@usa-open-data-connectors/usa-sources 0.1.2 → 0.1.4

package/dist/secEdgarFilings.d.ts

@@ -0,0 +1,103 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the SEC EDGAR submissions source. */
+export declare const SEC_EDGAR_FILINGS_SOURCE_ID = "sec-edgar-filings";
+/**
+ * User-Agent header the SEC asks every caller to send.
+ *
+ * The SEC blocks a request that does not identify its operator, so the
+ * adapter sends a descriptive name and a contact address on every call. A
+ * real deployment should override the contact with its own address.
+ */
+export declare const SEC_EDGAR_USER_AGENT = "usa-open-data-connectors oliver.treadwell@gmail.com";
+/** One filing in an issuer's recent submissions list. */
+export interface SecEdgarFiling {
+    /** The SEC's accession number, e.g. "0001958244-26-000636". */
+    accessionNumber: string;
+    /** Date the filing was made, e.g. "2026-10-02". */
+    filingDate: string;
+    /** End of the period the filing covers, or null when the form has none. */
+    reportDate: string | null;
+    /** Form type, e.g. "4" or "10-Q". */
+    form: string;
+    /** Path to the filing's main document inside the filing archive. */
+    primaryDocument: string;
+    /** Description of the main document, or null when the form has none. */
+    primaryDocDescription: string | null;
+    /** Size of the filing in bytes, or null when the SEC did not report one. */
+    sizeBytes: number | null;
+    /** Whether the filing carries XBRL data. */
+    isXbrl: boolean;
+    /** Whether the filing carries inline XBRL data. */
+    isInlineXbrl: boolean;
+}
+/** One form type and how many of the recent filings use it. */
+export interface SecEdgarFormCount {
+    form: string;
+    count: number;
+}
+/** An issuer's profile plus its recent filings, folded for a story. */
+export interface SecEdgarCompanyFilings {
+    /** Zero-padded Central Index Key, e.g. "0000320193". */
+    cik: string;
+    /** The issuer's registered name, e.g. "Apple Inc.". */
+    name: string;
+    entityType: string | null;
+    /** Standard Industrial Classification code. */
+    sic: string | null;
+    sicDescription: string | null;
+    /** Exchange tickers, empty when the issuer has none. */
+    tickers: string[];
+    /** Exchanges the issuer is listed on, empty when it has none. */
+    exchanges: string[];
+    /** Fiscal year end as the SEC writes it, e.g. "0926". */
+    fiscalYearEnd: string | null;
+    /** Recent filings, in the order the SEC sends them, newest first. */
+    filings: SecEdgarFiling[];
+    filingCount: number;
+    /** Date of the newest filing in the list, e.g. "2026-10-02". */
+    newestFilingDate: string;
+    /** Form types, most filings first, ties broken by form name. */
+    formCounts: SecEdgarFormCount[];
+}
+/** Base URL for the SEC EDGAR submissions service. */
+export declare const SEC_EDGAR_SUBMISSIONS_API_BASE = "https://data.sec.gov/submissions";
+/** Apple's Central Index Key, the issuer the committed fixture covers. */
+export declare const SEC_EDGAR_APPLE_CIK = "0000320193";
+/**
+ * Builds the request URL for one issuer's submissions file.
+ *
+ * The endpoint is keyless. The CIK is zero-padded to the ten digits the
+ * service expects, so a caller can pass "320193" as well as "0000320193".
+ *
+ * @param cik - the issuer's Central Index Key
+ * @returns the full request URL
+ */
+export declare function buildSecEdgarSubmissionsUrl(cik?: string): string;
+/**
+ * Parses one submissions response into an issuer's profile and recent filings.
+ *
+ * A response without a filings block, or with parallel arrays that do not line
+ * up, stops the parse. A filing without a readable date is a changed shape and
+ * also stops the parse.
+ *
+ * @param payload - the JSON body from the SEC submissions service
+ * @returns the issuer's profile, its recent filings, and the form counts
+ */
+export declare function parseSecEdgarFilingsPayload(payload: unknown): SecEdgarCompanyFilings;
+/**
+ * Reads one issuer's recent filings from the SEC's submissions service.
+ *
+ * The SEC asks every caller to identify itself, so the request carries a
+ * descriptive User-Agent header. One keyless request covers the issuer's
+ * recent filings and a little under a thousand rows.
+ *
+ * @param options - an optional Central Index Key and fetch stub
+ * @returns the issuer's profile, its recent filings, and the form counts
+ */
+export declare function fetchSecEdgarFilings(options?: {
+    cik?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<SecEdgarCompanyFilings>;
+/** SEC EDGAR issuer submissions and recent filings, keyless. */
+export declare const secEdgarFilingsAdapter: UsDataAdapter<SecEdgarCompanyFilings>;
+//# sourceMappingURL=secEdgarFilings.d.ts.map

package/dist/secEdgarFilings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"secEdgarFilings.d.ts","sourceRoot":"","sources":["../src/secEdgarFilings.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,uDAAuD;AACvD,eAAO,MAAM,2BAA2B,sBAAsB,CAAC;AAE/D;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,wDACsB,CAAC;AAExD,yDAAyD;AACzD,MAAM,WAAW,cAAc;IAC7B,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAC;IACxB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,4EAA4E;IAC5E,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,4CAA4C;IAC5C,MAAM,EAAE,OAAO,CAAC;IAChB,mDAAmD;IACnD,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,+DAA+D;AAC/D,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,sBAAsB;IACrC,wDAAwD;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+CAA+C;IAC/C,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,wDAAwD;IACxD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,yDAAyD;IACzD,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,qEAAqE;IACrE,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC;IACzB,gEAAgE;IAChE,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC;AAED,sDAAsD;AACtD,eAAO,MAAM,8BAA8B,qCAAqC,CAAC;AAEjF,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,eAAe,CAAC;AAuChD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,GAAG,GAAE,MAA4B,GAAG,MAAM,CASrF;AA0FD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CAqCpF;AAED;;;;;;;;;GASG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,CAAC,EAAE;IACnD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAQlC;AAED,gEAAgE;AAChE,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC,sBAAsB,CAUxE,CAAC"}

package/dist/secEdgarFilings.js

@@ -0,0 +1,215 @@
+import { z } from 'zod';
+import { UsSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/** Adapter id for the SEC EDGAR submissions source. */
+export const SEC_EDGAR_FILINGS_SOURCE_ID = 'sec-edgar-filings';
+/**
+ * User-Agent header the SEC asks every caller to send.
+ *
+ * The SEC blocks a request that does not identify its operator, so the
+ * adapter sends a descriptive name and a contact address on every call. A
+ * real deployment should override the contact with its own address.
+ */
+export const SEC_EDGAR_USER_AGENT = 'usa-open-data-connectors oliver.treadwell@gmail.com';
+/** Base URL for the SEC EDGAR submissions service. */
+export const SEC_EDGAR_SUBMISSIONS_API_BASE = 'https://data.sec.gov/submissions';
+/** Apple's Central Index Key, the issuer the committed fixture covers. */
+export const SEC_EDGAR_APPLE_CIK = '0000320193';
+/** Committed snapshot, so a build works when the SEC host is unreachable. */
+const SEC_EDGAR_FIXTURE_FILENAME = 'sec-edgar-filings-2026-10-05.json';
+/** Shape of a CIK as the submissions service uses it. */
+const CIK_PATTERN = /^\d{1,10}$/;
+/** Shape of a filing date, e.g. "2026-10-02". */
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+// The SEC sends the recent filings as parallel arrays, one array per column,
+// rather than one object per row. A field the form does not carry arrives as
+// an empty string rather than a missing key.
+const SEC_EDGAR_RECENT_SCHEMA = z.object({
+    accessionNumber: z.array(z.string()).optional(),
+    filingDate: z.array(z.string()).optional(),
+    reportDate: z.array(z.string()).optional(),
+    form: z.array(z.string()).optional(),
+    size: z.array(z.number()).optional(),
+    isXBRL: z.array(z.number()).optional(),
+    isInlineXBRL: z.array(z.number()).optional(),
+    primaryDocument: z.array(z.string()).optional(),
+    primaryDocDescription: z.array(z.string()).optional(),
+});
+const SEC_EDGAR_PAYLOAD_SCHEMA = z.object({
+    cik: z.string().optional(),
+    name: z.string().optional(),
+    entityType: z.string().optional(),
+    sic: z.string().optional(),
+    sicDescription: z.string().optional(),
+    tickers: z.array(z.string()).optional(),
+    exchanges: z.array(z.string()).optional(),
+    fiscalYearEnd: z.string().optional(),
+    stateOfIncorporation: z.string().optional(),
+    filings: z.object({ recent: SEC_EDGAR_RECENT_SCHEMA.optional() }).optional(),
+});
+/**
+ * Builds the request URL for one issuer's submissions file.
+ *
+ * The endpoint is keyless. The CIK is zero-padded to the ten digits the
+ * service expects, so a caller can pass "320193" as well as "0000320193".
+ *
+ * @param cik - the issuer's Central Index Key
+ * @returns the full request URL
+ */
+export function buildSecEdgarSubmissionsUrl(cik = SEC_EDGAR_APPLE_CIK) {
+    const trimmed = cik.trim();
+    if (!CIK_PATTERN.test(trimmed)) {
+        throw new UsSourceParseError(SEC_EDGAR_FILINGS_SOURCE_ID, `A Central Index Key must be up to ten digits: ${cik}`);
+    }
+    return `${SEC_EDGAR_SUBMISSIONS_API_BASE}/CIK${trimmed.padStart(10, '0')}.json`;
+}
+/** Reads a column the SEC may omit, as an empty list. */
+function columnOrEmpty(column) {
+    return column ?? [];
+}
+/**
+ * Zips the SEC's parallel filing arrays into one row per filing.
+ *
+ * The columns are parallel arrays, so a mismatch in their lengths means the
+ * response cannot be read as rows and stops the parse. A filing without a
+ * readable date is a changed shape and also stops the parse.
+ *
+ * @param recent - the recent filings object from the submissions file
+ * @returns one row per filing, in the order the SEC sent them
+ */
+function zipSecEdgarFilings(recent) {
+    const accessions = columnOrEmpty(recent.accessionNumber);
+    const dates = columnOrEmpty(recent.filingDate);
+    const reportDates = columnOrEmpty(recent.reportDate);
+    const forms = columnOrEmpty(recent.form);
+    const sizes = recent.size ?? [];
+    const xbrl = recent.isXBRL ?? [];
+    const inlineXbrl = recent.isInlineXBRL ?? [];
+    const primaryDocuments = columnOrEmpty(recent.primaryDocument);
+    const primaryDescriptions = columnOrEmpty(recent.primaryDocDescription);
+    const columns = [
+        { name: 'filingDate', values: dates },
+        { name: 'reportDate', values: reportDates },
+        { name: 'form', values: forms },
+        { name: 'size', values: sizes },
+        { name: 'isXBRL', values: xbrl },
+        { name: 'isInlineXBRL', values: inlineXbrl },
+        { name: 'primaryDocument', values: primaryDocuments },
+        { name: 'primaryDocDescription', values: primaryDescriptions },
+    ];
+    for (const column of columns) {
+        if (column.values.length !== accessions.length) {
+            throw new UsSourceParseError(SEC_EDGAR_FILINGS_SOURCE_ID, `The ${column.name} column holds ${column.values.length} entries, not ${accessions.length}`);
+        }
+    }
+    return accessions.map((accessionNumber, index) => {
+        const filingDate = dates[index] ?? '';
+        if (!ISO_DATE_PATTERN.test(filingDate)) {
+            throw new UsSourceParseError(SEC_EDGAR_FILINGS_SOURCE_ID, `Unreadable filing date: ${filingDate}`);
+        }
+        return {
+            accessionNumber,
+            filingDate,
+            reportDate: blankToNull(reportDates[index]),
+            form: forms[index] ?? '',
+            primaryDocument: primaryDocuments[index] ?? '',
+            primaryDocDescription: blankToNull(primaryDescriptions[index]),
+            sizeBytes: sizes[index] ?? null,
+            isXbrl: xbrl[index] === 1,
+            isInlineXbrl: inlineXbrl[index] === 1,
+        };
+    });
+}
+/** Turns the SEC's empty-string sentinel into null, and keeps real text. */
+function blankToNull(value) {
+    if (value === undefined || value.trim() === '') {
+        return null;
+    }
+    return value;
+}
+/** Counts how often each form appears, most filings first, ties by name. */
+function countSecEdgarForms(filings) {
+    const counts = new Map();
+    for (const filing of filings) {
+        counts.set(filing.form, (counts.get(filing.form) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .sort(([leftForm, leftCount], [rightForm, rightCount]) => leftCount === rightCount ? leftForm.localeCompare(rightForm) : rightCount - leftCount)
+        .map(([form, count]) => ({ form, count }));
+}
+/**
+ * Parses one submissions response into an issuer's profile and recent filings.
+ *
+ * A response without a filings block, or with parallel arrays that do not line
+ * up, stops the parse. A filing without a readable date is a changed shape and
+ * also stops the parse.
+ *
+ * @param payload - the JSON body from the SEC submissions service
+ * @returns the issuer's profile, its recent filings, and the form counts
+ */
+export function parseSecEdgarFilingsPayload(payload) {
+    const parsed = SEC_EDGAR_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(SEC_EDGAR_FILINGS_SOURCE_ID, parsed.error.message);
+    }
+    const recent = parsed.data.filings?.recent;
+    if (recent === undefined) {
+        throw new UsSourceParseError(SEC_EDGAR_FILINGS_SOURCE_ID, 'The response carried no filings');
+    }
+    const filings = zipSecEdgarFilings(recent);
+    if (filings.length === 0) {
+        throw new UsSourceParseError(SEC_EDGAR_FILINGS_SOURCE_ID, 'The response carried no filings');
+    }
+    const newestFilingDate = filings
+        .map((filing) => filing.filingDate)
+        .sort()
+        .at(-1);
+    if (newestFilingDate === undefined) {
+        throw new UsSourceParseError(SEC_EDGAR_FILINGS_SOURCE_ID, 'No filing date to summarise');
+    }
+    return {
+        cik: parsed.data.cik ?? '',
+        name: parsed.data.name ?? '',
+        entityType: blankToNull(parsed.data.entityType),
+        sic: blankToNull(parsed.data.sic),
+        sicDescription: blankToNull(parsed.data.sicDescription),
+        tickers: parsed.data.tickers ?? [],
+        exchanges: parsed.data.exchanges ?? [],
+        fiscalYearEnd: blankToNull(parsed.data.fiscalYearEnd),
+        filings,
+        filingCount: filings.length,
+        newestFilingDate,
+        formCounts: countSecEdgarForms(filings),
+    };
+}
+/**
+ * Reads one issuer's recent filings from the SEC's submissions service.
+ *
+ * The SEC asks every caller to identify itself, so the request carries a
+ * descriptive User-Agent header. One keyless request covers the issuer's
+ * recent filings and a little under a thousand rows.
+ *
+ * @param options - an optional Central Index Key and fetch stub
+ * @returns the issuer's profile, its recent filings, and the form counts
+ */
+export async function fetchSecEdgarFilings(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildSecEdgarSubmissionsUrl(options?.cik ?? SEC_EDGAR_APPLE_CIK);
+    const response = await httpGet(SEC_EDGAR_FILINGS_SOURCE_ID, url, {
+        fetchImpl,
+        headers: { 'User-Agent': SEC_EDGAR_USER_AGENT },
+    });
+    return parseSecEdgarFilingsPayload(await response.json());
+}
+/** SEC EDGAR issuer submissions and recent filings, keyless. */
+export const secEdgarFilingsAdapter = {
+    id: SEC_EDGAR_FILINGS_SOURCE_ID,
+    name: 'SEC EDGAR filings',
+    auth: 'none',
+    description: "An issuer's recent filing history from SEC EDGAR, one row per filing, with the form type and the newest date in the list.",
+    fetchLive: async (options) => fetchSecEdgarFilings(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseSecEdgarFilingsPayload(payload),
+    loadFixture: () => parseSecEdgarFilingsPayload(readFixtureJson(SEC_EDGAR_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=secEdgarFilings.js.map

package/dist/secEdgarFilings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"secEdgarFilings.js","sourceRoot":"","sources":["../src/secEdgarFilings.ts"],"names":[],"mappings":"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"}

package/dist/treasuryAvgInterestRate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"treasuryAvgInterestRate.d.ts","sourceRoot":"","sources":["../src/treasuryAvgInterestRate.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,yBAAyB,CAAC;IACrC,OAAO,EAAE,yBAAyB,CAAC;IACnC,MAAM,EAAE,yBAAyB,CAAC;IAClC,iEAAiE;IACjE,2BAA2B,EAAE,MAAM,CAAC;IACpC,gEAAgE;IAChE,8BAA8B,EAAE,MAAM,CAAC;CACxC;AAED,iDAAiD;AACjD,eAAO,MAAM,6BAA6B,oEACyB,CAAC;AAEpE,0EAA0E;AAC1E,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,wCAAwC,0BAA0B,CAAC;AAEhF,4EAA4E;AAC5E,eAAO,MAAM,+CAA+C,gCAAgC,CAAC;AAE7F,qCAAqC;AACrC,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,QAAS,CAAC;AA4B3D;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,CAAC,EAAE;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAQT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,yBAAyB,EAAE,CAmEjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,yBAAyB,EAAE,GAClC,0BAA0B,CA+B5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CAAC,OAAO,CAAC,EAAE;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAetC;AAED,0EAA0E;AAC1E,eAAO,MAAM,8BAA8B,EAAE,aAAa,CAAC,0BAA0B,CAkBpF,CAAC"}
+{"version":3,"file":"treasuryAvgInterestRate.d.ts","sourceRoot":"","sources":["../src/treasuryAvgInterestRate.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,WAAW,yBAAyB;IACxC,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,0BAA0B,EAAE,MAAM,CAAC;CACpC;AAED,iFAAiF;AACjF,MAAM,WAAW,0BAA0B;IACzC,sDAAsD;IACtD,MAAM,EAAE,yBAAyB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,yBAAyB,CAAC;IACtC,SAAS,EAAE,yBAAyB,CAAC;IACrC,OAAO,EAAE,yBAAyB,CAAC;IACnC,MAAM,EAAE,yBAAyB,CAAC;IAClC,iEAAiE;IACjE,2BAA2B,EAAE,MAAM,CAAC;IACpC,gEAAgE;IAChE,8BAA8B,EAAE,MAAM,CAAC;CACxC;AAED,iDAAiD;AACjD,eAAO,MAAM,6BAA6B,oEACyB,CAAC;AAEpE,0EAA0E;AAC1E,eAAO,MAAM,+BAA+B,yCAAyC,CAAC;AAEtF;;;;;;GAMG;AACH,eAAO,MAAM,wCAAwC,0BAA0B,CAAC;AAEhF,4EAA4E;AAC5E,eAAO,MAAM,+CAA+C,gCAAgC,CAAC;AAE7F,qCAAqC;AACrC,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAE1D;;;;;GAKG;AACH,eAAO,MAAM,oCAAoC,QAAS,CAAC;AA4B3D;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,CAAC,EAAE;IACxD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,MAAM,CAQT;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,yBAAyB,EAAE,CAmEjG;AAED;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAChD,MAAM,EAAE,yBAAyB,EAAE,GAClC,0BAA0B,CA+B5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,6BAA6B,CAAC,OAAO,CAAC,EAAE;IAC5D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAStC;AAED,0EAA0E;AAC1E,eAAO,MAAM,8BAA8B,EAAE,aAAa,CAAC,0BAA0B,CAkBpF,CAAC"}

package/dist/treasuryAvgInterestRate.js

@@ -1,5 +1,6 @@
 import { z } from 'zod';
 import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
 import { readFixtureJson } from './fixtures.js';
 /** Base URL for the Treasury Fiscal Data API. */
 export const TREASURY_FISCAL_DATA_API_BASE = 'https://api.fiscaldata.treasury.gov/services/api/fiscal_service';
@@ -172,10 +173,7 @@ export function buildTreasuryAvgInterestRateSeries(months) {
 export async function fetchTreasuryAvgInterestRates(options) {
     const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
     const url = buildTreasuryAvgInterestRateUrl(options?.securityType === undefined ? {} : { securityType: options.securityType });
-    const response = await fetchImpl(url);
-    if (!response.ok) {
-        throw new UsSourceApiError('treasury', `HTTP ${response.status} reading the average interest rates`);
-    }
+    const response = await httpGet('treasury', url, { fetchImpl });
     return buildTreasuryAvgInterestRateSeries(parseTreasuryAvgInterestRatePayload(await response.json()));
 }
 /** US Treasury average interest rate on the debt outstanding, keyless. */

package/dist/treasuryAvgInterestRate.js.map

@@ -1 +1 @@
-{"version":3,"file":"treasuryAvgInterestRate.js","sourceRoot":"","sources":["../src/treasuryAvgInterestRate.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"treasuryAvgInterestRate.js","sourceRoot":"","sources":["../src/treasuryAvgInterestRate.ts"],"names":[],"mappings":"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"}

package/dist/treasuryDebtToPenny.d.ts

@@ -0,0 +1,90 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the Treasury debt-to-the-penny source. */
+export declare const TREASURY_DEBT_TO_PENNY_SOURCE_ID = "treasury-debt-to-penny";
+/** One business day of the Treasury's outstanding public debt. */
+export interface TreasuryDebtToPennyDay {
+    /** The agency's own record date, e.g. "1993-04-01". */
+    recordDate: string;
+    /** Total public debt outstanding that day, in US dollars. */
+    totalPublicDebtOutstandingUsd: number;
+    /** Debt held by the public, in US dollars, or null when the row omits it. */
+    debtHeldByPublicUsd: number | null;
+    /** Intragovernmental holdings, in US dollars, or null when the row omits it. */
+    intragovernmentalHoldingsUsd: number | null;
+}
+/** One page of the debt file, folded down to the days a story leans on. */
+export interface TreasuryDebtToPennyPage {
+    /** One entry per business day in the page, oldest first. */
+    days: TreasuryDebtToPennyDay[];
+    dayCount: number;
+    /** Oldest day in the page. */
+    firstDay: TreasuryDebtToPennyDay;
+    /** Newest day in the page. */
+    lastDay: TreasuryDebtToPennyDay;
+    /** Day in the page with the largest total debt outstanding. Ties go to the earlier date. */
+    highestTotalDebt: TreasuryDebtToPennyDay;
+    /** Day in the page with the smallest total debt outstanding. Ties go to the earlier date. */
+    lowestTotalDebt: TreasuryDebtToPennyDay;
+}
+/** Base URL for the Treasury Fiscal Data API. */
+export declare const TREASURY_DEBT_TO_PENNY_API_BASE = "https://api.fiscaldata.treasury.gov/services/api/fiscal_service";
+/** Dataset path for the debt to the penny file. */
+export declare const TREASURY_DEBT_TO_PENNY_PATH = "/v2/accounting/od/debt_to_penny";
+/**
+ * Row cap for one request.
+ *
+ * The file runs to hundreds of thousands of daily rows, so the adapter reads
+ * a short recent page rather than the whole run. The API defaults to
+ * oldest-first, the same order the endpoint was probed in on 2026-10-05.
+ */
+export declare const TREASURY_DEBT_TO_PENNY_ROW_LIMIT = 10;
+/**
+ * Builds the request URL for one page of the debt file.
+ *
+ * The endpoint is keyless. The page size is small on purpose: the file holds
+ * one row per business day since 1993, so a caller asking for the whole run
+ * would read hundreds of thousands of rows.
+ *
+ * @param options - an optional row cap
+ * @returns the full request URL
+ */
+export declare function buildTreasuryDebtToPennyUrl(options?: {
+    rowLimit?: number;
+}): string;
+/**
+ * Parses one response into the days that carry a total debt figure.
+ *
+ * A row without a readable date stops the parse, because the file is a date
+ * series and an undated row cannot be placed. A row without a total debt
+ * figure is dropped, which is how a day the agency could not report arrives.
+ *
+ * @param payload - the JSON body from the Fiscal Data API
+ * @returns the days that carry a total, in the order the agency sent them
+ */
+export declare function parseTreasuryDebtToPennyPayload(payload: unknown): TreasuryDebtToPennyDay[];
+/**
+ * Folds the parsed days into one page with the headline days named.
+ *
+ * The days are sorted oldest first, so a caller reading index 0 gets the
+ * oldest day in the page and index -1 gets the newest.
+ *
+ * @param days - the parsed days, in any order
+ * @returns the sorted days, the first and last, and the highest and lowest on the page
+ */
+export declare function buildTreasuryDebtToPennyPage(days: TreasuryDebtToPennyDay[]): TreasuryDebtToPennyPage;
+/**
+ * Reads one page of the Treasury's debt to the penny file.
+ *
+ * One keyless request covers the short page the endpoint answers by default,
+ * one row per business day.
+ *
+ * @param options - an optional row cap and fetch stub
+ * @returns the daily totals in the page, oldest first, with the extremes named
+ */
+export declare function fetchTreasuryDebtToPenny(options?: {
+    rowLimit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<TreasuryDebtToPennyPage>;
+/** US Treasury debt to the penny, one row per business day, keyless. */
+export declare const treasuryDebtToPennyAdapter: UsDataAdapter<TreasuryDebtToPennyPage>;
+//# sourceMappingURL=treasuryDebtToPenny.d.ts.map

package/dist/treasuryDebtToPenny.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"treasuryDebtToPenny.d.ts","sourceRoot":"","sources":["../src/treasuryDebtToPenny.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,4DAA4D;AAC5D,eAAO,MAAM,gCAAgC,2BAA2B,CAAC;AAEzE,kEAAkE;AAClE,MAAM,WAAW,sBAAsB;IACrC,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,6BAA6B,EAAE,MAAM,CAAC;IACtC,6EAA6E;IAC7E,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,gFAAgF;IAChF,4BAA4B,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7C;AAED,2EAA2E;AAC3E,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,IAAI,EAAE,sBAAsB,EAAE,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,QAAQ,EAAE,sBAAsB,CAAC;IACjC,8BAA8B;IAC9B,OAAO,EAAE,sBAAsB,CAAC;IAChC,4FAA4F;IAC5F,gBAAgB,EAAE,sBAAsB,CAAC;IACzC,6FAA6F;IAC7F,eAAe,EAAE,sBAAsB,CAAC;CACzC;AAED,iDAAiD;AACjD,eAAO,MAAM,+BAA+B,oEACuB,CAAC;AAEpE,mDAAmD;AACnD,eAAO,MAAM,2BAA2B,oCAAoC,CAAC;AAE7E;;;;;;GAMG;AACH,eAAO,MAAM,gCAAgC,KAAK,CAAC;AAyBnD;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKnF;AAiBD;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,EAAE,CA6C1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,sBAAsB,EAAE,GAC7B,uBAAuB,CA2BzB;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACvD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAOnC;AAED,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,uBAAuB,CAe7E,CAAC"}