@mailwoman/corpus 10.0.0 → 10.2.0

package/out/ee/adapters/ads/adapter.d.ts

@@ -0,0 +1,102 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `ads`: Estonia's INSPIRE Addresses (AD) theme, published by Maa- ja Ruumiamet out of the
+ * Aadressiandmete süsteem.
+ *
+ * Input is newline-delimited GeoJSON: one `AD_Address:AD.Address` feature per line, as the service's
+ * `outputFormat=application/json` writes them. A page of the service is a `FeatureCollection`, and the
+ * acquisition step appends each page's `features` to the file, so the adapter streams a 729,973-feature
+ * extract without holding a page in memory.
+ *
+ * GeoServer flattens the INSPIRE application schema here, so every component value arrives inline on
+ * the feature's `properties` and the adapter resolves no reference. The county, the municipality, the
+ * settlement unit, the address area, the thoroughfare and the postal descriptor each occupy one of six
+ * fixed `component<n>_xlink_title` slots. An unused slot holds the string `unpopulated` rather than a
+ * void object. The slot a value lands in is fixed: slot 1 holds the county, slot 2 the municipality,
+ * slot 3 the settlement unit, slot 4 the address area, slot 5 the thoroughfare and slot 6 the postal
+ * descriptor.
+ *
+ * The field whose name matches the INSPIRE designator holds an internal ADS code, and the house
+ * number sits in the locator's name-spelling element. Estonia writes that ADS code in
+ * `locator_addresslocator_designator_locatordesignator_designator` (`7_1DOW`, `7_3P4Y`, `6_0MU3`).
+ * The human-readable number is in `locator_addresslocator_name_locatorname_name_spelling_text`. The
+ * designator's own type states `addressNumber` on the street rows, so that field is tempting to
+ * read. A reader that takes it would stamp `7_1DOW` as the house number on every row.
+ *
+ * The locator name takes one of two roles, and the feature's structure decides which. A feature that
+ * holds a thoroughfare or an address area writes its number there, and one that holds neither writes
+ * the farm or building name that designates the addressable unit. The two never co-occur. The adapter
+ * therefore reads `house_number` where a thoroughfare element exists and `venue` where none does, so a
+ * farm name never arrives labeled as a number.
+ *
+ * Slots 4 and 5 hold a malformed `href`: it addresses the `AU_haldusyksused` workspace with an
+ * `AD_Address` type and answers HTTP 400 `Unknown namespace [AD_Address]`. The adapter reads the slot's
+ * `title` and never follows an `href`.
+ *
+ * A row with no thoroughfare element is the ordinary rural case rather than a defect.
+ *
+ * Maa- ja Ruumiamet's dataset record states Creative Commons CC0 1.0 in `otherConstraints`. The
+ * address-source register elected that license and records it under `spdx` as `CC0-1.0`. CC0 reserves no act, so the
+ * adapter stamps that label on every row and the model card needs no attribution clause, although
+ * crediting the publisher stays good practice.
+ *
+ * The adapter honors `opts.limit` and `opts.signal`. `opts.country` is optional and accepts only `EE`.
+ */
+import { type CorpusAdapter } from "#types";
+/**
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
+ */
+export declare const ADS_ADAPTER_ID = "ads";
+/**
+ * The one jurisdiction this adapter emits.
+ *
+ * The service covers Estonia whole, so the set has one member and `opts.country` either
+ * matches `EE` or asks for a jurisdiction the dataset does not publish.
+ */
+export declare const ADS_COUNTRIES: readonly string[];
+/**
+ * The license the address-source register elected for this publisher.
+ *
+ * `unchecked-access-free-ee-maa-ja-ruumiamet` is elected with `spdx` `CC0-1.0`,
+ * from the `otherConstraints` of CSW record `b0bd266e-b4c6-45db-b7ea-f47486b6258b`.
+ */
+export declare const ADS_DEFAULT_LICENSE = "CC0-1.0";
+/**
+ * The flattened `AD.Address` properties this adapter consults.
+ *
+ * The explicit shape catches a rename early, and leaving the designator out of
+ * it is deliberate: the property exists on every feature and holds an ADS code
+ * rather than a house number, so the adapter cannot read it by accident.
+ */
+interface ADSProperties {
+    gml_id?: number | string;
+    inspireid_identifier_localid?: number | string;
+    locator_addresslocator_name_locatorname_name_spelling_text?: string;
+    component1_xlink_title?: string;
+    component2_xlink_title?: string;
+    component3_xlink_title?: string;
+    component4_xlink_title?: string;
+    component5_xlink_title?: string;
+    component6_xlink_title?: string;
+}
+/**
+ * The thoroughfare element a feature addresses, or an empty string where it addresses none.
+ *
+ * A thoroughfare name and an address area never co-occur on one feature, and the
+ * publisher's own `alternativeidentifier` writes either one in the same position:
+ * `Veskimäe tee 8` for the first and `Vahatu vkt 19` for the second.
+ * The address area is therefore read as the street it stands in for rather than as a separate rung.
+ */
+export declare function thoroughfareOf(properties: ADSProperties): string;
+export declare function createADSAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const adsAdapter: CorpusAdapter;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

package/out/ee/adapters/ads/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/ee/adapters/ads/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AAQH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAQ,CAAA;AAEnC;;;;;GAKG;AACH,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAAW,CAAA;AAEtD;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,YAAY,CAAA;AAW5C;;;;;;GAMG;AACH,UAAU,aAAa;IACtB,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IACxB,4BAA4B,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAC9C,0DAA0D,CAAC,EAAE,MAAM,CAAA;IACnE,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAA;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAC/B;AAsBD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,aAAa,GAAG,MAAM,CAEhE;AAED,wBAAgB,gBAAgB,IAAI,aAAa,CA+FhD;AAED;;GAEG;AACH,eAAO,MAAM,UAAU,eAAqB,CAAA"}

package/out/ee/adapters/ads/adapter.js

@@ -0,0 +1,185 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `ads`: Estonia's INSPIRE Addresses (AD) theme, published by Maa- ja Ruumiamet out of the
+ * Aadressiandmete süsteem.
+ *
+ * Input is newline-delimited GeoJSON: one `AD_Address:AD.Address` feature per line, as the service's
+ * `outputFormat=application/json` writes them. A page of the service is a `FeatureCollection`, and the
+ * acquisition step appends each page's `features` to the file, so the adapter streams a 729,973-feature
+ * extract without holding a page in memory.
+ *
+ * GeoServer flattens the INSPIRE application schema here, so every component value arrives inline on
+ * the feature's `properties` and the adapter resolves no reference. The county, the municipality, the
+ * settlement unit, the address area, the thoroughfare and the postal descriptor each occupy one of six
+ * fixed `component<n>_xlink_title` slots. An unused slot holds the string `unpopulated` rather than a
+ * void object. The slot a value lands in is fixed: slot 1 holds the county, slot 2 the municipality,
+ * slot 3 the settlement unit, slot 4 the address area, slot 5 the thoroughfare and slot 6 the postal
+ * descriptor.
+ *
+ * The field whose name matches the INSPIRE designator holds an internal ADS code, and the house
+ * number sits in the locator's name-spelling element. Estonia writes that ADS code in
+ * `locator_addresslocator_designator_locatordesignator_designator` (`7_1DOW`, `7_3P4Y`, `6_0MU3`).
+ * The human-readable number is in `locator_addresslocator_name_locatorname_name_spelling_text`. The
+ * designator's own type states `addressNumber` on the street rows, so that field is tempting to
+ * read. A reader that takes it would stamp `7_1DOW` as the house number on every row.
+ *
+ * The locator name takes one of two roles, and the feature's structure decides which. A feature that
+ * holds a thoroughfare or an address area writes its number there, and one that holds neither writes
+ * the farm or building name that designates the addressable unit. The two never co-occur. The adapter
+ * therefore reads `house_number` where a thoroughfare element exists and `venue` where none does, so a
+ * farm name never arrives labeled as a number.
+ *
+ * Slots 4 and 5 hold a malformed `href`: it addresses the `AU_haldusyksused` workspace with an
+ * `AD_Address` type and answers HTTP 400 `Unknown namespace [AD_Address]`. The adapter reads the slot's
+ * `title` and never follows an `href`.
+ *
+ * A row with no thoroughfare element is the ordinary rural case rather than a defect.
+ *
+ * Maa- ja Ruumiamet's dataset record states Creative Commons CC0 1.0 in `otherConstraints`. The
+ * address-source register elected that license and records it under `spdx` as `CC0-1.0`. CC0 reserves no act, so the
+ * adapter stamps that label on every row and the model card needs no attribution clause, although
+ * crediting the publisher stays good practice.
+ *
+ * The adapter honors `opts.limit` and `opts.signal`. `opts.country` is optional and accepts only `EE`.
+ */
+import { formatAddressRow } from "@mailwoman/codex/address/format";
+import { JSONSpliterator } from "spliterator";
+import { UnsupportedCountryError } from "#adapters/errors";
+import { stableSourceID } from "#adapters/source-id";
+import { SourceRegister } from "#registers";
+import { AddressRole, SurfaceOrigin } from "#types";
+/**
+ * Registry id for this adapter.
+ *
+ * Stamped into every row it emits, so a corpus record can be traced back to the dataset it came from.
+ */
+export const ADS_ADAPTER_ID = "ads";
+/**
+ * The one jurisdiction this adapter emits.
+ *
+ * The service covers Estonia whole, so the set has one member and `opts.country` either
+ * matches `EE` or asks for a jurisdiction the dataset does not publish.
+ */
+export const ADS_COUNTRIES = ["EE"];
+/**
+ * The license the address-source register elected for this publisher.
+ *
+ * `unchecked-access-free-ee-maa-ja-ruumiamet` is elected with `spdx` `CC0-1.0`,
+ * from the `otherConstraints` of CSW record `b0bd266e-b4c6-45db-b7ea-f47486b6258b`.
+ */
+export const ADS_DEFAULT_LICENSE = "CC0-1.0";
+/**
+ * The sentinel Estonia writes in an unused component slot.
+ *
+ * It is the local name of an INSPIRE void reason, written as bare text where GeoServer would
+ * otherwise write a void object, and it appears in both the slot's `href` and its `title`.
+ * A reader that takes the title at face value stores the word as a street name.
+ */
+const UNPOPULATED = "unpopulated";
+/**
+ * A component slot's value, or an empty string where the slot is unused.
+ *
+ * The sentinel is compared case-insensitively because it renders an INSPIRE codelist term
+ * rather than a value the publisher authored.
+ */
+function slotValue(value) {
+    const trimmed = (value ?? "").trim();
+    return trimmed.toLowerCase() === UNPOPULATED ? "" : trimmed;
+}
+/**
+ * The thoroughfare element a feature addresses, or an empty string where it addresses none.
+ *
+ * A thoroughfare name and an address area never co-occur on one feature, and the
+ * publisher's own `alternativeidentifier` writes either one in the same position:
+ * `Veskimäe tee 8` for the first and `Vahatu vkt 19` for the second.
+ * The address area is therefore read as the street it stands in for rather than as a separate rung.
+ */
+export function thoroughfareOf(properties) {
+    return slotValue(properties.component5_xlink_title) || slotValue(properties.component4_xlink_title);
+}
+export function createADSAdapter() {
+    return {
+        id: ADS_ADAPTER_ID,
+        defaultLicense: ADS_DEFAULT_LICENSE,
+        addressRole: AddressRole.Premise,
+        register: SourceRegister.EstoniaADS,
+        surface: SurfaceOrigin.Rendered,
+        description: "Estonia's INSPIRE Addresses theme (Maa- ja Ruumiamet): address points with a thoroughfare or a named site.",
+        async *rows(opts) {
+            if (opts.country && !ADS_COUNTRIES.includes(opts.country)) {
+                throw new UnsupportedCountryError(ADS_ADAPTER_ID, ADS_COUNTRIES, opts.country);
+            }
+            const features = JSONSpliterator.fromAsync(opts.inputPath);
+            let emitted = 0;
+            for await (const feature of features) {
+                if (opts.signal?.aborted)
+                    break;
+                if (opts.limit !== undefined && emitted >= opts.limit)
+                    break;
+                const properties = feature.properties ?? {};
+                const region = slotValue(properties.component1_xlink_title);
+                const municipality = slotValue(properties.component2_xlink_title);
+                const settlement = slotValue(properties.component3_xlink_title);
+                const street = thoroughfareOf(properties);
+                const postcode = slotValue(properties.component6_xlink_title);
+                const locatorName = (properties.locator_addresslocator_name_locatorname_name_spelling_text ?? "").trim();
+                if (!municipality)
+                    continue;
+                if (!postcode && !settlement)
+                    continue;
+                const components = {};
+                if (street) {
+                    // A thoroughfare or an address area makes the locator name this feature's
+                    // number on that thoroughfare.
+                    if (locatorName) {
+                        components.house_number = locatorName;
+                    }
+                    components.street = street;
+                }
+                else if (locatorName) {
+                    // With no thoroughfare the locator name is the site or building name
+                    // that designates the addressable unit.
+                    // That is how a rural Estonian address works.
+                    components.venue = locatorName;
+                }
+                // The settlement unit sits inside the municipality, and Estonia writes it between
+                // the thoroughfare and the municipality in its own `alternativeidentifier`.
+                if (settlement) {
+                    components.dependent_locality = settlement;
+                }
+                if (postcode) {
+                    components.postcode = postcode;
+                }
+                components.locality = municipality;
+                if (region) {
+                    components.region = region;
+                }
+                const rendered = formatAddressRow(components, "EE", { singleLine: true });
+                if (!rendered)
+                    continue;
+                const { raw, components: aligned } = rendered;
+                const seed = String(properties.inspireid_identifier_localid ?? properties.gml_id ?? feature.id ?? "").trim();
+                const sourceID = seed ? `${ADS_ADAPTER_ID}-${seed}` : stableSourceID(ADS_ADAPTER_ID, aligned);
+                yield {
+                    raw,
+                    components: aligned,
+                    country: "EE",
+                    locale: "et-EE",
+                    source: ADS_ADAPTER_ID,
+                    source_id: sourceID,
+                    corpus_version: "",
+                    license: ADS_DEFAULT_LICENSE,
+                };
+                emitted++;
+            }
+        },
+    };
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const adsAdapter = createADSAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/ee/adapters/ads/adapter.js.map

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

package/out/ee/tools/fetch/ads.d.ts

@@ -0,0 +1,123 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * Harvests Estonia's INSPIRE Addresses (AD) theme into the newline-delimited JSON file that
+ * `#ee/adapters/ads/adapter` reads.
+ *
+ * Maa- ja Ruumiamet publishes the Aadressiandmete süsteem through GeoServer at
+ * {@linkcode EE_ADS_WFS}. The service's dataset record states Creative Commons CC0 1.0 in
+ * `otherConstraints`, which the address-source register elected under `spdx` `CC0-1.0`. CC0 reserves
+ * no act, so paging the service and storing what it returns is granted and the harvest needs no
+ * attribution clause.
+ *
+ * `#tools/fetch/inspire-addresses` owns the capabilities read and the GeoJSON page read, and
+ * `#tools/fetch/wfs-harvest` owns the appending, the manifest and the resumption. This module states
+ * what is particular to Estonia: four measurements taken on 2026-10-02:
+ *
+ * 1. The payload needs no component resolution. GeoServer flattens the application schema here, so
+ *    each `component<n>_xlink_href` has a sibling `component<n>_xlink_title` carrying the referenced
+ *    feature's value, and the adapter reads the titles. The harvest therefore takes one feature type
+ *    rather than the five a harmonized INSPIRE service splits an address across.
+ * 2. `resultType=hits` at `startIndex=1` reports `numberMatched="729973"` and a feature page reports
+ *    the same number, so this service's count is real. It is read through
+ *    `readCheckedWFSFeatureCount`, which proves the number against a page before a caller uses it,
+ *    and no count is written into this file.
+ * 3. The service honors a sort. `ImplementsSorting` is `TRUE`, `sortBy=gml_id` answers HTTP 200 and
+ *    `sortBy=gml_id D` returns the type's last features first. That proves the parameter is
+ *    applied rather than accepted and dropped. `sortBy=gml:identifier` and `sortBy=inspireId` answer
+ *    HTTP 400 `Illegal property name`, so the sort property is one of the flattened names.
+ * 4. A `count=10000` page of `application/json` is 31,198,909 bytes and takes about 6 seconds. At
+ *    729,973 features that is 73 pages and about 2.3 GB, plus three requests for the capabilities and
+ *    the checked count.
+ *
+ * The harvest writes one feature per line. The adapter can then stream the whole extract
+ * without holding a page. The `FeatureCollection` envelope is dropped: its counts describe one page
+ * and the manifest records them per page instead.
+ */
+import { type APIClient } from "@mailwoman/core/api";
+import type { PathBuilderLike } from "path-ts";
+import type { BaseFetchOptions, FetchSummary } from "#tools/fetch/download";
+import { type WFSHarvestManifest } from "#tools/fetch/wfs-harvest";
+/**
+ * The service this module harvests.
+ */
+export declare const EE_ADS_WFS = "https://inspire.geoportaal.ee/geoserver/AD_Address/wfs";
+/**
+ * The qualified name the service publishes its addresses under.
+ *
+ * Read from the capabilities document per run.
+ * This constant is the name a refusal quotes when the document stops publishing an Addresses type.
+ */
+export declare const EE_ADS_TYPE_NAME = "AD_Address:AD.Address";
+/**
+ * The property the pages are ordered by.
+ *
+ * A flattened property name, because the service refuses `gml:identifier`
+ * and `inspireId` with HTTP 400 `Illegal property name`.
+ */
+export declare const EE_ADS_SORT_BY = "gml_id";
+/**
+ * Features per page.
+ *
+ * The service's `CountDefault` is 1,000,000 and it honors `count=10000`, which is where the page
+ * size is set: a 10,000-feature page is 31,198,909 bytes, and a larger page buys fewer requests
+ * at the cost of holding a larger body in memory and losing more work when one request fails.
+ */
+export declare const EE_ADS_PAGE_SIZE = 10000;
+/**
+ * The file the adapter's `inputPath` points at, inside the harvest directory.
+ */
+export declare const EE_ADS_HARVEST_FILE = "address.jsonl";
+/**
+ * One page of features as newline-delimited JSON, one feature per line.
+ *
+ * A trailing newline on a non-empty page, so the next page's first feature starts its own line.
+ */
+export declare function featuresAsJSONL(features: readonly unknown[]): string;
+export interface HarvestADSOptions {
+    /**
+     * Where the harvest is written.
+     *
+     * The adapter reads {@linkcode EE_ADS_HARVEST_FILE} inside it.
+     */
+    outputDir: PathBuilderLike;
+    /**
+     * Features per page, defaulting to {@linkcode EE_ADS_PAGE_SIZE}.
+     */
+    pageSize?: number;
+    /**
+     * Stop once the manifest holds this many pages, for a probe rather than a full harvest.
+     */
+    maxPages?: number;
+    signal?: AbortSignal;
+    report?: (line: string) => void;
+}
+/**
+ * Harvests the service into `options.outputDir` and writes the manifest beside the data file.
+ *
+ * The capabilities document is read first, so the type name, the JSON format
+ * and the paging support come from the service rather than from this file.
+ * A service that stops publishing any of the three raises here rather than
+ * producing a harvest of the wrong thing.
+ *
+ * @returns The manifest as written.
+ */
+export declare function harvestADSEE(client: Pick<APIClient, "fetch">, options: HarvestADSOptions): Promise<WFSHarvestManifest>;
+export type FetchADSEEOptions = BaseFetchOptions & Pick<HarvestADSOptions, "maxPages" | "pageSize" | "signal"> & {
+    /**
+     * An injected client, for a test that supplies its own transport.
+     *
+     * A caller that leaves it out gets a paced client of this module's own.
+     */
+    client?: Pick<APIClient, "fetch">;
+};
+/**
+ * Harvests Estonia's addresses under `<outRoot>/ads/`, for `mailwoman corpus fetch ads-ee`.
+ *
+ * Re-runnable: a complete harvest whose file still hashes to the manifest's digest makes
+ * no request, and an interrupted one resumes at the page after the last that reached disk.
+ */
+export declare function fetchADSEE(options: FetchADSEEOptions, report?: (line: string) => void): Promise<FetchSummary>;
+//# sourceMappingURL=ads.d.ts.map

package/out/ee/tools/fetch/ads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ads.d.ts","sourceRoot":"","sources":["../../../../lib/ee/tools/fetch/ads.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAEH,OAAO,EAA8B,KAAK,SAAS,EAAmC,MAAM,qBAAqB,CAAA;AAEjH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAA;AAE9C,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AAE3E,OAAO,EAKN,KAAK,kBAAkB,EACvB,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,eAAO,MAAM,UAAU,2DAA2D,CAAA;AAElF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,0BAA0B,CAAA;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,WAAW,CAAA;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,QAAS,CAAA;AAEtC;;GAEG;AACH,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AA4BlD;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,GAAG,MAAM,CAIpE;AAED,MAAM,WAAW,iBAAiB;IACjC;;;;OAIG;IACH,SAAS,EAAE,eAAe,CAAA;IAC1B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CACjC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAChC,OAAO,EAAE,iBAAiB,GACxB,OAAO,CAAC,kBAAkB,CAAC,CAwE7B;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAC/C,IAAI,CAAC,iBAAiB,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC,GAAG;IAC7D;;;;OAIG;IACH,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAA;CACjC,CAAA;AAEF;;;;;GAKG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,EAAE,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,YAAY,CAAC,CAwBnH"}

package/out/ee/tools/fetch/ads.js

@@ -0,0 +1,197 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * Harvests Estonia's INSPIRE Addresses (AD) theme into the newline-delimited JSON file that
+ * `#ee/adapters/ads/adapter` reads.
+ *
+ * Maa- ja Ruumiamet publishes the Aadressiandmete süsteem through GeoServer at
+ * {@linkcode EE_ADS_WFS}. The service's dataset record states Creative Commons CC0 1.0 in
+ * `otherConstraints`, which the address-source register elected under `spdx` `CC0-1.0`. CC0 reserves
+ * no act, so paging the service and storing what it returns is granted and the harvest needs no
+ * attribution clause.
+ *
+ * `#tools/fetch/inspire-addresses` owns the capabilities read and the GeoJSON page read, and
+ * `#tools/fetch/wfs-harvest` owns the appending, the manifest and the resumption. This module states
+ * what is particular to Estonia: four measurements taken on 2026-10-02:
+ *
+ * 1. The payload needs no component resolution. GeoServer flattens the application schema here, so
+ *    each `component<n>_xlink_href` has a sibling `component<n>_xlink_title` carrying the referenced
+ *    feature's value, and the adapter reads the titles. The harvest therefore takes one feature type
+ *    rather than the five a harmonized INSPIRE service splits an address across.
+ * 2. `resultType=hits` at `startIndex=1` reports `numberMatched="729973"` and a feature page reports
+ *    the same number, so this service's count is real. It is read through
+ *    `readCheckedWFSFeatureCount`, which proves the number against a page before a caller uses it,
+ *    and no count is written into this file.
+ * 3. The service honors a sort. `ImplementsSorting` is `TRUE`, `sortBy=gml_id` answers HTTP 200 and
+ *    `sortBy=gml_id D` returns the type's last features first. That proves the parameter is
+ *    applied rather than accepted and dropped. `sortBy=gml:identifier` and `sortBy=inspireId` answer
+ *    HTTP 400 `Illegal property name`, so the sort property is one of the flattened names.
+ * 4. A `count=10000` page of `application/json` is 31,198,909 bytes and takes about 6 seconds. At
+ *    729,973 features that is 73 pages and about 2.3 GB, plus three requests for the capabilities and
+ *    the checked count.
+ *
+ * The harvest writes one feature per line. The adapter can then stream the whole extract
+ * without holding a page. The `FeatureCollection` envelope is dropped: its counts describe one page
+ * and the manifest records them per page instead.
+ */
+import { readCheckedWFSFeatureCount } from "@mailwoman/core/api";
+import { stringifyJSON } from "@mailwoman/core/json";
+import { readFeaturePage, readWFSCapabilities } from "#tools/fetch/inspire-addresses";
+import { harvestPagedWFS, runWFSHarvest, statedFeatureCount, } from "#tools/fetch/wfs-harvest";
+/**
+ * The service this module harvests.
+ */
+export const EE_ADS_WFS = "https://inspire.geoportaal.ee/geoserver/AD_Address/wfs";
+/**
+ * The qualified name the service publishes its addresses under.
+ *
+ * Read from the capabilities document per run.
+ * This constant is the name a refusal quotes when the document stops publishing an Addresses type.
+ */
+export const EE_ADS_TYPE_NAME = "AD_Address:AD.Address";
+/**
+ * The property the pages are ordered by.
+ *
+ * A flattened property name, because the service refuses `gml:identifier`
+ * and `inspireId` with HTTP 400 `Illegal property name`.
+ */
+export const EE_ADS_SORT_BY = "gml_id";
+/**
+ * Features per page.
+ *
+ * The service's `CountDefault` is 1,000,000 and it honors `count=10000`, which is where the page
+ * size is set: a 10,000-feature page is 31,198,909 bytes, and a larger page buys fewer requests
+ * at the cost of holding a larger body in memory and losing more work when one request fails.
+ */
+export const EE_ADS_PAGE_SIZE = 10_000;
+/**
+ * The file the adapter's `inputPath` points at, inside the harvest directory.
+ */
+export const EE_ADS_HARVEST_FILE = "address.jsonl";
+/**
+ * The adapter slug this module fetches for, and the directory it writes under.
+ */
+const SLUG = "ads";
+/**
+ * Names the service in every refusal this module raises.
+ */
+const CONTEXT = "ee ads wfs";
+/**
+ * The license the address-source register elected for this publisher.
+ */
+const LICENSE = "CC0-1.0";
+/**
+ * The spacing between requests.
+ *
+ * The service answers a 10,000-feature page in about 6 seconds, so this is not what limits the harvest.
+ * It bounds the harvest to one request per second against a government host
+ * whose published terms state no rate.
+ *
+ * The shorter requests (the capabilities and the count) would otherwise exceed that rate.
+ */
+const MIN_REQUEST_INTERVAL_MS = 1000;
+/**
+ * One page of features as newline-delimited JSON, one feature per line.
+ *
+ * A trailing newline on a non-empty page, so the next page's first feature starts its own line.
+ */
+export function featuresAsJSONL(features) {
+    if (!features.length)
+        return "";
+    return `${features.map((feature) => stringifyJSON(feature)).join("\n")}\n`;
+}
+/**
+ * Harvests the service into `options.outputDir` and writes the manifest beside the data file.
+ *
+ * The capabilities document is read first, so the type name, the JSON format
+ * and the paging support come from the service rather than from this file.
+ * A service that stops publishing any of the three raises here rather than
+ * producing a harvest of the wrong thing.
+ *
+ * @returns The manifest as written.
+ */
+export async function harvestADSEE(client, options) {
+    const capabilities = await readWFSCapabilities(client, { wfsURL: EE_ADS_WFS, context: CONTEXT });
+    const typeName = capabilities.typeNames.Address;
+    if (!typeName) {
+        throw new Error(`${CONTEXT}: the capabilities document publishes no Addresses feature type, so ${EE_ADS_TYPE_NAME} could not be confirmed`);
+    }
+    if (!capabilities.jsonFormat) {
+        throw new Error(`${CONTEXT}: the service advertises no JSON output format, and the adapter reads newline-delimited JSON — it advertises ${capabilities.outputFormats.join(", ")}`);
+    }
+    if (!capabilities.supportsPaging) {
+        throw new Error(`${CONTEXT}: the service does not advertise ImplementsResultPaging, and such a service answers every page with the first, so a paged harvest would store one page repeated`);
+    }
+    const countOptions = { wfsURL: EE_ADS_WFS, typeNames: typeName, context: CONTEXT };
+    // The cap comes from the service's own `CountDefault`, because a `numberMatched` equal
+    // to it cannot be told apart from the largest page the service will serve.
+    const featureCount = statedFeatureCount(await readCheckedWFSFeatureCount(client, countOptions), capabilities.countDefault);
+    options.report?.(`  Feature count: ${featureCount.count ?? "not stated"} — ${featureCount.because}`);
+    return harvestPagedWFS({
+        context: CONTEXT,
+        source: SLUG,
+        outputDir: options.outputDir,
+        filename: EE_ADS_HARVEST_FILE,
+        request: {
+            wfsURL: EE_ADS_WFS,
+            typeName,
+            outputFormat: capabilities.jsonFormat,
+            sortBy: EE_ADS_SORT_BY,
+        },
+        license: LICENSE,
+        // CC0 reserves no act, so the elected terms require none.
+        attribution: "",
+        featureCount,
+        pageSize: options.pageSize ?? EE_ADS_PAGE_SIZE,
+        maxPages: options.maxPages,
+        signal: options.signal,
+        report: options.report,
+        readPage: async ({ startIndex, count }) => {
+            const page = await readFeaturePage(client, {
+                wfsURL: EE_ADS_WFS,
+                typeName,
+                outputFormat: capabilities.jsonFormat ?? "",
+                count,
+                startIndex,
+                supportsPaging: capabilities.supportsPaging,
+                sortBy: EE_ADS_SORT_BY,
+                context: CONTEXT,
+            });
+            return {
+                payload: featuresAsJSONL(page.features),
+                numberReturned: page.numberReturned,
+                numberMatched: page.numberMatched,
+                retrievedAt: page.timeStamp,
+            };
+        },
+    });
+}
+/**
+ * Harvests Estonia's addresses under `<outRoot>/ads/`, for `mailwoman corpus fetch ads-ee`.
+ *
+ * Re-runnable: a complete harvest whose file still hashes to the manifest's digest makes
+ * no request, and an interrupted one resumes at the page after the last that reached disk.
+ */
+export async function fetchADSEE(options, report) {
+    const pageSize = options.pageSize ?? EE_ADS_PAGE_SIZE;
+    return runWFSHarvest({
+        slug: SLUG,
+        outRoot: options.outRoot,
+        filename: EE_ADS_HARVEST_FILE,
+        expect: { wfsURL: EE_ADS_WFS, sortBy: EE_ADS_SORT_BY, pageSize },
+        displayName: "ee-ads",
+        minRequestIntervalMs: MIN_REQUEST_INTERVAL_MS,
+        client: options.client,
+        maxPages: options.maxPages,
+        harvest: async (client) => harvestADSEE(client, {
+            outputDir: options.outRoot(SLUG),
+            pageSize,
+            maxPages: options.maxPages,
+            signal: options.signal,
+            report,
+        }),
+    }, report);
+}
+//# sourceMappingURL=ads.js.map

package/out/ee/tools/fetch/ads.js.map

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

package/out/env.d.ts

@@ -13,7 +13,9 @@ export declare const PublicCorpusEnvSchema: z.ZodObject<{
     MAILWOMAN_RESUME: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 /**
- * Credentials the corpus acquisition and golden-expansion tooling send. Never log their values.
+ * Credentials the corpus acquisition and golden-expansion tooling send.
+ *
+ * Never log their values.
  */
 export declare const PrivateCorpusEnvSchema: z.ZodObject<{
     OA_BATCH_TOKEN: z.ZodOptional<z.ZodString>;
@@ -36,7 +38,9 @@ export declare const $public: Record<never, never> & {
     MAILWOMAN_RESUME?: string | undefined;
 };
 /**
- * Live corpus credentials over core's. Never log their values.
+ * Live corpus credentials over core's.
+ *
+ * Never log their values.
  */
 export declare const $private: Record<never, never> & Record<string, never> & {
     OA_BATCH_TOKEN?: string | undefined;

package/out/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../lib/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;iBAKhC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB;;;;iBAejC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;CAA6C,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;CAA+C,CAAA"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../lib/env.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;GAEG;AACH,eAAO,MAAM,qBAAqB;;iBAKhC,CAAA;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;iBAejC,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;CAA6C,CAAA;AAEjE;;;;GAIG;AACH,eAAO,MAAM,QAAQ;;;;CAA+C,CAAA"}