@cyanheads/orcid-mcp-server 0.1.1

package/dist/mcp-server/tools/definitions/resolve-researcher.tool.js

@@ -0,0 +1,250 @@
+/**
+ * @fileoverview Disambiguate an author name to a verified ORCID iD. Returns a
+ * ranked candidate list with transparent disambiguation signals: name match type,
+ * institution overlap, and anchor type (doi/pmid/none).
+ * @module mcp-server/tools/definitions/resolve-researcher.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOrcidService } from '../../../services/orcid/orcid-service.js';
+function computeNameMatch(candidate, inputName) {
+    const normalize = (s) => s
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, '')
+        .trim();
+    const normalizedInput = normalize(inputName);
+    // Build full names from candidate
+    const fullName = [candidate.givenNames, candidate.familyNames].filter(Boolean).join(' ');
+    const creditName = candidate.creditName ?? '';
+    if (normalize(fullName) === normalizedInput || normalize(creditName) === normalizedInput) {
+        return 'exact';
+    }
+    const inputTokens = normalizedInput.split(/\s+/).filter(Boolean);
+    const candidateTokens = normalize(fullName).split(/\s+/).filter(Boolean);
+    const overlap = inputTokens.filter((t) => candidateTokens.includes(t));
+    if (overlap.length >= Math.min(2, inputTokens.length)) {
+        return 'partial';
+    }
+    // Check other-names
+    for (const otherName of candidate.otherNames) {
+        if (normalize(otherName) === normalizedInput)
+            return 'other-name';
+        const otherTokens = normalize(otherName).split(/\s+/).filter(Boolean);
+        const otherOverlap = inputTokens.filter((t) => otherTokens.includes(t));
+        if (otherOverlap.length >= Math.min(2, inputTokens.length))
+            return 'other-name';
+    }
+    return 'none';
+}
+function computeInstitutionOverlap(candidate, inputAffiliation) {
+    if (!inputAffiliation?.trim())
+        return false;
+    const normalizeAff = (s) => s.toLowerCase().replace(/[^a-z0-9\s]/g, '');
+    const inputTokens = normalizeAff(inputAffiliation)
+        .split(/\s+/)
+        .filter((t) => t.length > 3); // skip short tokens (of, the, etc.)
+    return candidate.institutionNames.some((inst) => {
+        const instNorm = normalizeAff(inst);
+        return inputTokens.some((t) => instNorm.includes(t));
+    });
+}
+export const orcidResolveResearcher = tool('orcid_resolve_researcher', {
+    title: 'Resolve ORCID Researcher',
+    description: 'Disambiguate an author name to a verified ORCID iD. Returns up to 5 ranked candidates with transparent disambiguation signals: name match type (exact/partial/other-name/none), institution overlap flag, and whether a DOI or PMID anchor was used in the query. A DOI or PMID anchor is near-deterministic — it filters to researchers who have linked that specific work to their ORCID record. Use this tool (not orcid_search_researchers) when the input is an ambiguous name that needs ranked disambiguation. No synthetic scores are used — raw signals only.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        name: z
+            .string()
+            .min(1)
+            .describe('Author name to disambiguate (full name preferred, e.g. "Jennifer Doudna" or "J. Doudna").'),
+        affiliation: z
+            .string()
+            .optional()
+            .describe("Researcher's institution or organization name. Used for institution overlap scoring and optionally as a search constraint."),
+        doi: z
+            .string()
+            .optional()
+            .describe('DOI of a work authored by this researcher. Acts as a near-deterministic anchor — filters to researchers who linked this DOI to their ORCID record.'),
+        pmid: z
+            .string()
+            .optional()
+            .describe('PubMed ID of a work authored by this researcher. Acts as a near-deterministic anchor — filters to researchers who linked this PMID to their ORCID record.'),
+        rows: z
+            .number()
+            .int()
+            .min(1)
+            .max(20)
+            .default(5)
+            .describe('Maximum candidate count to return (1–20). Defaults to 5.'),
+    }),
+    output: z.object({
+        candidates: z
+            .array(z
+            .object({
+            orcidId: z.string().describe('Candidate ORCID iD (bare format).'),
+            orcidUri: z.string().describe('Full ORCID URI.'),
+            givenNames: z.string().optional().describe('Given names from the ORCID record.'),
+            familyNames: z.string().optional().describe('Family name from the ORCID record.'),
+            creditName: z.string().optional().describe('Published credit name, if set.'),
+            institutionNames: z
+                .array(z.string().describe('Institution name.'))
+                .describe('Affiliated institutions from the ORCID record.'),
+            nameMatchType: z
+                .enum(['exact', 'partial', 'other-name', 'none'])
+                .describe('How closely the candidate name matches the input name: exact (full match), partial (token overlap), other-name (match on alternate name), or none.'),
+            institutionOverlap: z
+                .boolean()
+                .describe("True when at least one of the candidate's institutions matches tokens from the provided affiliation parameter."),
+            anchorType: z
+                .enum(['doi', 'pmid', 'none'])
+                .describe('Type of identifier anchor used in the query: doi, pmid, or none. A doi or pmid anchor means the candidate has linked that work to their ORCID record.'),
+        })
+            .describe('Disambiguation candidate with transparency signals.'))
+            .describe('Ranked candidates, ordered by name match quality then institution overlap.'),
+        queryUsed: z.string().describe('Solr query sent to ORCID for the primary search.'),
+        relaxedQuery: z
+            .string()
+            .optional()
+            .describe('Solr query used in a secondary relaxed search, if the primary returned no results.'),
+        totalFound: z.number().describe('Total ORCID records matching the primary query.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Recovery hint when no candidates are found or when the anchor query failed to match.'),
+    }),
+    errors: [
+        {
+            reason: 'no_candidates',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No ORCID records matched even the relaxed query for this name.',
+            recovery: 'Try a different name spelling, use orcid_search_researchers with broader parameters, or verify the DOI/PMID is correct.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getOrcidService();
+        ctx.log.info('orcid_resolve_researcher', {
+            name: input.name,
+            hasAffiliation: !!input.affiliation,
+            hasDoi: !!input.doi,
+            hasPmid: !!input.pmid,
+        });
+        const anchorType = input.doi ? 'doi' : input.pmid ? 'pmid' : 'none';
+        // Build primary query: name + optional anchor + optional affiliation
+        const primaryClauses = [];
+        primaryClauses.push(`given-and-family-names:${input.name.trim()}`);
+        if (input.doi?.trim())
+            primaryClauses.push(`doi-self:${input.doi.trim()}`);
+        if (input.pmid?.trim())
+            primaryClauses.push(`pmid-self:${input.pmid.trim()}`);
+        if (input.affiliation?.trim()) {
+            primaryClauses.push(`affiliation-org-name:"${input.affiliation.trim()}"`);
+        }
+        const primaryQuery = primaryClauses.join(' AND ');
+        const primaryResponse = await service.expandedSearch({ q: primaryQuery, rows: input.rows }, ctx);
+        let relaxedQuery;
+        let finalResponse = primaryResponse;
+        // Relaxed fallback: drop affiliation constraint if primary returned nothing
+        if (primaryResponse.numFound === 0 && input.affiliation?.trim()) {
+            const relaxedClauses = primaryClauses.filter((c) => !c.startsWith('affiliation-org-name:'));
+            relaxedQuery = relaxedClauses.join(' AND ');
+            finalResponse = await service.expandedSearch({ q: relaxedQuery, rows: input.rows }, ctx);
+        }
+        // Second relaxed pass: if DOI/PMID anchor + affiliation both failed, try just DOI/PMID anchor
+        if (finalResponse.numFound === 0 && anchorType !== 'none') {
+            const prefix = anchorType === 'doi' ? 'doi-self:' : 'pmid-self:';
+            const anchorOnly = primaryClauses.find((c) => c.startsWith(prefix)) ?? '';
+            relaxedQuery = anchorOnly;
+            finalResponse = await service.expandedSearch({ q: anchorOnly, rows: input.rows }, ctx);
+        }
+        ctx.log.info('orcid_resolve_researcher completed', {
+            primaryFound: primaryResponse.numFound,
+            finalFound: finalResponse.numFound,
+            candidateCount: finalResponse.results.length,
+        });
+        // Score and sort candidates
+        const scored = finalResponse.results.map((r) => ({
+            candidate: r,
+            nameMatch: computeNameMatch(r, input.name),
+            instOverlap: computeInstitutionOverlap(r, input.affiliation),
+        }));
+        // Sort: exact > partial > other-name > none, then institution overlap within each tier
+        const matchOrder = ['exact', 'partial', 'other-name', 'none'];
+        scored.sort((a, b) => {
+            const aOrder = matchOrder.indexOf(a.nameMatch);
+            const bOrder = matchOrder.indexOf(b.nameMatch);
+            if (aOrder !== bOrder)
+                return aOrder - bOrder;
+            // Within same tier, institution overlap comes first
+            if (a.instOverlap !== b.instOverlap)
+                return a.instOverlap ? -1 : 1;
+            return 0;
+        });
+        const candidates = scored.map(({ candidate, nameMatch, instOverlap }) => ({
+            orcidId: candidate.orcidId,
+            orcidUri: `https://orcid.org/${candidate.orcidId}`,
+            ...(candidate.givenNames && { givenNames: candidate.givenNames }),
+            ...(candidate.familyNames && { familyNames: candidate.familyNames }),
+            ...(candidate.creditName && { creditName: candidate.creditName }),
+            institutionNames: candidate.institutionNames,
+            nameMatchType: nameMatch,
+            institutionOverlap: instOverlap,
+            anchorType,
+        }));
+        let notice;
+        if (candidates.length === 0) {
+            if (anchorType !== 'none') {
+                notice = `No ORCID records found matching "${input.name}" with the provided ${anchorType.toUpperCase()} anchor. Verify the ${anchorType.toUpperCase()} is correct or try without the anchor using orcid_search_researchers.`;
+            }
+            else {
+                notice = `No ORCID records found matching "${input.name}". Try a different spelling or use orcid_search_researchers with a broader query.`;
+            }
+        }
+        return {
+            candidates,
+            queryUsed: primaryQuery,
+            ...(relaxedQuery && { relaxedQuery }),
+            totalFound: finalResponse.numFound,
+            ...(notice && { notice }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## ORCID Disambiguation Results`,
+            `**Query:** \`${result.queryUsed}\``,
+            `**Total Matched:** ${result.totalFound}`,
+        ];
+        if (result.relaxedQuery) {
+            lines.push(`**Relaxed Query:** \`${result.relaxedQuery}\``);
+        }
+        if (result.notice) {
+            lines.push('', `> ${result.notice}`);
+        }
+        if (result.candidates.length === 0) {
+            lines.push('', 'No candidates found.');
+            return [{ type: 'text', text: lines.join('\n') }];
+        }
+        lines.push('', `**Candidates (${result.candidates.length}):**`);
+        result.candidates.forEach((c, i) => {
+            const nameParts = [c.givenNames, c.familyNames].filter(Boolean);
+            const displayName = c.creditName ?? (nameParts.length ? nameParts.join(' ') : c.orcidId);
+            lines.push('');
+            lines.push(`### ${i + 1}. ${displayName}`);
+            lines.push(`**ORCID iD:** ${c.orcidId}`);
+            lines.push(`**ORCID URI:** ${c.orcidUri}`);
+            if (c.givenNames)
+                lines.push(`**Given Names:** ${c.givenNames}`);
+            if (c.familyNames)
+                lines.push(`**Family Names:** ${c.familyNames}`);
+            if (c.creditName)
+                lines.push(`**Credit Name:** ${c.creditName}`);
+            lines.push(`**Name Match:** ${c.nameMatchType}`);
+            lines.push(`**Institution Overlap:** ${c.institutionOverlap ? 'Yes' : 'No'}`);
+            lines.push(`**Anchor Type:** ${c.anchorType}`);
+            if (c.institutionNames.length) {
+                lines.push(`**Institutions:** ${c.institutionNames.join('; ')}`);
+            }
+        });
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=resolve-researcher.tool.js.map

package/dist/mcp-server/tools/definitions/resolve-researcher.tool.js.map

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

package/dist/mcp-server/tools/definitions/search-researchers.tool.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @fileoverview Search the ORCID registry using structured field parameters or
+ * raw Solr syntax. Returns ORCID iDs with inline name and institution data.
+ * @module mcp-server/tools/definitions/search-researchers.tool
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+export declare const orcidSearchResearchers: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    given_name: z.ZodOptional<z.ZodString>;
+    family_name: z.ZodOptional<z.ZodString>;
+    affiliation: z.ZodOptional<z.ZodString>;
+    keyword: z.ZodOptional<z.ZodString>;
+    ror_id: z.ZodOptional<z.ZodString>;
+    doi: z.ZodOptional<z.ZodString>;
+    pmid: z.ZodOptional<z.ZodString>;
+    query: z.ZodOptional<z.ZodString>;
+    rows: z.ZodDefault<z.ZodNumber>;
+    start: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        orcidId: z.ZodString;
+        orcidUri: z.ZodString;
+        givenNames: z.ZodOptional<z.ZodString>;
+        familyNames: z.ZodOptional<z.ZodString>;
+        creditName: z.ZodOptional<z.ZodString>;
+        otherNames: z.ZodArray<z.ZodString>;
+        institutionNames: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    numFound: z.ZodNumber;
+    rows: z.ZodNumber;
+    start: z.ZodNumber;
+    effectiveQuery: z.ZodString;
+    notice: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, readonly [{
+    readonly reason: "no_results";
+    readonly code: JsonRpcErrorCode.NotFound;
+    readonly when: "No ORCID records matched the search query.";
+    readonly recovery: "Broaden the query — try fewer constraints, check spelling, or use the query field with Solr syntax.";
+}]>;
+//# sourceMappingURL=search-researchers.tool.d.ts.map

package/dist/mcp-server/tools/definitions/search-researchers.tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-researchers.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-researchers.tool.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AA6CjE,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoLjC,CAAC"}

package/dist/mcp-server/tools/definitions/search-researchers.tool.js

@@ -0,0 +1,192 @@
+/**
+ * @fileoverview Search the ORCID registry using structured field parameters or
+ * raw Solr syntax. Returns ORCID iDs with inline name and institution data.
+ * @module mcp-server/tools/definitions/search-researchers.tool
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { JsonRpcErrorCode } from '@cyanheads/mcp-ts-core/errors';
+import { getOrcidService } from '../../../services/orcid/orcid-service.js';
+/** Build a Solr query string from structured search parameters. */
+function buildSolrQuery(input) {
+    const clauses = [];
+    if (input.given_name?.trim()) {
+        clauses.push(`given-names:${input.given_name.trim()}`);
+    }
+    if (input.family_name?.trim()) {
+        clauses.push(`family-name:${input.family_name.trim()}`);
+    }
+    if (input.affiliation?.trim()) {
+        clauses.push(`affiliation-org-name:"${input.affiliation.trim()}"`);
+    }
+    if (input.keyword?.trim()) {
+        clauses.push(`keyword:"${input.keyword.trim()}"`);
+    }
+    if (input.ror_id?.trim()) {
+        // ROR IDs contain colons and must be quoted in Solr
+        clauses.push(`ror-org-id:"${input.ror_id.trim()}"`);
+    }
+    if (input.doi?.trim()) {
+        clauses.push(`doi-self:${input.doi.trim()}`);
+    }
+    if (input.pmid?.trim()) {
+        clauses.push(`pmid-self:${input.pmid.trim()}`);
+    }
+    if (input.query?.trim()) {
+        clauses.push(input.query.trim());
+    }
+    return clauses.join(' AND ') || '*:*';
+}
+export const orcidSearchResearchers = tool('orcid_search_researchers', {
+    title: 'Search ORCID Researchers',
+    description: 'Search the ORCID registry using structured field parameters or raw Solr syntax. All provided structured params are ANDed together. The `query` field appends raw Solr syntax to the generated clause. Returns ORCID iDs with inline name and institution data — no follow-up profile fetches needed for basic disambiguation. For ranked disambiguation of an ambiguous author name, use orcid_resolve_researcher instead. The ORCID Public API caps results at 10,000 — use pagination for large result sets.',
+    annotations: { readOnlyHint: true, openWorldHint: true, idempotentHint: true },
+    input: z.object({
+        given_name: z.string().optional().describe("Researcher's given (first) name."),
+        family_name: z.string().optional().describe("Researcher's family (last) name."),
+        affiliation: z.string().optional().describe('Organization name to filter by. Phrase match.'),
+        keyword: z
+            .string()
+            .optional()
+            .describe("Keyword to search in the researcher's keyword fields. Phrase match."),
+        ror_id: z
+            .string()
+            .optional()
+            .describe('ROR organization ID to filter by (full URL, e.g. https://ror.org/00f54p054). Returns researchers affiliated with this organization.'),
+        doi: z
+            .string()
+            .optional()
+            .describe('DOI to anchor the search. Returns researchers who have linked this DOI to their ORCID record.'),
+        pmid: z
+            .string()
+            .optional()
+            .describe('PubMed ID to anchor the search. Returns researchers who have linked this PMID to their ORCID record.'),
+        query: z
+            .string()
+            .optional()
+            .describe('Raw Solr query string appended to the generated clause with AND. Supports all ORCID Solr fields and boolean operators.'),
+        rows: z
+            .number()
+            .int()
+            .min(1)
+            .max(1000)
+            .default(20)
+            .describe('Maximum results to return (1–1000).'),
+        start: z
+            .number()
+            .int()
+            .min(0)
+            .default(0)
+            .describe('Pagination offset (0-based). ORCID Public API caps at 10,000 total results.'),
+    }),
+    output: z.object({
+        results: z
+            .array(z
+            .object({
+            orcidId: z.string().describe('ORCID iD (bare format).'),
+            orcidUri: z.string().describe('Full ORCID URI.'),
+            givenNames: z.string().optional().describe('Given names from the ORCID record.'),
+            familyNames: z.string().optional().describe('Family name from the ORCID record.'),
+            creditName: z.string().optional().describe('Published credit name, if set.'),
+            otherNames: z
+                .array(z.string().describe('Alternative name.'))
+                .describe('Other names listed on the ORCID record.'),
+            institutionNames: z
+                .array(z.string().describe('Institution name.'))
+                .describe('Affiliated institution names returned by expanded-search.'),
+        })
+            .describe('Expanded search result for one researcher.'))
+            .describe('Matching researchers with inline name and institution data.'),
+        numFound: z.number().describe('Total number of matching records in ORCID (before pagination).'),
+        rows: z.number().describe('Number of results returned in this response.'),
+        start: z.number().describe('Pagination offset used for this response.'),
+        effectiveQuery: z.string().describe('Solr query sent to the ORCID API.'),
+        notice: z
+            .string()
+            .optional()
+            .describe('Recovery hint when results are empty or pagination overshoots the total. Absent on successful pages.'),
+    }),
+    errors: [
+        {
+            reason: 'no_results',
+            code: JsonRpcErrorCode.NotFound,
+            when: 'No ORCID records matched the search query.',
+            recovery: 'Broaden the query — try fewer constraints, check spelling, or use the query field with Solr syntax.',
+        },
+    ],
+    async handler(input, ctx) {
+        const service = getOrcidService();
+        const effectiveQuery = buildSolrQuery(input);
+        ctx.log.info('orcid_search_researchers', {
+            effectiveQuery,
+            rows: input.rows,
+            start: input.start,
+        });
+        const response = await service.expandedSearch({ q: effectiveQuery, rows: input.rows, start: input.start }, ctx);
+        ctx.log.info('orcid_search_researchers completed', {
+            numFound: response.numFound,
+            returned: response.results.length,
+        });
+        let notice;
+        if (response.numFound === 0) {
+            notice =
+                'No results found. Try fewer constraints, verify spelling, or use the query field with Solr syntax.';
+        }
+        else if (response.results.length === 0 &&
+            input.start > 0 &&
+            input.start >= response.numFound) {
+            notice = `Offset ${input.start} exceeds numFound (${response.numFound}). Reduce start to page through results.`;
+        }
+        return {
+            results: response.results.map((r) => ({
+                orcidId: r.orcidId,
+                orcidUri: `https://orcid.org/${r.orcidId}`,
+                ...(r.givenNames && { givenNames: r.givenNames }),
+                ...(r.familyNames && { familyNames: r.familyNames }),
+                ...(r.creditName && { creditName: r.creditName }),
+                otherNames: r.otherNames,
+                institutionNames: r.institutionNames,
+            })),
+            numFound: response.numFound,
+            rows: response.results.length,
+            start: input.start,
+            effectiveQuery,
+            ...(notice && { notice }),
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `## ORCID Search Results`,
+            `**Query:** \`${result.effectiveQuery}\``,
+            `**Total Found:** ${result.numFound} | **Returned:** ${result.rows} | **Offset:** ${result.start}`,
+        ];
+        if (result.notice) {
+            lines.push('', `> ${result.notice}`);
+        }
+        if (result.results.length === 0) {
+            lines.push('', 'No results.');
+        }
+        else {
+            lines.push('');
+            for (const r of result.results) {
+                const nameParts = [r.givenNames, r.familyNames].filter(Boolean);
+                const displayName = r.creditName ?? (nameParts.length ? nameParts.join(' ') : r.orcidId);
+                lines.push(`### ${displayName}`);
+                lines.push(`**ORCID iD:** ${r.orcidId}`);
+                lines.push(`**ORCID URI:** ${r.orcidUri}`);
+                if (r.givenNames || r.familyNames) {
+                    lines.push(`**Name:** ${[r.givenNames, r.familyNames].filter(Boolean).join(' ')}`);
+                }
+                if (r.creditName)
+                    lines.push(`**Credit Name:** ${r.creditName}`);
+                if (r.otherNames.length)
+                    lines.push(`**Other Names:** ${r.otherNames.join(', ')}`);
+                if (r.institutionNames.length) {
+                    lines.push(`**Institutions:** ${r.institutionNames.join('; ')}`);
+                }
+                lines.push('');
+            }
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=search-researchers.tool.js.map

package/dist/mcp-server/tools/definitions/search-researchers.tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-researchers.tool.js","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/search-researchers.tool.ts"],"names":[],"mappings":"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"}

package/dist/services/orcid/normalizers.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview Normalization functions that convert raw ORCID API shapes to
+ * typed domain objects. Preserves absence as unknown rather than inventing defaults.
+ * @module services/orcid/normalizers
+ */
+import type { AffiliationType } from './orcid-service.js';
+import type { Affiliation, ExpandedSearchResponse, ExternalIdentifier, FundingRecord, PeerReview, RawActivities, RawExpandedSearchResponse, RawFundingsResponse, RawPeerReviewsResponse, RawPerson, RawWorksResponse, Work } from './types.js';
+/** Normalized person fields returned from /person endpoint. */
+export type NormalizedPerson = {
+    givenNames?: string;
+    familyName?: string;
+    creditName?: string;
+    biography?: string;
+    keywords: string[];
+    researcherUrls: Array<{
+        name?: string;
+        url: string;
+    }>;
+    externalIdentifiers: ExternalIdentifier[];
+    emails: Array<{
+        email: string;
+        primary?: boolean;
+    }>;
+    countries: string[];
+};
+export declare function normalizePerson(raw: RawPerson): NormalizedPerson;
+export declare function normalizeWorks(raw: RawWorksResponse): Work[];
+export declare function normalizeActivities(raw: RawActivities, types: AffiliationType[]): Affiliation[];
+export declare function normalizeFundings(raw: RawFundingsResponse): FundingRecord[];
+export declare function normalizePeerReviews(raw: RawPeerReviewsResponse): PeerReview[];
+export declare function normalizeExpandedSearch(raw: RawExpandedSearchResponse): ExpandedSearchResponse;
+//# sourceMappingURL=normalizers.d.ts.map

package/dist/services/orcid/normalizers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalizers.d.ts","sourceRoot":"","sources":["../../../src/services/orcid/normalizers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EAEtB,kBAAkB,EAClB,aAAa,EAIb,UAAU,EACV,aAAa,EAGb,yBAAyB,EAIzB,mBAAmB,EAGnB,sBAAsB,EACtB,SAAS,EAIT,gBAAgB,EAChB,IAAI,EACL,MAAM,YAAY,CAAC;AAiFpB,+DAA+D;AAC/D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,cAAc,EAAE,KAAK,CAAC;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtD,mBAAmB,EAAE,kBAAkB,EAAE,CAAC;IAC1C,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF,wBAAgB,eAAe,CAAC,GAAG,EAAE,SAAS,GAAG,gBAAgB,CAiDhE;AAeD,wBAAgB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,EAAE,CAO5D;AAwBD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,eAAe,EAAE,GAAG,WAAW,EAAE,CAY/F;AAmBD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,mBAAmB,GAAG,aAAa,EAAE,CAI3E;AAED,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,sBAAsB,GAAG,UAAU,EAAE,CAsB9E;AAED,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,yBAAyB,GAAG,sBAAsB,CAkB9F"}