@mailwoman/corpus 9.4.0 → 10.1.0

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

@@ -0,0 +1,225 @@
+/**
+ * @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 carries the whole province.
+ *
+ * The ATOM service at `https://b5m.gipuzkoa.eus/inspire/download/addresses.xml` is 4,469 bytes and
+ * holds a single entry for the province rather than one per municipality. That entry links its
+ * dataset through `rel="alternate"` and not `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 `ES.GFA.AD.zip` is 7,959,103 bytes and its one member `ES.GFA.AD.gml` is
+ * 313,162,472 bytes, a ratio of 39, so the member is read as a chunk sequence and never buffered.
+ *
+ * The member is self-contained and its order decides the reader. Counted over all 313,162,472 bytes:
+ * 68,744 `ad:Address`, 4,250 `ad:ThoroughfareName`, 178 `ad:PostalDescriptor` and 88
+ * `ad:AdminUnitName`, which is every one of the 73,260 `gml:featureMember` elements. The 4,516
+ * reference features are written last, beginning at byte 306,440,816. Holding an address until the
+ * document ends would therefore hold all 68,744, so the adapter reads the member twice through
+ * {@linkcode streamIndexedInspireRows} and indexes 4,516 features 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, which is why the predicate has one home.
+ *
+ * The locator vocabulary is one type. 68,743 of 68,744 addresses write exactly one designator, typed
+ * `LocatorDesignatorTypeValue/addressIdentifierGeneral`; one address writes none. The municipality is
+ * the only `ad:AdminUnitName` level published, `4thOrder`, and the province publishes 88 of them for
+ * its 88 municipalities.
+ *
+ * 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` is populated on 46,365 of 68,744 addresses and 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`
+ * on the ground that these name the building rather than its occupant, and it records that a Basque
+ * *baserri* name is commonly also a surname. Keeping them out of the corpus keeps that reading from
+ * resting on the stronger claim that the name is safe to publish as address text.
+ *
+ * No publisher-side rendering of a whole address was found for this source. `ad:alternativeIdentifier`
+ * is populated on all 68,744 addresses and holds a serial number such as `36798` rather than an
+ * address. What the file does state twice is the join: the address `gml:id`
+ * `ES.GFA.AD.056_1110_003` concatenates the municipality code `056`, the thoroughfare code `1110`
+ * and the number `003`, and the references it carries are `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, which is a check that the right features were joined rather than a
+ * check of 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, which the feed states 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 alone 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 `{refusal: "share-alike-carried"}`, 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 undefined when it carries 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();
+    if (voidDesignatorTypes(address).has(HOUSE_NUMBER_TYPE)) {
+        throw new VoidDesignatorError(ES_GIPUZKOA_ADAPTER_ID, addressID, HOUSE_NUMBER_TYPE);
+    }
+    let street;
+    let postcode;
+    let locality;
+    let settlement;
+    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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"}

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

@@ -0,0 +1,105 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `es-navarra`: the INSPIRE Addresses theme the Gobierno de Navarra publishes, read from its zipped
+ * GML partitions.
+ *
+ * The ATOM service at
+ * `https://filescartografia.navarra.es/2_CARTOGRAFIA_TEMATICA/2_7_CATASTRO/2_7_3_INSPIRE_ATOM/2_7_3_3_AD/Addresses_ServiceATOM_Navarra.xml`
+ * is 671,131 bytes and splits the province across 272 entries. Every entry is titled `Address
+ * Navarra`, so a partition cannot be selected by place from the feed alone. The three measured each
+ * turned out to hold one municipality, partition 1 Abáigar, partition 100 Eulate and partition 250
+ * Bera, but the feed states no such mapping and this adapter claims none. It reads one archive or a
+ * directory of them, which is how a caller harvests all 272.
+ *
+ * This publisher is read entirely from its references' titles, and that is what separates it from
+ * every other INSPIRE reader here. Its own file publishes no `AD:ThoroughfareName`,
+ * `AD:PostalDescriptor` or `AD:AdminUnitName` feature at all: partition 1 holds 29 distinct element
+ * names across 115 addresses and none of them is a component feature. Each address instead carries
+ * six `AD:component` references whose `xlink:title` states the value:
+ *
+ * | `xlink:href` | `xlink:title` | read as |
+ * | --- | --- | --- |
+ * | `…&ID=AD_ADMINUNITNAME_PAI_34000000000#…` | `España` | skipped |
+ * | `…&ID=AD_ADMINUNITNAME_COM_34150000000#…` | `Comunidad Foral de Navarra` | skipped |
+ * | `…&ID=AD_ADMINUNITNAME_MUN_34153131001#…` | `Abáigar` | the locality |
+ * | `http://inspire.ec.europa.eu/codelist/AdministrativeHierarchyLevel/5thOrder` | `Abáigar` | the settlement |
+ * | `ThoroughfareName` | `CALLE CALLEJA` | the street |
+ * | `PostalDescriptor` | `31280` | the postcode |
+ *
+ * The counts are exact and regular: 690 references over 115 addresses in partition 1, 1,728 over 288
+ * in partition 100 and 6,324 over 1,054 in partition 250, which is six per address in each, one of
+ * each shape above.
+ *
+ * The two place titles are not the same value. In Abáigar and Eulate the `5thOrder` title repeats the
+ * municipality, and in Bera it states a *concejo* the municipality contains: `Suspela` and `Dornaku`
+ * beside `Bera`. The fifth order is below the municipal fourth, so the title is written as a
+ * dependent locality where it differs from the municipality and left out where it repeats it.
+ *
+ * `Comunidad Foral de Navarra` is the autonomous community's own name rather than the province name a
+ * Spanish address writes, and the publisher's own address layer carries no region column, so no
+ * `region` is written.
+ *
+ * The publisher's own rendering is in a different service, and it agrees. `IDENA` publishes
+ * `IDENA:DIRECC_Txt_Direcciones`, 181,098 features, each with `MUNICIPIO`, `ENTIDAD`, `CODPOSTAL`,
+ * `VIA` and `PORTAL`. Partition 1's `AD.Address.1` composes `CALLE CALLEJA, 4, 31280 Abáigar`, and
+ * that layer's `DIRECC_Txt_Direcciones.1` reads `MUNICIPIO` `Abáigar`, `ENTIDAD` `Abáigar`,
+ * `CODPOSTAL` `31280`, `VIA` `CALLE CALLEJA`, `PORTAL` `4`. The adapter's integration test checks a
+ * sample of rows against that layer, which is this source's publisher-side oracle.
+ *
+ * Two values state an absence rather than a value. A `PostalDescriptor` title of `0` is the publisher
+ * holding no postcode, measured in Bera, and a designator of `S/N` is *sin número*, which
+ * `#es/cadastre` reads for all four Spanish cadastres. A designator may also carry a space-separated
+ * letter, `18 A` and `34 A` in Eulate, which is kept as the publisher wrote it.
+ */
+import { type MarkupElement } from "@mailwoman/core/html/elements";
+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_NAVARRA_ADAPTER_ID = "es-navarra";
+/**
+ * The jurisdiction this adapter emits.
+ */
+export declare const ES_NAVARRA_COUNTRIES: readonly string[];
+/**
+ * The license the address-source register elected for this publisher.
+ *
+ * Navarra states one license and states it in its own feed: the feed-level `rights` of
+ * `Addresses_ServiceATOM_Navarra.xml` reads `This layer is published under the terms of the license
+ * Creative Commons Attribution 4.0 International (CC BY 4.0)`, and all 272 of its entries repeat it.
+ * The version is stated, so the register records `CC-BY-4.0` as the SPDX identifier.
+ *
+ * The row carries that identifier rather than the license's title.
+ * `licenseVerdict` resolves an identifier and reads a title as unrecognized,
+ * and a row whose license resolves to no expression has unknown obligations
+ * rather than none, which the build reports separately from a refusal.
+ */
+export declare const ES_NAVARRA_LICENSE = "CC-BY-4.0";
+/**
+ * What one address's references state, read from their titles.
+ */
+interface ReferencedTitles {
+    street?: string;
+    postcode?: string;
+    locality?: string;
+    settlement?: string;
+}
+/**
+ * The street, postcode and place names an address's own references state.
+ *
+ * Each reference is placed by its href rather than by its position, because the six are written in one
+ * order in the three partitions measured and that order is the publisher's rather than the schema's.
+ */
+export declare function navarraReferencedTitles(address: MarkupElement): ReferencedTitles;
+export declare function createESNavarraAdapter(): CorpusAdapter;
+/**
+ * The configured adapter instance registered with the corpus builder.
+ */
+export declare const esNavarraAdapter: CorpusAdapter;
+export {};
+//# sourceMappingURL=adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/es/adapters/navarra/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,EAAE,KAAK,aAAa,EAAwB,MAAM,+BAA+B,CAAA;AAgBxF,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAW,CAAA;AAE7D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,kBAAkB,cAAc,CAAA;AAoD7C;;GAEG;AACH,UAAU,gBAAgB;IACzB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,gBAAgB,CAoBhF;AAED,wBAAgB,sBAAsB,IAAI,aAAa,CA2CtD;AAoDD;;GAEG;AACH,eAAO,MAAM,gBAAgB,eAA2B,CAAA"}

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

@@ -0,0 +1,241 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ * `es-navarra`: the INSPIRE Addresses theme the Gobierno de Navarra publishes, read from its zipped
+ * GML partitions.
+ *
+ * The ATOM service at
+ * `https://filescartografia.navarra.es/2_CARTOGRAFIA_TEMATICA/2_7_CATASTRO/2_7_3_INSPIRE_ATOM/2_7_3_3_AD/Addresses_ServiceATOM_Navarra.xml`
+ * is 671,131 bytes and splits the province across 272 entries. Every entry is titled `Address
+ * Navarra`, so a partition cannot be selected by place from the feed alone. The three measured each
+ * turned out to hold one municipality, partition 1 Abáigar, partition 100 Eulate and partition 250
+ * Bera, but the feed states no such mapping and this adapter claims none. It reads one archive or a
+ * directory of them, which is how a caller harvests all 272.
+ *
+ * This publisher is read entirely from its references' titles, and that is what separates it from
+ * every other INSPIRE reader here. Its own file publishes no `AD:ThoroughfareName`,
+ * `AD:PostalDescriptor` or `AD:AdminUnitName` feature at all: partition 1 holds 29 distinct element
+ * names across 115 addresses and none of them is a component feature. Each address instead carries
+ * six `AD:component` references whose `xlink:title` states the value:
+ *
+ * | `xlink:href` | `xlink:title` | read as |
+ * | --- | --- | --- |
+ * | `…&ID=AD_ADMINUNITNAME_PAI_34000000000#…` | `España` | skipped |
+ * | `…&ID=AD_ADMINUNITNAME_COM_34150000000#…` | `Comunidad Foral de Navarra` | skipped |
+ * | `…&ID=AD_ADMINUNITNAME_MUN_34153131001#…` | `Abáigar` | the locality |
+ * | `http://inspire.ec.europa.eu/codelist/AdministrativeHierarchyLevel/5thOrder` | `Abáigar` | the settlement |
+ * | `ThoroughfareName` | `CALLE CALLEJA` | the street |
+ * | `PostalDescriptor` | `31280` | the postcode |
+ *
+ * The counts are exact and regular: 690 references over 115 addresses in partition 1, 1,728 over 288
+ * in partition 100 and 6,324 over 1,054 in partition 250, which is six per address in each, one of
+ * each shape above.
+ *
+ * The two place titles are not the same value. In Abáigar and Eulate the `5thOrder` title repeats the
+ * municipality, and in Bera it states a *concejo* the municipality contains: `Suspela` and `Dornaku`
+ * beside `Bera`. The fifth order is below the municipal fourth, so the title is written as a
+ * dependent locality where it differs from the municipality and left out where it repeats it.
+ *
+ * `Comunidad Foral de Navarra` is the autonomous community's own name rather than the province name a
+ * Spanish address writes, and the publisher's own address layer carries no region column, so no
+ * `region` is written.
+ *
+ * The publisher's own rendering is in a different service, and it agrees. `IDENA` publishes
+ * `IDENA:DIRECC_Txt_Direcciones`, 181,098 features, each with `MUNICIPIO`, `ENTIDAD`, `CODPOSTAL`,
+ * `VIA` and `PORTAL`. Partition 1's `AD.Address.1` composes `CALLE CALLEJA, 4, 31280 Abáigar`, and
+ * that layer's `DIRECC_Txt_Direcciones.1` reads `MUNICIPIO` `Abáigar`, `ENTIDAD` `Abáigar`,
+ * `CODPOSTAL` `31280`, `VIA` `CALLE CALLEJA`, `PORTAL` `4`. The adapter's integration test checks a
+ * sample of rows against that layer, which is this source's publisher-side oracle.
+ *
+ * Two values state an absence rather than a value. A `PostalDescriptor` title of `0` is the publisher
+ * holding no postcode, measured in Bera, and a designator of `S/N` is *sin número*, which
+ * `#es/cadastre` reads for all four Spanish cadastres. A designator may also carry a space-separated
+ * letter, `18 A` and `34 A` in Eulate, which is kept as the publisher wrote it.
+ */
+import { streamMarkupElements } from "@mailwoman/core/html/elements";
+import { PathBuilder } from "path-ts";
+import { Globerator } from "spliterator/node/fs";
+import { UnsupportedCountryError } from "#adapters/errors";
+import { cadastralRow, spanishHouseNumber } from "#es/cadastre";
+import { codelistValue, componentJoinKey, componentLinks, designatorsByType, voidDesignatorTypes, } from "#inspire/address";
+import { inspireGMLChunks } from "#inspire/archive";
+import { VoidDesignatorError } from "#inspire/errors";
+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_NAVARRA_ADAPTER_ID = "es-navarra";
+/**
+ * The jurisdiction this adapter emits.
+ */
+export const ES_NAVARRA_COUNTRIES = ["ES"];
+/**
+ * The license the address-source register elected for this publisher.
+ *
+ * Navarra states one license and states it in its own feed: the feed-level `rights` of
+ * `Addresses_ServiceATOM_Navarra.xml` reads `This layer is published under the terms of the license
+ * Creative Commons Attribution 4.0 International (CC BY 4.0)`, and all 272 of its entries repeat it.
+ * The version is stated, so the register records `CC-BY-4.0` as the SPDX identifier.
+ *
+ * The row carries that identifier rather than the license's title.
+ * `licenseVerdict` resolves an identifier and reads a title as unrecognized,
+ * and a row whose license resolves to no expression has unknown obligations
+ * rather than none, which the build reports separately from a refusal.
+ */
+export const ES_NAVARRA_LICENSE = "CC-BY-4.0";
+/**
+ * The member of a partition's archive that holds the GML.
+ *
+ * Each archive ships one member, `AD_Navarra_<n>.gml`, so the extension selects
+ * it without the adapter knowing the partition number.
+ */
+const GML_MEMBER = /\.gml$/iu;
+/**
+ * The element each address is written as.
+ *
+ * The publisher binds the INSPIRE namespaces to upper-case prefixes.
+ */
+const ADDRESS_ELEMENT = "AD:Address";
+/**
+ * The designator type the publisher writes, on every address of the three partitions measured.
+ */
+const HOUSE_NUMBER_TYPE = "addressIdentifierGeneral";
+/**
+ * The reference href that states a street name in its title.
+ */
+const THOROUGHFARE_HREF = "thoroughfarename";
+/**
+ * The reference href that states a postcode in its title.
+ */
+const POSTAL_DESCRIPTOR_HREF = "postaldescriptor";
+/**
+ * The stored-query id prefix of the administrative-unit reference that is the municipality.
+ *
+ * The other two are `AD_ADMINUNITNAME_PAI_`, the country, and `AD_ADMINUNITNAME_COM_`,
+ * the autonomous community, and neither belongs to a written address.
+ */
+const MUNICIPALITY_ID_PREFIX = "AD_ADMINUNITNAME_MUN_";
+/**
+ * The administrative level whose title is a settlement within the municipality.
+ */
+const SETTLEMENT_LEVEL = "5thOrder";
+/**
+ * The postcode title that states that the publisher holds none.
+ *
+ * Measured in Bera, which writes `0` beside its `31780`.
+ */
+const NO_POSTCODE_TITLE = "0";
+/**
+ * The street, postcode and place names an address's own references state.
+ *
+ * Each reference is placed by its href rather than by its position, because the six are written in one
+ * order in the three partitions measured and that order is the publisher's rather than the schema's.
+ */
+export function navarraReferencedTitles(address) {
+    const titles = {};
+    for (const { href, title } of componentLinks(address)) {
+        if (!title)
+            continue;
+        const lowered = href.toLowerCase();
+        if (lowered === THOROUGHFARE_HREF) {
+            titles.street = title;
+        }
+        else if (lowered === POSTAL_DESCRIPTOR_HREF) {
+            titles.postcode = title === NO_POSTCODE_TITLE ? undefined : title;
+        }
+        else if (codelistValue(href) === SETTLEMENT_LEVEL) {
+            titles.settlement = title;
+        }
+        else if (componentJoinKey(href)?.startsWith(MUNICIPALITY_ID_PREFIX)) {
+            titles.locality = title;
+        }
+    }
+    return titles;
+}
+export function createESNavarraAdapter() {
+    return {
+        id: ES_NAVARRA_ADAPTER_ID,
+        defaultLicense: ES_NAVARRA_LICENSE,
+        addressRole: AddressRole.Premise,
+        register: SourceRegister.NavarraInspireAddresses,
+        surface: SurfaceOrigin.Rendered,
+        description: "INSPIRE Addresses (Gobierno de Navarra): house-number-level addresses for Navarra, as 272 zipped GML partitions.",
+        async *rows(opts) {
+            if (opts.country && !ES_NAVARRA_COUNTRIES.includes(opts.country)) {
+                throw new UnsupportedCountryError(ES_NAVARRA_ADAPTER_ID, ES_NAVARRA_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;
+                // The markup stream is read directly rather than through `#inspire/stream`,
+                // because this publisher writes no component feature for an address to reference.
+                // The index would stay empty and no address would ever be deferred.
+                for await (const address of streamMarkupElements(inspireGMLChunks(archivePath, GML_MEMBER), ADDRESS_ELEMENT, {
+                    xml: true,
+                })) {
+                    if (opts.signal?.aborted)
+                        break;
+                    if (opts.limit !== undefined && emitted >= opts.limit)
+                        break;
+                    const row = composeRow(address);
+                    if (!row)
+                        continue;
+                    yield row;
+                    emitted++;
+                }
+            }
+        },
+    };
+}
+/**
+ * One address's row, or undefined when it carries too little to render.
+ */
+function composeRow(address) {
+    const addressID = address.attributes["gml:id"]?.trim();
+    if (voidDesignatorTypes(address).has(HOUSE_NUMBER_TYPE)) {
+        throw new VoidDesignatorError(ES_NAVARRA_ADAPTER_ID, addressID, HOUSE_NUMBER_TYPE);
+    }
+    const { street, postcode, locality, settlement } = navarraReferencedTitles(address);
+    // Navarra's settlement is a fifth-order title, a *concejo* within the municipality, which
+    // `cadastralRow` writes as a dependent locality only where it differs from the municipality.
+    return cadastralRow({
+        street,
+        house: spanishHouseNumber(designatorsByType(address), HOUSE_NUMBER_TYPE),
+        postcode,
+        locality,
+        settlement,
+        addressID,
+    }, { adapterID: ES_NAVARRA_ADAPTER_ID, license: ES_NAVARRA_LICENSE });
+}
+/**
+ * Every archive under `inputPath`, which is one `.zip`, one unpacked `.gml`, or a directory holding either.
+ *
+ * A directory is the ordinary case, because the publisher ships 272 partitions
+ * and a caller harvesting the province points at the directory it fetched them into.
+ * 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_NAVARRA_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 esNavarraAdapter = createESNavarraAdapter();
+//# sourceMappingURL=adapter.js.map

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

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