@nz-open-data-connectors/nz-sources 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,48 @@
-# Temporary Holding Version
+# @nz-open-data-connectors/nz-sources
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Uniform TypeScript adapters for NZ public data sources. Every adapter has the same shape: a live fetch, a strict parse, and a committed fixture fallback so builds work offline.
+
+## Adapters
+
+| id            | Source                          | Auth   | What it does                          |
+| ------------- | ------------------------------- | ------ | ------------------------------------- |
+| `geonet`      | GeoNet                          | none   | Felt earthquake reports               |
+| `data-govt-nz`| data.govt.nz search             | none   | Dataset search                        |
+| `datastore`   | data.govt.nz datastore          | none   | Row pulls (e.g. MSD benefits)         |
+| `ade-search`  | Aotearoa Data Explorer search   | none   | Dataflow search                       |
+| `digitalnz`   | DigitalNZ                       | key    | Record search (key optional)          |
+| `trademe`     | Trade Me                        | none   | Category tree                         |
+| `nzor`        | NZ Organisms Register           | none   | Species name search                   |
+| `linz`        | LINZ Data Service               | key    | Layer search (key optional)           |
+
+## Quick start
+
+```ts
+import { NZ_DATA_SOURCES, probeAllNzDataSources } from '@nz-open-data-connectors/nz-sources';
+
+// List every source.
+for (const source of NZ_DATA_SOURCES) {
+  console.log(source.id, source.name, source.auth);
+}
+
+// Live probe every source, with optional keys.
+const probes = await probeAllNzDataSources({
+  apiKeys: {
+    linz: process.env.LINZ_API_KEY,
+    digitalnz: process.env.DIGITAL_NZ_API_KEY,
+  },
+});
+```
+
+## Keys
+
+All adapters work keyless. `linz` and `digitalnz` accept an optional key for higher rate limits and richer results. Keys are read from env only; never commit them.
+
+## Tests
+
+```sh
+npm run test -w @nz-open-data-connectors/nz-sources        # unit tests, fixtures only, no network
+RUN_SMOKE=1 npm run test:smoke -w @nz-open-data-connectors/nz-sources   # live probes against the real APIs
+```
+
+Fixtures in `src/fixtures/` are real snapshots from the live APIs. Smoke tests are skipped by default and must be run explicitly.

package/dist/adeSearch.d.ts

@@ -0,0 +1,30 @@
+import type { NzDataAdapter } from './types.js';
+/** One ADE table found by the Aotearoa Data Explorer search index. */
+export interface AdeDataflow {
+    dataflowId: string;
+    version: string;
+    agencyId: string;
+    name: string;
+    dimensions: string[];
+}
+/** Aotearoa Data Explorer search results. */
+export interface AdeSearchResult {
+    numFound: number;
+    dataflows: AdeDataflow[];
+}
+/** Parses an ADE search index payload into dataflow records. */
+export declare function parseAdeSearchResults(payload: unknown): AdeSearchResult;
+/**
+ * Searches the Aotearoa Data Explorer table index by keyword. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ */
+export declare function searchAdeTables(query: string, options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<AdeSearchResult>;
+/**
+ * Aotearoa Data Explorer search adapter: finds ADE table IDs by keyword.
+ * Keyless. The live probe searches for median annual earnings (LEED).
+ */
+export declare const adeSearchAdapter: NzDataAdapter<AdeSearchResult>;
+//# sourceMappingURL=adeSearch.d.ts.map

package/dist/adeSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adeSearch.d.ts","sourceRoot":"","sources":["../src/adeSearch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,sEAAsE;AACtE,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,6CAA6C;AAC7C,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,WAAW,EAAE,CAAC;CAC1B;AAeD,gEAAgE;AAChE,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAevE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpE,OAAO,CAAC,eAAe,CAAC,CAU1B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,eAAe,CAY3D,CAAC"}

package/dist/adeSearch.js

@@ -0,0 +1,62 @@
+import { z } from 'zod';
+import { NzSourceApiError, NzSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+const ADE_DATAFLOW_SCHEMA = z.object({
+    dataflowId: z.string(),
+    version: z.string().optional().default(''),
+    agencyId: z.string().optional().default(''),
+    name: z.string().optional().default(''),
+    dimensions: z.array(z.string()).optional().default([]),
+});
+const ADE_SEARCH_RESPONSE_SCHEMA = z.object({
+    numFound: z.number(),
+    dataflows: z.array(ADE_DATAFLOW_SCHEMA).optional().default([]),
+});
+/** Parses an ADE search index payload into dataflow records. */
+export function parseAdeSearchResults(payload) {
+    const parsed = ADE_SEARCH_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new NzSourceParseError('ADE search', parsed.error.message);
+    }
+    return {
+        numFound: parsed.data.numFound,
+        dataflows: parsed.data.dataflows.map((flow) => ({
+            dataflowId: flow.dataflowId,
+            version: flow.version,
+            agencyId: flow.agencyId,
+            name: flow.name,
+            dimensions: flow.dimensions,
+        })),
+    };
+}
+/**
+ * Searches the Aotearoa Data Explorer table index by keyword. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ */
+export async function searchAdeTables(query, options = {}) {
+    const limit = options.limit ?? 20;
+    const url = `https://explore.data.stats.govt.nz/sfs/api/search?tenant=public` +
+        `&q=${encodeURIComponent(query)}&limit=${limit}`;
+    const response = await (options.fetchImpl ?? globalThis.fetch)(url);
+    if (!response.ok) {
+        throw new NzSourceApiError('ADE search', `HTTP ${response.status}`);
+    }
+    return parseAdeSearchResults(await response.json());
+}
+/**
+ * Aotearoa Data Explorer search adapter: finds ADE table IDs by keyword.
+ * Keyless. The live probe searches for median annual earnings (LEED).
+ */
+export const adeSearchAdapter = {
+    id: 'ade-search',
+    name: 'Aotearoa Data Explorer search index',
+    auth: 'none',
+    description: 'Searches ADE table IDs and titles by keyword.',
+    fetchLive: (options) => searchAdeTables('median annual earnings', {
+        limit: 5,
+        ...(options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    }),
+    parse: parseAdeSearchResults,
+    loadFixture: () => parseAdeSearchResults(readFixtureJson('ade-search-earnings.json')),
+};
+//# sourceMappingURL=adeSearch.js.map

package/dist/adeSearch.js.map

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

package/dist/arcgisHub.d.ts

@@ -0,0 +1,109 @@
+/** Default ArcGIS Hub host: Auckland Council open data. */
+export declare const DEFAULT_ARCGIS_HUB_HOST = "https://data-aucklandcouncil.opendata.arcgis.com";
+/** One collection advertised by an ArcGIS Hub search API. */
+export interface ArcgisHubCollection {
+    id: string;
+    title: string;
+    itemType: string;
+    description: string;
+}
+/** One dataset found by an ArcGIS Hub dataset search. */
+export interface ArcgisHubDataset {
+    id: string;
+    title: string;
+    snippet: string;
+    type: string;
+    url: string;
+    owner: string;
+    source: string;
+    tags: string[];
+    modified: number;
+    created: number;
+    numViews: number;
+    access: string;
+}
+/** Options for ArcGIS Hub live fetches: host and optional search query. */
+export interface ArcgisHubFetchOptions {
+    host?: string;
+    q?: string;
+    fetchImpl?: typeof globalThis.fetch;
+}
+/** Result of an ArcGIS Hub live fetch: collections or dataset search. */
+export type ArcgisHubResult = {
+    kind: 'collections';
+    collections: ArcgisHubCollection[];
+} | {
+    kind: 'datasets';
+    datasets: ArcgisHubDataset[];
+};
+/**
+ * Normalizes a host option to a base URL with scheme and no trailing slash.
+ *
+ * @param host - Host or base URL, with or without scheme.
+ * @returns The normalized base URL.
+ */
+export declare function normalizeArcgisHubHost(host: string): string;
+/**
+ * Parses an ArcGIS Hub collections payload into collections.
+ *
+ * @param payload - Raw JSON from the collections endpoint.
+ * @returns The advertised collections.
+ */
+export declare function parseArcgisHubCollections(payload: unknown): ArcgisHubCollection[];
+/**
+ * Parses an ArcGIS Hub dataset search payload into datasets.
+ *
+ * @param payload - Raw GeoJSON from the dataset items endpoint.
+ * @returns The datasets found by the search.
+ */
+export declare function parseArcgisHubDatasets(payload: unknown): ArcgisHubDataset[];
+/**
+ * Parses an ArcGIS Hub payload into collections or datasets by shape.
+ *
+ * @param payload - Raw JSON from either ArcGIS Hub endpoint.
+ * @returns Collections when the payload has a collections list, else datasets.
+ */
+export declare function parseArcgisHubResult(payload: unknown): ArcgisHubResult;
+/**
+ * Fetches the collection list from an ArcGIS Hub search API. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ *
+ * @param options - Host and fetch override.
+ * @returns The advertised collections.
+ */
+export declare function fetchArcgisHubCollections(options?: ArcgisHubFetchOptions): Promise<ArcgisHubCollection[]>;
+/**
+ * Searches datasets on an ArcGIS Hub search API by keyword. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ *
+ * @param query - Search keyword, e.g. "parks".
+ * @param options - Host and fetch override.
+ * @returns The datasets found by the search.
+ */
+export declare function searchArcgisHubDatasets(query: string, options?: ArcgisHubFetchOptions): Promise<ArcgisHubDataset[]>;
+/**
+ * ArcGIS Hub adapter: keyless open data search, host-configurable. The live
+ * probe hits the collections endpoint; passing a query searches datasets.
+ */
+export declare const arcgisHubAdapter: {
+    id: string;
+    name: string;
+    auth: "none";
+    description: string;
+    fetchLive: (options?: ArcgisHubFetchOptions) => Promise<{
+        kind: "collections";
+        collections: ArcgisHubCollection[];
+    } | {
+        kind: "datasets";
+        datasets: ArcgisHubDataset[];
+    } | {
+        kind: "datasets";
+        datasets: ArcgisHubDataset[];
+    }>;
+    parse: typeof parseArcgisHubResult;
+    loadFixture: () => {
+        kind: "datasets";
+        datasets: ArcgisHubDataset[];
+    };
+};
+//# sourceMappingURL=arcgisHub.d.ts.map

package/dist/arcgisHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arcgisHub.d.ts","sourceRoot":"","sources":["../src/arcgisHub.ts"],"names":[],"mappings":"AAMA,2DAA2D;AAC3D,eAAO,MAAM,uBAAuB,qDAAqD,CAAC;AAE1F,6DAA6D;AAC7D,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,yDAAyD;AACzD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,2EAA2E;AAC3E,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,CAAC,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACrC;AAED,yEAAyE;AACzE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,WAAW,EAAE,mBAAmB,EAAE,CAAA;CAAE,GAC3D;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,gBAAgB,EAAE,CAAA;CAAE,CAAC;AAwDvD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG3D;AAgBD;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,mBAAmB,EAAE,CAWjF;AAED;;;;;GAKG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,EAAE,CAmB3E;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,eAAe,CAQtE;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAQhC;AAED;;;;;;;GAOG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAS7B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;0BAML,qBAAqB;cAnMjC,aAAa;qBAAe,mBAAmB,EAAE;;cACjD,UAAU;kBAAY,gBAAgB,EAAE;;;;;;;;;;CA0NV,CAAC"}

package/dist/arcgisHub.js

@@ -0,0 +1,200 @@
+import { z } from 'zod';
+import { NzSourceApiError, NzSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** Default ArcGIS Hub host: Auckland Council open data. */
+export const DEFAULT_ARCGIS_HUB_HOST = 'https://data-aucklandcouncil.opendata.arcgis.com';
+const ARCGIS_HUB_COLLECTION_SCHEMA = z.object({
+    id: z.string(),
+    title: z.string(),
+    itemType: z.string().optional().default(''),
+    description: z.string().optional().default(''),
+});
+const ARCGIS_HUB_COLLECTIONS_RESPONSE_SCHEMA = z.object({
+    collections: z.array(ARCGIS_HUB_COLLECTION_SCHEMA),
+});
+const ARCGIS_HUB_DATASET_SCHEMA = z.object({
+    id: z.string(),
+    title: z.string(),
+    snippet: z
+        .string()
+        .nullable()
+        .optional()
+        .transform((value) => value ?? ''),
+    type: z.string(),
+    url: z
+        .string()
+        .nullable()
+        .optional()
+        .transform((value) => value ?? ''),
+    owner: z
+        .string()
+        .nullable()
+        .optional()
+        .transform((value) => value ?? ''),
+    source: z
+        .string()
+        .nullable()
+        .optional()
+        .transform((value) => value ?? ''),
+    tags: z.array(z.string()).optional().default([]),
+    modified: z.number().optional().default(0),
+    created: z.number().optional().default(0),
+    numViews: z.number().optional().default(0),
+    access: z.string().optional().default(''),
+});
+const ARCGIS_HUB_DATASETS_RESPONSE_SCHEMA = z.object({
+    type: z.string(),
+    features: z.array(z.object({
+        id: z.string(),
+        properties: ARCGIS_HUB_DATASET_SCHEMA,
+    })),
+    numberMatched: z.number().optional().default(0),
+    numberReturned: z.number().optional().default(0),
+});
+/**
+ * Normalizes a host option to a base URL with scheme and no trailing slash.
+ *
+ * @param host - Host or base URL, with or without scheme.
+ * @returns The normalized base URL.
+ */
+export function normalizeArcgisHubHost(host) {
+    const trimmed = stripTrailingSlashes(host.trim());
+    return /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+}
+/**
+ * Removes trailing slashes without a regex, so host input stays linear.
+ *
+ * @param value - A host string that may end in slashes.
+ * @returns The host without trailing slashes.
+ */
+function stripTrailingSlashes(value) {
+    let end = value.length;
+    while (end > 0 && value[end - 1] === '/') {
+        end -= 1;
+    }
+    return value.slice(0, end);
+}
+/**
+ * Parses an ArcGIS Hub collections payload into collections.
+ *
+ * @param payload - Raw JSON from the collections endpoint.
+ * @returns The advertised collections.
+ */
+export function parseArcgisHubCollections(payload) {
+    const parsed = ARCGIS_HUB_COLLECTIONS_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new NzSourceParseError('ArcGIS Hub', parsed.error.message);
+    }
+    return parsed.data.collections.map((collection) => ({
+        id: collection.id,
+        title: collection.title,
+        itemType: collection.itemType,
+        description: collection.description,
+    }));
+}
+/**
+ * Parses an ArcGIS Hub dataset search payload into datasets.
+ *
+ * @param payload - Raw GeoJSON from the dataset items endpoint.
+ * @returns The datasets found by the search.
+ */
+export function parseArcgisHubDatasets(payload) {
+    const parsed = ARCGIS_HUB_DATASETS_RESPONSE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new NzSourceParseError('ArcGIS Hub', parsed.error.message);
+    }
+    return parsed.data.features.map((feature) => ({
+        id: feature.id,
+        title: feature.properties.title,
+        snippet: feature.properties.snippet,
+        type: feature.properties.type,
+        url: feature.properties.url,
+        owner: feature.properties.owner,
+        source: feature.properties.source,
+        tags: feature.properties.tags,
+        modified: feature.properties.modified,
+        created: feature.properties.created,
+        numViews: feature.properties.numViews,
+        access: feature.properties.access,
+    }));
+}
+/**
+ * Parses an ArcGIS Hub payload into collections or datasets by shape.
+ *
+ * @param payload - Raw JSON from either ArcGIS Hub endpoint.
+ * @returns Collections when the payload has a collections list, else datasets.
+ */
+export function parseArcgisHubResult(payload) {
+    if (typeof payload === 'object' && payload !== null && 'collections' in payload) {
+        return {
+            kind: 'collections',
+            collections: parseArcgisHubCollections(payload),
+        };
+    }
+    return { kind: 'datasets', datasets: parseArcgisHubDatasets(payload) };
+}
+/**
+ * Fetches the collection list from an ArcGIS Hub search API. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ *
+ * @param options - Host and fetch override.
+ * @returns The advertised collections.
+ */
+export async function fetchArcgisHubCollections(options = {}) {
+    const host = normalizeArcgisHubHost(options.host ?? DEFAULT_ARCGIS_HUB_HOST);
+    const url = `${host}/api/search/v1/collections`;
+    const response = await (options.fetchImpl ?? globalThis.fetch)(url);
+    if (!response.ok) {
+        throw new NzSourceApiError('ArcGIS Hub', `HTTP ${response.status}`);
+    }
+    return parseArcgisHubCollections(await response.json());
+}
+/**
+ * Searches datasets on an ArcGIS Hub search API by keyword. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ *
+ * @param query - Search keyword, e.g. "parks".
+ * @param options - Host and fetch override.
+ * @returns The datasets found by the search.
+ */
+export async function searchArcgisHubDatasets(query, options = {}) {
+    const host = normalizeArcgisHubHost(options.host ?? DEFAULT_ARCGIS_HUB_HOST);
+    const url = new URL(`${host}/api/search/v1/collections/dataset/items`);
+    url.searchParams.set('q', query);
+    const response = await (options.fetchImpl ?? globalThis.fetch)(url);
+    if (!response.ok) {
+        throw new NzSourceApiError('ArcGIS Hub', `HTTP ${response.status}`);
+    }
+    return parseArcgisHubDatasets(await response.json());
+}
+/**
+ * ArcGIS Hub adapter: keyless open data search, host-configurable. The live
+ * probe hits the collections endpoint; passing a query searches datasets.
+ */
+export const arcgisHubAdapter = {
+    id: 'arcgis',
+    name: 'ArcGIS Hub open data',
+    auth: 'none',
+    description: 'Searches NZ open data published on ArcGIS Hub (Auckland Council, WCC, Canterbury, NZTA).',
+    fetchLive: (options) => {
+        const host = options?.host;
+        const query = options?.q;
+        const fetchImpl = options?.fetchImpl;
+        if (query !== undefined) {
+            return searchArcgisHubDatasets(query, {
+                ...(host === undefined ? {} : { host }),
+                ...(fetchImpl === undefined ? {} : { fetchImpl }),
+            }).then((datasets) => ({ kind: 'datasets', datasets }));
+        }
+        return fetchArcgisHubCollections({
+            ...(host === undefined ? {} : { host }),
+            ...(fetchImpl === undefined ? {} : { fetchImpl }),
+        }).then((collections) => ({ kind: 'collections', collections }));
+    },
+    parse: parseArcgisHubResult,
+    loadFixture: () => ({
+        kind: 'datasets',
+        datasets: parseArcgisHubDatasets(readFixtureJson('arcgis-hub-data-aucklandcouncil.opendata.arcgis.com-datasets-parks-2026-08-25.json')),
+    }),
+};
+//# sourceMappingURL=arcgisHub.js.map

package/dist/arcgisHub.js.map

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

package/dist/dataGovtDatastore.d.ts

@@ -0,0 +1,28 @@
+import type { NzDataAdapter } from './types.js';
+/** One row from a data.govt.nz CKAN datastore resource. */
+export type DataGovtDatastoreRow = Record<string, string | number | boolean | null>;
+/** Rows from a data.govt.nz CKAN datastore resource. */
+export interface DataGovtDatastoreResult {
+    resourceId: string;
+    total: number;
+    records: DataGovtDatastoreRow[];
+}
+/** The default resource the adapter probes: MSD national-level main benefit data. */
+export declare const MSD_BENEFIT_RESOURCE_ID = "9144a616-9ab1-4475-972b-ac42c1f891b7";
+/** Parses a data.govt.nz CKAN datastore_search payload into rows. */
+export declare function parseDataGovtDatastoreRows(payload: unknown): DataGovtDatastoreResult;
+/**
+ * Fetches rows from a data.govt.nz CKAN datastore resource. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ */
+export declare function fetchDataGovtDatastoreRows(resourceId: string, options?: {
+    limit?: number;
+    fetchImpl?: typeof globalThis.fetch;
+}): Promise<DataGovtDatastoreResult>;
+/**
+ * data.govt.nz datastore adapter: CKAN datastore_search over the national
+ * open data catalogue. Keyless. The live probe reads the MSD national
+ * benefit table, a long monthly series.
+ */
+export declare const dataGovtDatastoreAdapter: NzDataAdapter<DataGovtDatastoreResult>;
+//# sourceMappingURL=dataGovtDatastore.d.ts.map

package/dist/dataGovtDatastore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataGovtDatastore.d.ts","sourceRoot":"","sources":["../src/dataGovtDatastore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,2DAA2D;AAC3D,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC;AAEpF,wDAAwD;AACxD,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC;AAED,qFAAqF;AACrF,eAAO,MAAM,uBAAuB,yCAAyC,CAAC;AAa9E,qEAAqE;AACrE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,OAAO,GAAG,uBAAuB,CAUpF;AAED;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAA;CAAO,GACpE,OAAO,CAAC,uBAAuB,CAAC,CAUlC;AAED;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,EAAE,aAAa,CAAC,uBAAuB,CAa3E,CAAC"}

package/dist/dataGovtDatastore.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+import { NzSourceApiError, NzSourceParseError } from './errors.js';
+import { readFixtureJson } from './fixtures.js';
+/** The default resource the adapter probes: MSD national-level main benefit data. */
+export const MSD_BENEFIT_RESOURCE_ID = '9144a616-9ab1-4475-972b-ac42c1f891b7';
+const DATA_GOVT_NZ_ROW_SCHEMA = z.record(z.union([z.string(), z.number(), z.boolean(), z.null()]));
+const DATA_GOVT_NZ_DATASTORE_SCHEMA = z.object({
+    success: z.literal(true),
+    result: z.object({
+        resource_id: z.string(),
+        total: z.number(),
+        records: z.array(DATA_GOVT_NZ_ROW_SCHEMA),
+    }),
+});
+/** Parses a data.govt.nz CKAN datastore_search payload into rows. */
+export function parseDataGovtDatastoreRows(payload) {
+    const parsed = DATA_GOVT_NZ_DATASTORE_SCHEMA.safeParse(payload);
+    if (!parsed.success) {
+        throw new NzSourceParseError('data.govt.nz datastore', parsed.error.message);
+    }
+    return {
+        resourceId: parsed.data.result.resource_id,
+        total: parsed.data.result.total,
+        records: parsed.data.result.records,
+    };
+}
+/**
+ * Fetches rows from a data.govt.nz CKAN datastore resource. Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ */
+export async function fetchDataGovtDatastoreRows(resourceId, options = {}) {
+    const limit = options.limit ?? 1000;
+    const url = `https://catalogue.data.govt.nz/api/3/action/datastore_search` +
+        `?resource_id=${encodeURIComponent(resourceId)}&limit=${limit}`;
+    const response = await (options.fetchImpl ?? globalThis.fetch)(url);
+    if (!response.ok) {
+        throw new NzSourceApiError('data.govt.nz datastore', `HTTP ${response.status}`);
+    }
+    return parseDataGovtDatastoreRows(await response.json());
+}
+/**
+ * data.govt.nz datastore adapter: CKAN datastore_search over the national
+ * open data catalogue. Keyless. The live probe reads the MSD national
+ * benefit table, a long monthly series.
+ */
+export const dataGovtDatastoreAdapter = {
+    id: 'data-govt-datastore',
+    name: 'data.govt.nz datastore (MSD benefits)',
+    auth: 'none',
+    description: 'CKAN datastore_search rows, defaulting to national MSD benefit data.',
+    fetchLive: (options) => fetchDataGovtDatastoreRows(MSD_BENEFIT_RESOURCE_ID, options?.fetchImpl === undefined ? {} : { fetchImpl: options.fetchImpl }),
+    parse: parseDataGovtDatastoreRows,
+    loadFixture: () => parseDataGovtDatastoreRows(readFixtureJson('data-govt-datastore-msd-benefits.json')),
+};
+//# sourceMappingURL=dataGovtDatastore.js.map

package/dist/dataGovtDatastore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataGovtDatastore.js","sourceRoot":"","sources":["../src/dataGovtDatastore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAahD,qFAAqF;AACrF,MAAM,CAAC,MAAM,uBAAuB,GAAG,sCAAsC,CAAC;AAE9E,MAAM,uBAAuB,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;AAEnG,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACxB,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;QACvB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,uBAAuB,CAAC;KAC1C,CAAC;CACH,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAM,UAAU,0BAA0B,CAAC,OAAgB;IACzD,MAAM,MAAM,GAAG,6BAA6B,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAChE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,IAAI,kBAAkB,CAAC,wBAAwB,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;IACD,OAAO;QACL,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW;QAC1C,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK;QAC/B,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO;KACpC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,UAAkB,EAClB,UAAmE,EAAE;IAErE,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAAC;IACpC,MAAM,GAAG,GACP,8DAA8D;QAC9D,gBAAgB,kBAAkB,CAAC,UAAU,CAAC,UAAU,KAAK,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC;IACpE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CAAC,wBAAwB,EAAE,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IAClF,CAAC;IACD,OAAO,0BAA0B,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA2C;IAC9E,EAAE,EAAE,qBAAqB;IACzB,IAAI,EAAE,uCAAuC;IAC7C,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,sEAAsE;IACnF,SAAS,EAAE,CAAC,OAAO,EAAE,EAAE,CACrB,0BAA0B,CACxB,uBAAuB,EACvB,OAAO,EAAE,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CACzE;IACH,KAAK,EAAE,0BAA0B;IACjC,WAAW,EAAE,GAAG,EAAE,CAChB,0BAA0B,CAAC,eAAe,CAAC,uCAAuC,CAAC,CAAC;CACvF,CAAC"}

package/dist/dataGovtNz.d.ts

@@ -0,0 +1,25 @@
+import type { NzDataAdapter } from './types.js';
+/** One dataset in the data.govt.nz catalogue. */
+export interface DataGovtNzDataset {
+    name: string;
+    title: string;
+    notes: string;
+    metadataModified: string;
+    url: string;
+    organization: string | undefined;
+}
+/** A data.govt.nz CKAN package_search response: total count plus the rows. */
+export interface DataGovtNzSearchResult {
+    count: number;
+    datasets: DataGovtNzDataset[];
+}
+/** Parses a data.govt.nz CKAN package_search payload into datasets. */
+export declare function parseDataGovtNzDatasets(payload: unknown): DataGovtNzSearchResult;
+/**
+ * Searches the public data.govt.nz catalogue (CKAN API). Keyless.
+ * Falls back to a committed fixture when the API is unreachable.
+ */
+export declare function searchDataGovtNzDatasets(query: string, fetchImpl?: typeof globalThis.fetch): Promise<DataGovtNzSearchResult>;
+/** data.govt.nz adapter: catalogue search, keyless. */
+export declare const dataGovtNzAdapter: NzDataAdapter<DataGovtNzSearchResult>;
+//# sourceMappingURL=dataGovtNz.d.ts.map

package/dist/dataGovtNz.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dataGovtNz.d.ts","sourceRoot":"","sources":["../src/dataGovtNz.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,iDAAiD;AACjD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,GAAG,SAAS,CAAC;CAClC;AAED,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC/B;AAsBD,uEAAuE;AACvE,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,sBAAsB,CAgBhF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,EACb,SAAS,GAAE,OAAO,UAAU,CAAC,KAAwB,GACpD,OAAO,CAAC,sBAAsB,CAAC,CAOjC;AAED,uDAAuD;AACvD,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,sBAAsB,CAQnE,CAAC"}