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

package/dist/socrataCatalogue.js

@@ -0,0 +1,151 @@
+import { z } from 'zod';
+import { UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+import { httpGet } from './http.js';
+import { parseSocrataCatalogueMetadata } from './socrataCatalogueMetadata.js';
+/** Default number of catalogue entries one request reads. */
+export const SOCRATA_CATALOGUE_LIMIT = 10;
+/** Category bucket used when a catalogue entry carries no category. */
+export const 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 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(),
+    metadata: z.unknown().optional(),
+});
+const SOCRATA_CATALOGUE_PAYLOAD_SCHEMA = z.array(SOCRATA_CATALOGUE_ENTRY_SCHEMA);
+/** Counts entries per category, most entries first, ties by name. */
+function countSocrataCategories(entries, uncategorisedLabel) {
+    const counts = new Map();
+    for (const entry of entries) {
+        const category = entry.category ?? uncategorisedLabel;
+        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 newestSocrataEntry(sourceId, entries) {
+    const first = entries[0];
+    if (first === undefined) {
+        throw new UsSourceParseError(sourceId, 'No entries to summarise');
+    }
+    return entries.reduce((best, entry) => (entry.createdAtEpochSeconds > best.createdAtEpochSeconds ? entry : best), first);
+}
+/**
+ * Builds the request URL for one page of a Socrata catalogue.
+ *
+ * The endpoint is keyless. The service answers the whole catalogue by default,
+ * so the adapter asks for a short page unless the caller sets a cap.
+ *
+ * @param apiBase - the Socrata discovery API URL, without query parameters
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export function buildSocrataCatalogueUrl(apiBase, options) {
+    const params = new URLSearchParams({
+        limit: String(options?.limit ?? SOCRATA_CATALOGUE_LIMIT),
+    });
+    return `${apiBase}?${params.toString()}`;
+}
+/**
+ * Parses one page of a Socrata catalogue into entries and topic 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 sourceId - adapter id used in parse errors
+ * @param payload - the JSON body from the Socrata discovery API
+ * @param options - an optional category label for entries without one
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseSocrataCataloguePayload(sourceId, payload, options) {
+    const parsed = SOCRATA_CATALOGUE_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(sourceId, parsed.error.message);
+    }
+    if (parsed.data.length === 0) {
+        throw new UsSourceParseError(sourceId, 'The response carried no entries');
+    }
+    const entries = parsed.data.map((row) => {
+        if (row.id === undefined || row.name === undefined || row.createdAt === undefined) {
+            throw new UsSourceParseError(sourceId, '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,
+            ...parseSocrataCatalogueMetadata(row.metadata),
+        };
+    });
+    return {
+        entries,
+        entryCount: entries.length,
+        datasetCount: entries.filter((entry) => entry.assetType === 'dataset').length,
+        newestEntry: newestSocrataEntry(sourceId, entries),
+        categories: countSocrataCategories(entries, options?.uncategorisedLabel ?? SOCRATA_UNCATEGORISED),
+    };
+}
+/**
+ * Reads one page of a Socrata catalogue.
+ *
+ * One keyless request covers the page and reports what the portal holds,
+ * without reading any dataset's rows.
+ *
+ * @param source - source id, API base, and optional defaults
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export async function fetchSocrataCatalogue(source, options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const limit = options?.limit ?? source.limit;
+    const url = buildSocrataCatalogueUrl(source.apiBase, limit === undefined ? {} : { limit });
+    const response = await httpGet(source.sourceId, url, { fetchImpl });
+    return parseSocrataCataloguePayload(source.sourceId, await response.json(), source.uncategorisedLabel === undefined ? {} : { uncategorisedLabel: source.uncategorisedLabel });
+}
+/**
+ * Creates an adapter around one Socrata catalogue endpoint.
+ *
+ * @param config - source id, endpoint, fixture, and the text the API shows
+ * @returns an adapter that fetches, parses, and loads the committed snapshot
+ */
+export function createSocrataCatalogueAdapter(config) {
+    const source = {
+        sourceId: config.sourceId,
+        apiBase: config.apiBase,
+        ...(config.limit === undefined ? {} : { limit: config.limit }),
+        ...(config.uncategorisedLabel === undefined
+            ? {}
+            : { uncategorisedLabel: config.uncategorisedLabel }),
+    };
+    return {
+        id: config.sourceId,
+        name: config.name,
+        auth: 'none',
+        description: config.description,
+        fetchLive: async (options) => fetchSocrataCatalogue(source, options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+        parse: (payload) => parseSocrataCataloguePayload(source.sourceId, payload, source.uncategorisedLabel === undefined
+            ? {}
+            : { uncategorisedLabel: source.uncategorisedLabel }),
+        loadFixture: () => parseSocrataCataloguePayload(source.sourceId, readFixtureJson(config.fixtureFilename), source.uncategorisedLabel === undefined
+            ? {}
+            : { uncategorisedLabel: source.uncategorisedLabel }),
+    };
+}
+//# sourceMappingURL=socrataCatalogue.js.map

package/dist/socrataCatalogue.js.map

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

package/dist/socrataCatalogueMetadata.d.ts

@@ -0,0 +1,19 @@
+/** Source-supplied licence and attribution metadata for one Socrata entry. */
+export interface SocrataCatalogueMetadata {
+    /** Licence URL the portal attaches to the entry, or "" when it supplies none. */
+    licenceUrl: string;
+    /** Publishing organisation the portal attaches to the entry, or "" when it supplies none. */
+    attribution: string;
+}
+/**
+ * Reads the licence and attribution values Socrata attaches to a catalogue entry.
+ *
+ * Portals use "Common Core" for older entries and "Common Core 3" for newer
+ * ones. A missing or malformed block returns empty strings, because the portal
+ * did not supply the value rather than the adapter knowing better.
+ *
+ * @param metadata - the entry's Socrata metadata block
+ * @returns the source-supplied licence URL and publisher
+ */
+export declare function parseSocrataCatalogueMetadata(metadata: unknown): SocrataCatalogueMetadata;
+//# sourceMappingURL=socrataCatalogueMetadata.d.ts.map

package/dist/socrataCatalogueMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"socrataCatalogueMetadata.d.ts","sourceRoot":"","sources":["../src/socrataCatalogueMetadata.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACvC,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;CACrB;AAqBD;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,OAAO,GAAG,wBAAwB,CAUzF"}

package/dist/socrataCatalogueMetadata.js

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+const SOCRATA_CATALOGUE_METADATA_SCHEMA = z
+    .object({
+    custom_fields: z.record(z.string(), z.record(z.string(), z.unknown())).nullable().optional(),
+})
+    .nullable()
+    .optional();
+/**
+ * Reads one string field from the portal's Common Core metadata groups.
+ *
+ * @param groups - the portal's custom field groups
+ * @param key - the source field name, such as License or Publisher
+ * @returns the trimmed value, or "" when the source did not supply a string
+ */
+function readCommonCoreText(groups, key) {
+    const value = groups['Common Core']?.[key] ?? groups['Common Core 3']?.[key];
+    return typeof value === 'string' ? value.trim() : '';
+}
+/**
+ * Reads the licence and attribution values Socrata attaches to a catalogue entry.
+ *
+ * Portals use "Common Core" for older entries and "Common Core 3" for newer
+ * ones. A missing or malformed block returns empty strings, because the portal
+ * did not supply the value rather than the adapter knowing better.
+ *
+ * @param metadata - the entry's Socrata metadata block
+ * @returns the source-supplied licence URL and publisher
+ */
+export function parseSocrataCatalogueMetadata(metadata) {
+    const parsed = SOCRATA_CATALOGUE_METADATA_SCHEMA.safeParse(metadata);
+    if (!parsed.success || parsed.data?.custom_fields == null) {
+        return { licenceUrl: '', attribution: '' };
+    }
+    const groups = parsed.data.custom_fields;
+    return {
+        licenceUrl: readCommonCoreText(groups, 'License'),
+        attribution: readCommonCoreText(groups, 'Publisher'),
+    };
+}
+//# sourceMappingURL=socrataCatalogueMetadata.js.map

package/dist/socrataCatalogueMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socrataCatalogueMetadata.js","sourceRoot":"","sources":["../src/socrataCatalogueMetadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB,MAAM,iCAAiC,GAAG,CAAC;KACxC,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAC7F,CAAC;KACD,QAAQ,EAAE;KACV,QAAQ,EAAE,CAAC;AAEd;;;;;;GAMG;AACH,SAAS,kBAAkB,CAAC,MAA+C,EAAE,GAAW;IACtF,MAAM,KAAK,GAAG,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;IAC7E,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AACvD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAAC,QAAiB;IAC7D,MAAM,MAAM,GAAG,iCAAiC,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC;QAC1D,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IAC7C,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC;IACzC,OAAO;QACL,UAAU,EAAE,kBAAkB,CAAC,MAAM,EAAE,SAAS,CAAC;QACjD,WAAW,EAAE,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC;KACrD,CAAC;AACJ,CAAC"}

package/dist/texasOpenDataCatalogue.d.ts

@@ -0,0 +1,91 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the Texas Open Data catalogue source. */
+export declare const TEXAS_OPEN_DATA_CATALOGUE_SOURCE_ID = "texas-open-data-catalogue";
+/** Base URL for the Texas Open Data Socrata catalogue. */
+export declare const TEXAS_OPEN_DATA_API_BASE = "https://data.texas.gov/api/views.json";
+/** How many catalogue entries one request reads. */
+export declare const TEXAS_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** One catalogue entry from the Texas Socrata discovery API. */
+export interface TexasOpenDataCatalogueEntry {
+    /** Four-by-four Socrata dataset id, e.g. "nqfs-mwbh". */
+    id: string;
+    /** Human-readable title of the dataset, chart, story, map, or file. */
+    name: string;
+    /** What the entry is: "dataset", "href", "map", or "measure". */
+    assetType: string;
+    /** State topic the entry belongs to, or null when the catalogue lists none. */
+    category: string | null;
+    /** How the entry is rendered, e.g. "tabular" or "href". */
+    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;
+    /** Licence text or URL the portal attaches, or "" when it supplies none. */
+    licenceUrl: string;
+    /** Publishing organisation the portal attaches, or "" when it supplies none. */
+    attribution: string;
+}
+/** One state topic and how many catalogue entries carry it. */
+export interface TexasOpenDataCategoryCount {
+    category: string;
+    entryCount: number;
+}
+/** One page of the Texas catalogue, folded for a story. */
+export interface TexasOpenDataCatalogue {
+    /** One entry per catalogue item in the page. */
+    entries: TexasOpenDataCatalogueEntry[];
+    entryCount: number;
+    /** Entries whose asset type is "dataset". */
+    datasetCount: number;
+    /** Entry with the latest creation time. Ties go to the earlier list entry. */
+    newestEntry: TexasOpenDataCatalogueEntry;
+    /**
+     * Categories in the page, most entries first, ties broken by name. An entry
+     * the catalogue lists without a category is counted under "Uncategorised".
+     */
+    categories: TexasOpenDataCategoryCount[];
+}
+/**
+ * Builds the request URL for one page of the Texas 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 buildTexasOpenDataCatalogueUrl(options?: {
+    limit?: number;
+}): string;
+/**
+ * Parses one page of the Texas catalogue into the entries and topic 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 Texas Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function parseTexasOpenDataCataloguePayload(payload: unknown): TexasOpenDataCatalogue;
+/**
+ * Reads one page of the Texas Open Data catalogue.
+ *
+ * One keyless request covers the page and reports what the state portal 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 fetchTexasOpenDataCatalogue(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<TexasOpenDataCatalogue>;
+/** Texas Open Data catalogue of datasets, maps, charts, and linked resources, keyless. */
+export declare const texasOpenDataCatalogueAdapter: UsDataAdapter<TexasOpenDataCatalogue>;
+//# sourceMappingURL=texasOpenDataCatalogue.d.ts.map

package/dist/texasOpenDataCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texasOpenDataCatalogue.d.ts","sourceRoot":"","sources":["../src/texasOpenDataCatalogue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,2DAA2D;AAC3D,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,0CAA0C,CAAC;AAEhF,oDAAoD;AACpD,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,gEAAgE;AAChE,MAAM,WAAW,2BAA2B;IAC1C,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,SAAS,EAAE,MAAM,CAAC;IAClB,+EAA+E;IAC/E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,2DAA2D;IAC3D,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;IACtB,4EAA4E;IAC5E,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,+DAA+D;AAC/D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,2DAA2D;AAC3D,MAAM,WAAW,sBAAsB;IACrC,gDAAgD;IAChD,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,2BAA2B,CAAC;IACzC;;;OAGG;IACH,UAAU,EAAE,0BAA0B,EAAE,CAAC;CAC1C;AAuDD;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKnF;AAED;;;;;;;;;GASG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CAwC3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IAC1D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAOlC;AAED,0FAA0F;AAC1F,eAAO,MAAM,6BAA6B,EAAE,aAAa,CAAC,sBAAsB,CAa/E,CAAC"}

package/dist/texasOpenDataCatalogue.js

@@ -0,0 +1,133 @@
+import { z } from 'zod';
+import { UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+import { httpGet } from './http.js';
+import { parseSocrataCatalogueMetadata } from './socrataCatalogueMetadata.js';
+/** Adapter id for the Texas Open Data catalogue source. */
+export const TEXAS_OPEN_DATA_CATALOGUE_SOURCE_ID = 'texas-open-data-catalogue';
+/** Base URL for the Texas Open Data Socrata catalogue. */
+export const TEXAS_OPEN_DATA_API_BASE = 'https://data.texas.gov/api/views.json';
+/** How many catalogue entries one request reads. */
+export const TEXAS_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** Committed snapshot, so a build works when the Texas host is unreachable. */
+const TEXAS_OPEN_DATA_FIXTURE_FILENAME = 'texas-open-data-catalogue-2026-11-08.json';
+/** Category bucket the adapter uses for an entry the catalogue lists without one. */
+const TEXAS_OPEN_DATA_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 TEXAS_OPEN_DATA_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(),
+    metadata: z.unknown().optional(),
+});
+const TEXAS_OPEN_DATA_PAYLOAD_SCHEMA = z.array(TEXAS_OPEN_DATA_ENTRY_SCHEMA);
+/** Counts entries per category, most entries first, ties by name. */
+function countTexasOpenDataCategories(entries) {
+    const counts = new Map();
+    for (const entry of entries) {
+        const category = entry.category ?? TEXAS_OPEN_DATA_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 newestTexasOpenDataEntry(entries) {
+    const first = entries[0];
+    if (first === undefined) {
+        throw new UsSourceParseError(TEXAS_OPEN_DATA_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 Texas 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 buildTexasOpenDataCatalogueUrl(options) {
+    const params = new URLSearchParams({
+        limit: String(options?.limit ?? TEXAS_OPEN_DATA_CATALOGUE_LIMIT),
+    });
+    return `${TEXAS_OPEN_DATA_API_BASE}?${params.toString()}`;
+}
+/**
+ * Parses one page of the Texas catalogue into the entries and topic 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 Texas Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseTexasOpenDataCataloguePayload(payload) {
+    const parsed = TEXAS_OPEN_DATA_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(TEXAS_OPEN_DATA_CATALOGUE_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.length === 0) {
+        throw new UsSourceParseError(TEXAS_OPEN_DATA_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(TEXAS_OPEN_DATA_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,
+            ...parseSocrataCatalogueMetadata(row.metadata),
+        };
+    });
+    return {
+        entries,
+        entryCount: entries.length,
+        datasetCount: entries.filter((entry) => entry.assetType === 'dataset').length,
+        newestEntry: newestTexasOpenDataEntry(entries),
+        categories: countTexasOpenDataCategories(entries),
+    };
+}
+/**
+ * Reads one page of the Texas Open Data catalogue.
+ *
+ * One keyless request covers the page and reports what the state portal 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 fetchTexasOpenDataCatalogue(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildTexasOpenDataCatalogueUrl(options?.limit === undefined ? {} : { limit: options.limit });
+    const response = await httpGet(TEXAS_OPEN_DATA_CATALOGUE_SOURCE_ID, url, { fetchImpl });
+    return parseTexasOpenDataCataloguePayload(await response.json());
+}
+/** Texas Open Data catalogue of datasets, maps, charts, and linked resources, keyless. */
+export const texasOpenDataCatalogueAdapter = {
+    id: TEXAS_OPEN_DATA_CATALOGUE_SOURCE_ID,
+    name: 'Texas Open Data catalogue',
+    auth: 'none',
+    description: 'The Texas Open Data Socrata catalogue, one row per published dataset, map, chart, or linked resource, with its state topic, view count, and download count.',
+    fetchLive: async (options) => fetchTexasOpenDataCatalogue(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseTexasOpenDataCataloguePayload(payload),
+    loadFixture: () => parseTexasOpenDataCataloguePayload(readFixtureJson(TEXAS_OPEN_DATA_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=texasOpenDataCatalogue.js.map

package/dist/texasOpenDataCatalogue.js.map

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

package/dist/types.d.ts

@@ -7,7 +7,8 @@ export interface UsFetchOptions {
 }
 /**
  * One US data source behind a uniform interface: a live fetch, a strict
- * parse, and a committed fixture fallback so builds work offline.
+ * parse, and a committed fixture for tests. A live fetch never falls back
+ * to the fixture.
  */
 export interface UsDataAdapter<T> {
     readonly id: string;

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1C,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC;IAC3B,WAAW,IAAI,CAAC,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,CAAC;AAE1C,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,SAAS,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,CAAC,CAAC;IAC3B,WAAW,IAAI,CAAC,CAAC;CAClB;AAED,8DAA8D;AAC9D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,YAAY,CAAC;IACnB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/vermontOpenDataCatalogue.d.ts

@@ -0,0 +1,42 @@
+import { type SocrataCatalogue, type SocrataCatalogueCategoryCount, type SocrataCatalogueEntry } from './socrataCatalogue.js';
+/** Adapter id for the Vermont Open Data catalogue source. */
+export declare const VERMONT_OPEN_DATA_CATALOGUE_SOURCE_ID = "vermont-open-data-catalogue";
+/** Base URL for the Vermont Open Data Socrata catalogue. */
+export declare const VERMONT_OPEN_DATA_API_BASE = "https://data.vermont.gov/api/views.json";
+/** How many catalogue entries one request reads. */
+export declare const VERMONT_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** One catalogue entry from the Vermont Socrata discovery API. */
+export type VermontOpenDataCatalogueEntry = SocrataCatalogueEntry;
+/** One state topic and how many catalogue entries carry it. */
+export type VermontOpenDataCategoryCount = SocrataCatalogueCategoryCount;
+/** One page of the Vermont catalogue, folded for a story. */
+export type VermontOpenDataCatalogue = SocrataCatalogue;
+/**
+ * Builds the request URL for one page of the Vermont catalogue.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export declare function buildVermontOpenDataCatalogueUrl(options?: {
+    limit?: number;
+}): string;
+/**
+ * Parses one page of the Vermont catalogue into entries and topic counts.
+ *
+ * @param payload - the JSON body from the Vermont Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function parseVermontOpenDataCataloguePayload(payload: unknown): VermontOpenDataCatalogue;
+/**
+ * Reads one page of the Vermont Open Data catalogue.
+ *
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function fetchVermontOpenDataCatalogue(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<VermontOpenDataCatalogue>;
+/** Vermont Open Data catalogue of datasets and filtered views, keyless. */
+export declare const vermontOpenDataCatalogueAdapter: import("./types.js").UsDataAdapter<SocrataCatalogue>;
+//# sourceMappingURL=vermontOpenDataCatalogue.d.ts.map

package/dist/vermontOpenDataCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vermontOpenDataCatalogue.d.ts","sourceRoot":"","sources":["../src/vermontOpenDataCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,6DAA6D;AAC7D,eAAO,MAAM,qCAAqC,gCAAgC,CAAC;AAEnF,4DAA4D;AAC5D,eAAO,MAAM,0BAA0B,4CAA4C,CAAC;AAEpF,oDAAoD;AACpD,eAAO,MAAM,iCAAiC,KAA0B,CAAC;AAEzE,kEAAkE;AAClE,MAAM,MAAM,6BAA6B,GAAG,qBAAqB,CAAC;AAElE,+DAA+D;AAC/D,MAAM,MAAM,4BAA4B,GAAG,6BAA6B,CAAC;AAEzE,6DAA6D;AAC7D,MAAM,MAAM,wBAAwB,GAAG,gBAAgB,CAAC;AAKxD;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAErF;AAED;;;;;GAKG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,OAAO,GAAG,wBAAwB,CAE/F;AAED;;;;;GAKG;AACH,wBAAsB,6BAA6B,CAAC,OAAO,CAAC,EAAE;IAC5D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CAKpC;AAED,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,sDAO1C,CAAC"}

package/dist/vermontOpenDataCatalogue.js

@@ -0,0 +1,45 @@
+import { buildSocrataCatalogueUrl, createSocrataCatalogueAdapter, fetchSocrataCatalogue, parseSocrataCataloguePayload, SOCRATA_CATALOGUE_LIMIT, } from './socrataCatalogue.js';
+/** Adapter id for the Vermont Open Data catalogue source. */
+export const VERMONT_OPEN_DATA_CATALOGUE_SOURCE_ID = 'vermont-open-data-catalogue';
+/** Base URL for the Vermont Open Data Socrata catalogue. */
+export const VERMONT_OPEN_DATA_API_BASE = 'https://data.vermont.gov/api/views.json';
+/** How many catalogue entries one request reads. */
+export const VERMONT_OPEN_DATA_CATALOGUE_LIMIT = SOCRATA_CATALOGUE_LIMIT;
+/** Committed snapshot, so a build works when the Vermont host is unreachable. */
+const VERMONT_OPEN_DATA_FIXTURE_FILENAME = 'vermont-open-data-catalogue-2026-11-08.json';
+/**
+ * Builds the request URL for one page of the Vermont catalogue.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export function buildVermontOpenDataCatalogueUrl(options) {
+    return buildSocrataCatalogueUrl(VERMONT_OPEN_DATA_API_BASE, options);
+}
+/**
+ * Parses one page of the Vermont catalogue into entries and topic counts.
+ *
+ * @param payload - the JSON body from the Vermont Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseVermontOpenDataCataloguePayload(payload) {
+    return parseSocrataCataloguePayload(VERMONT_OPEN_DATA_CATALOGUE_SOURCE_ID, payload);
+}
+/**
+ * Reads one page of the Vermont Open Data catalogue.
+ *
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export async function fetchVermontOpenDataCatalogue(options) {
+    return fetchSocrataCatalogue({ sourceId: VERMONT_OPEN_DATA_CATALOGUE_SOURCE_ID, apiBase: VERMONT_OPEN_DATA_API_BASE }, options);
+}
+/** Vermont Open Data catalogue of datasets and filtered views, keyless. */
+export const vermontOpenDataCatalogueAdapter = createSocrataCatalogueAdapter({
+    sourceId: VERMONT_OPEN_DATA_CATALOGUE_SOURCE_ID,
+    name: 'Vermont Open Data catalogue',
+    description: 'The Vermont Open Data Socrata catalogue, one row per published dataset or filtered view, with its state topic, view count, and download count.',
+    apiBase: VERMONT_OPEN_DATA_API_BASE,
+    fixtureFilename: VERMONT_OPEN_DATA_FIXTURE_FILENAME,
+});
+//# sourceMappingURL=vermontOpenDataCatalogue.js.map

package/dist/vermontOpenDataCatalogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vermontOpenDataCatalogue.js","sourceRoot":"","sources":["../src/vermontOpenDataCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GAIxB,MAAM,uBAAuB,CAAC;AAE/B,6DAA6D;AAC7D,MAAM,CAAC,MAAM,qCAAqC,GAAG,6BAA6B,CAAC;AAEnF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,0BAA0B,GAAG,yCAAyC,CAAC;AAEpF,oDAAoD;AACpD,MAAM,CAAC,MAAM,iCAAiC,GAAG,uBAAuB,CAAC;AAWzE,iFAAiF;AACjF,MAAM,kCAAkC,GAAG,6CAA6C,CAAC;AAEzF;;;;;GAKG;AACH,MAAM,UAAU,gCAAgC,CAAC,OAA4B;IAC3E,OAAO,wBAAwB,CAAC,0BAA0B,EAAE,OAAO,CAAC,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oCAAoC,CAAC,OAAgB;IACnE,OAAO,4BAA4B,CAAC,qCAAqC,EAAE,OAAO,CAAC,CAAC;AACtF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,6BAA6B,CAAC,OAGnD;IACC,OAAO,qBAAqB,CAC1B,EAAE,QAAQ,EAAE,qCAAqC,EAAE,OAAO,EAAE,0BAA0B,EAAE,EACxF,OAAO,CACR,CAAC;AACJ,CAAC;AAED,2EAA2E;AAC3E,MAAM,CAAC,MAAM,+BAA+B,GAAG,6BAA6B,CAAC;IAC3E,QAAQ,EAAE,qCAAqC;IAC/C,IAAI,EAAE,6BAA6B;IACnC,WAAW,EACT,gJAAgJ;IAClJ,OAAO,EAAE,0BAA0B;IACnC,eAAe,EAAE,kCAAkC;CACpD,CAAC,CAAC"}

package/dist/washingtonStateOpenDataCatalogue.d.ts

@@ -0,0 +1,42 @@
+import { type SocrataCatalogue, type SocrataCatalogueCategoryCount, type SocrataCatalogueEntry } from './socrataCatalogue.js';
+/** Adapter id for the Washington State Open Data catalogue source. */
+export declare const WASHINGTON_STATE_OPEN_DATA_CATALOGUE_SOURCE_ID = "washington-state-open-data-catalogue";
+/** Base URL for the Washington State Open Data Socrata catalogue. */
+export declare const WASHINGTON_STATE_OPEN_DATA_API_BASE = "https://data.wa.gov/api/views.json";
+/** How many catalogue entries one request reads. */
+export declare const WASHINGTON_STATE_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** One catalogue entry from the Washington State Socrata discovery API. */
+export type WashingtonStateOpenDataCatalogueEntry = SocrataCatalogueEntry;
+/** One state topic and how many catalogue entries carry it. */
+export type WashingtonStateOpenDataCategoryCount = SocrataCatalogueCategoryCount;
+/** One page of the Washington State catalogue, folded for a story. */
+export type WashingtonStateOpenDataCatalogue = SocrataCatalogue;
+/**
+ * Builds the request URL for one page of the Washington State catalogue.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export declare function buildWashingtonStateOpenDataCatalogueUrl(options?: {
+    limit?: number;
+}): string;
+/**
+ * Parses one page of the Washington State catalogue into entries and topic counts.
+ *
+ * @param payload - the JSON body from the Washington State Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function parseWashingtonStateOpenDataCataloguePayload(payload: unknown): WashingtonStateOpenDataCatalogue;
+/**
+ * Reads one page of the Washington State Open Data catalogue.
+ *
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function fetchWashingtonStateOpenDataCatalogue(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<WashingtonStateOpenDataCatalogue>;
+/** Washington State Open Data catalogue of datasets, charts, and stories, keyless. */
+export declare const washingtonStateOpenDataCatalogueAdapter: import("./types.js").UsDataAdapter<SocrataCatalogue>;
+//# sourceMappingURL=washingtonStateOpenDataCatalogue.d.ts.map

package/dist/washingtonStateOpenDataCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"washingtonStateOpenDataCatalogue.d.ts","sourceRoot":"","sources":["../src/washingtonStateOpenDataCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,sEAAsE;AACtE,eAAO,MAAM,8CAA8C,yCACnB,CAAC;AAEzC,qEAAqE;AACrE,eAAO,MAAM,mCAAmC,uCAAuC,CAAC;AAExF,oDAAoD;AACpD,eAAO,MAAM,0CAA0C,KAA0B,CAAC;AAElF,2EAA2E;AAC3E,MAAM,MAAM,qCAAqC,GAAG,qBAAqB,CAAC;AAE1E,+DAA+D;AAC/D,MAAM,MAAM,oCAAoC,GAAG,6BAA6B,CAAC;AAEjF,sEAAsE;AACtE,MAAM,MAAM,gCAAgC,GAAG,gBAAgB,CAAC;AAMhE;;;;;GAKG;AACH,wBAAgB,wCAAwC,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAE7F;AAED;;;;;GAKG;AACH,wBAAgB,4CAA4C,CAC1D,OAAO,EAAE,OAAO,GACf,gCAAgC,CAElC;AAED;;;;;GAKG;AACH,wBAAsB,qCAAqC,CAAC,OAAO,CAAC,EAAE;IACpE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,gCAAgC,CAAC,CAQ5C;AAED,sFAAsF;AACtF,eAAO,MAAM,uCAAuC,sDAOlD,CAAC"}