TransactionParser

Parse files containing transaction data using COBOL copybooks into a TypeScript object

Parse copybooks

This package supports parsing a copybook into a TypeScript object.

const parser = new CopybookParser('/path/to/copybook'); // Supports any extension
parser.parse(); // Load copybook as object

parser.getParsedCopybook(); // Retrieve copybook as object
parser.toJson(); // Retrieve copybook as JSON string

Want to use a different copybook? Just update the path to the copybook:

parser.updateCopybookPath('/path/to/another/copybook');

Note: This will clear previously parsed copybook data

Example

The following copybook:

       01 CUSTOMER-RECORD.
          05 CUSTOMER-NAME.
             10 FIRST-NAME             PIC X(15).

Will be parsed and represented as a JSON object:

[
  {
    "level": 1,
    "name": "CUSTOMER-RECORD",
    "picture": "group",
    "length": 0,
    "signed": false,
    "decimals": 0,
    "children": [
      {
        "level": 5,
        "name": "CUSTOMER-NAME",
        "picture": "group",
        "length": 0,
        "signed": false,
        "decimals": 0,
        "children": [
          {
            "level": 10,
            "name": "FIRST-NAME",
            "picture": "string",
            "length": 15,
            "signed": false,
            "decimals": 0
          }
        ]
      }
    ]
  }
]

Load transaction data

In the future, this package will support loading transaction data from a file based on a copybook that will be used for validation.