@helloao/tools 0.1.0 → 0.3.0

package/dist/types/utils.d.ts

@@ -1,3 +1,4 @@
+import z from "zod";
 /**
  * Normalizes the given language code into a ISO 639 code.
  * @param language The language code to normalize.
@@ -10,23 +11,227 @@ export declare function normalizeLanguage(language: string): string;
 export declare function getTranslationId(translationId: string): string;
 export declare function isEmptyOrWhitespace(str: string | null | undefined): boolean;
 export declare function getFirstNonEmpty<T extends string>(...values: T[]): T;
-export interface VerseRef {
-    book: string;
-    chapter: number;
-    verse: number;
-    /**
-     * The rest of the content of the verse.
-     */
-    content?: string;
-    /**
-     * The chapter that the verse reference ends at.
-     */
-    endChapter?: number;
-    /**
-     * The verse that the verse reference ends at.
-     */
-    endVerse?: number;
-}
+/**
+ * Defines a Zod schema for all USFM book IDs.
+ */
+export declare const BookIdSchema: z.ZodEnum<{
+    GEN: "GEN";
+    EXO: "EXO";
+    LEV: "LEV";
+    NUM: "NUM";
+    DEU: "DEU";
+    JOS: "JOS";
+    JDG: "JDG";
+    RUT: "RUT";
+    "1SA": "1SA";
+    "2SA": "2SA";
+    "1KI": "1KI";
+    "2KI": "2KI";
+    "1CH": "1CH";
+    "2CH": "2CH";
+    EZR: "EZR";
+    NEH: "NEH";
+    EST: "EST";
+    JOB: "JOB";
+    PSA: "PSA";
+    PRO: "PRO";
+    ECC: "ECC";
+    SNG: "SNG";
+    ISA: "ISA";
+    JER: "JER";
+    LAM: "LAM";
+    EZK: "EZK";
+    DAN: "DAN";
+    HOS: "HOS";
+    JOL: "JOL";
+    AMO: "AMO";
+    OBA: "OBA";
+    JON: "JON";
+    MIC: "MIC";
+    NAM: "NAM";
+    HAB: "HAB";
+    ZEP: "ZEP";
+    HAG: "HAG";
+    ZEC: "ZEC";
+    MAL: "MAL";
+    MAT: "MAT";
+    MRK: "MRK";
+    LUK: "LUK";
+    JHN: "JHN";
+    ACT: "ACT";
+    ROM: "ROM";
+    "1CO": "1CO";
+    "2CO": "2CO";
+    GAL: "GAL";
+    EPH: "EPH";
+    PHP: "PHP";
+    COL: "COL";
+    "1TH": "1TH";
+    "2TH": "2TH";
+    "1TI": "1TI";
+    "2TI": "2TI";
+    TIT: "TIT";
+    PHM: "PHM";
+    HEB: "HEB";
+    JAS: "JAS";
+    "1PE": "1PE";
+    "2PE": "2PE";
+    "1JN": "1JN";
+    "2JN": "2JN";
+    "3JN": "3JN";
+    JUD: "JUD";
+    REV: "REV";
+    TOB: "TOB";
+    JDT: "JDT";
+    ESG: "ESG";
+    WIS: "WIS";
+    SIR: "SIR";
+    BAR: "BAR";
+    LJE: "LJE";
+    S3Y: "S3Y";
+    SUS: "SUS";
+    BEL: "BEL";
+    "1MA": "1MA";
+    "2MA": "2MA";
+    "3MA": "3MA";
+    "4MA": "4MA";
+    "1ES": "1ES";
+    "2ES": "2ES";
+    MAN: "MAN";
+    PS2: "PS2";
+    ODA: "ODA";
+    PSS: "PSS";
+    EZA: "EZA";
+    "5EZ": "5EZ";
+    "6EZ": "6EZ";
+    DAG: "DAG";
+    PS3: "PS3";
+    "2BA": "2BA";
+    LBA: "LBA";
+    JUB: "JUB";
+    ENO: "ENO";
+    "1MQ": "1MQ";
+    "2MQ": "2MQ";
+    "3MQ": "3MQ";
+    REP: "REP";
+    "4BA": "4BA";
+    LAO: "LAO";
+}>;
+export type BookId = z.infer<typeof BookIdSchema>;
+/**
+ * Defines a schema for validating verse references.
+ */
+export declare const VerseRefSchema: z.ZodObject<{
+    book: z.ZodEnum<{
+        GEN: "GEN";
+        EXO: "EXO";
+        LEV: "LEV";
+        NUM: "NUM";
+        DEU: "DEU";
+        JOS: "JOS";
+        JDG: "JDG";
+        RUT: "RUT";
+        "1SA": "1SA";
+        "2SA": "2SA";
+        "1KI": "1KI";
+        "2KI": "2KI";
+        "1CH": "1CH";
+        "2CH": "2CH";
+        EZR: "EZR";
+        NEH: "NEH";
+        EST: "EST";
+        JOB: "JOB";
+        PSA: "PSA";
+        PRO: "PRO";
+        ECC: "ECC";
+        SNG: "SNG";
+        ISA: "ISA";
+        JER: "JER";
+        LAM: "LAM";
+        EZK: "EZK";
+        DAN: "DAN";
+        HOS: "HOS";
+        JOL: "JOL";
+        AMO: "AMO";
+        OBA: "OBA";
+        JON: "JON";
+        MIC: "MIC";
+        NAM: "NAM";
+        HAB: "HAB";
+        ZEP: "ZEP";
+        HAG: "HAG";
+        ZEC: "ZEC";
+        MAL: "MAL";
+        MAT: "MAT";
+        MRK: "MRK";
+        LUK: "LUK";
+        JHN: "JHN";
+        ACT: "ACT";
+        ROM: "ROM";
+        "1CO": "1CO";
+        "2CO": "2CO";
+        GAL: "GAL";
+        EPH: "EPH";
+        PHP: "PHP";
+        COL: "COL";
+        "1TH": "1TH";
+        "2TH": "2TH";
+        "1TI": "1TI";
+        "2TI": "2TI";
+        TIT: "TIT";
+        PHM: "PHM";
+        HEB: "HEB";
+        JAS: "JAS";
+        "1PE": "1PE";
+        "2PE": "2PE";
+        "1JN": "1JN";
+        "2JN": "2JN";
+        "3JN": "3JN";
+        JUD: "JUD";
+        REV: "REV";
+        TOB: "TOB";
+        JDT: "JDT";
+        ESG: "ESG";
+        WIS: "WIS";
+        SIR: "SIR";
+        BAR: "BAR";
+        LJE: "LJE";
+        S3Y: "S3Y";
+        SUS: "SUS";
+        BEL: "BEL";
+        "1MA": "1MA";
+        "2MA": "2MA";
+        "3MA": "3MA";
+        "4MA": "4MA";
+        "1ES": "1ES";
+        "2ES": "2ES";
+        MAN: "MAN";
+        PS2: "PS2";
+        ODA: "ODA";
+        PSS: "PSS";
+        EZA: "EZA";
+        "5EZ": "5EZ";
+        "6EZ": "6EZ";
+        DAG: "DAG";
+        PS3: "PS3";
+        "2BA": "2BA";
+        LBA: "LBA";
+        JUB: "JUB";
+        ENO: "ENO";
+        "1MQ": "1MQ";
+        "2MQ": "2MQ";
+        "3MQ": "3MQ";
+        REP: "REP";
+        "4BA": "4BA";
+        LAO: "LAO";
+    }>;
+    chapter: z.ZodNumber;
+    verse: z.ZodNumber;
+    content: z.ZodOptional<z.ZodString>;
+    endChapter: z.ZodOptional<z.ZodNumber>;
+    endVerse: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type VerseRef = z.infer<typeof VerseRefSchema>;
 /**
  * Parses the given verse reference.
  * Formatted like "GEN 1:1".
@@ -39,7 +244,7 @@ export declare function parseVerseReference(text: string): VerseRef | null;
  * Returns null if the ID could not be found.
  * @param book The name/ID of the book.
  */
-export declare function getBookId(book: string): string | null;
+export declare function getBookId(book: string): BookId | null;
 /**
  * A brief list of verses which may appear in some older translations
  * but are not present in more modern translations.

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@helloao/tools",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "A set of tools for managing HelloAO's Free Bible API",
+  "type": "module",
   "main": "./dist/cjs/index.cjs",
   "module": "./dist/esm/index.js",
   "exports": {
@@ -49,13 +50,15 @@
   "author": "Kallyn Gowdy <kal@helloao.org>",
   "license": "MIT",
   "dependencies": {
-    "lodash": "4.17.21",
-    "zod": "^3.23.8",
+    "es-toolkit": "1.46.1",
+    "zod": "^4.4.3",
     "papaparse": "5.4.1"
   },
   "devDependencies": {
+    "@types/jest": "^29.4.0",
     "linkedom": "0.18.4",
-    "hash.js": "1.1.7"
+    "hash.js": "1.1.7",
+    "zod-openapi": "5.4.6"
   },
   "files": [
     "/README.md",