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

package/dist/fdicBankDirectory.d.ts

@@ -0,0 +1,78 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the FDIC bank directory source. */
+export declare const FDIC_BANK_DIRECTORY_SOURCE_ID = "fdic-bank-directory";
+/** One bank in the FDIC's institution directory. */
+export interface FdicBank {
+    /** The FDIC's own certificate number for the bank. */
+    id: string;
+    /** The bank's legal name. */
+    name: string;
+    /** City of the bank's main office. */
+    city: string;
+    /** Two-letter state code of the main office. */
+    stateAbbr: string;
+}
+/** One state and how many banks in the page sit there. */
+export interface FdicBankStateCount {
+    stateAbbr: string;
+    bankCount: number;
+}
+/** One page of the bank directory, folded for a story. */
+export interface FdicBankDirectory {
+    /** One entry per bank in the page. */
+    banks: FdicBank[];
+    bankCount: number;
+    /** How many banks the FDIC holds in total, not just in this page. */
+    totalBanks: number;
+    /** States the banks in the page sit in, most banks first. */
+    states: FdicBankStateCount[];
+}
+/** Base URL for the FDIC institutions API. */
+export declare const FDIC_BANK_API_BASE = "https://banks.data.fdic.gov/api/institutions";
+/** Row cap for one request. */
+export declare const FDIC_BANK_ROW_LIMIT = 10;
+/** Columns the adapter asks for. The directory carries many more. */
+export declare const FDIC_BANK_FIELDS = "NAME,CITY,STALP";
+/**
+ * Builds the request URL for one page of the bank directory.
+ *
+ * The endpoint is keyless. The `fields` parameter trims the response to the
+ * columns a story reads, which keeps each row small. The service answers the
+ * banks.data.fdic.gov host with a redirect to api.fdic.gov, which fetch
+ * follows.
+ *
+ * @param options - an optional row cap and column list
+ * @returns the full request URL
+ */
+export declare function buildFdicBankDirectoryUrl(options?: {
+    rowLimit?: number;
+    fields?: string;
+}): string;
+/**
+ * Parses one response into the banks in the page and the state counts.
+ *
+ * A row without an id, name, city, or state is a changed shape and stops the
+ * parse. The API's own total is used for `totalBanks`, falling back to the
+ * page size when the envelope omits it.
+ *
+ * @param payload - the JSON body from the FDIC institutions API
+ * @returns the banks in the page, the total the FDIC reports, and state counts
+ */
+export declare function parseFdicBankDirectoryPayload(payload: unknown): FdicBankDirectory;
+/**
+ * Reads one page of the FDIC's bank directory.
+ *
+ * One keyless request covers the page. The service trims each row to the
+ * columns asked for, so a story gets names, cities, and states without the
+ * full institution record.
+ *
+ * @param options - an optional row cap and fetch stub
+ * @returns the banks in the page, the FDIC total, and the state counts
+ */
+export declare function fetchFdicBankDirectory(options?: {
+    rowLimit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<FdicBankDirectory>;
+/** FDIC bank directory, one row per insured institution, keyless. */
+export declare const fdicBankDirectoryAdapter: UsDataAdapter<FdicBankDirectory>;
+//# sourceMappingURL=fdicBankDirectory.d.ts.map

package/dist/fdicBankDirectory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fdicBankDirectory.d.ts","sourceRoot":"","sources":["../src/fdicBankDirectory.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qDAAqD;AACrD,eAAO,MAAM,6BAA6B,wBAAwB,CAAC;AAEnE,oDAAoD;AACpD,MAAM,WAAW,QAAQ;IACvB,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,6BAA6B;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,sCAAsC;IACtC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,MAAM,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,8CAA8C;AAC9C,eAAO,MAAM,kBAAkB,iDAAiD,CAAC;AAEjF,+BAA+B;AAC/B,eAAO,MAAM,mBAAmB,KAAK,CAAC;AAEtC,qEAAqE;AACrE,eAAO,MAAM,gBAAgB,oBAAoB,CAAC;AAuBlD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,MAAM,CAMT;AAeD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAiCjF;AAED;;;;;;;;;GASG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,CAAC,EAAE;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAO7B;AAED,qEAAqE;AACrE,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,iBAAiB,CAYrE,CAAC"}

package/dist/fdicBankDirectory.js

@@ -0,0 +1,122 @@
+import { z } from 'zod';
+import { UsSourceApiError, UsSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/** Adapter id for the FDIC bank directory source. */
+export const FDIC_BANK_DIRECTORY_SOURCE_ID = 'fdic-bank-directory';
+/** Base URL for the FDIC institutions API. */
+export const FDIC_BANK_API_BASE = 'https://banks.data.fdic.gov/api/institutions';
+/** Row cap for one request. */
+export const FDIC_BANK_ROW_LIMIT = 10;
+/** Columns the adapter asks for. The directory carries many more. */
+export const FDIC_BANK_FIELDS = 'NAME,CITY,STALP';
+/** Committed snapshot, so a build works when the FDIC host is unreachable. */
+const FDIC_BANK_FIXTURE_FILENAME = 'fdic-bank-directory-2026-10-05.json';
+// The API wraps each institution in a result object with its own score, and
+// answers a rejected request with an HTTP error and a body of {errors}.
+const FDIC_BANK_ROW_SCHEMA = z.object({
+    data: z.object({
+        ID: z.string().optional(),
+        NAME: z.string().optional(),
+        CITY: z.string().optional(),
+        STALP: z.string().optional(),
+    }),
+});
+const FDIC_BANK_PAYLOAD_SCHEMA = z.object({
+    meta: z.object({ total: z.number().optional() }).optional(),
+    totals: z.object({ count: z.number().optional() }).optional(),
+    data: z.array(FDIC_BANK_ROW_SCHEMA).optional(),
+    errors: z.array(z.unknown()).optional(),
+});
+/**
+ * Builds the request URL for one page of the bank directory.
+ *
+ * The endpoint is keyless. The `fields` parameter trims the response to the
+ * columns a story reads, which keeps each row small. The service answers the
+ * banks.data.fdic.gov host with a redirect to api.fdic.gov, which fetch
+ * follows.
+ *
+ * @param options - an optional row cap and column list
+ * @returns the full request URL
+ */
+export function buildFdicBankDirectoryUrl(options) {
+    const params = new URLSearchParams({
+        limit: String(options?.rowLimit ?? FDIC_BANK_ROW_LIMIT),
+        fields: options?.fields ?? FDIC_BANK_FIELDS,
+    });
+    return `${FDIC_BANK_API_BASE}?${params.toString()}`;
+}
+/** Counts banks per state in the order they were seen. */
+function countFdicBankStates(banks) {
+    const counts = new Map();
+    for (const bank of banks) {
+        counts.set(bank.stateAbbr, (counts.get(bank.stateAbbr) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .sort(([leftState, leftCount], [rightState, rightCount]) => leftCount === rightCount ? leftState.localeCompare(rightState) : rightCount - leftCount)
+        .map(([stateAbbr, bankCount]) => ({ stateAbbr, bankCount }));
+}
+/**
+ * Parses one response into the banks in the page and the state counts.
+ *
+ * A row without an id, name, city, or state is a changed shape and stops the
+ * parse. The API's own total is used for `totalBanks`, falling back to the
+ * page size when the envelope omits it.
+ *
+ * @param payload - the JSON body from the FDIC institutions API
+ * @returns the banks in the page, the total the FDIC reports, and state counts
+ */
+export function parseFdicBankDirectoryPayload(payload) {
+    const parsed = FDIC_BANK_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(FDIC_BANK_DIRECTORY_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.errors !== undefined && parsed.data.errors.length > 0) {
+        throw new UsSourceApiError(FDIC_BANK_DIRECTORY_SOURCE_ID, 'The API rejected the request');
+    }
+    const rows = parsed.data.data ?? [];
+    if (rows.length === 0) {
+        throw new UsSourceParseError(FDIC_BANK_DIRECTORY_SOURCE_ID, 'The response carried no rows');
+    }
+    const banks = rows.map((row) => {
+        const { ID, NAME, CITY, STALP } = row.data;
+        if (ID === undefined || NAME === undefined || CITY === undefined || STALP === undefined) {
+            throw new UsSourceParseError(FDIC_BANK_DIRECTORY_SOURCE_ID, 'A bank row arrived without its id, name, city, or state');
+        }
+        return { id: ID, name: NAME, city: CITY, stateAbbr: STALP };
+    });
+    const totalBanks = parsed.data.totals?.count ?? parsed.data.meta?.total ?? banks.length;
+    return {
+        banks,
+        bankCount: banks.length,
+        totalBanks,
+        states: countFdicBankStates(banks),
+    };
+}
+/**
+ * Reads one page of the FDIC's bank directory.
+ *
+ * One keyless request covers the page. The service trims each row to the
+ * columns asked for, so a story gets names, cities, and states without the
+ * full institution record.
+ *
+ * @param options - an optional row cap and fetch stub
+ * @returns the banks in the page, the FDIC total, and the state counts
+ */
+export async function fetchFdicBankDirectory(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildFdicBankDirectoryUrl(options?.rowLimit === undefined ? {} : { rowLimit: options.rowLimit });
+    const response = await httpGet(FDIC_BANK_DIRECTORY_SOURCE_ID, url, { fetchImpl });
+    return parseFdicBankDirectoryPayload(await response.json());
+}
+/** FDIC bank directory, one row per insured institution, keyless. */
+export const fdicBankDirectoryAdapter = {
+    id: FDIC_BANK_DIRECTORY_SOURCE_ID,
+    name: 'FDIC bank directory',
+    auth: 'none',
+    description: 'Insured banks in the FDIC institution directory, one row per bank, with the city and state of its main office.',
+    fetchLive: async (options) => fetchFdicBankDirectory(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseFdicBankDirectoryPayload(payload),
+    loadFixture: () => parseFdicBankDirectoryPayload(readFixtureJson(FDIC_BANK_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=fdicBankDirectory.js.map

package/dist/fdicBankDirectory.js.map

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

package/dist/femaDisasterDeclarations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"femaDisasterDeclarations.d.ts","sourceRoot":"","sources":["../src/femaDisasterDeclarations.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,qDAAqD;IACrD,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,uDAAuD;IACvD,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,qCAAqC,CAAC;AAE1E,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAqC9C;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQ/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CA2D/E;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,eAAe,EAAE,GAC9B,wBAAwB,CA+C1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAUpC;AAED,2CAA2C;AAC3C,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC,wBAAwB,CAanF,CAAC"}
+{"version":3,"file":"femaDisasterDeclarations.d.ts","sourceRoot":"","sources":["../src/femaDisasterDeclarations.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,cAAc,EAAE,MAAM,CAAC;IACvB,4EAA4E;IAC5E,eAAe,EAAE,MAAM,CAAC;IACxB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;IACb;;;OAGG;IACH,eAAe,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,YAAY,EAAE,MAAM,CAAC;IACrB,gEAAgE;IAChE,SAAS,EAAE,MAAM,CAAC;IAClB,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wEAAwE;AACxE,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,uEAAuE;AACvE,MAAM,WAAW,wBAAwB;IACvC,mDAAmD;IACnD,YAAY,EAAE,eAAe,EAAE,CAAC;IAChC,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,KAAK,EAAE,mBAAmB,EAAE,CAAC;IAC7B,WAAW,EAAE,mBAAmB,CAAC;IACjC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,aAAa,EAAE,oBAAoB,EAAE,CAAC;IACtC,qDAAqD;IACrD,gBAAgB,EAAE,oBAAoB,EAAE,CAAC;IACzC,uDAAuD;IACvD,SAAS,EAAE,oBAAoB,EAAE,CAAC;CACnC;AAED,qCAAqC;AACrC,eAAO,MAAM,uBAAuB,qCAAqC,CAAC;AAE1E,2DAA2D;AAC3D,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAEpE;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAEjD;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,SAAS,CAAC;AAqC9C;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAQ/E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,EAAE,CA2D/E;AAiBD;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAC3C,YAAY,EAAE,eAAe,EAAE,GAC9B,wBAAwB,CA+C1B;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,CAAC,EAAE;IACpD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAOpC;AAED,2CAA2C;AAC3C,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC,wBAAwB,CAanF,CAAC"}

package/dist/femaDisasterDeclarations.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 OpenFEMA API. */
 export const FEMA_OPEN_DATA_API_BASE = 'https://www.fema.gov/api/open/v1';
@@ -195,10 +196,7 @@ export function buildFemaDeclarationCatalogue(declarations) {
 export async function fetchFemaDeclarations(options) {
     const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
     const url = buildFemaDeclarationUrl(options?.rowLimit === undefined ? {} : { rowLimit: options.rowLimit });
-    const response = await fetchImpl(url);
-    if (!response.ok) {
-        throw new UsSourceApiError('fema', `HTTP ${response.status} reading the declaration file`);
-    }
+    const response = await httpGet('fema', url, { fetchImpl });
     return buildFemaDeclarationCatalogue(parseFemaDeclarationPayload(await response.json()));
 }
 /** FEMA disaster declarations, keyless. */

package/dist/femaDisasterDeclarations.js.map

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

package/dist/healthdataSocrataCatalogue.d.ts

@@ -0,0 +1,87 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the healthdata-socrata-catalogue source. */
+export declare const HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID = "healthdata-socrata-catalogue";
+/** One catalogue entry from the Socrata discovery API. */
+export interface HealthdataSocrataCatalogueEntry {
+    /** Four-by-four Socrata dataset id, e.g. "ahfs-x44r". */
+    id: string;
+    /** Human-readable title of the dataset, chart, story, or file. */
+    name: string;
+    /** What the entry is: "dataset", "chart", "story", "file", or "href". */
+    assetType: string;
+    /** Publishing office the entry belongs to, or null when the catalogue lists none. */
+    category: string | null;
+    /** How the entry is rendered, e.g. "tabular", "href", or "story". */
+    viewType: string;
+    /** When the entry was created, in seconds since the Unix epoch. */
+    createdAtEpochSeconds: number;
+    /** When the entry was last modified, in seconds since the Unix epoch. */
+    viewLastModifiedEpochSeconds: number;
+    /** How many times the entry has been viewed. */
+    viewCount: number;
+    /** How many times the entry has been downloaded. */
+    downloadCount: number;
+}
+/** One category and how many catalogue entries carry it. */
+export interface HealthdataSocrataCategoryCount {
+    category: string;
+    entryCount: number;
+}
+/** One page of the catalogue, folded for a story. */
+export interface HealthdataSocrataCatalogue {
+    /** One entry per catalogue item in the page. */
+    entries: HealthdataSocrataCatalogueEntry[];
+    entryCount: number;
+    /** Entries whose asset type is "dataset". */
+    datasetCount: number;
+    /** Entry with the latest creation time. Ties go to the earlier list entry. */
+    newestEntry: HealthdataSocrataCatalogueEntry;
+    /**
+     * Categories in the page, most entries first, ties broken by name. An entry
+     * the catalogue lists without a category is counted under "Uncategorised".
+     */
+    categories: HealthdataSocrataCategoryCount[];
+}
+/** Base URL for the HealthData.gov Socrata catalogue. */
+export declare const HEALTHDATA_SOCRATA_CATALOGUE_API_BASE = "https://healthdata.gov/api/views.json";
+/** How many catalogue entries one request reads. */
+export declare const HEALTHDATA_SOCRATA_CATALOGUE_LIMIT = 10;
+/**
+ * Builds the request URL for one page of the catalogue.
+ *
+ * The endpoint is keyless. The service answers the whole catalogue by default,
+ * so the adapter asks for a short page.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export declare function buildHealthdataSocrataCatalogueUrl(options?: {
+    limit?: number;
+}): string;
+/**
+ * Parses one page of the catalogue into the entries and the category counts.
+ *
+ * An entry without an id, a name, or a creation time is a changed shape and
+ * stops the parse. An empty page also stops the parse, because a catalogue
+ * with no entries is not a usable answer.
+ *
+ * @param payload - the JSON body from the Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function parseHealthdataSocrataCataloguePayload(payload: unknown): HealthdataSocrataCatalogue;
+/**
+ * Reads one page of the HealthData.gov catalogue.
+ *
+ * One keyless request covers the page and reports what the catalogue holds,
+ * without reading any dataset's rows.
+ *
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function fetchHealthdataSocrataCatalogue(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<HealthdataSocrataCatalogue>;
+/** HealthData.gov Socrata catalogue of datasets, charts, and stories, keyless. */
+export declare const healthdataSocrataCatalogueAdapter: UsDataAdapter<HealthdataSocrataCatalogue>;
+//# sourceMappingURL=healthdataSocrataCatalogue.d.ts.map

package/dist/healthdataSocrataCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"healthdataSocrataCatalogue.d.ts","sourceRoot":"","sources":["../src/healthdataSocrataCatalogue.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,8DAA8D;AAC9D,eAAO,MAAM,sCAAsC,iCAAiC,CAAC;AAErF,0DAA0D;AAC1D,MAAM,WAAW,+BAA+B;IAC9C,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,qFAAqF;IACrF,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qEAAqE;IACrE,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,qBAAqB,EAAE,MAAM,CAAC;IAC9B,yEAAyE;IACzE,4BAA4B,EAAE,MAAM,CAAC;IACrC,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,oDAAoD;IACpD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,4DAA4D;AAC5D,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,0BAA0B;IACzC,gDAAgD;IAChD,OAAO,EAAE,+BAA+B,EAAE,CAAC;IAC3C,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,+BAA+B,CAAC;IAC7C;;;OAGG;IACH,UAAU,EAAE,8BAA8B,EAAE,CAAC;CAC9C;AAED,yDAAyD;AACzD,eAAO,MAAM,qCAAqC,0CAA0C,CAAC;AAE7F,oDAAoD;AACpD,eAAO,MAAM,kCAAkC,KAAK,CAAC;AAyDrD;;;;;;;;GAQG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKvF;AAED;;;;;;;;;GASG;AACH,wBAAgB,sCAAsC,CACpD,OAAO,EAAE,OAAO,GACf,0BAA0B,CAuC5B;AAED;;;;;;;;GAQG;AACH,wBAAsB,+BAA+B,CAAC,OAAO,CAAC,EAAE;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAOtC;AAED,kFAAkF;AAClF,eAAO,MAAM,iCAAiC,EAAE,aAAa,CAAC,0BAA0B,CAevF,CAAC"}

package/dist/healthdataSocrataCatalogue.js

@@ -0,0 +1,130 @@
+import { z } from 'zod';
+import { UsSourceParseError } from './errors.js';
+import { httpGet } from './http.js';
+import { readFixtureJson } from './fixtures.js';
+/** Adapter id for the healthdata-socrata-catalogue source. */
+export const HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID = 'healthdata-socrata-catalogue';
+/** Base URL for the HealthData.gov Socrata catalogue. */
+export const HEALTHDATA_SOCRATA_CATALOGUE_API_BASE = 'https://healthdata.gov/api/views.json';
+/** How many catalogue entries one request reads. */
+export const HEALTHDATA_SOCRATA_CATALOGUE_LIMIT = 10;
+/** Committed snapshot, so a build works when the HealthData.gov host is unreachable. */
+const HEALTHDATA_SOCRATA_CATALOGUE_FIXTURE_FILENAME = 'healthdata-socrata-catalogue-2026-10-05.json';
+/** Category bucket the adapter uses for an entry the catalogue lists without one. */
+const HEALTHDATA_SOCRATA_UNCATEGORISED = 'Uncategorised';
+// The discovery API sends a bare JSON array. A value the catalogue does not
+// carry arrives as null, and every count arrives as a number.
+const HEALTHDATA_SOCRATA_CATALOGUE_ENTRY_SCHEMA = z.object({
+    id: z.string().optional(),
+    name: z.string().optional(),
+    assetType: z.string().optional(),
+    category: z.string().nullable().optional(),
+    viewType: z.string().optional(),
+    createdAt: z.number().optional(),
+    viewLastModified: z.number().optional(),
+    viewCount: z.number().optional(),
+    downloadCount: z.number().optional(),
+});
+const HEALTHDATA_SOCRATA_CATALOGUE_PAYLOAD_SCHEMA = z.array(HEALTHDATA_SOCRATA_CATALOGUE_ENTRY_SCHEMA);
+/** Counts entries per category, most entries first, ties by name. */
+function countHealthdataSocrataCategories(entries) {
+    const counts = new Map();
+    for (const entry of entries) {
+        const category = entry.category ?? HEALTHDATA_SOCRATA_UNCATEGORISED;
+        counts.set(category, (counts.get(category) ?? 0) + 1);
+    }
+    return [...counts.entries()]
+        .sort(([leftCategory, leftCount], [rightCategory, rightCount]) => leftCount === rightCount ? leftCategory.localeCompare(rightCategory) : rightCount - leftCount)
+        .map(([category, entryCount]) => ({ category, entryCount }));
+}
+/** Picks the entry with the latest creation time, ties to the earlier entry. */
+function newestHealthdataSocrataEntry(entries) {
+    const first = entries[0];
+    if (first === undefined) {
+        throw new UsSourceParseError(HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID, 'No entries to summarise');
+    }
+    return entries.reduce((best, entry) => (entry.createdAtEpochSeconds > best.createdAtEpochSeconds ? entry : best), first);
+}
+/**
+ * Builds the request URL for one page of the catalogue.
+ *
+ * The endpoint is keyless. The service answers the whole catalogue by default,
+ * so the adapter asks for a short page.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export function buildHealthdataSocrataCatalogueUrl(options) {
+    const params = new URLSearchParams({
+        limit: String(options?.limit ?? HEALTHDATA_SOCRATA_CATALOGUE_LIMIT),
+    });
+    return `https://healthdata.gov/api/views.json?${params.toString()}`;
+}
+/**
+ * Parses one page of the catalogue into the entries and the category counts.
+ *
+ * An entry without an id, a name, or a creation time is a changed shape and
+ * stops the parse. An empty page also stops the parse, because a catalogue
+ * with no entries is not a usable answer.
+ *
+ * @param payload - the JSON body from the Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseHealthdataSocrataCataloguePayload(payload) {
+    const parsed = HEALTHDATA_SOCRATA_CATALOGUE_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.length === 0) {
+        throw new UsSourceParseError(HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID, 'The response carried no entries');
+    }
+    const entries = parsed.data.map((row) => {
+        if (row.id === undefined || row.name === undefined || row.createdAt === undefined) {
+            throw new UsSourceParseError(HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID, 'A catalogue entry arrived without its id, name, or creation time');
+        }
+        return {
+            id: row.id,
+            name: row.name,
+            assetType: row.assetType ?? '',
+            category: row.category ?? null,
+            viewType: row.viewType ?? '',
+            createdAtEpochSeconds: row.createdAt,
+            viewLastModifiedEpochSeconds: row.viewLastModified ?? row.createdAt,
+            viewCount: row.viewCount ?? 0,
+            downloadCount: row.downloadCount ?? 0,
+        };
+    });
+    return {
+        entries,
+        entryCount: entries.length,
+        datasetCount: entries.filter((entry) => entry.assetType === 'dataset').length,
+        newestEntry: newestHealthdataSocrataEntry(entries),
+        categories: countHealthdataSocrataCategories(entries),
+    };
+}
+/**
+ * Reads one page of the HealthData.gov catalogue.
+ *
+ * One keyless request covers the page and reports what the catalogue holds,
+ * without reading any dataset's rows.
+ *
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export async function fetchHealthdataSocrataCatalogue(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildHealthdataSocrataCatalogueUrl(options?.limit === undefined ? {} : { limit: options.limit });
+    const response = await httpGet(HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID, url, { fetchImpl });
+    return parseHealthdataSocrataCataloguePayload(await response.json());
+}
+/** HealthData.gov Socrata catalogue of datasets, charts, and stories, keyless. */
+export const healthdataSocrataCatalogueAdapter = {
+    id: HEALTHDATA_SOCRATA_CATALOGUE_SOURCE_ID,
+    name: 'HealthData.gov catalogue',
+    auth: 'none',
+    description: 'The HealthData.gov Socrata catalogue, one row per published dataset, chart, or story, with its category, view count, and download count.',
+    fetchLive: async (options) => fetchHealthdataSocrataCatalogue(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseHealthdataSocrataCataloguePayload(payload),
+    loadFixture: () => parseHealthdataSocrataCataloguePayload(readFixtureJson(HEALTHDATA_SOCRATA_CATALOGUE_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=healthdataSocrataCatalogue.js.map

package/dist/healthdataSocrataCatalogue.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Identifies this client to the public APIs it calls.
+ *
+ * Several US government endpoints ask callers to identify themselves, and the
+ * National Weather Service and SEC reject anonymous callers outright, so every
+ * adapter sends this. The string carries no version, so it cannot go stale
+ * between releases. Where a source asks for more detail (the SEC wants a
+ * contact address, for example) the adapter adds its own header on top.
+ */
+export declare const USER_AGENT = "usa-open-data-connectors (Language=TypeScript)";
+/** Per-request timeout in milliseconds, applied to every adapter. */
+export declare const DEFAULT_TIMEOUT_MS = 30000;
+/** Options shared by the shared HTTP helpers. */
+export interface HttpGetOptions {
+    /** Fetch implementation override, used by tests. */
+    fetchImpl?: typeof globalThis.fetch | undefined;
+    /** Extra request headers, merged over the defaults. */
+    headers?: Record<string, string> | undefined;
+    /** Overrides {@link DEFAULT_TIMEOUT_MS}. */
+    timeoutMs?: 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
+ * a request that hangs, and a failure carries whether retrying is worthwhile.
+ *
+ * @param source - Source name used in the error message, e.g. "bls".
+ * @param url - Absolute URL or URL object to fetch.
+ * @param options - Fetch override, extra headers, and timeout.
+ * @returns The response, already checked for a successful status.
+ * @throws {UsSourceApiError} On a non-2xx status, an abort, or a network error.
+ */
+export declare function httpGet(source: string, url: string | URL, options?: HttpGetOptions): Promise<Response>;
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +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"}

package/dist/http.js

@@ -0,0 +1,85 @@
+import { UsSourceApiError } from './errors.js';
+/**
+ * Identifies this client to the public APIs it calls.
+ *
+ * Several US government endpoints ask callers to identify themselves, and the
+ * National Weather Service and SEC reject anonymous callers outright, so every
+ * adapter sends this. The string carries no version, so it cannot go stale
+ * between releases. Where a source asks for more detail (the SEC wants a
+ * contact address, for example) the adapter adds its own header on top.
+ */
+export const USER_AGENT = 'usa-open-data-connectors (Language=TypeScript)';
+/** Per-request timeout in milliseconds, applied to every adapter. */
+export const DEFAULT_TIMEOUT_MS = 30_000;
+/** The one status code worth retrying: the server is asking us to slow down. */
+const HTTP_TOO_MANY_REQUESTS = 429;
+/** The lowest status code that means the server failed rather than the request. */
+const HTTP_INTERNAL_SERVER_ERROR = 500;
+/**
+ * Builds the request headers, letting a caller replace the User-Agent.
+ *
+ * Most adapters send only the default identity. A few sources (the SEC and
+ * the National Weather Service, for example) ask for a more descriptive
+ * User-Agent of their own, and that one wins. Other headers merge over the
+ * defaults.
+ *
+ * @param extra - Headers supplied by the adapter.
+ * @returns The headers for one request.
+ */
+function buildRequestHeaders(extra) {
+    const headers = { 'user-agent': USER_AGENT };
+    for (const [name, value] of Object.entries(extra ?? {})) {
+        if (name.toLowerCase() === 'user-agent') {
+            headers['user-agent'] = value;
+        }
+        else {
+            headers[name] = value;
+        }
+    }
+    return headers;
+}
+/**
+ * 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
+ * a request that hangs, and a failure carries whether retrying is worthwhile.
+ *
+ * @param source - Source name used in the error message, e.g. "bls".
+ * @param url - Absolute URL or URL object to fetch.
+ * @param options - Fetch override, extra headers, and timeout.
+ * @returns The response, already checked for a successful status.
+ * @throws {UsSourceApiError} On a non-2xx status, an abort, or a network error.
+ */
+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,
+            });
+        }
+        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,
+        });
+    }
+    return response;
+}
+//# sourceMappingURL=http.js.map