sec-edgar-api 0.5.7 → 0.5.9

package/build/services/DocumentParser/parsers/parse-xbrl.d.ts

@@ -1,4 +1,4 @@
-import type { FactItemExtended, ReportRaw, XMLParams } from '../../../types';
+import type { FactItemExtended, FiscalPeriod, ReportRaw, XMLParams } from '../../../types';
 import { GetDocumentXbrlParams } from '../../SecEdgarApi';
 import { XbrlParseResult } from '../XBRLParser/XBRLParser';
 interface ReportWithPeriod extends ReportRaw {
@@ -9,6 +9,8 @@ interface ReportWithPeriod extends ReportRaw {
 }
 export interface DocumentXbrlResult extends XbrlParseResult {
     report: ReportRaw | null;
+    fiscalYear: number;
+    fiscalPeriod: FiscalPeriod;
     facts: FactItemExtended[];
     xml: string;
     /** Facts grouped into reports by their start and end dates */

package/build/services/DocumentParser/parsers/parse-xbrl.js

@@ -106,10 +106,12 @@ function buildReportsFromFacts(params) {
         var el = fact;
         var scale = Number((_q = el.scale) !== null && _q !== void 0 ? _q : 0) || 0;
         var decimals = Number((_r = el.decimals) !== null && _r !== void 0 ? _r : 0) || 0;
-        var suffix = (_s = fact === null || fact === void 0 ? void 0 : fact.segments) === null || _s === void 0 ? void 0 : _s.map(function (_a) {
-            var dimension = _a.dimension, value = _a.value;
-            return "".concat(dimension).concat(pathSeparator).concat(value);
-        }).join(pathSeparator);
+        var suffix = fact.name.includes(pathSeparator)
+            ? null
+            : (_s = fact === null || fact === void 0 ? void 0 : fact.segments) === null || _s === void 0 ? void 0 : _s.map(function (_a) {
+                var dimension = _a.dimension, value = _a.value;
+                return "".concat(dimension).concat(pathSeparator).concat(value);
+            }).join(pathSeparator);
         var nameKey = suffix ? "".concat(fact.name).concat(pathSeparator).concat(suffix) : fact.name;
         var roundPlaces = scale + decimals;
         var prevFactKey = "".concat(nameKey, "-").concat(dateKey);
@@ -184,8 +186,23 @@ function parseXbrl(params) {
         }
         facts.push(factParsed);
     }
+    var fiscalPeriodFact = facts.find(function (f) { return f.name === 'dei:DocumentFiscalPeriodFocus'; });
+    var fiscalYearFact = facts.find(function (f) { return f.name === 'dei:DocumentFiscalYearFocus'; });
+    var fiscalYear = fiscalYearFact ? Number(fiscalYearFact.value) : 0;
+    var fiscalPeriod = fiscalPeriodFact ? fiscalPeriodFact.value : 'FY';
+    if (!fiscalPeriodFact || !fiscalYearFact) {
+        var fiscalCalculator = new FactFiscalCalculator_1.default({
+            fiscalYearEnd: {
+                day: Number(response.header.fiscalYearEnd.substring(2)),
+                month: Number(response.header.fiscalYearEnd.substring(0, 2)),
+            },
+        });
+        var _p = fiscalCalculator.getFiscalYearQuarter({ dateStr: response.header.reportDate }), quarter = _p.quarter, year = _p.year;
+        fiscalYear = year;
+        fiscalPeriod = (quarter === 4 ? 'FY' : "Q".concat(quarter));
+    }
     var factsForBuilder = includeReport ? facts : [];
-    var _p = buildReportsFromFacts({
+    var _q = buildReportsFromFacts({
         facts: factsForBuilder,
         pathSeparator: '>',
         fiscalPeriod: (_g = factsForBuilder.find(function (f) { return f.name === 'dei:DocumentFiscalPeriodFocus'; })) === null || _g === void 0 ? void 0 : _g.value,
@@ -209,7 +226,7 @@ function parseXbrl(params) {
             url: "https://www.sec.gov/Archives/edgar/data/".concat(cik, "/").concat(accessionNumberNoHyphens, "/").concat(accessionNumber, ".txt"),
             urlPrimaryDocument: '',
         },
-    }), factsFiltered = _p.factsFiltered, reportFocus = _p.reportFocus, reportByDateRange = _p.reportByDateRange;
-    return __assign(__assign({}, response), { facts: factsFiltered, report: factsFiltered.length > 0 ? reportFocus : null, xml: xml, periodReports: Object.values(reportByDateRange) });
+    }), factsFiltered = _q.factsFiltered, reportFocus = _q.reportFocus, reportByDateRange = _q.reportByDateRange;
+    return __assign(__assign({}, response), { fiscalYear: fiscalYear, fiscalPeriod: fiscalPeriod, facts: factsFiltered, report: factsFiltered.length > 0 ? reportFocus : null, xml: xml, periodReports: Object.values(reportByDateRange) });
 }
 exports.parseXbrl = parseXbrl;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sec-edgar-api",
-    "version": "0.5.7",
+    "version": "0.5.9",
     "description": "Fetch and parse SEC earnings reports and other filings. Useful for financial analysis.",
     "main": "build/index.js",
     "author": "Andrew Evers (https://github.com/andyevers)",