@usa-open-data-connectors/usa-sources 0.1.1 → 0.1.3

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/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":"AAIA,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,CAanC;AAED,wEAAwE;AACxE,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,uBAAuB,CAe7E,CAAC"}

package/dist/treasuryDebtToPenny.js

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Adapter id for the Treasury debt-to-the-penny source. */
+export const TREASURY_DEBT_TO_PENNY_SOURCE_ID = 'treasury-debt-to-penny';
+/** Base URL for the Treasury Fiscal Data API. */
+export 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 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 const TREASURY_DEBT_TO_PENNY_ROW_LIMIT = 10;
+/** Committed snapshot, so a build works when the Treasury host is unreachable. */
+const TREASURY_DEBT_TO_PENNY_FIXTURE_FILENAME = 'treasury-debt-to-penny-2026-10-05.json';
+/** Shape of the agency's record date, e.g. "1993-04-01". */
+const ISO_DATE_PATTERN = /^\d{4}-\d{2}-\d{2}$/;
+// Every field arrives as a string, and a value the agency could not report
+// arrives as the literal text "null". A rejected request answers with an HTTP
+// error and a body of {error, message} instead of the data.
+const TREASURY_DEBT_ROW_SCHEMA = z.object({
+    record_date: z.string().optional(),
+    debt_held_public_amt: z.string().optional(),
+    intragov_hold_amt: z.string().optional(),
+    tot_pub_debt_out_amt: z.string().optional(),
+});
+const TREASURY_DEBT_PAYLOAD_SCHEMA = z.object({
+    data: z.array(TREASURY_DEBT_ROW_SCHEMA).optional(),
+    meta: z.object({ count: z.number().optional() }).optional(),
+    error: z.string().optional(),
+    message: z.string().optional(),
+});
+/**
+ * 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 function buildTreasuryDebtToPennyUrl(options) {
+    const params = new URLSearchParams({
+        'page[size]': String(options?.rowLimit ?? TREASURY_DEBT_TO_PENNY_ROW_LIMIT),
+    });
+    return `${TREASURY_DEBT_TO_PENNY_API_BASE}${TREASURY_DEBT_TO_PENNY_PATH}?${params.toString()}`;
+}
+/** Reads an amount the agency sends as a string, or null when it is missing. */
+function readTreasuryDebtAmount(value) {
+    if (value === undefined || value.trim() === '' || value === 'null') {
+        return null;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed)) {
+        throw new UsSourceParseError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, `Unreadable debt amount: ${value}`);
+    }
+    return parsed;
+}
+/**
+ * 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 function parseTreasuryDebtToPennyPayload(payload) {
+    const parsed = TREASURY_DEBT_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.error !== undefined) {
+        throw new UsSourceApiError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, parsed.data.message ?? `The API rejected the request: ${parsed.data.error}`);
+    }
+    const rows = parsed.data.data ?? [];
+    if (rows.length === 0) {
+        throw new UsSourceParseError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, 'The response carried no rows');
+    }
+    const days = [];
+    for (const row of rows) {
+        if (row.record_date === undefined || !ISO_DATE_PATTERN.test(row.record_date)) {
+            throw new UsSourceParseError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, `Unreadable record date: ${row.record_date ?? 'missing'}`);
+        }
+        const totalPublicDebtOutstandingUsd = readTreasuryDebtAmount(row.tot_pub_debt_out_amt);
+        if (totalPublicDebtOutstandingUsd === null) {
+            continue;
+        }
+        days.push({
+            recordDate: row.record_date,
+            totalPublicDebtOutstandingUsd,
+            debtHeldByPublicUsd: readTreasuryDebtAmount(row.debt_held_public_amt),
+            intragovernmentalHoldingsUsd: readTreasuryDebtAmount(row.intragov_hold_amt),
+        });
+    }
+    if (days.length === 0) {
+        throw new UsSourceParseError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, 'No daily values in the response');
+    }
+    return days;
+}
+/**
+ * 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 function buildTreasuryDebtToPennyPage(days) {
+    const sorted = [...days].sort((left, right) => left.recordDate.localeCompare(right.recordDate));
+    const first = sorted[0];
+    const last = sorted[sorted.length - 1];
+    if (first === undefined || last === undefined) {
+        throw new UsSourceParseError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, 'No days to summarise');
+    }
+    let highest = first;
+    let lowest = first;
+    for (const day of sorted) {
+        if (day.totalPublicDebtOutstandingUsd > highest.totalPublicDebtOutstandingUsd) {
+            highest = day;
+        }
+        if (day.totalPublicDebtOutstandingUsd < lowest.totalPublicDebtOutstandingUsd) {
+            lowest = day;
+        }
+    }
+    return {
+        days: sorted,
+        dayCount: sorted.length,
+        firstDay: first,
+        lastDay: last,
+        highestTotalDebt: highest,
+        lowestTotalDebt: lowest,
+    };
+}
+/**
+ * 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 async function fetchTreasuryDebtToPenny(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildTreasuryDebtToPennyUrl(options?.rowLimit === undefined ? {} : { rowLimit: options.rowLimit });
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UsSourceApiError(TREASURY_DEBT_TO_PENNY_SOURCE_ID, `HTTP ${response.status} reading the debt to the penny file`);
+    }
+    return buildTreasuryDebtToPennyPage(parseTreasuryDebtToPennyPayload(await response.json()));
+}
+/** US Treasury debt to the penny, one row per business day, keyless. */
+export const treasuryDebtToPennyAdapter = {
+    id: TREASURY_DEBT_TO_PENNY_SOURCE_ID,
+    name: 'US Treasury debt to the penny',
+    auth: 'none',
+    description: 'Daily total public debt outstanding the US Treasury reports, in dollars, from the debt to the penny file.',
+    fetchLive: async (options) => fetchTreasuryDebtToPenny(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => buildTreasuryDebtToPennyPage(parseTreasuryDebtToPennyPayload(payload)),
+    loadFixture: () => buildTreasuryDebtToPennyPage(parseTreasuryDebtToPennyPayload(readFixtureJson(TREASURY_DEBT_TO_PENNY_FIXTURE_FILENAME))),
+};
+//# sourceMappingURL=treasuryDebtToPenny.js.map

package/dist/treasuryDebtToPenny.js.map

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

package/dist/usaspendingAgencies.d.ts

@@ -0,0 +1,78 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the USAspending top-tier agencies source. */
+export declare const USASPENDING_AGENCIES_SOURCE_ID = "usaspending-agencies";
+/** One top-tier federal agency and its budget figures for the active quarter. */
+export interface UsaSpendingAgency {
+    /** USAspending's own id for the agency. */
+    agencyId: number;
+    /** The agency's top-tier code, e.g. "247". */
+    toptierCode: string;
+    /** Short abbreviation, e.g. "HHS". */
+    abbreviation: string;
+    /** Full agency name. */
+    agencyName: string;
+    /** Fiscal year the figures describe, e.g. "2026". */
+    activeFiscalYear: string;
+    /** Fiscal quarter the figures describe, e.g. "4". */
+    activeFiscalQuarter: string;
+    /** Money spent during the active quarter, in dollars. */
+    outlayAmount: number;
+    /** Money committed by contract or grant, in dollars. */
+    obligatedAmount: number;
+    /** Budget authority for the active fiscal year, in dollars. */
+    budgetAuthorityAmount: number;
+    /** Total budget authority across the whole government, in dollars. */
+    currentTotalBudgetAuthorityAmount: number;
+    /** This agency's share of the whole budget authority, as a fraction. */
+    percentageOfTotalBudgetAuthority: number;
+    /** URL slug the agency uses, e.g. "department-of-health-and-human-services". */
+    agencySlug: string;
+    /** URL of the agency's congressional budget justification, or null when none. */
+    congressionalJustificationUrl: string | null;
+}
+/** The agency list folded for a story. */
+export interface UsaSpendingAgencyDirectory {
+    /** One entry per top-tier agency. */
+    agencies: UsaSpendingAgency[];
+    agencyCount: number;
+    /** Fiscal year the figures describe. */
+    fiscalYear: string;
+    /** Fiscal quarter the figures describe. */
+    fiscalQuarter: string;
+    /** Total budget authority across the whole government, in dollars. */
+    currentTotalBudgetAuthorityAmount: number;
+    /** Agency with the largest obligated amount. Ties go to the earlier list entry. */
+    largestByObligation: UsaSpendingAgency;
+    /** Agency with the largest outlay amount. Ties go to the earlier list entry. */
+    largestByOutlay: UsaSpendingAgency;
+}
+/** Base URL for the USAspending API. */
+export declare const USASPENDING_API_BASE = "https://api.usaspending.gov/api/v2";
+/** Path of the top-tier agency reference list. */
+export declare const USASPENDING_TOP_TIER_AGENCIES_PATH = "/references/toptier_agencies/";
+/**
+ * Parses one response into the top-tier agency list and the headline agencies.
+ *
+ * A row without an id or a name is a changed shape and stops the parse. The
+ * first row's fiscal year and quarter describe the whole list, which is how
+ * the API builds it.
+ *
+ * @param payload - the JSON body from the USAspending agencies endpoint
+ * @returns the agencies, the fiscal period, and the largest by obligation and outlay
+ */
+export declare function parseUsaSpendingAgenciesPayload(payload: unknown): UsaSpendingAgencyDirectory;
+/**
+ * Reads the top-tier federal agency reference list from USAspending.
+ *
+ * One keyless request covers every top-tier agency and the budget figures for
+ * the active fiscal quarter.
+ *
+ * @param options - an optional fetch stub
+ * @returns the agencies, the fiscal period, and the largest by obligation and outlay
+ */
+export declare function fetchUsaSpendingAgencies(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<UsaSpendingAgencyDirectory>;
+/** USAspending top-tier federal agencies, one row per agency, keyless. */
+export declare const usaspendingAgenciesAdapter: UsDataAdapter<UsaSpendingAgencyDirectory>;
+//# sourceMappingURL=usaspendingAgencies.d.ts.map

package/dist/usaspendingAgencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usaspendingAgencies.d.ts","sourceRoot":"","sources":["../src/usaspendingAgencies.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,+DAA+D;AAC/D,eAAO,MAAM,8BAA8B,yBAAyB,CAAC;AAErE,iFAAiF;AACjF,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,8CAA8C;IAC9C,WAAW,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,gBAAgB,EAAE,MAAM,CAAC;IACzB,qDAAqD;IACrD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,yDAAyD;IACzD,YAAY,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,eAAe,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sEAAsE;IACtE,iCAAiC,EAAE,MAAM,CAAC;IAC1C,wEAAwE;IACxE,gCAAgC,EAAE,MAAM,CAAC;IACzC,gFAAgF;IAChF,UAAU,EAAE,MAAM,CAAC;IACnB,iFAAiF;IACjF,6BAA6B,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9C;AAED,0CAA0C;AAC1C,MAAM,WAAW,0BAA0B;IACzC,qCAAqC;IACrC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,sEAAsE;IACtE,iCAAiC,EAAE,MAAM,CAAC;IAC1C,mFAAmF;IACnF,mBAAmB,EAAE,iBAAiB,CAAC;IACvC,gFAAgF;IAChF,eAAe,EAAE,iBAAiB,CAAC;CACpC;AAED,wCAAwC;AACxC,eAAO,MAAM,oBAAoB,uCAAuC,CAAC;AAEzE,kDAAkD;AAClD,eAAO,MAAM,kCAAkC,kCAAkC,CAAC;AAuClF;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,0BAA0B,CAoD5F;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACvD,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAWtC;AAED,0EAA0E;AAC1E,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,0BAA0B,CAahF,CAAC"}

package/dist/usaspendingAgencies.js

@@ -0,0 +1,121 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Adapter id for the USAspending top-tier agencies source. */
+export const USASPENDING_AGENCIES_SOURCE_ID = 'usaspending-agencies';
+/** Base URL for the USAspending API. */
+export const USASPENDING_API_BASE = 'https://api.usaspending.gov/api/v2';
+/** Path of the top-tier agency reference list. */
+export const USASPENDING_TOP_TIER_AGENCIES_PATH = '/references/toptier_agencies/';
+/** Committed snapshot, so a build works when the USAspending host is unreachable. */
+const USASPENDING_AGENCIES_FIXTURE_FILENAME = 'usaspending-agencies-2026-10-05.json';
+// The list arrives as rows with typed numbers. A row the agency could not
+// complete arrives with null in the optional fields.
+const USASPENDING_AGENCY_SCHEMA = z.object({
+    agency_id: z.number().optional(),
+    toptier_code: z.string().optional(),
+    abbreviation: z.string().optional(),
+    agency_name: z.string().optional(),
+    congressional_justification_url: z.string().nullable().optional(),
+    active_fy: z.string().optional(),
+    active_fq: z.string().optional(),
+    outlay_amount: z.number().optional(),
+    obligated_amount: z.number().optional(),
+    budget_authority_amount: z.number().optional(),
+    current_total_budget_authority_amount: z.number().optional(),
+    percentage_of_total_budget_authority: z.number().optional(),
+    agency_slug: z.string().optional(),
+});
+const USASPENDING_AGENCIES_SCHEMA = z.object({
+    results: z.array(USASPENDING_AGENCY_SCHEMA).optional(),
+});
+/** Picks the agency with the largest value, ties to the earlier entry. */
+function largestAgencyBy(agencies, field) {
+    const first = agencies[0];
+    if (first === undefined) {
+        throw new UsSourceParseError(USASPENDING_AGENCIES_SOURCE_ID, 'No agencies to summarise');
+    }
+    return agencies.reduce((best, agency) => (agency[field] > best[field] ? agency : best), first);
+}
+/**
+ * Parses one response into the top-tier agency list and the headline agencies.
+ *
+ * A row without an id or a name is a changed shape and stops the parse. The
+ * first row's fiscal year and quarter describe the whole list, which is how
+ * the API builds it.
+ *
+ * @param payload - the JSON body from the USAspending agencies endpoint
+ * @returns the agencies, the fiscal period, and the largest by obligation and outlay
+ */
+export function parseUsaSpendingAgenciesPayload(payload) {
+    const parsed = USASPENDING_AGENCIES_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(USASPENDING_AGENCIES_SOURCE_ID, parsed.error.message);
+    }
+    const rows = parsed.data.results ?? [];
+    if (rows.length === 0) {
+        throw new UsSourceParseError(USASPENDING_AGENCIES_SOURCE_ID, 'The response carried no agencies');
+    }
+    const agencies = rows.map((row) => {
+        if (row.agency_id === undefined || row.agency_name === undefined) {
+            throw new UsSourceParseError(USASPENDING_AGENCIES_SOURCE_ID, 'An agency row arrived without its id or name');
+        }
+        return {
+            agencyId: row.agency_id,
+            toptierCode: row.toptier_code ?? '',
+            abbreviation: row.abbreviation ?? '',
+            agencyName: row.agency_name,
+            activeFiscalYear: row.active_fy ?? '',
+            activeFiscalQuarter: row.active_fq ?? '',
+            outlayAmount: row.outlay_amount ?? 0,
+            obligatedAmount: row.obligated_amount ?? 0,
+            budgetAuthorityAmount: row.budget_authority_amount ?? 0,
+            currentTotalBudgetAuthorityAmount: row.current_total_budget_authority_amount ?? 0,
+            percentageOfTotalBudgetAuthority: row.percentage_of_total_budget_authority ?? 0,
+            agencySlug: row.agency_slug ?? '',
+            congressionalJustificationUrl: row.congressional_justification_url ?? null,
+        };
+    });
+    const first = agencies[0];
+    if (first === undefined) {
+        throw new UsSourceParseError(USASPENDING_AGENCIES_SOURCE_ID, 'No agencies to summarise');
+    }
+    return {
+        agencies,
+        agencyCount: agencies.length,
+        fiscalYear: first.activeFiscalYear,
+        fiscalQuarter: first.activeFiscalQuarter,
+        currentTotalBudgetAuthorityAmount: first.currentTotalBudgetAuthorityAmount,
+        largestByObligation: largestAgencyBy(agencies, 'obligatedAmount'),
+        largestByOutlay: largestAgencyBy(agencies, 'outlayAmount'),
+    };
+}
+/**
+ * Reads the top-tier federal agency reference list from USAspending.
+ *
+ * One keyless request covers every top-tier agency and the budget figures for
+ * the active fiscal quarter.
+ *
+ * @param options - an optional fetch stub
+ * @returns the agencies, the fiscal period, and the largest by obligation and outlay
+ */
+export async function fetchUsaSpendingAgencies(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = `${USASPENDING_API_BASE}${USASPENDING_TOP_TIER_AGENCIES_PATH}`;
+    const response = await fetchImpl(url);
+    if (!response.ok) {
+        throw new UsSourceApiError(USASPENDING_AGENCIES_SOURCE_ID, `HTTP ${response.status} reading the top-tier agencies`);
+    }
+    return parseUsaSpendingAgenciesPayload(await response.json());
+}
+/** USAspending top-tier federal agencies, one row per agency, keyless. */
+export const usaspendingAgenciesAdapter = {
+    id: USASPENDING_AGENCIES_SOURCE_ID,
+    name: 'USAspending agencies',
+    auth: 'none',
+    description: 'Top-tier federal agencies from USAspending, one row per agency, with the budget authority, obligations, and outlays for the active fiscal quarter.',
+    fetchLive: async (options) => fetchUsaSpendingAgencies(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseUsaSpendingAgenciesPayload(payload),
+    loadFixture: () => parseUsaSpendingAgenciesPayload(readFixtureJson(USASPENDING_AGENCIES_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=usaspendingAgencies.js.map

package/dist/usaspendingAgencies.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@usa-open-data-connectors/usa-sources",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "private": false,
   "type": "module",
   "main": "./dist/index.js",
@@ -42,5 +42,13 @@
   "publishConfig": {
     "access": "public"
   },
-  "description": "Uniform TypeScript adapters for US public data sources"
+  "description": "Uniform TypeScript adapters for US public data sources",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/olitreadwell/usa-open-data-connectors.git"
+  },
+  "homepage": "https://github.com/olitreadwell/usa-open-data-connectors#readme",
+  "bugs": {
+    "url": "https://github.com/olitreadwell/usa-open-data-connectors/issues"
+  }
 }