@mailwoman/corpus 10.0.0 → 10.2.0

package/out/es/adapters/catastro/adapter.js

@@ -0,0 +1,290 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `es-catastro`: the INSPIRE Addresses theme the Dirección General del Catastro publishes, read
+ * from its per-municipality zipped GML.
+ *
+ * The ATOM service at `https://www.catastro.hacienda.gob.es/INSPIRE/Addresses/ES.SDGC.AD.atom.xml`
+ * lists 55 entries. 52 are the Dirección General del Catastro's own provinces. Three link the foral
+ * cadastres of Bizkaia, Gipuzkoa and Navarra. Those three state their own terms and have an adapter
+ * each. Every DGC entry links a province feed listing one zipped GML per municipality, so a caller
+ * harvests municipality by municipality and this adapter reads one archive or a directory of them.
+ *
+ * Three properties of the file decide the reader, and each of the three would silently empty a row
+ * if it were read the way the other INSPIRE publishers are read.
+ *
+ * The archive holds two members. `A.ES.SDGC.AD.<code>.gml` is the data and
+ * `A.ES.SDGC.AD.MD.<code>.xml` is its ISO 19139 metadata record. A member selector matching `.xml`
+ * therefore selects the metadata record. That record holds no `AD:Address` at all, so
+ * {@linkcode GML_MEMBER} matches the extension that holds the features.
+ *
+ * The GML declares `<?xml version="1.0" encoding="ISO-8859-1"?>` and is not valid UTF-8. Ceuta's
+ * 11,861,975-byte member holds 26 bytes above 0x7F, one of which is the `Ñ` of a street name.
+ * `streamMarkupElements` decodes with a UTF-8 `TextDecoder`. That decoder answers those bytes with
+ * U+FFFD. The bytes therefore pass through `decodeByteStream` first. {@linkcode assertLatin1Declaration}
+ * reads the declaration rather than trusting this note, because a publisher that re-encodes its
+ * output would otherwise have every accented name mojibaked under a reader that still claimed to be
+ * right.
+ *
+ * The file binds the INSPIRE namespaces to upper-case prefixes, `AD:Address` and `GN:text`, and
+ * states a designator type and an administrative level as element text rather than as a codelist
+ * URI. `#inspire/address` matches an element by its local name and accepts either form of a coded
+ * value, so the readers there serve this publisher. Only the element names this module passes to the
+ * markup stream hold the upper-case prefix.
+ *
+ * Each address references exactly three features by local `#` fragment, measured as 8,126 of 8,126
+ * addresses in Ceuta carrying one `ES.SDGC.PD`, one `ES.SDGC.TN` and one `ES.SDGC.AU` reference.
+ * Those features are written after the addresses — Ceuta's 511 of them sit in the last 530,000 bytes
+ * of the member — so the adapter reads the member twice through
+ * {@linkcode streamIndexedInspireRows} rather than holding every address until the document ends.
+ *
+ * The number is one designator, typed `1`. The publisher's own rendering fixes what that type means
+ * and what the value `S-N` means. `Consulta_DNPRC` on the OVC web service answers a cadastral
+ * reference with the address the Cadastre holds for it, as `<ldt>`, plus the fields it is built
+ * from: `tv` the street-type abbreviation, `nv` the street name, `pnp` the number, `plp` its letter,
+ * `dp` the postcode and `nm` the municipality. The cadastral reference is the tail of the address's
+ * own `gml:id`, so every row this adapter writes can be put beside the publisher's own line:
+ *
+ * | `gml:id` tail | designator | `<ldt>` |
+ * | --- | --- | --- |
+ * | `9744803TE8794S` | `13` | `CL SANTIAGO APOSTOL 13 51002 CEUTA (CEUTA)` |
+ * | `9745701TE8794S` | `13D` | `CL SANTIAGO APOSTOL 13(D) 51002 CEUTA (CEUTA)` |
+ *
+ * So the designator is `pnp` with `plp` appended, and the street is `tv` followed by `nv`. That
+ * street matches the `AD:ThoroughfareName` text verbatim once its leading space is trimmed. The
+ * abbreviation stays in the street component because the publisher writes it in its own rendered
+ * line. `Calle` would state something the Cadastre did not.
+ *
+ * `S-N` is *sin número*, the publisher stating that the address has no number, and it is 856 of
+ * Ceuta's 8,126 designators. A row carrying it writes no `house_number`, because the string is a
+ * statement about the number rather than a number.
+ *
+ * One reference form states an absence the same way. The postal-descriptor reference's final segment
+ * is the postcode, and 70 of Ceuta's 8,126 addresses write `#ES.SDGC.PD.55.101.` with that segment
+ * empty, against five `AD:PostalDescriptor` features the file does publish. Those 70 are the only
+ * unresolvable references in the member: the thoroughfare and administrative-unit references resolve
+ * 8,126 of 8,126 each. A reference whose final segment is empty is therefore read as the publisher
+ * holding no value for that component, and every other unresolved reference raises.
+ */
+import { decodeByteStream } from "@mailwoman/core/fs/streams";
+import { stringifyJSON } from "@mailwoman/core/json";
+import { PathBuilder } from "path-ts";
+import { Globerator } from "spliterator/node/fs";
+import { UnsupportedCountryError } from "#adapters/errors";
+import { cadastralRow, referenceStatesNoValue, spanishHouseNumber } from "#es/cadastre";
+import { adminUnitLevel, componentHrefs, componentJoinKey, designatorsByType, inspireNameIs, placeName, postalDescriptorCode, thoroughfareName, voidDesignatorTypes, } from "#inspire/address";
+import { inspireGMLChunks } from "#inspire/archive";
+import { UnresolvedComponentReferenceError, VoidDesignatorError } from "#inspire/errors";
+import { streamIndexedInspireRows } from "#inspire/stream";
+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 ES_CATASTRO_ADAPTER_ID = "es-catastro";
+/**
+ * The jurisdiction this adapter emits.
+ *
+ * The 52 province feeds cover peninsular Spain, the Balearics, the Canaries, Ceuta and Melilla.
+ * The three Basque provinces and Navarra keep their own cadastres and their own adapters.
+ */
+export const ES_CATASTRO_COUNTRIES = ["ES"];
+/**
+ * The license the address-source register elected for this publisher.
+ *
+ * The register elects the titled instrument, `Licencia de acceso y uso de los servicios y conjuntos
+ * de datos INSPIRE de la Dirección General del Catastro` at version 1.0, rather than the older
+ * `all rights reserved` template the feed still shows. No Creative Commons label or SPDX identifier
+ * covers that instrument, so the row records the instrument's own title.
+ *
+ * The register reads `refused` for `redistribute-data`: clause 1 withholds distribution
+ * of the information as supplied, and requires transformation before any public use.
+ * Ingest, transformation and training are permitted, and this adapter performs those.
+ */
+export const ES_CATASTRO_LICENSE = "Licencia de acceso y uso de los servicios y conjuntos de datos INSPIRE de la Dirección General del Catastro";
+/**
+ * The member of a municipality's archive that holds the GML.
+ *
+ * The archive ships two members and the other is `A.ES.SDGC.AD.MD.<code>.xml`,
+ * the ISO 19139 metadata record.
+ * A selector matching `.xml` reads that record.
+ * That record holds no `AD:Address`.
+ */
+const GML_MEMBER = /\.gml$/iu;
+/**
+ * The encoding the publisher declares and writes.
+ */
+const DECLARED_ENCODING = "iso-8859-1";
+/**
+ * The feature types an address references, indexed in the first pass over the member.
+ *
+ * `AD:AddressAreaName` is listed although Ceuta publishes none, because the schema admits one and a
+ * municipality that writes one would otherwise have its settlement part read as an unresolved reference.
+ */
+const COMPONENT_ELEMENTS = [
+    "AD:ThoroughfareName",
+    "AD:PostalDescriptor",
+    "AD:AdminUnitName",
+    "AD:AddressAreaName",
+];
+/**
+ * The element each address is written as.
+ */
+const ADDRESS_ELEMENT = "AD:Address";
+/**
+ * The administrative level that is the municipality.
+ *
+ * The publisher writes `<AD:level>4</AD:level>` as text where the other INSPIRE publishers
+ * write the `AdministrativeHierarchyLevel/4thOrder` codelist URI, so both spellings
+ * are accepted and a reference to a coarser unit is left out of the row.
+ */
+const MUNICIPALITY_LEVELS = new Set(["4", "4thOrder"]);
+/**
+ * The designator type the publisher writes on every address.
+ *
+ * Measured over Ceuta: 8,126 of 8,126 addresses hold exactly one designator,
+ * and its `AD:type` is the text `1`.
+ * The value is the house number.
+ *
+ * `Consulta_DNPRC`'s `pnp` and `plp` fields confirm that for the two addresses
+ * tabulated in this module's header.
+ */
+const HOUSE_NUMBER_TYPE = "1";
+/**
+ * Raises unless the member declares the encoding this reader decodes it from.
+ *
+ * The declaration is the publisher's statement about its own bytes, and a reader that assumed ISO-8859-1
+ * through a change to UTF-8 would mojibake every accented street name while reporting success.
+ * A member that states no encoding is accepted, because XML's default is UTF-8
+ * and ISO-8859-1 decoding of ASCII bytes is the same text.
+ */
+async function* assertLatin1Declaration(chunks, archivePath) {
+    let first = true;
+    for await (const chunk of chunks) {
+        if (first) {
+            first = false;
+            const declaration = /<\?xml[^>]*encoding="([^"]+)"/iu.exec(Buffer.from(chunk.subarray(0, 512)).toString("latin1"));
+            const declared = declaration?.[1]?.toLowerCase();
+            if (declared && declared !== DECLARED_ENCODING) {
+                throw new TypeError(`${ES_CATASTRO_ADAPTER_ID} adapter: ${archivePath.toString()} declares encoding ` +
+                    `${stringifyJSON(declaration?.[1])}, and this reader decodes ${stringifyJSON(DECLARED_ENCODING)}`);
+            }
+        }
+        yield chunk;
+    }
+}
+/**
+ * One archive member's bytes, re-encoded into the UTF-8 the markup reader decodes.
+ */
+function memberChunks(archivePath) {
+    return decodeByteStream(assertLatin1Declaration(inspireGMLChunks(archivePath, GML_MEMBER), archivePath), DECLARED_ENCODING);
+}
+export function createESCatastroAdapter() {
+    return {
+        id: ES_CATASTRO_ADAPTER_ID,
+        defaultLicense: ES_CATASTRO_LICENSE,
+        addressRole: AddressRole.Premise,
+        register: SourceRegister.CatastroInspireAddresses,
+        surface: SurfaceOrigin.Rendered,
+        description: "INSPIRE Addresses (Dirección General del Catastro): house-number-level addresses for Spain outside the foral cadastres, one zipped GML per municipality.",
+        async *rows(opts) {
+            if (opts.country && !ES_CATASTRO_COUNTRIES.includes(opts.country)) {
+                throw new UnsupportedCountryError(ES_CATASTRO_ADAPTER_ID, ES_CATASTRO_COUNTRIES, opts.country);
+            }
+            let emitted = 0;
+            // One archive per municipality, each a document whose references resolve inside it.
+            for (const archivePath of await archivePaths(opts.inputPath)) {
+                if (opts.signal?.aborted)
+                    break;
+                if (opts.limit !== undefined && emitted >= opts.limit)
+                    break;
+                for await (const row of streamIndexedInspireRows({
+                    chunks: () => memberChunks(archivePath),
+                    addressElement: ADDRESS_ELEMENT,
+                    componentElements: COMPONENT_ELEMENTS,
+                    // The subtree is kept, because one feature answers a street, a postcode
+                    // or a place name depending on which type it is.
+                    index: (feature) => feature,
+                    compose: composeRow,
+                    limit: opts.limit === undefined ? undefined : opts.limit - emitted,
+                    signal: opts.signal,
+                })) {
+                    yield row;
+                    emitted++;
+                }
+            }
+        },
+    };
+}
+/**
+ * One address's row, or null when it holds too little to render.
+ *
+ * The reference index is complete before this is called, so a reference resolving to no
+ * feature is a value the reader asked for and could not read, and it raises.
+ */
+function composeRow(address, referenced) {
+    const addressID = address.attributes["gml:id"]?.trim() ?? null;
+    if (voidDesignatorTypes(address).has(HOUSE_NUMBER_TYPE)) {
+        throw new VoidDesignatorError(ES_CATASTRO_ADAPTER_ID, addressID, HOUSE_NUMBER_TYPE);
+    }
+    let street = null;
+    let postcode = null;
+    let locality = null;
+    let settlement = null;
+    for (const href of componentHrefs(address)) {
+        const key = componentJoinKey(href);
+        if (key && referenceStatesNoValue(key))
+            continue;
+        const feature = key ? referenced.get(key) : undefined;
+        if (!feature)
+            throw new UnresolvedComponentReferenceError(ES_CATASTRO_ADAPTER_ID, addressID, href);
+        const name = feature.name;
+        if (inspireNameIs(name, "ad:ThoroughfareName")) {
+            street = thoroughfareName(feature);
+        }
+        else if (inspireNameIs(name, "ad:PostalDescriptor")) {
+            postcode = postalDescriptorCode(feature);
+        }
+        else if (inspireNameIs(name, "ad:AddressAreaName")) {
+            settlement = placeName(feature);
+        }
+        else if (inspireNameIs(name, "ad:AdminUnitName") && MUNICIPALITY_LEVELS.has(adminUnitLevel(feature) ?? "")) {
+            locality = placeName(feature);
+        }
+    }
+    return cadastralRow({
+        street,
+        house: spanishHouseNumber(designatorsByType(address), HOUSE_NUMBER_TYPE),
+        postcode,
+        locality,
+        settlement,
+        addressID,
+    }, { adapterID: ES_CATASTRO_ADAPTER_ID, license: ES_CATASTRO_LICENSE });
+}
+/**
+ * Every archive under `inputPath`, which is one `.zip` or a directory holding them.
+ *
+ * A directory holding no archive raises rather than yielding zero rows, so a wrong
+ * path reports itself instead of reading as an empty publisher.
+ */
+async function archivePaths(inputPath) {
+    const path = PathBuilder.from(inputPath);
+    if (path.basename().toLowerCase().endsWith(".zip"))
+        return [path];
+    if (path.basename().toLowerCase().endsWith(".gml"))
+        return [path];
+    const names = await Globerator.from("*.{zip,gml}", { cwd: path.toString(), absolute: false }).toSorted();
+    if (!names.length) {
+        throw new Error(`${ES_CATASTRO_ADAPTER_ID} adapter: ${path.toString()} holds no .zip archive`);
+    }
+    return names.map((name) => path(name));
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const esCatastroAdapter = createESCatastroAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/es/adapters/catastro/adapter.js.map

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

package/out/es/adapters/gipuzkoa/adapter.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `es-gipuzkoa`: the INSPIRE Addresses theme the Diputación Foral de Gipuzkoa publishes, read from
+ * the one zipped GML that holds the whole province.
+ *
+ * The ATOM service at `https://b5m.gipuzkoa.eus/inspire/download/addresses.xml` holds a single entry
+ * for the province and links its dataset through `rel="alternate"` rather than `rel="enclosure"`, so
+ * a fetcher that looks only for an enclosure finds no dataset here. The adapter is handed the
+ * archive and the feed is acquisition's concern. The archive holds one 313 MB GML member. The
+ * adapter reads that member as a chunk sequence and never buffers it.
+ *
+ * The member is self-contained and its order decides the reader. Addresses number 68,744, and the
+ * 4,516 reference features they point at are written last. An address held until the document ends
+ * would keep all 68,744 pending, so the adapter reads the member twice through
+ * {@linkcode streamIndexedInspireRows} and indexes the 4,516 references instead.
+ *
+ * A reference is a WFS stored-query URL whose `ID` parameter equals the target's `gml:id`, written
+ * against the internal host `http://b5mdev/` and with the id repeated as the URL's fragment:
+ * `…?…&ID=ES.GFA.TN.056.1110#ES.GFA.TN.056.1110`. `componentJoinKey` reads the parameter and the
+ * fragment belongs to the URL rather than to the id, so the key is `ES.GFA.TN.056.1110`. The
+ * unreachable host is not this reader's problem, because every reference resolves inside the member.
+ *
+ * A postal-descriptor reference whose final segment is empty, `…&ID=ES.GFA.PD.059. #…`, states that
+ * the publisher holds no postcode, and `referenceStatesNoValue` separates it from a broken join.
+ * The Cadastre writes the same form. The predicate therefore has one home.
+ *
+ * The locator vocabulary is one type,
+ * `LocatorDesignatorTypeValue/addressIdentifierGeneral`. The municipality is the only
+ * `ad:AdminUnitName` level published, `4thOrder`.
+ *
+ * The publisher writes its street names in Basque, with the street type as a trailing word rather
+ * than a leading abbreviation: `Samikolla ibilbidea`. The name is taken as written.
+ *
+ * `ad:LocatorName` holds a building name as a Basque and Spanish pair, `Gasolinera` with
+ * `Gasolindegia` and `Agirre, baserria` with `Agirre, caserío`. The adapter writes none of them: the
+ * address-source register's personal-data review reads `absent` because these identify the building
+ * rather than its occupant, and a Basque *baserri* name is commonly also a surname. The review
+ * therefore does not rest on the stronger claim that the name is safe to publish as address text.
+ *
+ * The address `gml:id` `ES.GFA.AD.056_1110_003` concatenates the municipality code `056`, the
+ * thoroughfare code `1110` and the number `003`, and holds references
+ * `AU_ADMINISTRATIVEUNIT_34162020056`, `ES.GFA.TN.056.1110` and `ES.GFA.PD.056.20830`. The
+ * adapter's test checks the composed street and number against that identifier. That check confirms
+ * the right features were joined. It does not check the address the publisher would print.
+ */
+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 ES_GIPUZKOA_ADAPTER_ID = "es-gipuzkoa";
+/**
+ * The jurisdiction this adapter emits.
+ *
+ * Coverage is the province of Gipuzkoa.
+ * The feed states that as the dataset's whole extent.
+ */
+export declare const ES_GIPUZKOA_COUNTRIES: readonly string[];
+/**
+ * The license the address-source register elected for this publisher.
+ *
+ * Gipuzkoa states four things, and the register elects the one addressing this dataset:
+ * the `otherConstraints` of its ISO 19139 dataset record, `CC BY-SA 4.0`.
+ * Its feed states attribution only and its website states CC BY 4.0, and the register records
+ * why the stricter reading is the one to err towards: the share-alike filter reads this label,
+ * so recording CC BY 4.0 would hide an obligation the publisher may hold.
+ *
+ * The value is the SPDX identifier the register elected rather than the license's title,
+ * because `licenseVerdict` resolves an identifier and reads a title as unrecognized.
+ * Under `LicensePolicy.ShareAlikeFree` the title returns `{refusal: null, mentionsShareAlike: false}`
+ * and `CC-BY-SA-4.0` returns a share-alike refusal, so the title admits these rows
+ * to a corpus assembled to hold no share-alike source.
+ */
+export declare const ES_GIPUZKOA_LICENSE = "CC-BY-SA-4.0";
+export declare function createESGipuzkoaAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const esGipuzkoaAdapter: CorpusAdapter;
+//# sourceMappingURL=adapter.d.ts.map

package/out/es/adapters/gipuzkoa/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/gipuzkoa/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AAuBH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,gBAAgB,CAAA;AAEnD;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAA;AAkCjD,wBAAgB,uBAAuB,IAAI,aAAa,CAqCvD;AA+ED;;GAEG;AACH,eAAO,MAAM,iBAAiB,eAA4B,CAAA"}

package/out/es/adapters/gipuzkoa/adapter.js

@@ -0,0 +1,218 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `es-gipuzkoa`: the INSPIRE Addresses theme the Diputación Foral de Gipuzkoa publishes, read from
+ * the one zipped GML that holds the whole province.
+ *
+ * The ATOM service at `https://b5m.gipuzkoa.eus/inspire/download/addresses.xml` holds a single entry
+ * for the province and links its dataset through `rel="alternate"` rather than `rel="enclosure"`, so
+ * a fetcher that looks only for an enclosure finds no dataset here. The adapter is handed the
+ * archive and the feed is acquisition's concern. The archive holds one 313 MB GML member. The
+ * adapter reads that member as a chunk sequence and never buffers it.
+ *
+ * The member is self-contained and its order decides the reader. Addresses number 68,744, and the
+ * 4,516 reference features they point at are written last. An address held until the document ends
+ * would keep all 68,744 pending, so the adapter reads the member twice through
+ * {@linkcode streamIndexedInspireRows} and indexes the 4,516 references instead.
+ *
+ * A reference is a WFS stored-query URL whose `ID` parameter equals the target's `gml:id`, written
+ * against the internal host `http://b5mdev/` and with the id repeated as the URL's fragment:
+ * `…?…&ID=ES.GFA.TN.056.1110#ES.GFA.TN.056.1110`. `componentJoinKey` reads the parameter and the
+ * fragment belongs to the URL rather than to the id, so the key is `ES.GFA.TN.056.1110`. The
+ * unreachable host is not this reader's problem, because every reference resolves inside the member.
+ *
+ * A postal-descriptor reference whose final segment is empty, `…&ID=ES.GFA.PD.059. #…`, states that
+ * the publisher holds no postcode, and `referenceStatesNoValue` separates it from a broken join.
+ * The Cadastre writes the same form. The predicate therefore has one home.
+ *
+ * The locator vocabulary is one type,
+ * `LocatorDesignatorTypeValue/addressIdentifierGeneral`. The municipality is the only
+ * `ad:AdminUnitName` level published, `4thOrder`.
+ *
+ * The publisher writes its street names in Basque, with the street type as a trailing word rather
+ * than a leading abbreviation: `Samikolla ibilbidea`. The name is taken as written.
+ *
+ * `ad:LocatorName` holds a building name as a Basque and Spanish pair, `Gasolinera` with
+ * `Gasolindegia` and `Agirre, baserria` with `Agirre, caserío`. The adapter writes none of them: the
+ * address-source register's personal-data review reads `absent` because these identify the building
+ * rather than its occupant, and a Basque *baserri* name is commonly also a surname. The review
+ * therefore does not rest on the stronger claim that the name is safe to publish as address text.
+ *
+ * The address `gml:id` `ES.GFA.AD.056_1110_003` concatenates the municipality code `056`, the
+ * thoroughfare code `1110` and the number `003`, and holds references
+ * `AU_ADMINISTRATIVEUNIT_34162020056`, `ES.GFA.TN.056.1110` and `ES.GFA.PD.056.20830`. The
+ * adapter's test checks the composed street and number against that identifier. That check confirms
+ * the right features were joined. It does not check the address the publisher would print.
+ */
+import { PathBuilder } from "path-ts";
+import { Globerator } from "spliterator/node/fs";
+import { UnsupportedCountryError } from "#adapters/errors";
+import { cadastralRow, referenceStatesNoValue, spanishHouseNumber } from "#es/cadastre";
+import { adminUnitLevel, componentHrefs, componentJoinKey, designatorsByType, inspireNameIs, placeName, postalDescriptorCode, thoroughfareName, voidDesignatorTypes, } from "#inspire/address";
+import { inspireGMLChunks } from "#inspire/archive";
+import { UnresolvedComponentReferenceError, VoidDesignatorError } from "#inspire/errors";
+import { streamIndexedInspireRows } from "#inspire/stream";
+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 ES_GIPUZKOA_ADAPTER_ID = "es-gipuzkoa";
+/**
+ * The jurisdiction this adapter emits.
+ *
+ * Coverage is the province of Gipuzkoa.
+ * The feed states that as the dataset's whole extent.
+ */
+export const ES_GIPUZKOA_COUNTRIES = ["ES"];
+/**
+ * The license the address-source register elected for this publisher.
+ *
+ * Gipuzkoa states four things, and the register elects the one addressing this dataset:
+ * the `otherConstraints` of its ISO 19139 dataset record, `CC BY-SA 4.0`.
+ * Its feed states attribution only and its website states CC BY 4.0, and the register records
+ * why the stricter reading is the one to err towards: the share-alike filter reads this label,
+ * so recording CC BY 4.0 would hide an obligation the publisher may hold.
+ *
+ * The value is the SPDX identifier the register elected rather than the license's title,
+ * because `licenseVerdict` resolves an identifier and reads a title as unrecognized.
+ * Under `LicensePolicy.ShareAlikeFree` the title returns `{refusal: null, mentionsShareAlike: false}`
+ * and `CC-BY-SA-4.0` returns a share-alike refusal, so the title admits these rows
+ * to a corpus assembled to hold no share-alike source.
+ */
+export const ES_GIPUZKOA_LICENSE = "CC-BY-SA-4.0";
+/**
+ * The member of the archive that holds the GML.
+ *
+ * The archive ships one member, so the extension selects it without the adapter naming it.
+ */
+const GML_MEMBER = /\.gml$/iu;
+/**
+ * The feature types an address references, indexed in the first pass over the member.
+ *
+ * `ad:AddressAreaName` is listed although the province publishes none, because the schema admits one
+ * and a future edition that wrote one would otherwise read as an unresolved reference.
+ */
+const COMPONENT_ELEMENTS = [
+    "ad:ThoroughfareName",
+    "ad:PostalDescriptor",
+    "ad:AdminUnitName",
+    "ad:AddressAreaName",
+];
+/**
+ * The administrative level that is the municipality.
+ *
+ * The only level the province publishes, on 88 of 88 `ad:AdminUnitName` features.
+ */
+const MUNICIPALITY_LEVEL = "4thOrder";
+/**
+ * The designator type the publisher writes.
+ */
+const HOUSE_NUMBER_TYPE = "addressIdentifierGeneral";
+export function createESGipuzkoaAdapter() {
+    return {
+        id: ES_GIPUZKOA_ADAPTER_ID,
+        defaultLicense: ES_GIPUZKOA_LICENSE,
+        addressRole: AddressRole.Premise,
+        register: SourceRegister.GipuzkoaInspireAddresses,
+        surface: SurfaceOrigin.Rendered,
+        description: "INSPIRE Addresses (Diputación Foral de Gipuzkoa): house-number-level addresses for the province, as one zipped GML.",
+        async *rows(opts) {
+            if (opts.country && !ES_GIPUZKOA_COUNTRIES.includes(opts.country)) {
+                throw new UnsupportedCountryError(ES_GIPUZKOA_ADAPTER_ID, ES_GIPUZKOA_COUNTRIES, opts.country);
+            }
+            let emitted = 0;
+            for (const archivePath of await archivePaths(opts.inputPath)) {
+                if (opts.signal?.aborted)
+                    break;
+                if (opts.limit !== undefined && emitted >= opts.limit)
+                    break;
+                for await (const row of streamIndexedInspireRows({
+                    chunks: () => inspireGMLChunks(archivePath, GML_MEMBER),
+                    componentElements: COMPONENT_ELEMENTS,
+                    index: (feature) => feature,
+                    compose: composeRow,
+                    limit: opts.limit === undefined ? undefined : opts.limit - emitted,
+                    signal: opts.signal,
+                })) {
+                    yield row;
+                    emitted++;
+                }
+            }
+        },
+    };
+}
+/**
+ * One address's row, or null when it holds too little to render.
+ *
+ * The reference index is complete before this is called, so a reference resolving to no
+ * feature is a value the reader asked for and could not read, and it raises.
+ */
+function composeRow(address, referenced) {
+    const addressID = address.attributes["gml:id"]?.trim() ?? null;
+    if (voidDesignatorTypes(address).has(HOUSE_NUMBER_TYPE)) {
+        throw new VoidDesignatorError(ES_GIPUZKOA_ADAPTER_ID, addressID, HOUSE_NUMBER_TYPE);
+    }
+    let street = null;
+    let postcode = null;
+    let locality = null;
+    let settlement = null;
+    for (const href of componentHrefs(address)) {
+        const key = componentJoinKey(href);
+        if (key && referenceStatesNoValue(key))
+            continue;
+        const feature = key ? referenced.get(key) : undefined;
+        if (!feature)
+            throw new UnresolvedComponentReferenceError(ES_GIPUZKOA_ADAPTER_ID, addressID, href);
+        const name = feature.name;
+        if (inspireNameIs(name, "ad:ThoroughfareName")) {
+            street = thoroughfareName(feature);
+        }
+        else if (inspireNameIs(name, "ad:PostalDescriptor")) {
+            postcode = postalDescriptorCode(feature);
+        }
+        else if (inspireNameIs(name, "ad:AddressAreaName")) {
+            settlement = placeName(feature);
+        }
+        else if (inspireNameIs(name, "ad:AdminUnitName") && adminUnitLevel(feature) === MUNICIPALITY_LEVEL) {
+            locality = placeName(feature);
+        }
+    }
+    return cadastralRow({
+        street,
+        house: spanishHouseNumber(designatorsByType(address), HOUSE_NUMBER_TYPE),
+        postcode,
+        locality,
+        settlement,
+        addressID,
+    }, { adapterID: ES_GIPUZKOA_ADAPTER_ID, license: ES_GIPUZKOA_LICENSE });
+}
+/**
+ * Every archive under `inputPath`, which is one `.zip`, one unpacked `.gml`, or a directory holding either.
+ *
+ * The publisher ships one archive, and the unpacked member is accepted because an
+ * operator who inflated 313,162,472 bytes once should not have to inflate them again,
+ * and because a committed fixture is reviewable only as text.
+ * A directory holding neither raises rather than yielding zero rows, so a wrong path
+ * reports itself instead of reading as an empty publisher.
+ */
+async function archivePaths(inputPath) {
+    const path = PathBuilder.from(inputPath);
+    const basename = path.basename().toLowerCase();
+    if (basename.endsWith(".zip") || basename.endsWith(".gml"))
+        return [path];
+    const names = await Globerator.from("*.{zip,gml}", { cwd: path.toString(), absolute: false }).toSorted();
+    if (!names.length) {
+        throw new Error(`${ES_GIPUZKOA_ADAPTER_ID} adapter: ${path.toString()} holds no .zip archive or .gml member`);
+    }
+    return names.map((name) => path(name));
+}
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export const esGipuzkoaAdapter = createESGipuzkoaAdapter();
+//# sourceMappingURL=adapter.js.map

package/out/es/adapters/gipuzkoa/adapter.js.map

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