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

package/dist/californiaOpenDataCatalogue.js

@@ -0,0 +1,153 @@
+import { z } from 'zod';
+import { UsSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+import { httpGet } from './http.js';
+/** Adapter id for the California Open Data catalogue source. */
+export const CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID = 'california-open-data-catalogue';
+/** Keyless CKAN package-search URL for the California Open Data catalogue. */
+export const CALIFORNIA_OPEN_DATA_API_BASE = 'https://data.ca.gov/api/3/action/package_search';
+/** How many catalogue entries one request reads. */
+export const CALIFORNIA_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** Committed snapshot, so a build works when the California host is unreachable. */
+const CALIFORNIA_OPEN_DATA_FIXTURE_FILENAME = 'california-open-data-catalogue-2026-11-08.json';
+/** Category bucket the adapter uses for an entry the catalogue lists without one. */
+const CALIFORNIA_OPEN_DATA_UNCATEGORISED = 'Uncategorised';
+const CALIFORNIA_OPEN_DATA_PACKAGE_SCHEMA = z.object({
+    id: z.string().optional(),
+    name: z.string().optional(),
+    title: z.string().optional(),
+    type: z.string().optional(),
+    metadata_created: z.string().optional(),
+    metadata_modified: z.string().optional(),
+    license_url: z.string().nullable().optional(),
+    license_title: z.string().nullable().optional(),
+    organization: z.object({ title: z.string().optional() }).nullable().optional(),
+    groups: z.array(z.object({ title: z.string().optional() })).optional(),
+    num_resources: z.number().optional(),
+    resources: z.array(z.unknown()).optional(),
+});
+const CALIFORNIA_OPEN_DATA_PAYLOAD_SCHEMA = z.object({
+    success: z.literal(true),
+    result: z.object({
+        count: z.number(),
+        results: z.array(CALIFORNIA_OPEN_DATA_PACKAGE_SCHEMA),
+    }),
+});
+/** Reads one CKAN timestamp as seconds since the Unix epoch. */
+function parseCkanTimestamp(sourceId, value, field) {
+    const normalized = /(?:Z|[+-]\d{2}:?\d{2})$/.test(value) ? value : `${value}Z`;
+    const millis = Date.parse(normalized);
+    if (!Number.isFinite(millis)) {
+        throw new UsSourceParseError(sourceId, `A catalogue entry carried an invalid ${field}`);
+    }
+    return Math.floor(millis / 1000);
+}
+/** Counts entries per category, most entries first, ties by name. */
+function countCaliforniaOpenDataCategories(entries) {
+    const counts = new Map();
+    for (const entry of entries) {
+        const category = entry.category ?? CALIFORNIA_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 newestCaliforniaOpenDataEntry(entries) {
+    const first = entries[0];
+    if (first === undefined) {
+        throw new UsSourceParseError(CALIFORNIA_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 California CKAN catalogue.
+ *
+ * The endpoint is keyless. CKAN calls the entry cap `rows`.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export function buildCaliforniaOpenDataCatalogueUrl(options) {
+    const params = new URLSearchParams({
+        rows: String(options?.limit ?? CALIFORNIA_OPEN_DATA_CATALOGUE_LIMIT),
+    });
+    return `${CALIFORNIA_OPEN_DATA_API_BASE}?${params.toString()}`;
+}
+/**
+ * Parses one page of the California CKAN catalogue into entries and topic counts.
+ *
+ * An entry without an id, a name, a title, or a creation time is a changed
+ * shape and stops the parse. An empty page also stops the parse.
+ *
+ * @param payload - the JSON body from the California CKAN package search
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseCaliforniaOpenDataCataloguePayload(payload) {
+    const parsed = CALIFORNIA_OPEN_DATA_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.result.results.length === 0) {
+        throw new UsSourceParseError(CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID, 'The response carried no entries');
+    }
+    const entries = parsed.data.result.results.map((row) => {
+        if (row.id === undefined ||
+            row.name === undefined ||
+            row.title === undefined ||
+            row.metadata_created === undefined) {
+            throw new UsSourceParseError(CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID, 'A catalogue entry arrived without its id, name, title, or creation time');
+        }
+        const createdAtEpochSeconds = parseCkanTimestamp(CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID, row.metadata_created, 'metadata_created');
+        const modifiedAtEpochSeconds = row.metadata_modified === undefined
+            ? createdAtEpochSeconds
+            : parseCkanTimestamp(CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID, row.metadata_modified, 'metadata_modified');
+        return {
+            id: row.id,
+            name: row.name,
+            title: row.title,
+            assetType: row.type ?? '',
+            category: row.groups?.[0]?.title ?? null,
+            createdAtEpochSeconds,
+            viewLastModifiedEpochSeconds: modifiedAtEpochSeconds,
+            resourceCount: row.num_resources ?? row.resources?.length ?? 0,
+            licenceUrl: (row.license_url ?? row.license_title ?? '').trim(),
+            attribution: (row.organization?.title ?? '').trim(),
+        };
+    });
+    return {
+        entries,
+        entryCount: entries.length,
+        catalogueCount: parsed.data.result.count,
+        datasetCount: entries.filter((entry) => entry.assetType === 'dataset').length,
+        newestEntry: newestCaliforniaOpenDataEntry(entries),
+        categories: countCaliforniaOpenDataCategories(entries),
+    };
+}
+/**
+ * Reads one page of the California Open Data catalogue through CKAN.
+ *
+ * One keyless request covers the page. The Socrata discovery endpoint on the
+ * same host answers HTTP 404, while CKAN package search answers JSON.
+ *
+ * @param options - an optional entry cap and fetch stub
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export async function fetchCaliforniaOpenDataCatalogue(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildCaliforniaOpenDataCatalogueUrl(options?.limit === undefined ? {} : { limit: options.limit });
+    const response = await httpGet(CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID, url, { fetchImpl });
+    return parseCaliforniaOpenDataCataloguePayload(await response.json());
+}
+/** California Open Data catalogue of datasets and resources, keyless through CKAN. */
+export const californiaOpenDataCatalogueAdapter = {
+    id: CALIFORNIA_OPEN_DATA_CATALOGUE_SOURCE_ID,
+    name: 'California Open Data catalogue',
+    auth: 'none',
+    description: 'The California Open Data CKAN catalogue, one row per published dataset package, with its title, groups, resources, licence, and publishing organisation.',
+    fetchLive: async (options) => fetchCaliforniaOpenDataCatalogue(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseCaliforniaOpenDataCataloguePayload(payload),
+    loadFixture: () => parseCaliforniaOpenDataCataloguePayload(readFixtureJson(CALIFORNIA_OPEN_DATA_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=californiaOpenDataCatalogue.js.map

package/dist/californiaOpenDataCatalogue.js.map

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

package/dist/cdcSocrataCatalogue.d.ts

@@ -21,6 +21,10 @@ export interface CdcSocrataCatalogueEntry {
     viewCount: number;
     /** How many times the entry has been downloaded. */
     downloadCount: number;
+    /** 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;
 }
 /** One category and how many catalogue entries carry it. */
 export interface CdcSocrataCategoryCount {

package/dist/cdcSocrataCatalogue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cdcSocrataCatalogue.d.ts","sourceRoot":"","sources":["../src/cdcSocrataCatalogue.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,uDAAuD;AACvD,eAAO,MAAM,+BAA+B,0BAA0B,CAAC;AAEvE,0DAA0D;AAC1D,MAAM,WAAW,wBAAwB;IACvC,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,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,wBAAwB,CAAC;IACtC;;;OAGG;IACH,UAAU,EAAE,uBAAuB,EAAE,CAAC;CACvC;AAED,8CAA8C;AAC9C,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AAEpF,oDAAoD;AACpD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAkD9C;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAuCrF;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAO/B;AAED,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,mBAAmB,CAazE,CAAC"}
+{"version":3,"file":"cdcSocrataCatalogue.d.ts","sourceRoot":"","sources":["../src/cdcSocrataCatalogue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,uDAAuD;AACvD,eAAO,MAAM,+BAA+B,0BAA0B,CAAC;AAEvE,0DAA0D;AAC1D,MAAM,WAAW,wBAAwB;IACvC,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;IACtB,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAC;IACnB,6FAA6F;IAC7F,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,4DAA4D;AAC5D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,OAAO,EAAE,wBAAwB,EAAE,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,wBAAwB,CAAC;IACtC;;;OAGG;IACH,UAAU,EAAE,uBAAuB,EAAE,CAAC;CACvC;AAED,8CAA8C;AAC9C,eAAO,MAAM,8BAA8B,wCAAwC,CAAC;AAEpF,oDAAoD;AACpD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAmD9C;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKhF;AAED;;;;;;;;;GASG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,CAwCrF;AAED;;;;;;;;GAQG;AACH,wBAAsB,wBAAwB,CAAC,OAAO,CAAC,EAAE;IACvD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAO/B;AAED,uEAAuE;AACvE,eAAO,MAAM,0BAA0B,EAAE,aAAa,CAAC,mBAAmB,CAazE,CAAC"}

package/dist/cdcSocrataCatalogue.js

@@ -2,6 +2,7 @@ import { z } from 'zod';
 import { UsSourceParseError } from './errors.js';
 import { httpGet } from './http.js';
 import { readFixtureJson } from './fixtures.js';
+import { parseSocrataCatalogueMetadata } from './socrataCatalogueMetadata.js';
 /** Adapter id for the cdc-socrata-catalogue source. */
 export const CDC_SOCRATA_CATALOGUE_SOURCE_ID = 'cdc-socrata-catalogue';
 /** Base URL for the CDC Socrata catalogue. */
@@ -24,6 +25,7 @@ const CDC_SOCRATA_CATALOGUE_ENTRY_SCHEMA = z.object({
     viewLastModified: z.number().optional(),
     viewCount: z.number().optional(),
     downloadCount: z.number().optional(),
+    metadata: z.unknown().optional(),
 });
 const CDC_SOCRATA_CATALOGUE_PAYLOAD_SCHEMA = z.array(CDC_SOCRATA_CATALOGUE_ENTRY_SCHEMA);
 /** Counts entries per category, most entries first, ties by name. */
@@ -92,6 +94,7 @@ export function parseCdcSocrataCataloguePayload(payload) {
             viewLastModifiedEpochSeconds: row.viewLastModified ?? row.createdAt,
             viewCount: row.viewCount ?? 0,
             downloadCount: row.downloadCount ?? 0,
+            ...parseSocrataCatalogueMetadata(row.metadata),
         };
     });
     return {

package/dist/cdcSocrataCatalogue.js.map

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

package/dist/chicagoOpenDataCatalogue.d.ts

@@ -0,0 +1,91 @@
+import type { UsDataAdapter } from './types.js';
+/** Adapter id for the Chicago Data Portal catalogue source. */
+export declare const CHICAGO_OPEN_DATA_CATALOGUE_SOURCE_ID = "chicago-open-data-catalogue";
+/** Base URL for the Chicago Data Portal Socrata catalogue. */
+export declare const CHICAGO_OPEN_DATA_API_BASE = "https://data.cityofchicago.org/api/views.json";
+/** How many catalogue entries one request reads. */
+export declare const CHICAGO_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** One catalogue entry from the Chicago Socrata discovery API. */
+export interface ChicagoOpenDataCatalogueEntry {
+    /** Four-by-four Socrata dataset id, e.g. "p4pq-bxn9". */
+    id: string;
+    /** Human-readable title of the dataset, chart, story, map, or file. */
+    name: string;
+    /** What the entry is: "dataset", "chart", "story", "map", or "file". */
+    assetType: string;
+    /** City topic the entry belongs to, or null when the catalogue lists none. */
+    category: string | null;
+    /** How the entry is rendered, e.g. "tabular" 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;
+    /** 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 city topic and how many catalogue entries carry it. */
+export interface ChicagoOpenDataCategoryCount {
+    category: string;
+    entryCount: number;
+}
+/** One page of the Chicago catalogue, folded for a story. */
+export interface ChicagoOpenDataCatalogue {
+    /** One entry per catalogue item in the page. */
+    entries: ChicagoOpenDataCatalogueEntry[];
+    entryCount: number;
+    /** Entries whose asset type is "dataset". */
+    datasetCount: number;
+    /** Entry with the latest creation time. Ties go to the earlier list entry. */
+    newestEntry: ChicagoOpenDataCatalogueEntry;
+    /**
+     * Categories in the page, most entries first, ties broken by name. An entry
+     * the catalogue lists without a category is counted under "Uncategorised".
+     */
+    categories: ChicagoOpenDataCategoryCount[];
+}
+/**
+ * Builds the request URL for one page of the Chicago 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 buildChicagoOpenDataCatalogueUrl(options?: {
+    limit?: number;
+}): string;
+/**
+ * Parses one page of the Chicago 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 Chicago Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function parseChicagoOpenDataCataloguePayload(payload: unknown): ChicagoOpenDataCatalogue;
+/**
+ * Reads one page of the Chicago Data Portal catalogue.
+ *
+ * One keyless request covers the page and reports what the city 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 fetchChicagoOpenDataCatalogue(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<ChicagoOpenDataCatalogue>;
+/** Chicago Data Portal catalogue of datasets, charts, maps, and stories, keyless. */
+export declare const chicagoOpenDataCatalogueAdapter: UsDataAdapter<ChicagoOpenDataCatalogue>;
+//# sourceMappingURL=chicagoOpenDataCatalogue.d.ts.map

package/dist/chicagoOpenDataCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chicagoOpenDataCatalogue.d.ts","sourceRoot":"","sources":["../src/chicagoOpenDataCatalogue.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,+DAA+D;AAC/D,eAAO,MAAM,qCAAqC,gCAAgC,CAAC;AAEnF,8DAA8D;AAC9D,eAAO,MAAM,0BAA0B,kDAAkD,CAAC;AAE1F,oDAAoD;AACpD,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD,kEAAkE;AAClE,MAAM,WAAW,6BAA6B;IAC5C,yDAAyD;IACzD,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,wEAAwE;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,4DAA4D;IAC5D,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,8DAA8D;AAC9D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,6DAA6D;AAC7D,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,WAAW,EAAE,6BAA6B,CAAC;IAC3C;;;OAGG;IACH,UAAU,EAAE,4BAA4B,EAAE,CAAC;CAC5C;AAuDD;;;;;;;;GAQG;AACH,wBAAgB,gCAAgC,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAKrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,OAAO,GAAG,wBAAwB,CAwC/F;AAED;;;;;;;;GAQG;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,CAOpC;AAED,qFAAqF;AACrF,eAAO,MAAM,+BAA+B,EAAE,aAAa,CAAC,wBAAwB,CAanF,CAAC"}

package/dist/chicagoOpenDataCatalogue.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 Chicago Data Portal catalogue source. */
+export const CHICAGO_OPEN_DATA_CATALOGUE_SOURCE_ID = 'chicago-open-data-catalogue';
+/** Base URL for the Chicago Data Portal Socrata catalogue. */
+export const CHICAGO_OPEN_DATA_API_BASE = 'https://data.cityofchicago.org/api/views.json';
+/** How many catalogue entries one request reads. */
+export const CHICAGO_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** Committed snapshot, so a build works when the Chicago host is unreachable. */
+const CHICAGO_OPEN_DATA_FIXTURE_FILENAME = 'chicago-open-data-catalogue-2026-11-08.json';
+/** Category bucket the adapter uses for an entry the catalogue lists without one. */
+const CHICAGO_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 CHICAGO_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 CHICAGO_OPEN_DATA_PAYLOAD_SCHEMA = z.array(CHICAGO_OPEN_DATA_ENTRY_SCHEMA);
+/** Counts entries per category, most entries first, ties by name. */
+function countChicagoOpenDataCategories(entries) {
+    const counts = new Map();
+    for (const entry of entries) {
+        const category = entry.category ?? CHICAGO_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 newestChicagoOpenDataEntry(entries) {
+    const first = entries[0];
+    if (first === undefined) {
+        throw new UsSourceParseError(CHICAGO_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 Chicago 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 buildChicagoOpenDataCatalogueUrl(options) {
+    const params = new URLSearchParams({
+        limit: String(options?.limit ?? CHICAGO_OPEN_DATA_CATALOGUE_LIMIT),
+    });
+    return `${CHICAGO_OPEN_DATA_API_BASE}?${params.toString()}`;
+}
+/**
+ * Parses one page of the Chicago 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 Chicago Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseChicagoOpenDataCataloguePayload(payload) {
+    const parsed = CHICAGO_OPEN_DATA_PAYLOAD_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new UsSourceParseError(CHICAGO_OPEN_DATA_CATALOGUE_SOURCE_ID, parsed.error.message);
+    }
+    if (parsed.data.length === 0) {
+        throw new UsSourceParseError(CHICAGO_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(CHICAGO_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: newestChicagoOpenDataEntry(entries),
+        categories: countChicagoOpenDataCategories(entries),
+    };
+}
+/**
+ * Reads one page of the Chicago Data Portal catalogue.
+ *
+ * One keyless request covers the page and reports what the city 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 fetchChicagoOpenDataCatalogue(options) {
+    const fetchImpl = options?.fetchImpl ?? globalThis.fetch;
+    const url = buildChicagoOpenDataCatalogueUrl(options?.limit === undefined ? {} : { limit: options.limit });
+    const response = await httpGet(CHICAGO_OPEN_DATA_CATALOGUE_SOURCE_ID, url, { fetchImpl });
+    return parseChicagoOpenDataCataloguePayload(await response.json());
+}
+/** Chicago Data Portal catalogue of datasets, charts, maps, and stories, keyless. */
+export const chicagoOpenDataCatalogueAdapter = {
+    id: CHICAGO_OPEN_DATA_CATALOGUE_SOURCE_ID,
+    name: 'Chicago Data Portal catalogue',
+    auth: 'none',
+    description: 'The Chicago Data Portal Socrata catalogue, one row per published dataset, chart, map, or story, with its city topic, view count, and download count.',
+    fetchLive: async (options) => fetchChicagoOpenDataCatalogue(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: (payload) => parseChicagoOpenDataCataloguePayload(payload),
+    loadFixture: () => parseChicagoOpenDataCataloguePayload(readFixtureJson(CHICAGO_OPEN_DATA_FIXTURE_FILENAME)),
+};
+//# sourceMappingURL=chicagoOpenDataCatalogue.js.map

package/dist/chicagoOpenDataCatalogue.js.map

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

package/dist/coloradoOpenDataCatalogue.d.ts

@@ -0,0 +1,42 @@
+import { type SocrataCatalogue, type SocrataCatalogueCategoryCount, type SocrataCatalogueEntry } from './socrataCatalogue.js';
+/** Adapter id for the Colorado Open Data catalogue source. */
+export declare const COLORADO_OPEN_DATA_CATALOGUE_SOURCE_ID = "colorado-open-data-catalogue";
+/** Base URL for the Colorado Open Data Socrata catalogue. */
+export declare const COLORADO_OPEN_DATA_API_BASE = "https://data.colorado.gov/api/views.json";
+/** How many catalogue entries one request reads. */
+export declare const COLORADO_OPEN_DATA_CATALOGUE_LIMIT = 10;
+/** One catalogue entry from the Colorado Socrata discovery API. */
+export type ColoradoOpenDataCatalogueEntry = SocrataCatalogueEntry;
+/** One state topic and how many catalogue entries carry it. */
+export type ColoradoOpenDataCategoryCount = SocrataCatalogueCategoryCount;
+/** One page of the Colorado catalogue, folded for a story. */
+export type ColoradoOpenDataCatalogue = SocrataCatalogue;
+/**
+ * Builds the request URL for one page of the Colorado catalogue.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export declare function buildColoradoOpenDataCatalogueUrl(options?: {
+    limit?: number;
+}): string;
+/**
+ * Parses one page of the Colorado catalogue into entries and topic counts.
+ *
+ * @param payload - the JSON body from the Colorado Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export declare function parseColoradoOpenDataCataloguePayload(payload: unknown): ColoradoOpenDataCatalogue;
+/**
+ * Reads one page of the Colorado 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 fetchColoradoOpenDataCatalogue(options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<ColoradoOpenDataCatalogue>;
+/** Colorado Open Data catalogue of datasets, maps, charts, and linked resources, keyless. */
+export declare const coloradoOpenDataCatalogueAdapter: import("./types.js").UsDataAdapter<SocrataCatalogue>;
+//# sourceMappingURL=coloradoOpenDataCatalogue.d.ts.map

package/dist/coloradoOpenDataCatalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coloradoOpenDataCatalogue.d.ts","sourceRoot":"","sources":["../src/coloradoOpenDataCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAC;AAE/B,8DAA8D;AAC9D,eAAO,MAAM,sCAAsC,iCAAiC,CAAC;AAErF,6DAA6D;AAC7D,eAAO,MAAM,2BAA2B,6CAA6C,CAAC;AAEtF,oDAAoD;AACpD,eAAO,MAAM,kCAAkC,KAA0B,CAAC;AAE1E,mEAAmE;AACnE,MAAM,MAAM,8BAA8B,GAAG,qBAAqB,CAAC;AAEnE,+DAA+D;AAC/D,MAAM,MAAM,6BAA6B,GAAG,6BAA6B,CAAC;AAE1E,8DAA8D;AAC9D,MAAM,MAAM,yBAAyB,GAAG,gBAAgB,CAAC;AAKzD;;;;;GAKG;AACH,wBAAgB,iCAAiC,CAAC,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAEtF;AAED;;;;;GAKG;AACH,wBAAgB,qCAAqC,CAAC,OAAO,EAAE,OAAO,GAAG,yBAAyB,CAEjG;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAAC,OAAO,CAAC,EAAE;IAC7D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAKrC;AAED,6FAA6F;AAC7F,eAAO,MAAM,gCAAgC,sDAO3C,CAAC"}

package/dist/coloradoOpenDataCatalogue.js

@@ -0,0 +1,45 @@
+import { buildSocrataCatalogueUrl, createSocrataCatalogueAdapter, fetchSocrataCatalogue, parseSocrataCataloguePayload, SOCRATA_CATALOGUE_LIMIT, } from './socrataCatalogue.js';
+/** Adapter id for the Colorado Open Data catalogue source. */
+export const COLORADO_OPEN_DATA_CATALOGUE_SOURCE_ID = 'colorado-open-data-catalogue';
+/** Base URL for the Colorado Open Data Socrata catalogue. */
+export const COLORADO_OPEN_DATA_API_BASE = 'https://data.colorado.gov/api/views.json';
+/** How many catalogue entries one request reads. */
+export const COLORADO_OPEN_DATA_CATALOGUE_LIMIT = SOCRATA_CATALOGUE_LIMIT;
+/** Committed snapshot, so a build works when the Colorado host is unreachable. */
+const COLORADO_OPEN_DATA_FIXTURE_FILENAME = 'colorado-open-data-catalogue-2026-11-08.json';
+/**
+ * Builds the request URL for one page of the Colorado catalogue.
+ *
+ * @param options - an optional entry cap
+ * @returns the full request URL
+ */
+export function buildColoradoOpenDataCatalogueUrl(options) {
+    return buildSocrataCatalogueUrl(COLORADO_OPEN_DATA_API_BASE, options);
+}
+/**
+ * Parses one page of the Colorado catalogue into entries and topic counts.
+ *
+ * @param payload - the JSON body from the Colorado Socrata discovery API
+ * @returns the entries in the page, the counts, and the newest entry
+ */
+export function parseColoradoOpenDataCataloguePayload(payload) {
+    return parseSocrataCataloguePayload(COLORADO_OPEN_DATA_CATALOGUE_SOURCE_ID, payload);
+}
+/**
+ * Reads one page of the Colorado 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 fetchColoradoOpenDataCatalogue(options) {
+    return fetchSocrataCatalogue({ sourceId: COLORADO_OPEN_DATA_CATALOGUE_SOURCE_ID, apiBase: COLORADO_OPEN_DATA_API_BASE }, options);
+}
+/** Colorado Open Data catalogue of datasets, maps, charts, and linked resources, keyless. */
+export const coloradoOpenDataCatalogueAdapter = createSocrataCatalogueAdapter({
+    sourceId: COLORADO_OPEN_DATA_CATALOGUE_SOURCE_ID,
+    name: 'Colorado Open Data catalogue',
+    description: 'The Colorado Open Data Socrata catalogue, one row per published dataset, map, chart, or linked resource, with its state topic, view count, and download count.',
+    apiBase: COLORADO_OPEN_DATA_API_BASE,
+    fixtureFilename: COLORADO_OPEN_DATA_FIXTURE_FILENAME,
+});
+//# sourceMappingURL=coloradoOpenDataCatalogue.js.map

package/dist/coloradoOpenDataCatalogue.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coloradoOpenDataCatalogue.js","sourceRoot":"","sources":["../src/coloradoOpenDataCatalogue.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,qBAAqB,EACrB,4BAA4B,EAC5B,uBAAuB,GAIxB,MAAM,uBAAuB,CAAC;AAE/B,8DAA8D;AAC9D,MAAM,CAAC,MAAM,sCAAsC,GAAG,8BAA8B,CAAC;AAErF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,0CAA0C,CAAC;AAEtF,oDAAoD;AACpD,MAAM,CAAC,MAAM,kCAAkC,GAAG,uBAAuB,CAAC;AAW1E,kFAAkF;AAClF,MAAM,mCAAmC,GAAG,8CAA8C,CAAC;AAE3F;;;;;GAKG;AACH,MAAM,UAAU,iCAAiC,CAAC,OAA4B;IAC5E,OAAO,wBAAwB,CAAC,2BAA2B,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,qCAAqC,CAAC,OAAgB;IACpE,OAAO,4BAA4B,CAAC,sCAAsC,EAAE,OAAO,CAAC,CAAC;AACvF,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAAC,OAGpD;IACC,OAAO,qBAAqB,CAC1B,EAAE,QAAQ,EAAE,sCAAsC,EAAE,OAAO,EAAE,2BAA2B,EAAE,EAC1F,OAAO,CACR,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gCAAgC,GAAG,6BAA6B,CAAC;IAC5E,QAAQ,EAAE,sCAAsC;IAChD,IAAI,EAAE,8BAA8B;IACpC,WAAW,EACT,gKAAgK;IAClK,OAAO,EAAE,2BAA2B;IACpC,eAAe,EAAE,mCAAmC;CACrD,CAAC,CAAC"}