@perrylink/dsh-einvoice 0.1.0-alpha.2 → 0.1.0-alpha.3

package/README.md

@@ -2,7 +2,7 @@
 
 File-level Chinese e-invoice ingest, parse and pool for DeepSeek Harness (SKU-04 S1).
 
-> **Status: S1+S2+S3 / public demo (0.1.0-alpha.2).** The customer evidence gate (2 enterprises + 1 bookkeeping firm + 100 real invoices) is still PARKED. S1 uses public/open-source and synthetic fixtures; its acceptance rows are `not counted` toward GA. Do not describe this package as GA-ready.
+> **Status: S1+S2+S3 / public demo (0.1.0-alpha.3).** The customer evidence gate (2 enterprises + 1 bookkeeping firm + 100 real invoices) is still PARKED. S1 uses public/open-source and synthetic fixtures; its acceptance rows are `not counted` toward GA. Do not describe this package as GA-ready.
 
 ## Install
 

package/lib/adapters/ofd-zip-xml.js

@@ -1,7 +1,7 @@
 /** OFD (ZIP + XML) and standalone XML reader for SKU-04 S1. */
 import { unzipSync } from 'fflate';
 import { XMLParser } from 'fast-xml-parser';
-import { InvoiceError, amountToCents, normalizeDate, normalizeTaxId, } from '../core/invoice.js';
+import { InvoiceError, amountToCents, priceToCents, normalizeDate, normalizeTaxId, } from '../core/invoice.js';
 export const PARSER_ID = 'ofd-zip-xml';
 export const PARSER_VERSION = 'ofd-zip-xml@1';
 const xmlParser = new XMLParser({
@@ -96,7 +96,7 @@ function parseOldInvoice(root) {
             line_no: index + 1,
             description: textAt(line, 'Item'),
             quantity: textAt(line, 'Quantity') || undefined,
-            unit_price_cents: textAt(line, 'Price') ? amountToCents(textAt(line, 'Price')) : undefined,
+            unit_price_cents: textAt(line, 'Price') ? priceToCents(textAt(line, 'Price')) : undefined,
             amount_cents: amount ? amountToCents(amount) : 0,
             tax_rate: textAt(line, 'TaxScheme') || undefined,
             tax_cents: tax ? amountToCents(tax) : undefined,
@@ -240,7 +240,7 @@ function parseDigitalInvoice(root, textMap) {
             line_no: index + 1,
             description,
             quantity: textMap.get(quantityRefs[index] ?? '') || undefined,
-            unit_price_cents: textMap.get(priceRefs[index] ?? '') ? amountToCents(textMap.get(priceRefs[index] ?? '') ?? '') : undefined,
+            unit_price_cents: textMap.get(priceRefs[index] ?? '') ? priceToCents(textMap.get(priceRefs[index] ?? '') ?? '') : undefined,
             amount_cents: amountText ? amountToCents(amountText) : 0,
             tax_rate: textMap.get(taxSchemeRefs[index] ?? '') || undefined,
             tax_cents: taxText ? amountToCents(taxText) : undefined,
@@ -299,7 +299,7 @@ function parseGenericInvoice(root) {
             line_no: index + 1,
             description: textAt(line, 'Description') || textAt(line, 'Item'),
             quantity: textAt(line, 'Quantity') || undefined,
-            unit_price_cents: textAt(line, 'UnitPrice') ? amountToCents(textAt(line, 'UnitPrice')) : undefined,
+            unit_price_cents: textAt(line, 'UnitPrice') ? priceToCents(textAt(line, 'UnitPrice')) : undefined,
             amount_cents: textAt(line, 'Amount') ? amountToCents(textAt(line, 'Amount')) : 0,
             tax_rate: textAt(line, 'TaxRate') || undefined,
             tax_cents: textAt(line, 'TaxAmount') ? amountToCents(textAt(line, 'TaxAmount')) : undefined,

package/lib/core/invoice.d.ts

@@ -48,6 +48,8 @@ export declare class InvoiceError extends Error {
 /** Parse a decimal amount (yuan) into integer cents without floating point. */
 export declare function amountToCents(raw: unknown): number;
 /** Normalize the common Chinese date spellings to YYYY-MM-DD. */
+/** Unit prices may carry tax-calculation precision; round half-up to integer cents. */
+export declare function priceToCents(raw: unknown): number;
 export declare function normalizeDate(raw: unknown): string;
 /** Validate the shape of a PRC taxpayer id without claiming checksum validity. */
 export declare function normalizeTaxId(raw: unknown): string;

package/lib/core/invoice.js

@@ -37,6 +37,20 @@ export function amountToCents(raw) {
     return Number(cents);
 }
 /** Normalize the common Chinese date spellings to YYYY-MM-DD. */
+/** Unit prices may carry tax-calculation precision; round half-up to integer cents. */
+export function priceToCents(raw) {
+    if (typeof raw !== 'string' && typeof raw !== 'number')
+        throw new InvoiceError('E_INV_FIELD_MISSING', 'price is not a value');
+    const normalized = String(raw).trim().replace(/[¥￥,，\s]/g, '');
+    const match = /^(-?)(\d+)(?:\.(\d{1,12}))?$/.exec(normalized);
+    if (!match)
+        throw new InvoiceError('E_INV_FIELD_MISSING', `price is not a decimal: ${String(raw).slice(0, 80)}`);
+    const sign = match[1] === '-' ? -1n : 1n;
+    const whole = BigInt(match[2]);
+    const fraction = BigInt((match[3] ?? '').padEnd(12, '0'));
+    const cents = (whole * 100n + (fraction + 5000000000n) / 10000000000n);
+    return Number(sign * cents);
+}
 export function normalizeDate(raw) {
     if (typeof raw !== 'string' || raw.trim() === '') {
         throw new InvoiceError('E_INV_FIELD_MISSING', 'issue date is empty');

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@perrylink/dsh-einvoice",
-  "version": "0.1.0-alpha.2",
+  "version": "0.1.0-alpha.3",
   "description": "File-level Chinese e-invoice (OFD/XML) ingest, parse and pool for DeepSeek Harness (SKU-04 S1).",
   "type": "module",
   "main": "./lib/plugin/index.js",