@mailwoman/bdc 8.3.0

package/out/sdk/data-collection.js

@@ -0,0 +1,50 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file FCC Broadband Data Collection System
+ */
+/**
+ * Code indicating confidence in the association between the textual address and the location.
+ *
+ * @category NTIA
+ * @category FCC
+ */
+export const AddressConfidenceCode = {
+    High: "1",
+    Medium: "2",
+    Low: "3",
+    SuccessfulChallenge: "4",
+};
+/**
+ * A modeled land use designation estimated from assembled county assessor information.
+ *
+ * @category NTIA
+ * @category FCC
+ */
+export const LandUseCode = {
+    Residential: 1,
+    Land: 2,
+    Business: 3,
+    Unknown: 4,
+    Agriculture: 5,
+    Community: 6,
+    Industrial: 7,
+    Recreation: 8,
+    Utility: 9,
+    MixedUse: 10,
+    Transportation: 11,
+    Water: 12,
+    Communications: 13,
+    Row: 14,
+    Wireless: 15,
+    Other: 0,
+};
+/**
+ * Flag indicating if the location is a broadband serviceable location.
+ */
+export const BSLFlag = {
+    Serviceable: 1,
+    NotServiceable: 0,
+};
+//# sourceMappingURL=data-collection.js.map

package/out/sdk/data-collection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-collection.js","sourceRoot":"","sources":["../../sdk/data-collection.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,IAAI,EAAE,GAAG;IACT,MAAM,EAAE,GAAG;IACX,GAAG,EAAE,GAAG;IACR,mBAAmB,EAAE,GAAG;CACf,CAAA;AAQV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IAC1B,WAAW,EAAE,CAAC;IACd,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,UAAU,EAAE,CAAC;IACb,UAAU,EAAE,CAAC;IACb,OAAO,EAAE,CAAC;IACV,QAAQ,EAAE,EAAE;IACZ,cAAc,EAAE,EAAE;IAClB,KAAK,EAAE,EAAE;IACT,cAAc,EAAE,EAAE;IAClB,GAAG,EAAE,EAAE;IACP,QAAQ,EAAE,EAAE;IACZ,KAAK,EAAE,CAAC;CACC,CAAA;AAQV;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,WAAW,EAAE,CAAC;IACd,cAAc,EAAE,CAAC;CACR,CAAA"}

package/out/sdk/download.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file FCC BDC availability-file download + zip extraction.
+ *
+ *   Re-homed from Nexus's `sync/fcc/bdc/download-file.ts` (relicense-by-copy, no provenance headers),
+ *   trimmed hard: the Nexus original downloaded AND cached the `.zip`, extracted it, THEN wrote a Parquet
+ *   file with a row-count integrity check. All Parquet machinery is dropped here — 2a's `bdc.db` is
+ *   SQLite, not Parquet-backed (see Task 7+) — and the `.zip` itself isn't cached either; only the
+ *   extracted CSV is written to `destinationDir`, and its presence alone is the cache check.
+ *
+ *   The zip-extraction library also changes: the Nexus original's `extractSingleFileZip` used `adm-zip`
+ *   (a repo-wide Nexus dependency). No unzip dependency exists anywhere in this repo — every workspace
+ *   `package.json` was checked, `tiger/` and `osm/` included — so `yauzl-promise` is added to `bdc` alone
+ *   (noted in this task's commit body per the brief).
+ */
+import type { BDCClient } from "./client.ts";
+import { type BDCFile } from "./common.ts";
+/**
+ * Download and cache an FCC BDC availability file, extracting its zip-wrapped CSV to `destinationDir`.
+ *
+ * Cache-if-exists: if the extracted CSV already exists at the destination path, this returns immediately without
+ * issuing any network request. Otherwise it downloads the zip via `client`, extracts the CSV, writes it to
+ * `destinationDir`, and returns the written path. Only the extracted CSV is ever cached — the intermediate `.zip` is
+ * never written to disk.
+ *
+ * THIS FILE OWNS THE CACHE FOR THE DOWNLOAD PATH, which is why `BDCClient.getArrayBuffer` switches the client's own
+ * response cache off: the `existsSync`-equivalent check above is the real cache hit, and running a
+ * multi-hundred-megabyte archive through a JSON-validating disk cache would write a second, unreadable copy of a file
+ * already on disk here.
+ *
+ * @returns The path of the extracted (and now cached) CSV file.
+ */
+export declare function downloadBDCFile(client: BDCClient, file: BDCFile, destinationDir: string): Promise<string>;
+//# sourceMappingURL=download.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../sdk/download.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAA;AA+B7D;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoB/G"}

package/out/sdk/download.js

@@ -0,0 +1,76 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file FCC BDC availability-file download + zip extraction.
+ *
+ *   Re-homed from Nexus's `sync/fcc/bdc/download-file.ts` (relicense-by-copy, no provenance headers),
+ *   trimmed hard: the Nexus original downloaded AND cached the `.zip`, extracted it, THEN wrote a Parquet
+ *   file with a row-count integrity check. All Parquet machinery is dropped here — 2a's `bdc.db` is
+ *   SQLite, not Parquet-backed (see Task 7+) — and the `.zip` itself isn't cached either; only the
+ *   extracted CSV is written to `destinationDir`, and its presence alone is the cache check.
+ *
+ *   The zip-extraction library also changes: the Nexus original's `extractSingleFileZip` used `adm-zip`
+ *   (a repo-wide Nexus dependency). No unzip dependency exists anywhere in this repo — every workspace
+ *   `package.json` was checked, `tiger/` and `osm/` included — so `yauzl-promise` is added to `bdc` alone
+ *   (noted in this task's commit body per the brief).
+ */
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { fromBuffer } from "yauzl-promise";
+import { BDCFilingDataType } from "./common.js";
+/**
+ * Extract the first file entry of a zip archive buffer into a single in-memory `Buffer`.
+ *
+ * BDC availability downloads are always a single zip-wrapped CSV, so — like the Nexus original — this doesn't walk
+ * every entry, just the first non-directory one.
+ */
+async function extractSingleFileZip(zippedBuffer) {
+    const zip = await fromBuffer(zippedBuffer);
+    try {
+        for await (const entry of zip) {
+            if (entry.filename.endsWith("/"))
+                continue;
+            const readStream = await entry.openReadStream();
+            const chunks = [];
+            for await (const chunk of readStream) {
+                chunks.push(chunk);
+            }
+            return Buffer.concat(chunks);
+        }
+        throw new Error("extractSingleFileZip: no file entries found in zip archive.");
+    }
+    finally {
+        await zip.close();
+    }
+}
+/**
+ * Download and cache an FCC BDC availability file, extracting its zip-wrapped CSV to `destinationDir`.
+ *
+ * Cache-if-exists: if the extracted CSV already exists at the destination path, this returns immediately without
+ * issuing any network request. Otherwise it downloads the zip via `client`, extracts the CSV, writes it to
+ * `destinationDir`, and returns the written path. Only the extracted CSV is ever cached — the intermediate `.zip` is
+ * never written to disk.
+ *
+ * THIS FILE OWNS THE CACHE FOR THE DOWNLOAD PATH, which is why `BDCClient.getArrayBuffer` switches the client's own
+ * response cache off: the `existsSync`-equivalent check above is the real cache hit, and running a
+ * multi-hundred-megabyte archive through a JSON-validating disk cache would write a second, unreadable copy of a file
+ * already on disk here.
+ *
+ * @returns The path of the extracted (and now cached) CSV file.
+ */
+export async function downloadBDCFile(client, file, destinationDir) {
+    const csvPath = path.join(destinationDir, `${file.fileName}.csv`);
+    const alreadyCached = await fs
+        .access(csvPath)
+        .then(() => true)
+        .catch(() => false);
+    if (alreadyCached)
+        return csvPath;
+    const zippedArrayBuffer = await client.getArrayBuffer(`/map/downloads/downloadFile/${BDCFilingDataType.Availability}/${file.fileID}`);
+    const csvBuffer = await extractSingleFileZip(Buffer.from(zippedArrayBuffer));
+    await fs.mkdir(destinationDir, { recursive: true });
+    await fs.writeFile(csvPath, csvBuffer);
+    return csvPath;
+}
+//# sourceMappingURL=download.js.map

package/out/sdk/download.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../sdk/download.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAA;AAG1C,OAAO,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAA;AAE7D;;;;;GAKG;AACH,KAAK,UAAU,oBAAoB,CAAC,YAAoB;IACvD,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,YAAY,CAAC,CAAA;IAE1C,IAAI,CAAC;QACJ,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,EAAE,CAAC;YAC/B,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;gBAAE,SAAQ;YAE1C,MAAM,UAAU,GAAG,MAAM,KAAK,CAAC,cAAc,EAAE,CAAA;YAC/C,MAAM,MAAM,GAAa,EAAE,CAAA;YAE3B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACnB,CAAC;YAED,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;QAC7B,CAAC;QAED,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAA;IAC/E,CAAC;YAAS,CAAC;QACV,MAAM,GAAG,CAAC,KAAK,EAAE,CAAA;IAClB,CAAC;AACF,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,MAAiB,EAAE,IAAa,EAAE,cAAsB;IAC7F,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,IAAI,CAAC,QAAQ,MAAM,CAAC,CAAA;IAEjE,MAAM,aAAa,GAAG,MAAM,EAAE;SAC5B,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC;SAChB,KAAK,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,CAAA;IAEpB,IAAI,aAAa;QAAE,OAAO,OAAO,CAAA;IAEjC,MAAM,iBAAiB,GAAG,MAAM,MAAM,CAAC,cAAc,CACpD,+BAA+B,iBAAiB,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,EAAE,CAC9E,CAAA;IAED,MAAM,SAAS,GAAG,MAAM,oBAAoB,CAAC,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAA;IAE5E,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IACnD,MAAM,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC,CAAA;IAEtC,OAAO,OAAO,CAAA;AACf,CAAC"}

package/out/sdk/filing-dates.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file FCC BDC filing-date discovery + vintage resolution.
+ *
+ *   Re-homed from Nexus's `sync/fcc/bdc/filing-dates.ts` (relicense-by-copy, no provenance
+ *   headers): the `$BCDClient`-bound `retrieveFilingDates()` → a plain function taking a
+ *   {@linkcode BDCClient}.
+ *
+ *   CACHING MOVED TO THE CLIENT. Both the Nexus original (one `<filingType>-dates.json` per filing
+ *   type) and this port's first cut (`dataRootPath("bdc", "cache", "filing-dates.json")`, unfiltered)
+ *   hand-rolled a JSON file cache here. `BDCClient` is built on `APIClient` and now carries an on-disk
+ *   response cache of its own, so the hand-rolled one was the exact duplication that migration exists to
+ *   remove — and it was worse than what replaced it: it had NO expiry, so a machine that resolved a
+ *   vintage once would never see the next one FCC published without an explicit `skipCache`. The
+ *   client's cache has a TTL chosen against the filing cadence, and `skipCache` now maps onto a
+ *   per-request cache bypass with the same meaning it always had.
+ */
+import type { BDCClient } from "./client.ts";
+import type { BDCFilingDataType } from "./common.ts";
+/**
+ * One entry from the FCC BDC's `/map/listAsOfDates` endpoint.
+ */
+export interface FCCAsOfDateEntry {
+    data_type: BDCFilingDataType;
+    /**
+     * @format date
+     */
+    as_of_date: string;
+}
+export interface RetrieveFilingDatesParams {
+    /**
+     * Which filing type's dates to return — the full cached/fetched set is filtered down to this type.
+     */
+    filingType: BDCFilingDataType;
+    /**
+     * Bypass the client's response cache and always fetch fresh from the API. Defaults to `false`.
+     */
+    skipCache?: boolean;
+}
+/**
+ * Retrieve the FCC BDC's available filing `as_of_date`s for a given filing type.
+ *
+ * One `listAsOfDates` call answers every filing type — the full unfiltered response is what the client caches, and this
+ * filters it down on read — so asking for a second filing type inside the TTL costs no request at all. At ten requests
+ * per minute that is worth six seconds each time.
+ */
+export declare function retrieveFilingDates(client: BDCClient, { filingType, skipCache }: RetrieveFilingDatesParams): Promise<FCCAsOfDateEntry[]>;
+/**
+ * Pick the latest (most recent) `as_of_date` among `entries` for the given `dataType`.
+ *
+ * Comparison is by parsed `Date` value, not string ordering — the FCC's `as_of_date` values are `date`-formatted
+ * (`YYYY-MM-DD`), which happens to sort correctly as strings too, but comparing as dates is the honest contract.
+ */
+export declare function resolveLatestVintage(entries: readonly FCCAsOfDateEntry[], dataType: BDCFilingDataType): string;
+//# sourceMappingURL=filing-dates.d.ts.map

package/out/sdk/filing-dates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filing-dates.d.ts","sourceRoot":"","sources":["../../sdk/filing-dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAA;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,iBAAiB,CAAA;IAC5B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CAClB;AAMD,MAAM,WAAW,yBAAyB;IACzC;;OAEG;IACH,UAAU,EAAE,iBAAiB,CAAA;IAC7B;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,SAAS,EACjB,EAAE,UAAU,EAAE,SAAiB,EAAE,EAAE,yBAAyB,GAC1D,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAI7B;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,EAAE,QAAQ,EAAE,iBAAiB,GAAG,MAAM,CAgB9G"}

package/out/sdk/filing-dates.js

@@ -0,0 +1,50 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ * @file FCC BDC filing-date discovery + vintage resolution.
+ *
+ *   Re-homed from Nexus's `sync/fcc/bdc/filing-dates.ts` (relicense-by-copy, no provenance
+ *   headers): the `$BCDClient`-bound `retrieveFilingDates()` → a plain function taking a
+ *   {@linkcode BDCClient}.
+ *
+ *   CACHING MOVED TO THE CLIENT. Both the Nexus original (one `<filingType>-dates.json` per filing
+ *   type) and this port's first cut (`dataRootPath("bdc", "cache", "filing-dates.json")`, unfiltered)
+ *   hand-rolled a JSON file cache here. `BDCClient` is built on `APIClient` and now carries an on-disk
+ *   response cache of its own, so the hand-rolled one was the exact duplication that migration exists to
+ *   remove — and it was worse than what replaced it: it had NO expiry, so a machine that resolved a
+ *   vintage once would never see the next one FCC published without an explicit `skipCache`. The
+ *   client's cache has a TTL chosen against the filing cadence, and `skipCache` now maps onto a
+ *   per-request cache bypass with the same meaning it always had.
+ */
+/**
+ * Retrieve the FCC BDC's available filing `as_of_date`s for a given filing type.
+ *
+ * One `listAsOfDates` call answers every filing type — the full unfiltered response is what the client caches, and this
+ * filters it down on read — so asking for a second filing type inside the TTL costs no request at all. At ten requests
+ * per minute that is worth six seconds each time.
+ */
+export async function retrieveFilingDates(client, { filingType, skipCache = false }) {
+    const body = await client.get("/map/listAsOfDates", undefined, { skipCache });
+    return body.data.filter((entry) => entry.data_type === filingType);
+}
+/**
+ * Pick the latest (most recent) `as_of_date` among `entries` for the given `dataType`.
+ *
+ * Comparison is by parsed `Date` value, not string ordering — the FCC's `as_of_date` values are `date`-formatted
+ * (`YYYY-MM-DD`), which happens to sort correctly as strings too, but comparing as dates is the honest contract.
+ */
+export function resolveLatestVintage(entries, dataType) {
+    const matching = entries.filter((entry) => entry.data_type === dataType);
+    if (!matching.length) {
+        throw new Error(`resolveLatestVintage: no filing-date entries found for data_type "${dataType}"`);
+    }
+    let latest = matching[0];
+    for (const entry of matching) {
+        if (new Date(entry.as_of_date).getTime() > new Date(latest.as_of_date).getTime()) {
+            latest = entry;
+        }
+    }
+    return latest.as_of_date;
+}
+//# sourceMappingURL=filing-dates.js.map

package/out/sdk/filing-dates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filing-dates.js","sourceRoot":"","sources":["../../sdk/filing-dates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA+BH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,MAAiB,EACjB,EAAE,UAAU,EAAE,SAAS,GAAG,KAAK,EAA6B;IAE5D,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,GAAG,CAA4B,oBAAoB,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IAExG,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,UAAU,CAAC,CAAA;AACnE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoC,EAAE,QAA2B;IACrG,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAA;IAExE,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,qEAAqE,QAAQ,GAAG,CAAC,CAAA;IAClG,CAAC;IAED,IAAI,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAE,CAAA;IAEzB,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC9B,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC;YAClF,MAAM,GAAG,KAAK,CAAA;QACf,CAAC;IACF,CAAC;IAED,OAAO,MAAM,CAAC,UAAU,CAAA;AACzB,CAAC"}

package/out/sdk/filing-landscape.d.ts

@@ -0,0 +1,124 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `filing_landscape` reader (2a Task 9) — the FOUR PRE-REGISTERED ACCEPTANCE GATES this whole phase
+ *   is judged by. See `filing-landscape.test.ts` for the gate tests; this module is only the reader.
+ *
+ *   Coverage check (the meaning-of-zero rule): a queried block counts as SURVEYED only when its res-6
+ *   coverage cell is present in `layer_coverage` (via `readLayerCoverage`) — `undefined` means the area
+ *   was never surveyed, and the block is reported in `unknown_block_count`, NEVER folded into a
+ *   zero-filing claim.
+ *
+ *   - For a `geoids` query, the candidate res-9 cell is read off the block's OWN `bdc_availability`
+ *     rows — a geoid with zero rows has no derivable cell at all (never guessed, matching the builder's
+ *     "unknown geoid" discipline in `build-bdc.ts`), so it falls straight to unknown.
+ *   - For an `h3Cells` query, the caller supplies the res-9 cell directly, so coverage can be checked
+ *     even for a cell with no filing rows of its own — a genuine "surveyed, zero providers here" result,
+ *     the meaning-of-zero rule's POSITIVE case (covered but empty is not the same as never surveyed).
+ *
+ *   Res-9 → res-6 parent reconstruction is deliberately NOT `@mailwoman/spatial`'s `expandH3Cell` — that
+ *   helper's left-shift reconstruction only round-trips a short cell that was shortened AT resolution
+ *   15 (the address-id spine); fed a resolution-9 short cell it silently produces a full index
+ *   `cellToParent` rejects (`Cell arguments had incompatible resolutions`), verified empirically while
+ *   building this reader. The correct reconstruction for a short cell captured at a KNOWN resolution R
+ *   is a straight concatenation, not a shift: a full 64-bit H3 cell index is always
+ *   `"8" + <resolution nibble> + <52 bits of base-cell + digit path, trailing padding included>`, and
+ *   the 48-bit "short" form (`shortCellToInt`/`shortenH3Cell`) already carries exactly those low 52 bits
+ *   verbatim — so `"8" + R.toString(16) + shortHex.padStart(13, "0")` reassembles the identical full
+ *   index `latLngToCell` would have produced at resolution R. See {@link res9ShortCellToRes6Parent}.
+ *
+ *   This same formula is exactly what `build-bdc.ts` MUST use (and does, after fix round 1) to derive the
+ *   coverage cell it writes at build time — H3's cell hierarchy is not geometrically exact, so a
+ *   `latLngToCell(centroid, 6)` computed independently of the stored res-9 cell disagrees with
+ *   `cellToParent(res9Cell, 6)` for a real fraction of points (verified ~6% over CONUS). Builder and
+ *   reader deriving the res-6 parent differently was a real bug (fix round 1): a genuinely-surveyed block
+ *   (real rows, real `layer_coverage` entry) could read back as `unknown_block_count` while its own rows
+ *   still populated `filings` — a self-contradiction. `filings` is now scoped to units that PASS the
+ *   coverage check (see the `surveyedUnits` accumulator below) precisely so that can't happen again: a
+ *   block excluded from `surveyed_block_count` never contributes to `filings` either.
+ */
+import type { DatabaseClient } from "@mailwoman/core/kysley/client";
+import { type BDCDatabase } from "../schema.ts";
+/**
+ * Exactly one of `geoids` or `h3Cells` is required — `filingLandscape` throws otherwise.
+ */
+export interface FilingLandscapeQuery {
+    geoids?: string[];
+    h3Cells?: number[];
+}
+/**
+ * One provider/technology/speed-bucket group's block count within the query — `block_count` is the number of DISTINCT
+ * queried blocks carrying this exact combination, never a raw row count. A block can carry multiple `bdc_availability`
+ * rows for the SAME (provider_id, technology_code) pair even in the DEFAULT (non-`includeLocationIDs`) build mode:
+ * `build-bdc.ts`'s materialize-time collapse merges to one row per distinct (geoid, provider_id, technology_code,
+ * speeds, low_latency, business_residential_code) tuple, not one row per (geoid, provider_id, technology_code) triple —
+ * so Broadband Serviceable Locations at the same triple with DIFFERING speeds/flags survive as separate rows and can
+ * land in different `speed_bucket`s here (see that file's docstring). This `block_count`'s DISTINCT is exactly what
+ * keeps that from double-counting the block itself when it does.
+ */
+export interface ProviderFilingSummary {
+    provider_id: number;
+    technology_code: number;
+    speed_bucket: string;
+    block_count: number;
+}
+/**
+ * The queried landscape: ALWAYS vintage-stamped (from `layer_manifest.sourceVintage`) and ALWAYS reports its unknown
+ * blocks — `unknown_block_count` is reported, never zeroed, and never evidence of "no providers file here."
+ */
+export interface FilingLandscape {
+    vintage: string;
+    surveyed_block_count: number;
+    unknown_block_count: number;
+    filings: ProviderFilingSummary[];
+}
+/**
+ * `speed_bucket` label for a block whose `max_advertised_download_speed` is below
+ * {@link BDC_SPEED_BUCKET_THRESHOLD_25_MBPS} Mbps.
+ */
+export declare const BDC_SPEED_BUCKET_UNDER_25 = "under-25";
+/**
+ * `speed_bucket` label for `BDC_SPEED_BUCKET_THRESHOLD_25_MBPS <= speed < BDC_SPEED_BUCKET_THRESHOLD_100_MBPS`.
+ */
+export declare const BDC_SPEED_BUCKET_25_100 = "25-100";
+/**
+ * `speed_bucket` label for `BDC_SPEED_BUCKET_THRESHOLD_100_MBPS <= speed < BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS`.
+ */
+export declare const BDC_SPEED_BUCKET_100_1000 = "100-1000";
+/**
+ * `speed_bucket` label for a block whose `max_advertised_download_speed` is at or above
+ * {@link BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS} Mbps.
+ */
+export declare const BDC_SPEED_BUCKET_GIGABIT = "gigabit";
+/**
+ * Upper-exclusive Mbps boundary between {@link BDC_SPEED_BUCKET_UNDER_25} and {@link BDC_SPEED_BUCKET_25_100}.
+ */
+export declare const BDC_SPEED_BUCKET_THRESHOLD_25_MBPS = 25;
+/**
+ * Upper-exclusive Mbps boundary between {@link BDC_SPEED_BUCKET_25_100} and {@link BDC_SPEED_BUCKET_100_1000}.
+ */
+export declare const BDC_SPEED_BUCKET_THRESHOLD_100_MBPS = 100;
+/**
+ * Mbps boundary at/above which a block is bucketed {@link BDC_SPEED_BUCKET_GIGABIT}.
+ */
+export declare const BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS = 1000;
+/**
+ * Pure mirror of the SQL `CASE` expression below ({@link speedBucketCaseSQL}) — same thresholds, same labels, exported
+ * so the boundary logic can be asserted directly without a database round trip.
+ */
+export declare function speedBucketForDownloadSpeed(maxAdvertisedDownloadSpeed: number): string;
+/**
+ * Reconstruct the res-6 ancestor of a res-9 short-cell int WITHOUT a centroid — see the module docstring for why this
+ * isn't `@mailwoman/spatial`'s `expandH3Cell`. Exported so tests can assert this agrees, cell-for-cell, with
+ * `build-bdc.ts`'s own coverage-cell derivation (the two MUST share this exact formula — see that file's docstring).
+ */
+export declare function res9ShortCellToRes6Parent(h3CellShortInt: number): number;
+/**
+ * Read the provider/technology/speed-bucket filing census over a set of queried blocks (by `geoid` or by `h3Cell`,
+ * never both). Always vintage-stamped; always throws on a broken manifest rather than answering unstamped; a queried
+ * block with no coverage evidence is reported in `unknown_block_count` and never folded into a zero-filing claim.
+ */
+export declare function filingLandscape(db: DatabaseClient<BDCDatabase>, query: FilingLandscapeQuery): Promise<FilingLandscape>;
+//# sourceMappingURL=filing-landscape.d.ts.map

package/out/sdk/filing-landscape.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filing-landscape.d.ts","sourceRoot":"","sources":["../../sdk/filing-landscape.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AAMnE,OAAO,EAAiD,KAAK,WAAW,EAAE,MAAM,cAAc,CAAA;AAE9F;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACpC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAClB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,qBAAqB;IACrC,WAAW,EAAE,MAAM,CAAA;IACnB,eAAe,EAAE,MAAM,CAAA;IACvB,YAAY,EAAE,MAAM,CAAA;IACpB,WAAW,EAAE,MAAM,CAAA;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC/B,OAAO,EAAE,MAAM,CAAA;IACf,oBAAoB,EAAE,MAAM,CAAA;IAC5B,mBAAmB,EAAE,MAAM,CAAA;IAC3B,OAAO,EAAE,qBAAqB,EAAE,CAAA;CAChC;AAED;;;GAGG;AACH,eAAO,MAAM,yBAAyB,aAAa,CAAA;AAEnD;;GAEG;AACH,eAAO,MAAM,uBAAuB,WAAW,CAAA;AAE/C;;GAEG;AACH,eAAO,MAAM,yBAAyB,aAAa,CAAA;AAEnD;;;GAGG;AACH,eAAO,MAAM,wBAAwB,YAAY,CAAA;AAEjD;;GAEG;AACH,eAAO,MAAM,kCAAkC,KAAK,CAAA;AAEpD;;GAEG;AACH,eAAO,MAAM,mCAAmC,MAAM,CAAA;AAEtD;;GAEG;AACH,eAAO,MAAM,uCAAuC,OAAO,CAAA;AAE3D;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,0BAA0B,EAAE,MAAM,GAAG,MAAM,CAQtF;AAqBD;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAMxE;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACpC,EAAE,EAAE,cAAc,CAAC,WAAW,CAAC,EAC/B,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,eAAe,CAAC,CA6G1B"}

package/out/sdk/filing-landscape.js

@@ -0,0 +1,216 @@
+/**
+ * @copyright Sister Software.
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `filing_landscape` reader (2a Task 9) — the FOUR PRE-REGISTERED ACCEPTANCE GATES this whole phase
+ *   is judged by. See `filing-landscape.test.ts` for the gate tests; this module is only the reader.
+ *
+ *   Coverage check (the meaning-of-zero rule): a queried block counts as SURVEYED only when its res-6
+ *   coverage cell is present in `layer_coverage` (via `readLayerCoverage`) — `undefined` means the area
+ *   was never surveyed, and the block is reported in `unknown_block_count`, NEVER folded into a
+ *   zero-filing claim.
+ *
+ *   - For a `geoids` query, the candidate res-9 cell is read off the block's OWN `bdc_availability`
+ *     rows — a geoid with zero rows has no derivable cell at all (never guessed, matching the builder's
+ *     "unknown geoid" discipline in `build-bdc.ts`), so it falls straight to unknown.
+ *   - For an `h3Cells` query, the caller supplies the res-9 cell directly, so coverage can be checked
+ *     even for a cell with no filing rows of its own — a genuine "surveyed, zero providers here" result,
+ *     the meaning-of-zero rule's POSITIVE case (covered but empty is not the same as never surveyed).
+ *
+ *   Res-9 → res-6 parent reconstruction is deliberately NOT `@mailwoman/spatial`'s `expandH3Cell` — that
+ *   helper's left-shift reconstruction only round-trips a short cell that was shortened AT resolution
+ *   15 (the address-id spine); fed a resolution-9 short cell it silently produces a full index
+ *   `cellToParent` rejects (`Cell arguments had incompatible resolutions`), verified empirically while
+ *   building this reader. The correct reconstruction for a short cell captured at a KNOWN resolution R
+ *   is a straight concatenation, not a shift: a full 64-bit H3 cell index is always
+ *   `"8" + <resolution nibble> + <52 bits of base-cell + digit path, trailing padding included>`, and
+ *   the 48-bit "short" form (`shortCellToInt`/`shortenH3Cell`) already carries exactly those low 52 bits
+ *   verbatim — so `"8" + R.toString(16) + shortHex.padStart(13, "0")` reassembles the identical full
+ *   index `latLngToCell` would have produced at resolution R. See {@link res9ShortCellToRes6Parent}.
+ *
+ *   This same formula is exactly what `build-bdc.ts` MUST use (and does, after fix round 1) to derive the
+ *   coverage cell it writes at build time — H3's cell hierarchy is not geometrically exact, so a
+ *   `latLngToCell(centroid, 6)` computed independently of the stored res-9 cell disagrees with
+ *   `cellToParent(res9Cell, 6)` for a real fraction of points (verified ~6% over CONUS). Builder and
+ *   reader deriving the res-6 parent differently was a real bug (fix round 1): a genuinely-surveyed block
+ *   (real rows, real `layer_coverage` entry) could read back as `unknown_block_count` while its own rows
+ *   still populated `filings` — a self-contradiction. `filings` is now scoped to units that PASS the
+ *   coverage check (see the `surveyedUnits` accumulator below) precisely so that can't happen again: a
+ *   block excluded from `surveyed_block_count` never contributes to `filings` either.
+ */
+import { readLayerCoverage, readLayerManifest } from "@mailwoman/core/layers";
+import { shortCellToInt } from "@mailwoman/spatial";
+import { cellToParent } from "h3-js";
+import { sql } from "kysely";
+import { BDC_COVERAGE_H3_RESOLUTION, BDC_H3_RESOLUTION } from "../schema.js";
+/**
+ * `speed_bucket` label for a block whose `max_advertised_download_speed` is below
+ * {@link BDC_SPEED_BUCKET_THRESHOLD_25_MBPS} Mbps.
+ */
+export const BDC_SPEED_BUCKET_UNDER_25 = "under-25";
+/**
+ * `speed_bucket` label for `BDC_SPEED_BUCKET_THRESHOLD_25_MBPS <= speed < BDC_SPEED_BUCKET_THRESHOLD_100_MBPS`.
+ */
+export const BDC_SPEED_BUCKET_25_100 = "25-100";
+/**
+ * `speed_bucket` label for `BDC_SPEED_BUCKET_THRESHOLD_100_MBPS <= speed < BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS`.
+ */
+export const BDC_SPEED_BUCKET_100_1000 = "100-1000";
+/**
+ * `speed_bucket` label for a block whose `max_advertised_download_speed` is at or above
+ * {@link BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS} Mbps.
+ */
+export const BDC_SPEED_BUCKET_GIGABIT = "gigabit";
+/**
+ * Upper-exclusive Mbps boundary between {@link BDC_SPEED_BUCKET_UNDER_25} and {@link BDC_SPEED_BUCKET_25_100}.
+ */
+export const BDC_SPEED_BUCKET_THRESHOLD_25_MBPS = 25;
+/**
+ * Upper-exclusive Mbps boundary between {@link BDC_SPEED_BUCKET_25_100} and {@link BDC_SPEED_BUCKET_100_1000}.
+ */
+export const BDC_SPEED_BUCKET_THRESHOLD_100_MBPS = 100;
+/**
+ * Mbps boundary at/above which a block is bucketed {@link BDC_SPEED_BUCKET_GIGABIT}.
+ */
+export const BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS = 1000;
+/**
+ * Pure mirror of the SQL `CASE` expression below ({@link speedBucketCaseSQL}) — same thresholds, same labels, exported
+ * so the boundary logic can be asserted directly without a database round trip.
+ */
+export function speedBucketForDownloadSpeed(maxAdvertisedDownloadSpeed) {
+    if (maxAdvertisedDownloadSpeed < BDC_SPEED_BUCKET_THRESHOLD_25_MBPS)
+        return BDC_SPEED_BUCKET_UNDER_25;
+    if (maxAdvertisedDownloadSpeed < BDC_SPEED_BUCKET_THRESHOLD_100_MBPS)
+        return BDC_SPEED_BUCKET_25_100;
+    if (maxAdvertisedDownloadSpeed < BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS)
+        return BDC_SPEED_BUCKET_100_1000;
+    return BDC_SPEED_BUCKET_GIGABIT;
+}
+/**
+ * The same bucketing as {@link speedBucketForDownloadSpeed}, expressed as a `CASE` over `max_advertised_download_speed`
+ * so the GROUP BY below can group directly on the bucket.
+ */
+const speedBucketCaseSQL = sql `CASE
+	WHEN max_advertised_download_speed < ${BDC_SPEED_BUCKET_THRESHOLD_25_MBPS} THEN ${BDC_SPEED_BUCKET_UNDER_25}
+	WHEN max_advertised_download_speed < ${BDC_SPEED_BUCKET_THRESHOLD_100_MBPS} THEN ${BDC_SPEED_BUCKET_25_100}
+	WHEN max_advertised_download_speed < ${BDC_SPEED_BUCKET_THRESHOLD_GIGABIT_MBPS} THEN ${BDC_SPEED_BUCKET_100_1000}
+	ELSE ${BDC_SPEED_BUCKET_GIGABIT}
+END`;
+/**
+ * `BDCDatabase extends LayerContractDatabase` structurally, but Kysely's `transaction()` makes `Kysely<DB>` INVARIANT
+ * in `DB` — same narrowing cast as `build-bdc.ts`'s `asContractDB`.
+ */
+function asContractDB(kdb) {
+    return kdb;
+}
+/**
+ * Reconstruct the res-6 ancestor of a res-9 short-cell int WITHOUT a centroid — see the module docstring for why this
+ * isn't `@mailwoman/spatial`'s `expandH3Cell`. Exported so tests can assert this agrees, cell-for-cell, with
+ * `build-bdc.ts`'s own coverage-cell derivation (the two MUST share this exact formula — see that file's docstring).
+ */
+export function res9ShortCellToRes6Parent(h3CellShortInt) {
+    const shortHex = h3CellShortInt.toString(16).padStart(13, "0");
+    const fullCell = `8${BDC_H3_RESOLUTION.toString(16)}${shortHex}`;
+    const parentCell = cellToParent(fullCell, BDC_COVERAGE_H3_RESOLUTION);
+    return shortCellToInt(parentCell);
+}
+/**
+ * Read the provider/technology/speed-bucket filing census over a set of queried blocks (by `geoid` or by `h3Cell`,
+ * never both). Always vintage-stamped; always throws on a broken manifest rather than answering unstamped; a queried
+ * block with no coverage evidence is reported in `unknown_block_count` and never folded into a zero-filing claim.
+ */
+export async function filingLandscape(db, query) {
+    const queryModeCount = (query.geoids ? 1 : 0) + (query.h3Cells ? 1 : 0);
+    if (queryModeCount !== 1) {
+        throw new Error("filingLandscape: exactly one of `geoids` or `h3Cells` is required");
+    }
+    // `[]` is truthy, so it passes the XOR check above undetected — without this guard an empty array sails
+    // straight through to a vacuous all-zero landscape (surveyed_block_count: 0, unknown_block_count: 0, no
+    // filings), which reads exactly like a real "nothing queried" answer instead of the malformed-query error
+    // it should be. Checked before the manifest read so a bad query fails fast without even opening the db further.
+    if (!(query.geoids ?? query.h3Cells).length) {
+        throw new Error("filingLandscape: `geoids`/`h3Cells` must not be an empty array");
+    }
+    // Read (and validate) the manifest FIRST — a broken/missing manifest must throw before any block is
+    // classified, never fall through to an "unstamped" answer (gate 4).
+    const manifest = await readLayerManifest(asContractDB(db));
+    const requestedUnits = query.geoids ?? query.h3Cells;
+    const unitColumn = query.geoids ? "geoid" : "h3_cell";
+    // Candidate res-9 cell per requested unit. `h3Cells` queries already carry the cell directly;
+    // `geoids` queries can only derive one from the block's OWN rows — a geoid with none has no
+    // candidate at all (never guessed), so it falls straight to unknown below.
+    const candidateCellByUnit = new Map();
+    if (query.geoids) {
+        const rows = await db
+            .selectFrom("bdc_availability")
+            .select(["geoid", "h3_cell"])
+            .where("geoid", "in", query.geoids)
+            .groupBy(["geoid", "h3_cell"])
+            .execute();
+        for (const row of rows) {
+            candidateCellByUnit.set(row.geoid, row.h3_cell);
+        }
+    }
+    else {
+        for (const cell of query.h3Cells) {
+            candidateCellByUnit.set(cell, cell);
+        }
+    }
+    let surveyedBlockCount = 0;
+    let unknownBlockCount = 0;
+    // Only units that PASS the coverage check feed the census below — a unit with rows but no coverage evidence
+    // (a corrupted/inconsistent db — see filing-landscape.test.ts's "coverage row deleted" gate) is `unknown`, and
+    // its rows must not leak into `filings` either: `surveyed_block_count` and the blocks backing `filings` must
+    // always agree, or a caller cross-referencing the two gets a contradiction (an "unknown" block whose filings
+    // still show up looks exactly like the false-negative bug this reader exists to prevent).
+    const surveyedUnits = [];
+    for (const unit of requestedUnits) {
+        const candidateCell = candidateCellByUnit.get(unit);
+        if (candidateCell === undefined) {
+            unknownBlockCount++;
+            continue;
+        }
+        const res6Parent = res9ShortCellToRes6Parent(candidateCell);
+        const coverage = await readLayerCoverage(asContractDB(db), res6Parent);
+        if (coverage === undefined) {
+            unknownBlockCount++;
+        }
+        else {
+            surveyedBlockCount++;
+            surveyedUnits.push(unit);
+        }
+    }
+    let filings = [];
+    if (surveyedUnits.length) {
+        let filingsQuery = db
+            .selectFrom("bdc_availability")
+            .select([
+            "provider_id",
+            "technology_code",
+            speedBucketCaseSQL.as("speed_bucket"),
+            (eb) => eb.fn.count(unitColumn).distinct().as("block_count"),
+        ])
+            .groupBy(["provider_id", "technology_code", speedBucketCaseSQL])
+            .orderBy("provider_id")
+            .orderBy("technology_code")
+            .orderBy(speedBucketCaseSQL);
+        filingsQuery = query.geoids
+            ? filingsQuery.where("geoid", "in", surveyedUnits)
+            : filingsQuery.where("h3_cell", "in", surveyedUnits);
+        const filingsRows = await filingsQuery.execute();
+        filings = filingsRows.map((row) => ({
+            provider_id: row.provider_id,
+            technology_code: row.technology_code,
+            speed_bucket: row.speed_bucket,
+            block_count: row.block_count,
+        }));
+    }
+    return {
+        vintage: manifest.sourceVintage,
+        surveyed_block_count: surveyedBlockCount,
+        unknown_block_count: unknownBlockCount,
+        filings,
+    };
+}
+//# sourceMappingURL=filing-landscape.js.map

package/out/sdk/filing-landscape.js.map

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