sec-edgar-api 0.2.1 → 0.2.2

package/build/services/DocumentParser/XMLParser.js

@@ -10,16 +10,131 @@ var __assign = (this && this.__assign) || function () {
     };
     return __assign.apply(this, arguments);
 };
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-var ColNode_1 = require("./XMLNode/ColNode");
-var DocumentNode_1 = require("./XMLNode/DocumentNode");
-var HRNode_1 = require("./XMLNode/HRNode");
-var NonTableNode_1 = require("./XMLNode/NonTableNode");
-var RowNode_1 = require("./XMLNode/RowNode");
-var TableNode_1 = require("./XMLNode/TableNode");
+var fast_xml_parser_1 = require("fast-xml-parser");
 var XMLParser = /** @class */ (function () {
-    function XMLParser() {
+    function XMLParser(args) {
+        var _a = (args !== null && args !== void 0 ? args : {}).parser, parser = _a === void 0 ? new fast_xml_parser_1.XMLParser() : _a;
+        this.parser = parser;
     }
+    XMLParser.prototype.extractJsonKey = function (json, extractKey) {
+        var obj = {};
+        this.iterateKeysDeep(json, function (key, currentObj) {
+            if (key === extractKey) {
+                obj = currentObj[key];
+                return true;
+            }
+        });
+        return obj;
+    };
+    XMLParser.prototype.parse = function (xml) {
+        return this.parser.parse(xml);
+    };
+    /**
+     * Return true in the callback if you want the loop to stop
+     */
+    XMLParser.prototype.iterateKeysDeep = function (obj, cb) {
+        var originalObj = obj;
+        // prevents original object from being modified
+        var _iterateKeys = function (obj, cb) {
+            for (var key in obj) {
+                var shouldBreak = cb(key, obj, originalObj) === true;
+                if (shouldBreak)
+                    return;
+                var value = obj[key];
+                var isObjOrArr = typeof value === 'object' && value !== null;
+                if (isObjOrArr)
+                    _iterateKeys(obj[key], cb);
+            }
+        };
+        _iterateKeys(obj, cb);
+    };
+    XMLParser.prototype.parseSectionTables = function (xml) {
+        var _this = this;
+        var xmlSplit = xml.split(/<HR.*?>/gi);
+        var fastParser = new fast_xml_parser_1.XMLParser({
+            htmlEntities: true,
+            ignoreAttributes: false,
+            alwaysCreateTextNode: true,
+        });
+        var toArray = function (value) { return (Array.isArray(value) ? value : [value]); };
+        var parseTable = function (obj) {
+            var _a, _b, _c, _d;
+            var getRowStrings = function (rows) {
+                var _a, _b, _c;
+                var results = [];
+                for (var i = 0; i < rows.length; i++) {
+                    var obj_1 = rows[i];
+                    var isObject = typeof obj_1 === 'object' && obj_1;
+                    var cols = isObject ? (_c = (_b = (_a = obj_1['TD']) !== null && _a !== void 0 ? _a : obj_1['td']) !== null && _b !== void 0 ? _b : obj_1['TH']) !== null && _c !== void 0 ? _c : obj_1['th'] : [];
+                    var rowCols = [];
+                    var _loop_1 = function (a) {
+                        var col = cols[a];
+                        if (typeof col !== 'object' || !col) {
+                            rowCols.push(String(col || '').trim());
+                        }
+                        var colStr = '';
+                        _this.iterateKeysDeep(col, function (key, curObj) {
+                            var _a;
+                            if (!key.startsWith('@_')) {
+                                colStr = "".concat((_a = curObj[key]) !== null && _a !== void 0 ? _a : '').trim();
+                            }
+                        });
+                        rowCols.push(String(colStr || '').trim());
+                        var colSpan = !Array.isArray(col) ? Number(col['@_COLSPAN']) || 1 : 1;
+                        for (var c = 1; c < colSpan; c++) {
+                            rowCols.push('@_SPAN');
+                        }
+                    };
+                    for (var a = 0; a < (cols !== null && cols !== void 0 ? cols : []).length; a++) {
+                        _loop_1(a);
+                    }
+                    results.push(rowCols);
+                }
+                return results;
+            };
+            var table = toArray(obj);
+            var thead = toArray((_b = (_a = table['THEAD']) !== null && _a !== void 0 ? _a : table['thead']) !== null && _b !== void 0 ? _b : []);
+            var tbody = toArray((_d = (_c = table['TBODY']) !== null && _c !== void 0 ? _c : table['tbody']) !== null && _d !== void 0 ? _d : []);
+            var tableRows = __spreadArray(__spreadArray(__spreadArray([], thead, true), table, true), tbody, true).map(function (obj) { var _a, _b; return toArray((_b = (_a = obj['TR']) !== null && _a !== void 0 ? _a : obj['tr']) !== null && _b !== void 0 ? _b : []); }).flat();
+            var tableData = [];
+            tableData.push(getRowStrings(tableRows));
+            return tableData;
+        };
+        var sections = [];
+        xmlSplit.forEach(function (xml) {
+            var tableIndex = xml.indexOf('<TABLE');
+            tableIndex = tableIndex === -1 ? xml.indexOf('<table') : tableIndex;
+            var text = xml
+                .substring(0, tableIndex)
+                .replace(/<\/?(.|\n)*?>/gi, ' ')
+                .replace(/\s+/g, ' ');
+            var xmlTables = xml
+                .replace(/<(?!(\/?TABLE|\/?TR|\/?TD|\/?TH|\/?HTML))(.|\n)*?>/gi, ' ')
+                .replace(/\s+/g, ' ');
+            var tableObjects = fastParser.parse(xmlTables);
+            var tableObjectsFlat = [];
+            _this.iterateKeysDeep(tableObjects, function (key, curObj) {
+                if (key.toLowerCase() === 'table') {
+                    tableObjectsFlat.push.apply(tableObjectsFlat, toArray(curObj[key]));
+                }
+            });
+            var tables = tableObjectsFlat.map(function (t) { return parseTable(t)[0]; });
+            if (tables.length > 0) {
+                sections.push({ text: text, tables: tables });
+            }
+        });
+        return sections;
+    };
     XMLParser.prototype.iterateXML = function (params) {
         var _a, _b, _c;
         var xml = params.xml, onCharacter = params.onCharacter, onCloseTag = params.onCloseTag, onOpenTag = params.onOpenTag;
@@ -191,117 +306,6 @@ var XMLParser = /** @class */ (function () {
         });
         return textByColKey;
     };
-    XMLParser.prototype.getDocumentNode = function (params) {
-        var xml = params.xml;
-        var rowsArr = [];
-        var colsArr = [];
-        var documentNode = new DocumentNode_1.DocumentNode();
-        var curNode = null;
-        var prevRowCols = [];
-        var curRowCols = [];
-        var isBold = false;
-        var boldPath = null;
-        var pushColToRow = function (col) {
-            var _a;
-            var colIndex = curRowCols.length;
-            col.setIndex(colIndex);
-            var colSpan = col.getColSpan();
-            Array.from({ length: colSpan }).forEach(function () { return curRowCols.push(col); });
-            var topSibling = (_a = prevRowCols[colIndex]) !== null && _a !== void 0 ? _a : null;
-            topSibling === null || topSibling === void 0 ? void 0 : topSibling.addBottomSibling(col);
-        };
-        this.iterateXML({
-            xml: xml,
-            onCloseTag: function (_a) {
-                var _b;
-                var path = _a.path;
-                var tag = path.split('.').pop();
-                if ((curNode === null || curNode === void 0 ? void 0 : curNode.getPath()) === boldPath) {
-                    curNode === null || curNode === void 0 ? void 0 : curNode.setText("".concat((_b = curNode === null || curNode === void 0 ? void 0 : curNode.getText()) !== null && _b !== void 0 ? _b : '', "}}"));
-                    boldPath = null;
-                }
-            },
-            onCharacter: function (_a) {
-                var _b;
-                var char = _a.char;
-                curNode === null || curNode === void 0 ? void 0 : curNode.setText(((_b = curNode === null || curNode === void 0 ? void 0 : curNode.getText()) !== null && _b !== void 0 ? _b : '') + char);
-            },
-            onOpenTag: function (_a) {
-                var _b;
-                var path = _a.path, attributesStr = _a.attributesStr;
-                // skip nested tables
-                if (path.split('.').reduce(function (acc, cur) { return (cur === 'table' ? acc + 1 : acc); }, 0) > 1)
-                    return;
-                var tag = path.split('.').pop();
-                var isInTable = path.includes('table');
-                var topLevelNodes = documentNode.getChildren();
-                var prevTopLevelNode = topLevelNodes[topLevelNodes.length - 1];
-                var wasHorizontalLine = prevTopLevelNode instanceof HRNode_1.HRNode;
-                var wasNonTableNode = prevTopLevelNode instanceof NonTableNode_1.NonTableNode;
-                var wasBold = isBold;
-                var attributesLower = attributesStr.toLowerCase().replace(/\s/g, '');
-                isBold =
-                    tag === 'b' ||
-                        tag === 'strong' ||
-                        attributesLower.includes('font-weight:bold') ||
-                        attributesLower.includes('font-weight:700') ||
-                        attributesLower.includes('font-weight:800') ||
-                        attributesLower.includes('font-weight:900');
-                if (!isInTable) {
-                    prevRowCols = [];
-                    curRowCols = [];
-                }
-                if (tag === 'hr' && !isInTable) {
-                    var hr = new HRNode_1.HRNode({ attributesStr: attributesStr, path: path });
-                    hr.setPreviousSibling(prevTopLevelNode !== null && prevTopLevelNode !== void 0 ? prevTopLevelNode : null);
-                    topLevelNodes.push(hr);
-                    curNode = hr;
-                }
-                else if (tag === 'table') {
-                    var table = new TableNode_1.TableNode({ attributesStr: attributesStr, path: path });
-                    table.setPreviousSibling(prevTopLevelNode !== null && prevTopLevelNode !== void 0 ? prevTopLevelNode : null);
-                    topLevelNodes.push(table);
-                    curNode = table;
-                }
-                else if (tag === 'tr') {
-                    var row = new RowNode_1.RowNode({ attributesStr: attributesStr, path: path });
-                    var prevRow = rowsArr[rowsArr.length - 1];
-                    row.setParent(prevTopLevelNode);
-                    row.setPreviousSibling((prevRow === null || prevRow === void 0 ? void 0 : prevRow.getParent()) === row.getParent() ? prevRow : null);
-                    rowsArr.push(row);
-                    prevRowCols = curRowCols;
-                    curRowCols = [];
-                    curNode = row;
-                }
-                else if (tag === 'td' || tag === 'th') {
-                    var col = new ColNode_1.ColNode({ attributesStr: attributesStr, path: path });
-                    var prevCol = colsArr[colsArr.length - 1];
-                    col.setParent(rowsArr[rowsArr.length - 1]);
-                    col.setPreviousSibling((prevCol === null || prevCol === void 0 ? void 0 : prevCol.getParent()) === col.getParent() ? prevCol : null);
-                    colsArr.push(col);
-                    pushColToRow(col);
-                    curNode = col;
-                }
-                else if ((!isInTable && !wasNonTableNode) || (wasHorizontalLine && tag !== 'hr')) {
-                    var node = new NonTableNode_1.NonTableNode({ attributesStr: attributesStr, path: path });
-                    node.setPreviousSibling(prevTopLevelNode !== null && prevTopLevelNode !== void 0 ? prevTopLevelNode : null);
-                    topLevelNodes.push(node);
-                    curNode = node;
-                }
-                else if (curNode && !curNode.getText().endsWith('\n')) {
-                    curNode.setText("".concat(curNode.getText().trim(), "\n"));
-                }
-                if (isBold && !wasBold && !(curNode === null || curNode === void 0 ? void 0 : curNode.getText().endsWith('{{'))) {
-                    curNode === null || curNode === void 0 ? void 0 : curNode.setText("".concat(curNode === null || curNode === void 0 ? void 0 : curNode.getText().trim(), "{{"));
-                }
-                if (isBold) {
-                    boldPath = (_b = curNode === null || curNode === void 0 ? void 0 : curNode.getPath()) !== null && _b !== void 0 ? _b : null;
-                }
-            },
-        });
-        documentNode.setText(xml);
-        return documentNode;
-    };
     return XMLParser;
 }());
 exports.default = XMLParser;

package/build/services/DocumentParser/parsers/index.d.ts

@@ -1,11 +1,13 @@
-import { parseForm4 } from './parse-form-4';
+import { parseCurrentFilings } from './parse-current-filings';
+import { parseForm13f } from './parse-form-13f';
 import { parseForm13g } from './parse-form-13g';
-import { parseForm10k } from './parse-form-10k';
+import { parseForm4 } from './parse-form-4';
 import { parseFormDef14a } from './parse-form-def14a';
 declare const parsers: {
     parseForm4: typeof parseForm4;
     parseForm13g: typeof parseForm13g;
-    parseForm10k: typeof parseForm10k;
+    parseForm13f: typeof parseForm13f;
     parseFormDef14a: typeof parseFormDef14a;
+    parseCurrentFilings: typeof parseCurrentFilings;
 };
 export default parsers;

package/build/services/DocumentParser/parsers/index.js

@@ -1,13 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-var parse_form_4_1 = require("./parse-form-4");
+var parse_current_filings_1 = require("./parse-current-filings");
+var parse_form_13f_1 = require("./parse-form-13f");
 var parse_form_13g_1 = require("./parse-form-13g");
-var parse_form_10k_1 = require("./parse-form-10k");
+var parse_form_4_1 = require("./parse-form-4");
 var parse_form_def14a_1 = require("./parse-form-def14a");
 var parsers = {
     parseForm4: parse_form_4_1.parseForm4,
     parseForm13g: parse_form_13g_1.parseForm13g,
-    parseForm10k: parse_form_10k_1.parseForm10k,
+    parseForm13f: parse_form_13f_1.parseForm13f,
     parseFormDef14a: parse_form_def14a_1.parseFormDef14a,
+    parseCurrentFilings: parse_current_filings_1.parseCurrentFilings,
 };
 exports.default = parsers;

package/build/services/DocumentParser/parsers/parse-current-filings.d.ts

@@ -0,0 +1,3 @@
+import { XMLParams } from '../../../types';
+import { CurrentFilingsList } from '../../../types/current-filings.type';
+export declare function parseCurrentFilings(params: XMLParams): CurrentFilingsList;

package/build/services/DocumentParser/parsers/parse-current-filings.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseCurrentFilings = void 0;
+var fast_xml_parser_1 = require("fast-xml-parser");
+function parseCurrentFilings(params) {
+    var _a;
+    var parser = new fast_xml_parser_1.XMLParser({ ignoreAttributes: false });
+    var json = parser.parse(params.xml);
+    var toArray = function (value) { return (Array.isArray(value) ? value : [value]).filter(Boolean); };
+    var toObject = function (value) {
+        value = Array.isArray(value) ? value[0] : value;
+        return (value && typeof value === 'object' ? value : {});
+    };
+    var toString = function (value) { return String(value || ''); };
+    var toNumber = function (value) { return Number(value) || 0; };
+    var toBoolean = function (value) {
+        var isFalseStr = ['false', '0', 'no', 'null', 'undefined'].includes(String(value).toLowerCase());
+        return isFalseStr ? false : Boolean(value);
+    };
+    var toDateStr = function (value) {
+        var _a = value.split('/'), month = _a[0], day = _a[1], year = _a[2];
+        return "".concat(year, "-").concat(month, "-").concat(day);
+    };
+    var parseConcatDate = function (value) {
+        var acceptanceDateTime = toString(toNumber(value));
+        var year = acceptanceDateTime.slice(0, 4);
+        var month = acceptanceDateTime.slice(4, 6);
+        var day = acceptanceDateTime.slice(6, 8);
+        var hour = acceptanceDateTime.slice(8, 10);
+        var minute = acceptanceDateTime.slice(10, 12);
+        var second = acceptanceDateTime.slice(12, 14);
+        return acceptanceDateTime.length < 9
+            ? "".concat(year, "-").concat(month, "-").concat(day)
+            : "".concat(year, "-").concat(month, "-").concat(day, " ").concat(hour, ":").concat(minute, ":").concat(second);
+    };
+    var parseFiscalYearEnd = function (value) {
+        var str = toString(value).padStart(4, '0');
+        var month = str.slice(0, 2);
+        var day = str.slice(2, 4);
+        return "".concat(month, "-").concat(day);
+    };
+    var channelXML = toObject((_a = json === null || json === void 0 ? void 0 : json.rss) === null || _a === void 0 ? void 0 : _a.channel);
+    var description = channelXML.description, item = channelXML.item, language = channelXML.language, lastBuildDate = channelXML.lastBuildDate, link = channelXML.link, pubDate = channelXML.pubDate, title = channelXML.title;
+    var atomLink = toObject(channelXML['atom:link']);
+    var itemsXML = toArray(item);
+    return {
+        title: toString(title),
+        link: toString(link),
+        href: toString(atomLink['@_href']),
+        description: toString(description),
+        language: toString(language),
+        pubDate: toString(pubDate),
+        lastBuildDate: toString(lastBuildDate),
+        items: itemsXML.map(function (itemXML) {
+            var _a;
+            itemXML = toObject(itemXML);
+            var enclosure = toObject(itemXML.enclosure);
+            var filing = toObject(itemXML['edgar:xbrlFiling']);
+            var xbrlFilesXML = toArray((_a = filing['edgar:xbrlFiles']) === null || _a === void 0 ? void 0 : _a['edgar:xbrlFile']);
+            return {
+                title: toString(itemXML.title),
+                link: toString(itemXML.link),
+                guid: toString(itemXML.guid),
+                enclosureUrl: toString(enclosure['@_url']),
+                enclosureLength: toString(enclosure['@_length']),
+                enclosureType: toString(enclosure['@_type']),
+                description: toString(itemXML.description),
+                pubDate: toString(itemXML.pubDate),
+                filing: {
+                    companyName: toString(filing['edgar:companyName']),
+                    formType: toString(filing['edgar:formType']),
+                    filingDate: toDateStr(filing['edgar:filingDate']),
+                    cikNumber: toNumber(filing['edgar:cikNumber']),
+                    accessionNumber: toString(filing['edgar:accessionNumber']),
+                    fileNumber: toString(filing['edgar:fileNumber']),
+                    acceptanceDatetime: parseConcatDate(filing['edgar:acceptanceDatetime']),
+                    period: parseConcatDate(filing['edgar:period']),
+                    assistantDirector: toString(filing['edgar:assistantDirector']),
+                    assignedSic: toNumber(filing['edgar:assignedSic']),
+                    fiscalYearEnd: parseFiscalYearEnd(filing['edgar:fiscalYearEnd']),
+                    xbrlFiles: xbrlFilesXML.map(function (xbrlFileXML) {
+                        xbrlFileXML = toObject(xbrlFileXML);
+                        return {
+                            sequence: toNumber(xbrlFileXML['@_edgar:sequence']),
+                            file: toString(xbrlFileXML['@_edgar:file']),
+                            type: toString(xbrlFileXML['@_edgar:type']),
+                            size: toNumber(xbrlFileXML['@_edgar:size']),
+                            description: toString(xbrlFileXML['@_edgar:description']),
+                            inlineXBRL: toBoolean(xbrlFileXML['@_edgar:inlineXBRL']),
+                            url: toString(xbrlFileXML['@_edgar:url']),
+                        };
+                    }),
+                },
+            };
+        }),
+    };
+}
+exports.parseCurrentFilings = parseCurrentFilings;

package/build/services/DocumentParser/parsers/parse-form-13f.d.ts

@@ -0,0 +1,6 @@
+import { Form13FData, XMLParams } from '../../../types';
+import XMLParser from '../XMLParser';
+/**
+ * Form 13F - Holdings Report
+ */
+export declare function parseForm13f(params: XMLParams, xmlParser?: XMLParser): Form13FData;

package/build/services/DocumentParser/parsers/parse-form-13f.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseForm13f = void 0;
+var XMLParser_1 = require("../XMLParser");
+/**
+ * Form 13F - Holdings Report
+ */
+function parseForm13f(params, xmlParser) {
+    var _a, _b;
+    if (xmlParser === void 0) { xmlParser = new XMLParser_1.default(); }
+    var json = xmlParser.parse(params.xml);
+    var informationTable = xmlParser.extractJsonKey(json, 'informationTable');
+    var edgarSubmission = xmlParser.extractJsonKey(json, 'edgarSubmission');
+    var toArray = function (value) { return (Array.isArray(value) ? value : [value]).filter(Boolean); };
+    var formData = edgarSubmission.formData, headerData = edgarSubmission.headerData;
+    var _c = headerData !== null && headerData !== void 0 ? headerData : {}, filerInfo = _c.filerInfo, submissionType = _c.submissionType;
+    var _d = filerInfo !== null && filerInfo !== void 0 ? filerInfo : {}, filer = _d.filer, flags = _d.flags, _e = _d.liveTestFlag, liveTestFlag = _e === void 0 ? '' : _e, periodOfReport = _d.periodOfReport;
+    var _f = flags !== null && flags !== void 0 ? flags : {}, _g = _f.confirmingCopyFlag, confirmingCopyFlag = _g === void 0 ? false : _g, _h = _f.overrideInternetFlag, overrideInternetFlag = _h === void 0 ? false : _h, _j = _f.returnCopyFlag, returnCopyFlag = _j === void 0 ? false : _j;
+    var _k = (_a = filer === null || filer === void 0 ? void 0 : filer.credentials) !== null && _a !== void 0 ? _a : {}, _l = _k.ccc, ccc = _l === void 0 ? '' : _l, _m = _k.cik, cik = _m === void 0 ? 0 : _m;
+    var coverPage = formData.coverPage, signatureBlock = formData.signatureBlock, summaryPage = formData.summaryPage;
+    var _o = coverPage !== null && coverPage !== void 0 ? coverPage : {}, filingManager = _o.filingManager, form13FFileNumber = _o.form13FFileNumber, otherManagersInfo = _o.otherManagersInfo, provideInfoForInstruction5 = _o.provideInfoForInstruction5, reportCalendarOrQuarter = _o.reportCalendarOrQuarter, reportType = _o.reportType;
+    var _p = filingManager !== null && filingManager !== void 0 ? filingManager : {}, address = _p.address, filingManagerName = _p.name;
+    var _q = summaryPage !== null && summaryPage !== void 0 ? summaryPage : {}, isConfidentialOmitted = _q.isConfidentialOmitted, otherIncludedManagersCount = _q.otherIncludedManagersCount, otherManagers2Info = _q.otherManagers2Info, tableEntryTotal = _q.tableEntryTotal, tableValueTotal = _q.tableValueTotal;
+    var _r = signatureBlock !== null && signatureBlock !== void 0 ? signatureBlock : {}, city = _r.city, signatureName = _r.name, phone = _r.phone, signature = _r.signature, signatureDate = _r.signatureDate, stateOrCountry = _r.stateOrCountry, title = _r.title;
+    var otherManager = (otherManagersInfo !== null && otherManagersInfo !== void 0 ? otherManagersInfo : {}).otherManager;
+    var otherManagers2 = (_b = otherManagers2Info.otherManager2) !== null && _b !== void 0 ? _b : [];
+    return {
+        submissionType: String(submissionType || ''),
+        periodOfReport: String(periodOfReport || ''),
+        cik: Number(cik) || 0,
+        ccc: String(ccc || ''),
+        form13FFileNumber: String(form13FFileNumber || ''),
+        liveTestFlag: String(liveTestFlag || ''),
+        reportCalendarOrQuarter: String(reportCalendarOrQuarter || ''),
+        reportType: String(reportType || ''),
+        confirmingCopyFlag: Boolean(confirmingCopyFlag),
+        overrideInternetFlag: Boolean(overrideInternetFlag),
+        returnCopyFlag: Boolean(returnCopyFlag),
+        filingManager: {
+            name: String(filingManagerName || ''),
+            ns1City: String(address['ns1:city'] || ''),
+            ns1StateOrCountry: String(address['ns1:stateOrCountry'] || ''),
+            ns1Street1: String(address['ns1:street1'] || ''),
+            ns1ZipCode: String(address['ns1:zipCode'] || 0),
+        },
+        otherManagers: toArray(otherManager).map(function (otherManager) { return ({
+            sequenceNumber: Number(otherManager.sequenceNumber) || -1,
+            form13FFileNumber: String(otherManager.form13FFileNumber || ''),
+            name: String(otherManager.name || ''),
+        }); }),
+        provideInfoForInstruction5: String(provideInfoForInstruction5 || ''),
+        signatureBlock: {
+            city: String(city || ''),
+            name: String(signatureName || ''),
+            phone: String(phone || ''),
+            signature: String(signature || ''),
+            signatureDate: String(signatureDate || ''),
+            stateOrCountry: String(stateOrCountry || ''),
+            title: String(title || ''),
+        },
+        otherManagers2: toArray(otherManagers2).map(function (otherManager) { return ({
+            sequenceNumber: Number(otherManager.sequenceNumber) || -1,
+            name: String(otherManager.otherManager.name || ''),
+            form13FFileNumber: String(otherManager.otherManager.form13FFileNumber || ''),
+        }); }),
+        otherIncludedManagersCount: Number(otherIncludedManagersCount || 0),
+        tableEntryTotal: Number(tableEntryTotal || 0),
+        tableValueTotal: Number(tableValueTotal || 0),
+        isConfidentialOmitted: Boolean(isConfidentialOmitted),
+        infoTable: toArray(informationTable.infoTable).map(function (infoTable) {
+            var _a = infoTable !== null && infoTable !== void 0 ? infoTable : {}, cusip = _a.cusip, investmentDiscretion = _a.investmentDiscretion, nameOfIssuer = _a.nameOfIssuer, otherManager = _a.otherManager, shrsOrPrnAmt = _a.shrsOrPrnAmt, titleOfClass = _a.titleOfClass, value = _a.value, votingAuthority = _a.votingAuthority;
+            var _b = votingAuthority !== null && votingAuthority !== void 0 ? votingAuthority : {}, votingAuthorityNone = _b.None, votingAuthorityShared = _b.Shared, votingAuthoritySole = _b.Sole;
+            return {
+                nameOfIssuer: String(nameOfIssuer || ''),
+                titleOfClass: String(titleOfClass || ''),
+                cusip: String(cusip || ''),
+                value: Number(value) || 0,
+                sharesOrPrincipalAmount: Number((shrsOrPrnAmt === null || shrsOrPrnAmt === void 0 ? void 0 : shrsOrPrnAmt.sshPrnamt) || 0) || 0,
+                isPrincipalAmount: (shrsOrPrnAmt === null || shrsOrPrnAmt === void 0 ? void 0 : shrsOrPrnAmt.sshPrnamtType) !== 'SH',
+                investmentDiscretion: String(investmentDiscretion || ''),
+                votingAuthoritySole: Number(votingAuthoritySole) || 0,
+                votingAuthorityShared: Number(votingAuthorityShared) || 0,
+                votingAuthorityNone: Number(votingAuthorityNone) || 0,
+                otherManagers: String(otherManager || '')
+                    .split(',')
+                    .map(Number),
+            };
+        }),
+    };
+}
+exports.parseForm13f = parseForm13f;

package/build/services/DocumentParser/parsers/parse-form-13g.js

@@ -58,7 +58,7 @@ function parseForm13g(params, xmlParser) {
             return "continue";
         var textParts = text.split(' ').filter(function (t) { return t.trim() !== ''; });
         var colNameIndex = textParts.findIndex(function (t) { return getKey(t) === colName; });
-        var value = (_c = (_b = textParts[colNameIndex + 1]) === null || _b === void 0 ? void 0 : _b.trim()) !== null && _c !== void 0 ? _c : '';
+        var value = ((_c = (_b = textParts[colNameIndex + 1]) === null || _b === void 0 ? void 0 : _b.trim()) !== null && _c !== void 0 ? _c : '').replace(/&.*?;/g, ' ').replace(/\s+/g, ' ').trim();
         switch (colName) {
             case 'shares':
                 holder.shares = Number(value.replace(/[^0-9]/g, '')) || 0;
@@ -83,6 +83,6 @@ function parseForm13g(params, xmlParser) {
     if (((_d = holders[holders.length - 1]) === null || _d === void 0 ? void 0 : _d.name) === '') {
         holders.pop();
     }
-    return { holders: holders };
+    return { institutionalHolders: holders };
 }
 exports.parseForm13g = parseForm13g;

package/build/services/DocumentParser/parsers/parse-form-4.d.ts

@@ -1,7 +1,12 @@
 import { Form4Data, XMLParams } from '../../../types';
 import XMLParser from '../XMLParser';
 /**
- * Form 4 - Insider Transactions
+ * Form 4 and form 5 - Insider Transactions
+ *
+ * TODO: sometimes not working. keys not consistently coming back objects vs arrays:
+ *
+ * here reporting owner is array, so not being extracted correctly
+ * https://www.sec.gov/Archives/edgar/data/1067983/000095017024044198/0000950170-24-044198.txt
  *
  * example at https://www.sec.gov/Archives/edgar/data/320193/000032019323000079/xslF345X05/wk-form4_1691533817.xml
  */