@brianbuie/node-kit 0.16.0 → 0.16.1

package/README.md

@@ -45,6 +45,12 @@ export default config;
 
 # Changelog
 
+## 0.16.1
+
+- New `Cmd` utility for running shell commands, handling output and errors
+  - `Cmd.ffmpeg` and `Cmd.ffprobe` added with basic config for handling output (ffmpeg and ffprobe need to be installed separately)
+- New `FileTypeImage` and `FileTypeVideo` extensions with methods to get media dimensions
+
 ## 0.16
 
 - `Log` rewritten using [pino](https://github.com/pinojs/pino) under the hood. Will require updates in projects:
@@ -79,19 +85,15 @@ Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types
 
 # Classes
 
-| |
-| --- |
-| [Cache](#class-cache) |
-| [Dir](#class-dir) |
-| [Fetcher](#class-fetcher) |
-| [File](#class-file) |
-| [FileType](#class-filetype) |
-| [FileTypeCsv](#class-filetypecsv) |
-| [FileTypeJson](#class-filetypejson) |
-| [FileTypeNdjson](#class-filetypendjson) |
-| [Format](#class-format) |
-| [Log](#class-log) |
-| [TypeWriter](#class-typewriter) |
+| | |
+| --- | --- |
+| [Cache](#class-cache) | [FileTypeImage](#class-filetypeimage) |
+| [Cmd](#class-cmd) | [FileTypeJson](#class-filetypejson) |
+| [Dir](#class-dir) | [FileTypeNdjson](#class-filetypendjson) |
+| [Fetcher](#class-fetcher) | [FileTypeVideo](#class-filetypevideo) |
+| [File](#class-file) | [Format](#class-format) |
+| [FileType](#class-filetype) | [Log](#class-log) |
+| [FileTypeCsv](#class-filetypecsv) | [TypeWriter](#class-typewriter) |
 
 Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
@@ -123,6 +125,62 @@ See also: [FileTypeJson](#class-filetypejson)
 
 Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
+---
+## Class: Cmd
+
+Spawn a child process for shell commands with `Cmd.run('command arg1=something arg2=2...")`
+
+```ts
+export class Cmd {
+    static bin = "/usr/local/bin";
+    static configure({ bin }: {
+        bin: string;
+    }): void 
+    static args(args: Args): string[] 
+    static async run(cmd: string, args: Args, opts?: SpawnOptionsWithoutStdio): Promise<string> 
+    static async ffmpeg(args: Args) 
+    static async ffprobe(args: Args) 
+}
+```
+
+See also: [Args](#type-args)
+
+<details>
+
+<summary>Class Cmd Details</summary>
+
+### Method configure
+
+configure global location of bin files
+
+```ts
+static configure({ bin }: {
+    bin: string;
+}): void 
+```
+
+### Method ffmpeg
+
+Run ffmpeg for video processing (ffmpeg needs to be installed separately)
+
+```ts
+static async ffmpeg(args: Args) 
+```
+See also: [Args](#type-args)
+
+### Method ffprobe
+
+Use ffprobe to get video stream dimensions (ffprobe needs to be installed separately)
+
+```ts
+static async ffprobe(args: Args) 
+```
+See also: [Args](#type-args)
+
+</details>
+
+Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
+
 ---
 ## Class: Dir
 
@@ -385,10 +443,14 @@ export class File {
     static get ndjson(): typeof FileTypeNdjson 
     async csv<T extends object>(rows?: T[], options?: FileTypeCsvOptions<T>): Promise<FileTypeCsv<T>> 
     static get csv(): typeof FileTypeCsv 
+    async image(content?: ReadableStream) 
+    static get image(): typeof FileTypeImage 
+    async video(content?: ReadableStream) 
+    static get video(): typeof FileTypeVideo 
 }
 ```
 
-See also: [FileTypeCsv](#class-filetypecsv), [FileTypeJson](#class-filetypejson), [FileTypeNdjson](#class-filetypendjson)
+See also: [FileTypeCsv](#class-filetypecsv), [FileTypeImage](#class-filetypeimage), [FileTypeJson](#class-filetypejson), [FileTypeNdjson](#class-filetypendjson), [FileTypeVideo](#class-filetypevideo)
 
 <details>
 
@@ -538,6 +600,22 @@ See also: [FileType](#class-filetype)
 
 Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
+---
+## Class: FileTypeImage
+
+```ts
+export class FileTypeImage extends FileType {
+    async dimensions(): Promise<{
+        width: number;
+        height: number;
+    }> 
+}
+```
+
+See also: [FileType](#class-filetype)
+
+Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
+
 ---
 ## Class: FileTypeJson
 
@@ -586,6 +664,23 @@ See also: [FileType](#class-filetype)
 
 Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
 
+---
+## Class: FileTypeVideo
+
+```ts
+export class FileTypeVideo extends FileType {
+    async dimensions(): Promise<{
+        width: number;
+        height: number;
+        duration: number;
+    }> 
+}
+```
+
+See also: [FileType](#class-filetype)
+
+Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
+
 ---
 ## Class: Format
 
@@ -767,6 +862,7 @@ Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types
 
 | |
 | --- |
+| [Args](#type-args) |
 | [DirOptions](#type-diroptions) |
 | [FetchOptions](#type-fetchoptions) |
 | [LogDetails](#type-logdetails) |
@@ -779,6 +875,15 @@ Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types
 
 ---
 
+## Type: Args
+
+```ts
+export type Args = string | (string | number | null | undefined | Args)[]
+```
+
+Links: [API](#api), [Classes](#classes), [Functions](#functions), [Types](#types), [Variables](#variables)
+
+---
 ## Type: DirOptions
 
 ```ts

package/dist/index.d.mts

@@ -76,6 +76,10 @@ declare class File {
    */
   csv<T extends object>(rows?: T[], options?: FileTypeCsvOptions<T>): Promise<FileTypeCsv<T>>;
   static get csv(): typeof FileTypeCsv;
+  image(content?: ReadableStream): Promise<FileTypeImage>;
+  static get image(): typeof FileTypeImage;
+  video(content?: ReadableStream): Promise<FileTypeVideo>;
+  static get video(): typeof FileTypeVideo;
 }
 /**
  * A generic file adaptor, extended by specific file type implementations
@@ -139,6 +143,19 @@ declare class FileTypeCsv<Row extends object> extends FileType {
   write(rows: Row[]): Promise<void>;
   read(): Promise<Row[]>;
 }
+declare class FileTypeImage extends FileType {
+  dimensions(): Promise<{
+    width: number;
+    height: number;
+  }>;
+}
+declare class FileTypeVideo extends FileType {
+  dimensions(): Promise<{
+    width: number;
+    height: number;
+    duration: number;
+  }>;
+}
 //#endregion
 //#region src/Dir.d.ts
 type DirOptions = {

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/File.ts","../src/Dir.ts","../src/Cache.ts","../src/Fetcher.ts","../src/Format.ts","../src/Log.ts","../src/snapshot.ts","../src/timeout.ts","../src/TypeWriter.ts"],"sourcesContent":[],"mappings":";;;;;;;;;;cAWa,IAAA;;EAAA,IAAA,EAAA,MAAI;EAmCS,IAAA,EAAA,MAAA;EAAX,GAAA,EAAA,MAAA;EA0BQ,IAAA,EAAA,MAAA;EAAa,IAAA,EAAA,MAAA;EAIZ,GAAA,EAAA,MAAA;EAKG,IAAA,CAAA,EAAA,MAAA;EAAwB,WAAA,CAAA,QAAA,EAAA,MAAA;EA2B9B,IAAA,MAAA,CAAA,CAAA,EAAA,OAAA;EAAiB,IAAA,KAAA,CAAA,CAAA,EA9DvB,OA8DuB,CA9Df,EAAA,CAAG,KA8DY,CAAA;EAAb;;;EAec,MAAA,CAAA,CAAA,EAAA,IAAA;EAAqB;;;EAoBvB,IAAA,CAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAkC;;;EAAa,KAAA,CAAA,CAAA,EAAA,MAAA,EAAA;EAAR,IAAA,UAAA,CAAA,CAAA,EAvExD,EAAA,CAAG,UAuEqD,GAvExC,QAuEwC;EAMjD,IAAA,WAAA,CAAA,CAAA,EAzEN,EAAA,CAAG,WAyEG;EAAW,KAAA,CAAA,QAAA,EAAA,MAAA,GApEX,cAoEW,CAAA,EAAA,IAAA,GApEa,OAoEb,CAAA,IAAA,CAAA;EAQzB;;;;EAgDU,MAAA,CAAA,KAAA,EAAA,MAAA,GAAA,MAAA,EAAA,CAAA,EAAA,IAAA;EAAa;;;AAoBpC;;;;;;AAoBA;EACwC,IAAA,CAAA,CAAA,CAAA,CAAA,QAAA,CAAA,EA1InB,CA0ImB,CAAA,EA1If,YA0Ie,CA1IF,CA0IE,CAAA;EAAI;;;;EADU,WAAA,IAAA,CAAA,CAAA,EAAA,OAjI1B,YAiI0B;EAAQ;AAa7D;AAEmC;EAavB,MAAA,CAAA,UAAW,MAAA,CAAA,CAAA,KAAA,CAAA,EAtJW,CAsJX,GAtJe,CAsJf,EAAA,CAAA,EAtJqB,cAsJrB,CAtJoC,CAsJpC,CAAA;EACM;;;;;EAYF,WAAA,MAAA,CAAA,CAAA,EAAA,OA3JE,cA2JF;EAuBJ;;;;;;;AC/SxB;EAWa,GAAA,CAAA,UAAG,MAAA,CAAA,CAAA,IAAA,CAAA,ED8HqB,CC9HrB,EAAA,EAAA,OAAA,CAAA,ED8HoC,kBC9HpC,CD8HuD,CC9HvD,CAAA,CAAA,ED8H4D,OC9H5D,CD8HoE,WC9HpE,CD8HgF,CC9HhF,CAAA,CAAA;EAQuC,WAAA,GAAA,CAAA,CAAA,EAAA,OD4H5B,WC5H4B;;;;;AA6FpC,cDuCN,QAAA,CCvCM;EAAM,IAAA,EDwCjB,ICxCiB;EASX,WAAA,CAAA,QAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA;EAOC,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;EAOC,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;EAOA,IAAA,GAAA,CAAA,CAAA,EAAA,MAAA;EAWG,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;EAWE,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;EAWH,IAAA,GAAA,CAAA,CAAA,EAAA,MAAA;EAOA,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA,GAAA,SAAA;EAAI,IAAA,MAAA,CAAA,CAAA,EAAA,OAAA;EAiBT,IAAA,KAAmB,CAAA,CAAA,EDRjB,OCQC,CDRO,EAAA,CAAG,KCQM,CAAA;EAInB,MAAA,CAAA,CAA2B,EAAA,IAAA;oBDJpB,EAAA,CAAG,aAAa;qBAIf,EAAA,CAAG;;AExMxB;;;;;;;;;;;cFwNa,wBAAwB,QAAA;EG9NzB,WAAK,CAAA,QAAY,EAAA,MAAG,EAAA,QAAA,CAAA,EH+NW,CG/NX;EAE3B,IAAA,CAAA,CAAA,EHkOK,CGlOL,GAAQ,SAAA;EACD,KAAA,CAAA,QAAK,EHsOC,CGtOD,CAAA,EAAA,IAAA;;;;;AAEjB;AAA2B,cH6Od,cG7Oc,CAAA,UAAA,MAAA,CAAA,SH6O2B,QAAA,CG7O3B;EAEjB,WAAA,CAAA,QAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EH4O8B,CG5O9B,GH4OkC,CG5OlC,EAAA;EACE,MAAA,CAAA,KAAA,EHgPI,CGhPJ,GHgPQ,CGhPR,EAAA,CAAA,EAAA,IAAA;EAAM,KAAA,CAAA,CAAA,EHoPP,CGpPO,EAAA;AAYlB;KH6OK,GG5Oa,CAAA,UAAA,MAAA,CAAA,GAAA,MH4OiB,CG5OjB;KH8Ob,kBG5Oe,CAAA,YAAA,MAAA,CAAA,GAAA;EAiBF,YAAA,CAAA,EAAA,OAAA;EAAa,aAAA,CAAA,EAAA,OAAA;EAAqB,UAAA,CAAA,EAAA,OAAA;EAwB9B,IAAA,CAAA,EHuMb,GGvMa,CHuMT,GGvMS,CAAA,EAAA;CAAa;;;;;AASqB,cHqM3C,WGrM2C,CAAA,YAAA,MAAA,CAAA,SHqMH,QAAA,CGrMG;EAAS,CAAA,OAAA;EAsB5C,OAAA,EHgLV,kBGhLU,CHgLS,GGhLT,CAAA;EAAa,WAAA,CAAA,QAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EHkLO,kBGlLP,CHkL0B,GGlL1B,CAAA;EAA6B,KAAA,CAAA,IAAA,EH4L3C,GG5L2C,EAAA,CAAA,EH4LnC,OG5LmC,CAAA,IAAA,CAAA;EAAU,IAAA,CAAA,CAAA,EHmNzD,OGnNyD,CHmNjD,GGnNiD,EAAA,CAAA;;;;KF5F7D,UAAA;;;;;;ADKZ;;;;AA6DoC,cCvDvB,GAAA,CDuDuB;EAIZ,CAAA,OAAA;EAKG,MAAA,EAAA,OAAA;EAAwB;;;EA2B1B,WAAA,CAAA,SAAA,CAAA,EAAA,MAAA,EAAA,OAAA,CAAA,ECnF8B,UDmF9B;EAQG;;;EAOgC,IAAA,UAAA,CAAA,CAAA,EAAA,MAAA;EAAf;;;;EAoBO,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;EAA4C;;;;;AAchG;EACQ,IAAA,IAAA,CAAA,CAAA,EAAA,MAAA;EAuCkB;;;;;;AA4B1B;;;;;;EAoBa,GAAA,CAAA,OAAc,CAAd,EAAA,MAAc,EAAA,OAAA,CAAA,ECrKkB,UDqKlB,CAAA,ECrKuD,GDqKvD;EACa;;;;EAS7B,OAAA,CAAA,OAAA,CAAA,EAAA,MAAA,CAAA,ECvKkB,GDuKlB;EAV2C,QAAA,CAAA,QAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAAQ;AAa7D;AAEmC;AAapC;;;;EAGyC,QAAA,CAAA,IAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAUrB;;;EAuBJ,IAAA,CAAA,IAAA,CAAA,EAAA,MAAA,CAAA,ECtMuB,IDsMvB;EApCqC;;;mBC3JlC,MAAM;;AAhHzB;AAWA;EAQuD,IAAA,IAAA,CAAA,CAAA,EAsGzC,GAtGyC,EAAA;EAuDV;;;EA+BN,IAAA,KAAA,CAAA,CAAA,EAuBxB,IAvBwB,EAAA;EAOpB;;;EAgBJ,IAAA,MAAA,CAAA,CAAA,EAOC,IAPD,EAAA;EAOC;;;EA6BK,IAAA,MAAA,CAAA,CAAA,EAtBL,IAsBK,EAAA;EAWH;;;AAwBlB;AAIA;;;mBAlDmB;ECtJN;;;;;;;EAeF,IAAA,WAAA,CAAA,CAAA,EDkJU,IClJV,EAAA;EAAC;;;;ACrBZ;AAAiC;AAGjC;EAAmC,IAAA,QAAA,CAAA,CAAA,EF+KjB,IE/KiB,EAAA;EAAW;;;EAElC,IAAA,QAAA,CAAA,CAAA,EFoLM,IEpLM,EAAA;EAAG;;;EAGT,KAAA,CAAA,CAAA,EAAA,IAAA;AAYlB;;;;AAoB+B,cFkKlB,GElKkB,EFkKf,GElKe;;;;AAwBwB,cF8I1C,IE9I0C,EF8ItC,GE9IsC;;;;;;;;AHxD1C,cEFA,KFEI,CAAA,CAAA,CAAA,CAAA;EAmCS,IAAA,EEpClB,YFoCkB,CAAA;IAAX,OAAA,EAAA,MAAA;IA0BQ,IAAA,EE9DuB,CF8DvB;EAAa,CAAA,CAAA;EAIZ,GAAA,EEjEjB,QFiEiB;EAKG,WAAA,CAAA,GAAA,EAAA,MAAA,EAAA,GAAA,EAAA,MAAA,GEpEc,QFoEd,EAAA,WAAA,CAAA,EEpEsC,CFoEtC;EAAwB,KAAA,CAAA,IAAA,EE7DrC,CF6DqC,CAAA,EAAA,IAAA;EA2B9B,IAAA,CAAA,CAAA,EAAA,CEpFV,CFoFU,GAAA,SAAA,EAAA,OAAA,CAAA;;;;KGzGT,KAAA,YAAiB;KAExB,QAAA;KACO,KAAA,GAAQ,eAAe,WAAW;KAElC,YAAA,GAAe;;UAEjB;YACE;EHAC,IAAA,CAAA,EAAI,GAAA;EAmCS,OAAA,CAAA,EAAA,MAAA;EAAX,OAAA,CAAA,EAAA,MAAA;EA0BQ,UAAA,CAAA,EAAA,MAAA;CAAa;;;;;;AAoCX,cGrFZ,OAAA,CHqFY;EAQG,cAAA,EG5FV,YH4FU;EAOO,WAAA,CAAA,IAAA,CAAA,EGjGf,YHiGe;EAAI;;;;;;;;EAoB6C,QAAA,CAAA,KAAA,EGpGlE,KHoGkE,EAAA,IAAA,CAAA,EGpGrD,YHoGqD,CAAA,EAAA,CGpGhC,GHoGgC,EAAA,MAAA,CAAA;EAAR;;;EAc/D,YAAQ,CAAA,KAAA,EG1FC,KH0FD,EAAA,IAAA,CAAA,EG1Fc,YH0Fd,CAAA,EG1FkC,WH0FlC,GG1FgD,MH0FhD,CAAA,MAAA,EAAA,MAAA,CAAA;EACb;;;;EA+C4B,YAAA,CAAA,KAAA,EGjId,KHiIc,EAAA,IAAA,CAAA,EGjID,YHiIC,CAAA,EAAA,CGjIoB,OHiIpB,EGjI6B,YHiI7B,EAAA,MAAA,CAAA;EAIZ;;AAgBxB;;;EAWkB,KAAA,CAAA,KAAA,EG1IG,KH0IH,EAAA,IAAA,CAAA,EG1IgB,YH0IhB,CAAA,EG1IoC,OH0IpC,CAAA,CG1I6C,QH0I7C,EG1IuD,OH0IvD,CAAA,CAAA;EAXmB,SAAA,CAAA,KAAA,EGrGZ,KHqGY,EAAA,IAAA,CAAA,EGrGC,YHqGD,CAAA,EGrGqB,OHqGrB,CAAA,CAAA,MAAA,EGrGsC,QHqGtC,EGrGgD,OHqGhD,CAAA,CAAA;EAAQ,SAAA,CAAA,CAAA,CAAA,CAAA,KAAA,EG9FjB,KH8FiB,EAAA,IAAA,CAAA,EG9FJ,YH8FI,CAAA,EG9FgB,OH8FhB,CAAA,CG9FyB,CH8FzB,EG9F4B,QH8F5B,EG9FsC,OH8FtC,CAAA,CAAA;AAoB7C;;;;;;cI/Oa,MAAA;;;AJKb;;;;;;;;;;EAiGyB,OAAA,IAAA,CAAA,SAAA,CAAA,EAAA,KAAA,GAAA,KAAA,GAAA,QAAA,GAAA,SAAA,GAAA,OAAA,GAAA,MAAA,EAAA,CAAA,CAAA,EIvFlB,OJuFkB,CIvFV,IJuFU,CAAA,CAAA,EAAA,MAAA;EAQG;;;EAOgC,OAAA,KAAA,CAAA,CAAA,EAAA,MAAA,EAAA,MAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAAf,OAAA,MAAA,CAAA,MAAA,EAAA,MAAA,EAAA,QAAA,EAAA,MAAA,EAAA,QAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;EAQf;;;;;;;EAkBH,OAAA,EAAA,CAAA,EAAA,EAAA,MAAA,EAAA,KAAA,CAAA,EAAA,SAAA,CAAA,EAAA,MAAA;EAAW,OAAA,KAAA,CAAA,CAAA,EAAA,MAAA,CAAA,EAAA,MAAA;AAQtC;;;KK1JY,UAAA,GAAa;KAIb,UAAA,GAAa,IAAA,CAAK;;;;ALI9B;;;;;AAiEwB,cK3DX,GAAA,CL2DW;EAKG,CAAA,OAAA;EAAwB,OAAA,YAAA,CAAA,CAAA,EK5D1B,ML4D0B;EA2B9B,OAAA,SAAA,CAAA,OAAA,CAAA,EK/DO,UL+DP,CAAA,EAAA,IAAA;EAAiB,OAAA,KAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EK9CI,UL8CJ,CAAA,EAAA,IAAA;EAAb,OAAA,KAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EK1CiB,UL0CjB,CAAA,EAAA,IAAA;EAQG,OAAA,IAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EK9Ca,UL8Cb,CAAA,EAAA,IAAA;EAOO,OAAA,IAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EKjDM,ULiDN,CAAA,EAAA,IAAA;EAAI,OAAA,KAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EK7CG,UL6CH,CAAA,EAAA,IAAA;EAAqB,OAAA,KAAA,CAAA,OAAA,EAAA,MAAA,EAAA,OAAA,CAAA,EKzClB,ULyCkB,CAAA,EAAA,IAAA;;;;;;;;;iBMpH5C,QAAA;;;iBCPM,OAAA,cAAqB;;;;;;;;;APW3C;;AAmCe,cQlCF,UAAA,CRkCE;EA0BQ,UAAA,EAAA,MAAA;EAAa,KAAA,EQ1D7B,EAAA,CAAA,SR0D6B,CAAA,MAAA,CAAA;EAIZ,MAAA,EAAA,MAAA;EAKG,OAAA,EAAA,MAAA;EAAwB,UAAA,EQhErC,ORgEqC,CQhE7B,EAAA,CAAG,ORgE0B,CAAA;EA2B9B,WAAA,CAAA,UAAA,EAAA,MAAA,EAAA,QAQO,CARP,EAAA;IAAiB,MAAA,CAAA,EAAA,MAAA;IAAb,OAAA,CAAA,EAAA,MAAA;EAQG,CAAA,GQjGwD,ORiGxD,CQjGgE,EAAA,CAAG,ORiGnE,CAAA;EAOO,SAAA,CAAA,IAAA,EAAA,MAAA,EAAA,QAAA,EAAA,GAAA,EAAA,CAAA,EQvFe,ORuFf,CAAA,IAAA,CAAA;EAAI,QAAA,CAAA,CAAA,EQlFnB,ORkFmB,CAAA,MAAA,CAAA;EAAqB,MAAA,CAAA,CAAA,EQxE1C,ORwE0C,CAAA,IAAA,CAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/File.ts","../src/Dir.ts","../src/Cache.ts","../src/Fetcher.ts","../src/Format.ts","../src/Log.ts","../src/snapshot.ts","../src/timeout.ts","../src/TypeWriter.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/index.mjs

@@ -5,13 +5,75 @@ import { Readable } from "node:stream";
 import { finished } from "node:stream/promises";
 import mime from "mime-types";
 import { parseStream, writeToStream } from "fast-csv";
+import probeImageSize from "probe-image-size";
+import { spawn } from "child_process";
+import { parseArgsStringToArgv } from "string-argv";
+import { flattenDeep, isObjectLike, merge } from "lodash-es";
 import { add, format, formatISO, isAfter } from "date-fns";
 import formatDuration from "format-duration";
-import { isObjectLike, merge } from "lodash-es";
 import extractDomain from "extract-domain";
 import pino from "pino";
 import * as qt from "quicktype-core";
 
+//#region src/Cmd.ts
+/**
+* Spawn a child process for shell commands with `Cmd.run('command arg1=something arg2=2...")`
+* @param args can be provided as a string or array of strings
+* @returns Promise that resolves with content of STDOUT. Rejects with output of STDERR
+*/
+var Cmd = class {
+	static bin = "/usr/local/bin";
+	/**
+	* configure global location of bin files
+	*/
+	static configure({ bin }) {
+		this.bin = bin;
+	}
+	static args(args) {
+		return typeof args === "string" ? parseArgsStringToArgv(args) : parseArgsStringToArgv(flattenDeep(args).filter((a) => a !== void 0).join(" "));
+	}
+	static async run(cmd, args, opts) {
+		const options = merge({ timeout: 300 * 1e3 }, opts);
+		return new Promise((resolve, reject) => {
+			let stdout = "";
+			let stderr = "";
+			const child = spawn(`${this.bin}/${cmd}`, this.args(args), options);
+			child.stdout.on("data", (chunk) => {
+				stdout += chunk.toString();
+			});
+			child.stderr.on("data", (chunk) => {
+				stderr += chunk.toString();
+			});
+			child.on("close", () => {
+				if (stderr.trim().length) return reject(new Error(stderr));
+				resolve(stdout.trim());
+			});
+		});
+	}
+	/**
+	* Run ffmpeg for video processing (ffmpeg needs to be installed separately)
+	*/
+	static async ffmpeg(args) {
+		return this.run("ffmpeg", [
+			"-y",
+			"-loglevel",
+			"error",
+			args
+		], { timeout: 600 * 1e3 });
+	}
+	/**
+	* Use ffprobe to get video stream dimensions (ffprobe needs to be installed separately)
+	*/
+	static async ffprobe(args) {
+		return this.run("ffprobe", [
+			"-v",
+			"error",
+			args
+		], { timeout: 600 * 1e3 });
+	}
+};
+
+//#endregion
 //#region src/File.ts
 /**
 * Represents a file on the file system. If the file doesn't exist, it is created the first time it is written to.
@@ -136,6 +198,22 @@ var File = class {
 	static get csv() {
 		return FileTypeCsv;
 	}
+	async image(content) {
+		const imageFile = new FileTypeImage(this.path);
+		if (content) await imageFile.file.write(content);
+		return imageFile;
+	}
+	static get image() {
+		return FileTypeImage;
+	}
+	async video(content) {
+		const videoFile = new FileTypeVideo(this.path);
+		if (content) await videoFile.file.write(content);
+		return videoFile;
+	}
+	static get video() {
+		return FileTypeVideo;
+	}
 };
 /**
 * A generic file adaptor, extended by specific file type implementations
@@ -266,6 +344,23 @@ var FileTypeCsv = class extends FileType {
 		});
 	}
 };
+var FileTypeImage = class extends FileType {
+	async dimensions() {
+		return probeImageSize(this.file.readStream);
+	}
+};
+var FileTypeVideo = class extends FileType {
+	async dimensions() {
+		return Cmd.ffprobe(`-select_streams v:0 -show_entries stream -of json "${this.file.path}"`).then((out) => {
+			const { streams } = JSON.parse(out);
+			if (!streams[0]) throw new Error("Could not parse video stream");
+			return {
+				...streams[0],
+				duration: Number(streams[0].duration)
+			};
+		});
+	}
+};
 
 //#endregion
 //#region src/Format.ts

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":["#resolve","parsed: Row[]","#parseVal","#inputPath","#resolved","params: [string, string][]","timeout","#logger","#options","#getLogger","#write","output: Record<string, any>","obj: Record<string, any>"],"sources":["../src/File.ts","../src/Format.ts","../src/Dir.ts","../src/Cache.ts","../src/Fetcher.ts","../src/Log.ts","../src/snapshot.ts","../src/timeout.ts","../src/TypeWriter.ts"],"sourcesContent":["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: string;\n  root: string;\n  dir: string;\n  base: string;\n  name: string;\n  ext: string;\n  type?: string;\n\n  constructor(filepath: string) {\n    this.path = this.#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  #resolve(filepath: string): string {\n    if (filepath[0] === '~') {\n      if (process.env.HOME) {\n        return path.join(process.env.HOME, filepath.slice(1));\n      } else {\n        console.warn('process.env.HOME does not exist! \"~\" will not resolve to home directory');\n      }\n    }\n    return path.resolve(filepath);\n  }\n\n  get exists(): boolean {\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(): void {\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(): string | undefined {\n    return this.exists ? fs.readFileSync(this.path, 'utf8') : undefined;\n  }\n\n  /**\n   * @returns lines as strings, removes trailing '\\n'\n   */\n  lines(): string[] {\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(): fs.ReadStream | Readable {\n    return this.exists ? fs.createReadStream(this.path) : Readable.from([]);\n  }\n\n  get writeStream(): fs.WriteStream {\n    fs.mkdirSync(this.dir, { recursive: true });\n    return fs.createWriteStream(this.path);\n  }\n\n  write(contents: string | ReadableStream): void | Promise<void> {\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[]): void {\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): FileTypeJson<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(): typeof FileTypeJson {\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[]): FileTypeNdjson<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(): typeof FileTypeNdjson {\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[], options?: FileTypeCsvOptions<T>): Promise<FileTypeCsv<T>> {\n    const csvFile = new FileTypeCsv<T>(this.path, options);\n    if (rows) await csvFile.write(rows);\n    return csvFile;\n  }\n\n  static get csv(): typeof FileTypeCsv {\n    return FileTypeCsv;\n  }\n}\n\n/**\n * A generic file adaptor, extended by specific file type implementations\n */\nexport class FileType {\n  file: 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(): string {\n    return this.file.path;\n  }\n\n  get root(): string {\n    return this.file.root;\n  }\n\n  get dir(): string {\n    return this.file.dir;\n  }\n\n  get base(): string {\n    return this.file.base;\n  }\n\n  get name(): string {\n    return this.file.name;\n  }\n\n  get ext(): string {\n    return this.file.ext;\n  }\n\n  get type(): string | undefined {\n    return this.file.type;\n  }\n\n  get exists(): boolean {\n    return this.file.exists;\n  }\n\n  get stats(): Partial<fs.Stats> {\n    return this.file.stats;\n  }\n\n  delete(): void {\n    this.file.delete();\n  }\n\n  get readStream(): fs.ReadStream | Readable {\n    return this.file.readStream;\n  }\n\n  get writeStream(): fs.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, 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(): T | undefined {\n    const contents = this.file.read();\n    return contents ? (JSON.parse(contents) as T) : undefined;\n  }\n\n  write(contents: T): void {\n    this.file.write(JSON.stringify(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[]): void {\n    this.file.append(Array.isArray(lines) ? lines.map(l => JSON.stringify(l)) : JSON.stringify(lines));\n  }\n\n  lines(): T[] {\n    return this.file.lines().map(l => JSON.parse(l) as T);\n  }\n}\n\ntype Key<T extends object> = keyof T;\n\ntype FileTypeCsvOptions<Row extends object> = {\n  parseNumbers?: boolean;\n  parseBooleans?: boolean;\n  parseNulls?: boolean;\n  keys?: Key<Row>[];\n};\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  options: FileTypeCsvOptions<Row>;\n\n  constructor(filepath: string, options: FileTypeCsvOptions<Row> = {}) {\n    super(filepath.endsWith('.csv') ? filepath : filepath + '.csv');\n    this.options = {\n      parseNumbers: true,\n      parseBooleans: true,\n      parseNulls: true,\n      ...options,\n    };\n  }\n\n  async write(rows: Row[]): Promise<void> {\n    const headerSet = new Set<Key<Row>>();\n    if (this.options.keys) {\n      for (const key of this.options.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): string | number | boolean | null {\n    const { parseNumbers, parseBooleans, parseNulls } = this.options;\n    if (parseBooleans && val.toLowerCase() === 'false') return false;\n    if (parseBooleans && val.toLowerCase() === 'true') return true;\n    if (parseNulls && (val.length === 0 || val.toLowerCase() === 'null')) return null;\n    if (parseNumbers && /^[\\.0-9]+$/.test(val)) return Number(val);\n    return val;\n  }\n\n  async read(): Promise<Row[]> {\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 { 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  ): string {\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): string {\n    return new Intl.NumberFormat('en-US', { maximumFractionDigits: places }).format(n);\n  }\n\n  static plural(amount: number, singular: string, multiple?: string): 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'): string {\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): string {\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 * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport sanitizeFilename from 'sanitize-filename';\nimport { File } from './File.ts';\nimport { Format } from './Format.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. Default: `./YYYYMMDD`\n * @param options\n * include `{ temp: true }` to enable the `.clear()` method\n */\nexport class Dir {\n  #inputPath: string;\n  #resolved?: string;\n  isTemp: boolean;\n\n  /**\n   * @param path can be relative to workspace or absolute\n   */\n  constructor(inputPath = Format.date('ymd'), options: DirOptions = {}) {\n    this.#inputPath = inputPath;\n    this.isTemp = Boolean(options.temp);\n  }\n\n  /**\n   * The path of the directory, which might not exist yet.\n   */\n  get pathUnsafe(): string {\n    if (this.#resolved) return this.#resolved;\n    if (this.#inputPath[0] === '~') {\n      if (process.env.HOME) {\n        return path.join(process.env.HOME, this.#inputPath.slice(1));\n      } else {\n        console.warn('process.env.HOME does not exist! \"~\" will not resolve to home directory');\n      }\n    }\n    return path.resolve(this.#inputPath);\n  }\n\n  /**\n   * The path of this Dir instance. Created on file system the first time this property is read/used.\n   * Safe to use the directory immediately, without calling mkdir separately.\n   */\n  get path(): string {\n    // avoids calling mkdir every time path is read\n    if (!this.#resolved) {\n      this.#resolved = this.pathUnsafe;\n      fs.mkdirSync(this.#resolved, { recursive: true });\n    }\n    return this.#resolved;\n  }\n\n  /**\n   * The last segment in the path. Doesn't read this.path, to avoid creating directory on file system before it's needed.\n   * @example\n   * const example = new Dir('/path/to/folder');\n   * console.log(example.name); // \"folder\"\n   */\n  get name(): string {\n    return this.pathUnsafe.split(path.sep).at(-1)!;\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 = Format.date('ymd'), options: DirOptions = { temp: this.isTemp }): Dir {\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): Dir {\n    return this.dir(subPath, { temp: true });\n  }\n\n  sanitize(filename: string): 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   * // '/path/to/example/file.json'\n   */\n  filepath(base: string): string {\n    return path.resolve(this.path, this.sanitize(base));\n  }\n\n  /**\n   * Create a new file in this directory. Filename defaults to `YYYYMMDD-HHMMSS` if not provided\n   */\n  file(base = Format.date('ymd-hms')): File {\n    return new File(this.filepath(base));\n  }\n\n  /**\n   * All files and subdirectories in in this directory, returned as Dir and File instances\n   */\n  get contents(): (Dir | File)[] {\n    return fs\n      .readdirSync(this.path)\n      .map(name => (fs.statSync(path.join(this.path, name)).isDirectory() ? this.dir(name) : this.file(name)));\n  }\n\n  /**\n   * All subdirectories in this directory\n   */\n  get dirs(): Dir[] {\n    return this.contents.filter(f => f instanceof Dir);\n  }\n\n  /**\n   * All files in this directory\n   */\n  get files(): File[] {\n    return this.contents.filter(f => f instanceof File);\n  }\n\n  /**\n   * All files with MIME type that includes \"video\"\n   */\n  get videos(): File[] {\n    return this.files.filter(f => f.type?.includes('video'));\n  }\n\n  /**\n   * All files with MIME type that includes \"image\"\n   */\n  get images(): File[] {\n    return this.files.filter(f => f.type?.includes('image'));\n  }\n\n  /**\n   * All files with ext \".json\"\n   * @example\n   * // Directory of json files with the same shape\n   * const dataFiles = dataDir.jsonFiles.map(f => f.json<ExampleType>());\n   * // dataFiles: FileTypeJson<ExampleType>[]\n   */\n  get jsonFiles(): File[] {\n    return this.files.filter(f => f.ext === '.json');\n  }\n\n  /**\n   * All files with ext \".ndjson\"\n   * @example\n   * // Directory of ndjson files with the same shape\n   * const dataFiles = dataDir.ndjsonFiles.map(f => f.ndjson<ExampleType>());\n   * // dataFiles: FileTypeNdjson<ExampleType>[]\n   */\n  get ndjsonFiles(): File[] {\n    return this.files.filter(f => f.ext === '.ndjson');\n  }\n\n  /**\n   * All files with ext \".csv\"\n   * @example\n   * // Directory of csv files with the same shape\n   * const dataFiles = dataDir.csvFile.map(f => f.csv<ExampleType>());\n   * // dataFiles: FileTypeCsv<ExampleType>[]\n   */\n  get csvFiles(): File[] {\n    return this.files.filter(f => f.ext === '.csv');\n  }\n\n  /**\n   * All files with ext \".txt\"\n   */\n  get txtFiles(): File[] {\n    return this.files.filter(f => f.ext === '.txt');\n  }\n\n  /**\n   * Deletes the contents of the directory. Only allowed if created with `temp` option set to `true` (or created with `dir.tempDir` method).\n   */\n  clear(): void {\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 { type FileTypeJson } from './File.ts';\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: FileTypeJson<{ savedAt: string; data: T }>;\n  ttl: Duration;\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();\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: FetchOptions;\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   * Query params are merged in this order, last instance of key wins:\n   * 1. defaultOptions.query\n   * 2. route URLSearchParams\n   * 3. options.query\n   */\n  buildUrl(route: Route, opts: FetchOptions = {}): [URL, string] {\n    const routeUrl = route instanceof URL ? route : new URL(route, opts.base || this.defaultOptions.base);\n    const routeQuery = Object.fromEntries(routeUrl.searchParams);\n    const mergedOptions = merge({}, this.defaultOptions, { query: routeQuery }, 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, mergedOptions.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 = {}): HeadersInit & Record<string, string> {\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 { merge } from 'lodash-es';\nimport { default as pino, type Logger } from 'pino';\n\nexport type LogDetails = Record<string, unknown>;\n\nexport type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';\n\nexport type LogOptions = pino.LoggerOptions & {\n  environment?: string;\n};\n\n/**\n * Wrapper for [pino](https://github.com/pinojs/pino)\n * Levels: fatal, error, warn, info, debug, trace\n * Use `LOG_LEVL=info` to limit what's printed to console\n * Use `Log.configure` to customize the pino instance\n */\nexport class Log {\n  static #logger?: Logger;\n  static #options: LogOptions;\n\n  static createLogger(): Logger {\n    const isProduction = this.#options?.environment === 'production' || process.env.NODE_ENV === 'production';\n    const defaultOptions: LogOptions = {\n      level: process.env.LOG_LEVEL ?? (isProduction ? 'info' : 'debug'),\n      timestamp: pino.stdTimeFunctions.isoTime,\n      formatters: {\n        level(label: string) {\n          return { level: label };\n        },\n      },\n      transport: isProduction\n        ? undefined\n        : {\n            target: 'pino-pretty',\n            options: {\n              colorize: true,\n              singleLine: true,\n              ignore: 'pid,hostname',\n            },\n          },\n    };\n    return pino(merge(defaultOptions, this.#options));\n  }\n\n  static configure(options: LogOptions = {}): void {\n    this.#options = options;\n    this.#logger = this.createLogger();\n  }\n\n  static #getLogger(): Logger {\n    return (this.#logger ??= this.createLogger());\n  }\n\n  static #write(level: LogLevel, message: string, details?: LogDetails): void {\n    if (details === undefined) {\n      Log.#getLogger()[level](message);\n    } else {\n      Log.#getLogger()[level](details, message);\n    }\n  }\n\n  static trace(message: string, details?: LogDetails): void {\n    Log.#write('trace', message, details);\n  }\n\n  static debug(message: string, details?: LogDetails): void {\n    Log.#write('debug', message, details);\n  }\n\n  static info(message: string, details?: LogDetails): void {\n    Log.#write('info', message, details);\n  }\n\n  static warn(message: string, details?: LogDetails): void {\n    Log.#write('warn', message, details);\n  }\n\n  static error(message: string, details?: LogDetails): void {\n    Log.#write('error', message, details);\n  }\n\n  static fatal(message: string, details?: LogDetails): void {\n    Log.#write('fatal', message, details);\n  }\n}\n","import { isObjectLike } from 'lodash-es';\n\n/**\n * @deprecated\n * Allows special objects (Error, Headers, Set) to be included in JSON.stringify output. Functions are removed.\n * ⚠️ This is bad! Only use it for debugging!\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","export async function timeout(ms: number): Promise<void> {\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\n/**\n * Wrapper for [quicktype-core](https://github.com/glideapps/quicktype)\n * @example\n * const group = new TypeWriter('Group');\n * await types.addMember('Thing', [{ a: 1 }, { a: 2, b: 1 }]);\n * await types.toFile();\n * // type def for `Thing` saved in `types/Group.types.ts`\n */\nexport class TypeWriter {\n  moduleName: string;\n  input = qt.jsonInputForTargetLanguage('typescript');\n  outDir: string;\n  outFile: string;\n  qtSettings: Partial<qt.Options>;\n\n  constructor(moduleName: string, settings: { outDir?: string; outFile?: string } & Partial<qt.Options> = {}) {\n    this.moduleName = moduleName;\n    const { outDir, outFile, ...qtSettings } = settings;\n    this.outDir = outDir || './types';\n    this.outFile = outFile || `${this.moduleName}.types.ts`;\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[]): Promise<void> {\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(): Promise<string> {\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(): Promise<void> {\n    const result = await this.toString();\n    fs.mkdirSync(this.outDir, { recursive: true });\n    fs.writeFileSync(`${this.outDir}/${this.outFile}`, result);\n  }\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":["parseArgs","#resolve","parsed: Row[]","#parseVal","#inputPath","#resolved","params: [string, string][]","timeout","#logger","#options","#getLogger","#write","output: Record<string, any>","obj: Record<string, any>"],"sources":["../src/Cmd.ts","../src/File.ts","../src/Format.ts","../src/Dir.ts","../src/Cache.ts","../src/Fetcher.ts","../src/Log.ts","../src/snapshot.ts","../src/timeout.ts","../src/TypeWriter.ts"],"sourcesContent":["import { spawn, type SpawnOptionsWithoutStdio } from 'child_process';\nimport { parseArgsStringToArgv as parseArgs } from 'string-argv';\nimport { merge, flattenDeep } from 'lodash-es';\n\nexport type Args = string | (string | number | null | undefined | Args)[];\n\n/**\n * Spawn a child process for shell commands with `Cmd.run('command arg1=something arg2=2...\")`\n * @param args can be provided as a string or array of strings\n * @returns Promise that resolves with content of STDOUT. Rejects with output of STDERR\n */\nexport class Cmd {\n  static bin = '/usr/local/bin';\n\n  /**\n   * configure global location of bin files\n   */\n  static configure({ bin }: { bin: string }): void {\n    this.bin = bin;\n  }\n\n  static args(args: Args): string[] {\n    return typeof args === 'string'\n      ? parseArgs(args)\n      : parseArgs(\n          flattenDeep(args)\n            .filter(a => a !== undefined)\n            .join(' '),\n        );\n  }\n\n  static async run(cmd: string, args: Args, opts?: SpawnOptionsWithoutStdio): Promise<string> {\n    const options = merge({ timeout: 5 * 60 * 1000 }, opts);\n    return new Promise((resolve, reject) => {\n      let stdout = '';\n      let stderr = '';\n      const child = spawn(`${this.bin}/${cmd}`, this.args(args), options);\n      child.stdout.on('data', chunk => {\n        stdout += chunk.toString();\n      });\n      child.stderr.on('data', chunk => {\n        stderr += chunk.toString();\n      });\n      child.on('close', () => {\n        const err = stderr.trim();\n        if (err.length) return reject(new Error(stderr));\n        resolve(stdout.trim());\n      });\n    });\n  }\n\n  /**\n   * Run ffmpeg for video processing (ffmpeg needs to be installed separately)\n   */\n  static async ffmpeg(args: Args) {\n    return this.run('ffmpeg', ['-y', '-loglevel', 'error', args], { timeout: 10 * 60 * 1000 });\n  }\n\n  /**\n   * Use ffprobe to get video stream dimensions (ffprobe needs to be installed separately)\n   */\n  static async ffprobe(args: Args) {\n    return this.run('ffprobe', ['-v', 'error', args], { timeout: 10 * 60 * 1000 });\n  }\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 { default as probeImageSize, type ProbeResult } from 'probe-image-size';\nimport { Cmd } from './Cmd.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: string;\n  root: string;\n  dir: string;\n  base: string;\n  name: string;\n  ext: string;\n  type?: string;\n\n  constructor(filepath: string) {\n    this.path = this.#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  #resolve(filepath: string): string {\n    if (filepath[0] === '~') {\n      if (process.env.HOME) {\n        return path.join(process.env.HOME, filepath.slice(1));\n      } else {\n        console.warn('process.env.HOME does not exist! \"~\" will not resolve to home directory');\n      }\n    }\n    return path.resolve(filepath);\n  }\n\n  get exists(): boolean {\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(): void {\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(): string | undefined {\n    return this.exists ? fs.readFileSync(this.path, 'utf8') : undefined;\n  }\n\n  /**\n   * @returns lines as strings, removes trailing '\\n'\n   */\n  lines(): string[] {\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(): fs.ReadStream | Readable {\n    return this.exists ? fs.createReadStream(this.path) : Readable.from([]);\n  }\n\n  get writeStream(): fs.WriteStream {\n    fs.mkdirSync(this.dir, { recursive: true });\n    return fs.createWriteStream(this.path);\n  }\n\n  write(contents: string | ReadableStream): void | Promise<void> {\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[]): void {\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): FileTypeJson<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(): typeof FileTypeJson {\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[]): FileTypeNdjson<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(): typeof FileTypeNdjson {\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[], options?: FileTypeCsvOptions<T>): Promise<FileTypeCsv<T>> {\n    const csvFile = new FileTypeCsv<T>(this.path, options);\n    if (rows) await csvFile.write(rows);\n    return csvFile;\n  }\n\n  static get csv(): typeof FileTypeCsv {\n    return FileTypeCsv;\n  }\n\n  async image(content?: ReadableStream) {\n    const imageFile = new FileTypeImage(this.path);\n    if (content) await imageFile.file.write(content);\n    return imageFile;\n  }\n\n  static get image(): typeof FileTypeImage {\n    return FileTypeImage;\n  }\n\n  async video(content?: ReadableStream) {\n    const videoFile = new FileTypeVideo(this.path);\n    if (content) await videoFile.file.write(content);\n    return videoFile;\n  }\n\n  static get video(): typeof FileTypeVideo {\n    return FileTypeVideo;\n  }\n}\n\n/**\n * A generic file adaptor, extended by specific file type implementations\n */\nexport class FileType {\n  file: 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(): string {\n    return this.file.path;\n  }\n\n  get root(): string {\n    return this.file.root;\n  }\n\n  get dir(): string {\n    return this.file.dir;\n  }\n\n  get base(): string {\n    return this.file.base;\n  }\n\n  get name(): string {\n    return this.file.name;\n  }\n\n  get ext(): string {\n    return this.file.ext;\n  }\n\n  get type(): string | undefined {\n    return this.file.type;\n  }\n\n  get exists(): boolean {\n    return this.file.exists;\n  }\n\n  get stats(): Partial<fs.Stats> {\n    return this.file.stats;\n  }\n\n  delete(): void {\n    this.file.delete();\n  }\n\n  get readStream(): fs.ReadStream | Readable {\n    return this.file.readStream;\n  }\n\n  get writeStream(): fs.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, 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(): T | undefined {\n    const contents = this.file.read();\n    return contents ? (JSON.parse(contents) as T) : undefined;\n  }\n\n  write(contents: T): void {\n    this.file.write(JSON.stringify(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[]): void {\n    this.file.append(Array.isArray(lines) ? lines.map(l => JSON.stringify(l)) : JSON.stringify(lines));\n  }\n\n  lines(): T[] {\n    return this.file.lines().map(l => JSON.parse(l) as T);\n  }\n}\n\ntype Key<T extends object> = keyof T;\n\ntype FileTypeCsvOptions<Row extends object> = {\n  parseNumbers?: boolean;\n  parseBooleans?: boolean;\n  parseNulls?: boolean;\n  keys?: Key<Row>[];\n};\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  options: FileTypeCsvOptions<Row>;\n\n  constructor(filepath: string, options: FileTypeCsvOptions<Row> = {}) {\n    super(filepath.endsWith('.csv') ? filepath : filepath + '.csv');\n    this.options = {\n      parseNumbers: true,\n      parseBooleans: true,\n      parseNulls: true,\n      ...options,\n    };\n  }\n\n  async write(rows: Row[]): Promise<void> {\n    const headerSet = new Set<Key<Row>>();\n    if (this.options.keys) {\n      for (const key of this.options.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): string | number | boolean | null {\n    const { parseNumbers, parseBooleans, parseNulls } = this.options;\n    if (parseBooleans && val.toLowerCase() === 'false') return false;\n    if (parseBooleans && val.toLowerCase() === 'true') return true;\n    if (parseNulls && (val.length === 0 || val.toLowerCase() === 'null')) return null;\n    if (parseNumbers && /^[\\.0-9]+$/.test(val)) return Number(val);\n    return val;\n  }\n\n  async read(): Promise<Row[]> {\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\nexport class FileTypeImage extends FileType {\n  async dimensions(): Promise<{\n    width: number;\n    height: number;\n  }> {\n    return probeImageSize(this.file.readStream);\n  }\n}\n\nexport class FileTypeVideo extends FileType {\n  async dimensions(): Promise<{\n    width: number;\n    height: number;\n    duration: number;\n  }> {\n    return Cmd.ffprobe(`-select_streams v:0 -show_entries stream -of json \"${this.file.path}\"`).then(out => {\n      const { streams } = JSON.parse(out) as {\n        streams: { width: number; height: number; duration: string }[];\n      };\n      if (!streams[0]) throw new Error('Could not parse video stream');\n      return { ...streams[0], duration: Number(streams[0].duration) };\n    });\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  ): string {\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): string {\n    return new Intl.NumberFormat('en-US', { maximumFractionDigits: places }).format(n);\n  }\n\n  static plural(amount: number, singular: string, multiple?: string): 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'): string {\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): string {\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 * as fs from 'node:fs';\nimport * as path from 'node:path';\nimport sanitizeFilename from 'sanitize-filename';\nimport { File } from './File.ts';\nimport { Format } from './Format.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. Default: `./YYYYMMDD`\n * @param options\n * include `{ temp: true }` to enable the `.clear()` method\n */\nexport class Dir {\n  #inputPath: string;\n  #resolved?: string;\n  isTemp: boolean;\n\n  /**\n   * @param path can be relative to workspace or absolute\n   */\n  constructor(inputPath = Format.date('ymd'), options: DirOptions = {}) {\n    this.#inputPath = inputPath;\n    this.isTemp = Boolean(options.temp);\n  }\n\n  /**\n   * The path of the directory, which might not exist yet.\n   */\n  get pathUnsafe(): string {\n    if (this.#resolved) return this.#resolved;\n    if (this.#inputPath[0] === '~') {\n      if (process.env.HOME) {\n        return path.join(process.env.HOME, this.#inputPath.slice(1));\n      } else {\n        console.warn('process.env.HOME does not exist! \"~\" will not resolve to home directory');\n      }\n    }\n    return path.resolve(this.#inputPath);\n  }\n\n  /**\n   * The path of this Dir instance. Created on file system the first time this property is read/used.\n   * Safe to use the directory immediately, without calling mkdir separately.\n   */\n  get path(): string {\n    // avoids calling mkdir every time path is read\n    if (!this.#resolved) {\n      this.#resolved = this.pathUnsafe;\n      fs.mkdirSync(this.#resolved, { recursive: true });\n    }\n    return this.#resolved;\n  }\n\n  /**\n   * The last segment in the path. Doesn't read this.path, to avoid creating directory on file system before it's needed.\n   * @example\n   * const example = new Dir('/path/to/folder');\n   * console.log(example.name); // \"folder\"\n   */\n  get name(): string {\n    return this.pathUnsafe.split(path.sep).at(-1)!;\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 = Format.date('ymd'), options: DirOptions = { temp: this.isTemp }): Dir {\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): Dir {\n    return this.dir(subPath, { temp: true });\n  }\n\n  sanitize(filename: string): 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   * // '/path/to/example/file.json'\n   */\n  filepath(base: string): string {\n    return path.resolve(this.path, this.sanitize(base));\n  }\n\n  /**\n   * Create a new file in this directory. Filename defaults to `YYYYMMDD-HHMMSS` if not provided\n   */\n  file(base = Format.date('ymd-hms')): File {\n    return new File(this.filepath(base));\n  }\n\n  /**\n   * All files and subdirectories in in this directory, returned as Dir and File instances\n   */\n  get contents(): (Dir | File)[] {\n    return fs\n      .readdirSync(this.path)\n      .map(name => (fs.statSync(path.join(this.path, name)).isDirectory() ? this.dir(name) : this.file(name)));\n  }\n\n  /**\n   * All subdirectories in this directory\n   */\n  get dirs(): Dir[] {\n    return this.contents.filter(f => f instanceof Dir);\n  }\n\n  /**\n   * All files in this directory\n   */\n  get files(): File[] {\n    return this.contents.filter(f => f instanceof File);\n  }\n\n  /**\n   * All files with MIME type that includes \"video\"\n   */\n  get videos(): File[] {\n    return this.files.filter(f => f.type?.includes('video'));\n  }\n\n  /**\n   * All files with MIME type that includes \"image\"\n   */\n  get images(): File[] {\n    return this.files.filter(f => f.type?.includes('image'));\n  }\n\n  /**\n   * All files with ext \".json\"\n   * @example\n   * // Directory of json files with the same shape\n   * const dataFiles = dataDir.jsonFiles.map(f => f.json<ExampleType>());\n   * // dataFiles: FileTypeJson<ExampleType>[]\n   */\n  get jsonFiles(): File[] {\n    return this.files.filter(f => f.ext === '.json');\n  }\n\n  /**\n   * All files with ext \".ndjson\"\n   * @example\n   * // Directory of ndjson files with the same shape\n   * const dataFiles = dataDir.ndjsonFiles.map(f => f.ndjson<ExampleType>());\n   * // dataFiles: FileTypeNdjson<ExampleType>[]\n   */\n  get ndjsonFiles(): File[] {\n    return this.files.filter(f => f.ext === '.ndjson');\n  }\n\n  /**\n   * All files with ext \".csv\"\n   * @example\n   * // Directory of csv files with the same shape\n   * const dataFiles = dataDir.csvFile.map(f => f.csv<ExampleType>());\n   * // dataFiles: FileTypeCsv<ExampleType>[]\n   */\n  get csvFiles(): File[] {\n    return this.files.filter(f => f.ext === '.csv');\n  }\n\n  /**\n   * All files with ext \".txt\"\n   */\n  get txtFiles(): File[] {\n    return this.files.filter(f => f.ext === '.txt');\n  }\n\n  /**\n   * Deletes the contents of the directory. Only allowed if created with `temp` option set to `true` (or created with `dir.tempDir` method).\n   */\n  clear(): void {\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 { type FileTypeJson } from './File.ts';\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: FileTypeJson<{ savedAt: string; data: T }>;\n  ttl: Duration;\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();\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: FetchOptions;\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   * Query params are merged in this order, last instance of key wins:\n   * 1. defaultOptions.query\n   * 2. route URLSearchParams\n   * 3. options.query\n   */\n  buildUrl(route: Route, opts: FetchOptions = {}): [URL, string] {\n    const routeUrl = route instanceof URL ? route : new URL(route, opts.base || this.defaultOptions.base);\n    const routeQuery = Object.fromEntries(routeUrl.searchParams);\n    const mergedOptions = merge({}, this.defaultOptions, { query: routeQuery }, 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, mergedOptions.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 = {}): HeadersInit & Record<string, string> {\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 { merge } from 'lodash-es';\nimport { default as pino, type Logger } from 'pino';\n\nexport type LogDetails = Record<string, unknown>;\n\nexport type LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal';\n\nexport type LogOptions = pino.LoggerOptions & {\n  environment?: string;\n};\n\n/**\n * Wrapper for [pino](https://github.com/pinojs/pino)\n * Levels: fatal, error, warn, info, debug, trace\n * Use `LOG_LEVL=info` to limit what's printed to console\n * Use `Log.configure` to customize the pino instance\n */\nexport class Log {\n  static #logger?: Logger;\n  static #options: LogOptions;\n\n  static createLogger(): Logger {\n    const isProduction = this.#options?.environment === 'production' || process.env.NODE_ENV === 'production';\n    const defaultOptions: LogOptions = {\n      level: process.env.LOG_LEVEL ?? (isProduction ? 'info' : 'debug'),\n      timestamp: pino.stdTimeFunctions.isoTime,\n      formatters: {\n        level(label: string) {\n          return { level: label };\n        },\n      },\n      transport: isProduction\n        ? undefined\n        : {\n            target: 'pino-pretty',\n            options: {\n              colorize: true,\n              singleLine: true,\n              ignore: 'pid,hostname',\n            },\n          },\n    };\n    return pino(merge(defaultOptions, this.#options));\n  }\n\n  static configure(options: LogOptions = {}): void {\n    this.#options = options;\n    this.#logger = this.createLogger();\n  }\n\n  static #getLogger(): Logger {\n    return (this.#logger ??= this.createLogger());\n  }\n\n  static #write(level: LogLevel, message: string, details?: LogDetails): void {\n    if (details === undefined) {\n      Log.#getLogger()[level](message);\n    } else {\n      Log.#getLogger()[level](details, message);\n    }\n  }\n\n  static trace(message: string, details?: LogDetails): void {\n    Log.#write('trace', message, details);\n  }\n\n  static debug(message: string, details?: LogDetails): void {\n    Log.#write('debug', message, details);\n  }\n\n  static info(message: string, details?: LogDetails): void {\n    Log.#write('info', message, details);\n  }\n\n  static warn(message: string, details?: LogDetails): void {\n    Log.#write('warn', message, details);\n  }\n\n  static error(message: string, details?: LogDetails): void {\n    Log.#write('error', message, details);\n  }\n\n  static fatal(message: string, details?: LogDetails): void {\n    Log.#write('fatal', message, details);\n  }\n}\n","import { isObjectLike } from 'lodash-es';\n\n/**\n * @deprecated\n * Allows special objects (Error, Headers, Set) to be included in JSON.stringify output. Functions are removed.\n * ⚠️ This is bad! Only use it for debugging!\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","export async function timeout(ms: number): Promise<void> {\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\n/**\n * Wrapper for [quicktype-core](https://github.com/glideapps/quicktype)\n * @example\n * const group = new TypeWriter('Group');\n * await types.addMember('Thing', [{ a: 1 }, { a: 2, b: 1 }]);\n * await types.toFile();\n * // type def for `Thing` saved in `types/Group.types.ts`\n */\nexport class TypeWriter {\n  moduleName: string;\n  input = qt.jsonInputForTargetLanguage('typescript');\n  outDir: string;\n  outFile: string;\n  qtSettings: Partial<qt.Options>;\n\n  constructor(moduleName: string, settings: { outDir?: string; outFile?: string } & Partial<qt.Options> = {}) {\n    this.moduleName = moduleName;\n    const { outDir, outFile, ...qtSettings } = settings;\n    this.outDir = outDir || './types';\n    this.outFile = outFile || `${this.moduleName}.types.ts`;\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[]): Promise<void> {\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(): Promise<string> {\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(): Promise<void> {\n    const result = await this.toString();\n    fs.mkdirSync(this.outDir, { recursive: true });\n    fs.writeFileSync(`${this.outDir}/${this.outFile}`, result);\n  }\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@brianbuie/node-kit",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "license": "Unlicense",
   "description": "Basic tools for quick node.js projects",
   "author": "Brian Buie <brian@buie.dev>",
@@ -34,6 +34,7 @@
     "@types/lodash-es": "^4.17.12",
     "@types/mime-types": "^3.0.1",
     "@types/node": "^24.9.1",
+    "@types/probe-image-size": "^7.2.5",
     "date-fns": "^4.1.0",
     "extract-domain": "^5.0.2",
     "fast-csv": "^5.0.5",
@@ -42,8 +43,10 @@
     "mime-types": "^3.0.2",
     "pino": "^10.3.1",
     "pino-pretty": "^13.1.3",
+    "probe-image-size": "^7.3.0",
     "quicktype-core": "^23.2.6",
-    "sanitize-filename": "^1.6.3"
+    "sanitize-filename": "^1.6.3",
+    "string-argv": "^0.3.2"
   },
   "devDependencies": {
     "prettier": "^3.7.4",

package/src/Cmd.ts

@@ -0,0 +1,65 @@
+import { spawn, type SpawnOptionsWithoutStdio } from 'child_process';
+import { parseArgsStringToArgv as parseArgs } from 'string-argv';
+import { merge, flattenDeep } from 'lodash-es';
+
+export type Args = string | (string | number | null | undefined | Args)[];
+
+/**
+ * Spawn a child process for shell commands with `Cmd.run('command arg1=something arg2=2...")`
+ * @param args can be provided as a string or array of strings
+ * @returns Promise that resolves with content of STDOUT. Rejects with output of STDERR
+ */
+export class Cmd {
+  static bin = '/usr/local/bin';
+
+  /**
+   * configure global location of bin files
+   */
+  static configure({ bin }: { bin: string }): void {
+    this.bin = bin;
+  }
+
+  static args(args: Args): string[] {
+    return typeof args === 'string'
+      ? parseArgs(args)
+      : parseArgs(
+          flattenDeep(args)
+            .filter(a => a !== undefined)
+            .join(' '),
+        );
+  }
+
+  static async run(cmd: string, args: Args, opts?: SpawnOptionsWithoutStdio): Promise<string> {
+    const options = merge({ timeout: 5 * 60 * 1000 }, opts);
+    return new Promise((resolve, reject) => {
+      let stdout = '';
+      let stderr = '';
+      const child = spawn(`${this.bin}/${cmd}`, this.args(args), options);
+      child.stdout.on('data', chunk => {
+        stdout += chunk.toString();
+      });
+      child.stderr.on('data', chunk => {
+        stderr += chunk.toString();
+      });
+      child.on('close', () => {
+        const err = stderr.trim();
+        if (err.length) return reject(new Error(stderr));
+        resolve(stdout.trim());
+      });
+    });
+  }
+
+  /**
+   * Run ffmpeg for video processing (ffmpeg needs to be installed separately)
+   */
+  static async ffmpeg(args: Args) {
+    return this.run('ffmpeg', ['-y', '-loglevel', 'error', args], { timeout: 10 * 60 * 1000 });
+  }
+
+  /**
+   * Use ffprobe to get video stream dimensions (ffprobe needs to be installed separately)
+   */
+  static async ffprobe(args: Args) {
+    return this.run('ffprobe', ['-v', 'error', args], { timeout: 10 * 60 * 1000 });
+  }
+}

package/src/File.ts

@@ -4,7 +4,8 @@ import { Readable } from 'node:stream';
 import { finished } from 'node:stream/promises';
 import mime from 'mime-types';
 import { writeToStream, parseStream } from 'fast-csv';
-import { snapshot } from './snapshot.ts';
+import { default as probeImageSize, type ProbeResult } from 'probe-image-size';
+import { Cmd } from './Cmd.ts';
 
 /**
  * Represents a file on the file system. If the file doesn't exist, it is created the first time it is written to.
@@ -150,6 +151,26 @@ export class File {
   static get csv(): typeof FileTypeCsv {
     return FileTypeCsv;
   }
+
+  async image(content?: ReadableStream) {
+    const imageFile = new FileTypeImage(this.path);
+    if (content) await imageFile.file.write(content);
+    return imageFile;
+  }
+
+  static get image(): typeof FileTypeImage {
+    return FileTypeImage;
+  }
+
+  async video(content?: ReadableStream) {
+    const videoFile = new FileTypeVideo(this.path);
+    if (content) await videoFile.file.write(content);
+    return videoFile;
+  }
+
+  static get video(): typeof FileTypeVideo {
+    return FileTypeVideo;
+  }
 }
 
 /**
@@ -327,3 +348,28 @@ export class FileTypeCsv<Row extends object> extends FileType {
     });
   }
 }
+
+export class FileTypeImage extends FileType {
+  async dimensions(): Promise<{
+    width: number;
+    height: number;
+  }> {
+    return probeImageSize(this.file.readStream);
+  }
+}
+
+export class FileTypeVideo extends FileType {
+  async dimensions(): Promise<{
+    width: number;
+    height: number;
+    duration: number;
+  }> {
+    return Cmd.ffprobe(`-select_streams v:0 -show_entries stream -of json "${this.file.path}"`).then(out => {
+      const { streams } = JSON.parse(out) as {
+        streams: { width: number; height: number; duration: string }[];
+      };
+      if (!streams[0]) throw new Error('Could not parse video stream');
+      return { ...streams[0], duration: Number(streams[0].duration) };
+    });
+  }
+}