@mantra-ai/core 0.1.0

package/dist/works/errors.js

@@ -0,0 +1,37 @@
+/**
+ * Typed pipeline errors for the ingest pipeline.
+ *
+ * Each error code maps to an HTTP status code so the error handler
+ * can return semantically correct responses instead of generic 500s.
+ */
+export const PIPELINE_ERROR_CODES = {
+    IDENTIFIER_NOT_FOUND: "identifier_not_found",
+    FULLTEXT_UNAVAILABLE: "fulltext_unavailable",
+    XML_PARSE_ERROR: "xml_parse_error",
+    UPSTREAM_FAILURE: "upstream_failure",
+    UPSTREAM_RATE_LIMITED: "upstream_rate_limited",
+    CONFLICT: "conflict",
+    INTERNAL_ERROR: "internal_error",
+};
+const STATUS_MAP = {
+    [PIPELINE_ERROR_CODES.IDENTIFIER_NOT_FOUND]: 404,
+    [PIPELINE_ERROR_CODES.FULLTEXT_UNAVAILABLE]: 422,
+    [PIPELINE_ERROR_CODES.XML_PARSE_ERROR]: 422,
+    [PIPELINE_ERROR_CODES.UPSTREAM_FAILURE]: 502,
+    [PIPELINE_ERROR_CODES.UPSTREAM_RATE_LIMITED]: 503,
+    [PIPELINE_ERROR_CODES.CONFLICT]: 409,
+    [PIPELINE_ERROR_CODES.INTERNAL_ERROR]: 500,
+};
+export class PipelineError extends Error {
+    code;
+    statusCode;
+    details;
+    constructor(code, message, details) {
+        super(message);
+        this.name = "PipelineError";
+        this.code = code;
+        this.statusCode = STATUS_MAP[code] ?? 500;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/works/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/works/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,oBAAoB,EAAE,sBAAsB;IAC5C,oBAAoB,EAAE,sBAAsB;IAC5C,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,qBAAqB,EAAE,uBAAuB;IAC9C,QAAQ,EAAE,UAAU;IACpB,cAAc,EAAE,gBAAgB;CACxB,CAAC;AAKX,MAAM,UAAU,GAA2B;IACzC,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,EAAE,GAAG;IAChD,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,EAAE,GAAG;IAChD,CAAC,oBAAoB,CAAC,eAAe,CAAC,EAAE,GAAG;IAC3C,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,GAAG;IAC5C,CAAC,oBAAoB,CAAC,qBAAqB,CAAC,EAAE,GAAG;IACjD,CAAC,oBAAoB,CAAC,QAAQ,CAAC,EAAE,GAAG;IACpC,CAAC,oBAAoB,CAAC,cAAc,CAAC,EAAE,GAAG;CAC3C,CAAC;AAEF,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAoB;IACxB,UAAU,CAAS;IACnB,OAAO,CAA2B;IAE3C,YACE,IAAuB,EACvB,OAAe,EACf,OAAiC;QAEjC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;QAC1C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/works/id/detect-identifier.d.ts

@@ -0,0 +1,15 @@
+import type { ActionsExternalType } from "../types";
+export type DetectedIdentifier = {
+    idType: ActionsExternalType;
+    value: string;
+};
+/**
+ * Auto-detect identifier type from a raw string.
+ *
+ * Tries normalizers in priority order:
+ *   DOI → PMCID → arXiv → bioRxiv/medRxiv → PMID → fallback DOI.
+ *
+ * PMID is checked last because bare numerics are ambiguous.
+ */
+export declare function detectIdentifier(input: string): DetectedIdentifier;
+//# sourceMappingURL=detect-identifier.d.ts.map

package/dist/works/id/detect-identifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-identifier.d.ts","sourceRoot":"","sources":["../../../src/works/id/detect-identifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAUpD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,mBAAmB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,kBAAkB,CA8ClE"}

package/dist/works/id/detect-identifier.js

@@ -0,0 +1,50 @@
+import { detectDOI, normalizeDOI, normalizePMID, normalizePMCID, normalizeArXivId, deriveBioMedrxivDoi, } from "./normalize-internals";
+/**
+ * Auto-detect identifier type from a raw string.
+ *
+ * Tries normalizers in priority order:
+ *   DOI → PMCID → arXiv → bioRxiv/medRxiv → PMID → fallback DOI.
+ *
+ * PMID is checked last because bare numerics are ambiguous.
+ */
+export function detectIdentifier(input) {
+    const trimmed = input.trim();
+    // DOI (most common) — handles 10.xxxx/..., doi:..., https://doi.org/...
+    const doi = detectDOI(trimmed);
+    if (doi) {
+        return { idType: "doi", value: doi };
+    }
+    // PMCID — PMC1234567, pmc:1234567
+    const pmcid = normalizePMCID(trimmed);
+    if (pmcid) {
+        return { idType: "pmcid", value: pmcid };
+    }
+    // arXiv — 2301.12345, arxiv:2301.12345, https://arxiv.org/abs/...
+    const arxiv = normalizeArXivId(trimmed);
+    if (arxiv) {
+        return { idType: "arxivId", value: arxiv };
+    }
+    // bioRxiv/medRxiv — 10.1101/... DOI pattern or raw ID
+    const biorxivDoi = deriveBioMedrxivDoi(trimmed);
+    if (biorxivDoi) {
+        return { idType: "doi", value: biorxivDoi };
+    }
+    // PMID — bare numeric (check last to avoid false positives)
+    if (/^\d{1,12}$/.test(trimmed)) {
+        const pmid = normalizePMID(trimmed);
+        if (pmid) {
+            return { idType: "pmid", value: pmid };
+        }
+    }
+    // Explicit PMID prefix — pmid:1234567
+    if (/^pmid:\s*\d+$/i.test(trimmed)) {
+        const pmid = normalizePMID(trimmed.replace(/^pmid:\s*/i, ""));
+        if (pmid) {
+            return { idType: "pmid", value: pmid };
+        }
+    }
+    // Fallback: treat as DOI
+    const normalized = normalizeDOI(trimmed);
+    return { idType: "doi", value: normalized ?? trimmed };
+}
+//# sourceMappingURL=detect-identifier.js.map

package/dist/works/id/detect-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-identifier.js","sourceRoot":"","sources":["../../../src/works/id/detect-identifier.ts"],"names":[],"mappings":"AACA,OAAO,EACL,SAAS,EACT,YAAY,EACZ,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,uBAAuB,CAAC;AAO/B;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,wEAAwE;IACxE,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAC/B,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;IACvC,CAAC;IAED,kCAAkC;IAClC,MAAM,KAAK,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED,kEAAkE;IAClE,MAAM,KAAK,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;IACxC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IAC7C,CAAC;IAED,sDAAsD;IACtD,MAAM,UAAU,GAAG,mBAAmB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAC9C,CAAC;IAED,4DAA4D;IAC5D,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,CAAC;QACpC,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,sCAAsC;IACtC,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;QAC9D,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;QACzC,CAAC;IACH,CAAC;IAED,yBAAyB;IACzB,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC;IACzC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,UAAU,IAAI,OAAO,EAAE,CAAC;AACzD,CAAC"}

package/dist/works/id/normalize-external-id.d.ts

@@ -0,0 +1,3 @@
+export type ExtKey = "doi" | "pmid" | "pmcid" | "arxivId" | "biorxivId" | "medrxivId" | "openalexId";
+export declare function normalizeExternalId(kind: ExtKey, value: string): string | null;
+//# sourceMappingURL=normalize-external-id.d.ts.map

package/dist/works/id/normalize-external-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-external-id.d.ts","sourceRoot":"","sources":["../../../src/works/id/normalize-external-id.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,MAAM,GACd,KAAK,GACL,MAAM,GACN,OAAO,GACP,SAAS,GACT,WAAW,GACX,WAAW,GACX,YAAY,CAAC;AAEjB,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,IAAI,CAuCf"}

package/dist/works/id/normalize-external-id.js

@@ -0,0 +1,44 @@
+import { normalizeDOI, normalizePMID, normalizePMCID, normalizeArXivId, } from "./normalize-internals";
+export function normalizeExternalId(kind, value) {
+    let s = String(value ?? "").trim();
+    if (s.length === 0)
+        return null;
+    switch (kind) {
+        case "doi": {
+            const v = normalizeDOI(s);
+            return v ? v.toLowerCase() : null; // store lowercase for canonicalization
+        }
+        case "pmid": {
+            const v = normalizePMID(s);
+            return v ?? null;
+        }
+        case "pmcid": {
+            const v = normalizePMCID(s);
+            return v ?? null; // already PMC-prefixed uppercase
+        }
+        case "arxivId": {
+            const v = normalizeArXivId(s);
+            if (!v)
+                return null;
+            // Drop version suffix (e.g., v2) per route contract
+            return v.replace(/v\d+$/i, "");
+        }
+        case "biorxivId": {
+            // Strip common prefixes; keep as plain identifier
+            s = s.replace(/^biorxiv:\s*/i, "").trim();
+            return s.length ? s : null;
+        }
+        case "medrxivId": {
+            // Strip common prefixes; keep as plain identifier (no 10.1101/)
+            s = s.replace(/^medrxiv:\s*/i, "").trim();
+            s = s.replace(/^10\.1101\//i, "");
+            return s.length ? s : null;
+        }
+        case "openalexId": {
+            // Accept bare W123... or URL forms
+            s = s.replace(/^https?:\/\/(www\.)?openalex\.org\//i, "").trim();
+            return s.length ? s : null;
+        }
+    }
+}
+//# sourceMappingURL=normalize-external-id.js.map

package/dist/works/id/normalize-external-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-external-id.js","sourceRoot":"","sources":["../../../src/works/id/normalize-external-id.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,aAAa,EACb,cAAc,EACd,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAW/B,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,KAAa;IAEb,IAAI,CAAC,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAChC,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,KAAK,CAAC,CAAC,CAAC;YACX,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC1B,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,uCAAuC;QAC5E,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;YAC3B,OAAO,CAAC,IAAI,IAAI,CAAC;QACnB,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC;YAC5B,OAAO,CAAC,IAAI,IAAI,CAAC,CAAC,iCAAiC;QACrD,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;YAC9B,IAAI,CAAC,CAAC;gBAAE,OAAO,IAAI,CAAC;YACpB,oDAAoD;YACpD,OAAO,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,kDAAkD;YAClD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7B,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,gEAAgE;YAChE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YAC1C,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;YAClC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7B,CAAC;QACD,KAAK,YAAY,CAAC,CAAC,CAAC;YAClB,mCAAmC;YACnC,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,sCAAsC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;YACjE,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7B,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/works/id/normalize-ids.d.ts

@@ -0,0 +1,66 @@
+import type { IdentifierType } from "./types";
+import { normalizeDOI, detectDOI, normalizePMID, normalizePMCID, normalizeArXivId, deriveBioMedrxivDoi } from "./normalize-internals";
+export { normalizeDOI, detectDOI, normalizePMID, normalizePMCID, normalizeArXivId, deriveBioMedrxivDoi, };
+export declare function normalizeAndMaybeResolveToDOI(type: IdentifierType, value: string, resolvers: {
+    resolvePmidToDoi: (pmid: string) => Promise<string | null>;
+    resolvePmcidToDoi: (pmcid: string) => Promise<string | null>;
+    resolveArxivToDoi: (arxivId: string) => Promise<string | null>;
+}): Promise<{
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        details: {
+            value: string;
+            type?: undefined;
+        };
+    };
+    data?: undefined;
+} | {
+    ok: true;
+    data: {
+        type: "doi";
+        value: string;
+    };
+    error?: undefined;
+} | {
+    ok: true;
+    data: {
+        type: "pmid";
+        value: string;
+    };
+    error?: undefined;
+} | {
+    ok: true;
+    data: {
+        type: "pmcid";
+        value: string;
+    };
+    error?: undefined;
+} | {
+    ok: true;
+    data: {
+        type: "arxiv";
+        value: string;
+    };
+    error?: undefined;
+} | {
+    ok: true;
+    data: {
+        type: "biorxiv" | "medrxiv";
+        value: string;
+    };
+    error?: undefined;
+} | {
+    ok: false;
+    error: {
+        code: string;
+        message: string;
+        details: {
+            type: never;
+            value: string;
+        };
+    };
+    data?: undefined;
+}>;
+//# sourceMappingURL=normalize-ids.d.ts.map

package/dist/works/id/normalize-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-ids.d.ts","sourceRoot":"","sources":["../../../src/works/id/normalize-ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC9C,OAAO,EACL,YAAY,EACZ,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,YAAY,EACZ,SAAS,EACT,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,mBAAmB,GACpB,CAAC;AAEF,wBAAsB,6BAA6B,CACjD,IAAI,EAAE,cAAc,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE;IACT,gBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC3D,iBAAiB,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7D,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6GF"}

package/dist/works/id/normalize-ids.js

@@ -0,0 +1,112 @@
+import { normalizeDOI, detectDOI, normalizePMID, normalizePMCID, normalizeArXivId, deriveBioMedrxivDoi, } from "./normalize-internals";
+export { normalizeDOI, detectDOI, normalizePMID, normalizePMCID, normalizeArXivId, deriveBioMedrxivDoi, };
+export async function normalizeAndMaybeResolveToDOI(type, value, resolvers) {
+    const raw = String(value || "").trim();
+    switch (type) {
+        case "doi": {
+            const doi = normalizeDOI(raw);
+            if (!doi)
+                return {
+                    ok: false,
+                    error: {
+                        code: "invalid_input",
+                        message: "Invalid DOI",
+                        details: { value },
+                    },
+                };
+            return { ok: true, data: { type: "doi", value: doi } };
+        }
+        case "pmid": {
+            const pmid = normalizePMID(raw);
+            if (!pmid)
+                return {
+                    ok: false,
+                    error: {
+                        code: "invalid_input",
+                        message: "Invalid PMID",
+                        details: { value },
+                    },
+                };
+            const doi = await resolvers.resolvePmidToDoi(pmid);
+            if (doi)
+                return {
+                    ok: true,
+                    data: { type: "doi", value: doi },
+                };
+            return {
+                ok: true,
+                data: { type: "pmid", value: pmid },
+            };
+        }
+        case "pmcid": {
+            const pmcid = normalizePMCID(raw);
+            if (!pmcid)
+                return {
+                    ok: false,
+                    error: {
+                        code: "invalid_input",
+                        message: "Invalid PMCID",
+                        details: { value },
+                    },
+                };
+            const doi = await resolvers.resolvePmcidToDoi(pmcid);
+            if (doi)
+                return {
+                    ok: true,
+                    data: { type: "doi", value: doi },
+                };
+            return {
+                ok: true,
+                data: { type: "pmcid", value: pmcid },
+            };
+        }
+        case "arxiv": {
+            const arxivid = normalizeArXivId(raw);
+            if (!arxivid)
+                return {
+                    ok: false,
+                    error: {
+                        code: "invalid_input",
+                        message: "Invalid arXiv identifier",
+                        details: { value },
+                    },
+                };
+            const doi = await resolvers.resolveArxivToDoi(arxivid);
+            if (doi)
+                return {
+                    ok: true,
+                    data: { type: "doi", value: doi },
+                };
+            return {
+                ok: true,
+                data: { type: "arxiv", value: arxivid },
+            };
+        }
+        case "biorxiv":
+        case "medrxiv": {
+            const embeddedDoi = detectDOI(raw);
+            if (embeddedDoi)
+                return {
+                    ok: true,
+                    data: { type: "doi", value: embeddedDoi },
+                };
+            const derived = deriveBioMedrxivDoi(raw);
+            if (derived)
+                return {
+                    ok: true,
+                    data: { type: "doi", value: derived },
+                };
+            return { ok: true, data: { type, value: raw } };
+        }
+        default:
+            return {
+                ok: false,
+                error: {
+                    code: "invalid_input",
+                    message: "Unknown identifier type",
+                    details: { type, value },
+                },
+            };
+    }
+}
+//# sourceMappingURL=normalize-ids.js.map

package/dist/works/id/normalize-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-ids.js","sourceRoot":"","sources":["../../../src/works/id/normalize-ids.ts"],"names":[],"mappings":"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"}

package/dist/works/id/normalize-internals.d.ts

@@ -0,0 +1,7 @@
+export declare function normalizeDOI(input: string): string | null;
+export declare function detectDOI(input: string): string | null;
+export declare function normalizePMID(input: string): string | null;
+export declare function normalizePMCID(input: string): string | null;
+export declare function normalizeArXivId(input: string): string | null;
+export declare function deriveBioMedrxivDoi(input: string): string | null;
+//# sourceMappingURL=normalize-internals.d.ts.map

package/dist/works/id/normalize-internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-internals.d.ts","sourceRoot":"","sources":["../../../src/works/id/normalize-internals.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUzD;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtD;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1D;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAM3D;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQ7D;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoBhE"}

package/dist/works/id/normalize-internals.js

@@ -0,0 +1,65 @@
+export function normalizeDOI(input) {
+    let v = input.trim();
+    v = v.replace(/^doi:\s*/i, "");
+    v = v.replace(/^info:doi\//i, "");
+    v = v.replace(/^(https?:\/\/)?(dx\.)?doi\.org\//i, "");
+    try {
+        v = decodeURIComponent(v);
+    }
+    catch { }
+    if (!/^10\.[0-9]{4,9}\/\S+$/i.test(v))
+        return null;
+    return v;
+}
+export function detectDOI(input) {
+    const m = input.match(/10\.[0-9]{4,9}\/\S+/i);
+    if (!m)
+        return null;
+    const candidate = m[0];
+    return normalizeDOI(candidate);
+}
+export function normalizePMID(input) {
+    const lowered = input.trim();
+    const m = lowered.match(/(\d{1,12})/);
+    return m ? m[1] : null;
+}
+export function normalizePMCID(input) {
+    const v = input.trim();
+    const m = v.match(/pmc\s*:?\s*(\d{1,12})/i);
+    if (m)
+        return `PMC${m[1]}`;
+    const m2 = v.match(/PMC\d{1,12}/i);
+    return m2 ? m2[0].toUpperCase() : null;
+}
+export function normalizeArXivId(input) {
+    let v = input.trim();
+    v = v.replace(/^arxiv:\s*/i, "");
+    v = v.replace(/^https?:\/\/arxiv\.org\/(abs|pdf)\//i, "");
+    v = v.replace(/\.pdf$/i, "");
+    if (/^\d{4}\.\d{4,5}(v\d+)?$/i.test(v))
+        return v;
+    if (/^[a-z\-]+\/\d{7}$/i.test(v))
+        return v;
+    return null;
+}
+export function deriveBioMedrxivDoi(input) {
+    const raw = String(input ?? "").trim();
+    if (raw.length === 0)
+        return null;
+    // If a DOI is already embedded, normalize and return it
+    const embedded = raw.match(/10\.1101\/([^\s#?]+)/i);
+    if (embedded && embedded[1]) {
+        const doi = `10.1101/${embedded[1].replace(/v\d+$/i, "")}`;
+        return normalizeDOI(doi);
+    }
+    // Support both historical (YYYY.MM.NNNN...) and modern (YYYY.MM.DD.NNNN...) id forms
+    // Optionally strip a trailing version suffix vN
+    const m = raw.match(/(\d{4}\.\d{2}(?:\.\d{2})?\.\d{4,})(?:v\d+)?/i);
+    if (m && m[1]) {
+        const suffix = m[1];
+        const doi = `10.1101/${suffix}`;
+        return normalizeDOI(doi);
+    }
+    return null;
+}
+//# sourceMappingURL=normalize-internals.js.map

package/dist/works/id/normalize-internals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-internals.js","sourceRoot":"","sources":["../../../src/works/id/normalize-internals.ts"],"names":[],"mappings":"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"}

package/dist/works/id/resolve.d.ts

@@ -0,0 +1,31 @@
+import type { LoggerLike } from "../types";
+/**
+ * Resolve PMID -> DOI via Europe PMC.
+ */
+export declare function resolvePmidToDoi(pmid: string, logger?: LoggerLike): Promise<string | null>;
+/**
+ * Resolve PMCID -> DOI via Europe PMC.
+ */
+export declare function resolvePmcidToDoi(pmcid: string, logger?: LoggerLike): Promise<string | null>;
+/**
+ * Normalize arXiv identifiers from many forms (URL, arXiv: prefix, DOI, raw).
+ * Preserves version if present; callers can strip with `.replace(/v\\d+$/i, "")`.
+ */
+export declare function normalizeArXivId(raw: string | null | undefined): string | null;
+/**
+ * Helper to recognize arXiv/DataCite DOIs.
+ */
+export declare function isArxivDataciteDoi(doi: string | null | undefined): boolean;
+/**
+ * Resolve arXiv -> DOI deterministically via DataCite.
+ * - Construct 10.48550/arXiv.<id> (strip version)
+ * - Verify with DataCite (returns null if not found)
+ */
+export declare function resolveArxivToDoi(arxivId: string, logger?: LoggerLike): Promise<string | null>;
+/**
+ * Tiny helper you can call before hitting Crossref.
+ * Example:
+ *   if (doi && !shouldQueryCrossrefForDoi(doi)) { /* skip Crossref *\/ }
+ */
+export declare function shouldQueryCrossrefForDoi(doi: string | null | undefined): boolean;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/works/id/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/works/id/resolve.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAiB3C;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWhG;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAWlG;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,MAAM,GAAG,IAAI,CA+Cf;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE1E;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,UAAU,GAClB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBxB;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC7B,OAAO,CAET"}

package/dist/works/id/resolve.js

@@ -0,0 +1,123 @@
+import { normalizeDOI } from "./normalize-internals";
+/**
+ * Europe PMC thin client (pageSize=1 is enough for our uses).
+ */
+// EuropePMC returns deeply nested, untyped JSON — keep as `any` at the adapter boundary
+async function europePmcSearch(query) {
+    const url = `https://www.ebi.ac.uk/europepmc/webservices/rest/search?format=json&pageSize=1&query=${encodeURIComponent(query)}`;
+    const res = await fetch(url, {
+        headers: { Accept: "application/json" },
+    });
+    if (!res.ok)
+        throw new Error(`Europe PMC search failed: ${res.status}`);
+    return res.json();
+}
+/**
+ * Resolve PMID -> DOI via Europe PMC.
+ */
+export async function resolvePmidToDoi(pmid, logger) {
+    try {
+        const data = await europePmcSearch(`EXT_ID:${pmid} AND SRC:MED`);
+        const item = data?.resultList?.result?.[0];
+        const doi = item?.doi || item?.doiFirst || item?.doiList?.[0];
+        return doi ? normalizeDOI(doi) : null;
+    }
+    catch (err) {
+        logger?.warn?.({ err, source: "europepmc", identifier: pmid }, "resolve.pmidToDoi: failed");
+        return null;
+    }
+}
+/**
+ * Resolve PMCID -> DOI via Europe PMC.
+ */
+export async function resolvePmcidToDoi(pmcid, logger) {
+    try {
+        const data = await europePmcSearch(`PMCID:${pmcid}`);
+        const item = data?.resultList?.result?.[0];
+        const doi = item?.doi || item?.doiFirst || item?.doiList?.[0];
+        return doi ? normalizeDOI(doi) : null;
+    }
+    catch (err) {
+        logger?.warn?.({ err, source: "europepmc", identifier: pmcid }, "resolve.pmcidToDoi: failed");
+        return null;
+    }
+}
+/**
+ * Normalize arXiv identifiers from many forms (URL, arXiv: prefix, DOI, raw).
+ * Preserves version if present; callers can strip with `.replace(/v\\d+$/i, "")`.
+ */
+export function normalizeArXivId(raw) {
+    if (!raw)
+        return null;
+    let s = String(raw).trim();
+    // Normalize odd trailing "[vN]" into "vN" (e.g., "…[v2]" -> "…v2")
+    s = s.replace(/\[v(\d+)\]$/i, "v$1");
+    // Strip arXiv: prefix
+    s = s.replace(/^arxiv:\s*/i, "");
+    // Pull from URL forms
+    const urlMatch = s.match(/arxiv\.org\/(?:abs|pdf)\/(?<core>(\d{4}\.\d{4,5}|[a-z\-]+\/\d{7}))(?:v(?<ver>\d+))?(?:\.pdf)?/i);
+    if (urlMatch?.groups?.core) {
+        const core = urlMatch.groups.core.toLowerCase();
+        const ver = urlMatch.groups.ver ? `v${urlMatch.groups.ver}` : "";
+        return `${core}${ver}`;
+    }
+    // If it's a bare DataCite DOI like 10.48550/arXiv.2101.12345[v2]
+    const dataciteDoi = s.match(/^10\.48550\/(?:arxiv[.:])(?<rest>.+)$/i);
+    if (dataciteDoi?.groups?.rest) {
+        // rest may still include a version (e.g., "2101.12345v2")
+        return dataciteDoi.groups.rest.toLowerCase();
+    }
+    // Now assume it's a raw id (maybe with version)
+    s = s.toLowerCase();
+    // Modern scheme: YYYY.NNNN(N) with optional version
+    const modern = s.match(/^(\d{4})\.(\d{4,5})(?:v(\d+))?$/);
+    if (modern) {
+        const ver = modern[3] ? `v${modern[3]}` : "";
+        return `${modern[1]}.${modern[2]}${ver}`;
+    }
+    // Legacy scheme: archive/YYMMNNN with optional version
+    const legacy = s.match(/^([a-z\-]+)\/(\d{7})(?:v(\d+))?$/);
+    if (legacy) {
+        const archive = legacy[1];
+        const num = legacy[2];
+        const ver = legacy[3] ? `v${legacy[3]}` : "";
+        return `${archive}/${num}${ver}`;
+    }
+    return null; // Not a recognizable arXiv id
+}
+/**
+ * Helper to recognize arXiv/DataCite DOIs.
+ */
+export function isArxivDataciteDoi(doi) {
+    return typeof doi === "string" && /^10\.48550\//i.test(doi);
+}
+/**
+ * Resolve arXiv -> DOI deterministically via DataCite.
+ * - Construct 10.48550/arXiv.<id> (strip version)
+ * - Verify with DataCite (returns null if not found)
+ */
+export async function resolveArxivToDoi(arxivId, logger) {
+    try {
+        const aid = normalizeArXivId(arxivId)?.replace(/v\d+$/i, "");
+        if (!aid)
+            return null;
+        const doi = `10.48550/arXiv.${aid}`;
+        const res = await fetch(`https://api.datacite.org/dois/${encodeURIComponent(doi)}`, {
+            headers: { Accept: "application/json" },
+        });
+        return res.ok ? doi : null;
+    }
+    catch (err) {
+        logger?.warn?.({ err, source: "datacite", identifier: arxivId }, "resolve.arxivToDoi: failed");
+        return null;
+    }
+}
+/**
+ * Tiny helper you can call before hitting Crossref.
+ * Example:
+ *   if (doi && !shouldQueryCrossrefForDoi(doi)) { /* skip Crossref *\/ }
+ */
+export function shouldQueryCrossrefForDoi(doi) {
+    return !isArxivDataciteDoi(doi);
+}
+//# sourceMappingURL=resolve.js.map

package/dist/works/id/resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/works/id/resolve.ts"],"names":[],"mappings":"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"}

package/dist/works/id/resolveIds/assign.d.ts

@@ -0,0 +1,4 @@
+import type { CompleteIds } from "../../types";
+export declare function applyNormalizedCompleteIds(ids: CompleteIds): CompleteIds;
+export declare const cloneAndNormalizeCompleteIds: (ids: any) => CompleteIds;
+//# sourceMappingURL=assign.d.ts.map

package/dist/works/id/resolveIds/assign.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign.d.ts","sourceRoot":"","sources":["../../../../src/works/id/resolveIds/assign.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CASxE;AAED,eAAO,MAAM,4BAA4B,GAAI,KAAK,GAAG,KAAG,WACtB,CAAC"}

package/dist/works/id/resolveIds/assign.js

@@ -0,0 +1,15 @@
+import { normalizeIds } from "../../util/normalize";
+export function applyNormalizedCompleteIds(ids) {
+    if (!ids)
+        return ids;
+    const normalized = normalizeIds(ids);
+    // Delete keys that normalization removed
+    for (const key of Object.keys(ids)) {
+        if (!(key in normalized))
+            delete ids[key];
+    }
+    // Apply normalized values back onto the original (preserves mutation semantics)
+    return Object.assign(ids, normalized);
+}
+export const cloneAndNormalizeCompleteIds = (ids) => normalizeIds({ ...(ids ?? {}) });
+//# sourceMappingURL=assign.js.map