@mailwoman/bdc 9.0.0 → 9.1.0

package/out/sdk/download.d.ts

@@ -3,17 +3,6 @@
  * @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 — `bdc.db` is
- *   SQLite, not Parquet-backed (`bdc/schema.ts`) — 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 a `bdc`-only
- *   dependency.
  */
 import type { BDCClient } from "./client.ts";
 import { type BDCFile } from "./common.ts";

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

@@ -1 +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"}
+{"version":3,"file":"download.d.ts","sourceRoot":"","sources":["../../sdk/download.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AAC5C,OAAO,EAAqB,KAAK,OAAO,EAAE,MAAM,aAAa,CAAA;AAE7D;;;;;;;;;;;;;;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

@@ -3,47 +3,11 @@
  * @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 — `bdc.db` is
- *   SQLite, not Parquet-backed (`bdc/schema.ts`) — 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 a `bdc`-only
- *   dependency.
  */
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
-import { fromBuffer } from "yauzl-promise";
+import { extractSingleFileZip } from "@mailwoman/core/fs/zip";
 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`.
  *

package/out/sdk/download.js.map

@@ -1 +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"}
+{"version":3,"file":"download.js","sourceRoot":"","sources":["../../sdk/download.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,kBAAkB,CAAA;AACtC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAG7D,OAAO,EAAE,iBAAiB,EAAgB,MAAM,aAAa,CAAA;AAE7D;;;;;;;;;;;;;;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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/bdc",
-  "version": "9.0.0",
+  "version": "9.1.0",
   "description": "FCC Broadband Data Collection (BDC) availability data — fetch/parse/ingest provider and bdc.db layer reader",
   "keywords": [
     "bdc",
@@ -78,11 +78,11 @@
     "test": "vitest run"
   },
   "dependencies": {
-    "@mailwoman/core": "9.0.0",
-    "@mailwoman/filer": "9.0.0",
-    "@mailwoman/resolver-wof-sqlite": "9.0.0",
-    "@mailwoman/spatial": "9.0.0",
-    "@mailwoman/tiger": "9.0.0",
+    "@mailwoman/core": "9.1.0",
+    "@mailwoman/filer": "9.1.0",
+    "@mailwoman/resolver-wof-sqlite": "9.1.0",
+    "@mailwoman/spatial": "9.1.0",
+    "@mailwoman/tiger": "9.1.0",
     "h3-js": "^4.5.0",
     "kysely": "^0.29.4",
     "type-fest": "^5.8.0",

package/sdk/download.ts

@@ -3,56 +3,16 @@
  * @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 — `bdc.db` is
- *   SQLite, not Parquet-backed (`bdc/schema.ts`) — 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 a `bdc`-only
- *   dependency.
  */
 
 import * as fs from "node:fs/promises"
 import * as path from "node:path"
 
-import { fromBuffer } from "yauzl-promise"
+import { extractSingleFileZip } from "@mailwoman/core/fs/zip"
 
 import type { BDCClient } from "./client.ts"
 import { BDCFilingDataType, type BDCFile } from "./common.ts"
 
-/**
- * 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: Buffer): Promise<Buffer> {
-	const zip = await fromBuffer(zippedBuffer)
-
-	try {
-		for await (const entry of zip) {
-			if (entry.filename.endsWith("/")) continue
-
-			const readStream = await entry.openReadStream()
-			const chunks: Buffer[] = []
-
-			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`.
  *