doi_record.ts

//
// DOI verify will contact either CrossRef or DataCite to verify the DOI
//
import { getObject, verifyIdentifier } from "./utility.ts";
import { normalizeDOI, validateDOI } from "./doi.ts";

/**
 * Verifies an DOI handle exists registered via the DOI API.
 * @param DOI - the identifier to verify.
 * @returns Promise<boolean> - True if exists, false otherwise.
 */
export async function verifyDOI(doi: string): Promise<boolean> {
  const normalizedDOI = normalizeDOI(doi);
  const verified: boolean = await verifyIdentifier(
    doi,
    `https://doi.org/api/handles/${encodeURIComponent(normalizedDOI)}`,
    validateDOI,
  );
  return verified;
}

/**
 * getObjectDOI retrieves an DOI record from CrossRef or DataCite
 * @param DOI - The identifier of the object to retrieve.
 * @returns Promie<object | undefined>, if retrieval fails or JSON parse fail undefined is returned.
 */
export async function getObjectDOI(doi: string): Promise<object | undefined> {
  const normalizedDOI = normalizeDOI(doi);
  let obj = await getObject(
    doi,
    `https://api.crossref.org/works/${encodeURIComponent(normalizedDOI)}`,
    validateDOI,
  );
  if (obj === undefined) {
    // Now try DataCite
    return await getObject(
      doi,
      `https://api.datacite.org/dois/${encodeURIComponent(normalizedDOI)}`,
      validateDOI,
    );
  }
  return obj;
}