@brianbuie/node-kit 0.12.4 → 0.13.0

package/dist/index.mjs

@@ -8,14 +8,15 @@ import { parseStream, writeToStream } from "fast-csv";
 import { isObjectLike, merge } from "lodash-es";
 import { add, format, formatISO, isAfter } from "date-fns";
 import extractDomain from "extract-domain";
+import formatDuration from "format-duration";
 import { inspect } from "node:util";
 import chalk from "chalk";
 import * as qt from "quicktype-core";
 
 //#region src/snapshot.ts
 /**
-* Allows special objects (Error, Headers, Set) to be included in JSON.stringify output
-* functions are removed
+* Allows special objects (Error, Headers, Set) to be included in JSON.stringify output.
+* Functions are removed
 */
 function snapshot(i, max = 50, depth = 0) {
 	if (Array.isArray(i)) {
@@ -285,17 +286,21 @@ var FileTypeCsv = class extends FileType {
 //#region src/Dir.ts
 /**
 * Reference to a specific directory with methods to create and list files.
-* Default path: '.'
-* > Created on file system the first time .path is read or any methods are used
+* @param inputPath
+* The path of the directory, created on file system the first time `.path` is read or any methods are used
+* @param options
+* include `{ temp: true }` to enable the `.clear()` method
 */
-var Dir = class Dir {
+var Dir = class {
 	#inputPath;
 	#resolved;
+	isTemp;
 	/**
 	* @param path can be relative to workspace or absolute
 	*/
-	constructor(inputPath = ".") {
+	constructor(inputPath, options = {}) {
 		this.#inputPath = inputPath;
+		this.isTemp = Boolean(options.temp);
 	}
 	/**
 	* The path of this Dir instance. Created on file system the first time this property is read/used.
@@ -309,22 +314,25 @@ var Dir = class Dir {
 	}
 	/**
 	* Create a new Dir inside the current Dir
-	* @param subPath joined with parent Dir's path to make new Dir
+	* @param subPath
+	* joined with parent Dir's path to make new Dir
+	* @param options
+	* include `{ temp: true }` to enable the `.clear()` method. If current Dir is temporary, child directories will also be temporary.
 	* @example
 	* const folder = new Dir('example');
 	* // folder.path = '/path/to/cwd/example'
 	* const child = folder.dir('path/to/dir');
 	* // child.path = '/path/to/cwd/example/path/to/dir'
 	*/
-	dir(subPath) {
-		return new Dir(path.join(this.path, subPath));
+	dir(subPath, options = { temp: this.isTemp }) {
+		return new this.constructor(path.join(this.path, subPath), options);
 	}
 	/**
-	* Creates a new TempDir inside current Dir
+	* Creates a new temp directory inside current Dir
 	* @param subPath joined with parent Dir's path to make new TempDir
 	*/
 	tempDir(subPath) {
-		return new TempDir(path.join(this.path, subPath));
+		return this.dir(subPath, { temp: true });
 	}
 	sanitize(filename) {
 		return sanitizeFilename(filename.replace("https://", "").replace("www.", ""), { replacement: "_" }).slice(-200);
@@ -345,19 +353,8 @@ var Dir = class Dir {
 	get files() {
 		return fs.readdirSync(this.path).map((filename) => this.file(filename));
 	}
-};
-/**
-* Extends Dir class with method to `clear()` contents.
-* Default path: `./.temp`
-*/
-var TempDir = class extends Dir {
-	constructor(inputPath = `./.temp`) {
-		super(inputPath);
-	}
-	/**
-	* > ⚠️ Warning! This deletes the directory!
-	*/
 	clear() {
+		if (!this.isTemp) throw new Error("Dir is not temporary");
 		fs.rmSync(this.path, {
 			recursive: true,
 			force: true
@@ -366,9 +363,13 @@ var TempDir = class extends Dir {
 	}
 };
 /**
-* './.temp' in current working directory
+* Current working directory
+*/
+const cwd = new Dir("./");
+/**
+* ./.temp in current working directory
 */
-const temp = new TempDir();
+const temp = cwd.tempDir(".temp");
 
 //#endregion
 //#region src/Cache.ts
@@ -381,7 +382,7 @@ var Cache = class {
 	file;
 	ttl;
 	constructor(key, ttl, initialData) {
-		this.file = new TempDir(".cache").file(key).json();
+		this.file = new Dir(".cache", { temp: true }).file(key).json();
 		this.ttl = typeof ttl === "number" ? { minutes: ttl } : ttl;
 		if (initialData) this.write(initialData);
 	}
@@ -512,12 +513,22 @@ var Fetcher = class {
 var Format = class {
 	/**
 	* date-fns format() with some shortcuts
-	* @param formatStr
-	* 'iso' to get ISO date, 'ymd' to format as 'yyyy-MM-dd', full options: https://date-fns.org/v4.1.0/docs/format
+	* @param formatStr the format to use
+	* @param date the date to format, default `new Date()`
+	* @example
+	* Format.date('iso') // '2026-04-08T13:56:45Z'
+	* Format.date('ymd') // '20260408'
+	* Format.date('ymd-hm') // '20260408-1356'
+	* Format.date('ymd-hms') // '20260408-135645'
+	* Format.date('h:m:s') // '13:56:45'
+	* @see more format options https://date-fns.org/v4.1.0/docs/format
 	*/
 	static date(formatStr = "iso", d = /* @__PURE__ */ new Date()) {
 		if (formatStr === "iso") return formatISO(d);
-		if (formatStr === "ymd") return format(d, "yyyy-MM-dd");
+		if (formatStr === "ymd") return format(d, "yyyyMMdd");
+		if (formatStr === "ymd-hm") return format(d, "yyyyMMdd-HHmm");
+		if (formatStr === "ymd-hms") return format(d, "yyyyMMdd-HHmmss");
+		if (formatStr === "h:m:s") return format(d, "HH:mm:ss");
 		return format(d, formatStr);
 	}
 	/**
@@ -526,10 +537,18 @@ var Format = class {
 	static round(n, places = 0) {
 		return new Intl.NumberFormat("en-US", { maximumFractionDigits: places }).format(n);
 	}
+	static plural(amount, singular, multiple) {
+		return amount === 1 ? `${amount} ${singular}` : `${amount} ${multiple || singular + "s"}`;
+	}
 	/**
 	* Make millisecond durations actually readable (eg "123ms", "3.56s", "1m 34s", "3h 24m", "2d 4h")
+	* @param ms milliseconds
+	* @param style 'digital' to output as 'HH:MM:SS'
+	* @see details on 'digital' format https://github.com/ungoldman/format-duration
+	* @see waiting on `Intl.DurationFormat({ style: 'digital' })` types https://github.com/microsoft/TypeScript/issues/60608
 	*/
-	static ms(ms) {
+	static ms(ms, style) {
+		if (style === "digital") return formatDuration(ms, { leading: true });
 		if (ms < 1e3) return `${this.round(ms)}ms`;
 		const s = ms / 1e3;
 		if (s < 60) return `${this.round(s, 2)}s`;
@@ -558,23 +577,29 @@ var Format = class {
 
 //#endregion
 //#region src/Log.ts
-var Log = class {
-	static isTest = process.env.npm_package_name === "@brianbuie/node-kit" && process.env.npm_lifecycle_event === "test";
+var Log = class Log {
+	static getStack() {
+		const details = { stack: "" };
+		Error.captureStackTrace(details, Log.getStack);
+		return details.stack.split("\n").map((l) => l.trim()).filter((l) => l !== "Error");
+	}
 	/**
 	* Gcloud parses JSON in stdout
 	*/
 	static #toGcloud(entry) {
-		if (entry.details?.length === 1) console.log(JSON.stringify(snapshot({
+		const details = entry.details?.length === 1 ? entry.details[0] : entry.details;
+		const output = {
 			...entry,
-			details: entry.details[0]
-		})));
-		else console.log(JSON.stringify(snapshot(entry)));
+			details,
+			stack: entry.stack || this.getStack()
+		};
+		console.log(JSON.stringify(snapshot(output)));
 	}
 	/**
 	* Includes colors and better inspection for logging during dev
 	*/
 	static #toConsole(entry, color) {
-		if (entry.message) console.log(color(`[${entry.severity}] ${entry.message}`));
+		if (entry.message) console.log(color(`${Format.date("h:m:s")} [${entry.severity}] ${entry.message}`));
 		entry.details?.forEach((detail) => {
 			console.log(inspect(detail, {
 				depth: 10,
@@ -584,42 +609,28 @@ var Log = class {
 			}));
 		});
 	}
-	static #log(options, ...input) {
+	static #log({ severity, color }, ...input) {
 		const { message, details } = this.prepare(...input);
-		if (process.env.K_SERVICE !== void 0 || process.env.CLOUD_RUN_JOB !== void 0) {
-			this.#toGcloud({
-				message,
-				severity: options.severity,
-				details
-			});
-			return {
-				message,
-				details,
-				options
-			};
-		}
-		if (!this.isTest) this.#toConsole({
+		const entry = {
 			message,
-			severity: options.severity,
+			severity,
 			details
-		}, options.color);
-		return {
-			message,
-			details,
-			options
 		};
+		if (process.env.K_SERVICE !== void 0 || process.env.CLOUD_RUN_JOB !== void 0) this.#toGcloud(entry);
+		else this.#toConsole(entry, color);
+		return entry;
 	}
 	/**
 	* Handle first argument being a string or an object with a 'message' prop
 	*/
 	static prepare(...input) {
-		let [first, ...rest] = input;
-		if (typeof first === "string") return {
-			message: first,
+		let [firstArg, ...rest] = input;
+		if (typeof firstArg === "string") return {
+			message: firstArg,
 			details: rest
 		};
-		if (isObjectLike(first) && typeof first["message"] === "string") {
-			const { message, ...firstDetails } = first;
+		if (isObjectLike(firstArg) && typeof firstArg["message"] === "string") {
+			const { message, ...firstDetails } = firstArg;
 			return {
 				message,
 				details: [firstDetails, ...rest]
@@ -628,35 +639,55 @@ var Log = class {
 		return { details: input };
 	}
 	/**
-	* Logs error details before throwing
+	* Events that require action or attention immediately
+	*/
+	static alert(...input) {
+		return this.#log({
+			severity: "ALERT",
+			color: chalk.bgRed
+		}, ...input);
+	}
+	/**
+	* Events that cause problems
 	*/
 	static error(...input) {
-		const { message } = this.#log({
+		return this.#log({
 			severity: "ERROR",
 			color: chalk.red
 		}, ...input);
-		throw new Error(message);
 	}
+	/**
+	* Events that might cause problems
+	*/
 	static warn(...input) {
 		return this.#log({
 			severity: "WARNING",
 			color: chalk.yellow
 		}, ...input);
 	}
+	/**
+	* Normal but significant events, such as start up, shut down, or a configuration change
+	*/
 	static notice(...input) {
 		return this.#log({
 			severity: "NOTICE",
 			color: chalk.cyan
 		}, ...input);
 	}
+	/**
+	* Routine information, such as ongoing status or performance
+	*/
 	static info(...input) {
 		return this.#log({
 			severity: "INFO",
 			color: chalk.white
 		}, ...input);
 	}
+	/**
+	* Debug or trace information
+	*/
 	static debug(...input) {
-		if (process.argv.some((arg) => arg.includes("--debug")) || process.env.DEBUG !== void 0 || process.env.NODE_ENV !== "production") return this.#log({
+		return this.#log({
 			severity: "DEBUG",
 			color: chalk.gray
 		}, ...input);
@@ -715,5 +746,5 @@ var TypeWriter = class {
 };
 
 //#endregion
-export { Cache, Dir, Fetcher, File, FileType, FileTypeCsv, FileTypeJson, FileTypeNdjson, Format, Log, TempDir, TypeWriter, snapshot, temp, timeout };
+export { Cache, Dir, Fetcher, File, FileType, FileTypeCsv, FileTypeJson, FileTypeNdjson, Format, Log, TypeWriter, cwd, snapshot, temp, timeout };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["output: Record<string, any>","obj: Record<string, any>","parsed: Row[]","#parseVal","#inputPath","#resolved","params: [string, string][]","timeout","#toGcloud","#toConsole","#log"],"sources":["../src/snapshot.ts","../src/File.ts","../src/Dir.ts","../src/Cache.ts","../src/Fetcher.ts","../src/Format.ts","../src/Log.ts","../src/timeout.ts","../src/TypeWriter.ts"],"sourcesContent":["import { isObjectLike } from 'lodash-es';\n\n/**\n * Allows special objects (Error, Headers, Set) to be included in JSON.stringify output\n * functions are removed\n */\nexport function snapshot(i: unknown, max = 50, depth = 0): any {\n  if (Array.isArray(i)) {\n    if (depth === max) return [];\n    return i.map((c) => snapshot(c, max, depth + 1));\n  }\n  if (typeof i === 'function') return undefined;\n  if (!isObjectLike(i)) return i;\n\n  if (depth === max) return {};\n  let output: Record<string, any> = {};\n  // @ts-ignore If it has an 'entries' function, use that for looping (eg. Set, Map, Headers)\n  if (typeof i.entries === 'function') {\n    // @ts-ignore\n    for (let [k, v] of i.entries()) {\n      output[k] = snapshot(v, max, depth + 1);\n    }\n    return output;\n  }\n\n  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Enumerability_and_ownership_of_properties\n\n  // Get Enumerable, inherited properties\n  const obj: Record<string, any> = i!;\n  for (let key in obj) {\n    output[key] = snapshot(obj[key], max, depth + 1);\n  }\n\n  // Get Non-enumberable, own properties\n  Object.getOwnPropertyNames(obj).forEach((key) => {\n    output[key] = snapshot(obj[key], max, depth + 1);\n  });\n\n  return output;\n}\n","import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { Readable } from 'node:stream';\nimport { finished } from 'node:stream/promises';\nimport mime from 'mime-types';\nimport { writeToStream, parseStream } from 'fast-csv';\nimport { snapshot } from './snapshot.ts';\n\n/**\n * Represents a file on the file system. If the file doesn't exist, it is created the first time it is written to.\n */\nexport class File {\n  path;\n  root;\n  dir;\n  base;\n  name;\n  ext;\n  type;\n\n  constructor(filepath: string) {\n    this.path = path.resolve(filepath);\n    const { root, dir, base, ext, name } = path.parse(this.path);\n    this.root = root;\n    this.dir = dir;\n    this.base = base;\n    this.name = name;\n    this.ext = ext;\n    this.type = mime.lookup(ext) || undefined;\n  }\n\n  get exists() {\n    return fs.existsSync(this.path);\n  }\n\n  get stats(): Partial<fs.Stats> {\n    return this.exists ? fs.statSync(this.path) : {};\n  }\n\n  /**\n   * Deletes the file if it exists\n   */\n  delete() {\n    fs.rmSync(this.path, { force: true });\n  }\n\n  /**\n   * @returns the contents of the file as a string, or undefined if the file doesn't exist\n   */\n  read() {\n    return this.exists ? fs.readFileSync(this.path, 'utf8') : undefined;\n  }\n\n  /**\n   * @returns lines as strings, removes trailing '\\n'\n   */\n  lines() {\n    const contents = (this.read() || '').split('\\n');\n    return contents.at(-1)?.length ? contents : contents.slice(0, contents.length - 1);\n  }\n\n  get readStream() {\n    return this.exists ? fs.createReadStream(this.path) : Readable.from([]);\n  }\n\n  get writeStream() {\n    fs.mkdirSync(this.dir, { recursive: true });\n    return fs.createWriteStream(this.path);\n  }\n\n  write(contents: string | ReadableStream) {\n    fs.mkdirSync(this.dir, { recursive: true });\n    if (typeof contents === 'string') return fs.writeFileSync(this.path, contents);\n    if (contents instanceof ReadableStream) return finished(Readable.from(contents).pipe(this.writeStream));\n    throw new Error(`Invalid content type: ${typeof contents}`);\n  }\n\n  /**\n   * creates file if it doesn't exist, appends string or array of strings as new lines.\n   * File always ends with '\\n', so contents don't need to be read before appending\n   */\n  append(lines: string | string[]) {\n    if (!this.exists) this.write('');\n    const contents = Array.isArray(lines) ? lines.join('\\n') : lines;\n    fs.appendFileSync(this.path, contents + '\\n');\n  }\n\n  /**\n   * @returns FileTypeJson adaptor for current File, adds '.json' extension if not present.\n   * @example\n   * const file = new File('./data').json({ key: 'val' }); // FileTypeJson<{ key: string; }>\n   * console.log(file.path) // '/path/to/cwd/data.json'\n   * file.write({ something: 'else' }) // ❌ property 'something' doesn't exist on type { key: string; }\n   * @example\n   * const file = new File('./data').json<object>({ key: 'val' }); // FileTypeJson<object>\n   * file.write({ something: 'else' }) // ✅ data is typed as object\n   */\n  json<T>(contents?: T) {\n    return new FileTypeJson<T>(this.path, contents);\n  }\n\n  /**\n   * @example\n   * const file = new File.json('data.json', { key: 'val' }); // FileTypeJson<{ key: string; }>\n   */\n  static get json() {\n    return FileTypeJson;\n  }\n\n  /**\n   * @returns FileTypeNdjson adaptor for current File, adds '.ndjson' extension if not present.\n   */\n  ndjson<T extends object>(lines?: T | T[]) {\n    return new FileTypeNdjson<T>(this.path, lines);\n  }\n  /**\n   * @example\n   * const file = new File.ndjson('log', { key: 'val' }); // FileTypeNdjson<{ key: string; }>\n   * console.log(file.path) // /path/to/cwd/log.ndjson\n   */\n  static get ndjson() {\n    return FileTypeNdjson;\n  }\n\n  /**\n   * @returns FileTypeCsv adaptor for current File, adds '.csv' extension if not present.\n   * @example\n   * const file = await new File('a').csv([{ col: 'val' }, { col: 'val2' }]); // FileTypeCsv<{ col: string; }>\n   * await file.write([ { col2: 'val2' } ]); // ❌ 'col2' doesn't exist on type { col: string; }\n   * await file.write({ col: 'val' }); // ✅ Writes one row\n   * await file.write([{ col: 'val2' }, { col: 'val3' }]); // ✅ Writes multiple rows\n   */\n  async csv<T extends object>(rows?: T[], keys?: (keyof T)[]) {\n    const csvFile = new FileTypeCsv<T>(this.path);\n    if (rows) await csvFile.write(rows, keys);\n    return csvFile;\n  }\n\n  static get csv() {\n    return FileTypeCsv;\n  }\n}\n\n/**\n * A generic file adaptor, extended by specific file type implementations\n */\nexport class FileType {\n  file;\n\n  constructor(filepath: string, contents?: string) {\n    this.file = new File(filepath);\n    if (contents) this.file.write(contents);\n  }\n\n  get path() {\n    return this.file.path;\n  }\n\n  get root() {\n    return this.file.root;\n  }\n\n  get dir() {\n    return this.file.dir;\n  }\n\n  get base() {\n    return this.file.base;\n  }\n\n  get name() {\n    return this.file.name;\n  }\n\n  get ext() {\n    return this.file.ext;\n  }\n\n  get type() {\n    return this.file.type;\n  }\n\n  get exists() {\n    return this.file.exists;\n  }\n\n  get stats() {\n    return this.file.stats;\n  }\n\n  delete() {\n    this.file.delete();\n  }\n\n  get readStream() {\n    return this.file.readStream;\n  }\n\n  get writeStream() {\n    return this.file.writeStream;\n  }\n}\n\n/**\n * A .json file that maintains data type when reading/writing.\n * > ⚠️ This is mildly unsafe, important/foreign json files should be validated at runtime!\n * @example\n * const file = new FileTypeJson('./data', { key: 'val' }); // FileTypeJson<{ key: string; }>\n * console.log(file.path) // '/path/to/cwd/data.json'\n * file.write({ something: 'else' }) // ❌ property 'something' doesn't exist on type { key: string; }\n * @example\n * const file = new FileTypeJson<object>('./data', { key: 'val' }); // FileTypeJson<object>\n * file.write({ something: 'else' }) // ✅ data is typed as object\n */\nexport class FileTypeJson<T> extends FileType {\n  constructor(filepath: string, contents?: T) {\n    super(filepath.endsWith('.json') ? filepath : filepath + '.json');\n    if (contents) this.write(contents);\n  }\n\n  read() {\n    const contents = this.file.read();\n    return contents ? (JSON.parse(contents) as T) : undefined;\n  }\n\n  write(contents: T) {\n    this.file.write(JSON.stringify(snapshot(contents), null, 2));\n  }\n}\n\n/**\n * New-line delimited json file (.ndjson)\n * @see https://jsonltools.com/ndjson-format-specification\n */\nexport class FileTypeNdjson<T extends object> extends FileType {\n  constructor(filepath: string, lines?: T | T[]) {\n    super(filepath.endsWith('.ndjson') ? filepath : filepath + '.ndjson');\n    if (lines) this.append(lines);\n  }\n\n  append(lines: T | T[]) {\n    this.file.append(\n      Array.isArray(lines) ? lines.map(l => JSON.stringify(snapshot(l))) : JSON.stringify(snapshot(lines)),\n    );\n  }\n\n  lines() {\n    return this.file.lines().map(l => JSON.parse(l) as T);\n  }\n}\n\ntype Key<T extends object> = keyof T;\n\n/**\n * Comma separated values (.csv).\n * Input rows as objects, keys are used as column headers\n */\nexport class FileTypeCsv<Row extends object> extends FileType {\n  constructor(filepath: string) {\n    super(filepath.endsWith('.csv') ? filepath : filepath + '.csv');\n  }\n\n  async write(rows: Row[], keys?: Key<Row>[]) {\n    const headerSet = new Set<Key<Row>>();\n    if (keys) {\n      for (const key of keys) headerSet.add(key);\n    } else {\n      for (const row of rows) {\n        for (const key in row) headerSet.add(key);\n      }\n    }\n    const headers = Array.from(headerSet);\n    const outRows = rows.map(row => headers.map(key => row[key]));\n    return finished(writeToStream(this.file.writeStream, [headers, ...outRows]));\n  }\n\n  #parseVal(val: string) {\n    if (val.toLowerCase() === 'false') return false;\n    if (val.toLowerCase() === 'true') return true;\n    if (val.length === 0) return null;\n    if (/^[\\.0-9]+$/.test(val)) return Number(val);\n    return val;\n  }\n\n  async read() {\n    return new Promise<Row[]>((resolve, reject) => {\n      const parsed: Row[] = [];\n      parseStream(this.file.readStream, { headers: true })\n        .on('data', (raw: Record<Key<Row>, string>) => {\n          parsed.push(\n            Object.entries(raw).reduce(\n              (all, [key, val]) => ({\n                ...all,\n                [key]: this.#parseVal(val as string),\n              }),\n              {} as Row,\n            ),\n          );\n        })\n        .on('error', e => reject(e))\n        .on('end', () => resolve(parsed));\n    });\n  }\n}\n","import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport sanitizeFilename from 'sanitize-filename';\nimport { File } from './File.ts';\n\n/**\n * Reference to a specific directory with methods to create and list files.\n * Default path: '.'\n * > Created on file system the first time .path is read or any methods are used\n */\nexport class Dir {\n  #inputPath;\n  #resolved?: string;\n\n  /**\n   * @param path can be relative to workspace or absolute\n   */\n  constructor(inputPath = '.') {\n    this.#inputPath = inputPath;\n  }\n\n  /**\n   * The path of this Dir instance. Created on file system the first time this property is read/used.\n   */\n  get path() {\n    if (!this.#resolved) {\n      this.#resolved = path.resolve(this.#inputPath);\n      fs.mkdirSync(this.#resolved, { recursive: true });\n    }\n    return this.#resolved;\n  }\n\n  /**\n   * Create a new Dir inside the current Dir\n   * @param subPath joined with parent Dir's path to make new Dir\n   * @example\n   * const folder = new Dir('example');\n   * // folder.path = '/path/to/cwd/example'\n   * const child = folder.dir('path/to/dir');\n   * // child.path = '/path/to/cwd/example/path/to/dir'\n   */\n  dir(subPath: string) {\n    return new Dir(path.join(this.path, subPath));\n  }\n\n  /**\n   * Creates a new TempDir inside current Dir\n   * @param subPath joined with parent Dir's path to make new TempDir\n   */\n  tempDir(subPath: string) {\n    return new TempDir(path.join(this.path, subPath));\n  }\n\n  sanitize(filename: string) {\n    const notUrl = filename.replace('https://', '').replace('www.', '');\n    return sanitizeFilename(notUrl, { replacement: '_' }).slice(-200);\n  }\n\n  /**\n   * @param base - The file base (name and extension)\n   * @example\n   * const folder = new Dir('example');\n   * const filepath = folder.resolve('file.json');\n   * // 'example/file.json'\n   */\n  filepath(base: string) {\n    return path.resolve(this.path, this.sanitize(base));\n  }\n\n  file(base: string) {\n    return new File(this.filepath(base));\n  }\n\n  get files() {\n    return fs.readdirSync(this.path).map((filename) => this.file(filename));\n  }\n}\n\n/**\n * Extends Dir class with method to `clear()` contents.\n * Default path: `./.temp`\n */\nexport class TempDir extends Dir {\n  constructor(inputPath = `./.temp`) {\n    super(inputPath);\n  }\n\n  /**\n   * > ⚠️ Warning! This deletes the directory!\n   */\n  clear() {\n    fs.rmSync(this.path, { recursive: true, force: true });\n    fs.mkdirSync(this.path, { recursive: true });\n  }\n}\n\n/**\n * './.temp' in current working directory\n */\nexport const temp = new TempDir();\n","import { type Duration, isAfter, add } from 'date-fns';\nimport { TempDir } from './Dir.ts';\n\n/**\n * Save data to a local file with an expiration.\n * Fresh/stale data is returned with a flag for if it's fresh or not,\n * so stale data can still be used if needed.\n */\nexport class Cache<T> {\n  file;\n  ttl;\n\n  constructor(key: string, ttl: number | Duration, initialData?: T) {\n    const dir = new TempDir('.cache');\n    this.file = dir.file(key).json<{ savedAt: string; data: T }>();\n    this.ttl = typeof ttl === 'number' ? { minutes: ttl } : ttl;\n    if (initialData) this.write(initialData);\n  }\n\n  write(data: T) {\n    this.file.write({ savedAt: new Date().toUTCString(), data });\n  }\n\n  read(): [T | undefined, boolean] {\n    const { savedAt, data } = this.file.read() || {};\n    const isFresh = Boolean(savedAt && isAfter(add(savedAt, this.ttl), new Date()));\n    return [data, isFresh];\n  }\n}\n","import { merge } from 'lodash-es';\nimport extractDomain from 'extract-domain';\n\nexport type Route = string | URL;\n\ntype QueryVal = string | number | boolean | null | undefined;\nexport type Query = Record<string, QueryVal | QueryVal[]>;\n\nexport type FetchOptions = RequestInit & {\n  base?: string;\n  query?: Query;\n  headers?: Record<string, string>;\n  data?: any;\n  timeout?: number;\n  retries?: number;\n  retryDelay?: number;\n};\n\n/**\n * Fetcher provides a quick way to set up a basic API connection\n * with options applied to every request.\n * Includes basic methods for requesting and parsing responses\n */\nexport class Fetcher {\n  defaultOptions;\n\n  constructor(opts: FetchOptions = {}) {\n    this.defaultOptions = {\n      timeout: 60000,\n      retries: 0,\n      retryDelay: 3000,\n      ...opts,\n    };\n  }\n\n  /**\n   * Build URL with URLSearchParams if query is provided.\n   * Also returns domain, to help with cookies\n   */\n  buildUrl(route: Route, opts: FetchOptions = {}): [URL, string] {\n    const mergedOptions = merge({}, this.defaultOptions, opts);\n    const params: [string, string][] = [];\n    Object.entries(mergedOptions.query || {}).forEach(([key, val]) => {\n      if (val === undefined) return;\n      if (Array.isArray(val)) {\n        val.forEach((v) => {\n          params.push([key, `${v}`]);\n        });\n      } else {\n        params.push([key, `${val}`]);\n      }\n    });\n    const search = params.length > 0 ? '?' + new URLSearchParams(params).toString() : '';\n    const url = new URL(route + search, this.defaultOptions.base);\n    const domain = extractDomain(url.href) as string;\n    return [url, domain];\n  }\n\n  /**\n   * Merges options to get headers. Useful when extending the Fetcher class to add custom auth.\n   */\n  buildHeaders(route: Route, opts: FetchOptions = {}) {\n    const { headers } = merge({}, this.defaultOptions, opts);\n    return headers || {};\n  }\n\n  /**\n   * Builds request, merging defaultOptions and provided options.\n   * Includes Abort signal for timeout\n   */\n  buildRequest(route: Route, opts: FetchOptions = {}): [Request, FetchOptions, string] {\n    const mergedOptions = merge({}, this.defaultOptions, opts);\n    const { query, data, timeout, retries, ...init } = mergedOptions;\n    init.headers = this.buildHeaders(route, mergedOptions);\n    if (data) {\n      init.headers['content-type'] = init.headers['content-type'] || 'application/json';\n      init.method = init.method || 'POST';\n      init.body = JSON.stringify(data);\n    }\n    if (timeout) {\n      init.signal = AbortSignal.timeout(timeout);\n    }\n    const [url, domain] = this.buildUrl(route, mergedOptions);\n    const req = new Request(url, init);\n    return [req, mergedOptions, domain];\n  }\n\n  /**\n   * Builds and performs the request, merging provided options with defaultOptions.\n   * If `opts.data` is provided, method is updated to POST, content-type json, data is stringified in the body.\n   * Retries on local or network error, with increasing backoff.\n   */\n  async fetch(route: Route, opts: FetchOptions = {}): Promise<[Response, Request]> {\n    const [_req, options] = this.buildRequest(route, opts);\n    const maxAttempts = (options.retries || 0) + 1;\n    let attempt = 0;\n    while (attempt < maxAttempts) {\n      attempt++;\n      const [req] = this.buildRequest(route, opts);\n      const res = await fetch(req)\n        .then((r) => {\n          if (!r.ok) throw new Error(r.statusText);\n          return r;\n        })\n        .catch(async (error) => {\n          if (attempt < maxAttempts) {\n            const wait = attempt * 3000;\n            console.warn(`${req.method} ${req.url} (attempt ${attempt} of ${maxAttempts})`, error);\n            await new Promise((resolve) => setTimeout(resolve, wait));\n          } else {\n            throw new Error(error);\n          }\n        });\n      if (res) return [res, req];\n    }\n    throw new Error(`Failed to fetch ${_req.url}`);\n  }\n\n  async fetchText(route: Route, opts: FetchOptions = {}): Promise<[string, Response, Request]> {\n    return this.fetch(route, opts).then(async ([res, req]) => {\n      const text = await res.text();\n      return [text, res, req];\n    });\n  }\n\n  async fetchJson<T>(route: Route, opts: FetchOptions = {}): Promise<[T, Response, Request]> {\n    return this.fetchText(route, opts).then(([txt, res, req]) => [JSON.parse(txt) as T, res, req]);\n  }\n}\n","import { format, formatISO, type DateArg } from 'date-fns';\n\n/**\n * Helpers for formatting dates, times, and numbers as strings\n */\nexport class Format {\n  /**\n   * date-fns format() with some shortcuts\n   * @param formatStr\n   * 'iso' to get ISO date, 'ymd' to format as 'yyyy-MM-dd', full options: https://date-fns.org/v4.1.0/docs/format\n   */\n  static date(formatStr: 'iso' | 'ymd' | string = 'iso', d: DateArg<Date> = new Date()) {\n    if (formatStr === 'iso') return formatISO(d);\n    if (formatStr === 'ymd') return format(d, 'yyyy-MM-dd');\n    return format(d, formatStr);\n  }\n\n  /**\n   * Round a number to a specific set of places\n   */\n  static round(n: number, places = 0) {\n    return new Intl.NumberFormat('en-US', { maximumFractionDigits: places }).format(n);\n  }\n\n  /**\n   * Make millisecond durations actually readable (eg \"123ms\", \"3.56s\", \"1m 34s\", \"3h 24m\", \"2d 4h\")\n   */\n  static ms(ms: number) {\n    if (ms < 1000) return `${this.round(ms)}ms`;\n    const s = ms / 1000;\n    if (s < 60) return `${this.round(s, 2)}s`;\n    const m = Math.floor(s / 60);\n    if (m < 60) return `${m}m ${Math.floor(s) % 60}s`;\n    const h = Math.floor(m / 60);\n    if (h < 24) return `${h}h ${m % 60}m`;\n    const d = Math.floor(h / 24);\n    return `${d}d ${h % 24}h`;\n  }\n\n  static bytes(b: number) {\n    const labels = ['b', 'KB', 'MB', 'GB', 'TB'];\n    let factor = 0;\n    while (b >= 1024 && labels[factor + 1]) {\n      b = b / 1024;\n      factor++;\n    }\n    return `${this.round(b, 2)} ${labels[factor]}`;\n  }\n}\n","import { inspect } from 'node:util';\nimport { isObjectLike } from 'lodash-es';\nimport chalk, { type ChalkInstance } from 'chalk';\nimport { snapshot } from './snapshot.ts';\n\ntype Severity = 'DEFAULT' | 'DEBUG' | 'INFO' | 'NOTICE' | 'WARNING' | 'ERROR' | 'CRITICAL' | 'ALERT' | 'EMERGENCY';\n\ntype Options = {\n  severity: Severity;\n  color: ChalkInstance;\n};\n\ntype Entry = {\n  message?: string;\n  severity: Severity;\n  details?: unknown[];\n};\n\nexport class Log {\n  // Only silence logs when THIS package is running its own tests\n  static isTest = process.env.npm_package_name === '@brianbuie/node-kit' && process.env.npm_lifecycle_event === 'test';\n\n  /**\n   * Gcloud parses JSON in stdout\n   */\n  static #toGcloud(entry: Entry) {\n    if (entry.details?.length === 1) {\n      console.log(JSON.stringify(snapshot({ ...entry, details: entry.details[0] })));\n    } else {\n      console.log(JSON.stringify(snapshot(entry)));\n    }\n  }\n\n  /**\n   * Includes colors and better inspection for logging during dev\n   */\n  static #toConsole(entry: Entry, color: ChalkInstance) {\n    if (entry.message) console.log(color(`[${entry.severity}] ${entry.message}`));\n    entry.details?.forEach((detail) => {\n      console.log(inspect(detail, { depth: 10, breakLength: 100, compact: true, colors: true }));\n    });\n  }\n\n  static #log(options: Options, ...input: unknown[]) {\n    const { message, details } = this.prepare(...input);\n    // https://cloud.google.com/run/docs/container-contract#env-vars\n    const isGcloud = process.env.K_SERVICE !== undefined || process.env.CLOUD_RUN_JOB !== undefined;\n    if (isGcloud) {\n      this.#toGcloud({ message, severity: options.severity, details });\n      return { message, details, options };\n    }\n    // Hide output while testing this package\n    if (!this.isTest) {\n      this.#toConsole({ message, severity: options.severity, details }, options.color);\n    }\n    return { message, details, options };\n  }\n\n  /**\n   * Handle first argument being a string or an object with a 'message' prop\n   */\n  static prepare(...input: unknown[]): { message?: string; details: unknown[] } {\n    let [first, ...rest] = input;\n    if (typeof first === 'string') {\n      return { message: first, details: rest };\n    }\n    // @ts-ignore\n    if (isObjectLike(first) && typeof first['message'] === 'string') {\n      const { message, ...firstDetails } = first as { message: string };\n      return { message, details: [firstDetails, ...rest] };\n    }\n    return { details: input };\n  }\n\n  /**\n   * Logs error details before throwing\n   */\n  static error(...input: unknown[]) {\n    const { message } = this.#log({ severity: 'ERROR', color: chalk.red }, ...input);\n    throw new Error(message);\n  }\n\n  static warn(...input: unknown[]) {\n    return this.#log({ severity: 'WARNING', color: chalk.yellow }, ...input);\n  }\n\n  static notice(...input: unknown[]) {\n    return this.#log({ severity: 'NOTICE', color: chalk.cyan }, ...input);\n  }\n\n  static info(...input: unknown[]) {\n    return this.#log({ severity: 'INFO', color: chalk.white }, ...input);\n  }\n\n  static debug(...input: unknown[]) {\n    const debugging = process.argv.some((arg) => arg.includes('--debug')) || process.env.DEBUG !== undefined;\n    if (debugging || process.env.NODE_ENV !== 'production') {\n      return this.#log({ severity: 'DEBUG', color: chalk.gray }, ...input);\n    }\n  }\n}\n","export async function timeout(ms: number) {\n  return new Promise((resolve) => {\n    setTimeout(resolve, ms);\n  });\n}\n","import * as fs from 'node:fs';\nimport { merge } from 'lodash-es';\nimport * as qt from 'quicktype-core';\n\nexport class TypeWriter {\n  moduleName;\n  input = qt.jsonInputForTargetLanguage('typescript');\n  outDir;\n  qtSettings;\n\n  constructor(moduleName: string, settings: { outDir?: string } & Partial<qt.Options> = {}) {\n    this.moduleName = moduleName;\n    const { outDir, ...qtSettings } = settings;\n    this.outDir = outDir || './types';\n    const defaultSettings = {\n      lang: 'typescript',\n      rendererOptions: {\n        'just-types': true,\n        'prefer-types': true,\n      },\n      inferEnums: false,\n      inferDateTimes: false,\n    };\n    this.qtSettings = merge(defaultSettings, qtSettings);\n  }\n\n  async addMember(name: string, _samples: any[]) {\n    const samples = _samples.map((s) => (typeof s === 'string' ? s : JSON.stringify(s)));\n    await this.input.addSource({ name, samples });\n  }\n\n  async toString() {\n    const inputData = new qt.InputData();\n    inputData.addInput(this.input);\n    const result = await qt.quicktype({\n      inputData,\n      ...this.qtSettings,\n    });\n    return result.lines.join('\\n');\n  }\n\n  async toFile() {\n    const result = await this.toString();\n    fs.mkdirSync(this.outDir, { recursive: true });\n    fs.writeFileSync(`${this.outDir}/${this.moduleName}.d.ts`, result);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAMA,SAAgB,SAAS,GAAY,MAAM,IAAI,QAAQ,GAAQ;AAC7D,KAAI,MAAM,QAAQ,EAAE,EAAE;AACpB,MAAI,UAAU,IAAK,QAAO,EAAE;AAC5B,SAAO,EAAE,KAAK,MAAM,SAAS,GAAG,KAAK,QAAQ,EAAE,CAAC;;AAElD,KAAI,OAAO,MAAM,WAAY,QAAO;AACpC,KAAI,CAAC,aAAa,EAAE,CAAE,QAAO;AAE7B,KAAI,UAAU,IAAK,QAAO,EAAE;CAC5B,IAAIA,SAA8B,EAAE;AAEpC,KAAI,OAAO,EAAE,YAAY,YAAY;AAEnC,OAAK,IAAI,CAAC,GAAG,MAAM,EAAE,SAAS,CAC5B,QAAO,KAAK,SAAS,GAAG,KAAK,QAAQ,EAAE;AAEzC,SAAO;;CAMT,MAAMC,MAA2B;AACjC,MAAK,IAAI,OAAO,IACd,QAAO,OAAO,SAAS,IAAI,MAAM,KAAK,QAAQ,EAAE;AAIlD,QAAO,oBAAoB,IAAI,CAAC,SAAS,QAAQ;AAC/C,SAAO,OAAO,SAAS,IAAI,MAAM,KAAK,QAAQ,EAAE;GAChD;AAEF,QAAO;;;;;;;;AC3BT,IAAa,OAAb,MAAkB;CAChB;CACA;CACA;CACA;CACA;CACA;CACA;CAEA,YAAY,UAAkB;AAC5B,OAAK,OAAO,KAAK,QAAQ,SAAS;EAClC,MAAM,EAAE,MAAM,KAAK,MAAM,KAAK,SAAS,KAAK,MAAM,KAAK,KAAK;AAC5D,OAAK,OAAO;AACZ,OAAK,MAAM;AACX,OAAK,OAAO;AACZ,OAAK,OAAO;AACZ,OAAK,MAAM;AACX,OAAK,OAAO,KAAK,OAAO,IAAI,IAAI;;CAGlC,IAAI,SAAS;AACX,SAAO,GAAG,WAAW,KAAK,KAAK;;CAGjC,IAAI,QAA2B;AAC7B,SAAO,KAAK,SAAS,GAAG,SAAS,KAAK,KAAK,GAAG,EAAE;;;;;CAMlD,SAAS;AACP,KAAG,OAAO,KAAK,MAAM,EAAE,OAAO,MAAM,CAAC;;;;;CAMvC,OAAO;AACL,SAAO,KAAK,SAAS,GAAG,aAAa,KAAK,MAAM,OAAO,GAAG;;;;;CAM5D,QAAQ;EACN,MAAM,YAAY,KAAK,MAAM,IAAI,IAAI,MAAM,KAAK;AAChD,SAAO,SAAS,GAAG,GAAG,EAAE,SAAS,WAAW,SAAS,MAAM,GAAG,SAAS,SAAS,EAAE;;CAGpF,IAAI,aAAa;AACf,SAAO,KAAK,SAAS,GAAG,iBAAiB,KAAK,KAAK,GAAG,SAAS,KAAK,EAAE,CAAC;;CAGzE,IAAI,cAAc;AAChB,KAAG,UAAU,KAAK,KAAK,EAAE,WAAW,MAAM,CAAC;AAC3C,SAAO,GAAG,kBAAkB,KAAK,KAAK;;CAGxC,MAAM,UAAmC;AACvC,KAAG,UAAU,KAAK,KAAK,EAAE,WAAW,MAAM,CAAC;AAC3C,MAAI,OAAO,aAAa,SAAU,QAAO,GAAG,cAAc,KAAK,MAAM,SAAS;AAC9E,MAAI,oBAAoB,eAAgB,QAAO,SAAS,SAAS,KAAK,SAAS,CAAC,KAAK,KAAK,YAAY,CAAC;AACvG,QAAM,IAAI,MAAM,yBAAyB,OAAO,WAAW;;;;;;CAO7D,OAAO,OAA0B;AAC/B,MAAI,CAAC,KAAK,OAAQ,MAAK,MAAM,GAAG;EAChC,MAAM,WAAW,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAK,KAAK,GAAG;AAC3D,KAAG,eAAe,KAAK,MAAM,WAAW,KAAK;;;;;;;;;;;;CAa/C,KAAQ,UAAc;AACpB,SAAO,IAAI,aAAgB,KAAK,MAAM,SAAS;;;;;;CAOjD,WAAW,OAAO;AAChB,SAAO;;;;;CAMT,OAAyB,OAAiB;AACxC,SAAO,IAAI,eAAkB,KAAK,MAAM,MAAM;;;;;;;CAOhD,WAAW,SAAS;AAClB,SAAO;;;;;;;;;;CAWT,MAAM,IAAsB,MAAY,MAAoB;EAC1D,MAAM,UAAU,IAAI,YAAe,KAAK,KAAK;AAC7C,MAAI,KAAM,OAAM,QAAQ,MAAM,MAAM,KAAK;AACzC,SAAO;;CAGT,WAAW,MAAM;AACf,SAAO;;;;;;AAOX,IAAa,WAAb,MAAsB;CACpB;CAEA,YAAY,UAAkB,UAAmB;AAC/C,OAAK,OAAO,IAAI,KAAK,SAAS;AAC9B,MAAI,SAAU,MAAK,KAAK,MAAM,SAAS;;CAGzC,IAAI,OAAO;AACT,SAAO,KAAK,KAAK;;CAGnB,IAAI,OAAO;AACT,SAAO,KAAK,KAAK;;CAGnB,IAAI,MAAM;AACR,SAAO,KAAK,KAAK;;CAGnB,IAAI,OAAO;AACT,SAAO,KAAK,KAAK;;CAGnB,IAAI,OAAO;AACT,SAAO,KAAK,KAAK;;CAGnB,IAAI,MAAM;AACR,SAAO,KAAK,KAAK;;CAGnB,IAAI,OAAO;AACT,SAAO,KAAK,KAAK;;CAGnB,IAAI,SAAS;AACX,SAAO,KAAK,KAAK;;CAGnB,IAAI,QAAQ;AACV,SAAO,KAAK,KAAK;;CAGnB,SAAS;AACP,OAAK,KAAK,QAAQ;;CAGpB,IAAI,aAAa;AACf,SAAO,KAAK,KAAK;;CAGnB,IAAI,cAAc;AAChB,SAAO,KAAK,KAAK;;;;;;;;;;;;;;AAerB,IAAa,eAAb,cAAqC,SAAS;CAC5C,YAAY,UAAkB,UAAc;AAC1C,QAAM,SAAS,SAAS,QAAQ,GAAG,WAAW,WAAW,QAAQ;AACjE,MAAI,SAAU,MAAK,MAAM,SAAS;;CAGpC,OAAO;EACL,MAAM,WAAW,KAAK,KAAK,MAAM;AACjC,SAAO,WAAY,KAAK,MAAM,SAAS,GAAS;;CAGlD,MAAM,UAAa;AACjB,OAAK,KAAK,MAAM,KAAK,UAAU,SAAS,SAAS,EAAE,MAAM,EAAE,CAAC;;;;;;;AAQhE,IAAa,iBAAb,cAAsD,SAAS;CAC7D,YAAY,UAAkB,OAAiB;AAC7C,QAAM,SAAS,SAAS,UAAU,GAAG,WAAW,WAAW,UAAU;AACrE,MAAI,MAAO,MAAK,OAAO,MAAM;;CAG/B,OAAO,OAAgB;AACrB,OAAK,KAAK,OACR,MAAM,QAAQ,MAAM,GAAG,MAAM,KAAI,MAAK,KAAK,UAAU,SAAS,EAAE,CAAC,CAAC,GAAG,KAAK,UAAU,SAAS,MAAM,CAAC,CACrG;;CAGH,QAAQ;AACN,SAAO,KAAK,KAAK,OAAO,CAAC,KAAI,MAAK,KAAK,MAAM,EAAE,CAAM;;;;;;;AAUzD,IAAa,cAAb,cAAqD,SAAS;CAC5D,YAAY,UAAkB;AAC5B,QAAM,SAAS,SAAS,OAAO,GAAG,WAAW,WAAW,OAAO;;CAGjE,MAAM,MAAM,MAAa,MAAmB;EAC1C,MAAM,4BAAY,IAAI,KAAe;AACrC,MAAI,KACF,MAAK,MAAM,OAAO,KAAM,WAAU,IAAI,IAAI;MAE1C,MAAK,MAAM,OAAO,KAChB,MAAK,MAAM,OAAO,IAAK,WAAU,IAAI,IAAI;EAG7C,MAAM,UAAU,MAAM,KAAK,UAAU;EACrC,MAAM,UAAU,KAAK,KAAI,QAAO,QAAQ,KAAI,QAAO,IAAI,KAAK,CAAC;AAC7D,SAAO,SAAS,cAAc,KAAK,KAAK,aAAa,CAAC,SAAS,GAAG,QAAQ,CAAC,CAAC;;CAG9E,UAAU,KAAa;AACrB,MAAI,IAAI,aAAa,KAAK,QAAS,QAAO;AAC1C,MAAI,IAAI,aAAa,KAAK,OAAQ,QAAO;AACzC,MAAI,IAAI,WAAW,EAAG,QAAO;AAC7B,MAAI,aAAa,KAAK,IAAI,CAAE,QAAO,OAAO,IAAI;AAC9C,SAAO;;CAGT,MAAM,OAAO;AACX,SAAO,IAAI,SAAgB,SAAS,WAAW;GAC7C,MAAMC,SAAgB,EAAE;AACxB,eAAY,KAAK,KAAK,YAAY,EAAE,SAAS,MAAM,CAAC,CACjD,GAAG,SAAS,QAAkC;AAC7C,WAAO,KACL,OAAO,QAAQ,IAAI,CAAC,QACjB,KAAK,CAAC,KAAK,UAAU;KACpB,GAAG;MACF,MAAM,MAAKC,SAAU,IAAc;KACrC,GACD,EAAE,CACH,CACF;KACD,CACD,GAAG,UAAS,MAAK,OAAO,EAAE,CAAC,CAC3B,GAAG,aAAa,QAAQ,OAAO,CAAC;IACnC;;;;;;;;;;;ACnSN,IAAa,MAAb,MAAa,IAAI;CACf;CACA;;;;CAKA,YAAY,YAAY,KAAK;AAC3B,QAAKC,YAAa;;;;;CAMpB,IAAI,OAAO;AACT,MAAI,CAAC,MAAKC,UAAW;AACnB,SAAKA,WAAY,KAAK,QAAQ,MAAKD,UAAW;AAC9C,MAAG,UAAU,MAAKC,UAAW,EAAE,WAAW,MAAM,CAAC;;AAEnD,SAAO,MAAKA;;;;;;;;;;;CAYd,IAAI,SAAiB;AACnB,SAAO,IAAI,IAAI,KAAK,KAAK,KAAK,MAAM,QAAQ,CAAC;;;;;;CAO/C,QAAQ,SAAiB;AACvB,SAAO,IAAI,QAAQ,KAAK,KAAK,KAAK,MAAM,QAAQ,CAAC;;CAGnD,SAAS,UAAkB;AAEzB,SAAO,iBADQ,SAAS,QAAQ,YAAY,GAAG,CAAC,QAAQ,QAAQ,GAAG,EACnC,EAAE,aAAa,KAAK,CAAC,CAAC,MAAM,KAAK;;;;;;;;;CAUnE,SAAS,MAAc;AACrB,SAAO,KAAK,QAAQ,KAAK,MAAM,KAAK,SAAS,KAAK,CAAC;;CAGrD,KAAK,MAAc;AACjB,SAAO,IAAI,KAAK,KAAK,SAAS,KAAK,CAAC;;CAGtC,IAAI,QAAQ;AACV,SAAO,GAAG,YAAY,KAAK,KAAK,CAAC,KAAK,aAAa,KAAK,KAAK,SAAS,CAAC;;;;;;;AAQ3E,IAAa,UAAb,cAA6B,IAAI;CAC/B,YAAY,YAAY,WAAW;AACjC,QAAM,UAAU;;;;;CAMlB,QAAQ;AACN,KAAG,OAAO,KAAK,MAAM;GAAE,WAAW;GAAM,OAAO;GAAM,CAAC;AACtD,KAAG,UAAU,KAAK,MAAM,EAAE,WAAW,MAAM,CAAC;;;;;;AAOhD,MAAa,OAAO,IAAI,SAAS;;;;;;;;;AC3FjC,IAAa,QAAb,MAAsB;CACpB;CACA;CAEA,YAAY,KAAa,KAAwB,aAAiB;AAEhE,OAAK,OADO,IAAI,QAAQ,SAAS,CACjB,KAAK,IAAI,CAAC,MAAoC;AAC9D,OAAK,MAAM,OAAO,QAAQ,WAAW,EAAE,SAAS,KAAK,GAAG;AACxD,MAAI,YAAa,MAAK,MAAM,YAAY;;CAG1C,MAAM,MAAS;AACb,OAAK,KAAK,MAAM;GAAE,0BAAS,IAAI,MAAM,EAAC,aAAa;GAAE;GAAM,CAAC;;CAG9D,OAAiC;EAC/B,MAAM,EAAE,SAAS,SAAS,KAAK,KAAK,MAAM,IAAI,EAAE;AAEhD,SAAO,CAAC,MADQ,QAAQ,WAAW,QAAQ,IAAI,SAAS,KAAK,IAAI,kBAAE,IAAI,MAAM,CAAC,CAAC,CACzD;;;;;;;;;;;ACH1B,IAAa,UAAb,MAAqB;CACnB;CAEA,YAAY,OAAqB,EAAE,EAAE;AACnC,OAAK,iBAAiB;GACpB,SAAS;GACT,SAAS;GACT,YAAY;GACZ,GAAG;GACJ;;;;;;CAOH,SAAS,OAAc,OAAqB,EAAE,EAAiB;EAC7D,MAAM,gBAAgB,MAAM,EAAE,EAAE,KAAK,gBAAgB,KAAK;EAC1D,MAAMC,SAA6B,EAAE;AACrC,SAAO,QAAQ,cAAc,SAAS,EAAE,CAAC,CAAC,SAAS,CAAC,KAAK,SAAS;AAChE,OAAI,QAAQ,OAAW;AACvB,OAAI,MAAM,QAAQ,IAAI,CACpB,KAAI,SAAS,MAAM;AACjB,WAAO,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC;KAC1B;OAEF,QAAO,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC;IAE9B;EACF,MAAM,SAAS,OAAO,SAAS,IAAI,MAAM,IAAI,gBAAgB,OAAO,CAAC,UAAU,GAAG;EAClF,MAAM,MAAM,IAAI,IAAI,QAAQ,QAAQ,KAAK,eAAe,KAAK;AAE7D,SAAO,CAAC,KADO,cAAc,IAAI,KAAK,CAClB;;;;;CAMtB,aAAa,OAAc,OAAqB,EAAE,EAAE;EAClD,MAAM,EAAE,YAAY,MAAM,EAAE,EAAE,KAAK,gBAAgB,KAAK;AACxD,SAAO,WAAW,EAAE;;;;;;CAOtB,aAAa,OAAc,OAAqB,EAAE,EAAmC;EACnF,MAAM,gBAAgB,MAAM,EAAE,EAAE,KAAK,gBAAgB,KAAK;EAC1D,MAAM,EAAE,OAAO,MAAM,oBAAS,SAAS,GAAG,SAAS;AACnD,OAAK,UAAU,KAAK,aAAa,OAAO,cAAc;AACtD,MAAI,MAAM;AACR,QAAK,QAAQ,kBAAkB,KAAK,QAAQ,mBAAmB;AAC/D,QAAK,SAAS,KAAK,UAAU;AAC7B,QAAK,OAAO,KAAK,UAAU,KAAK;;AAElC,MAAIC,UACF,MAAK,SAAS,YAAY,QAAQA,UAAQ;EAE5C,MAAM,CAAC,KAAK,UAAU,KAAK,SAAS,OAAO,cAAc;AAEzD,SAAO;GADK,IAAI,QAAQ,KAAK,KAAK;GACrB;GAAe;GAAO;;;;;;;CAQrC,MAAM,MAAM,OAAc,OAAqB,EAAE,EAAgC;EAC/E,MAAM,CAAC,MAAM,WAAW,KAAK,aAAa,OAAO,KAAK;EACtD,MAAM,eAAe,QAAQ,WAAW,KAAK;EAC7C,IAAI,UAAU;AACd,SAAO,UAAU,aAAa;AAC5B;GACA,MAAM,CAAC,OAAO,KAAK,aAAa,OAAO,KAAK;GAC5C,MAAM,MAAM,MAAM,MAAM,IAAI,CACzB,MAAM,MAAM;AACX,QAAI,CAAC,EAAE,GAAI,OAAM,IAAI,MAAM,EAAE,WAAW;AACxC,WAAO;KACP,CACD,MAAM,OAAO,UAAU;AACtB,QAAI,UAAU,aAAa;KACzB,MAAM,OAAO,UAAU;AACvB,aAAQ,KAAK,GAAG,IAAI,OAAO,GAAG,IAAI,IAAI,YAAY,QAAQ,MAAM,YAAY,IAAI,MAAM;AACtF,WAAM,IAAI,SAAS,YAAY,WAAW,SAAS,KAAK,CAAC;UAEzD,OAAM,IAAI,MAAM,MAAM;KAExB;AACJ,OAAI,IAAK,QAAO,CAAC,KAAK,IAAI;;AAE5B,QAAM,IAAI,MAAM,mBAAmB,KAAK,MAAM;;CAGhD,MAAM,UAAU,OAAc,OAAqB,EAAE,EAAwC;AAC3F,SAAO,KAAK,MAAM,OAAO,KAAK,CAAC,KAAK,OAAO,CAAC,KAAK,SAAS;AAExD,UAAO;IADM,MAAM,IAAI,MAAM;IACf;IAAK;IAAI;IACvB;;CAGJ,MAAM,UAAa,OAAc,OAAqB,EAAE,EAAmC;AACzF,SAAO,KAAK,UAAU,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,KAAK,SAAS;GAAC,KAAK,MAAM,IAAI;GAAO;GAAK;GAAI,CAAC;;;;;;;;;ACzHlG,IAAa,SAAb,MAAoB;;;;;;CAMlB,OAAO,KAAK,YAAoC,OAAO,oBAAmB,IAAI,MAAM,EAAE;AACpF,MAAI,cAAc,MAAO,QAAO,UAAU,EAAE;AAC5C,MAAI,cAAc,MAAO,QAAO,OAAO,GAAG,aAAa;AACvD,SAAO,OAAO,GAAG,UAAU;;;;;CAM7B,OAAO,MAAM,GAAW,SAAS,GAAG;AAClC,SAAO,IAAI,KAAK,aAAa,SAAS,EAAE,uBAAuB,QAAQ,CAAC,CAAC,OAAO,EAAE;;;;;CAMpF,OAAO,GAAG,IAAY;AACpB,MAAI,KAAK,IAAM,QAAO,GAAG,KAAK,MAAM,GAAG,CAAC;EACxC,MAAM,IAAI,KAAK;AACf,MAAI,IAAI,GAAI,QAAO,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC;EACvC,MAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAC5B,MAAI,IAAI,GAAI,QAAO,GAAG,EAAE,IAAI,KAAK,MAAM,EAAE,GAAG,GAAG;EAC/C,MAAM,IAAI,KAAK,MAAM,IAAI,GAAG;AAC5B,MAAI,IAAI,GAAI,QAAO,GAAG,EAAE,IAAI,IAAI,GAAG;AAEnC,SAAO,GADG,KAAK,MAAM,IAAI,GAAG,CAChB,IAAI,IAAI,GAAG;;CAGzB,OAAO,MAAM,GAAW;EACtB,MAAM,SAAS;GAAC;GAAK;GAAM;GAAM;GAAM;GAAK;EAC5C,IAAI,SAAS;AACb,SAAO,KAAK,QAAQ,OAAO,SAAS,IAAI;AACtC,OAAI,IAAI;AACR;;AAEF,SAAO,GAAG,KAAK,MAAM,GAAG,EAAE,CAAC,GAAG,OAAO;;;;;;AC5BzC,IAAa,MAAb,MAAiB;CAEf,OAAO,SAAS,QAAQ,IAAI,qBAAqB,yBAAyB,QAAQ,IAAI,wBAAwB;;;;CAK9G,QAAOC,SAAU,OAAc;AAC7B,MAAI,MAAM,SAAS,WAAW,EAC5B,SAAQ,IAAI,KAAK,UAAU,SAAS;GAAE,GAAG;GAAO,SAAS,MAAM,QAAQ;GAAI,CAAC,CAAC,CAAC;MAE9E,SAAQ,IAAI,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;;;;;CAOhD,QAAOC,UAAW,OAAc,OAAsB;AACpD,MAAI,MAAM,QAAS,SAAQ,IAAI,MAAM,IAAI,MAAM,SAAS,IAAI,MAAM,UAAU,CAAC;AAC7E,QAAM,SAAS,SAAS,WAAW;AACjC,WAAQ,IAAI,QAAQ,QAAQ;IAAE,OAAO;IAAI,aAAa;IAAK,SAAS;IAAM,QAAQ;IAAM,CAAC,CAAC;IAC1F;;CAGJ,QAAOC,IAAK,SAAkB,GAAG,OAAkB;EACjD,MAAM,EAAE,SAAS,YAAY,KAAK,QAAQ,GAAG,MAAM;AAGnD,MADiB,QAAQ,IAAI,cAAc,UAAa,QAAQ,IAAI,kBAAkB,QACxE;AACZ,SAAKF,SAAU;IAAE;IAAS,UAAU,QAAQ;IAAU;IAAS,CAAC;AAChE,UAAO;IAAE;IAAS;IAAS;IAAS;;AAGtC,MAAI,CAAC,KAAK,OACR,OAAKC,UAAW;GAAE;GAAS,UAAU,QAAQ;GAAU;GAAS,EAAE,QAAQ,MAAM;AAElF,SAAO;GAAE;GAAS;GAAS;GAAS;;;;;CAMtC,OAAO,QAAQ,GAAG,OAA4D;EAC5E,IAAI,CAAC,OAAO,GAAG,QAAQ;AACvB,MAAI,OAAO,UAAU,SACnB,QAAO;GAAE,SAAS;GAAO,SAAS;GAAM;AAG1C,MAAI,aAAa,MAAM,IAAI,OAAO,MAAM,eAAe,UAAU;GAC/D,MAAM,EAAE,SAAS,GAAG,iBAAiB;AACrC,UAAO;IAAE;IAAS,SAAS,CAAC,cAAc,GAAG,KAAK;IAAE;;AAEtD,SAAO,EAAE,SAAS,OAAO;;;;;CAM3B,OAAO,MAAM,GAAG,OAAkB;EAChC,MAAM,EAAE,YAAY,MAAKC,IAAK;GAAE,UAAU;GAAS,OAAO,MAAM;GAAK,EAAE,GAAG,MAAM;AAChF,QAAM,IAAI,MAAM,QAAQ;;CAG1B,OAAO,KAAK,GAAG,OAAkB;AAC/B,SAAO,MAAKA,IAAK;GAAE,UAAU;GAAW,OAAO,MAAM;GAAQ,EAAE,GAAG,MAAM;;CAG1E,OAAO,OAAO,GAAG,OAAkB;AACjC,SAAO,MAAKA,IAAK;GAAE,UAAU;GAAU,OAAO,MAAM;GAAM,EAAE,GAAG,MAAM;;CAGvE,OAAO,KAAK,GAAG,OAAkB;AAC/B,SAAO,MAAKA,IAAK;GAAE,UAAU;GAAQ,OAAO,MAAM;GAAO,EAAE,GAAG,MAAM;;CAGtE,OAAO,MAAM,GAAG,OAAkB;AAEhC,MADkB,QAAQ,KAAK,MAAM,QAAQ,IAAI,SAAS,UAAU,CAAC,IAAI,QAAQ,IAAI,UAAU,UAC9E,QAAQ,IAAI,aAAa,aACxC,QAAO,MAAKA,IAAK;GAAE,UAAU;GAAS,OAAO,MAAM;GAAM,EAAE,GAAG,MAAM;;;;;;ACjG1E,eAAsB,QAAQ,IAAY;AACxC,QAAO,IAAI,SAAS,YAAY;AAC9B,aAAW,SAAS,GAAG;GACvB;;;;;ACCJ,IAAa,aAAb,MAAwB;CACtB;CACA,QAAQ,GAAG,2BAA2B,aAAa;CACnD;CACA;CAEA,YAAY,YAAoB,WAAsD,EAAE,EAAE;AACxF,OAAK,aAAa;EAClB,MAAM,EAAE,QAAQ,GAAG,eAAe;AAClC,OAAK,SAAS,UAAU;AAUxB,OAAK,aAAa,MATM;GACtB,MAAM;GACN,iBAAiB;IACf,cAAc;IACd,gBAAgB;IACjB;GACD,YAAY;GACZ,gBAAgB;GACjB,EACwC,WAAW;;CAGtD,MAAM,UAAU,MAAc,UAAiB;EAC7C,MAAM,UAAU,SAAS,KAAK,MAAO,OAAO,MAAM,WAAW,IAAI,KAAK,UAAU,EAAE,CAAE;AACpF,QAAM,KAAK,MAAM,UAAU;GAAE;GAAM;GAAS,CAAC;;CAG/C,MAAM,WAAW;EACf,MAAM,YAAY,IAAI,GAAG,WAAW;AACpC,YAAU,SAAS,KAAK,MAAM;AAK9B,UAJe,MAAM,GAAG,UAAU;GAChC;GACA,GAAG,KAAK;GACT,CAAC,EACY,MAAM,KAAK,KAAK;;CAGhC,MAAM,SAAS;EACb,MAAM,SAAS,MAAM,KAAK,UAAU;AACpC,KAAG,UAAU,KAAK,QAAQ,EAAE,WAAW,MAAM,CAAC;AAC9C,KAAG,cAAc,GAAG,KAAK,OAAO,GAAG,KAAK,WAAW,QAAQ,OAAO"}
+{"version":3,"file":"index.mjs","names":["output: Record<string, any>","obj: Record<string, any>","parsed: Row[]","#parseVal","#inputPath","#resolved","params: [string, string][]","timeout","#toGcloud","#toConsole","#log","entry: Entry"],"sources":["../src/snapshot.ts","../src/File.ts","../src/Dir.ts","../src/Cache.ts","../src/Fetcher.ts","../src/Format.ts","../src/Log.ts","../src/timeout.ts","../src/TypeWriter.ts"],"sourcesContent":["import { isObjectLike } from 'lodash-es';\n\n/**\n * Allows special objects (Error, Headers, Set) to be included in JSON.stringify output.\n * Functions are removed\n */\nexport function snapshot(i: unknown, max = 50, depth = 0): any {\n  if (Array.isArray(i)) {\n    if (depth === max) return [];\n    return i.map(c => snapshot(c, max, depth + 1));\n  }\n  if (typeof i === 'function') return undefined;\n  if (!isObjectLike(i)) return i;\n\n  if (depth === max) return {};\n  let output: Record<string, any> = {};\n  // @ts-ignore If it has an 'entries' function, use that for looping (eg. Set, Map, Headers)\n  if (typeof i.entries === 'function') {\n    // @ts-ignore\n    for (let [k, v] of i.entries()) {\n      output[k] = snapshot(v, max, depth + 1);\n    }\n    return output;\n  }\n\n  // https://developer.mozilla.org/en-US/docs/Web/JavaScript/Guide/Enumerability_and_ownership_of_properties\n\n  // Get Enumerable, inherited properties\n  const obj: Record<string, any> = i!;\n  for (let key in obj) {\n    output[key] = snapshot(obj[key], max, depth + 1);\n  }\n\n  // Get Non-enumberable, own properties\n  Object.getOwnPropertyNames(obj).forEach(key => {\n    output[key] = snapshot(obj[key], max, depth + 1);\n  });\n\n  return output;\n}\n","import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport { Readable } from 'node:stream';\nimport { finished } from 'node:stream/promises';\nimport mime from 'mime-types';\nimport { writeToStream, parseStream } from 'fast-csv';\nimport { snapshot } from './snapshot.ts';\n\n/**\n * Represents a file on the file system. If the file doesn't exist, it is created the first time it is written to.\n */\nexport class File {\n  path;\n  root;\n  dir;\n  base;\n  name;\n  ext;\n  type;\n\n  constructor(filepath: string) {\n    this.path = path.resolve(filepath);\n    const { root, dir, base, ext, name } = path.parse(this.path);\n    this.root = root;\n    this.dir = dir;\n    this.base = base;\n    this.name = name;\n    this.ext = ext;\n    this.type = mime.lookup(ext) || undefined;\n  }\n\n  get exists() {\n    return fs.existsSync(this.path);\n  }\n\n  get stats(): Partial<fs.Stats> {\n    return this.exists ? fs.statSync(this.path) : {};\n  }\n\n  /**\n   * Deletes the file if it exists\n   */\n  delete() {\n    fs.rmSync(this.path, { force: true });\n  }\n\n  /**\n   * @returns the contents of the file as a string, or undefined if the file doesn't exist\n   */\n  read() {\n    return this.exists ? fs.readFileSync(this.path, 'utf8') : undefined;\n  }\n\n  /**\n   * @returns lines as strings, removes trailing '\\n'\n   */\n  lines() {\n    const contents = (this.read() || '').split('\\n');\n    return contents.at(-1)?.length ? contents : contents.slice(0, contents.length - 1);\n  }\n\n  get readStream() {\n    return this.exists ? fs.createReadStream(this.path) : Readable.from([]);\n  }\n\n  get writeStream() {\n    fs.mkdirSync(this.dir, { recursive: true });\n    return fs.createWriteStream(this.path);\n  }\n\n  write(contents: string | ReadableStream) {\n    fs.mkdirSync(this.dir, { recursive: true });\n    if (typeof contents === 'string') return fs.writeFileSync(this.path, contents);\n    if (contents instanceof ReadableStream) return finished(Readable.from(contents).pipe(this.writeStream));\n    throw new Error(`Invalid content type: ${typeof contents}`);\n  }\n\n  /**\n   * creates file if it doesn't exist, appends string or array of strings as new lines.\n   * File always ends with '\\n', so contents don't need to be read before appending\n   */\n  append(lines: string | string[]) {\n    if (!this.exists) this.write('');\n    const contents = Array.isArray(lines) ? lines.join('\\n') : lines;\n    fs.appendFileSync(this.path, contents + '\\n');\n  }\n\n  /**\n   * @returns FileTypeJson adaptor for current File, adds '.json' extension if not present.\n   * @example\n   * const file = new File('./data').json({ key: 'val' }); // FileTypeJson<{ key: string; }>\n   * console.log(file.path) // '/path/to/cwd/data.json'\n   * file.write({ something: 'else' }) // ❌ property 'something' doesn't exist on type { key: string; }\n   * @example\n   * const file = new File('./data').json<object>({ key: 'val' }); // FileTypeJson<object>\n   * file.write({ something: 'else' }) // ✅ data is typed as object\n   */\n  json<T>(contents?: T) {\n    return new FileTypeJson<T>(this.path, contents);\n  }\n\n  /**\n   * @example\n   * const file = new File.json('data.json', { key: 'val' }); // FileTypeJson<{ key: string; }>\n   */\n  static get json() {\n    return FileTypeJson;\n  }\n\n  /**\n   * @returns FileTypeNdjson adaptor for current File, adds '.ndjson' extension if not present.\n   */\n  ndjson<T extends object>(lines?: T | T[]) {\n    return new FileTypeNdjson<T>(this.path, lines);\n  }\n  /**\n   * @example\n   * const file = new File.ndjson('log', { key: 'val' }); // FileTypeNdjson<{ key: string; }>\n   * console.log(file.path) // /path/to/cwd/log.ndjson\n   */\n  static get ndjson() {\n    return FileTypeNdjson;\n  }\n\n  /**\n   * @returns FileTypeCsv adaptor for current File, adds '.csv' extension if not present.\n   * @example\n   * const file = await new File('a').csv([{ col: 'val' }, { col: 'val2' }]); // FileTypeCsv<{ col: string; }>\n   * await file.write([ { col2: 'val2' } ]); // ❌ 'col2' doesn't exist on type { col: string; }\n   * await file.write({ col: 'val' }); // ✅ Writes one row\n   * await file.write([{ col: 'val2' }, { col: 'val3' }]); // ✅ Writes multiple rows\n   */\n  async csv<T extends object>(rows?: T[], keys?: (keyof T)[]) {\n    const csvFile = new FileTypeCsv<T>(this.path);\n    if (rows) await csvFile.write(rows, keys);\n    return csvFile;\n  }\n\n  static get csv() {\n    return FileTypeCsv;\n  }\n}\n\n/**\n * A generic file adaptor, extended by specific file type implementations\n */\nexport class FileType {\n  file;\n\n  constructor(filepath: string, contents?: string) {\n    this.file = new File(filepath);\n    if (contents) this.file.write(contents);\n  }\n\n  get path() {\n    return this.file.path;\n  }\n\n  get root() {\n    return this.file.root;\n  }\n\n  get dir() {\n    return this.file.dir;\n  }\n\n  get base() {\n    return this.file.base;\n  }\n\n  get name() {\n    return this.file.name;\n  }\n\n  get ext() {\n    return this.file.ext;\n  }\n\n  get type() {\n    return this.file.type;\n  }\n\n  get exists() {\n    return this.file.exists;\n  }\n\n  get stats() {\n    return this.file.stats;\n  }\n\n  delete() {\n    this.file.delete();\n  }\n\n  get readStream() {\n    return this.file.readStream;\n  }\n\n  get writeStream() {\n    return this.file.writeStream;\n  }\n}\n\n/**\n * A .json file that maintains data type when reading/writing.\n * > ⚠️ This is mildly unsafe, important/foreign json files should be validated at runtime!\n * @example\n * const file = new FileTypeJson('./data', { key: 'val' }); // FileTypeJson<{ key: string; }>\n * console.log(file.path) // '/path/to/cwd/data.json'\n * file.write({ something: 'else' }) // ❌ property 'something' doesn't exist on type { key: string; }\n * @example\n * const file = new FileTypeJson<object>('./data', { key: 'val' }); // FileTypeJson<object>\n * file.write({ something: 'else' }) // ✅ data is typed as object\n */\nexport class FileTypeJson<T> extends FileType {\n  constructor(filepath: string, contents?: T) {\n    super(filepath.endsWith('.json') ? filepath : filepath + '.json');\n    if (contents) this.write(contents);\n  }\n\n  read() {\n    const contents = this.file.read();\n    return contents ? (JSON.parse(contents) as T) : undefined;\n  }\n\n  write(contents: T) {\n    this.file.write(JSON.stringify(snapshot(contents), null, 2));\n  }\n}\n\n/**\n * New-line delimited json file (.ndjson)\n * @see https://jsonltools.com/ndjson-format-specification\n */\nexport class FileTypeNdjson<T extends object> extends FileType {\n  constructor(filepath: string, lines?: T | T[]) {\n    super(filepath.endsWith('.ndjson') ? filepath : filepath + '.ndjson');\n    if (lines) this.append(lines);\n  }\n\n  append(lines: T | T[]) {\n    this.file.append(\n      Array.isArray(lines) ? lines.map(l => JSON.stringify(snapshot(l))) : JSON.stringify(snapshot(lines)),\n    );\n  }\n\n  lines() {\n    return this.file.lines().map(l => JSON.parse(l) as T);\n  }\n}\n\ntype Key<T extends object> = keyof T;\n\n/**\n * Comma separated values (.csv).\n * Input rows as objects, keys are used as column headers\n */\nexport class FileTypeCsv<Row extends object> extends FileType {\n  constructor(filepath: string) {\n    super(filepath.endsWith('.csv') ? filepath : filepath + '.csv');\n  }\n\n  async write(rows: Row[], keys?: Key<Row>[]) {\n    const headerSet = new Set<Key<Row>>();\n    if (keys) {\n      for (const key of keys) headerSet.add(key);\n    } else {\n      for (const row of rows) {\n        for (const key in row) headerSet.add(key);\n      }\n    }\n    const headers = Array.from(headerSet);\n    const outRows = rows.map(row => headers.map(key => row[key]));\n    return finished(writeToStream(this.file.writeStream, [headers, ...outRows]));\n  }\n\n  #parseVal(val: string) {\n    if (val.toLowerCase() === 'false') return false;\n    if (val.toLowerCase() === 'true') return true;\n    if (val.length === 0) return null;\n    if (/^[\\.0-9]+$/.test(val)) return Number(val);\n    return val;\n  }\n\n  async read() {\n    return new Promise<Row[]>((resolve, reject) => {\n      const parsed: Row[] = [];\n      parseStream(this.file.readStream, { headers: true })\n        .on('data', (raw: Record<Key<Row>, string>) => {\n          parsed.push(\n            Object.entries(raw).reduce(\n              (all, [key, val]) => ({\n                ...all,\n                [key]: this.#parseVal(val as string),\n              }),\n              {} as Row,\n            ),\n          );\n        })\n        .on('error', e => reject(e))\n        .on('end', () => resolve(parsed));\n    });\n  }\n}\n","import * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport sanitizeFilename from 'sanitize-filename';\nimport { File } from './File.ts';\n\nexport type DirOptions = {\n  temp?: boolean;\n};\n\n/**\n * Reference to a specific directory with methods to create and list files.\n * @param inputPath\n * The path of the directory, created on file system the first time `.path` is read or any methods are used\n * @param options\n * include `{ temp: true }` to enable the `.clear()` method\n */\nexport class Dir {\n  #inputPath;\n  #resolved?: string;\n  isTemp;\n\n  /**\n   * @param path can be relative to workspace or absolute\n   */\n  constructor(inputPath: string, options: DirOptions = {}) {\n    this.#inputPath = inputPath;\n    this.isTemp = Boolean(options.temp);\n  }\n\n  /**\n   * The path of this Dir instance. Created on file system the first time this property is read/used.\n   */\n  get path() {\n    if (!this.#resolved) {\n      this.#resolved = path.resolve(this.#inputPath);\n      fs.mkdirSync(this.#resolved, { recursive: true });\n    }\n    return this.#resolved;\n  }\n\n  /**\n   * Create a new Dir inside the current Dir\n   * @param subPath\n   * joined with parent Dir's path to make new Dir\n   * @param options\n   * include `{ temp: true }` to enable the `.clear()` method. If current Dir is temporary, child directories will also be temporary.\n   * @example\n   * const folder = new Dir('example');\n   * // folder.path = '/path/to/cwd/example'\n   * const child = folder.dir('path/to/dir');\n   * // child.path = '/path/to/cwd/example/path/to/dir'\n   */\n  dir(subPath: string, options: DirOptions = { temp: this.isTemp }) {\n    return new (this.constructor as typeof Dir)(path.join(this.path, subPath), options) as this;\n  }\n\n  /**\n   * Creates a new temp directory inside current Dir\n   * @param subPath joined with parent Dir's path to make new TempDir\n   */\n  tempDir(subPath: string) {\n    return this.dir(subPath, { temp: true });\n  }\n\n  sanitize(filename: string) {\n    const notUrl = filename.replace('https://', '').replace('www.', '');\n    return sanitizeFilename(notUrl, { replacement: '_' }).slice(-200);\n  }\n\n  /**\n   * @param base - The file base (name and extension)\n   * @example\n   * const folder = new Dir('example');\n   * const filepath = folder.resolve('file.json');\n   * // 'example/file.json'\n   */\n  filepath(base: string) {\n    return path.resolve(this.path, this.sanitize(base));\n  }\n\n  file(base: string) {\n    return new File(this.filepath(base));\n  }\n\n  get files() {\n    return fs.readdirSync(this.path).map(filename => this.file(filename));\n  }\n\n  clear() {\n    if (!this.isTemp) throw new Error('Dir is not temporary');\n    fs.rmSync(this.path, { recursive: true, force: true });\n    fs.mkdirSync(this.path, { recursive: true });\n  }\n}\n\n/**\n * Current working directory\n */\nexport const cwd = new Dir('./');\n/**\n * ./.temp in current working directory\n */\nexport const temp = cwd.tempDir('.temp');\n","import { type Duration, isAfter, add } from 'date-fns';\nimport { Dir } from './Dir.ts';\n\n/**\n * Save data to a local file with an expiration.\n * Fresh/stale data is returned with a flag for if it's fresh or not,\n * so stale data can still be used if needed.\n */\nexport class Cache<T> {\n  file;\n  ttl;\n\n  constructor(key: string, ttl: number | Duration, initialData?: T) {\n    const dir = new Dir('.cache', { temp: true });\n    this.file = dir.file(key).json<{ savedAt: string; data: T }>();\n    this.ttl = typeof ttl === 'number' ? { minutes: ttl } : ttl;\n    if (initialData) this.write(initialData);\n  }\n\n  write(data: T) {\n    this.file.write({ savedAt: new Date().toUTCString(), data });\n  }\n\n  read(): [T | undefined, boolean] {\n    const { savedAt, data } = this.file.read() || {};\n    const isFresh = Boolean(savedAt && isAfter(add(savedAt, this.ttl), new Date()));\n    return [data, isFresh];\n  }\n}\n","import { merge } from 'lodash-es';\nimport extractDomain from 'extract-domain';\n\nexport type Route = string | URL;\n\ntype QueryVal = string | number | boolean | null | undefined;\nexport type Query = Record<string, QueryVal | QueryVal[]>;\n\nexport type FetchOptions = RequestInit & {\n  base?: string;\n  query?: Query;\n  headers?: Record<string, string>;\n  data?: any;\n  timeout?: number;\n  retries?: number;\n  retryDelay?: number;\n};\n\n/**\n * Fetcher provides a quick way to set up a basic API connection\n * with options applied to every request.\n * Includes basic methods for requesting and parsing responses\n */\nexport class Fetcher {\n  defaultOptions;\n\n  constructor(opts: FetchOptions = {}) {\n    this.defaultOptions = {\n      timeout: 60000,\n      retries: 0,\n      retryDelay: 3000,\n      ...opts,\n    };\n  }\n\n  /**\n   * Build URL with URLSearchParams if query is provided.\n   * Also returns domain, to help with cookies\n   */\n  buildUrl(route: Route, opts: FetchOptions = {}): [URL, string] {\n    const mergedOptions = merge({}, this.defaultOptions, opts);\n    const params: [string, string][] = [];\n    Object.entries(mergedOptions.query || {}).forEach(([key, val]) => {\n      if (val === undefined) return;\n      if (Array.isArray(val)) {\n        val.forEach(v => {\n          params.push([key, `${v}`]);\n        });\n      } else {\n        params.push([key, `${val}`]);\n      }\n    });\n    const search = params.length > 0 ? '?' + new URLSearchParams(params).toString() : '';\n    const url = new URL(route + search, this.defaultOptions.base);\n    const domain = extractDomain(url.href) as string;\n    return [url, domain];\n  }\n\n  /**\n   * Merges options to get headers. Useful when extending the Fetcher class to add custom auth.\n   */\n  buildHeaders(route: Route, opts: FetchOptions = {}) {\n    const { headers } = merge({}, this.defaultOptions, opts);\n    return headers || {};\n  }\n\n  /**\n   * Builds request, merging defaultOptions and provided options.\n   * Includes Abort signal for timeout\n   */\n  buildRequest(route: Route, opts: FetchOptions = {}): [Request, FetchOptions, string] {\n    const mergedOptions = merge({}, this.defaultOptions, opts);\n    const { query, data, timeout, retries, ...init } = mergedOptions;\n    init.headers = this.buildHeaders(route, mergedOptions);\n    if (data) {\n      init.headers['content-type'] = init.headers['content-type'] || 'application/json';\n      init.method = init.method || 'POST';\n      init.body = JSON.stringify(data);\n    }\n    if (timeout) {\n      init.signal = AbortSignal.timeout(timeout);\n    }\n    const [url, domain] = this.buildUrl(route, mergedOptions);\n    const req = new Request(url, init);\n    return [req, mergedOptions, domain];\n  }\n\n  /**\n   * Builds and performs the request, merging provided options with defaultOptions.\n   * If `opts.data` is provided, method is updated to POST, content-type json, data is stringified in the body.\n   * Retries on local or network error, with increasing backoff.\n   */\n  async fetch(route: Route, opts: FetchOptions = {}): Promise<[Response, Request]> {\n    const [_req, options] = this.buildRequest(route, opts);\n    const maxAttempts = (options.retries || 0) + 1;\n    let attempt = 0;\n    while (attempt < maxAttempts) {\n      attempt++;\n      const [req] = this.buildRequest(route, opts);\n      const res = await fetch(req)\n        .then(r => {\n          if (!r.ok) throw new Error(r.statusText);\n          return r;\n        })\n        .catch(async error => {\n          if (attempt < maxAttempts) {\n            const wait = attempt * 3000;\n            console.warn(`${req.method} ${req.url} (attempt ${attempt} of ${maxAttempts})`, error);\n            await new Promise(resolve => setTimeout(resolve, wait));\n          } else {\n            throw new Error(error);\n          }\n        });\n      if (res) return [res, req];\n    }\n    throw new Error(`Failed to fetch ${_req.url}`);\n  }\n\n  async fetchText(route: Route, opts: FetchOptions = {}): Promise<[string, Response, Request]> {\n    return this.fetch(route, opts).then(async ([res, req]) => {\n      const text = await res.text();\n      return [text, res, req];\n    });\n  }\n\n  async fetchJson<T>(route: Route, opts: FetchOptions = {}): Promise<[T, Response, Request]> {\n    return this.fetchText(route, opts).then(([txt, res, req]) => [JSON.parse(txt) as T, res, req]);\n  }\n}\n","import { format, formatISO, type DateArg, type Duration } from 'date-fns';\nimport formatDuration from 'format-duration';\n\n/**\n * Helpers for formatting dates, times, and numbers as strings\n */\nexport class Format {\n  /**\n   * date-fns format() with some shortcuts\n   * @param formatStr the format to use\n   * @param date the date to format, default `new Date()`\n   * @example\n   * Format.date('iso') // '2026-04-08T13:56:45Z'\n   * Format.date('ymd') // '20260408'\n   * Format.date('ymd-hm') // '20260408-1356'\n   * Format.date('ymd-hms') // '20260408-135645'\n   * Format.date('h:m:s') // '13:56:45'\n   * @see more format options https://date-fns.org/v4.1.0/docs/format\n   */\n  static date(\n    formatStr: 'iso' | 'ymd' | 'ymd-hm' | 'ymd-hms' | 'h:m:s' | string = 'iso',\n    d: DateArg<Date> = new Date(),\n  ) {\n    if (formatStr === 'iso') return formatISO(d);\n    if (formatStr === 'ymd') return format(d, 'yyyyMMdd');\n    if (formatStr === 'ymd-hm') return format(d, 'yyyyMMdd-HHmm');\n    if (formatStr === 'ymd-hms') return format(d, 'yyyyMMdd-HHmmss');\n    if (formatStr === 'h:m:s') return format(d, 'HH:mm:ss');\n    return format(d, formatStr);\n  }\n\n  /**\n   * Round a number to a specific set of places\n   */\n  static round(n: number, places = 0) {\n    return new Intl.NumberFormat('en-US', { maximumFractionDigits: places }).format(n);\n  }\n\n  static plural(amount: number, singular: string, multiple?: string) {\n    return amount === 1 ? `${amount} ${singular}` : `${amount} ${multiple || singular + 's'}`;\n  }\n\n  /**\n   * Make millisecond durations actually readable (eg \"123ms\", \"3.56s\", \"1m 34s\", \"3h 24m\", \"2d 4h\")\n   * @param ms milliseconds\n   * @param style 'digital' to output as 'HH:MM:SS'\n   * @see details on 'digital' format https://github.com/ungoldman/format-duration\n   * @see waiting on `Intl.DurationFormat({ style: 'digital' })` types https://github.com/microsoft/TypeScript/issues/60608\n   */\n  static ms(ms: number, style?: 'digital') {\n    if (style === 'digital') return formatDuration(ms, { leading: true });\n    if (ms < 1000) return `${this.round(ms)}ms`;\n    const s = ms / 1000;\n    if (s < 60) return `${this.round(s, 2)}s`;\n    const m = Math.floor(s / 60);\n    if (m < 60) return `${m}m ${Math.floor(s) % 60}s`;\n    const h = Math.floor(m / 60);\n    if (h < 24) return `${h}h ${m % 60}m`;\n    const d = Math.floor(h / 24);\n    return `${d}d ${h % 24}h`;\n  }\n\n  static bytes(b: number) {\n    const labels = ['b', 'KB', 'MB', 'GB', 'TB'];\n    let factor = 0;\n    while (b >= 1024 && labels[factor + 1]) {\n      b = b / 1024;\n      factor++;\n    }\n    return `${this.round(b, 2)} ${labels[factor]}`;\n  }\n}\n","import { inspect } from 'node:util';\nimport { isObjectLike } from 'lodash-es';\nimport chalk, { type ChalkInstance } from 'chalk';\nimport { snapshot } from './snapshot.ts';\nimport { Format } from './Format.ts';\n\n// https://docs.cloud.google.com/logging/docs/reference/v2/rest/v2/LogEntry#logseverity\ntype Severity = 'DEFAULT' | 'DEBUG' | 'INFO' | 'NOTICE' | 'WARNING' | 'ERROR' | 'CRITICAL' | 'ALERT' | 'EMERGENCY';\n\ntype Options = {\n  severity: Severity;\n  color: ChalkInstance;\n};\n\ntype Entry = {\n  message?: string;\n  severity: Severity;\n  stack?: string;\n  details?: unknown[];\n};\n\nexport class Log {\n  static getStack() {\n    const details = { stack: '' };\n    // replaces details.stack with current stack trace, excluding this Log.getStack call\n    Error.captureStackTrace(details, Log.getStack);\n    // remove 'Error' on first line\n    return details.stack\n      .split('\\n')\n      .map(l => l.trim())\n      .filter(l => l !== 'Error');\n  }\n\n  /**\n   * Gcloud parses JSON in stdout\n   */\n  static #toGcloud(entry: Entry) {\n    const details = entry.details?.length === 1 ? entry.details[0] : entry.details;\n    const output = { ...entry, details, stack: entry.stack || this.getStack() };\n    console.log(JSON.stringify(snapshot(output)));\n  }\n\n  /**\n   * Includes colors and better inspection for logging during dev\n   */\n  static #toConsole(entry: Entry, color: ChalkInstance) {\n    if (entry.message) console.log(color(`${Format.date('h:m:s')} [${entry.severity}] ${entry.message}`));\n    entry.details?.forEach(detail => {\n      console.log(inspect(detail, { depth: 10, breakLength: 100, compact: true, colors: true }));\n    });\n  }\n\n  static #log({ severity, color }: Options, ...input: unknown[]) {\n    const { message, details } = this.prepare(...input);\n    const entry: Entry = { message, severity, details };\n    // https://cloud.google.com/run/docs/container-contract#env-vars\n    const isGcloud = process.env.K_SERVICE !== undefined || process.env.CLOUD_RUN_JOB !== undefined;\n    if (isGcloud) {\n      this.#toGcloud(entry);\n    } else {\n      this.#toConsole(entry, color);\n    }\n    return entry;\n  }\n\n  /**\n   * Handle first argument being a string or an object with a 'message' prop\n   */\n  static prepare(...input: unknown[]): { message?: string; details: unknown[] } {\n    let [firstArg, ...rest] = input;\n    // First argument is a string, use that as the message\n    if (typeof firstArg === 'string') {\n      return { message: firstArg, details: rest };\n    }\n    // First argument is an object with a `message` property\n    // @ts-ignore\n    if (isObjectLike(firstArg) && typeof firstArg['message'] === 'string') {\n      const { message, ...firstDetails } = firstArg as { message: string };\n      return { message, details: [firstDetails, ...rest] };\n    }\n    // No message found, log all args as details\n    return { details: input };\n  }\n\n  /**\n   * Events that require action or attention immediately\n   */\n  static alert(...input: unknown[]) {\n    return this.#log({ severity: 'ALERT', color: chalk.bgRed }, ...input);\n  }\n\n  /**\n   * Events that cause problems\n   */\n  static error(...input: unknown[]) {\n    return this.#log({ severity: 'ERROR', color: chalk.red }, ...input);\n  }\n\n  /**\n   * Events that might cause problems\n   */\n  static warn(...input: unknown[]) {\n    return this.#log({ severity: 'WARNING', color: chalk.yellow }, ...input);\n  }\n\n  /**\n   * Normal but significant events, such as start up, shut down, or a configuration change\n   */\n  static notice(...input: unknown[]) {\n    return this.#log({ severity: 'NOTICE', color: chalk.cyan }, ...input);\n  }\n\n  /**\n   * Routine information, such as ongoing status or performance\n   */\n  static info(...input: unknown[]) {\n    return this.#log({ severity: 'INFO', color: chalk.white }, ...input);\n  }\n\n  /**\n   * Debug or trace information\n   */\n  static debug(...input: unknown[]) {\n    return this.#log({ severity: 'DEBUG', color: chalk.gray }, ...input);\n  }\n}\n","export async function timeout(ms: number) {\n  return new Promise(resolve => {\n    setTimeout(resolve, ms);\n  });\n}\n","import * as fs from 'node:fs';\nimport { merge } from 'lodash-es';\nimport * as qt from 'quicktype-core';\n\nexport class TypeWriter {\n  moduleName;\n  input = qt.jsonInputForTargetLanguage('typescript');\n  outDir;\n  qtSettings;\n\n  constructor(moduleName: string, settings: { outDir?: string } & Partial<qt.Options> = {}) {\n    this.moduleName = moduleName;\n    const { outDir, ...qtSettings } = settings;\n    this.outDir = outDir || './types';\n    const defaultSettings = {\n      lang: 'typescript',\n      rendererOptions: {\n        'just-types': true,\n        'prefer-types': true,\n      },\n      inferEnums: false,\n      inferDateTimes: false,\n    };\n    this.qtSettings = merge(defaultSettings, qtSettings);\n  }\n\n  async addMember(name: string, _samples: any[]) {\n    const samples = _samples.map(s => (typeof s === 'string' ? s : JSON.stringify(s)));\n    await this.input.addSource({ name, samples });\n  }\n\n  async toString() {\n    const inputData = new qt.InputData();\n    inputData.addInput(this.input);\n    const result = await qt.quicktype({\n      inputData,\n      ...this.qtSettings,\n    });\n    return result.lines.join('\\n');\n  }\n\n  async toFile() {\n    const result = await this.toString();\n    fs.mkdirSync(this.outDir, { recursive: true });\n    fs.writeFileSync(`${this.outDir}/${this.moduleName}.d.ts`, result);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brianbuie/node-kit",
-  "version": "0.12.4",
+  "version": "0.13.0",
   "license": "ISC",
   "description": "Basic tools for Node.js projects",
   "author": "Brian Buie <brian@buie.dev>",
@@ -9,7 +9,7 @@
     "url": "git+https://github.com/brianbuie/node-kit.git"
   },
   "scripts": {
-    "build": "tsdown && node ./node_modules/ts2md/out/src/ts2md.js --firstHeadingLevel=1",
+    "build": "prettier . -w && tsdown && ts2md --firstHeadingLevel=1",
     "test": "tsc && node --test \"src/*.test.ts\" --quiet",
     "preversion": "npm test && npm run build",
     "postversion": "git push --follow-tags"
@@ -38,12 +38,14 @@
     "date-fns": "^4.1.0",
     "extract-domain": "^5.0.2",
     "fast-csv": "^5.0.5",
+    "format-duration": "^3.0.2",
     "lodash-es": "^4.17.21",
     "mime-types": "^3.0.2",
     "quicktype-core": "^23.2.6",
     "sanitize-filename": "^1.6.3"
   },
   "devDependencies": {
+    "prettier": "^3.7.4",
     "ts2md": "^0.2.8",
     "tsdown": "^0.16.6",
     "typescript": "^5.9.3"

package/prettier.config.ts

@@ -1,8 +1,6 @@
-const config = {
+export default {
   printWidth: 120,
   singleQuote: true,
   quoteProps: 'consistent',
   arrowParens: 'avoid',
 };
-
-export default config;

package/src/Cache.ts

@@ -1,5 +1,5 @@
 import { type Duration, isAfter, add } from 'date-fns';
-import { TempDir } from './Dir.ts';
+import { Dir } from './Dir.ts';
 
 /**
  * Save data to a local file with an expiration.
@@ -11,7 +11,7 @@ export class Cache<T> {
   ttl;
 
   constructor(key: string, ttl: number | Duration, initialData?: T) {
-    const dir = new TempDir('.cache');
+    const dir = new Dir('.cache', { temp: true });
     this.file = dir.file(key).json<{ savedAt: string; data: T }>();
     this.ttl = typeof ttl === 'number' ? { minutes: ttl } : ttl;
     if (initialData) this.write(initialData);

package/src/Dir.test.ts

@@ -1,13 +1,10 @@
 import { describe, it } from 'node:test';
 import assert from 'node:assert';
-import path from 'node:path';
-import { Dir, TempDir, temp } from './Dir.ts';
+import { temp, Dir, type DirOptions } from './Dir.ts';
 
 describe('Dir', () => {
   const testDir = temp.dir('dir-test');
 
-  console.log(path.join('/dir1', '/dir2', 'dir3'));
-
   it('Sanitizes filenames', () => {
     const name = testDir.sanitize(':/something/else.json');
     assert(!name.includes('/'));
@@ -21,14 +18,19 @@ describe('Dir', () => {
     assert(sub.path.includes(subPath));
   });
 
-  it('.tempDir returns instance of TempDir', () => {
+  it('.tempDir returns temporary directory', () => {
     const sub = testDir.tempDir('example');
-    assert(sub instanceof TempDir);
+    assert(sub.isTemp);
   });
 
-  it('.dir() and .tempDir() make relative paths', () => {
+  it('.dir() makes relative paths', () => {
     assert(testDir.dir('/').path.includes(testDir.path));
-    assert(testDir.tempDir('/').path.includes(testDir.path));
+  });
+
+  it('.isTemp flows down to child Dirs', () => {
+    const base = testDir.tempDir('temp-by-default');
+    const child = base.dir('child');
+    assert(child.isTemp);
   });
 
   it('Resolves filenames in folder', () => {
@@ -36,4 +38,22 @@ describe('Dir', () => {
     assert(txt.includes(testDir.path));
     assert(txt.includes('test.txt'));
   });
+
+  it('is extendable and chains methods correctly', () => {
+    class Example extends Dir {
+      get jsonFiles() {
+        return this.files.filter(f => f.ext === '.json');
+      }
+    }
+    const testRoot = testDir.tempDir('extendable');
+    const test = new Example(testRoot.path);
+    const child = test.dir('child');
+    assert(child instanceof Example);
+    child.file('child.json').json({});
+    assert(child.jsonFiles.length === 1);
+    const childTemp = child.tempDir('temp-child');
+    assert(childTemp instanceof Example);
+    childTemp.file('child-temp').json({});
+    assert(childTemp.jsonFiles.length === 1);
+  });
 });