live-order-parser

Parse order comments (Facebook Live, TikTok Live, etc.) into structured order data. Supports all world currencies, configurable separators, auto-K for VND, multi-item comments, and various price/quantity formats.

Install

npm install live-order-parser

Usage

import { parseOrderComment } from "live-order-parser";

parseOrderComment("sku1 100k x2");
// [{ sku: 'sku1', price: 100000, quantity: 2, currency: 'VND', raw: 'sku1 100k x2' }]

parseOrderComment("sku1 $100");
// [{ sku: 'sku1', price: 100, quantity: 1, currency: 'USD', raw: 'sku1 $100' }]

parseOrderComment("sku1 100k*2 sku2 50k");
// [
//   { sku: 'sku1', price: 100000, quantity: 2, currency: 'VND', raw: 'sku1 100k*2' },
//   { sku: 'sku2', price: 50000,  quantity: 1, currency: 'VND', raw: 'sku2 50k' }
// ]

Supported Formats

| Comment | SKU | Price | Qty | Notes | | ---------------------- | ---------- | ---------- | ---- | ------------------------- | | sku1 100 | sku1 | 100,000 | 1 | Auto-K (VND) | | sku1 100k | sku1 | 100,000 | 1 | Explicit K | | sku1 4k | sku1 | 4,000 | 1 | Small K | | sku1 1200k | sku1 | 1,200,000 | 1 | Large K | | sku1 1.2m | sku1 | 1,200,000 | 1 | Million | | sku1 1.3m | sku1 | 1,300,000 | 1 | Million decimal | | sku1 100 x2 | sku1 | 100,000 | 2 | With quantity | | sku1 100k x3 | sku1 | 100,000 | 3 | K + quantity | | sku1-100 | sku1 | 100,000 | 1 | Dash separator | | sku1\|100 | sku1 | 100,000 | 1 | Pipe separator | | sku1 $100 | sku1 | $100 | 1 | USD (no auto-K) | | sku1 €50 | sku1 | €50 | 1 | EUR | | sku1 100đ | sku1 | 100,000 | 1 | VND suffix | | sku1 100 SL2 | sku1 | 100,000 | 2 | Vietnamese qty keyword | | sku1 1,200 | sku1 | 1,200,000 | 1 | Comma thousands + auto-K | | sku1 1.200 | sku1 | 1,200,000 | 1 | EU dot thousands + auto-K | | sku1 100 sku2 200 | sku1, sku2 | 100k, 200k | 1, 1 | Multi-item | | sku1 100k*2 sku2 50k | sku1, sku2 | 100k, 50k | 2, 1 | Multi-item + qty |

Quantity Patterns

All of these are recognized as quantity = 2:

x2, X2, *2, ×2, SL2, sl2, SL 2

Quantity can also be attached to price: 100k*2, 100kx3

Options

interface ParserOptions {
  defaultCurrency?: string; // Default: 'VND'
  separators?: string[]; // Default: [' ']
  knownSkus?: string[]; // Optional SKU whitelist
  autoK?: boolean; // Default: true
  thousandsSeparator?: "comma" | "dot" | "auto"; // Default: 'auto'
}

Custom separator

// Dash
parseOrderComment("sku1-100", { separators: ["-"] });

// Pipe
parseOrderComment("sku1|100", { separators: ["|"] });

// Multiple separators
parseOrderComment("sku1-100", { separators: [" ", "-", "|"] });

Disable auto-K

parseOrderComment("sku1 100", { autoK: false });
// [{ sku: 'sku1', price: 100, ... }]

Different default currency

parseOrderComment("sku1 100", { defaultCurrency: "USD" });
// [{ sku: 'sku1', price: 100, currency: 'USD', ... }]

Known SKUs

parseOrderComment("abc 200", { knownSkus: ["abc", "def"] });
// [{ sku: 'abc', price: 200000, ... }]

Auto-K Rule

When defaultCurrency is 'VND' (default) and autoK is true (default):

• Bare numbers are multiplied by 1,000: 100 → 100,000
• Numbers with k/m suffix are NOT auto-multiplied (already explicit)
• Numbers with foreign currency prefix ($, €, etc.) are NOT auto-multiplied

Supported Currencies

Prefix symbols: $ USD, € EUR, £ GBP, ¥ JPY, ₩ KRW, ₫ VND, ₱ PHP, ฿ THB, ₹ INR, ₺ TRY, ₴ UAH, ₸ KZT, ₡ CRC, ₵ GHS, ₦ NGN, ₲ PYG, ₭ LAK, ₮ MNT, ﷼ IRR, ៛ KHR, ₿ BTC, zł PLN, Kč CZK, Ft HUF, lei RON, лв BGN, din RSD

Multi-char prefixes: R$ BRL, RM MYR, Rp IDR, kr SEK, NT$ TWD, HK$ HKD, S$ SGD, A$ AUD, NZ$ NZD, C$ CAD

Suffixes: đ/d VND

License

MIT