sec-edgar-api 0.5.1 → 0.5.3

package/build/index.d.ts

@@ -2,6 +2,7 @@ import ReportParser from './services/ReportParser';
 import SecEdgarApi from './services/SecEdgarApi';
 import ReportResolvable from './services/ReportParser/ReportResolvable';
 import { utilMap } from './util/util-map';
+import FactFiscalCalculator from './services/ReportRawBuilder/FactFiscalCalculator';
 /**
  * Takes company facts data from the SEC and translates them to
  * reports as json objects.
@@ -14,5 +15,5 @@ declare const reportParser: ReportParser;
  * @see https://www.sec.gov/edgar/sec-api-documentation
  */
 declare const secEdgarApi: SecEdgarApi;
-export { reportParser, secEdgarApi, ReportResolvable, utilMap };
+export { reportParser, secEdgarApi, ReportResolvable, utilMap, FactFiscalCalculator };
 export type * from './types';

package/build/index.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.utilMap = exports.ReportResolvable = exports.secEdgarApi = exports.reportParser = void 0;
+exports.FactFiscalCalculator = exports.utilMap = exports.ReportResolvable = exports.secEdgarApi = exports.reportParser = void 0;
 var ReportParser_1 = require("./services/ReportParser");
 var SecEdgarApi_1 = require("./services/SecEdgarApi");
 var ReportResolvable_1 = require("./services/ReportParser/ReportResolvable");
 exports.ReportResolvable = ReportResolvable_1.default;
 var util_map_1 = require("./util/util-map");
 Object.defineProperty(exports, "utilMap", { enumerable: true, get: function () { return util_map_1.utilMap; } });
+var FactFiscalCalculator_1 = require("./services/ReportRawBuilder/FactFiscalCalculator");
+exports.FactFiscalCalculator = FactFiscalCalculator_1.default;
 /**
  * Takes company facts data from the SEC and translates them to
  * reports as json objects.

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

@@ -2,6 +2,7 @@ import { XMLParams } from '../../types';
 import { GetDocumentXbrlParams } from '../SecEdgarApi';
 import XMLParser from './XMLParserLegacy';
 import parsers from './parsers';
+import { DocumentXbrlResult } from './parsers/parse-xbrl';
 interface DocumentParserArgs {
     parser?: XMLParser;
     parsersByName?: typeof parsers;
@@ -36,10 +37,6 @@ export default class DocumentParser {
     };
     parseCurrentFilings(params: XMLParams): import("../../types").CurrentFilingsList;
     parseCurrentFilingsXbrl(params: XMLParams): import("../../types").CurrentFilingsXBRL;
-    parseXbrl(params: XMLParams & GetDocumentXbrlParams): import("./XBRLParser/XBRLParser").XbrlParseResult & {
-        report: import("../../types").ReportRaw | null;
-        facts: import("../../types").FactItemExtended[];
-        xml: string;
-    };
+    parseXbrl(params: XMLParams & GetDocumentXbrlParams): DocumentXbrlResult;
 }
 export {};

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

@@ -1,8 +1,17 @@
 import type { FactItemExtended, ReportRaw, XMLParams } from '../../../types';
 import { GetDocumentXbrlParams } from '../../SecEdgarApi';
 import { XbrlParseResult } from '../XBRLParser/XBRLParser';
-export declare function parseXbrl(params: XMLParams & GetDocumentXbrlParams): XbrlParseResult & {
+interface ReportWithPeriod extends ReportRaw {
+    period: number;
+    startDate: string;
+    endDate: string;
+}
+export interface DocumentXbrlResult extends XbrlParseResult {
     report: ReportRaw | null;
     facts: FactItemExtended[];
     xml: string;
-};
+    /** Facts grouped into reports by their start and end dates */
+    periodReports: ReportWithPeriod[];
+}
+export declare function parseXbrl(params: XMLParams & GetDocumentXbrlParams): DocumentXbrlResult;
+export {};

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

@@ -24,15 +24,19 @@ var __rest = (this && this.__rest) || function (s, e) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseXbrl = void 0;
 var constants_1 = require("../../../util/constants");
+var FactFiscalCalculator_1 = require("../../ReportRawBuilder/FactFiscalCalculator");
+var FactPeriodResolver_1 = require("../../ReportRawBuilder/FactPeriodResolver");
 var XBRLParser_1 = require("../XBRLParser/XBRLParser");
 function isWithinDays(params) {
     var dateA = params.dateA, dateB = params.dateB, days = params.days;
+    if (dateA === dateB)
+        return true;
     var timeDiff = Math.abs(new Date(dateA).getTime() - new Date(dateB).getTime());
     var daysDiff = timeDiff / (1000 * 3600 * 24);
     return daysDiff < days;
 }
 function buildReportsFromFacts(params) {
-    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s;
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
     var filing = params.filing, facts = params.facts, fiscalPeriod = params.fiscalPeriod, fiscalYear = params.fiscalYear, pathSeparator = params.pathSeparator, cikProp = params.cik;
     var urlParts = (_a = filing === null || filing === void 0 ? void 0 : filing.url.split('/')) !== null && _a !== void 0 ? _a : [];
     var cik = cikProp !== null && cikProp !== void 0 ? cikProp : urlParts[(_b = urlParts.indexOf('data')) !== null && _b !== void 0 ? _b : -1];
@@ -59,22 +63,49 @@ function buildReportsFromFacts(params) {
     var roundPlacesByName = new Map();
     var scaleByName = new Map();
     var isFocusFactByDateKey = new Map();
+    var dateYearEnd = new Date(reportFocus.dateReport);
+    var offsetByFiscalPeriod = { Q1: 9, Q2: 6, Q3: 3, Q4: 0, FY: 0 };
+    dateYearEnd.setMonth(dateYearEnd.getMonth() + ((_h = offsetByFiscalPeriod[reportFocus.fiscalPeriod]) !== null && _h !== void 0 ? _h : 0));
+    var fiscalCalculator = new FactFiscalCalculator_1.default({
+        filings: filing ? [filing] : undefined,
+        facts: facts,
+        fiscalYearEnd: { day: dateYearEnd.getDate(), month: dateYearEnd.getMonth() + 1 },
+    });
+    var fiscalsByDateKey = new Map();
     for (var _i = 0, facts_1 = facts; _i < facts_1.length; _i++) {
         var fact = facts_1[_i];
         var dateKey = fact.start ? "".concat(fact.start, "_").concat(fact.end) : fact.end;
-        (_h = reportByDateRange[dateKey]) !== null && _h !== void 0 ? _h : (reportByDateRange[dateKey] = {
-            startDate: (_j = fact.start) !== null && _j !== void 0 ? _j : '',
+        if (!fiscalsByDateKey.has(dateKey)) {
+            var _x = fiscalCalculator.getFiscalYearQuarter({ dateStr: fact.end }), quarter = _x.quarter, year = _x.year;
+            var period = FactPeriodResolver_1.default.getPeriod({ end: fact.end, start: fact.start });
+            var fiscalPeriod_1 = (period === 12 && quarter === 4 ? 'FY' : "Q".concat(quarter));
+            fiscalsByDateKey.set(dateKey, { fiscalYear: year, fiscalPeriod: fiscalPeriod_1 });
+        }
+        (_j = reportByDateRange[dateKey]) !== null && _j !== void 0 ? _j : (reportByDateRange[dateKey] = {
+            cik: reportFocus.cik,
+            url: '',
+            splitDate: (_k = splitFact === null || splitFact === void 0 ? void 0 : splitFact.end) !== null && _k !== void 0 ? _k : null,
+            splitRatio: (splitFact === null || splitFact === void 0 ? void 0 : splitFact.value) ? Number(splitFact.value) : null,
+            dateFiled: reportFocus.dateFiled,
+            dateReport: fact.end,
+            fiscalPeriod: (_l = fiscalsByDateKey.get(dateKey)) === null || _l === void 0 ? void 0 : _l.fiscalPeriod,
+            startDate: (_m = fact.start) !== null && _m !== void 0 ? _m : '',
             endDate: fact.end,
+            fiscalYear: (_o = fiscalsByDateKey.get(dateKey)) === null || _o === void 0 ? void 0 : _o.fiscalYear,
+            period: FactPeriodResolver_1.default.getPeriod({ start: fact.start, end: fact.end }),
         });
         var isSplitFact = fact === splitFact;
-        var isFocusFact = (_k = isFocusFactByDateKey.get(dateKey)) !== null && _k !== void 0 ? _k : (isWithinDays({ dateA: fact.end, dateB: reportFocus.dateReport, days: 45 }) || isSplitFact);
+        var isFocusFact = (_p = isFocusFactByDateKey.get(dateKey)) !== null && _p !== void 0 ? _p : (isWithinDays({ dateA: fact.end, dateB: reportFocus.dateReport, days: 45 }) || isSplitFact);
+        if (isFocusFact) {
+            fact.isCurrentPeriod = true;
+        }
         if (!isSplitFact) {
             isFocusFactByDateKey.set(dateKey, isFocusFact);
         }
         var el = fact;
-        var scale = Number((_l = el.scale) !== null && _l !== void 0 ? _l : 0) || 0;
-        var decimals = Number((_m = el.decimals) !== null && _m !== void 0 ? _m : 0) || 0;
-        var suffix = (_o = fact === null || fact === void 0 ? void 0 : fact.segments) === null || _o === void 0 ? void 0 : _o.map(function (_a) {
+        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);
@@ -88,8 +119,8 @@ function buildReportsFromFacts(params) {
             var prevRounding = roundPlacesByName.get(prevFactKey);
             var prevScale = scaleByName.get(prevFactKey);
             var prevFact_1 = factByName.get(prevFactKey);
-            var prevUnit = (_q = (_p = prevFact_1 === null || prevFact_1 === void 0 ? void 0 : prevFact_1.unit) === null || _p === void 0 ? void 0 : _p.split('_').pop()) === null || _q === void 0 ? void 0 : _q.toLowerCase();
-            var unit = (_s = (_r = fact.unit) === null || _r === void 0 ? void 0 : _r.split('_').pop()) === null || _s === void 0 ? void 0 : _s.toLowerCase();
+            var prevUnit = (_u = (_t = prevFact_1 === null || prevFact_1 === void 0 ? void 0 : prevFact_1.unit) === null || _t === void 0 ? void 0 : _t.split('_').pop()) === null || _u === void 0 ? void 0 : _u.toLowerCase();
+            var unit = (_w = (_v = fact.unit) === null || _v === void 0 ? void 0 : _v.split('_').pop()) === null || _w === void 0 ? void 0 : _w.toLowerCase();
             var shouldSkip = [
                 (prevUnit === null || prevUnit === void 0 ? void 0 : prevUnit.length) === 3 && (unit === null || unit === void 0 ? void 0 : unit.length) === 3 && prevUnit !== unit && prevUnit === 'usd',
                 (prevRounding !== null && prevRounding !== void 0 ? prevRounding : 0) < roundPlaces,
@@ -177,7 +208,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;
-    return __assign(__assign({}, response), { facts: factsFiltered, report: factsFiltered.length > 0 ? reportFocus : null, xml: xml });
+    }), 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) });
 }
 exports.parseXbrl = parseXbrl;

package/build/services/ReportParser/ReportParser.d.ts

@@ -31,16 +31,16 @@ export default class ReportParser {
     /**
      * Same as parseReports but accepts ReportRaw[] instead of CompanyFactListData
      */
-    parseReportsFromRaw<T = ReportTranslated>(params: {
-        reportsRaw: ReportRaw[];
+    translateReport<T = ReportTranslated>(params: {
+        report: ReportRaw;
         calculationMap?: CalculationMap<T>;
-    }): (ReportRaw & T)[];
+    }): ReportRaw & T;
     /**
      * Parse raw reports
      *
      * @see https://www.sec.gov/edgar/sec-api-documentation
      */
-    parseReportsRaw(companyFactListData: CompanyFactListData, options: Omit<BuildReportsParams, 'facts'> & {
+    parseReportsRaw(companyFactListData: CompanyFactListData, options?: Omit<BuildReportsParams, 'facts'> & {
         includeNamePrefix?: boolean;
     }): ReportRaw[];
     /**
@@ -48,6 +48,8 @@ export default class ReportParser {
      */
     buildReports(params: BuildReportsParams): ReportRaw[];
     /**
+     * @deprecated use translateReport
+     *
      * Translate ReportRaw to ReportTranslated by default, but can be used to translate to any object using both the callback and keyTranslator
      *
      * @param reportsRaw this is the output of parseReportsRaw

package/build/services/ReportParser/ReportParser.js

@@ -53,31 +53,32 @@ var ReportParser = /** @class */ (function () {
     /**
      * Same as parseReports but accepts ReportRaw[] instead of CompanyFactListData
      */
-    ReportParser.prototype.parseReportsFromRaw = function (params) {
-        var reportsRaw = params.reportsRaw, calculationMap = params.calculationMap;
+    ReportParser.prototype.translateReport = function (params) {
+        var _a;
+        var report = params.report, calculationMap = params.calculationMap;
         var calcMap = calculationMap !== null && calculationMap !== void 0 ? calculationMap : this.defaultCalculationMap;
-        return reportsRaw.map(function (report) {
-            var _a;
-            var reportNew = {
-                cik: report.cik,
-                dateFiled: report.dateFiled,
-                dateReport: report.dateReport,
-                fiscalPeriod: report.fiscalPeriod,
-                url: report.url,
-                fiscalYear: report.fiscalYear,
-                splitDate: report.splitDate,
-                splitRatio: report.splitRatio,
-            };
-            var reportResolvable = new ReportResolvable_1.default({
-                report: report,
-                calculationMap: calcMap,
-            });
-            for (var key in calcMap) {
-                var value = (_a = reportResolvable.get(key)) !== null && _a !== void 0 ? _a : null;
+        var reportNew = {
+            cik: report.cik,
+            dateFiled: report.dateFiled,
+            dateReport: report.dateReport,
+            fiscalPeriod: report.fiscalPeriod,
+            url: report.url,
+            fiscalYear: report.fiscalYear,
+            splitDate: report.splitDate,
+            splitRatio: report.splitRatio,
+        };
+        var reportResolvable = new ReportResolvable_1.default({
+            report: report,
+            calculationMap: calcMap,
+        });
+        for (var key in calcMap) {
+            var value = (_a = reportResolvable.get(key)) !== null && _a !== void 0 ? _a : null;
+            // use first truthy value
+            if (!reportNew[key]) {
                 reportNew[key] = value;
             }
-            return reportNew;
-        });
+        }
+        return reportNew;
     };
     /**
      * Parse raw reports
@@ -85,7 +86,7 @@ var ReportParser = /** @class */ (function () {
      * @see https://www.sec.gov/edgar/sec-api-documentation
      */
     ReportParser.prototype.parseReportsRaw = function (companyFactListData, options) {
-        var includeNamePrefix = options.includeNamePrefix;
+        var includeNamePrefix = (options !== null && options !== void 0 ? options : {}).includeNamePrefix;
         var facts = this.reportBuilder.createFacts(companyFactListData, includeNamePrefix).facts;
         return this.reportBuilder.buildReports(__assign({ facts: facts }, options));
     };
@@ -96,6 +97,8 @@ var ReportParser = /** @class */ (function () {
         return this.reportBuilder.buildReports(params);
     };
     /**
+     * @deprecated use translateReport
+     *
      * Translate ReportRaw to ReportTranslated by default, but can be used to translate to any object using both the callback and keyTranslator
      *
      * @param reportsRaw this is the output of parseReportsRaw

package/build/services/ReportRawBuilder/FactFiscalCalculator.d.ts

@@ -18,13 +18,16 @@ export default class FactFiscalCalculator {
     private readonly endDateCountMap;
     private readonly filedDateCountByEndDate;
     private didResolve;
+    private readonly fiscalYearEnd;
     constructor(params?: {
         facts?: Pick<FactItem, 'end' | 'filed'>[];
         filings?: Pick<FilingListItemTranslated, 'form' | 'reportDate' | 'filingDate' | 'accessionNumber'>[];
+        fiscalYearEnd?: {
+            month: number;
+            day: number;
+        } | null;
     });
-    useFilingsForDates(params: {
-        filings: Pick<FilingListItemTranslated, 'form' | 'reportDate' | 'filingDate' | 'accessionNumber'>[];
-    }): void;
+    private useFilingsForDates;
     add(fact: {
         end: string;
         filed: string;
@@ -44,13 +47,21 @@ export default class FactFiscalCalculator {
     getFiscalYearQuarter(params: {
         dateStr: string;
         endDateByYear?: Map<number, Date>;
+        fiscalYearEnd?: {
+            month: number;
+            day: number;
+        } | null;
     }): {
         year: number;
         quarter: number;
     };
     static getFiscalYearQuarter(params: {
         dateStr: string;
-        endDateByYear: Map<number, Date>;
+        endDateByYear?: Map<number, Date>;
+        fiscalYearEnd?: {
+            month: number;
+            day: number;
+        } | null;
     }): {
         quarter: number;
         year: number;

package/build/services/ReportRawBuilder/FactFiscalCalculator.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+var constants_1 = require("../../util/constants");
 /**
  * Gets the fiscal period for a given date. does this by checking when the FY end periods are,
  * Then measures the offset from the end date to the next/previous fiscal year end.
@@ -14,10 +15,10 @@ var FactFiscalCalculator = /** @class */ (function () {
         this.endDateCountMap = new Map();
         this.filedDateCountByEndDate = new Map();
         this.didResolve = false;
-        var _a = params !== null && params !== void 0 ? params : {}, _b = _a.facts, facts = _b === void 0 ? [] : _b, _c = _a.filings, filings = _c === void 0 ? [] : _c;
-        if (filings.length > 0) {
-            this.useFilingsForDates({ filings: filings });
-        }
+        this.fiscalYearEnd = null;
+        var _a = params !== null && params !== void 0 ? params : {}, _b = _a.facts, facts = _b === void 0 ? [] : _b, _c = _a.filings, filings = _c === void 0 ? [] : _c, fiscalYearEnd = _a.fiscalYearEnd;
+        this.fiscalYearEnd = fiscalYearEnd !== null && fiscalYearEnd !== void 0 ? fiscalYearEnd : null;
+        this.useFilingsForDates({ filings: filings });
         facts.forEach(function (fact) { return _this.add(fact); });
     }
     FactFiscalCalculator.prototype.useFilingsForDates = function (params) {
@@ -26,12 +27,12 @@ var FactFiscalCalculator = /** @class */ (function () {
         var endDateByYear = new Map();
         filings.forEach(function (_a) {
             var reportDate = _a.reportDate, form = _a.form;
-            if (form === '10-K' || form === '20-F') {
+            if (constants_1.FORMS_EARNINGS_ANNUAL.includes(form)) {
                 endDateByYear.set(Number(reportDate.substring(0, 4)), new Date(reportDate));
             }
         });
         filings.forEach(function (filing) {
-            if (filing.form === '10-K' || filing.form === '10-Q' || filing.form === '20-F' || filing.form === '40-F') {
+            if (constants_1.FORMS_EARNINGS.includes(filing.form)) {
                 var _a = _this.getFiscalYearQuarter({
                     dateStr: filing.reportDate,
                     endDateByYear: endDateByYear,
@@ -203,17 +204,25 @@ var FactFiscalCalculator = /** @class */ (function () {
         return (_a = this.datesByFiscals.get("".concat(params.year, "_").concat(params.quarter))) !== null && _a !== void 0 ? _a : null;
     };
     FactFiscalCalculator.prototype.getFiscalYearQuarter = function (params) {
-        var dateStr = params.dateStr, _a = params.endDateByYear, endDateByYear = _a === void 0 ? this.endDateByYear : _a;
+        var dateStr = params.dateStr, _a = params.endDateByYear, endDateByYear = _a === void 0 ? this.endDateByYear : _a, _b = params.fiscalYearEnd, fiscalYearEnd = _b === void 0 ? this.fiscalYearEnd : _b;
         if (this.fiscalsByEndDate.has(dateStr)) {
             return this.fiscalsByEndDate.get(dateStr);
         }
-        var fiscals = FactFiscalCalculator.getFiscalYearQuarter({ dateStr: dateStr, endDateByYear: endDateByYear });
+        var fiscals = FactFiscalCalculator.getFiscalYearQuarter({ dateStr: dateStr, endDateByYear: endDateByYear, fiscalYearEnd: fiscalYearEnd });
         this.fiscalsByEndDate.set(dateStr, fiscals);
         return fiscals;
     };
     FactFiscalCalculator.getFiscalYearQuarter = function (params) {
-        var dateStr = params.dateStr, endDateByYear = params.endDateByYear;
-        if (endDateByYear.size === 0) {
+        var _a;
+        var dateStr = params.dateStr, endDateByYearProp = params.endDateByYear, fiscalYearEnd = params.fiscalYearEnd;
+        var endDateByYear = endDateByYearProp !== null && endDateByYearProp !== void 0 ? endDateByYearProp : new Map();
+        if (fiscalYearEnd) {
+            var month = fiscalYearEnd.month, day = fiscalYearEnd.day;
+            var year = new Date().getFullYear();
+            var yearEndDate_1 = new Date("".concat(year, "-").concat(month, "-").concat(day));
+            endDateByYear.set(year, (_a = endDateByYear.get(year)) !== null && _a !== void 0 ? _a : yearEndDate_1);
+        }
+        if (!(endDateByYear === null || endDateByYear === void 0 ? void 0 : endDateByYear.size)) {
             throw new Error('No annual report dates provided');
         }
         var getYearEndDate = function (year) {

package/build/services/ReportRawBuilder/FactPeriodResolver.js

@@ -197,20 +197,9 @@ var FactPeriodResolver = /** @class */ (function () {
         var _this = this;
         this.propertiesByYear.forEach(function (properties, year) {
             properties.forEach(function (propertyName) {
-                var _a, _b;
+                var _a;
                 for (var i = 0; i < 4; i++) {
                     var bucketSum = (_a = _this.sumByQuarterByPropertyByYear.get(year)) === null || _a === void 0 ? void 0 : _a.get(propertyName);
-                    var bucketQuarter = _this.getOrSetBucketArr(_this.valueByQuarterByPropertyByYear, year, propertyName);
-                    if (bucketSum && !bucketSum.has(i)) {
-                        var prevSum = 0;
-                        var quarterSum = 0;
-                        for (var j = 0; j < i; j++) {
-                            prevSum = quarterSum;
-                            quarterSum = (_b = bucketSum.get(j)) !== null && _b !== void 0 ? _b : quarterSum;
-                        }
-                        bucketSum.set(i, quarterSum);
-                        bucketQuarter.set(i, quarterSum - prevSum);
-                    }
                     var value = bucketSum === null || bucketSum === void 0 ? void 0 : bucketSum.get(i);
                     if (value === undefined)
                         continue;

package/build/services/ReportRawBuilder/ReportRawBuilder.d.ts

@@ -1,18 +1,26 @@
-import type { CompanyFactListData, FactGroup, FactItem, ReportRaw, SplitData } from '../../types';
-import FactFiscalCalculator, { SetReportDatesParams } from './FactFiscalCalculator';
+import type { CompanyFactListData, FactGroup, FactItem, FilingListItemTranslated, ReportRaw, SplitData } from '../../types';
+import FactFiscalCalculator from './FactFiscalCalculator';
 export interface BuildReportsParams {
     facts: FactItem[];
     /**
      * for more accurate dates, add this. Otherwise, dates will be inferred
      * using the fact periods. The filing and report dates can be found in the SubmissionList (segEdgarApi.getSubmissions)
      */
-    reportDates?: SetReportDatesParams[];
+    filings?: Pick<FilingListItemTranslated, 'form' | 'reportDate' | 'filingDate' | 'accessionNumber'>[];
     /**
      * Splits will be extracted from facts if not provided.
      */
     splits?: SplitData[];
     resolvePeriodValues?: boolean;
     adjustForSplits?: boolean;
+    /**
+     * For member facts (facts with segments), the separator between the fact name and the segments.
+     */
+    pathSeparatorForMemberFacts?: string;
+    fiscalYearEnd?: {
+        month: number;
+        day: number;
+    } | null;
 }
 /**
  * Builds ReportRaw objects from company facts. Adjusts for splits and resolves period values.
@@ -22,7 +30,7 @@ export default class ReportRawBuilder {
     createFacts(companyFacts: CompanyFactListData, includeNamePrefix?: boolean): {
         facts: FactItem[];
     };
-    private createFiscalCalculator;
+    private getFactKey;
     buildReports(params: BuildReportsParams): ReportRaw[];
     private createReportKey;
     private createReport;

package/build/services/ReportRawBuilder/ReportRawBuilder.js

@@ -1,5 +1,17 @@
 "use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
 Object.defineProperty(exports, "__esModule", { value: true });
+var constants_1 = require("../../util/constants");
 var FactFiscalCalculator_1 = require("./FactFiscalCalculator");
 var FactGrouper_1 = require("./FactGrouper");
 var FactRecordBuilder_1 = require("./FactRecordBuilder");
@@ -15,43 +27,50 @@ var ReportRawBuilder = /** @class */ (function () {
         if (includeNamePrefix === void 0) { includeNamePrefix = false; }
         return this.factRecordBuilder.createFacts(companyFacts, includeNamePrefix);
     };
-    ReportRawBuilder.prototype.createFiscalCalculator = function (params) {
-        var facts = params.facts;
-        var fiscalCalculator = new FactFiscalCalculator_1.default();
-        for (var _i = 0, facts_1 = facts; _i < facts_1.length; _i++) {
-            var fact = facts_1[_i];
-            fiscalCalculator.add(fact);
-        }
-        return fiscalCalculator;
+    ReportRawBuilder.prototype.getFactKey = function (fact, pathSeparator) {
+        var _a;
+        var suffix = (_a = fact.segments) === null || _a === void 0 ? void 0 : _a.map(function (_a) {
+            var dimension = _a.dimension, value = _a.value;
+            return "".concat(dimension).concat(pathSeparator).concat(value);
+        }).join(pathSeparator);
+        return suffix ? "".concat(fact.name).concat(pathSeparator).concat(suffix) : fact.name;
     };
     ReportRawBuilder.prototype.buildReports = function (params) {
-        var facts = params.facts, reportDates = params.reportDates, splitsProp = params.splits, _a = params.resolvePeriodValues, resolvePeriodValues = _a === void 0 ? true : _a, _b = params.adjustForSplits, adjustForSplits = _b === void 0 ? true : _b;
+        var _this = this;
+        var factsProp = params.facts, filings = params.filings, splitsProp = params.splits, _a = params.resolvePeriodValues, resolvePeriodValues = _a === void 0 ? true : _a, _b = params.adjustForSplits, adjustForSplits = _b === void 0 ? true : _b, _c = params.pathSeparatorForMemberFacts, pathSeparatorForMemberFacts = _c === void 0 ? '>' : _c, fiscalYearEnd = params.fiscalYearEnd;
+        // Rename member facts to prevent overwriting parent facts.
+        var facts = factsProp.map(function (fact) {
+            var factKey = _this.getFactKey(fact, pathSeparatorForMemberFacts);
+            return __assign(__assign({}, fact), { name: factKey });
+        });
         if (facts.length === 0) {
             return [];
         }
+        var reportsCik = Number(facts[0].cik);
+        var fiscalCalculator = new FactFiscalCalculator_1.default({
+            filings: filings === null || filings === void 0 ? void 0 : filings.filter(function (f) { return constants_1.FORMS_EARNINGS.includes(f.form); }),
+            facts: facts,
+            fiscalYearEnd: fiscalYearEnd,
+        });
         var accessionByYearQuarter = new Map();
-        reportDates === null || reportDates === void 0 ? void 0 : reportDates.forEach(function (params) {
-            var year = params.year, quarter = params.quarter, accn = params.accn;
-            if (accn)
-                accessionByYearQuarter.set("".concat(year, "_").concat(quarter), accn);
+        filings === null || filings === void 0 ? void 0 : filings.forEach(function (f) {
+            var _a = fiscalCalculator.getFiscalYearQuarter({ dateStr: f.reportDate }), year = _a.year, quarter = _a.quarter;
+            accessionByYearQuarter.set(f.accessionNumber, "".concat(year, "_").concat(quarter));
         });
-        var reportsCik = Number(facts[0].cik);
-        var fiscalCalculator = reportDates ? new FactFiscalCalculator_1.default() : this.createFiscalCalculator({ facts: facts });
-        reportDates === null || reportDates === void 0 ? void 0 : reportDates.forEach(function (params) { return fiscalCalculator.setReportDates(params); });
         var factGrouper = new FactGrouper_1.default();
         var factSplitAdjuster = new FactSplitAdjuster_1.default();
         // if splits not included in params and need to adjust, extract from facts
         var splits = adjustForSplits
             ? splitsProp !== null && splitsProp !== void 0 ? splitsProp : factSplitAdjuster.getSplits({ splitFacts: factSplitAdjuster.filterSplitFacts({ facts: facts }) })
             : splitsProp;
-        var _c = factGrouper.buildFactGroupsByReportKey({
+        var _d = factGrouper.buildFactGroupsByReportKey({
             facts: facts,
             cik: reportsCik,
             fiscalCalculator: fiscalCalculator,
             resolvePeriodValues: resolvePeriodValues,
             generateMissingGroups: false,
             splits: splits,
-        }), factGroupsByReportKey = _c.factGroupsByReportKey, maxYear = _c.maxYear, minYear = _c.minYear;
+        }), factGroupsByReportKey = _d.factGroupsByReportKey, maxYear = _d.maxYear, minYear = _d.minYear;
         return this.buildReportsFromGroups({
             factGroupsByReportKey: factGroupsByReportKey,
             fiscalCalculator: fiscalCalculator,

package/build/services/SecEdgarApi/SecEdgarApi.d.ts

@@ -231,11 +231,7 @@ export default class SecEdgarApi {
      *
      * Use "include" params to specify what to parse. If not provided, all data is parsed.
      */
-    getDocumentXbrl(params: GetDocumentXbrlParams): Promise<import("../DocumentParser/XBRLParser/XBRLParser").XbrlParseResult & {
-        report: ReportRaw | null;
-        facts: import("../../types").FactItemExtended[];
-        xml: string;
-    }>;
+    getDocumentXbrl(params: GetDocumentXbrlParams): Promise<import("../DocumentParser/parsers/parse-xbrl").DocumentXbrlResult>;
     /**
      * Builds a url for a document. If fileName is not provided, it defaults to `${accessionNumber}.txt`
      *

package/build/services/SecEdgarApi/SecEdgarApi.js

@@ -302,17 +302,17 @@ var SecEdgarApi = /** @class */ (function () {
      */
     SecEdgarApi.prototype.getReports = function (params) {
         return __awaiter(this, void 0, void 0, function () {
-            var calculationMap, reportsRaw;
+            var calculationMap, reports;
+            var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         calculationMap = params.calculationMap;
                         return [4 /*yield*/, this.getReportsRaw(__assign(__assign({}, params), { includeNamePrefix: true }))];
                     case 1:
-                        reportsRaw = _a.sent();
-                        return [2 /*return*/, this.reportParser.parseReportsFromRaw({
-                                reportsRaw: reportsRaw,
-                                calculationMap: calculationMap,
+                        reports = _a.sent();
+                        return [2 /*return*/, reports.map(function (report) {
+                                return _this.reportParser.translateReport({ report: report, calculationMap: calculationMap });
                             })];
                 }
             });

package/build/types/company-facts.type.d.ts

@@ -76,6 +76,7 @@ export interface FactItem {
 }
 export interface FactItemExtended extends FactItem {
     isUsedInReport?: boolean;
+    isCurrentPeriod?: boolean;
     decimals?: number;
     scale?: number;
 }

package/build/util/constants.d.ts

@@ -1,2 +1,4 @@
 declare const KEY_SPLIT = "StockholdersEquityNoteStockSplitConversionRatio1";
-export { KEY_SPLIT };
+declare const FORMS_EARNINGS: string[];
+declare const FORMS_EARNINGS_ANNUAL: string[];
+export { KEY_SPLIT, FORMS_EARNINGS, FORMS_EARNINGS_ANNUAL };

package/build/util/constants.js

@@ -1,5 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.KEY_SPLIT = void 0;
+exports.FORMS_EARNINGS_ANNUAL = exports.FORMS_EARNINGS = exports.KEY_SPLIT = void 0;
 var KEY_SPLIT = 'StockholdersEquityNoteStockSplitConversionRatio1';
 exports.KEY_SPLIT = KEY_SPLIT;
+var FORMS_EARNINGS = ['10-Q', '10-K', '20-F', '40-F'];
+exports.FORMS_EARNINGS = FORMS_EARNINGS;
+var FORMS_EARNINGS_ANNUAL = ['10-K', '20-F', '40-F'];
+exports.FORMS_EARNINGS_ANNUAL = FORMS_EARNINGS_ANNUAL;

package/build/util/key-translations.d.ts

@@ -1,5 +1,7 @@
 import type { ReportTranslated } from '../types/report-translated.type';
 /**
+ * @deprecated use calculationMap for ReportResolvable
+ *
  * Checks if any of the array keys exist in the object to assign to the translated key
  * These were checked against Yahoo Finance values, adding the ones that most often matched the yahoo values
  */

package/build/util/key-translations.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 /**
+ * @deprecated use calculationMap for ReportResolvable
+ *
  * Checks if any of the array keys exist in the object to assign to the translated key
  * These were checked against Yahoo Finance values, adding the ones that most often matched the yahoo values
  */

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "sec-edgar-api",
-    "version": "0.5.1",
+    "version": "0.5.3",
     "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)",