pinoy-kredit-parser 1.2.0 → 1.3.1

package/README.MD

@@ -1,6 +1,6 @@
 # pinoy-kredit-parser
 
-A lightweight Node.js library for parsing Philippine credit card statement PDFs into structured transaction data.
+A lightweight, isomorphic library for parsing Philippine credit card statement PDFs into structured transaction data. Works in Node.js, Browsers, and Next.js.
 
 Currently supports:
 
@@ -39,44 +39,50 @@ npm install pinoy-kredit-parser
 ---
 
 ## Usage
+The library automatically detects your environment (Node vs. Browser) to provide the correct parsing engine.
+
 ### Using a file path (Node.js)
 ```javascript
-const { parseKredit, BankType } = require('pinoy-kredit-parser')
+import { parseKredit, BankType } from 'pinoy-kredit-parser';
 
-async function main() {
-  const transactions = await parseKredit('statement.pdf', {
+const transactions = await parseKredit('./statement.pdf', {
     bank: BankType.RCBC,
-  })
-
-  console.log(transactions)
-}
-
-main()
+});
 ```
-### Using a File object (Browser / modern runtimes)
+### Browser / Next.js Client Components (File or ArrayBuffer)
 ```javascript
-import { parseKredit, BankType } from 'pinoy-kredit-parser'
-
-async function handleFile(file) {
-  const transactions = await parseKredit(file, {
-    bank: BankType.METROBANK,
-  })
+import { parseKredit, BankType } from 'pinoy-kredit-parser';
+
+const handleUpload = async (event) => {
+    const file = event.target.files[0];
+    const transactions = await parseKredit(file, {
+        bank: BankType.UNIONBANK,
+    });
+};
+```
 
-  console.log(transactions)
-}
+### Next.js (App Router / API Routes)
+When using this library in Next.js, you must add it to `serverExternalPackages` in your `next.config.ts` to correctly handle the native PDF rendering binaries.
+```javascript
+// next.config.ts
+const nextConfig = {
+  experimental: {
+    serverExternalPackages: ['pinoy-kredit-parser', 'pdf-parse', '@napi-rs/canvas'],
+  },
+};
 ```
 
 ---
 
 ## Output Format
 
-Each transaction is returned as:
+Transactions are returned in a clean, structured format:
 ```typescript
 type KreditTransaction = {
-  saleDate: string
-  postDate: string
-  description: string
-  amount: number
+  saleDate: string;    // MM/DD/YY
+  postDate: string;    // MM/DD/YY
+  description: string;
+  amount: number;      // Positive for purchases, negative for payments/credits
 }
 ```
 Example:
@@ -90,6 +96,12 @@ Example:
   }
 ]
 ```
+---
+## Features
+- **Isomorphic:** Shared logic for server-side and client-side parsing.
+- **Zero Global Pollution:** No need for manual DOMMatrix or Canvas polyfills.
+- **Next.js Ready:** Optimized for modern frameworks with automatic environment detection.
+- **Privacy-First:** All parsing happens locally on your machine. No data is ever sent to a server.
 
 ---
 

package/dist/browser.d.ts

@@ -4,3 +4,6 @@ type BrowserInput = File | Blob | ArrayBuffer | Uint8Array;
 export declare const parseKredit: (input: BrowserInput, options: {
     bank: BankType;
 }) => Promise<import("./types").KreditTransaction[]>;
+export declare const parseKreditMeta: (input: BrowserInput, options: {
+    bank: BankType;
+}) => Promise<import("./types").KreditMeta>;

package/dist/browser.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseKredit = void 0;
+exports.parseKreditMeta = exports.parseKredit = void 0;
 const core_1 = require("./core");
 __exportStar(require("./types"), exports);
 const parseKredit = async (input, options) => {
@@ -22,4 +22,9 @@ const parseKredit = async (input, options) => {
     return (0, core_1.baseParseKredit)(new Uint8Array(data), options);
 };
 exports.parseKredit = parseKredit;
+const parseKreditMeta = async (input, options) => {
+    const data = input instanceof File || input instanceof Blob ? await input.arrayBuffer() : input;
+    return (0, core_1.baseParseMeta)(new Uint8Array(data), options);
+};
+exports.parseKreditMeta = parseKreditMeta;
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAwC;AAGxC,0CAAuB;AAIhB,MAAM,WAAW,GAAG,KAAK,EAAE,KAAmB,EAAE,OAA2B,EAAE,EAAE;IACpF,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IAE/F,OAAO,IAAA,sBAAe,EAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;AACvD,CAAC,CAAA;AAJY,QAAA,WAAW,eAIvB"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,iCAAuD;AAGvD,0CAAuB;AAIhB,MAAM,WAAW,GAAG,KAAK,EAAE,KAAmB,EAAE,OAA2B,EAAE,EAAE;IACpF,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IAE/F,OAAO,IAAA,sBAAe,EAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;AACvD,CAAC,CAAA;AAJY,QAAA,WAAW,eAIvB;AAEM,MAAM,eAAe,GAAG,KAAK,EAAE,KAAmB,EAAE,OAA2B,EAAE,EAAE;IACxF,MAAM,IAAI,GAAG,KAAK,YAAY,IAAI,IAAI,KAAK,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,KAAK,CAAA;IAE/F,OAAO,IAAA,oBAAa,EAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,CAAA;AACrD,CAAC,CAAA;AAJY,QAAA,eAAe,mBAI3B"}

package/dist/core.d.ts

@@ -1,5 +1,9 @@
-import { BankType, KreditTransaction } from './types';
+import { BankType, KreditMeta, KreditTransaction } from './types';
 export declare const baseParseKredit: (data: Buffer | Uint8Array, options: {
     bank: BankType;
     CanvasFactory?: any;
 }) => Promise<KreditTransaction[]>;
+export declare const baseParseMeta: (data: Buffer | Uint8Array, options: {
+    bank: BankType;
+    CanvasFactory?: any;
+}) => Promise<KreditMeta>;

package/dist/core.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.baseParseKredit = void 0;
+exports.baseParseMeta = exports.baseParseKredit = void 0;
 const pdf_parse_1 = require("pdf-parse");
 const types_1 = require("./types");
 const rcbc_1 = require("./parsers/rcbc");
@@ -24,4 +24,73 @@ const baseParseKredit = async (data, options) => {
     }
 };
 exports.baseParseKredit = baseParseKredit;
+const MONTH_MAP = {
+    jan: '01',
+    feb: '02',
+    mar: '03',
+    apr: '04',
+    may: '05',
+    jun: '06',
+    jul: '07',
+    aug: '08',
+    sep: '09',
+    oct: '10',
+    nov: '11',
+    dec: '12',
+    january: '01',
+    february: '02',
+    march: '03',
+    april: '04',
+    june: '06',
+    july: '07',
+    august: '08',
+    september: '09',
+    october: '10',
+    november: '11',
+    december: '12',
+};
+const normalizeMetaDate = (raw) => {
+    const parts = raw.replace(',', '').trim().split(/\s+/);
+    let day, month, year;
+    if (/^\d+$/.test(parts[0])) {
+        // DD Month YYYY (Metrobank)
+        ;
+        [day, month, year] = parts;
+    }
+    else {
+        // MMM DD YYYY (RCBC / UnionBank)
+        ;
+        [month, day, year] = parts;
+    }
+    const mm = MONTH_MAP[month.toLowerCase()];
+    if (!mm)
+        throw new Error(`Unknown month in date: ${raw}`);
+    return `${mm}/${day.padStart(2, '0')}/${year}`;
+};
+const baseParseMeta = async (data, options) => {
+    const parser = new pdf_parse_1.PDFParse({
+        data: Buffer.from(data),
+        CanvasFactory: options.CanvasFactory,
+    });
+    const { text } = await parser.getText();
+    let raw;
+    switch (options.bank) {
+        case types_1.BankType.RCBC:
+            raw = (0, rcbc_1.parseRCBCMeta)(text);
+            break;
+        case types_1.BankType.METROBANK:
+            raw = (0, metrobank_1.parseMetrobankMeta)(text);
+            break;
+        case types_1.BankType.UNIONBANK:
+            raw = (0, unionbank_1.parseUnionBankMeta)(text);
+            break;
+        default:
+            throw new Error('Unsupported bank type');
+    }
+    return {
+        statementDate: normalizeMetaDate(raw.statementDate),
+        dueDate: normalizeMetaDate(raw.dueDate),
+    };
+};
+exports.baseParseMeta = baseParseMeta;
 //# sourceMappingURL=core.js.map

package/dist/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":";;;AAAA,yCAAoC;AACpC,mCAAqD;AACrD,yCAA0C;AAC1C,mDAAoD;AACpD,mDAAoD;AAE7C,MAAM,eAAe,GAAG,KAAK,EAClC,IAAyB,EACzB,OAAgD,EAClB,EAAE;IAChC,MAAM,MAAM,GAAG,IAAI,oBAAQ,CAAC;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;QACvB,aAAa,EAAE,OAAO,CAAC,aAAa;KACrC,CAAC,CAAA;IAEF,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,CAAA;IAEvC,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;QACrB,KAAK,gBAAQ,CAAC,IAAI;YAChB,OAAO,IAAA,gBAAS,EAAC,IAAI,CAAC,CAAA;QACxB,KAAK,gBAAQ,CAAC,SAAS;YACrB,OAAO,IAAA,0BAAc,EAAC,IAAI,CAAC,CAAA;QAC7B,KAAK,gBAAQ,CAAC,SAAS;YACrB,OAAO,IAAA,0BAAc,EAAC,IAAI,CAAC,CAAA;QAC7B;YACE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAC5C,CAAC;AACH,CAAC,CAAA;AArBY,QAAA,eAAe,mBAqB3B"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../src/core.ts"],"names":[],"mappings":"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"}

package/dist/node.d.ts

@@ -4,3 +4,6 @@ type NodeInput = string | Buffer | Uint8Array;
 export declare const parseKredit: (input: NodeInput, options: {
     bank: BankType;
 }) => Promise<import("./types").KreditTransaction[]>;
+export declare const parseKreditMeta: (input: NodeInput, options: {
+    bank: BankType;
+}) => Promise<import("./types").KreditMeta>;

package/dist/node.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseKredit = void 0;
+exports.parseKreditMeta = exports.parseKredit = void 0;
 const node_fs_1 = require("node:fs");
 const worker_1 = require("pdf-parse/worker");
 const core_1 = require("./core");
@@ -24,4 +24,9 @@ const parseKredit = async (input, options) => {
     return (0, core_1.baseParseKredit)(buffer, { ...options, CanvasFactory: worker_1.CanvasFactory });
 };
 exports.parseKredit = parseKredit;
+const parseKreditMeta = async (input, options) => {
+    const buffer = typeof input === 'string' ? (0, node_fs_1.readFileSync)(input) : input;
+    return (0, core_1.baseParseMeta)(buffer, { ...options, CanvasFactory: worker_1.CanvasFactory });
+};
+exports.parseKreditMeta = parseKreditMeta;
 //# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAsC;AACtC,6CAAgD;AAChD,iCAAwC;AAGxC,0CAAuB;AAIhB,MAAM,WAAW,GAAG,KAAK,EAAE,KAAgB,EAAE,OAA2B,EAAE,EAAE;IACjF,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAEtE,OAAO,IAAA,sBAAe,EAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAb,sBAAa,EAAE,CAAC,CAAA;AAC/D,CAAC,CAAA;AAJY,QAAA,WAAW,eAIvB"}
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qCAAsC;AACtC,6CAAgD;AAChD,iCAAuD;AAGvD,0CAAuB;AAIhB,MAAM,WAAW,GAAG,KAAK,EAAE,KAAgB,EAAE,OAA2B,EAAE,EAAE;IACjF,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAEtE,OAAO,IAAA,sBAAe,EAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAb,sBAAa,EAAE,CAAC,CAAA;AAC/D,CAAC,CAAA;AAJY,QAAA,WAAW,eAIvB;AAEM,MAAM,eAAe,GAAG,KAAK,EAAE,KAAgB,EAAE,OAA2B,EAAE,EAAE;IACrF,MAAM,MAAM,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAA,sBAAY,EAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IAEtE,OAAO,IAAA,oBAAa,EAAC,MAAM,EAAE,EAAE,GAAG,OAAO,EAAE,aAAa,EAAb,sBAAa,EAAE,CAAC,CAAA;AAC7D,CAAC,CAAA;AAJY,QAAA,eAAe,mBAI3B"}

package/dist/parsers/metrobank.d.ts

@@ -1,2 +1,6 @@
 import { KreditTransaction } from '../types';
 export declare const parseMetrobank: (text: string) => KreditTransaction[];
+export declare const parseMetrobankMeta: (text: string) => {
+    statementDate: string;
+    dueDate: string;
+};

package/dist/parsers/metrobank.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseMetrobank = void 0;
+exports.parseMetrobankMeta = exports.parseMetrobank = void 0;
 const regex = /^"?(\d{2}\/\d{2})\s+(\d{2}\/\d{2})\s+(.+?)\s+([\d,]+\.\d{2}C?)"?$/;
 const parseMetrobank = (text) => text
     .split('\n')
@@ -17,4 +17,12 @@ const parseMetrobank = (text) => text
     };
 });
 exports.parseMetrobank = parseMetrobank;
+const metaRegex = /Statement Date Payment Due Date\n(\d{1,2} \w+ \d{4}) (\d{1,2} \w+ \d{4})/;
+const parseMetrobankMeta = (text) => {
+    const m = metaRegex.exec(text);
+    if (!m)
+        throw new Error('Metrobank: could not extract statement/due dates');
+    return { statementDate: m[1], dueDate: m[2] };
+};
+exports.parseMetrobankMeta = parseMetrobankMeta;
 //# sourceMappingURL=metrobank.js.map

package/dist/parsers/metrobank.js.map

@@ -1 +1 @@
-{"version":3,"file":"metrobank.js","sourceRoot":"","sources":["../../src/parsers/metrobank.ts"],"names":[],"mappings":";;;AAEA,MAAM,KAAK,GAAG,mEAAmE,CAAA;AAC1E,MAAM,cAAc,GAAG,CAAC,IAAY,EAAuB,EAAE,CAClE,IAAI;KACD,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC/B,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE;IACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAExC,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;IAEtE,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;KAClC,CAAA;AACH,CAAC,CAAC,CAAA;AAhBO,QAAA,cAAc,kBAgBrB"}
+{"version":3,"file":"metrobank.js","sourceRoot":"","sources":["../../src/parsers/metrobank.ts"],"names":[],"mappings":";;;AAEA,MAAM,KAAK,GAAG,mEAAmE,CAAA;AAC1E,MAAM,cAAc,GAAG,CAAC,IAAY,EAAuB,EAAE,CAClE,IAAI;KACD,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC/B,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE;IACtD,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAA;IAExC,MAAM,KAAK,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;IAEtE,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK;KAClC,CAAA;AACH,CAAC,CAAC,CAAA;AAhBO,QAAA,cAAc,kBAgBrB;AAEN,MAAM,SAAS,GAAG,0EAA0E,CAAA;AAErF,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA8C,EAAE;IAC7F,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IAC3E,OAAO,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/C,CAAC,CAAA;AAJY,QAAA,kBAAkB,sBAI9B"}

package/dist/parsers/rcbc.d.ts

@@ -1,2 +1,6 @@
 import { KreditTransaction } from '../types';
 export declare const parseRCBC: (text: string) => KreditTransaction[];
+export declare const parseRCBCMeta: (text: string) => {
+    statementDate: string;
+    dueDate: string;
+};

package/dist/parsers/rcbc.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseRCBC = void 0;
+exports.parseRCBCMeta = exports.parseRCBC = void 0;
 const regex = /^([\d,]+\.\d{2}-?)\t(\d{2}\/\d{2}\/\d{2}) (\d{2}\/\d{2}\/\d{2}) (.+)$/;
 const parseRCBC = (text) => text
     .split('\n')
@@ -17,4 +17,12 @@ const parseRCBC = (text) => text
     };
 });
 exports.parseRCBC = parseRCBC;
+const metaRegex = /([A-Z]{3} \d{2} \d{4})\t([A-Z]{3} \d{2} \d{4})\nPAYMENT DUE DATE\tSTATEMENT DATE/;
+const parseRCBCMeta = (text) => {
+    const m = metaRegex.exec(text);
+    if (!m)
+        throw new Error('RCBC: could not extract statement/due dates');
+    return { dueDate: m[1], statementDate: m[2] };
+};
+exports.parseRCBCMeta = parseRCBCMeta;
 //# sourceMappingURL=rcbc.js.map

package/dist/parsers/rcbc.js.map

@@ -1 +1 @@
-{"version":3,"file":"rcbc.js","sourceRoot":"","sources":["../../src/parsers/rcbc.ts"],"names":[],"mappings":";;;AAEA,MAAM,KAAK,GAAG,uEAAuE,CAAA;AAC9E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAuB,EAAE,CAC7D,IAAI;KACD,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC/B,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE;IACtD,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;IAE5E,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAA;IAEnE,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;QAC/B,MAAM;KACP,CAAA;AACH,CAAC,CAAC,CAAA;AAhBO,QAAA,SAAS,aAgBhB"}
+{"version":3,"file":"rcbc.js","sourceRoot":"","sources":["../../src/parsers/rcbc.ts"],"names":[],"mappings":";;;AAEA,MAAM,KAAK,GAAG,uEAAuE,CAAA;AAC9E,MAAM,SAAS,GAAG,CAAC,IAAY,EAAuB,EAAE,CAC7D,IAAI;KACD,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC/B,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,EAAE,EAAE;IACtD,MAAM,WAAW,GAAG,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAA;IAE5E,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,WAAW,CAAA;IAEnE,OAAO;QACL,QAAQ;QACR,QAAQ;QACR,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;QAC/B,MAAM;KACP,CAAA;AACH,CAAC,CAAC,CAAA;AAhBO,QAAA,SAAS,aAgBhB;AAEN,MAAM,SAAS,GAAG,kFAAkF,CAAA;AAE7F,MAAM,aAAa,GAAG,CAAC,IAAY,EAA8C,EAAE;IACxF,MAAM,CAAC,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAA;IACtE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;AAC/C,CAAC,CAAA;AAJY,QAAA,aAAa,iBAIzB"}

package/dist/parsers/unionbank.d.ts

@@ -1,2 +1,6 @@
 import { KreditTransaction } from '../types';
 export declare const parseUnionBank: (text: string) => KreditTransaction[];
+export declare const parseUnionBankMeta: (text: string) => {
+    statementDate: string;
+    dueDate: string;
+};

package/dist/parsers/unionbank.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseUnionBank = void 0;
+exports.parseUnionBankMeta = exports.parseUnionBank = void 0;
 const regex = /^"?(\d{2}\/\d{2}\/\d{2})\s+(\d{2}\/\d{2}\/\d{2})\s+(.+?)\s+PHP\s+(-?[\d,]+\.\d{2})"?$/;
 const parseUnionBank = (text) => text
     .split('\n')
@@ -13,4 +13,14 @@ const parseUnionBank = (text) => text
     amount: parseFloat(amountStr.replace(/,/g, '')),
 }));
 exports.parseUnionBank = parseUnionBank;
+const stmtRegex = /Statement Date\s*:\s*(\w{3} \d{2}, \d{4})/;
+const dueRegex = /Payment Due Date\s*:\s*(\w{3} \d{2}, \d{4})/;
+const parseUnionBankMeta = (text) => {
+    const sm = stmtRegex.exec(text);
+    const dm = dueRegex.exec(text);
+    if (!sm || !dm)
+        throw new Error('UnionBank: could not extract statement/due dates');
+    return { statementDate: sm[1], dueDate: dm[1] };
+};
+exports.parseUnionBankMeta = parseUnionBankMeta;
 //# sourceMappingURL=unionbank.js.map

package/dist/parsers/unionbank.js.map

@@ -1 +1 @@
-{"version":3,"file":"unionbank.js","sourceRoot":"","sources":["../../src/parsers/unionbank.ts"],"names":[],"mappings":";;;AAEA,MAAM,KAAK,GACT,uFAAuF,CAAA;AAClF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAuB,EAAE,CAClE,IAAI;KACD,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC/B,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACxD,QAAQ;IACR,QAAQ;IACR,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;IAC/B,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;CAChD,CAAC,CAAC,CAAA;AAVM,QAAA,cAAc,kBAUpB"}
+{"version":3,"file":"unionbank.js","sourceRoot":"","sources":["../../src/parsers/unionbank.ts"],"names":[],"mappings":";;;AAEA,MAAM,KAAK,GACT,uFAAuF,CAAA;AAClF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAuB,EAAE,CAClE,IAAI;KACD,KAAK,CAAC,IAAI,CAAC;KACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAC/B,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC;KAC/C,GAAG,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;IACxD,QAAQ;IACR,QAAQ;IACR,WAAW,EAAE,WAAW,CAAC,IAAI,EAAE;IAC/B,MAAM,EAAE,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;CAChD,CAAC,CAAC,CAAA;AAVM,QAAA,cAAc,kBAUpB;AAEP,MAAM,SAAS,GAAG,2CAA2C,CAAA;AAC7D,MAAM,QAAQ,GAAG,6CAA6C,CAAA;AAEvD,MAAM,kBAAkB,GAAG,CAAC,IAAY,EAA8C,EAAE;IAC7F,MAAM,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC/B,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAC9B,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAA;IACnF,OAAO,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;AACjD,CAAC,CAAA;AALY,QAAA,kBAAkB,sBAK9B"}

package/dist/types.d.ts

@@ -4,6 +4,10 @@ export type KreditTransaction = {
     description: string;
     amount: number;
 };
+export type KreditMeta = {
+    statementDate: string;
+    dueDate: string;
+};
 export declare enum BankType {
     RCBC = "rcbc",
     METROBANK = "metrobank",

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAOA,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,mCAAuB,CAAA;IACvB,mCAAuB,CAAA;AACzB,CAAC,EAJW,QAAQ,wBAAR,QAAQ,QAInB"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";;;AAYA,IAAY,QAIX;AAJD,WAAY,QAAQ;IAClB,yBAAa,CAAA;IACb,mCAAuB,CAAA;IACvB,mCAAuB,CAAA;AACzB,CAAC,EAJW,QAAQ,wBAAR,QAAQ,QAInB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pinoy-kredit-parser",
-  "version": "1.2.0",
+  "version": "1.3.1",
   "description": "Philippine credit card statement parser",
   "main": "./dist/node.js",
   "browser": "./dist/browser.js",
@@ -34,6 +34,8 @@
     "build": "rm -rf dist && tsc",
     "format": "prettier --write 'src/**/*.ts'",
     "format:check": "prettier --check 'src/**/*.ts'",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -55,6 +57,7 @@
     "eslint-config-prettier": "^10.1.8",
     "prettier": "^3.8.1",
     "ts-node": "^10.9.2",
-    "typescript": "^5.9.3"
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.9"
   }
 }