@adisuper94/nih-reporter 0.0.4 → 0.0.8

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Aditya Subramanian
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -2,3 +2,34 @@
 
 A TypeScript/JavaScript wrapper to call NIH reporter API
 
+## Installation
+
+### Deno
+
+```bash
+deno add @jsr:@adisuper94/nih-reporter
+```
+
+### Node
+
+```bash
+npm install @adisuper94/nih-reporter
+```
+
+## Basic Usage
+
+```typescript
+import { NIHProjectQuery } from "@adisuper94/nih-reporter";
+
+const nihPersonIds: number[] = [12345679, 12345678];
+let query = new NIHProjectQuery();
+query.setPIProfileIds(nihPersonIds).setLimit(100).setFiscalYears([2020, 2021, 2022, 2023, 2024, 2025]);
+const iter = query.safeIterator();
+for await (const [project, err] of iter) {
+  if (err) {
+    // Handle error
+    console.error(err);
+    continue;
+  }
+}
+```

package/esm/index.d.ts

@@ -0,0 +1,4 @@
+import { NIHProjectQuery } from "./project.js";
+import type { NIHProject } from "./types.js";
+export { type NIHProject, NIHProjectQuery };
+//# sourceMappingURL=index.d.ts.map

package/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,KAAK,UAAU,EAAE,eAAe,EAAE,CAAC"}

package/esm/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "module"
+}

package/esm/project.d.ts

@@ -0,0 +1,81 @@
+import { type NIHProject, type NIHProjectFields } from "./types.js";
+/**
+ * NIHProjectQuery class to query the NIH Reporter API for projects
+ * All methods follow the builder pattern (are chainable) and return the same instance of the class
+ */
+declare class NIHProjectQuery {
+    private useRelavance;
+    private fiscalYears;
+    private includeActiveProjects;
+    private piProfileIds;
+    private excludeFields;
+    private offset;
+    private limit;
+    constructor();
+    /**
+     * Set query params to return projects associated with "ANY" of the PI profile IDs passed
+     * @param piProfileIds - The PI profile IDs to filter the projects by
+     */
+    setPIProfileIds(piProfileIds: number[]): NIHProjectQuery;
+    /**
+     * Sets query params return projects that started in "ANY" of the fiscal years entered
+     * @param fiscalYears - The fiscal years to filter the projects by
+     */
+    setFiscalYears(fiscalYears: number[]): NIHProjectQuery;
+    /**
+     * If sets true, it will bring the most closely matching records with the search criteria on top
+     * @param useRelevance - If true, use relevance scoring for the results, default is false
+     */
+    setUseRelevance(useRelevance: boolean): NIHProjectQuery;
+    /**
+     * Return the result with active projects if set to true
+     * @param includeActiveProjects - If true, include active projects in the result, default is false
+     */
+    setIncludeActiveProjects(includeActiveProjects: boolean): NIHProjectQuery;
+    /**
+     * Set the fields to exclude from the result
+     * @param excludeFields - The fields to exclude from the result
+     */
+    setExcludeFields(excludeFields: NIHProjectFields[]): NIHProjectQuery;
+    /**
+     * Add a field to exclude from the result
+     * @param excludeField - The field to exclude from the result
+     */
+    addExcludeField(excludeField: NIHProjectFields): NIHProjectQuery;
+    /**
+     * Remove a field to exclude from the result.
+     * @param excludeField - The field to remove from the exclude list
+     */
+    removeExcludeField(excludeField: string): NIHProjectQuery;
+    /**
+     * Set the number of records to return
+     * @param limit - The number of records to return, default is 50
+     */
+    setLimit(limit: number): NIHProjectQuery;
+    /**
+     * Set the offset for the records to return
+     * @param offset - The offset for the records to return, default is 0
+     */
+    setOffset(offset: number): NIHProjectQuery;
+    /**
+     * Execute the query and return the results
+     * @returns - The results of the query
+     * @throws - Error if the NIH Reporter API call fails
+     */
+    execute(): Promise<NIHProject[]>;
+    /**
+     * Creates an async iterator that will yield NIHProject objects queried from the NIH Reporter API
+     * @param offset to start from, by default it is 0
+     * @returns an async iterator that will yield NIHProject objects
+     * @throws Error if the NIH Reporter API call fails
+     */
+    iterator(offset?: number): AsyncGenerator<NIHProject, void, void>;
+    /**
+     * Creates a safe async iterator that will yield NIHProject objects queried from the NIH Reporter API
+     * @param offset to start from, by default it is 0
+     * @returns a safe async iterator that will yield NIHProject objects in Golang style (value, error) tuple
+     */
+    safeIterator(offset?: number): AsyncGenerator<[NIHProject?, Error?], [undefined, undefined], void>;
+}
+export { type NIHProject, NIHProjectQuery };
+//# sourceMappingURL=project.d.ts.map

package/esm/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../src/project.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAE,KAAK,gBAAgB,EAAmB,MAAM,YAAY,CAAC;AAErF;;;GAGG;AACH,cAAM,eAAe;IACnB,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,qBAAqB,CAAU;IACvC,OAAO,CAAC,YAAY,CAAW;IAC/B,OAAO,CAAC,aAAa,CAAqB;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAS;;IAYtB;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,GAAG,eAAe;IAKxD;;;OAGG;IACH,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,eAAe;IAKtD;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,OAAO,GAAG,eAAe;IAKvD;;;OAGG;IACH,wBAAwB,CAAC,qBAAqB,EAAE,OAAO,GAAG,eAAe;IAKzE;;;OAGG;IACH,gBAAgB,CAAC,aAAa,EAAE,gBAAgB,EAAE,GAAG,eAAe;IAKpE;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,gBAAgB,GAAG,eAAe;IAOhE;;;OAGG;IACH,kBAAkB,CAAC,YAAY,EAAE,MAAM,GAAG,eAAe;IAKzD;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe;IAWxC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,eAAe;IAS1C;;;;OAIG;IACG,OAAO,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;IAmCtC;;;;;OAKG;IACI,QAAQ,CAAC,MAAM,SAAI,GAAG,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC;IAqBnE;;;;OAIG;IACI,YAAY,CAAC,MAAM,SAAI,GAAG,cAAc,CAAC,CAAC,UAAU,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,EAAE,IAAI,CAAC;CA6BrG;AACD,OAAO,EAAE,KAAK,UAAU,EAAE,eAAe,EAAE,CAAC"}

package/{dist → esm}/project.js

@@ -1,6 +1,52 @@
 import { parseNIHProject } from "./types.js";
+/**
+ * NIHProjectQuery class to query the NIH Reporter API for projects
+ * All methods follow the builder pattern (are chainable) and return the same instance of the class
+ */
 class NIHProjectQuery {
     constructor() {
+        Object.defineProperty(this, "useRelavance", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "fiscalYears", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "includeActiveProjects", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "piProfileIds", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "excludeFields", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "offset", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "limit", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
         this.useRelavance = false;
         this.fiscalYears = [];
         this.includeActiveProjects = true;
@@ -10,14 +56,16 @@ class NIHProjectQuery {
         this.limit = 50;
     }
     /**
-     * When executed, this will return projects associated with "ANY" of the PI profile IDs passed
+     * Set query params to return projects associated with "ANY" of the PI profile IDs passed
+     * @param piProfileIds - The PI profile IDs to filter the projects by
      */
     setPIProfileIds(piProfileIds) {
         this.piProfileIds = piProfileIds;
         return this;
     }
     /**
-     * When executed, this will return projects that started in "ANY" of the fiscal years entered
+     * Sets query params return projects that started in "ANY" of the fiscal years entered
+     * @param fiscalYears - The fiscal years to filter the projects by
      */
     setFiscalYears(fiscalYears) {
         this.fiscalYears = fiscalYears;
@@ -25,7 +73,7 @@ class NIHProjectQuery {
     }
     /**
      * If sets true, it will bring the most closely matching records with the search criteria on top
-     * Default is false
+     * @param useRelevance - If true, use relevance scoring for the results, default is false
      */
     setUseRelevance(useRelevance) {
         this.useRelavance = useRelevance;
@@ -33,26 +81,42 @@ class NIHProjectQuery {
     }
     /**
      * Return the result with active projects if set to true
-     * Default is false
+     * @param includeActiveProjects - If true, include active projects in the result, default is false
      */
     setIncludeActiveProjects(includeActiveProjects) {
         this.includeActiveProjects = includeActiveProjects;
         return this;
     }
+    /**
+     * Set the fields to exclude from the result
+     * @param excludeFields - The fields to exclude from the result
+     */
     setExcludeFields(excludeFields) {
         this.excludeFields = excludeFields;
         return this;
     }
+    /**
+     * Add a field to exclude from the result
+     * @param excludeField - The field to exclude from the result
+     */
     addExcludeField(excludeField) {
         if (!this.excludeFields.includes(excludeField)) {
             this.excludeFields.push(excludeField);
         }
         return this;
     }
+    /**
+     * Remove a field to exclude from the result.
+     * @param excludeField - The field to remove from the exclude list
+     */
     removeExcludeField(excludeField) {
         this.excludeFields = this.excludeFields.filter((field) => field !== excludeField);
         return this;
     }
+    /**
+     * Set the number of records to return
+     * @param limit - The number of records to return, default is 50
+     */
     setLimit(limit) {
         if (limit <= 0) {
             this.limit = 50;
@@ -65,6 +129,10 @@ class NIHProjectQuery {
         }
         return this;
     }
+    /**
+     * Set the offset for the records to return
+     * @param offset - The offset for the records to return, default is 0
+     */
     setOffset(offset) {
         if (offset < 0) {
             this.offset = 0;
@@ -74,6 +142,11 @@ class NIHProjectQuery {
         }
         return this;
     }
+    /**
+     * Execute the query and return the results
+     * @returns - The results of the query
+     * @throws - Error if the NIH Reporter API call fails
+     */
     async execute() {
         const resp = await fetch("https://api.reporter.nih.gov/v2/projects/search", {
             method: "POST",
@@ -99,10 +172,17 @@ class NIHProjectQuery {
             const errMsg = data[0];
             throw new Error(`NIH API err_msg: ${errMsg}`);
         }
-        const projects = results.map((raw) => parseNIHProject(raw));
+        const projects = results.map((p) => {
+            const [project, err] = parseNIHProject(p);
+            if (err) {
+                throw new Error(`NIH API parse err_msg: ${JSON.stringify(err, null, 1)}`);
+            }
+            return project;
+        });
         return projects;
     }
     /**
+     * Creates an async iterator that will yield NIHProject objects queried from the NIH Reporter API
      * @param offset to start from, by default it is 0
      * @returns an async iterator that will yield NIHProject objects
      * @throws Error if the NIH Reporter API call fails
@@ -128,6 +208,7 @@ class NIHProjectQuery {
         }
     }
     /**
+     * Creates a safe async iterator that will yield NIHProject objects queried from the NIH Reporter API
      * @param offset to start from, by default it is 0
      * @returns a safe async iterator that will yield NIHProject objects in Golang style (value, error) tuple
      */

package/{dist → esm}/types.d.ts

@@ -1,4 +1,35 @@
-type NIHProject = {
+interface NIHPerson {
+    nihPersonId: number;
+    firstName: string;
+    lastName: string;
+    middleName: string;
+    fullName: string;
+    isContactPI: boolean;
+    title?: string;
+}
+interface NIHOrg {
+    orgName: string;
+    city?: string;
+    country?: string;
+    orgCity: string;
+    orgState: string;
+    orgCountry?: string;
+    orgStateName?: string;
+    orgZipCode: string;
+    orgFips: string;
+    orgIPFCode: string;
+    externalOrgId: number;
+    deptType: string;
+    fipsCountyCode?: string;
+    orgDuns: string[];
+    orgUeis: string[];
+    primaryDuns: string;
+    primaryUei: string;
+}
+/**
+ * NIH Project/Award object
+ */
+interface NIHProject {
     applId: number;
     subProjectId?: string;
     fiscalYear: number;
@@ -10,7 +41,7 @@ type NIHProject = {
     directCost: number;
     indirectCost: number;
     isActive: boolean;
-    congDistrict: string;
+    congDistrict?: string;
     projectStartDate: Date;
     projectEndDate: Date;
     budgetStartDate: Date;
@@ -28,38 +59,15 @@ type NIHProject = {
     cfdaCode: string;
     org: NIHOrg;
     spendingCategories?: number[];
+    spendingCategoriesDesc?: string[];
     terms?: string[];
     prefTerms?: string[];
     abstractText?: string;
-};
-type NIHPerson = {
-    eraId: number;
-    firstName: string;
-    lastName: string;
-    middleName: string;
-    fullName: string;
-    isContactPI: boolean;
-    title?: string;
-};
-type NIHOrg = {
-    orgName: string;
-    city?: string;
-    country?: string;
-    orgCity: string;
-    orgState: string;
-    orgCountry?: string;
-    orgStateName?: string;
-    orgZipCode: string;
-    orgFips: string;
-    orgIPFCode: string;
-    externalOrgId: string;
-    deptType: string;
-    fipsCountyCode?: string;
-    orgDuns: string[];
-    orgUeis: string[];
-    primaryDuns: string;
-    primaryUei: string;
-};
-declare function parseNIHProject(raw: any): NIHProject;
+}
+/**
+ * NIHProjectFields which can be used to filter the fields returned by the NIH Reporter API
+ */
 type NIHProjectFields = "SpendingCategories" | "SpendingCategoriesDesc" | "ProgramOfficers" | "AbstractText" | "Terms" | "PrefTerms" | "CovidResponse" | "SubprojectId";
-export { parseNIHProject, NIHProjectFields, NIHProject };
+export declare function parseNIHProject(obj: unknown): [NIHProject, undefined] | [undefined, Error];
+export type { NIHProject, NIHProjectFields };
+//# sourceMappingURL=types.d.ts.map

package/esm/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAGA,UAAU,SAAS;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAqCD,UAAU,MAAM;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAwDD;;GAEG;AACH,UAAU,UAAU;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,IAAI,CAAC;IACvB,cAAc,EAAE,IAAI,CAAC;IACrB,eAAe,EAAE,IAAI,CAAC;IACtB,aAAa,EAAE,IAAI,CAAC;IACpB,sBAAsB,EAAE,SAAS,EAAE,CAAC;IACpC,SAAS,EAAE,IAAI,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,CAAC;IACZ,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA+FD;;GAEG;AACH,KAAK,gBAAgB,GACjB,oBAAoB,GACpB,wBAAwB,GACxB,iBAAiB,GACjB,cAAc,GACd,OAAO,GACP,WAAW,GACX,eAAe,GACf,cAAc,CAAC;AAEnB,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,GAAG,CAAC,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,CAAC,CAO1F;AAED,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC"}

package/esm/types.js

@@ -0,0 +1,169 @@
+import * as z from "@zod/zod/mini";
+z.config(z.locales.en());
+const NIHPersonSchema = z.pipe(z.object({
+    profile_id: z.number(),
+    first_name: z.string(),
+    last_name: z.string(),
+    middle_name: z.string(),
+    full_name: z.string(),
+    is_contact_pi: z.boolean(),
+    title: z.optional(z.string()),
+}), z.transform((p) => {
+    const nihPerson = {
+        nihPersonId: p.profile_id,
+        firstName: p.first_name,
+        lastName: p.last_name,
+        middleName: p.middle_name,
+        fullName: p.full_name,
+        isContactPI: p.is_contact_pi,
+    };
+    if (p.title !== null && p.title !== undefined) {
+        nihPerson.title = p.title;
+    }
+    return nihPerson;
+}));
+function _testTypeNIHPerson(nihPerson) {
+    return nihPerson;
+}
+function __testTypeNIHPerson(nihPerson) {
+    return nihPerson;
+}
+const NIHOrgSchema = z.pipe(z.object({
+    org_name: z.string(),
+    city: z.nullable(z.string()),
+    country: z.nullable(z.string()),
+    org_city: z.string(),
+    org_state: z.string(),
+    org_country: z.string(),
+    org_state_name: z.nullable(z.string()),
+    org_zipcode: z.string(),
+    org_fips: z.string(),
+    org_ipf_code: z.string(),
+    external_org_id: z.coerce.number(),
+    dept_type: z.string(),
+    fips_county_code: z.nullish(z.string()),
+    org_duns: z.array(z.string()),
+    org_ueis: z.array(z.string()),
+    primary_duns: z.string(),
+    primary_uei: z.string(),
+}), z.transform((o) => {
+    const org = {
+        orgName: o.org_name,
+        city: o.city ?? undefined,
+        country: o.country ?? undefined,
+        orgCity: o.org_city,
+        orgState: o.org_state,
+        orgCountry: o.org_country ?? undefined,
+        orgStateName: o.org_state_name ?? undefined,
+        deptType: o.dept_type,
+        orgDuns: o.org_duns,
+        orgUeis: o.org_ueis,
+        orgZipCode: o.org_zipcode,
+        primaryDuns: o.primary_duns,
+        primaryUei: o.primary_uei,
+        orgFips: o.org_fips,
+        orgIPFCode: o.org_ipf_code,
+        externalOrgId: o.external_org_id,
+        fipsCountyCode: o.fips_county_code ?? undefined,
+    };
+    return org;
+}));
+function _testTypeNIHOrg(org) {
+    return org;
+}
+function __testTypeNIHOrg(org) {
+    return org;
+}
+const NIHProjectSchema = z.pipe(z.object({
+    appl_id: z.number(),
+    subproject_id: z.nullish(z.string()),
+    fiscal_year: z.number(),
+    project_num: z.string(),
+    project_serial_num: z.string(),
+    award_type: z.string(),
+    activity_code: z.string(),
+    award_amount: z.number(),
+    direct_cost_amt: z.number(),
+    indirect_cost_amt: z.number(),
+    is_active: z.boolean(),
+    cong_district: z.optional(z.string()),
+    project_start_date: z.string(),
+    project_end_date: z.string(),
+    budget_start: z.string(),
+    budget_end: z.string(),
+    principal_investigators: z.array(NIHPersonSchema),
+    date_added: z.string(),
+    agency_code: z.string(),
+    arra_funded: z.string(),
+    opportunity_number: z.string(),
+    is_new: z.boolean(),
+    core_project_num: z.string(),
+    mechanism_code_dc: z.string(),
+    project_title: z.string(),
+    covid_response: z.nullish(z.string()),
+    cfda_code: z.string(),
+    organization: NIHOrgSchema,
+    spending_categories: z.nullish(z.array(z.coerce.number())),
+    spending_categories_desc: z.nullish(z.string()),
+    terms: z.nullish(z.string()),
+    pref_terms: z.nullish(z.string()),
+    abstract_text: z.nullish(z.string()),
+}), z.transform((p) => {
+    const org = p.organization;
+    const pis = p.principal_investigators;
+    const nihProject = {
+        applId: p.appl_id,
+        subProjectId: p.subproject_id ?? undefined,
+        fiscalYear: p.fiscal_year,
+        projectNum: p.project_num,
+        projectSerialNum: p.project_serial_num,
+        awardType: p.award_type,
+        activityCode: p.activity_code,
+        awardAmount: p.award_amount,
+        directCost: p.direct_cost_amt,
+        indirectCost: p.indirect_cost_amt,
+        isActive: p.is_active,
+        congDistrict: p.cong_district,
+        projectStartDate: new Date(p.project_start_date),
+        projectEndDate: new Date(p.project_end_date),
+        budgetStartDate: new Date(p.budget_start),
+        budgetEndDate: new Date(p.budget_end),
+        principalInvestigators: pis,
+        dateAdded: new Date(p.date_added),
+        agencyCode: p.agency_code,
+        arraFunded: p.arra_funded,
+        oppurtunityNumber: p.opportunity_number,
+        isNew: p.is_new,
+        coreProjectNum: p.core_project_num,
+        mechanismCodeDc: p.mechanism_code_dc,
+        projectTitle: p.project_title,
+        covidResponse: p.covid_response ?? undefined,
+        cfdaCode: p.cfda_code,
+        org: org,
+        spendingCategories: typeof p.spending_categories === "object" ? p.spending_categories : undefined,
+        terms: typeof p.terms === "string"
+            ? (p.terms.match(/<([^>]+)>/g)?.map((tag) => tag.slice(1, -1)) || [])
+            : undefined,
+        spendingCategoriesDesc: typeof p.spending_categories_desc === "string"
+            ? p.spending_categories_desc.split(";")
+            : undefined,
+        prefTerms: typeof p.pref_terms === "string" ? p.pref_terms.split(";") : undefined,
+        abstractText: p.abstract_text ?? undefined,
+    };
+    return nihProject;
+}));
+function _testTypeNIHProject(project) {
+    return project;
+}
+function __testTypeNIHProject(project) {
+    return project;
+}
+export function parseNIHProject(obj) {
+    const result = NIHProjectSchema.safeParse(obj);
+    if (result.success) {
+        return [result.data, undefined];
+    }
+    else {
+        return [undefined, result.error];
+    }
+}

package/package.json

@@ -1,27 +1,35 @@
 {
   "name": "@adisuper94/nih-reporter",
-  "version": "0.0.4",
-  "description": "",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "scripts": {
-    "build": "tsc",
-    "test": "node --loader ts-node/esm --no-warnings=ExperimentalWarning tests/*"
-  },
+  "version": "0.0.8",
+  "description": "NIH Reporter API client",
+  "keywords": [
+    "nih",
+    "nih-reporter",
+    "api"
+  ],
+  "author": "Aditya Subramanian",
+  "homepage": "https://github.com/adiSuper94/nih-reporter#readme",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/adiSuper94/nih-reporter.git"
   },
-  "keywords": [],
-  "author": "Aditya Subramanian",
+  "license": "MIT",
   "bugs": {
     "url": "https://github.com/adiSuper94/nih-reporter/issues"
   },
-  "homepage": "https://github.com/adiSuper94/nih-reporter#readme",
+  "main": "./script/index.js",
+  "module": "./esm/index.js",
+  "exports": {
+    ".": {
+      "import": "./esm/index.js",
+      "require": "./script/index.js"
+    }
+  },
+  "dependencies": {
+    "@zod/mini": "^4.0.0-beta.20250424T163858"
+  },
   "devDependencies": {
-    "@types/node": "^22.14.0",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.8.2"
-  }
-}
+    "@types/node": "^20.9.0"
+  },
+  "_generatedBy": "dnt@dev"
+}

package/script/index.d.ts

@@ -0,0 +1,4 @@
+import { NIHProjectQuery } from "./project.js";
+import type { NIHProject } from "./types.js";
+export { type NIHProject, NIHProjectQuery };
+//# sourceMappingURL=index.d.ts.map

package/script/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,KAAK,UAAU,EAAE,eAAe,EAAE,CAAC"}

package/script/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NIHProjectQuery = void 0;
+const project_js_1 = require("./project.js");
+Object.defineProperty(exports, "NIHProjectQuery", { enumerable: true, get: function () { return project_js_1.NIHProjectQuery; } });

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}