@mailwoman/corpus 10.1.0 → 10.2.1

package/out/es/tools/fetch/navarra.js

@@ -15,11 +15,11 @@
  * Four properties of this service decide the harvest's shape.
  *
  * 1. **The archive link is the `enclosure` link, and the `alternate` link is not it.** Each entry
- *    carries six links, three of which address the same archive under `enclosure`, `section` and
+ *    lists six links, three of which address the same archive under `enclosure`, `section` and
  *    `alternate`. The entry's *first* `alternate` link is the relative href
  *    `Addresses_DatasetATOM_Navarra.xml`, which is the dataset feed, so a reader taking the first
  *    `alternate` link downloads an ATOM document in place of the archive. This harvest takes
- *    `enclosure` and refuses an entry that carries none.
+ *    `enclosure` and refuses an entry that lists none.
  * 2. **An entry leaves its own area unstated.** Every one of the 272 entries is titled
  *    `Address Navarra` and every `<id>` is empty, so the archive's own file name,
  *    `AD_Navarra_<n>.gml.zip`, is the only statement of which partition an entry offers. The
@@ -46,7 +46,7 @@
  */
 import { APIClient, assertNoOGCServiceException } from "@mailwoman/core/api";
 import { ByteFormatter } from "@mailwoman/core/fs/formatters";
-import { tryStat } from "@mailwoman/core/fs/readers";
+import { tryStat } from "@mailwoman/core/fs/readers/stat";
 import { makeDirectories } from "@mailwoman/core/fs/writers";
 import { sha256File } from "@mailwoman/core/hash";
 import { stringifyJSON } from "@mailwoman/core/json";
@@ -56,7 +56,8 @@ import { feedChunks, linkWithRel, readAtomFeed } from "#tools/fetch/atom";
 import { loadCollectionFiles, writeManifest } from "#tools/fetch/download";
 import { downloadZipArchive } from "#tools/fetch/zip-archive";
 /**
- * The ATOM service document, which lists one zipped GML partition per entry.
+ * The ATOM service document.
+ * It lists one zipped GML partition per entry.
  */
 export const ES_NAVARRA_SERVICE_FEED_URL = "https://filescartografia.navarra.es/2_CARTOGRAFIA_TEMATICA/2_7_CATASTRO/2_7_3_INSPIRE_ATOM/2_7_3_3_AD/Addresses_ServiceATOM_Navarra.xml";
 /**
@@ -75,7 +76,8 @@ export const ES_NAVARRA_ATTRIBUTION = "Gobierno de Navarra";
  */
 export const ES_NAVARRA_REQUEST_INTERVAL_MS = 250;
 /**
- * The directory the harvest writes under, which is the adapter's `inputPath`.
+ * The directory the harvest writes under.
+ * The adapter reads this directory as its `inputPath`.
  */
 const SLUG = ES_NAVARRA_ADAPTER_ID;
 /**
@@ -92,8 +94,8 @@ const ARCHIVE_FILENAME = /^AD_Navarra_(\d+)\.gml\.zip$/iu;
 /**
  * The partitions the service document lists.
  *
- * @throws When the document holds no entry, when an entry carries no `enclosure` link, when a
- * linked archive is not named `AD_Navarra_<n>.gml.zip`, or when two entries name one archive.
+ * @throws When the document holds no entry, when an entry lists no `enclosure` link, when a linked
+ * archive's file name is not `AD_Navarra_<n>.gml.zip`, or when two entries point to one archive.
  * Each of those would otherwise write zero archives while reporting a completed run.
  */
 export function readESNavarraServiceFeed(feed) {
@@ -138,8 +140,9 @@ export function readESNavarraServiceFeed(feed) {
  * Whether the archive recorded for one partition is still the one the feed describes.
  *
  * A skip requires the feed to state an `<updated>` value.
- * Where it states none, both sides read an empty string and an equality test would hold,
- * which would keep an archive of unknown age for as long as the feed stayed silent.
+ * Where it states none, both sides read an empty string and an equality test would hold.
+ *
+ * That test would keep an archive of unknown age for as long as the feed stayed silent.
  */
 async function isCurrent(recorded, partition, path, verifyDigests) {
     if (!recorded || !partition.updated || recorded.feed_updated !== partition.updated)
@@ -147,13 +150,14 @@ async function isCurrent(recorded, partition, path, verifyDigests) {
     const stat = await tryStat(path);
     if (!stat || stat.size !== recorded.bytes)
         return false;
-    // The digest check reads the whole file rather than its metadata, which is why it is opt-in.
+    // The digest check reads the whole file rather than its metadata.
+    // The caller opts in.
     if (!verifyDigests)
         return true;
     return (await sha256File(path)) === recorded.sha256;
 }
 /**
- * The partitions this run considers, and the numbers a caller named that the feed does not list.
+ * The partitions this run considers, and the numbers a caller supplied that the feed does not list.
  *
  * A number the caller asked for and the service document does not list is returned
  * rather than dropped, because a partition that is not published is a different
@@ -188,8 +192,9 @@ function selectPartitions(listed, options) {
  * the pacing. {@linkcode fetchESNavarra} is the registry entry point and supplies both.
  *
  * @returns What was fetched, what the feed states is already recorded, and which partitions failed.
- * @throws When the service document lists no partition, which would otherwise answer
- * `{fetched: 0, skipped: 0, failed: 0}` and read to a caller as a completed fetch of an empty publisher.
+ * @throws When the service document lists no partition.
+ * The call would otherwise return `{fetched: 0, skipped: 0, failed: 0}`
+ * and read to a caller as a completed fetch of an empty publisher.
  */
 export async function harvestESNavarra(client, options) {
     const { report, signal } = options;
@@ -215,8 +220,8 @@ export async function harvestESNavarra(client, options) {
     await makeDirectories(destDir);
     const previous = await loadCollectionFiles(manifestPath);
     const files = new Map();
-    // An entry for a partition this run does not consider is carried through,
-    // so a bounded run never drops what an earlier run recorded.
+    // An entry for a partition this run does not consider is kept, so a bounded
+    // run never drops what an earlier run recorded.
     for (const [filename, entry] of previous) {
         files.set(filename, entry);
     }
@@ -242,7 +247,7 @@ export async function harvestESNavarra(client, options) {
         if (signal?.aborted)
             break;
         const dest = destDir(partition.filename);
-        if (await isCurrent(files.get(partition.filename), partition, dest, options.verifyDigests ?? false)) {
+        if (await isCurrent(files.get(partition.filename) ?? null, partition, dest, options.verifyDigests ?? false)) {
             skipped++;
             continue;
         }

package/out/es/tools/fetch/navarra.js.map

@@ -1 +1 @@
-{"version":3,"file":"navarra.js","sourceRoot":"","sources":["../../../../lib/es/tools/fetch/navarra.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"navarra.js","sourceRoot":"","sources":["../../../../lib/es/tools/fetch/navarra.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EAAE,SAAS,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAA;AAC5E,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAC5D,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAwB,MAAM,SAAS,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAExF,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEzE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACvC,yIAAyI,CAAA;AAE1I;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,qBAAqB,CAAA;AAE3D;;;;;GAKG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,GAAG,CAAA;AAEjD;;;GAGG;AACH,MAAM,IAAI,GAAG,qBAAqB,CAAA;AAElC;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,EAAE,CAAA;AAE5B;;GAEG;AACH,MAAM,gBAAgB,GAAG,gCAAgC,CAAA;AA8BzD;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAc;IACtD,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACd,GAAG,2BAA2B,uEAAuE;YACpG,mBAAmB,CACpB,CAAA;IACF,CAAC;IAED,MAAM,UAAU,GAAyB,EAAE,CAAA;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAA;IAE9B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,gFAAgF;QAChF,+EAA+E;QAC/E,kDAAkD;QAClD,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,CAAC,KAAK,EAAE,WAAW,CAAC,CAAA;QAElD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CACd,GAAG,2BAA2B,qBAAqB,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,cAAc;gBAC1F,wDAAwD,CACzD,CAAA;QACF,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;QAChE,MAAM,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAEhD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CACd,GAAG,2BAA2B,oBAAoB,aAAa,CAAC,QAAQ,CAAC,uBAAuB;gBAC/F,iDAAiD,aAAa,CAAC,KAAK,CAAC,KAAK,CAAC,qBAAqB;gBAChG,4DAA4D,CAC7D,CAAA;QACF,CAAC;QAED,IAAI,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CACd,GAAG,2BAA2B,KAAK,aAAa,CAAC,QAAQ,CAAC,sCAAsC;gBAC/F,oCAAoC,CACrC,CAAA;QACF,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;QAElB,UAAU,CAAC,IAAI,CAAC;YACf,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAE;YACvB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE;YACzB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,UAAU,EAAE,IAAI,CAAC,IAAI;YACrB,QAAQ;SACR,CAAC,CAAA;IACH,CAAC;IAED,OAAO,UAAU,CAAA;AAClB,CAAC;AA4DD;;;;;;;GAOG;AACH,KAAK,UAAU,SAAS,CACvB,QAAsC,EACtC,SAA6B,EAC7B,IAAqB,EACrB,aAAsB;IAEtB,IAAI,CAAC,QAAQ,IAAI,CAAC,SAAS,CAAC,OAAO,IAAI,QAAQ,CAAC,YAAY,KAAK,SAAS,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAEhG,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IAEhC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAEvD,kEAAkE;IAClE,sBAAsB;IACtB,IAAI,CAAC,aAAa;QAAE,OAAO,IAAI,CAAA;IAE/B,OAAO,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,KAAK,QAAQ,CAAC,MAAM,CAAA;AACpD,CAAC;AAED;;;;;;GAMG;AACH,SAAS,gBAAgB,CACxB,MAAqC,EACrC,OAA8D;IAE9D,IAAI,QAAQ,GAAG,MAAM,CAAA;IACrB,MAAM,OAAO,GAAa,EAAE,CAAA;IAE5B,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;QACrF,MAAM,KAAK,GAAyB,EAAE,CAAA;QAEtC,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACzC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;YAEtC,IAAI,SAAS,EAAE,CAAC;gBACf,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;YACtB,CAAC;iBAAM,CAAC;gBACP,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACrB,CAAC;QACF,CAAC;QAED,QAAQ,GAAG,KAAK,CAAA;IACjB,CAAC;IAED,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC5C,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AAC7B,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACrC,MAAgC,EAChC,OAAgC;IAEhC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAClC,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAA;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAAA;IAE7C,MAAM,EAAE,CAAC,OAAO,IAAI,aAAa,2BAA2B,EAAE,CAAC,CAAA;IAE/D,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,MAAM,MAAM,CAAC,KAAK,CAAS;QACvD,MAAM,EAAE,KAAK;QACb,GAAG,EAAE,2BAA2B;QAChC,YAAY,EAAE,MAAM;QACpB,OAAO,EAAE,OAAO;QAChB,MAAM;KACN,CAAC,CAAA;IAEF,2EAA2E;IAC3E,2BAA2B,CAAC,UAAU,EAAE,GAAG,IAAI,mBAAmB,CAAC,CAAA;IAEnE,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAA;IACvD,MAAM,MAAM,GAAG,wBAAwB,CAAC,IAAI,CAAC,CAAA;IAE7C,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,MAAM,oBAAoB,CAAC,CAAA;IAEhD,MAAM,MAAM,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAEhD,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,wBAAwB,CAAC,CAAA;IAE7D,kFAAkF;IAClF,kDAAkD;IAClD,MAAM,eAAe,CAAC,OAAO,CAAC,CAAA;IAE9B,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,YAAY,CAAC,CAAA;IACxD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAiC,CAAA;IAEtD,4EAA4E;IAC5E,gDAAgD;IAChD,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,QAAQ,EAAE,CAAC;QAC1C,KAAK,CAAC,GAAG,CAAC,QAAQ,EAAE,KAA8B,CAAC,CAAA;IACpD,CAAC;IAED,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,IAAI,OAAO,GAAG,CAAC,CAAA;IACf,MAAM,WAAW,GAAa,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,CAAA;IAEjD,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,EAAE,CAAC,iBAAiB,OAAO,wCAAwC,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,oBAAoB,GAAG,KAAK,IAAmB,EAAE;QACtD,MAAM,QAAQ,GAA6B;YAC1C,MAAM,EAAE,IAAI;YACZ,UAAU,EAAE,2BAA2B;YACvC,OAAO,EAAE,kBAAkB;YAC3B,WAAW,EAAE,sBAAsB;YACnC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACvC,iBAAiB,EAAE,MAAM,CAAC,MAAM;YAChC,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;SACtG,CAAA;QAED,MAAM,aAAa,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAA;IAC5C,CAAC,CAAA;IAED,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;QACzC,IAAI,MAAM,EAAE,OAAO;YAAE,MAAK;QAE1B,MAAM,IAAI,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAA;QAExC,IAAI,MAAM,SAAS,CAAC,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,CAAC,aAAa,IAAI,KAAK,CAAC,EAAE,CAAC;YAC7G,OAAO,EAAE,CAAA;YAET,SAAQ;QACT,CAAC;QAED,IAAI,CAAC;YACJ,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE;gBAClD,GAAG,EAAE,SAAS,CAAC,UAAU;gBACzB,IAAI;gBACJ,OAAO,EAAE,OAAO;gBAChB,MAAM;aACN,CAAC,CAAA;YAEF,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,EAAE;gBAC7B,SAAS,EAAE,SAAS,CAAC,SAAS;gBAC9B,QAAQ,EAAE,SAAS,CAAC,QAAQ;gBAC5B,UAAU,EAAE,SAAS,CAAC,UAAU;gBAChC,aAAa,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;gBACvC,MAAM,EAAE,SAAS,CAAC,MAAM;gBACxB,KAAK,EAAE,SAAS,CAAC,KAAK;gBACtB,YAAY,EAAE,SAAS,CAAC,OAAO;gBAC/B,aAAa,EAAE,SAAS,CAAC,YAAY;aACrC,CAAC,CAAA;YAEF,OAAO,EAAE,CAAA;YAET,MAAM,EAAE,CAAC,OAAO,SAAS,CAAC,QAAQ,IAAI,aAAa,CAAC,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,WAAW,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;QAC7G,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,EAAE,CAAC,OAAO,SAAS,CAAC,SAAS,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;YACjG,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAA;YAErC,SAAQ;QACT,CAAC;QAED,IAAI,OAAO,GAAG,iBAAiB,KAAK,CAAC,EAAE,CAAC;YACvC,MAAM,oBAAoB,EAAE,CAAA;QAC7B,CAAC;IACF,CAAC;IAED,MAAM,oBAAoB,EAAE,CAAA;IAE5B,MAAM,EAAE,CAAC,OAAO,IAAI,UAAU,CAAC,CAAA;IAC/B,MAAM,EAAE,CAAC,YAAY,OAAO,EAAE,CAAC,CAAA;IAC/B,MAAM,EAAE,CAAC,YAAY,OAAO,0DAA0D,CAAC,CAAA;IACvF,MAAM,EAAE,CAAC,YAAY,WAAW,CAAC,MAAM,EAAE,CAAC,CAAA;IAE1C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,CAAA;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAoC;IACtE,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;AACrB,CAAC;AAYD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CACnC,OAA8B,EAC9B,MAA+B;IAE/B,YAAY,MAAM,GAAG,IAAI,SAAS,CAAC;QAClC,WAAW,EAAE,IAAI;QACjB,oBAAoB,EAAE,OAAO,CAAC,oBAAoB,IAAI,8BAA8B;QACpF,KAAK,EAAE,IAAI;KACX,CAAC,CAAA;IAEF,yFAAyF;IACzF,0DAA0D;IAC1D,OAAO,MAAM,gBAAgB,CAAC,MAAM,EAAE;QACrC,SAAS,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QAChC,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,aAAa,EAAE,OAAO,CAAC,aAAa;QACpC,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,MAAM;KACN,CAAC,CAAA;AACH,CAAC"}

package/out/fi/adapters/ryhti/adapter.d.ts

@@ -17,43 +17,40 @@
  * every name column bare.
  *
  * A row's country comes from `municipality_number` rather than from the caller. Åland is part of
- * Finland and its sixteen municipalities carry Finnish municipality numbers, so one national file
- * holds both jurisdictions and {@linkcode ALAND_MUNICIPALITIES} is what separates them.
+ * Finland and its sixteen municipalities have Finnish municipality numbers, so one national file
+ * holds both jurisdictions and {@linkcode ALAND_MUNICIPALITIES} separates them.
  *
  * The street and the house number are read from the publisher's own part columns rather than from
  * its inline address text.
  * `address_name_fin` is the whole of `address_fin` or a space-delimited prefix of it, and the four
  * number-part columns reproduce the publisher's inline number.
- * Measured over the first 292,293 rows of the 2026-10-02 edition: 278,262 rows populate both
- * columns, 0 of them place `address_name_fin` anywhere but at the head of `address_fin`, and the
- * composed number equals the inline remainder byte for byte on all 265,830 numbered rows.
- * No row publishes inline address text with both name columns empty,
- * so reading the name columns loses no address.
+ * No row publishes inline address text with both name columns empty, so the part columns lose no
+ * address.
  *
- * `address_number` is not a house number. It is a 1-based ordinal over the addresses sharing one
- * `building_key`, which is how a corner building's several frontages are numbered, and it holds nine
- * distinct values across the file. The adapter ignores it.
+ * `address_number` is not a house number. It is a 1-based ordinal over the addresses that share one
+ * `building_key`. That is how a corner building's several frontages are numbered. The adapter
+ * ignores it.
  *
- * The file is bilingual, and which column carries which language depends on the municipality. On
+ * The file is bilingual, and which column holds which language depends on the municipality. On
  * mainland Finland `address_name_fin` is the Finnish name and `address_name_swe` the Swedish one. On
  * Åland the `*_fin` columns, where populated at all, hold the **Swedish** name: `address_fin` reads
  * `Skogshyddsvägen 11`.
  * So the adapter prefers `*_swe` on Åland and `*_fin` on the mainland, and emits one row per
  * published record from the preferred language's columns.
- * `locale` names the language of the name it emitted rather than the language of the column that
- * name came from, which gives three values.
- * `fi-FI` is a mainland record named in `address_name_fin`.
- * `sv-FI` is a mainland record that populates `address_name_swe` alone, which is the form a
+ * `locale` states the language of the name it emitted rather than the language of the column that
+ * name came from. That gives three values.
+ * `fi-FI` is a mainland record whose name came from `address_name_fin`.
+ * `sv-FI` is a mainland record that populates `address_name_swe` only. That is the form a
  * Swedish-speaking municipality publishes.
  * `sv-AX` is every Åland record, because the Swedish columns are the populated ones there and the
  * `*_fin` columns hold the Swedish name where they are populated at all.
  * A mainland record's Swedish name, where the record publishes both, is not emitted as a second
- * row: a record is one premise, and `CanonicalRow` carries one written surface.
+ * row: a record is one premise, and `CanonicalRow` holds one written surface.
  *
  * SYKE's metadata record `{DBD610F4-3392-44CD-B601-BAE8FA547A57}` grants CC BY 4.0 for its open data
  * and the register's two elected decisions for this file record `CC-BY-4.0` in their `spdx` field, so
  * the adapter records that license on every row. SYKE states the attribution it wants as
- * `Lähde: Syke Ryhti`, and the model card must carry it.
+ * `Lähde: Syke Ryhti`, and the model card must state it.
  *
  * The adapter streams with `CSVSpliterator.fromAsync`, so the 3.8M-row file never sits in memory. It
  * honors `opts.limit`, `opts.signal` and `opts.country`.
@@ -69,7 +66,6 @@ export declare const RYHTI_ADAPTER_ID = "ryhti";
  * The sixteen `municipality_number` values of Åland's municipalities.
  *
  * Every other number in the file belongs to a mainland Finnish municipality.
- * The file holds 308 distinct values, and these sixteen cover 32,518 of its 3,862,609 rows.
  *
  * The column is a zero-padded three-digit string, so a reader compares the padded form.
  */
@@ -102,8 +98,8 @@ export declare function countryOfFinnishMunicipality(municipalityNumber: string)
  * as `184-183b` across a second pair of the same two columns.
  * The second pair is appended after a hyphen when either of its halves is populated.
  *
- * @returns The composed number, or an empty string for a row with no number at all,
- * which a caller treats as a named place rather than assigning it a number.
+ * @returns The composed number, or an empty string for a row with no number at all.
+ * A caller treats that empty string as a place name rather than a number.
  */
 export declare function composeRyhtiHouseNumber(record: Partial<RyhtiNumberParts>): string;
 export declare function createRyhtiAdapter(): CorpusAdapter;

package/out/fi/adapters/ryhti/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/fi/adapters/ryhti/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AASH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAiBnD,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAiB,CAAA;AAmB9D;;;GAGG;AACH,UAAU,gBAAgB;IACzB,6BAA6B,EAAE,MAAM,CAAA;IACrC,8BAA8B,EAAE,MAAM,CAAA;IACtC,oCAAoC,EAAE,MAAM,CAAA;IAC5C,qCAAqC,EAAE,MAAM,CAAA;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAI/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAcjF;AAkDD,wBAAgB,kBAAkB,IAAI,aAAa,CA8FlD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,eAAuB,CAAA"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../../lib/fi/adapters/ryhti/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AASH,OAAO,EAAuD,KAAK,aAAa,EAAiB,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,UAAU,CAAA;AAEvC;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,EAAE,WAAW,CAAC,MAAM,CAiBnD,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAiB,CAAA;AAmB9D;;;GAGG;AACH,UAAU,gBAAgB;IACzB,6BAA6B,EAAE,MAAM,CAAA;IACrC,8BAA8B,EAAE,MAAM,CAAA;IACtC,oCAAoC,EAAE,MAAM,CAAA;IAC5C,qCAAqC,EAAE,MAAM,CAAA;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,4BAA4B,CAAC,kBAAkB,EAAE,MAAM,GAAG,MAAM,CAI/E;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,MAAM,CAcjF;AAkDD,wBAAgB,kBAAkB,IAAI,aAAa,CA8FlD;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,eAAuB,CAAA"}

package/out/fi/adapters/ryhti/adapter.js

@@ -17,43 +17,40 @@
  * every name column bare.
  *
  * A row's country comes from `municipality_number` rather than from the caller. Åland is part of
- * Finland and its sixteen municipalities carry Finnish municipality numbers, so one national file
- * holds both jurisdictions and {@linkcode ALAND_MUNICIPALITIES} is what separates them.
+ * Finland and its sixteen municipalities have Finnish municipality numbers, so one national file
+ * holds both jurisdictions and {@linkcode ALAND_MUNICIPALITIES} separates them.
  *
  * The street and the house number are read from the publisher's own part columns rather than from
  * its inline address text.
  * `address_name_fin` is the whole of `address_fin` or a space-delimited prefix of it, and the four
  * number-part columns reproduce the publisher's inline number.
- * Measured over the first 292,293 rows of the 2026-10-02 edition: 278,262 rows populate both
- * columns, 0 of them place `address_name_fin` anywhere but at the head of `address_fin`, and the
- * composed number equals the inline remainder byte for byte on all 265,830 numbered rows.
- * No row publishes inline address text with both name columns empty,
- * so reading the name columns loses no address.
+ * No row publishes inline address text with both name columns empty, so the part columns lose no
+ * address.
  *
- * `address_number` is not a house number. It is a 1-based ordinal over the addresses sharing one
- * `building_key`, which is how a corner building's several frontages are numbered, and it holds nine
- * distinct values across the file. The adapter ignores it.
+ * `address_number` is not a house number. It is a 1-based ordinal over the addresses that share one
+ * `building_key`. That is how a corner building's several frontages are numbered. The adapter
+ * ignores it.
  *
- * The file is bilingual, and which column carries which language depends on the municipality. On
+ * The file is bilingual, and which column holds which language depends on the municipality. On
  * mainland Finland `address_name_fin` is the Finnish name and `address_name_swe` the Swedish one. On
  * Åland the `*_fin` columns, where populated at all, hold the **Swedish** name: `address_fin` reads
  * `Skogshyddsvägen 11`.
  * So the adapter prefers `*_swe` on Åland and `*_fin` on the mainland, and emits one row per
  * published record from the preferred language's columns.
- * `locale` names the language of the name it emitted rather than the language of the column that
- * name came from, which gives three values.
- * `fi-FI` is a mainland record named in `address_name_fin`.
- * `sv-FI` is a mainland record that populates `address_name_swe` alone, which is the form a
+ * `locale` states the language of the name it emitted rather than the language of the column that
+ * name came from. That gives three values.
+ * `fi-FI` is a mainland record whose name came from `address_name_fin`.
+ * `sv-FI` is a mainland record that populates `address_name_swe` only. That is the form a
  * Swedish-speaking municipality publishes.
  * `sv-AX` is every Åland record, because the Swedish columns are the populated ones there and the
  * `*_fin` columns hold the Swedish name where they are populated at all.
  * A mainland record's Swedish name, where the record publishes both, is not emitted as a second
- * row: a record is one premise, and `CanonicalRow` carries one written surface.
+ * row: a record is one premise, and `CanonicalRow` holds one written surface.
  *
  * SYKE's metadata record `{DBD610F4-3392-44CD-B601-BAE8FA547A57}` grants CC BY 4.0 for its open data
  * and the register's two elected decisions for this file record `CC-BY-4.0` in their `spdx` field, so
  * the adapter records that license on every row. SYKE states the attribution it wants as
- * `Lähde: Syke Ryhti`, and the model card must carry it.
+ * `Lähde: Syke Ryhti`, and the model card must state it.
  *
  * The adapter streams with `CSVSpliterator.fromAsync`, so the 3.8M-row file never sits in memory. It
  * honors `opts.limit`, `opts.signal` and `opts.country`.
@@ -75,7 +72,6 @@ export const RYHTI_ADAPTER_ID = "ryhti";
  * The sixteen `municipality_number` values of Åland's municipalities.
  *
  * Every other number in the file belongs to a mainland Finnish municipality.
- * The file holds 308 distinct values, and these sixteen cover 32,518 of its 3,862,609 rows.
  *
  * The column is a zero-padded three-digit string, so a reader compares the padded form.
  */
@@ -118,8 +114,8 @@ export function countryOfFinnishMunicipality(municipalityNumber) {
  * as `184-183b` across a second pair of the same two columns.
  * The second pair is appended after a hyphen when either of its halves is populated.
  *
- * @returns The composed number, or an empty string for a row with no number at all,
- * which a caller treats as a named place rather than assigning it a number.
+ * @returns The composed number, or an empty string for a row with no number at all.
+ * A caller treats that empty string as a place name rather than a number.
  */
 export function composeRyhtiHouseNumber(record) {
     const first = composeHouseNumber(record.number_part_of_address_number ?? "", record.subdivision_letter_of_address_number ?? "");
@@ -132,7 +128,7 @@ export function composeRyhtiHouseNumber(record) {
     return `${first}-${secondNumber}${secondLetter}`;
 }
 /**
- * The surface to emit for one record, or `undefined` for a record that names no street.
+ * The surface to emit for one record, or `null` for a record with no street.
  *
  * On Åland the Swedish columns are preferred, and the Finnish ones are read as Swedish.
  * That is the language they hold there.
@@ -141,7 +137,7 @@ export function composeRyhtiHouseNumber(record) {
  * The Swedish ones stand in where `address_name_fin` is empty.
  * That is the form a Swedish-speaking municipality publishes.
  *
- * A language whose name column is empty names no street.
+ * A language whose name column is empty has no street.
  * Seven mainland rows publish an `address_swe` of a bare number with an empty `address_name_swe`.
  * This refuses them rather than giving them an empty street.
  */
@@ -156,11 +152,11 @@ function surfaceOf(record, country) {
     };
     if (country === "AX") {
         const preferred = swedish.street ? swedish : finnish;
-        return preferred.street ? { ...preferred, language: "sv" } : undefined;
+        return preferred.street ? { ...preferred, language: "sv" } : null;
     }
     if (finnish.street)
         return { ...finnish, language: "fi" };
-    return swedish.street ? { ...swedish, language: "sv" } : undefined;
+    return swedish.street ? { ...swedish, language: "sv" } : null;
 }
 export function createRyhtiAdapter() {
     return {
@@ -186,7 +182,7 @@ export function createRyhtiAdapter() {
                     if (opts.limit !== undefined && emitted >= opts.limit)
                         break;
                     const country = countryOfFinnishMunicipality(record.municipality_number ?? "");
-                    // A caller that named one jurisdiction gets that jurisdiction's rows,
+                    // A caller that requested one jurisdiction gets that jurisdiction's rows,
                     // so the one national file can be read once per country.
                     if (opts.country && country !== opts.country)
                         continue;

package/out/fi/adapters/ryhti/adapter.js.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../lib/fi/adapters/ryhti/adapter.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adapter.js","sourceRoot":"","sources":["../../../../lib/fi/adapters/ryhti/adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAClE,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAC3C,OAAO,EAAE,WAAW,EAA8D,aAAa,EAAE,MAAM,QAAQ,CAAA;AAE/G;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,OAAO,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAwB,IAAI,GAAG,CAAC;IAChE,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,aAAa;IACpB,KAAK,EAAE,YAAY;IACnB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,WAAW;IAClB,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,QAAQ;CACf,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;AA8B9D;;;;;GAKG;AACH,MAAM,UAAU,4BAA4B,CAAC,kBAA0B;IACtE,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;IAEzD,OAAO,oBAAoB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AACtD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAiC;IACxE,MAAM,KAAK,GAAG,kBAAkB,CAC/B,MAAM,CAAC,6BAA6B,IAAI,EAAE,EAC1C,MAAM,CAAC,oCAAoC,IAAI,EAAE,CACjD,CAAA;IAED,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAA;IAErB,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,8BAA8B,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IACzE,MAAM,YAAY,GAAG,CAAC,MAAM,CAAC,qCAAqC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAEhF,IAAI,CAAC,YAAY,IAAI,CAAC,YAAY;QAAE,OAAO,KAAK,CAAA;IAEhD,OAAO,GAAG,KAAK,IAAI,YAAY,GAAG,YAAY,EAAE,CAAA;AACjD,CAAC;AAcD;;;;;;;;;;;;;GAaG;AACH,SAAS,SAAS,CAAC,MAAgB,EAAE,OAAe;IACnD,MAAM,OAAO,GAAG;QACf,MAAM,EAAE,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC9C,QAAQ,EAAE,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;KACjD,CAAA;IAED,MAAM,OAAO,GAAG;QACf,MAAM,EAAE,CAAC,MAAM,CAAC,gBAAgB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QAC9C,QAAQ,EAAE,CAAC,MAAM,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;KACjD,CAAA;IAED,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAA;QAEpD,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;IAClE,CAAC;IAED,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAEzD,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAA;AAC9D,CAAC;AAED,MAAM,UAAU,kBAAkB;IACjC,OAAO;QACN,EAAE,EAAE,gBAAgB;QACpB,cAAc,EAAE,WAAW;QAC3B,WAAW,EAAE,WAAW,CAAC,OAAO;QAChC,QAAQ,EAAE,cAAc,CAAC,oBAAoB;QAC7C,OAAO,EAAE,aAAa,CAAC,QAAQ;QAC/B,WAAW,EACV,uHAAuH;QAExH,KAAK,CAAC,CAAC,IAAI,CAAC,IAAoB;YAC/B,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,uBAAuB,CAAC,gBAAgB,EAAE,eAAe,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;YACnF,CAAC;YAED,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,SAAS,EAAE;gBACrD,aAAa,EAAE,KAAK;aACpB,CAAC,CAAA;YAEF,IAAI,OAAO,GAAG,CAAC,CAAA;YACf,IAAI,OAAO,GAAG,CAAC,CAAA;YAEf,IAAI,CAAC;gBACJ,IAAI,KAAK,EAAE,MAAM,MAAM,IAAI,IAA+B,EAAE,CAAC;oBAC5D,IAAI,IAAI,CAAC,MAAM,EAAE,OAAO;wBAAE,MAAK;oBAE/B,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,OAAO,IAAI,IAAI,CAAC,KAAK;wBAAE,MAAK;oBAE5D,MAAM,OAAO,GAAG,4BAA4B,CAAC,MAAM,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAA;oBAE9E,0EAA0E;oBAC1E,yDAAyD;oBACzD,IAAI,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO;wBAAE,SAAQ;oBAEtD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;oBAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;wBACd,OAAO,IAAI,CAAC,CAAA;wBAEZ,SAAQ;oBACT,CAAC;oBAED,MAAM,QAAQ,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;oBAElD,IAAI,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,QAAQ;wBAAE,SAAQ;oBAE5C,MAAM,KAAK,GAAG,uBAAuB,CAAC,MAAM,CAAC,CAAA;oBAC7C,MAAM,UAAU,GAA+B,EAAE,CAAA;oBAEjD,IAAI,KAAK,EAAE,CAAC;wBACX,UAAU,CAAC,YAAY,GAAG,KAAK,CAAA;oBAChC,CAAC;oBAED,UAAU,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;oBAElC,IAAI,QAAQ,EAAE,CAAC;wBACd,UAAU,CAAC,QAAQ,GAAG,QAAQ,CAAA;oBAC/B,CAAC;oBAED,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;wBACtB,UAAU,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAA;oBACvC,CAAC;oBAED,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;oBAE5E,IAAI,CAAC,QAAQ;wBAAE,SAAQ;oBAEvB,MAAM,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,QAAQ,CAAA;oBAC7C,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;oBAE7C,MAAM,QAAQ,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,gBAAgB,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAA;oBAE/F,MAAM;wBACL,GAAG;wBACH,UAAU,EAAE,OAAO;wBACnB,OAAO;wBACP,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE;wBACxC,MAAM,EAAE,gBAAgB;wBACxB,SAAS,EAAE,QAAQ;wBACnB,cAAc,EAAE,EAAE;wBAClB,OAAO,EAAE,WAAW;qBACpB,CAAA;oBAED,OAAO,EAAE,CAAA;gBACV,CAAC;YACF,CAAC;oBAAS,CAAC;gBACV,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CACnB,YAAY,OAAO,6DAA6D,OAAO,SAAS,CAChG,CAAA;gBACF,CAAC;YACF,CAAC;QACF,CAAC;KACD,CAAA;AACF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,EAAE,CAAA"}

package/out/fi/tools/fetch/ryhti.d.ts

@@ -14,31 +14,27 @@
  * this module sits beside `#fr/tools/fetch/ban` rather than in an `sdk/` root the workspace does
  * not declare.
  *
- * SYKE's metadata record `{DBD610F4-3392-44CD-B601-BAE8FA547A57}` grants CC BY 4.0, which the
- * address-source register elects, and states the attribution as `Lähde: Syke Ryhti`. The manifest
+ * SYKE's metadata record `{DBD610F4-3392-44CD-B601-BAE8FA547A57}` grants CC BY 4.0 and states the
+ * attribution as `Lähde: Syke Ryhti`. The address-source register elects that license. The manifest
  * records both, and `#fi/adapters/ryhti/adapter` records the license on every row.
  *
  * Four measured properties decide what this module does:
  *
- * 1. **The file is republished daily and its length changes with it.** `HEAD` answered
- *    `content-length: 351290196` and `last-modified: Fri, 2 Oct 2026 05:20:14 GMT` on 2026-10-02,
- *    against `351288399` and `Thu, 1 Oct 2026 05:20:03 GMT` the day before. So the re-run check is
- *    a `HEAD` compared against the manifest, which costs one small request instead of 351 MB, and
- *    neither number is written into this module as a constant.
+ * 1. **The file is republished daily and its length changes with it.** The re-run check is a `HEAD`
+ *    compared against the manifest, so one small request replaces the whole body and no length is a
+ *    constant here.
  * 2. **The host ignores `Range`.** `bytes=0-4095` answers HTTP 200 with no `content-range` and the
  *    whole `content-length`, and `accept-ranges` is absent, so a resumed transfer is not available
  *    and an interrupted one restarts. {@linkcode resumableDownload} would refuse the response.
- * 3. **This module moves bytes and decodes none of them.** The body is streamed to disk compressed, then
- *    decompressed stream to stream, so no chunk boundary is ever interpreted as a character
- *    boundary. A `chunk.toString("utf8")` per gzip chunk produces a U+FFFD at every boundary that
- *    splits a multi-byte character, and 60,014,592 decompressed bytes of this file were scanned for
- *    `EF BF BD` with 0 found: the replacement characters such a reader reports are its own.
+ * 3. **This module moves bytes and decodes none of them.** The body is streamed to disk compressed
+ *    and then decompressed stream to stream, so no chunk boundary is interpreted as a character
+ *    boundary. A `chunk.toString("utf8")` per gzip chunk would write U+FFFD at every split
+ *    multi-byte character.
  * 4. **The decompressed CSV is what the adapter can read.** `#fi/adapters/ryhti/adapter` hands
- *    `opts.inputPath` to `CSVSpliterator.fromAsync`, which reads the bytes as they are on disk, so
- *    a path to the `.gz` would be parsed as CSV over gzip bytes. The `.gz` is therefore removed once the CSV is
- *    written: 793 MB of readable input instead of 351 MB plus a reader the adapter does not have.
+ *    `opts.inputPath` to `CSVSpliterator.fromAsync`, which reads the bytes on disk. A path to the
+ *    `.gz` would be parsed as CSV over gzip bytes, so the `.gz` is removed once the CSV is written.
  *    A caller that wants the compressed copy kept passes
- *    {@linkcode FetchRyhtiOptions.keepCompressed}, which costs 1.14 GB for both.
+ *    {@linkcode FetchRyhtiOptions.keepCompressed}.
  */
 import { APIClient } from "@mailwoman/core/api";
 import { type PathBuilderLike } from "path-ts";
@@ -56,7 +52,8 @@ export declare const FI_RYHTI_CSV_FILENAME = "open_address.csv";
  */
 export declare const FI_RYHTI_LICENSE = "CC-BY-4.0";
 /**
- * The attribution SYKE states for its open data, which the model card must carry.
+ * The attribution SYKE states for its open data.
+ * The model card must record it.
  */
 export declare const FI_RYHTI_ATTRIBUTION = "L\u00E4hde: Syke Ryhti";
 /**
@@ -73,8 +70,9 @@ export declare const FI_RYHTI_REQUIRED_COLUMNS: readonly string[];
 /**
  * What the manifest records about the one file.
  *
- * {@linkcode SourceManifest}'s five fields describe the decompressed CSV,
- * which is what the adapter reads and what the digest covers.
+ * {@linkcode SourceManifest}'s five fields describe the decompressed CSV.
+ * That file is what the adapter reads and what the digest covers.
+ *
  * The three added fields describe the transfer, and they are what the re-run
  * check compares before it downloads 351 MB.
  */
@@ -90,7 +88,7 @@ export interface RyhtiManifest extends SourceManifest {
      */
     compressed_bytes: number | null;
     /**
-     * The columns the header named when this file was downloaded, in order.
+     * The columns the header held when this file was downloaded, in order.
      *
      * Recorded rather than counted, so a later edition's added, removed or renamed
      * column is a diff against this list rather than a count that moved.
@@ -141,13 +139,14 @@ export interface DownloadRyhtiOptions {
      * Keep the compressed copy beside the CSV.
      *
      * The adapter reads the CSV, so the default removes the archive once the CSV is written.
-     * Keeping both holds 1.14 GB for the one file.
+     * Both together hold 1.14 GB for the one file.
      */
     keepCompressed?: boolean;
     /**
      * Re-read the CSV's sha256 on a re-run instead of comparing its byte count.
      *
-     * The default compares the recorded byte count against the file's size, which is one `stat`.
+     * The default compares the recorded byte count against the file's size.
+     * That check is one `stat`.
      * This re-hashes 793 MB.
      */
     verifyDigest?: boolean;
@@ -157,14 +156,15 @@ export interface DownloadRyhtiOptions {
     force?: boolean;
     /**
      * Attempts after the first for the one transfer.
-     * Defaults to three.
      *
      * The host ignores `Range`, so each attempt starts the 351 MB again.
+     *
+     * @defaultValue three.
      */
     retries?: number;
     /**
      * Pause between attempts, in milliseconds.
-     * Defaults to `DEFAULT_RETRY_DELAY_MS`.
+     * @defaultValue {@linkcode DEFAULT_RETRY_DELAY_MS}
      */
     retryDelayMs?: number;
     signal?: AbortSignal;

package/out/fi/tools/fetch/ryhti.d.ts.map

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

package/out/fi/tools/fetch/ryhti.js

@@ -14,38 +14,34 @@
  * this module sits beside `#fr/tools/fetch/ban` rather than in an `sdk/` root the workspace does
  * not declare.
  *
- * SYKE's metadata record `{DBD610F4-3392-44CD-B601-BAE8FA547A57}` grants CC BY 4.0, which the
- * address-source register elects, and states the attribution as `Lähde: Syke Ryhti`. The manifest
+ * SYKE's metadata record `{DBD610F4-3392-44CD-B601-BAE8FA547A57}` grants CC BY 4.0 and states the
+ * attribution as `Lähde: Syke Ryhti`. The address-source register elects that license. The manifest
  * records both, and `#fi/adapters/ryhti/adapter` records the license on every row.
  *
  * Four measured properties decide what this module does:
  *
- * 1. **The file is republished daily and its length changes with it.** `HEAD` answered
- *    `content-length: 351290196` and `last-modified: Fri, 2 Oct 2026 05:20:14 GMT` on 2026-10-02,
- *    against `351288399` and `Thu, 1 Oct 2026 05:20:03 GMT` the day before. So the re-run check is
- *    a `HEAD` compared against the manifest, which costs one small request instead of 351 MB, and
- *    neither number is written into this module as a constant.
+ * 1. **The file is republished daily and its length changes with it.** The re-run check is a `HEAD`
+ *    compared against the manifest, so one small request replaces the whole body and no length is a
+ *    constant here.
  * 2. **The host ignores `Range`.** `bytes=0-4095` answers HTTP 200 with no `content-range` and the
  *    whole `content-length`, and `accept-ranges` is absent, so a resumed transfer is not available
  *    and an interrupted one restarts. {@linkcode resumableDownload} would refuse the response.
- * 3. **This module moves bytes and decodes none of them.** The body is streamed to disk compressed, then
- *    decompressed stream to stream, so no chunk boundary is ever interpreted as a character
- *    boundary. A `chunk.toString("utf8")` per gzip chunk produces a U+FFFD at every boundary that
- *    splits a multi-byte character, and 60,014,592 decompressed bytes of this file were scanned for
- *    `EF BF BD` with 0 found: the replacement characters such a reader reports are its own.
+ * 3. **This module moves bytes and decodes none of them.** The body is streamed to disk compressed
+ *    and then decompressed stream to stream, so no chunk boundary is interpreted as a character
+ *    boundary. A `chunk.toString("utf8")` per gzip chunk would write U+FFFD at every split
+ *    multi-byte character.
  * 4. **The decompressed CSV is what the adapter can read.** `#fi/adapters/ryhti/adapter` hands
- *    `opts.inputPath` to `CSVSpliterator.fromAsync`, which reads the bytes as they are on disk, so
- *    a path to the `.gz` would be parsed as CSV over gzip bytes. The `.gz` is therefore removed once the CSV is
- *    written: 793 MB of readable input instead of 351 MB plus a reader the adapter does not have.
+ *    `opts.inputPath` to `CSVSpliterator.fromAsync`, which reads the bytes on disk. A path to the
+ *    `.gz` would be parsed as CSV over gzip bytes, so the `.gz` is removed once the CSV is written.
  *    A caller that wants the compressed copy kept passes
- *    {@linkcode FetchRyhtiOptions.keepCompressed}, which costs 1.14 GB for both.
+ *    {@linkcode FetchRyhtiOptions.keepCompressed}.
  */
 /* oxlint-disable sister-software/prefer-region-over-marks -- these markers label steps inside one
    procedure rather than sections of declarations. A region there folds no element a reader wants folded. */
 import { APIClient } from "@mailwoman/core/api";
 import { gunzipChunks } from "@mailwoman/core/fs/compression";
 import { ByteFormatter } from "@mailwoman/core/fs/formatters";
-import { tryStat } from "@mailwoman/core/fs/readers";
+import { tryStat } from "@mailwoman/core/fs/readers/stat";
 import { openReadStream, openWriteStream, pipeline, Readable } from "@mailwoman/core/fs/streams";
 import { makeDirectories, removePathIfPresent } from "@mailwoman/core/fs/writers";
 import { sha256File } from "@mailwoman/core/hash";
@@ -58,7 +54,7 @@ import { assertHeaderColumns, readDelimitedHeader } from "#tools/fetch/header";
  */
 export const FI_RYHTI_CSV_URL = "https://paikkatiedot.ymparisto.fi/geoserver/www/open_address.csv.gz";
 /**
- * The directory the download is written under, which is the adapter's `inputPath`'s parent.
+ * The download directory, the adapter's `inputPath`'s parent.
  */
 const SLUG = RYHTI_ADAPTER_ID;
 /**
@@ -74,7 +70,8 @@ const COMPRESSED_FILENAME = "open_address.csv.gz";
  */
 export const FI_RYHTI_LICENSE = "CC-BY-4.0";
 /**
- * The attribution SYKE states for its open data, which the model card must carry.
+ * The attribution SYKE states for its open data.
+ * The model card must record it.
  */
 export const FI_RYHTI_ATTRIBUTION = "Lähde: Syke Ryhti";
 /**
@@ -115,7 +112,7 @@ export async function readRyhtiHead(client, url = FI_RYHTI_CSV_URL) {
     const length = headers?.["content-length"];
     return {
         lastModified: headers?.["last-modified"] ?? null,
-        contentLength: length !== undefined && /^\d+$/u.test(length) ? Number(length) : null,
+        contentLength: length && /^\d+$/u.test(length) ? Number(length) : null,
         contentType: headers?.["content-type"] ?? null,
     };
 }
@@ -157,9 +154,9 @@ async function isCurrent(recorded, head, path, verifyDigest) {
     if (!recorded)
         return false;
     // A host that states neither cannot be compared against, so the file is downloaded.
-    if (head.lastModified === null && head.contentLength === null)
+    if (!head.lastModified && head.contentLength === null)
         return false;
-    if (head.lastModified !== null && head.lastModified !== recorded.last_modified)
+    if (head.lastModified && head.lastModified !== recorded.last_modified)
         return false;
     if (head.contentLength !== null && head.contentLength !== recorded.compressed_bytes)
         return false;
@@ -221,8 +218,8 @@ export async function downloadRyhti(client, options) {
                 throw new Error(`HTTP ${response.status} ${response.statusText} — ${FI_RYHTI_CSV_URL}`);
             const contentType = response.headers.get("content-type") ?? "";
             // The host serves `application/x-gzip`.
-            // An `text/html` body under http 200 is a portal page, which would otherwise
-            // be written to disk and fail later as a corrupt archive.
+            // An `text/html` body under http 200 is a portal page.
+            // A portal page saved to disk would fail later as a corrupt archive.
             if (contentType.includes("text/html")) {
                 throw new Error(`${FI_RYHTI_CSV_URL} answered ${contentType}, which is a page rather than the file`);
             }