@mailwoman/soil 9.4.0 → 10.1.0

package/out/sdk/download.js

@@ -2,75 +2,38 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Acquire one survey area's published archive — 13 to 41 MB streamed to disk and unzipped.
- *
- *   THE TRANSFER ITSELF LIVES IN `@mailwoman/core/utils`, and `streamToDisk` carries why a file transfer of
- *   this size keeps raw `fetch` instead of going through `APIClient`, plus the `.part`-rename rule. What is
- *   soil's, and stays here, is the URL shape, the cache key, and the two facts below that the shared
- *   transfer is told rather than assumes: the progress stride and what a 400 means. The METADATA reads
- *   around this one do go through `APIClient` — see `client.ts`.
- *
- *   FRESHNESS IS `sacatalog.saverest`, NEVER A LENGTH PROBE, AND THE HOST LEAVES NO CHOICE. It answers `HEAD`
- *   with HTTP 405 (`allow: GET`) and IGNORES `Range`: a request with `Range: bytes=0-0` returned HTTP 200 and
- *   transferred the whole 27,598,377 bytes in 7.23 s. So "check the size first" starts a real download. The
- *   cache is keyed on the version date the tabular service reports instead, and a vintage already on disk is
- *   never re-fetched. The `Range` behaviour is PATH-SPECIFIC rather than host-wide — `/DataAvailability/`
- *   does answer 206 — so a client must probe per path rather than conclude from one.
- *
- *   THE FILENAME EMBEDS THE VERSION DATE AND A WRONG ONE IS AN HTTP 400. Not a 404: asking for a date the
- *   host does not hold reads as a malformed request rather than a missing file, which is why the date comes
- *   from the catalogue rather than from a guess. The square brackets must be sent literally, so the URL is
- *   built with them percent-encoded.
- *
- *   TWO CACHE VARIANTS EXIST AND THE BARE ONE IS WANTED. `wss_SSA_IA153_[2025-09-09].zip` is 25,474,922 bytes;
- *   `wss_SSA_IA153_soildb_IA_2003_[2025-09-09].zip` is 27,598,377 and differs only by an EMPTY Microsoft Access
- *   template container for a workflow this program does not use. Confirmed on a second area (`IA015`:
- *   38,981,269 against 41,104,724 bytes) and on a third that ships no template at all (`TX299`, 13,455,641
- *   bytes, 97 files, no `.mdb`).
  */
 import { tryStat } from "@mailwoman/core/fs/readers";
 import { makeDirectories } from "@mailwoman/core/fs/writers";
 import { runFile } from "@mailwoman/core/process";
 import { streamToDisk } from "@mailwoman/core/utils";
-import { join } from "path-ts";
+import { PathBuilder } from "path-ts";
 /**
- * The download service's survey-area cache. Documented at `https://websoilsurvey.sc.egov.usda.gov/DSD/Download/help`,
- * which lists `GET /{CacheName}/{FileName}`.
+ * Points to the Web Soil Survey download cache that serves survey-area archives.
  */
 export const WSS_SSA_CACHE_URL = "https://websoilsurvey.sc.egov.usda.gov/DSD/Download/Cache/SSA";
 /**
- * The archive URL for one survey area at one version date.
- *
- * The brackets are percent-encoded rather than sent raw: they are not valid in a URL path, and a client that sends them
- * literally depends on the fetcher tolerating them.
+ * Returns the archive URL for one survey area at one version date, with the brackets
+ * around the date percent-encoded because they are not valid in a URL path.
  */
 export function surveyAreaArchiveURL(areaSymbol, versionDate) {
     return `${WSS_SSA_CACHE_URL}/wss_SSA_${areaSymbol}_%5B${versionDate}%5D.zip`;
 }
-/**
- * Bytes between progress reports. Smaller than the shared default because these archives are 13–41 MB, and the default
- * stride would leave the smallest of them reporting once.
- */
 const PROGRESS_STRIDE_BYTES = 8 * 1024 * 1024;
-/**
- * What this host answers for a version date it does not hold. NOT a 404: it reads as a malformed request rather than a
- * missing file, which is why the message below says so and why the date comes from the catalogue rather than a guess.
- */
 const UNKNOWN_VERSION_STATUS = 400;
 /**
- * Download and unzip one survey area, returning where its pieces landed.
+ * Downloads and unzips one survey area into the cache, skipping completed steps.
+ * Returns the paths to its files.
  *
- * Downloads to a `.part` file and renames only on a clean finish, so an interrupted transfer never presents as a
- * complete archive — the same discipline the database build uses, for the same reason.
+ * The download goes through a `.part` file so an interrupted transfer never looks like a complete archive.
  *
- * @throws {Error} When the host answers anything but 200, or when the extracted tree does not hold the two directories
- *   every survey area publishes.
+ * @throws {Error} When the host answers anything but 200, or when the extracted
+ * tree lacks the `spatial` or `tabular` directory.
  */
 export async function downloadSurveyArea(options) {
-    const vintageDirectory = join(options.cacheRoot, options.versionDate);
-    const root = join(vintageDirectory, options.areaSymbol);
-    const archivePath = join(vintageDirectory, `wss_SSA_${options.areaSymbol}.zip`);
+    const vintageDirectory = PathBuilder.from(options.cacheRoot)(options.versionDate);
+    const root = vintageDirectory(options.areaSymbol);
+    const archivePath = vintageDirectory(`wss_SSA_${options.areaSymbol}.zip`);
     if (!(await tryStat(root))) {
         await makeDirectories(vintageDirectory);
         if (await tryStat(archivePath)) {
@@ -85,21 +48,18 @@ export async function downloadSurveyArea(options) {
                 describeStatus: (status) => status === UNKNOWN_VERSION_STATUS
                     ? " — this host answers 400 rather than 404 for a version date it does not hold, so check the date against sacatalog.saverest"
                     : undefined,
-                // Every progress line names the area, because a full acquisition interleaves hundreds of them.
                 ...(options.onProgress
                     ? { onProgress: (message) => options.onProgress?.(`${options.areaSymbol}: ${message}`) }
                     : {}),
             });
         }
-        // The archive holds its files under an `<AREASYMBOL>/` root already, so it unzips into the vintage directory
-        // rather than into a directory named for itself.
         await runFile("unzip", ["-o", "-q", archivePath, "-d", vintageDirectory]);
     }
     else {
         options.onProgress?.(`${options.areaSymbol}: already extracted for ${options.versionDate}`);
     }
-    const spatialDirectory = join(root, "spatial");
-    const tabularDirectory = join(root, "tabular");
+    const spatialDirectory = root("spatial");
+    const tabularDirectory = root("tabular");
     for (const directory of [spatialDirectory, tabularDirectory]) {
         if (!(await tryStat(directory))) {
             throw new Error(`soil download: ${options.areaSymbol} extracted without a ${directory} directory — every survey area publishes both spatial/ and tabular/, so this archive is not the product`);

package/out/sdk/download.js.map

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

package/out/sdk/ingest/chunk.d.ts

@@ -0,0 +1,77 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   This streaming pass writes each delineation to `soil_map_unit_area` and the build's touch table.
+ *   It can process part of one survey area as a unit of work.
+ *
+ *   H3's wasm heap cannot be reset from JavaScript. It also cannot sustain unlimited polyfill calls.
+ *   Two runs over the flood layer's real product stopped after roughly 510,000 and 798,000 features.
+ *   The same geometries classify in milliseconds in a fresh process. A build that completes only when
+ *   fragmentation stays low is not reproducible. {@linkcode buildSoilDatabase} bounds each process to a range
+ *   of the shapefile's FIDs. Each range gets a separate process with a fresh heap. Iowa's 99 survey areas
+ *   contain far more delineations together than each area contains by itself. The bound therefore applies per range.
+ *
+ *   The chunk appends rows to a database created by the parent. The parent seals that database and adds up
+ *   the counts returned by each chunk. Chunks run one at a time against the file, so only one writer uses it.
+ */
+import type { DatabaseClient } from "@mailwoman/sqlite/client";
+import type { SoilDatabase } from "#schema";
+import type { SoilFeatureSource } from "#sdk/ingest";
+/**
+ * What one chunk produced.
+ *
+ * Every field is JSON-serializable, because a chunk normally reports across a process boundary.
+ */
+export interface SoilChunkResult {
+    areaSymbol: string;
+    delineations: number;
+    /**
+     * Delineations whose bounding box forced a resolution coarser than the target.
+     */
+    coarsened: number;
+    /**
+     * `[coverageCell, delineationsReachingIt]` pairs — an array rather than a `Map`
+     * so it survives the process boundary.
+     */
+    observedByCoverageCell: Array<[number, number]>;
+    /**
+     * The same, counting only delineations whose map unit has soil mapping behind it.
+     *
+     * Separate from the total because the coverage rule depends on this value.
+     * A cell reached only by `notcom` or access-denied polygons lies inside a published
+     * survey area and contains no digitized soil mapping.
+     *
+     * Section 3.2 of the survey specification assigns no row to that cell.
+     */
+    mappedByCoverageCell: Array<[number, number]>;
+    /**
+     * Square meters computed from the encoded rings, with holes and with every ring treated as exterior.
+     */
+    area: {
+        nestedM2: number;
+        allExteriorM2: number;
+    };
+}
+export interface IngestSoilChunkOptions {
+    source: SoilFeatureSource;
+    indexResolution: number;
+    coverageResolution: number;
+    /**
+     * The map units with no soil mapping behind them — `notcom`, `notpub`,
+     * access denied, or no readable component weights.
+     *
+     * Passed in rather than joined here so the chunk stays a streaming pass over geometry.
+     */
+    noMappingMukeys: ReadonlySet<string>;
+    onProgress?: (message: string) => void;
+}
+/**
+ * Stream one chunk of one survey area into `database`.
+ *
+ * @throws {Error} On a delineation the classifier refuses — which includes the
+ * allocator's silent zero-cell answer.
+ */
+export declare function ingestSoilChunk(database: DatabaseClient<SoilDatabase>, options: IngestSoilChunkOptions): Promise<SoilChunkResult>;
+//# sourceMappingURL=chunk.d.ts.map

package/out/sdk/ingest/chunk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.d.ts","sourceRoot":"","sources":["../../../sdk/ingest/chunk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAE3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAiBpD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,sBAAsB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC/C;;;;;;;;OAQG;IACH,oBAAoB,EAAE,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAC7C;;OAEG;IACH,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAA;CACjD;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,iBAAiB,CAAA;IACzB,eAAe,EAAE,MAAM,CAAA;IACvB,kBAAkB,EAAE,MAAM,CAAA;IAC1B;;;;;OAKG;IACH,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACpC,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACtC;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACpC,QAAQ,EAAE,cAAc,CAAC,YAAY,CAAC,EACtC,OAAO,EAAE,sBAAsB,GAC7B,OAAO,CAAC,eAAe,CAAC,CA2F1B"}

package/out/sdk/{ingest-chunk.js → ingest/chunk.js}

@@ -3,28 +3,29 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   The streaming pass — every delineation into `soil_map_unit_area` and into the build's touch table — as a
- *   unit of work that can run over PART of one survey area.
+ *   This streaming pass writes each delineation to `soil_map_unit_area` and the build's touch table.
+ *   It can process part of one survey area as a unit of work.
  *
- *   WHY THIS IS A CHUNK RATHER THAN A WHOLE FILE. h3's WASM heap cannot be reset from JavaScript, and it does
- *   not survive an unbounded number of polyfill calls: over the flood layer's real product, runs died after
- *   roughly 510,000 and 798,000 features on geometry that classifies in milliseconds in a fresh process. A
- *   build that completes only when fragmentation happens to stay low is not a reproducible build, so the
- *   classification is bounded by construction — {@linkcode buildSoilDatabase} runs one of these per range of
- *   the shapefile's own FIDs, each in its own process, and each therefore against a heap that starts empty.
- *   Iowa's 99 survey areas hold far more delineations together than any one of them does, which is why the
- *   bound is per RANGE rather than per area.
+ *   H3's wasm heap cannot be reset from JavaScript. It also cannot sustain unlimited polyfill calls.
+ *   Two runs over the flood layer's real product stopped after roughly 510,000 and 798,000 features.
+ *   The same geometries classify in milliseconds in a fresh process. A build that completes only when
+ *   fragmentation stays low is not reproducible. {@linkcode buildSoilDatabase} bounds each process to a range
+ *   of the shapefile's FIDs. Each range gets a separate process with a fresh heap. Iowa's 99 survey areas
+ *   contain far more delineations together than each area contains by itself. The bound therefore applies per range.
  *
- *   THE CHUNK OWNS NO ARTIFACT. It appends rows to a database the parent created and will seal, and returns
- *   counts the parent adds up. Chunks run one at a time against that file, so there is no concurrent writer
- *   and no locking to reason about.
+ *   The chunk appends rows to a database created by the parent. The parent seals that database and adds up
+ *   the counts returned by each chunk. Chunks run one at a time against the file, so only one writer uses it.
  */
 import { addCoverageCells, encodeRings, ringAreaReadings, ringsBoundingBox, shortCellToInt } from "@mailwoman/spatial";
 import { beginBatched } from "@mailwoman/sqlite/batched";
 import { classifyDelineationCells } from "#sdk/cells";
 /**
- * Rows per bulk-insert transaction. Chosen for the geometry table, whose rows carry a blob: a larger transaction grows
- * the write-ahead file without improving throughput.
+ * Rows per bulk-insert transaction.
+ *
+ * Chosen for the geometry table.
+ * Each row contains a blob.
+ *
+ * A larger transaction grows the write-ahead file without improving throughput.
  */
 const INSERT_TRANSACTION_ROWS = 5000;
 /**
@@ -34,7 +35,8 @@ const PROGRESS_STRIDE = 20_000;
 /**
  * Stream one chunk of one survey area into `database`.
  *
- * @throws {Error} On a delineation the classifier refuses — which includes the allocator's silent zero-cell answer.
+ * @throws {Error} On a delineation the classifier refuses — which includes the
+ * allocator's silent zero-cell answer.
  */
 export async function ingestSoilChunk(database, options) {
     const insertArea = database.prepare("INSERT INTO soil_map_unit_area (area_id, mukey, areasymbol, min_lat, min_lon, max_lat, max_lon, rings) " +
@@ -95,4 +97,4 @@ export async function ingestSoilChunk(database, options) {
         area: { nestedM2: nestedArea, allExteriorM2: allExteriorArea },
     };
 }
-//# sourceMappingURL=ingest-chunk.js.map
+//# sourceMappingURL=chunk.js.map

package/out/sdk/ingest/chunk.js.map

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

package/out/sdk/ingest/worker.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   One chunk of the soil ingest as its own process, spawned by `buildSoilDatabase` and never run by hand.
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/out/sdk/ingest/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../sdk/ingest/worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/out/{scripts/ingest-chunk.js → sdk/ingest/worker.js}

@@ -3,14 +3,12 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   One chunk of the soil ingest, as its own process — spawned by `buildSoilDatabase`, never run by hand.
- *   The process boundary and the stdout contract live with `runIngestChunkScript`; what stays here is only
- *   this product's flags and its feature-source constructor.
+ *   One chunk of the soil ingest as its own process, spawned by `buildSoilDatabase` and never run by hand.
  */
 import { requiredArgument } from "@mailwoman/core/scripting/arguments";
 import { INGEST_CHUNK_FLAGS, runIngestChunkScript } from "@mailwoman/core/scripting/ingest-chunk-script";
 import { createShapefileFeatureSource } from "#sdk/ingest";
-import { ingestSoilChunk } from "#sdk/ingest-chunk";
+import { ingestSoilChunk } from "#sdk/ingest/chunk";
 await runIngestChunkScript({
     context: "soil ingest-chunk",
     options: {
@@ -27,16 +25,19 @@ await runIngestChunkScript({
             areaSymbol: requiredArgument("soil ingest-chunk", "area-symbol", values["area-symbol"]),
             fidFrom: Number(requiredArgument("soil ingest-chunk", "fid-from", values["fid-from"])),
             fidTo: Number(requiredArgument("soil ingest-chunk", "fid-to", values["fid-to"])),
-            // A range's own count is not knowable up front — `ogrinfo` reports the layer's total and nothing narrower — so
-            // the chunk asserts nothing about its size and the PARENT checks the per-area sum against the shapefile's.
+            // A range's own count is not knowable up front — `ogrinfo` reports the layer's total
+            // and no narrower count — so the chunk makes no assertion about its size
+            // and the parent checks the per-area sum against the shapefile's.
             declaredFeatureCount: 0,
         }),
         indexResolution: chunk.indexResolution,
         coverageResolution: chunk.coverageResolution,
-        // An empty string is an empty set, not "every map unit": a build where nothing lacks soil mapping passes one, and
-        // `"".split(",")` yields one empty element that has to be dropped rather than joined against as a mukey.
-        noMappingMukeys: new Set((values["no-mapping-mukeys"] ?? "").split(",").filter((mukey) => mukey.length > 0)),
+        // An empty string is an empty set rather than "every map unit": a build
+        // where every map unit has soil mapping passes one.
+        // `"".split(",")` yields one empty element that has to be dropped
+        // rather than joined against as a mukey.
+        noMappingMukeys: new Set((values["no-mapping-mukeys"] ?? "").split(",").filter((mukey) => mukey.length)),
         onProgress: chunk.onProgress,
     }),
 });
-//# sourceMappingURL=ingest-chunk.js.map
+//# sourceMappingURL=worker.js.map

package/out/sdk/ingest/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../sdk/ingest/worker.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAA;AACtE,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAA;AAIxG,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEnD,MAAM,oBAAoB,CAAC;IAC1B,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE;QACR,GAAG,kBAAkB;QACrB,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC7B,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACjC,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC9B,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC5B,mBAAmB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACvC;IACD,GAAG,EAAE,KAAK,EAAE,QAAsC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CACpE,eAAe,CAAC,QAAQ,EAAE;QACzB,MAAM,EAAE,MAAM,4BAA4B,CAAC;YAC1C,aAAa,EAAE,gBAAgB,CAAC,mBAAmB,EAAE,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC;YACnF,UAAU,EAAE,gBAAgB,CAAC,mBAAmB,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC;YACvF,OAAO,EAAE,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;YACtF,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAChF,qFAAqF;YACrF,yEAAyE;YACzE,kEAAkE;YAClE,oBAAoB,EAAE,CAAC;SACvB,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,eAAe;QACtC,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,wEAAwE;QACxE,oDAAoD;QACpD,kEAAkE;QAClE,yCAAyC;QACzC,eAAe,EAAE,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QACxG,UAAU,EAAE,KAAK,CAAC,UAAU;KAC5B,CAAC;CACH,CAAC,CAAA"}

package/out/sdk/ingest.d.ts

@@ -2,47 +2,26 @@
  * @copyright Sister Software
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
- *
- *   Read a survey area's published shapefiles as a stream of WGS84 delineations, through ogr2ogr.
- *
- *   OGR IS BUILD TOOLING, NEVER A SERVE DEPENDENCY (SCOPE invariant 6). It converts the authority's geometry
- *   into the structure the runtime probes, and nothing downstream of this module knows GDAL exists.
- *
- *   THE SOURCE IS ALREADY IN WGS84, AND CHECKING IT IS STILL THE CHECK. Each `.prj` is an ESRI WKT reading
- *   `GEOGCS["GCS_WGS_1984",…]`, which GDAL resolves to EPSG:4326 — so no reprojection is needed before H3.
- *   The authority code is asserted anyway before a single feature is read, and the reprojected stream is
- *   asserted against the layer's own declared extent, which is the check that catches a coordinate-order
- *   mistake the projection check cannot see.
- *
- *   THE DATUM GUARD RUNS EVEN THOUGH THE ANSWER IS THE IDENTITY, AND THAT IS THE POINT. PROJ substitutes a
- *   ballpark datum shift SILENTLY when the accurate grid is missing — measured on the flood layer at 3.4 m
- *   over an entire country, visible only as eight disagreements out of 59 against the authority's own
- *   service. For an EPSG:4326 source `projinfo` answers `Null geographic offset from WGS 84 to WGS 84, 0 m,
- *   World.` and the guard passes in one process. Skipping it on the reasoning that this source needs no
- *   shift is how the guard comes to be missing on the day a source arrives that does.
- *
- *   THE ID IS THE SHAPEFILE'S OWN FID, AND IT HAS TO BE, because SSURGO publishes no per-delineation key:
- *   `MUKEY` names the MAP UNIT and one map unit has many delineations — `IA153` holds 17,966 delineations
- *   across 152 map units. So `area_id` is `<areasymbol>:<fid>`, which is stable across runs and is what makes
- *   a bounded chunk name the same features every time.
  */
 import { type MultiPolygonRings } from "@mailwoman/spatial";
+import { PathBuilder, type PathBuilderLike } from "path-ts";
 /**
- * The shapefile holding a survey area's map-unit polygons — the delineations this layer stores.
+ * Returns the path of the shapefile that holds a survey area's map-unit polygons.
  */
-export declare function mapUnitShapefile(spatialDirectory: string, areaSymbol: string): string;
+export declare function mapUnitShapefile(spatialDirectory: PathBuilderLike, areaSymbol: string): string;
 /**
- * The shapefile holding a survey area's own OUTLINE. The footprint comes from HERE and never from the union of the
- * rated polygons — `NOTCOM` and access-denied map units are inside the footprint and carry no rating, so a footprint
- * derived from the rated set would report them as unmapped when the authority has declared exactly what they are.
+ * Returns the path of the shapefile holding a survey area's outline.
+ *
+ * The build takes the footprint from this outline because unrated map units such as `notcom` lie inside it.
+ * A union of rated polygons would leave them out.
  */
-export declare function surveyAreaShapefile(spatialDirectory: string, areaSymbol: string): string;
+export declare function surveyAreaShapefile(spatialDirectory: PathBuilderLike, areaSymbol: string): PathBuilder;
 /**
  * One map-unit delineation, reprojected to WGS84.
  */
 export interface SoilDelineation {
     /**
-     * `<areasymbol>:<fid>`.
+     * The delineation's identifier, formed as `<areasymbol>:<fid>`.
      */
     areaID: string;
     mukey: string;
@@ -50,80 +29,89 @@ export interface SoilDelineation {
     polygons: MultiPolygonRings;
 }
 /**
- * What a shapefile says about itself, read before any feature is.
+ * The metadata that a shapefile declares, read before any feature.
  */
 export interface SoilSourceIdentity {
     epsg: number;
     featureCount: number;
     layer: string;
     /**
-     * The layer's own declared extent, `[minLon, minLat, maxLon, maxLat]`.
+     * The layer's declared extent as `[minLon, minLat, maxLon, maxLat]`.
      */
     bbox: readonly [number, number, number, number];
 }
+/**
+ * Options for reading one SSURGO map-unit shapefile.
+ */
 export interface SoilIngestOptions {
     shapefilePath: string;
     /**
-     * Layer inside it. Defaults to the shapefile's base name, which is what the ESRI driver reports.
+     * The layer inside the shapefile.
+     *
+     * The default is the file's base name.
+     * The ESRI driver reports that name.
      */
     layer?: string;
     /**
-     * The EPSG code the source must declare.
+     * The EPSG code that the source must declare.
+     * The default is the SSURGO source projection.
      */
     expectEPSG?: number;
     /**
-     * Read only the shapefile's own FIDs in `[fidFrom, fidTo]`, inclusive — what makes a bounded chunk possible.
+     * The inclusive range of shapefile FIDs to read.
+     * A build can use it to read one chunk.
      */
     fidFrom?: number;
     fidTo?: number;
     /**
-     * Stop after this many features. The fixture and smoke rungs use it; a full build does not set it.
+     * The maximum number of features to read.
+     * Fixture and smoke runs use it.
      */
     limit?: number;
 }
 /**
- * Read what the shapefile declares about itself, and refuse a projection this ingest was not written for.
+ * Reads the projection, feature count, layer name and extent that a shapefile declares.
  *
- * @throws {Error} When the layer is missing, declares no EPSG authority code, declares one other than `expectEPSG`, or
- *   reports no feature count.
+ * It throws when the shapefile declares a projection other than `expectEPSG`.
  */
 export declare function readSoilSourceIdentity(options: SoilIngestOptions): Promise<SoilSourceIdentity>;
 /**
- * Stream the map-unit delineations as WGS84 features.
+ * Streams a shapefile's map-unit delineations reprojected to WGS84.
  *
- * Every feature is checked against the declared extent as it passes. A swapped coordinate order survives a projection
- * check — both axes are still numbers in a plausible range — and shows up here immediately.
+ * It throws when a feature lacks geometry or `mukey`.
+ * It also throws when a vertex falls outside the declared extent.
  *
- * @throws {Error} When ogr2ogr fails, when a feature carries no geometry or no `MUKEY`, or when a vertex falls outside
- *   the declared extent.
+ * The extent check catches swapped coordinate axes that the projection check misses.
  */
 export declare function readSoilDelineations(options: SoilIngestOptions & {
     bbox: readonly [number, number, number, number];
 }): AsyncGenerator<SoilDelineation>;
 /**
- * Where a build's delineations come from, and what the source declares about itself.
+ * Supplies a soil build with its delineations and the source's declared identity.
  *
- * The builder takes ONE of these rather than a path, which is what makes the fixture rung possible: hand-built geometry
- * with no network and no GDAL still exercises the whole database half — the domain check, the cell classification, the
- * reduction, the coverage rows, the manifest and the seal.
+ * The builder takes this instead of a path so that fixtures can run the database
+ * build without network access or GDAL.
  */
 export interface SoilFeatureSource {
     areaSymbol: string;
     /**
-     * What the source says it holds. The build compares its own streamed total against this, so a short read throws
-     * instead of building a smaller county.
+     * The feature count that the source declares.
+     *
+     * The build throws when its streamed total differs from this count.
      */
     declaredFeatureCount: number;
     layer: string;
     epsg: number;
     /**
-     * A description of where these delineations came from, for the receipt.
+     * A description of where the delineations came from, such as the shapefile path.
      */
     origin: string;
     delineations: () => AsyncIterable<SoilDelineation>;
 }
 /**
- * One survey area's map-unit shapefile as a feature source — identity read up front, features streamed on demand.
+ * Creates a {@link SoilFeatureSource} for one survey area's shapefile.
+ *
+ * It reads the shapefile's identity immediately and streams features when asked.
  */
 export declare function createShapefileFeatureSource(options: SoilIngestOptions & {
     areaSymbol: string;

package/out/sdk/ingest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../lib/sdk/ingest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,EAAiD,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAsB1G;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAErF;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAExF;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,iBAAiB,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/C;AAED,MAAM,WAAW,iBAAiB;IACjC,aAAa,EAAE,MAAM,CAAA;IACrB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAepG;AAyBD;;;;;;;;GAQG;AACH,wBAAuB,oBAAoB,CAC1C,OAAO,EAAE,iBAAiB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9E,cAAc,CAAC,eAAe,CAAC,CAuBjC;AAqCD;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,aAAa,CAAC,eAAe,CAAC,CAAA;CAClD;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CACjD,OAAO,EAAE,iBAAiB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF,OAAO,CAAC,iBAAiB,CAAC,CAiB5B"}
+{"version":3,"file":"ingest.d.ts","sourceRoot":"","sources":["../../sdk/ingest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAiD,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAA;AAG1G,OAAO,EAAY,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAQrE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,gBAAgB,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAEtG;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC/B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;IACb,UAAU,EAAE,MAAM,CAAA;IAClB,QAAQ,EAAE,iBAAiB,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IAEb;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,aAAa,EAAE,MAAM,CAAA;IAErB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,KAAK,CAAC,EAAE,MAAM,CAAA;IAEd;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAA;CACd;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAepG;AAsBD;;;;;;;GAOG;AACH,wBAAuB,oBAAoB,CAC1C,OAAO,EAAE,iBAAiB,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAC9E,cAAc,CAAC,eAAe,CAAC,CAsBjC;AAkCD;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,UAAU,EAAE,MAAM,CAAA;IAElB;;;;OAIG;IACH,oBAAoB,EAAE,MAAM,CAAA;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IAEZ;;OAEG;IACH,MAAM,EAAE,MAAM,CAAA;IACd,YAAY,EAAE,MAAM,aAAa,CAAC,eAAe,CAAC,CAAA;CAClD;AAED;;;;GAIG;AACH,wBAAsB,4BAA4B,CACjD,OAAO,EAAE,iBAAiB,GAAG;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GAChF,OAAO,CAAC,iBAAiB,CAAC,CAgB5B"}