@debriefer/sources 1.0.1

package/dist/shared/sanitize-text.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Final safety-net text sanitization.
+ *
+ * Runs on source text before AI prompt assembly, catching remaining
+ * artifacts regardless of source (Wikipedia footnotes, navigation text,
+ * boilerplate phrases, etc.). This is the last line of defense against
+ * noisy input reaching the synthesis step.
+ */
+/**
+ * Sanitize source text before sending to an AI model for synthesis.
+ *
+ * Catches remaining artifacts from any source:
+ * - Wikipedia citation markers ([1], [2][3])
+ * - Editorial tags ([edit], [citation needed])
+ * - Footnote reference lines (lines starting with ^)
+ * - Navigation-like pipe-separated text (e.g., "News | Sports | Weather")
+ * - Common web boilerplate (sign in, subscribe, cookie policy)
+ * - Excess whitespace and blank lines
+ *
+ * @param text - Raw source text to sanitize
+ * @returns Cleaned text ready for prompt assembly
+ */
+export declare function sanitizeSourceText(text: string): string;
+//# sourceMappingURL=sanitize-text.d.ts.map

package/dist/shared/sanitize-text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-text.d.ts","sourceRoot":"","sources":["../../src/shared/sanitize-text.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAsCvD"}

package/dist/shared/sanitize-text.js

@@ -0,0 +1,49 @@
+/**
+ * Final safety-net text sanitization.
+ *
+ * Runs on source text before AI prompt assembly, catching remaining
+ * artifacts regardless of source (Wikipedia footnotes, navigation text,
+ * boilerplate phrases, etc.). This is the last line of defense against
+ * noisy input reaching the synthesis step.
+ */
+/**
+ * Sanitize source text before sending to an AI model for synthesis.
+ *
+ * Catches remaining artifacts from any source:
+ * - Wikipedia citation markers ([1], [2][3])
+ * - Editorial tags ([edit], [citation needed])
+ * - Footnote reference lines (lines starting with ^)
+ * - Navigation-like pipe-separated text (e.g., "News | Sports | Weather")
+ * - Common web boilerplate (sign in, subscribe, cookie policy)
+ * - Excess whitespace and blank lines
+ *
+ * @param text - Raw source text to sanitize
+ * @returns Cleaned text ready for prompt assembly
+ */
+export function sanitizeSourceText(text) {
+    let cleaned = text;
+    // 1. Strip Wikipedia citation markers (with and without spaces)
+    cleaned = cleaned.replace(/\[\s*\d+\s*\]/g, "");
+    // 2. Strip [edit], [citation needed], etc.
+    cleaned = cleaned.replace(/\[\s*(?:edit|citation needed|clarification needed|when\?|who\?|where\?|dubious|discuss|further explanation needed|original research\??|not in citation given|failed verification|unreliable source\??|needs? update|verification needed)\s*\]/gi, "");
+    // 3. Strip Wikipedia footnote blocks (lines starting with ^)
+    cleaned = cleaned.replace(/^\s*\^[^\n]+$/gm, "");
+    // 4. Strip navigation-like text patterns:
+    //    pipe-separated short items (e.g. "News | Sports | Weather | ...")
+    /* eslint-disable-next-line security/detect-unsafe-regex --
+       Bounded quantifier on short pipe-separated nav text; no backtracking risk */
+    const navPattern = /^(?:[A-Z][a-z]+\s*\|\s*){3,}[A-Z][a-z]+\s*$/gm;
+    cleaned = cleaned.replace(navPattern, "");
+    // 5. Strip common boilerplate phrases
+    cleaned = cleaned.replace(/\b(?:Sign [Ii]n|Sign [Uu]p|Subscribe|Newsletter|Cookie [Pp]olicy|Privacy [Pp]olicy|Terms (?:of|and) (?:Service|Use)|Accept (?:All )?Cookies|Manage Preferences)\b[^\n]*/g, "");
+    // 6. Collapse whitespace
+    cleaned = cleaned.replace(/\n{3,}/g, "\n\n");
+    cleaned = cleaned.replace(/[ \t]+/g, " ");
+    cleaned = cleaned
+        .split("\n")
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0)
+        .join("\n");
+    return cleaned.trim();
+}
+//# sourceMappingURL=sanitize-text.js.map

package/dist/shared/sanitize-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-text.js","sourceRoot":"","sources":["../../src/shared/sanitize-text.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,IAAI,OAAO,GAAG,IAAI,CAAA;IAElB,gEAAgE;IAChE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAA;IAE/C,2CAA2C;IAC3C,OAAO,GAAG,OAAO,CAAC,OAAO,CACvB,iPAAiP,EACjP,EAAE,CACH,CAAA;IAED,6DAA6D;IAC7D,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAA;IAEhD,0CAA0C;IAC1C,uEAAuE;IACvE;mFAC+E;IAC/E,MAAM,UAAU,GAAG,+CAA+C,CAAA;IAClE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAA;IAEzC,sCAAsC;IACtC,OAAO,GAAG,OAAO,CAAC,OAAO,CACvB,0KAA0K,EAC1K,EAAE,CACH,CAAA;IAED,yBAAyB;IACzB,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAA;IAC5C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAA;IACzC,OAAO,GAAG,OAAO;SACd,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,IAAI,CAAC,IAAI,CAAC,CAAA;IAEb,OAAO,OAAO,CAAC,IAAI,EAAE,CAAA;AACvB,CAAC"}

package/dist/shared/search-utils.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Search query utilities.
+ *
+ * Helpers for splitting and normalizing search strings, used by sources
+ * that need multi-word ILIKE matching or search term tokenization.
+ */
+/**
+ * Split a search string into individual words for multi-word matching.
+ *
+ * Trims leading/trailing whitespace, splits on one or more whitespace
+ * characters, and filters out empty strings. Returns an empty array
+ * for blank or whitespace-only input.
+ *
+ * @param query - Search string to split
+ * @returns Array of individual search words
+ */
+export declare function splitSearchWords(query: string): string[];
+//# sourceMappingURL=search-utils.d.ts.map

package/dist/shared/search-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-utils.d.ts","sourceRoot":"","sources":["../../src/shared/search-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}

package/dist/shared/search-utils.js

@@ -0,0 +1,20 @@
+/**
+ * Search query utilities.
+ *
+ * Helpers for splitting and normalizing search strings, used by sources
+ * that need multi-word ILIKE matching or search term tokenization.
+ */
+/**
+ * Split a search string into individual words for multi-word matching.
+ *
+ * Trims leading/trailing whitespace, splits on one or more whitespace
+ * characters, and filters out empty strings. Returns an empty array
+ * for blank or whitespace-only input.
+ *
+ * @param query - Search string to split
+ * @returns Array of individual search words
+ */
+export function splitSearchWords(query) {
+    return query.trim().split(/\s+/).filter(Boolean);
+}
+//# sourceMappingURL=search-utils.js.map

package/dist/shared/search-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-utils.js","sourceRoot":"","sources":["../../src/shared/search-utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;AAClD,CAAC"}

package/dist/structured/wikidata.d.ts

@@ -0,0 +1,128 @@
+/**
+ * Generic Wikidata SPARQL source for structured data.
+ *
+ * Queries Wikidata's SPARQL endpoint to retrieve structured facts about
+ * a research subject. Domain-agnostic: consumers customize the SPARQL query
+ * via the `queryBuilder` option and control what properties to extract.
+ *
+ * Default query searches by name with an optional birth year filter,
+ * returning basic identity properties (labels, descriptions, Wikipedia links).
+ * Consumers can provide a custom `queryBuilder` for domain-specific properties
+ * (e.g., cause of death P509, education P69, occupation P106).
+ */
+import { BaseResearchSource, ReliabilityTier, type BaseSourceOptions, type ResearchSubject, type RawFinding } from "@debriefer/core";
+/**
+ * Escape a string for use in a SPARQL string literal.
+ * Escapes backslashes first, then double quotes, to prevent injection.
+ */
+export declare function escapeSparql(str: string): string;
+/**
+ * Check if a Wikidata label value is valid (not a URL, blank node, or raw entity ID).
+ * Wikidata sometimes returns genid URLs instead of actual labels when the value
+ * is a complex statement or blank node.
+ */
+export declare function isValidLabel(value: string | undefined): value is string;
+/**
+ * Get a valid label value or null if invalid.
+ */
+export declare function getValidLabel(value: string | undefined): string | null;
+/**
+ * Filter a comma-separated string of labels, removing invalid entries.
+ * Returns null if no valid labels remain.
+ */
+export declare function filterValidLabels(concatenated: string | undefined): string | null;
+/** A single binding (row) from a SPARQL response */
+export interface SparqlBinding {
+    [key: string]: {
+        value: string;
+        type?: string;
+    } | undefined;
+}
+/** Standard SPARQL JSON response format */
+export interface SparqlResponse {
+    results: {
+        bindings: SparqlBinding[];
+    };
+}
+/**
+ * Function that builds a SPARQL query for a given research subject.
+ * The subject's `context` bag may contain domain-specific fields
+ * (e.g., `birthYear`, `deathYear`) for more targeted queries.
+ */
+export type SparqlQueryBuilder = (subject: ResearchSubject) => string;
+/**
+ * Function that parses SPARQL bindings into a text string and confidence score.
+ * Returns null if no relevant data was found in the bindings.
+ */
+export type SparqlResultParser = (bindings: SparqlBinding[], subject: ResearchSubject) => {
+    text: string;
+    confidence: number;
+    metadata?: Record<string, unknown>;
+} | null;
+/** Options for the Wikidata source */
+export interface WikidataOptions extends BaseSourceOptions {
+    /** Custom SPARQL query builder. Default searches by name. */
+    queryBuilder?: SparqlQueryBuilder;
+    /** Custom result parser. Default formats all bindings as key: value text. */
+    resultParser?: SparqlResultParser;
+    /** User-Agent string for Wikidata API requests. */
+    userAgent?: string;
+    /** Maximum retries on 429/5xx responses (default: 3) */
+    maxRetries?: number;
+}
+/**
+ * Wikidata SPARQL source for structured research data.
+ *
+ * Queries Wikidata for structured facts about a subject. Consumers customize
+ * what data is queried via `queryBuilder` and how results are parsed via
+ * `resultParser`. Ships with sensible defaults that search by person name.
+ */
+export declare class WikidataSource extends BaseResearchSource<ResearchSubject> {
+    readonly name = "Wikidata";
+    readonly type = "wikidata";
+    readonly reliabilityTier = ReliabilityTier.STRUCTURED_DATA;
+    readonly domain = "query.wikidata.org";
+    readonly isFree = true;
+    readonly estimatedCostPerQuery = 0;
+    private queryBuilder;
+    private resultParser;
+    private userAgent;
+    private maxRetries;
+    constructor(options?: WikidataOptions);
+    protected fetchResult(subject: ResearchSubject, signal: AbortSignal): Promise<RawFinding | null>;
+    /**
+     * Build the search query for cache key generation.
+     * Uses the actual SPARQL query (truncated) so different queryBuilders
+     * don't collide in cache. Falls back to name + birth year for the default builder.
+     */
+    buildQuery(subject: ResearchSubject): string;
+    /**
+     * Fetch SPARQL results with retry on 429/5xx responses.
+     * Uses exponential backoff: 2s, 4s, 8s.
+     */
+    private fetchWithRetry;
+}
+/**
+ * Create a Wikidata SPARQL source instance.
+ *
+ * @example
+ * ```typescript
+ * // Default: search by name, return basic info
+ * const source = wikidata()
+ *
+ * // Custom: death-specific query
+ * const deathSource = wikidata({
+ *   queryBuilder: (subject) => {
+ *     const name = escapeSparql(subject.name)
+ *     const deathYear = subject.context?.deathYear as number
+ *     return `SELECT ... WHERE { ... }`
+ *   },
+ *   resultParser: (bindings, subject) => {
+ *     // Extract cause of death, manner, location...
+ *     return { text: "...", confidence: 0.8 }
+ *   },
+ * })
+ * ```
+ */
+export declare function wikidata(options?: WikidataOptions): WikidataSource;
+//# sourceMappingURL=wikidata.d.ts.map

package/dist/structured/wikidata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wikidata.d.ts","sourceRoot":"","sources":["../../src/structured/wikidata.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,UAAU,EAChB,MAAM,iBAAiB,CAAA;AAexB;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAOhD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,KAAK,IAAI,MAAM,CAMvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAEtE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAIjF;AAMD,oDAAoD;AACpD,MAAM,WAAW,aAAa;IAC5B,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAA;CAC5D;AAED,2CAA2C;AAC3C,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE;QACP,QAAQ,EAAE,aAAa,EAAE,CAAA;KAC1B,CAAA;CACF;AAED;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,MAAM,CAAA;AAErE;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,QAAQ,EAAE,aAAa,EAAE,EACzB,OAAO,EAAE,eAAe,KACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,IAAI,CAAA;AAEpF,sCAAsC;AACtC,MAAM,WAAW,eAAgB,SAAQ,iBAAiB;IACxD,6DAA6D;IAC7D,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,6EAA6E;IAC7E,YAAY,CAAC,EAAE,kBAAkB,CAAA;IACjC,mDAAmD;IACnD,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,wDAAwD;IACxD,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAyID;;;;;;GAMG;AACH,qBAAa,cAAe,SAAQ,kBAAkB,CAAC,eAAe,CAAC;IACrE,QAAQ,CAAC,IAAI,cAAa;IAC1B,QAAQ,CAAC,IAAI,cAAa;IAC1B,QAAQ,CAAC,eAAe,mCAAkC;IAC1D,QAAQ,CAAC,MAAM,wBAAuB;IACtC,QAAQ,CAAC,MAAM,QAAO;IACtB,QAAQ,CAAC,qBAAqB,KAAI;IAElC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,UAAU,CAAQ;gBAEd,OAAO,GAAE,eAAoB;cAQzB,WAAW,CACzB,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IA4B7B;;;;OAIG;IACM,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,MAAM;IAqBrD;;;OAGG;YACW,cAAc;CA+D7B;AAMD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,cAAc,CAElE"}

package/dist/structured/wikidata.js

@@ -0,0 +1,361 @@
+/**
+ * Generic Wikidata SPARQL source for structured data.
+ *
+ * Queries Wikidata's SPARQL endpoint to retrieve structured facts about
+ * a research subject. Domain-agnostic: consumers customize the SPARQL query
+ * via the `queryBuilder` option and control what properties to extract.
+ *
+ * Default query searches by name with an optional birth year filter,
+ * returning basic identity properties (labels, descriptions, Wikipedia links).
+ * Consumers can provide a custom `queryBuilder` for domain-specific properties
+ * (e.g., cause of death P509, education P69, occupation P106).
+ */
+import { createHash } from "node:crypto";
+import { BaseResearchSource, ReliabilityTier, } from "@debriefer/core";
+// ============================================================================
+// Constants
+// ============================================================================
+const WIKIDATA_ENDPOINT = "https://query.wikidata.org/sparql";
+const MAX_RETRIES = 3;
+const RETRY_BASE_DELAY_MS = 2000;
+const DEFAULT_USER_AGENT = "debriefer/0.1.0 (https://github.com/chenders/debriefer)";
+// ============================================================================
+// SPARQL Helpers
+// ============================================================================
+/**
+ * Escape a string for use in a SPARQL string literal.
+ * Escapes backslashes first, then double quotes, to prevent injection.
+ */
+export function escapeSparql(str) {
+    return str
+        .replace(/\\/g, "\\\\")
+        .replace(/"/g, '\\"')
+        .replace(/\n/g, "\\n")
+        .replace(/\r/g, "\\r")
+        .replace(/\t/g, "\\t");
+}
+/**
+ * Check if a Wikidata label value is valid (not a URL, blank node, or raw entity ID).
+ * Wikidata sometimes returns genid URLs instead of actual labels when the value
+ * is a complex statement or blank node.
+ */
+export function isValidLabel(value) {
+    if (!value)
+        return false;
+    if (value.startsWith("http://") || value.startsWith("https://"))
+        return false;
+    if (value.includes("genid"))
+        return false;
+    if (/^Q\d+$/.test(value))
+        return false;
+    return true;
+}
+/**
+ * Get a valid label value or null if invalid.
+ */
+export function getValidLabel(value) {
+    return isValidLabel(value) ? value : null;
+}
+/**
+ * Filter a comma-separated string of labels, removing invalid entries.
+ * Returns null if no valid labels remain.
+ */
+export function filterValidLabels(concatenated) {
+    if (!concatenated)
+        return null;
+    const labels = concatenated.split(/\s*,\s*/).filter((label) => isValidLabel(label));
+    return labels.length > 0 ? labels.join(", ") : null;
+}
+// ============================================================================
+// Default Query Builder
+// ============================================================================
+/**
+ * Default SPARQL query builder that searches for a person by name.
+ * If the subject context includes `birthYear`, filters by birth year for disambiguation.
+ * Returns label, description, and English Wikipedia article link.
+ */
+function defaultQueryBuilder(subject) {
+    const escapedName = escapeSparql(subject.name);
+    const rawBirthYear = subject.context?.birthYear;
+    const parsedBirthYear = typeof rawBirthYear === "number" && Number.isFinite(rawBirthYear)
+        ? rawBirthYear
+        : typeof rawBirthYear === "string"
+            ? parseInt(rawBirthYear, 10)
+            : undefined;
+    const validBirthYear = parsedBirthYear !== undefined && Number.isFinite(parsedBirthYear) ? parsedBirthYear : undefined;
+    const birthFilter = validBirthYear
+        ? `?person wdt:P569 ?birthDate .
+       FILTER(YEAR(?birthDate) = ${validBirthYear})`
+        : "";
+    return `
+    SELECT ?person ?personLabel ?personDescription ?article
+    WHERE {
+      ?person wdt:P31 wd:Q5 .
+      ?person rdfs:label "${escapedName}"@en .
+      ${birthFilter}
+
+      OPTIONAL {
+        ?article schema:about ?person .
+        ?article schema:isPartOf <https://en.wikipedia.org/> .
+      }
+
+      SERVICE wikibase:label { bd:serviceParam wikibase:language "en". }
+    }
+    LIMIT 5
+  `;
+}
+// ============================================================================
+// Default Result Parser
+// ============================================================================
+/**
+ * Default result parser that extracts person label, description, and Wikipedia URL.
+ * Formats them as plain text with a base confidence of 0.5.
+ */
+function defaultResultParser(bindings, subject) {
+    if (bindings.length === 0)
+        return null;
+    // Find the first binding whose label matches the subject name
+    for (const binding of bindings) {
+        const personName = binding.personLabel?.value ?? "";
+        if (!isNameMatch(subject.name, personName))
+            continue;
+        const lines = [];
+        const label = getValidLabel(binding.personLabel?.value);
+        const description = binding.personDescription?.value;
+        const articleUrl = binding.article?.value;
+        if (label)
+            lines.push(`Name: ${label}`);
+        if (description)
+            lines.push(`Description: ${description}`);
+        if (articleUrl)
+            lines.push(`Wikipedia: ${articleUrl}`);
+        // Add all other non-standard fields
+        for (const [key, val] of Object.entries(binding)) {
+            if (["person", "personLabel", "personDescription", "article"].includes(key))
+                continue;
+            const labelValue = getValidLabel(val?.value);
+            if (labelValue) {
+                const readableKey = key
+                    .replace(/Label$/, "")
+                    .replace(/([A-Z])/g, " $1")
+                    .trim();
+                lines.push(`${readableKey}: ${labelValue}`);
+            }
+        }
+        if (lines.length === 0)
+            continue;
+        return {
+            text: lines.join("\n"),
+            confidence: 0.5 + Math.min(0.3, (lines.length - 1) * 0.1),
+            metadata: { entityUrl: binding.person?.value, articleUrl },
+        };
+    }
+    return null;
+}
+// ============================================================================
+// Name Matching
+// ============================================================================
+/**
+ * Check if two names match, handling common variations.
+ * Normalizes to lowercase ASCII and checks for exact match, substring
+ * containment, or last-name + first-initial match.
+ *
+ * Note: Normalization strips non-ASCII characters (accents, diacritics),
+ * which works for most Western names but may cause false matches for
+ * names that differ only in diacritics.
+ */
+function isNameMatch(name1, name2) {
+    const normalize = (s) => s.toLowerCase().replace(/[^a-z]/g, "");
+    const norm1 = normalize(name1);
+    const norm2 = normalize(name2);
+    if (norm1 === norm2)
+        return true;
+    if (norm1.includes(norm2) || norm2.includes(norm1))
+        return true;
+    // Last name + first initial match (avoids "John Smith" matching "Mary Smith")
+    const parts1 = name1.toLowerCase().split(/\s+/);
+    const parts2 = name2.toLowerCase().split(/\s+/);
+    if (parts1.length < 2 || parts2.length < 2)
+        return false;
+    const last1 = parts1[parts1.length - 1];
+    const last2 = parts2[parts2.length - 1];
+    if (last1 !== last2)
+        return false;
+    // Require first initial to match
+    return parts1[0][0] === parts2[0][0];
+}
+// ============================================================================
+// Source Implementation
+// ============================================================================
+/**
+ * Wikidata SPARQL source for structured research data.
+ *
+ * Queries Wikidata for structured facts about a subject. Consumers customize
+ * what data is queried via `queryBuilder` and how results are parsed via
+ * `resultParser`. Ships with sensible defaults that search by person name.
+ */
+export class WikidataSource extends BaseResearchSource {
+    name = "Wikidata";
+    type = "wikidata";
+    reliabilityTier = ReliabilityTier.STRUCTURED_DATA;
+    domain = "query.wikidata.org";
+    isFree = true;
+    estimatedCostPerQuery = 0;
+    queryBuilder;
+    resultParser;
+    userAgent;
+    maxRetries;
+    constructor(options = {}) {
+        super({ rateLimitMs: 500, ...options });
+        this.queryBuilder = options.queryBuilder ?? defaultQueryBuilder;
+        this.resultParser = options.resultParser ?? defaultResultParser;
+        this.userAgent = options.userAgent ?? DEFAULT_USER_AGENT;
+        this.maxRetries = options.maxRetries ?? MAX_RETRIES;
+    }
+    async fetchResult(subject, signal) {
+        const query = this.queryBuilder(subject);
+        const data = await this.fetchWithRetry(query, signal);
+        if (!data)
+            return null;
+        const parsed = this.resultParser(data.results.bindings, subject);
+        if (!parsed)
+            return null;
+        // Build URL — use Wikipedia article URL if available, otherwise Wikidata entity
+        const entityUrl = parsed.metadata?.entityUrl;
+        const articleUrl = parsed.metadata?.articleUrl;
+        const url = articleUrl ?? entityUrl;
+        return {
+            text: parsed.text,
+            confidence: parsed.confidence,
+            costUsd: 0,
+            url,
+            publication: "Wikidata",
+            metadata: {
+                ...parsed.metadata,
+                sparqlQuery: query,
+                bindingCount: data.results.bindings.length,
+            },
+        };
+    }
+    /**
+     * Build the search query for cache key generation.
+     * Uses the actual SPARQL query (truncated) so different queryBuilders
+     * don't collide in cache. Falls back to name + birth year for the default builder.
+     */
+    buildQuery(subject) {
+        if (this.queryBuilder !== defaultQueryBuilder) {
+            // Custom queryBuilder: hash the full SPARQL query for a collision-resistant cache key
+            const query = this.queryBuilder(subject);
+            return createHash("sha256").update(query).digest("hex").slice(0, 16);
+        }
+        // Default builder: name + validated birth year (number or numeric string,
+        // matching the same parsing logic used in defaultQueryBuilder)
+        const rawBirthYear = subject.context?.birthYear;
+        let birthYear;
+        if (typeof rawBirthYear === "number" && Number.isFinite(rawBirthYear)) {
+            birthYear = rawBirthYear;
+        }
+        else if (typeof rawBirthYear === "string") {
+            const parsed = parseInt(rawBirthYear, 10);
+            if (Number.isFinite(parsed)) {
+                birthYear = parsed;
+            }
+        }
+        return birthYear !== undefined ? `${subject.name}:${birthYear}` : subject.name;
+    }
+    /**
+     * Fetch SPARQL results with retry on 429/5xx responses.
+     * Uses exponential backoff: 2s, 4s, 8s.
+     */
+    async fetchWithRetry(query, signal) {
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            try {
+                const response = await fetch(`${WIKIDATA_ENDPOINT}?query=${encodeURIComponent(query)}`, {
+                    headers: {
+                        Accept: "application/sparql-results+json",
+                        "User-Agent": this.userAgent,
+                    },
+                    signal,
+                });
+                if ((response.status === 429 || response.status >= 500) && attempt < this.maxRetries) {
+                    if (signal.aborted)
+                        throw new DOMException("Aborted", "AbortError");
+                    const delay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+                    await new Promise((resolve, reject) => {
+                        const onAbort = () => {
+                            clearTimeout(timer);
+                            reject(signal.reason);
+                        };
+                        const timer = setTimeout(() => {
+                            signal.removeEventListener("abort", onAbort);
+                            resolve();
+                        }, delay);
+                        signal.addEventListener("abort", onAbort, { once: true });
+                    });
+                    continue;
+                }
+                if (!response.ok) {
+                    // 404 = subject not found, return null. Other errors should propagate
+                    // for telemetry recording via BaseResearchSource.lookup()
+                    if (response.status === 404)
+                        return null;
+                    throw new Error(`Wikidata SPARQL request failed: ${response.status} ${response.statusText}`);
+                }
+                return (await response.json());
+            }
+            catch (error) {
+                // Don't retry abort errors
+                if (error instanceof DOMException && error.name === "AbortError")
+                    throw error;
+                if (signal.aborted)
+                    throw new DOMException("Aborted", "AbortError");
+                if (attempt < this.maxRetries) {
+                    const delay = RETRY_BASE_DELAY_MS * Math.pow(2, attempt);
+                    await new Promise((resolve, reject) => {
+                        const onAbort = () => {
+                            clearTimeout(timer);
+                            reject(signal.reason);
+                        };
+                        const timer = setTimeout(() => {
+                            signal.removeEventListener("abort", onAbort);
+                            resolve();
+                        }, delay);
+                        signal.addEventListener("abort", onAbort, { once: true });
+                    });
+                    continue;
+                }
+                throw error;
+            }
+        }
+        return null;
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a Wikidata SPARQL source instance.
+ *
+ * @example
+ * ```typescript
+ * // Default: search by name, return basic info
+ * const source = wikidata()
+ *
+ * // Custom: death-specific query
+ * const deathSource = wikidata({
+ *   queryBuilder: (subject) => {
+ *     const name = escapeSparql(subject.name)
+ *     const deathYear = subject.context?.deathYear as number
+ *     return `SELECT ... WHERE { ... }`
+ *   },
+ *   resultParser: (bindings, subject) => {
+ *     // Extract cause of death, manner, location...
+ *     return { text: "...", confidence: 0.8 }
+ *   },
+ * })
+ * ```
+ */
+export function wikidata(options) {
+    return new WikidataSource(options);
+}
+//# sourceMappingURL=wikidata.js.map

package/dist/structured/wikidata.js.map

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