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

package/dist/collegeScorecardInstitutions.d.ts

@@ -0,0 +1,133 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the College Scorecard institution-level download. */
+export declare const COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID = "college-scorecard-institutions";
+/** The dated, keyless institution-level archive published by College Scorecard. */
+export declare const COLLEGE_SCORECARD_INSTITUTION_ARCHIVE_URL = "https://ed-public-download.scorecard.network/downloads/Most-Recent-Cohorts-Institution_10152026.zip";
+/** The data release the pinned archive represents, as YYYY-MM-DD. */
+export declare const COLLEGE_SCORECARD_DATA_RELEASE_DATE = "2026-10-15";
+/**
+ * The archive is 24 MB, and the CSV inside it is 102 MB.
+ *
+ * The shared 30 second timeout is tuned for small JSON answers, so this
+ * adapter allows two minutes for the download and inflation.
+ */
+export declare const COLLEGE_SCORECARD_FETCH_TIMEOUT_MS = 120000;
+/** The kind of institution the federal government recorded. */
+export type CollegeScorecardControl = 'public' | 'private-nonprofit' | 'private-for-profit' | 'unknown';
+/** One institution and the outcome fields a story can use. */
+export interface CollegeScorecardInstitution {
+    /** IPEDS unit id, the federal identifier for the institution. */
+    unitId: number;
+    /** Department of Education OPEID, or an empty string when the file has none. */
+    opeId: string;
+    /** Institution name as it appears in the federal file. */
+    name: string;
+    /** City and state from the institution address. */
+    city: string;
+    /** Two-letter state abbreviation, or an empty string when the file has none. */
+    stateAbbr: string;
+    /** Public institution website, or null when the file has none. */
+    institutionUrl: string | null;
+    /** Public, private nonprofit, private for-profit, or unknown. */
+    control: CollegeScorecardControl;
+    /** Undergraduate enrollment, or null when suppressed. */
+    undergraduateEnrollment: number | null;
+    /** Admission rate as a fraction from 0 to 1, or null when unavailable. */
+    admissionRate: number | null;
+    /** In-state tuition and fees in dollars, or null when unavailable. */
+    inStateTuition: number | null;
+    /** Out-of-state tuition and fees in dollars, or null when unavailable. */
+    outStateTuition: number | null;
+    /** Median federal student debt at graduation in dollars, or null. */
+    medianDebt: number | null;
+    /** Six-year completion rate as a fraction, or null when unavailable. */
+    completionRate: number | null;
+    /** First-year retention rate as a fraction, or null when unavailable. */
+    retentionRate: number | null;
+    /**
+     * Median earnings of graduates working and not enrolled ten years after
+     * entry, in dollars, or null when unavailable.
+     */
+    medianEarnings10Years: number | null;
+}
+/** One state's institutions, folded into the numbers a chart needs. */
+export interface CollegeScorecardStateSummary {
+    /** Two-letter state abbreviation. */
+    stateAbbr: string;
+    /** Institutions in the state, whether or not they report outcomes. */
+    institutionCount: number;
+    /** Institutions with a reported ten-year median earnings figure. */
+    earningsReportedCount: number;
+    /** Median of the reported institution medians, in dollars, or null. */
+    medianEarnings10Years: number | null;
+    /** Median of the reported institution median debt figures, in dollars, or null. */
+    medianDebt: number | null;
+    /** Median of the reported institution completion rates, or null. */
+    medianCompletionRate: number | null;
+    /** Public institutions in the state. */
+    publicInstitutionCount: number;
+    /** Private nonprofit institutions in the state. */
+    privateNonprofitInstitutionCount: number;
+    /** Private for-profit institutions in the state. */
+    privateForProfitInstitutionCount: number;
+}
+/** The institution file folded for a story. */
+export interface CollegeScorecardSnapshot {
+    /** The College Scorecard release the pinned archive represents. */
+    dataReleaseDate: string;
+    /** One row per institution in the file. */
+    institutions: CollegeScorecardInstitution[];
+    institutionCount: number;
+    /** Number of states and territories with at least one institution. */
+    stateCount: number;
+    /** Institutions with a reported ten-year median earnings figure. */
+    earningsReportedCount: number;
+    /** States and territories, alphabetical by abbreviation. */
+    stateSummaries: CollegeScorecardStateSummary[];
+    /** Median of every reported institution median, in dollars, or null. */
+    nationalMedianEarnings10Years: number | null;
+    /** Median of every reported institution median debt, in dollars, or null. */
+    nationalMedianDebt: number | null;
+    /** Median of every reported institution completion rate, or null. */
+    nationalMedianCompletionRate: number | null;
+    /** State with the highest median of institution earnings, or null. */
+    highestEarningState: CollegeScorecardStateSummary | null;
+    /** State with the lowest median of institution earnings, or null. */
+    lowestEarningState: CollegeScorecardStateSummary | null;
+    /** Institution with the highest ten-year median earnings, or null. */
+    highestEarningInstitution: CollegeScorecardInstitution | null;
+}
+/**
+ * Parses the institution-level CSV into one row per institution and its state
+ * summaries.
+ *
+ * The federal file is very wide and uses "NA" and "PS" for figures it did not
+ * publish. Those become null rather than zero, so a chart never turns a
+ * suppressed value into an invented one.
+ *
+ * @param csv - the CSV text from the institution archive
+ * @returns every institution, plus the state and national summaries
+ */
+export declare function parseCollegeScorecardCsv(csv: string): CollegeScorecardSnapshot;
+/**
+ * Reads the institution archive, which is a zip containing one wide CSV.
+ *
+ * The live download is a zip. A committed fixture and a hand-copied sample are
+ * plain CSV, so the parser accepts both shapes.
+ *
+ * @param payload - the zip bytes, an ArrayBuffer, or CSV text
+ * @returns every institution, plus the state and national summaries
+ */
+export declare function parseCollegeScorecardArchive(payload: unknown): CollegeScorecardSnapshot;
+/**
+ * Downloads and parses the keyless College Scorecard institution archive.
+ *
+ * @param options - an optional fetch stub
+ * @returns every institution, plus the state and national summaries
+ */
+export declare function fetchCollegeScorecardInstitutions(options?: {
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<CollegeScorecardSnapshot>;
+/** College Scorecard institution-level outcomes, keyless bulk download. */
+export declare const collegeScorecardInstitutionsAdapter: UsDataAdapter<CollegeScorecardSnapshot>;
+//# sourceMappingURL=collegeScorecardInstitutions.d.ts.map

package/dist/collegeScorecardInstitutions.d.ts.map

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

package/dist/collegeScorecardInstitutions.js

@@ -0,0 +1,339 @@
+import { strFromU8, unzipSync } from 'fflate';
+import { UsSourceParseError } from './errors.js';
+import { readFixtureText } from './fixtures.js';
+import { httpGet } from './http.js';
+/** Adapter id for the College Scorecard institution-level download. */
+export const COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID = 'college-scorecard-institutions';
+/** The dated, keyless institution-level archive published by College Scorecard. */
+export const COLLEGE_SCORECARD_INSTITUTION_ARCHIVE_URL = 'https://ed-public-download.scorecard.network/downloads/Most-Recent-Cohorts-Institution_10152026.zip';
+/** The data release the pinned archive represents, as YYYY-MM-DD. */
+export const COLLEGE_SCORECARD_DATA_RELEASE_DATE = '2026-10-15';
+/**
+ * The archive is 24 MB, and the CSV inside it is 102 MB.
+ *
+ * The shared 30 second timeout is tuned for small JSON answers, so this
+ * adapter allows two minutes for the download and inflation.
+ */
+export const COLLEGE_SCORECARD_FETCH_TIMEOUT_MS = 120_000;
+/** Committed sample of real rows, so a build works when the archive is unreachable. */
+const COLLEGE_SCORECARD_FIXTURE_FILENAME = 'college-scorecard-institutions-2026-10-15-sampled.csv';
+/** Column names the adapter reads from the wide institution CSV. */
+const REQUIRED_COLUMNS = [
+    'UNITID',
+    'OPEID',
+    'INSTNM',
+    'CITY',
+    'STABBR',
+    'INSTURL',
+    'CONTROL',
+    'UGDS',
+    'ADM_RATE',
+    'TUITIONFEE_IN',
+    'TUITIONFEE_OUT',
+    'DEBT_MDN',
+    'C150_4',
+    'RET_FT4',
+    'MD_EARN_WNE_P10',
+];
+/** Values the federal file uses for a number it did not publish. */
+const MISSING_VALUES = new Set(['', 'NA', 'PS', 'PRIVACYSUPPRESSED', 'NULL']);
+/** The control codes the federal file uses for public and private institutions. */
+const CONTROL_LABELS = {
+    '1': 'public',
+    '2': 'private-nonprofit',
+    '3': 'private-for-profit',
+};
+/**
+ * Splits one CSV line into fields, following the quoting rule the federal file
+ * uses: a field wrapped in double quotes may contain commas, and two double
+ * quotes inside it mean one literal double quote.
+ */
+function splitCsvLine(line) {
+    const fields = [];
+    let field = '';
+    let inQuotes = false;
+    for (let index = 0; index < line.length; index += 1) {
+        const character = line[index];
+        if (inQuotes) {
+            if (character === '"') {
+                if (line[index + 1] === '"') {
+                    field += '"';
+                    index += 1;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else if (character !== undefined) {
+                field += character;
+            }
+        }
+        else if (character === '"') {
+            inQuotes = true;
+        }
+        else if (character === ',') {
+            fields.push(field);
+            field = '';
+        }
+        else if (character !== undefined && character !== '\r') {
+            field += character;
+        }
+    }
+    if (inQuotes) {
+        throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, 'A quoted field in the institution file did not close');
+    }
+    fields.push(field);
+    return fields;
+}
+/** Reads a text field, turning the federal missing markers into an empty string. */
+function readText(value) {
+    const text = value?.trim() ?? '';
+    return MISSING_VALUES.has(text.toUpperCase()) ? '' : text;
+}
+/** Reads a numeric field, turning suppressed values into null. */
+function readNumber(value, column) {
+    const text = readText(value);
+    if (text === '') {
+        return null;
+    }
+    const number = Number(text);
+    if (!Number.isFinite(number)) {
+        throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, `Unreadable ${column} value in the institution file: ${text}`);
+    }
+    return number;
+}
+/** Maps the federal control code to its plain-language label. */
+function readControl(value) {
+    return CONTROL_LABELS[readText(value)] ?? 'unknown';
+}
+/** Returns the median of the values, or null when there are none. */
+function median(values) {
+    if (values.length === 0) {
+        return null;
+    }
+    const sorted = [...values].sort((left, right) => left - right);
+    const middle = Math.floor(sorted.length / 2);
+    if (sorted.length % 2 === 1) {
+        return sorted[middle] ?? null;
+    }
+    const left = sorted[middle - 1];
+    const right = sorted[middle];
+    return left === undefined || right === undefined ? null : (left + right) / 2;
+}
+/** Builds one state's summary from the institutions in it. */
+function buildStateSummary(stateAbbr, institutions) {
+    const earnings = institutions
+        .map((institution) => institution.medianEarnings10Years)
+        .filter((value) => value !== null);
+    const debt = institutions
+        .map((institution) => institution.medianDebt)
+        .filter((value) => value !== null);
+    const completion = institutions
+        .map((institution) => institution.completionRate)
+        .filter((value) => value !== null);
+    return {
+        stateAbbr,
+        institutionCount: institutions.length,
+        earningsReportedCount: earnings.length,
+        medianEarnings10Years: median(earnings),
+        medianDebt: median(debt),
+        medianCompletionRate: median(completion),
+        publicInstitutionCount: institutions.filter((institution) => institution.control === 'public')
+            .length,
+        privateNonprofitInstitutionCount: institutions.filter((institution) => institution.control === 'private-nonprofit').length,
+        privateForProfitInstitutionCount: institutions.filter((institution) => institution.control === 'private-for-profit').length,
+    };
+}
+/** Picks the institution with the highest reported earnings, ties to the earlier row. */
+function findHighestEarningInstitution(institutions) {
+    let best = null;
+    for (const institution of institutions) {
+        if (institution.medianEarnings10Years === null) {
+            continue;
+        }
+        if (best === null ||
+            (best.medianEarnings10Years !== null &&
+                institution.medianEarnings10Years > best.medianEarnings10Years)) {
+            best = institution;
+        }
+    }
+    return best;
+}
+/** Picks the state with the highest or lowest median earnings, ties alphabetically. */
+function findStateByEarnings(summaries, direction) {
+    const reported = summaries.filter((summary) => summary.medianEarnings10Years !== null);
+    if (reported.length === 0) {
+        return null;
+    }
+    return reported.reduce((best, summary) => {
+        if (summary.medianEarnings10Years === best.medianEarnings10Years) {
+            return summary.stateAbbr < best.stateAbbr ? summary : best;
+        }
+        const higher = summary.medianEarnings10Years > best.medianEarnings10Years;
+        return (direction === 'highest' ? higher : !higher) ? summary : best;
+    });
+}
+/**
+ * Parses the institution-level CSV into one row per institution and its state
+ * summaries.
+ *
+ * The federal file is very wide and uses "NA" and "PS" for figures it did not
+ * publish. Those become null rather than zero, so a chart never turns a
+ * suppressed value into an invented one.
+ *
+ * @param csv - the CSV text from the institution archive
+ * @returns every institution, plus the state and national summaries
+ */
+export function parseCollegeScorecardCsv(csv) {
+    const lines = csv
+        .replace(/^\ufeff/, '')
+        .split('\n')
+        .map((line) => line.trimEnd())
+        .filter((line) => line.trim() !== '');
+    const headerLine = lines[0];
+    if (headerLine === undefined) {
+        throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, 'The institution file was empty');
+    }
+    const header = splitCsvLine(headerLine);
+    const columnIndexes = new Map();
+    for (const column of REQUIRED_COLUMNS) {
+        const index = header.indexOf(column);
+        if (index === -1) {
+            throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, `The institution file is missing the ${column} column`);
+        }
+        columnIndexes.set(column, index);
+    }
+    const column = (row, name) => {
+        const index = columnIndexes.get(name);
+        return index === undefined ? undefined : row[index];
+    };
+    const institutions = [];
+    for (const line of lines.slice(1)) {
+        const row = splitCsvLine(line);
+        if (row.length !== header.length) {
+            throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, `A row in the institution file had ${row.length} fields, expected ${header.length}`);
+        }
+        const unitId = readNumber(column(row, 'UNITID'), 'UNITID');
+        const name = readText(column(row, 'INSTNM'));
+        if (unitId === null || name === '') {
+            throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, 'An institution row arrived without its unit id or name');
+        }
+        institutions.push({
+            unitId,
+            opeId: readText(column(row, 'OPEID')),
+            name,
+            city: readText(column(row, 'CITY')),
+            stateAbbr: readText(column(row, 'STABBR')),
+            institutionUrl: readText(column(row, 'INSTURL')) || null,
+            control: readControl(column(row, 'CONTROL')),
+            undergraduateEnrollment: readNumber(column(row, 'UGDS'), 'UGDS'),
+            admissionRate: readNumber(column(row, 'ADM_RATE'), 'ADM_RATE'),
+            inStateTuition: readNumber(column(row, 'TUITIONFEE_IN'), 'TUITIONFEE_IN'),
+            outStateTuition: readNumber(column(row, 'TUITIONFEE_OUT'), 'TUITIONFEE_OUT'),
+            medianDebt: readNumber(column(row, 'DEBT_MDN'), 'DEBT_MDN'),
+            completionRate: readNumber(column(row, 'C150_4'), 'C150_4'),
+            retentionRate: readNumber(column(row, 'RET_FT4'), 'RET_FT4'),
+            medianEarnings10Years: readNumber(column(row, 'MD_EARN_WNE_P10'), 'MD_EARN_WNE_P10'),
+        });
+    }
+    if (institutions.length === 0) {
+        throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, 'The institution file had a header but no rows');
+    }
+    const byState = new Map();
+    for (const institution of institutions) {
+        if (institution.stateAbbr === '') {
+            continue;
+        }
+        const rows = byState.get(institution.stateAbbr) ?? [];
+        rows.push(institution);
+        byState.set(institution.stateAbbr, rows);
+    }
+    const stateSummaries = [...byState.entries()]
+        .map(([stateAbbr, rows]) => buildStateSummary(stateAbbr, rows))
+        .sort((left, right) => left.stateAbbr.localeCompare(right.stateAbbr));
+    const earnings = institutions
+        .map((institution) => institution.medianEarnings10Years)
+        .filter((value) => value !== null);
+    const debt = institutions
+        .map((institution) => institution.medianDebt)
+        .filter((value) => value !== null);
+    const completion = institutions
+        .map((institution) => institution.completionRate)
+        .filter((value) => value !== null);
+    return {
+        dataReleaseDate: COLLEGE_SCORECARD_DATA_RELEASE_DATE,
+        institutions,
+        institutionCount: institutions.length,
+        stateCount: stateSummaries.length,
+        earningsReportedCount: earnings.length,
+        stateSummaries,
+        nationalMedianEarnings10Years: median(earnings),
+        nationalMedianDebt: median(debt),
+        nationalMedianCompletionRate: median(completion),
+        highestEarningState: findStateByEarnings(stateSummaries, 'highest'),
+        lowestEarningState: findStateByEarnings(stateSummaries, 'lowest'),
+        highestEarningInstitution: findHighestEarningInstitution(institutions),
+    };
+}
+/**
+ * Reads the institution archive, which is a zip containing one wide CSV.
+ *
+ * The live download is a zip. A committed fixture and a hand-copied sample are
+ * plain CSV, so the parser accepts both shapes.
+ *
+ * @param payload - the zip bytes, an ArrayBuffer, or CSV text
+ * @returns every institution, plus the state and national summaries
+ */
+export function parseCollegeScorecardArchive(payload) {
+    if (typeof payload === 'string') {
+        return parseCollegeScorecardCsv(payload);
+    }
+    let bytes;
+    if (payload instanceof ArrayBuffer) {
+        bytes = new Uint8Array(payload);
+    }
+    else if (payload instanceof Uint8Array) {
+        bytes = payload;
+    }
+    else {
+        throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, 'The institution archive must be zip bytes or CSV text');
+    }
+    if (bytes[0] !== 0x50 || bytes[1] !== 0x4b) {
+        return parseCollegeScorecardCsv(new TextDecoder().decode(bytes));
+    }
+    let files;
+    try {
+        files = unzipSync(bytes);
+    }
+    catch (error) {
+        throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, 'The institution archive was not a readable zip', { cause: error });
+    }
+    const csvName = Object.keys(files).find((name) => name.endsWith('.csv') && !name.startsWith('__MACOSX/'));
+    const csvBytes = csvName === undefined ? undefined : files[csvName];
+    if (csvBytes === undefined) {
+        throw new UsSourceParseError(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, 'The institution archive contained no CSV');
+    }
+    return parseCollegeScorecardCsv(strFromU8(csvBytes));
+}
+/**
+ * Downloads and parses the keyless College Scorecard institution archive.
+ *
+ * @param options - an optional fetch stub
+ * @returns every institution, plus the state and national summaries
+ */
+export async function fetchCollegeScorecardInstitutions(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const response = await httpGet(COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, COLLEGE_SCORECARD_INSTITUTION_ARCHIVE_URL, { fetchImpl, timeoutMs: COLLEGE_SCORECARD_FETCH_TIMEOUT_MS });
+    return parseCollegeScorecardArchive(await response.arrayBuffer());
+}
+/** College Scorecard institution-level outcomes, keyless bulk download. */
+export const collegeScorecardInstitutionsAdapter = {
+    id: COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID,
+    name: 'College Scorecard institutions',
+    auth: 'none',
+    description: 'Institution-level College Scorecard outcomes for US colleges: enrollment, cost, completion, debt, and earnings ten years after entry, from the Department of Education bulk download.',
+    fetchLive: async (options) => fetchCollegeScorecardInstitutions(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseCollegeScorecardArchive(payload),
+    loadFixture: () => parseCollegeScorecardCsv(readFixtureText(COLLEGE_SCORECARD_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=collegeScorecardInstitutions.js.map

package/dist/collegeScorecardInstitutions.js.map

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

package/dist/http.d.ts

@@ -18,12 +18,16 @@ export interface HttpGetOptions {
     headers?: Record<string, string> | undefined;
     /** Overrides {@link DEFAULT_TIMEOUT_MS}. */
     timeoutMs?: number | undefined;
+    /** How many times a retryable failure is attempted again. Defaults to 0. */
+    retries?: number | undefined;
+    /** Base delay between retry attempts, doubled each time. Defaults to 1000ms. */
+    retryDelayMs?: number | undefined;
 }
 /**
  * Issues a GET through the shared HTTP layer.
  *
  * Every adapter goes through here so that three things happen the same way
- * for all 22 sources: a `user-agent` identifies the client, a timeout aborts
+ * for all registered sources: a `user-agent` identifies the client, a timeout aborts
  * a request that hangs, and a failure carries whether retrying is worthwhile.
  *
  * @param source - Source name used in the error message, e.g. "bls".

package/dist/http.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,mDAAmD,CAAC;AAE3E,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAQzC,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAChD,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAChC;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CA8BnB"}
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU,mDAAmD,CAAC;AAE3E,qEAAqE;AACrE,eAAO,MAAM,kBAAkB,QAAS,CAAC;AAQzC,iDAAiD;AACjD,MAAM,WAAW,cAAc;IAC7B,oDAAoD;IACpD,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,GAAG,SAAS,CAAC;IAChD,uDAAuD;IACvD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7C,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,gFAAgF;IAChF,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACnC;AAyBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,OAAO,CAC3B,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GAAG,GAAG,EACjB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,QAAQ,CAAC,CAsCnB"}

package/dist/http.js

@@ -42,7 +42,7 @@ function buildRequestHeaders(extra) {
  * Issues a GET through the shared HTTP layer.
  *
  * Every adapter goes through here so that three things happen the same way
- * for all 22 sources: a `user-agent` identifies the client, a timeout aborts
+ * for all registered sources: a `user-agent` identifies the client, a timeout aborts
  * a request that hangs, and a failure carries whether retrying is worthwhile.
  *
  * @param source - Source name used in the error message, e.g. "bls".
@@ -54,32 +54,40 @@ function buildRequestHeaders(extra) {
 export async function httpGet(source, url, options = {}) {
     const doFetch = options.fetchImpl ?? globalThis.fetch;
     const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUT_MS;
-    const controller = new AbortController();
-    const timer = setTimeout(() => controller.abort(), timeoutMs);
-    let response;
-    try {
-        response = await doFetch(url, {
-            headers: buildRequestHeaders(options.headers),
-            signal: controller.signal,
-        });
-    }
-    catch (error) {
-        if (controller.signal.aborted) {
-            throw new UsSourceApiError(source, `request timed out after ${timeoutMs}ms`, {
-                retryable: true,
+    const retries = options.retries ?? 0;
+    const retryDelayMs = options.retryDelayMs ?? 1000;
+    for (let attempt = 0;; attempt += 1) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeoutMs);
+        let response;
+        try {
+            response = await doFetch(url, {
+                headers: buildRequestHeaders(options.headers),
+                signal: controller.signal,
             });
         }
-        throw new UsSourceApiError(source, `request failed: ${String(error)}`, { retryable: true });
-    }
-    finally {
-        clearTimeout(timer);
-    }
-    if (!response.ok) {
-        throw new UsSourceApiError(source, `HTTP ${response.status}`, {
-            status: response.status,
-            retryable: response.status === HTTP_TOO_MANY_REQUESTS || response.status >= HTTP_INTERNAL_SERVER_ERROR,
-        });
+        catch (error) {
+            if (controller.signal.aborted) {
+                throw new UsSourceApiError(source, `request timed out after ${timeoutMs}ms`, {
+                    retryable: true,
+                });
+            }
+            throw new UsSourceApiError(source, `request failed: ${String(error)}`, { retryable: true });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (response.ok) {
+            return response;
+        }
+        const retryable = response.status === HTTP_TOO_MANY_REQUESTS || response.status >= HTTP_INTERNAL_SERVER_ERROR;
+        if (!retryable || attempt >= retries) {
+            throw new UsSourceApiError(source, `HTTP ${response.status}`, {
+                status: response.status,
+                retryable,
+            });
+        }
+        await new Promise((resolve) => setTimeout(resolve, retryDelayMs * 2 ** attempt));
     }
-    return response;
 }
 //# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -1 +1 @@
-{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,gDAAgD,CAAC;AAE3E,qEAAqE;AACrE,MAAM,CAAC,MAAM,kBAAkB,GAAG,MAAM,CAAC;AAEzC,gFAAgF;AAChF,MAAM,sBAAsB,GAAG,GAAG,CAAC;AAEnC,mFAAmF;AACnF,MAAM,0BAA0B,GAAG,GAAG,CAAC;AAYvC;;;;;;;;;;GAUG;AACH,SAAS,mBAAmB,CAAC,KAAyC;IACpE,MAAM,OAAO,GAA2B,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC;IACrE,KAAK,MAAM,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC;QACxD,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,YAAY,EAAE,CAAC;YACxC,OAAO,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC;QAChC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,MAAc,EACd,GAAiB,EACjB,OAAO,GAAmB,EAAE;IAE5B,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC;IACtD,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,kBAAkB,CAAC;IAC1D,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,SAAS,CAAC,CAAC;IAC9D,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,OAAO,CAAC,GAAG,EAAE;YAC5B,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,OAAO,CAAC;YAC7C,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YAC9B,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,2BAA2B,SAAS,IAAI,EAAE;gBAC3E,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,mBAAmB,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9F,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,KAAK,CAAC,CAAC;IACtB,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,EAAE;YAC5D,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,SAAS,EACP,QAAQ,CAAC,MAAM,KAAK,sBAAsB,IAAI,QAAQ,CAAC,MAAM,IAAI,0BAA0B;SAC9F,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC"}
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -24,6 +24,10 @@ export { buildNoaaSeaLevelSeries, buildNoaaSeaLevelUrl, fetchNoaaSeaLevel, noaaS
 export type { NoaaSeaLevelMonth, NoaaSeaLevelPayload, NoaaSeaLevelQuery, NoaaSeaLevelSeries, NoaaSeaLevelStation, NoaaSeaLevelYear, } from './noaaSeaLevel.js';
 /** The uniform adapter registry and probe helpers. */
 export { US_DATA_SOURCES, getUsDataSource, probeAllUsDataSources, probeUsDataSource, } from './registry.js';
+/** NextBus live transit vehicle positions (keyless). */
+export { buildNextBusVehicleUrl, fetchNextBusVehicles, nextBusTransitVehiclesAdapter, NEXTBUS_PORTLAND_STREETCAR_AGENCY_TAG, NEXTBUS_PORTLAND_STREETCAR_QUERY, NEXTBUS_PORTLAND_STREETCAR_ROUTE_TAG, NEXTBUS_TRANSIT_VEHICLES_SOURCE_ID, NEXTBUS_XML_FEED_BASE, parseNextBusVehiclePayload, } from './nextBusTransitVehicles.js';
+/** NextBus transit vehicle types. */
+export type { NextBusVehicle, NextBusVehicleQuery, NextBusVehicleSnapshot, } from './nextBusTransitVehicles.js';
 /** US Treasury average interest rate on the debt outstanding (keyless). */
 export { buildTreasuryAvgInterestRateSeries, buildTreasuryAvgInterestRateUrl, fetchTreasuryAvgInterestRates, parseTreasuryAvgInterestRatePayload, treasuryAvgInterestRateAdapter, TREASURY_AVG_INTEREST_RATE_FIRST_YEAR, TREASURY_AVG_INTEREST_RATE_PATH, TREASURY_AVG_INTEREST_RATE_ROW_LIMIT, TREASURY_AVG_INTEREST_RATE_SECURITY_DESCRIPTION, TREASURY_AVG_INTEREST_RATE_SECURITY_TYPE, TREASURY_FISCAL_DATA_API_BASE, } from './treasuryAvgInterestRate.js';
 /** Treasury interest rate types. */
@@ -100,6 +104,18 @@ export type { BtsCatalogueCategoryCount, BtsCatalogueEntry, BtsTransportationCat
 export { buildEstimateTaxUrl, ESTIMATETAX_API_BASE, ESTIMATETAX_CALCULATE_PATH, ESTIMATETAX_DEFAULT_CITY, ESTIMATETAX_DEFAULT_INCOME, ESTIMATETAX_DEFAULT_QUERY, ESTIMATETAX_DEFAULT_STATE, ESTIMATETAX_FILING_STATUSES, ESTIMATETAX_INCOME_TAX_SOURCE_ID, estimatetaxIncomeTaxAdapter, fetchEstimateTaxCalculation, parseEstimateTaxCalculation, } from './estimatetaxIncomeTax.js';
 /** EstimateTax income tax types. */
 export type { EstimateTaxBracket, EstimateTaxCalculation, EstimateTaxFederal, EstimateTaxFilingStatus, EstimateTaxInput, EstimateTaxLocal, EstimateTaxQuery, EstimateTaxSource, EstimateTaxSources, EstimateTaxState, EstimateTaxTotals, } from './estimatetaxIncomeTax.js';
+/** Callook.info US amateur radio callsign lookup (keyless). */
+export { buildCallookCallsignDirectory, buildCallookCallsignUrl, CALLOOK_API_BASE, CALLOOK_CALLSIGNS_SOURCE_ID, CALLOOK_DISTRICT_CALLSIGNS, callookCallsignsAdapter, fetchCallookCallsigns, parseCallookCallsignsPayload, } from './callookCallsigns.js';
+/** Callook.info callsign types. */
+export type { CallookCallsign, CallookCallsignDirectory, CallookLabelCount, CallookLookupStatus, } from './callookCallsigns.js';
+/** College Scorecard institution-level outcomes (keyless bulk download). */
+export { COLLEGE_SCORECARD_DATA_RELEASE_DATE, COLLEGE_SCORECARD_FETCH_TIMEOUT_MS, COLLEGE_SCORECARD_INSTITUTION_ARCHIVE_URL, COLLEGE_SCORECARD_INSTITUTION_SOURCE_ID, collegeScorecardInstitutionsAdapter, fetchCollegeScorecardInstitutions, parseCollegeScorecardArchive, parseCollegeScorecardCsv, } from './collegeScorecardInstitutions.js';
+/** College Scorecard institution types. */
+export type { CollegeScorecardControl, CollegeScorecardInstitution, CollegeScorecardSnapshot, CollegeScorecardStateSummary, } from './collegeScorecardInstitutions.js';
+/** PublicDataHub Medicare hospital quality records (keyless). */
+export { buildPublicDataHubHospitalUrl, fetchPublicDataHubHospital, getPublicDataHubMeasure, parsePublicDataHubHospitalPayload, PUBLICDATAHUB_API_BASE, PUBLICDATAHUB_DEFAULT_HOSPITAL_SLUG, PUBLICDATAHUB_HOSPITAL_SOURCE_ID, publicDataHubHospitalAdapter, } from './publicDataHubHospital.js';
+/** PublicDataHub hospital quality types. */
+export type { PublicDataHubHospital, PublicDataHubHospitalAddress, PublicDataHubHospitalQuality, PublicDataHubMeasure, PublicDataHubProvenance, } from './publicDataHubHospital.js';
 /** Shared adapter contract types. */
 export type { UsDataAdapter, UsFetchOptions, UsSourceAuth, UsSourceProbe } from './types.js';
 /** API key normalization shared by adapters, the API, and the CLI. */