@posx/core 5.5.393 → 5.5.396

package/dev/escpos/receipt.hex

@@ -0,0 +1 @@
+1B401B45001B34001B2D000A1B45011B61011D2111204861707079205468616920466F6F64202D20566963746F727920380A1D21001B45001B34001B2D000A1B45011B610138204A616C616E204C6567756E6469202330312D313020566963746F727920380A1B45001B34001B2D000A1B45011B610154656C3A2036373134363638320A1B45001B34001B2D000A1B45011B610044696E652D496E0A1B45001B34001B2D000A1B45011B6100232030313236303231303030303030313437320A1B45001B34001B2D000A1B45011B61001D21115461626C653A31350A1D21001B45001B34001B2D000A1B45011B61001D21114F52444552204E4F2E3A203437320A1D21001B45001B34001B2D000A1B45011B61005365727665642042793A61646D696E0A1B45001B34001B2D000A1B45011B6100446174653A323032362D4665622D31302031333A34313A35340A1B45001B34001B2D000A1B45001B34001B2D002D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D0A1B45014954454D20202020202020202020202020202020202020202020202051545920202020414D542020202020202020200A1B45001B34001B2D002D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D0A1B45011B61004D332E204761726C696320467269656420506F726B20202020202020783120202020202431332E39302020202020200A1B45011B61005445352E20436869636B656E204F6D656C65747465202020202020207831202020202024372E3930202020202020200A1B45011B61004E44322E20506861642073656520457720284B7761792054202020207831202020202024392E3930202020202020200A656F772920536561666F6F6420202020202020202020202020202020202020202020202020202020202020202020200A1B45011B610041342E205468616920507261776E2043616B65202834205020202020783120202020202431332E39302020202020200A69656365732920202020202020202020202020202020202020202020202020202020202020202020202020202020200A1B45011B6100445231312E2054686169204D696C6B205465612020202020202020207831202020202024342E3530202020202020200A1B45011B61004452372E204C656D6F6E6772617373204472696E6B202020202020207831202020202024332E3930202020202020200A1B45001B34001B2D001B61002D2020436F6C642020202020202020202020202020202020202020207B7B7D7D2020202020202020202020202020200A1B45001B34001B2D000A1B45001B34001B2D002D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D0A1B45011B6100535542544F54414C202020202020202020202020202020202020202020202020202020202435342E30302020202020200A1B450131302520534552564943452043484152474520202020202020202020202020202020202024352E3430202020202020200A1B4501544F54414C202020202020202020202020202020202020202020202020202020202020202435392E34302020202020200A1B45001B34001B2D002D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D0A1B45015041594D454E542042593A466975752020202020202020202020202020202020202020202435392E34302020202020200A1B45001B34001B2D002D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D0A1B45015041594D454E5420545950452020202020202020202020204D41535445524341524420202020202020202020202020200A1B45015245462020202020202020202020202020202020202020203334383732363039343320202020202020202020202020200A1B450143415244204E554D202020202020202020202020202020202A2A2A2A202A2A2A2A202A2A2A2A203130343020202020200A1B4501435553544F4D45522054454C2020202020202020202020202020202020202020202020202B36352A2A2A2A34383436200A1B450143617368204261636B20202020202020202020202020202020202020202020202020202024312E3738202020202020200A1B45014372656469742042616C616E63652020202020202020202020202020202020202020202024312E3738202020202020200A1B4501506F696E742042616C616E636520202020202020202020202020202020202020202020207074202020202020202020200A1B45001B34001B2D002D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D2D0A1B45011B610138204A616C616E204C6567756E6469202330312D313020566963746F727920380A1B45001B34001B2D000A0A0A0A0A1B45001B34001B2D000A1B45001B34001B2D000A1B45001B34001B2D000A1B45001B34001B2D001D5600

package/dev/escpos/receipt.json

@@ -0,0 +1 @@
+{"uid": "pjb_I8RJcR0Hm6iMsYSzmIDRd", "updated_at": "2026-02-10T05:41:54.209Z", "created_at": "2026-02-10T05:41:54.356Z", "created_at_timestamp": 1770702114356, "deleted_at": null, "name_translations": {}, "printer_name": "Receipt Printer", "driver_printer_name": "Receipt Printer", "printer_ip": "0.0.0.0", "printer_uid": "prt_eJ5yITaByzBnAXSz1IvhF", "printer_type": "receipt_printer", "protocol": "ESC/POS", "connection_type": "WINDOWS_DRIVER", "data": {"codepage": "cp936", "items": [{"type": "newline", "repeat": 1}, {"type": "text", "align": "center", "style": "bold", "item": {"size": "custom", "width": 1, "height": 1, "text": " Happy Thai Food - Victory 8"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "center", "style": "bold", "item": {"text": "8 Jalan Legundi #01-10 Victory 8"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "center", "style": "bold", "item": {"text": "Tel: 67146682"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "Dine-In"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "# 01260210000001472"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"size": "custom", "width": 1, "height": 1, "text": "Table:15"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"size": "custom", "width": 1, "height": 1, "text": "ORDER NO.: 472"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "Served By:admin"}}, {"type": "newline", "repeat": 1}, {"type": "text", "align": "left", "style": "bold", "item": {"text": "Date:2026-Feb-10 13:41:54"}}, {"type": "newline", "repeat": 1}, {"type": "line"}, {"type": "table", "style": "bold", "table": {"items": [{"text": "ITEM", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "QTY", "column_width": 15}, {"text": "AMT", "column_width": 25}]}}, {"type": "line"}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "M3. Garlic Fried Pork  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$13.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "TE5. Chicken Omelette  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$7.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "ND2. Phad see Ew (Kway Teow) Seafood  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$9.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "A4. Thai Prawn Cake (4 Pieces)  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$13.90", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "DR11. Thai Milk Tea  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$4.50", "column_width": 25}]}}, {"type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "DR7. Lemongrass Drink  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "x1", "column_width": 15}, {"text": "$3.90", "column_width": 25}]}}, {"type": "table", "align": "left", "table": {"items": [{"text": "-  Cold  ", "column_width": 50}, {"text": "", "column_width": 10}, {"text": "{{}}", "column_width": 15}, {"text": "", "column_width": 25}]}}, {"type": "newline", "repeat": 1}, {"type": "line"}, {"codepage": "cp437", "type": "table", "align": "left", "style": "bold", "table": {"items": [{"text": "SUBTOTAL", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$54.00", "column_width": 25}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "10% SERVICE CHARGE", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$5.40", "column_width": 25}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "size": "custom", "width": 1, "height": 1, "table": {"items": [{"text": "TOTAL", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$59.40", "column_width": 25}]}}, {"type": "line"}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "PAYMENT BY:Fiuu", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$59.40", "column_width": 25}]}}, {"type": "line"}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "PAYMENT TYPE", "column_width": 50}, {"text": "MASTERCARD", "column_width": 50}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "REF", "column_width": 50}, {"text": "3487260943", "column_width": 50}]}}, {"codepage": "cp437", "type": "table", "style": "bold", "table": {"items": [{"text": "CARD NUM", "column_width": 50}, {"text": "**** **** **** 1040", "column_width": 50}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "CUSTOMER TEL", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "\u002B65****4846", "column_width": 25}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "Cash Back", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$1.78", "column_width": 25}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "Credit Balance", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "$1.78", "column_width": 25}]}}, {"type": "table", "style": "bold", "table": {"items": [{"text": "Point Balance", "column_width": 50}, {"text": "", "column_width": 25}, {"text": "pt", "column_width": 25}]}}, {"type": "line"}, {"type": "text", "align": "center", "style": "bold", "item": {"text": "8 Jalan Legundi #01-10 Victory 8"}}, {"type": "newline", "repeat": 5}, {"type": "newline", "repeat": 1}, {"type": "newline", "repeat": 1}, {"type": "newline", "repeat": 1}, {"type": "cut"}]}, "status": "printed", "retries": 0, "commands": "", "save_only": false, "print_times": 1, "printed": 1, "device_uid_to_print": "", "designated_table_section_uids": [], "job_id": 0, "print_sequence": 0, "meta": {}, "id_in_server": 1044494, "_timestamp": 1770702115370025}

package/dev/escpos-cli-usage.md

@@ -0,0 +1,103 @@
+# ESC/POS CLI Tool Usage Manual
+
+Generate ESC/POS byte files from print job JSON definitions.
+
+## Files
+
+- `scripts/generate-escpos-bytes.mjs` - ESC/POS byte generator with built-in encoder
+- `scripts/example-print-job.json` - Example print job for testing
+
+## Usage
+
+```bash
+npm run escpos -- <input.json> <output.bin>
+```
+
+## Example
+
+```bash
+npm run escpos -- ./scripts/example-print-job.json ./receipt.bin
+```
+
+## Supported Features
+
+| Feature | Description |
+|---------|-------------|
+| Text | With size, bold, italic, underline, alignment |
+| Tables | With column widths and text wrapping |
+| Lines | Separators |
+| QR codes | Model, size, error level configurable |
+| Barcodes | EAN13, UPC-A, UPC-E, EAN8, Code39, ITF, Codabar |
+| Newlines | With repeat count |
+| Cut | Full or partial |
+| Beeper | Audible alert |
+| Cash drawer | Open cash drawer command |
+| VISCII codepage | Vietnamese support |
+| Multiple codepages | cp437, cp850, cp936, etc. |
+
+## Not Supported
+
+- **Image printing** - Requires browser APIs, not available in CLI mode
+
+## Print Job JSON Format
+
+```json
+{
+  "codepage": "cp936",
+  "items": [
+    {
+      "type": "text",
+      "align": "center",
+      "style": "bold",
+      "item": {
+        "text": "RECEIPT",
+        "size": "normal",
+        "line_width": 48
+      }
+    },
+    {
+      "type": "table",
+      "table": {
+        "size": "normal",
+        "line_width": 48,
+        "items": [
+          { "text": "Item", "column_width": 50 },
+          { "text": "Qty", "column_width": 20 },
+          { "text": "Price", "column_width": 30 }
+        ]
+      }
+    },
+    {
+      "type": "qrcode",
+      "align": "center",
+      "qrcode": {
+        "data": "https://example.com",
+        "model": 2,
+        "size": 6,
+        "errorlevel": "m"
+      }
+    },
+    {
+      "type": "cut"
+    }
+  ]
+}
+```
+
+## Available Types
+
+| Type | Properties |
+|------|------------|
+| `text` | `item.text`, `item.size`, `item.line_width`, `item.width`, `item.height` |
+| `table` | `table.items[]`, `table.size`, `table.line_width` |
+| `line` | `item.text` (character to repeat) |
+| `newline` | `repeat` (number of lines) |
+| `qrcode` | `qrcode.data`, `qrcode.model`, `qrcode.size`, `qrcode.errorlevel` |
+| `barcode` | `barcode.data`, `barcode.symbology`, `barcode.height` |
+| `cut` | `item.text` ("full" or "partial") |
+| `beeper` | - |
+| `open_cash_drawer` | - |
+
+## Available Codepages
+
+`cp437`, `cp850`, `cp860`, `cp863`, `cp865`, `cp857`, `cp737`, `cp866`, `cp862`, `cp864`, `cp874`, `cp936`, `cp949`, `cp950`, `shiftjis`, `windows1252`, `69` (VISCII)

package/dev/px-cli.md

@@ -0,0 +1,99 @@
+# px-cli
+
+Bun CLI project to interact with server using x-api-key method
+
+## Setup
+
+```bash
+cd px
+bun install
+cp .env.example .env   # fill in PX_BASE_URL, PX_API_KEY, PX_MERCHANT_UID
+```
+
+## Structure
+
+```
+px/
+├── package.json          # bun project, depends on @posx/core
+├── tsconfig.json
+├── .env.example
+├── index.ts              # entry point & router (cac)
+├── http.ts               # HTTP client with x-api-key auth
+├── .changes.json         # staged CUD changes (auto-generated)
+└── commands/
+    ├── category.ts       # Category CRUD (types: ICategory)
+    └── product.ts        # Product CRUD (types: IItem)
+```
+
+## Dependencies
+
+- `@posx/core` — import types only (no service layer — no Dexie/IndexedDB in Bun):
+  - `IServiceOptions` — config typing in `http.ts`
+  - `ICategory` — category request/response typing
+  - `IItem` — product request/response typing
+- `@litepos/autoquery` — `QueryBuilder` for `list` action (autoquery via `sapi` endpoint)
+- `cac` — lightweight CLI framework (arg parsing, help text, subcommands)
+
+## Usage
+
+### Read (immediate)
+
+```bash
+# List via autoquery (sapi)
+px category list
+px category list --nameContains Drinks --take 10
+px product list
+px product list --nameContains Latte --take 10
+
+# Get by ID
+px category get --id 123
+px product get --id 456
+```
+
+### CUD — two-step workflow (stage → commit)
+
+CUD operations stage changes locally before applying to server.
+
+**Step 1: Stage changes** — fetches latest data, displays diff, saves to `.changes.json`
+
+```bash
+# Add (shows new record fields)
+px category add --name "Drinks" --type product --color "#ff0000" --icon "🍹"
+
+# Update (fetches current record, shows old → new diff)
+# Pattern: GET → merge changes → PATCH
+px category update --id 123 --name "Beverages"
+px product update --id 456 --price 6.00
+
+# Delete (fetches current record, shows record to be removed)
+px category delete --id 123
+px product delete --id 456
+```
+
+**Step 2: Review & apply**
+
+```bash
+px status          # show all staged changes
+px commit          # apply all staged changes to server
+px reset           # discard all staged changes
+```
+
+## API
+
+- **Base**: `https://lite-dev.posx.ai`
+- **Auth**: `x-api-key` header
+
+| Method   | Route                                               | Action           |
+|----------|-----------------------------------------------------|------------------|
+| `GET`    | `sapi/v5/merchants/{merchant_uid}/{module}`         | list (autoquery) |
+| `GET`    | `api/v5/merchants/{merchant_uid}/{module}/{id}`     | get              |
+| `PUT`    | `api/v5/merchants/{merchant_uid}/{module}/{method}` | add              |
+| `PATCH`  | `api/v5/merchants/{merchant_uid}/{module}/{id}`     | update           |
+| `DELETE` | `api/v5/merchants/{merchant_uid}/{module}/{id}`     | delete           |
+
+## Ref
+
+```bash
+curl -H "x-api-key: p8Hwl4A7ewynszODOOc05SJcqSP6YZDo2pevtZ" \
+  "https://lite-dev.posx.ai/api/v5/merchants/by-whatsapp-jid/6590992059@s.whatsapp.net"
+```