openplanter 0.1.3 → 0.2.0

package/dist/investigation-tools/document-processing.js

@@ -0,0 +1,252 @@
+/**
+ * document-processing.ts — PDF extraction, document similarity, and sentiment analysis tools.
+ *
+ * Tools: pdf_filings_extractor, document_similarity_scorer, sentiment_analyzer
+ */
+import { sentimentScore, sentimentLabel, isRumor, BULLISH_KEYWORDS, BEARISH_KEYWORDS, RUMOR_KEYWORDS } from "./shared.js";
+import { makeProvenance } from "./shared-crypto.js";
+// ── Mock Data ────────────────────────────────────────────────────
+const MOCK_PDF = {
+    tables: [
+        {
+            pageNumber: 3, tableIndex: 0,
+            headers: ["Name", "Position", "Shares Acquired", "Price", "Date"],
+            rows: [
+                ["John Smith", "CEO", "50,000", "$45.20", "2026-02-15"],
+                ["Jane Williams", "CFO", "25,000", "$43.80", "2026-02-14"],
+            ],
+            confidence: 85,
+        },
+    ],
+    textSections: [
+        { page: 1, heading: "Item 1", text: "The reporting person acquired shares of common stock..." },
+    ],
+    metadata: { pages: 4, title: "Form 4 - Statement of Changes", author: "SEC EDGAR" },
+    provenance: makeProvenance("pdf_extractor", "test://mock", ["test_mode"]),
+};
+const MOCK_SIMILARITY = {
+    pairs: [
+        {
+            docA: "SEC Filing Q4 2025", docB: "Insider Trade Report",
+            cosineSimilarity: 0.78,
+            sharedTerms: ["techcorp", "shares", "acquisition", "material"],
+            topDivergentTerms: ["revenue", "compliance"],
+        },
+    ],
+    provenance: makeProvenance("document_similarity", "test://mock", ["test_mode"]),
+};
+const MOCK_SENTIMENT = {
+    overallSentiment: -0.4,
+    overallLabel: "bearish",
+    sentences: [
+        { text: "CEO sold 50,000 shares days before earnings miss.", sentiment: -0.8, label: "bearish", isRumor: false },
+        { text: "Rumor has it the company is under SEC investigation.", sentiment: -0.6, label: "bearish", isRumor: true },
+    ],
+    entities: [
+        { text: "CEO", type: "PERSON", start: 0, end: 3, count: 2 },
+        { text: "SEC", type: "ORG", start: 55, end: 58, count: 1 },
+    ],
+    keyPhrases: ["insider trading", "earnings miss", "SEC investigation"],
+    rumorIndicators: ["rumor has it"],
+    provenance: makeProvenance("sentiment_analyzer", "test://mock", ["test_mode"]),
+};
+// ── pdf_filings_extractor ────────────────────────────────────────
+export async function extractPdfFilings(opts) {
+    if (opts.test)
+        return MOCK_PDF;
+    const text = opts.text;
+    const lines = text.split("\n");
+    const tables = [];
+    const sections = [];
+    let currentTableRows = [];
+    let currentHeaders = [];
+    let inTable = false;
+    let tableCount = 0;
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i].trim();
+        if (line.includes("|") || line.includes("\t")) {
+            const cells = line.split(/[|\t]/).map((c) => c.trim()).filter(Boolean);
+            if (cells.length >= 2) {
+                if (!inTable) {
+                    inTable = true;
+                    currentHeaders = cells;
+                    currentTableRows = [];
+                }
+                else {
+                    currentTableRows.push(cells);
+                }
+                continue;
+            }
+        }
+        if (inTable && currentTableRows.length > 0) {
+            tables.push({
+                pageNumber: 1,
+                tableIndex: tableCount++,
+                headers: currentHeaders,
+                rows: currentTableRows,
+                confidence: 70,
+            });
+            inTable = false;
+            currentHeaders = [];
+            currentTableRows = [];
+        }
+        const headingMatch = line.match(/^(#{1,3}|Item\s+\d+|Section\s+\d+|PART\s+[IVX]+)/i);
+        if (headingMatch) {
+            const sectionText = [];
+            for (let j = i + 1; j < Math.min(i + 20, lines.length); j++) {
+                if (lines[j].trim() === "" && sectionText.length > 0)
+                    break;
+                sectionText.push(lines[j].trim());
+            }
+            sections.push({
+                page: 1,
+                heading: line.replace(/^#+\s*/, ""),
+                text: sectionText.join(" ").slice(0, 500),
+            });
+        }
+    }
+    if (inTable && currentTableRows.length > 0) {
+        tables.push({
+            pageNumber: 1, tableIndex: tableCount,
+            headers: currentHeaders, rows: currentTableRows, confidence: 70,
+        });
+    }
+    return {
+        tables, textSections: sections,
+        metadata: { pages: 1, title: opts.source ?? "Unknown", author: "" },
+        provenance: makeProvenance("pdf_extractor", opts.source),
+    };
+}
+// ── document_similarity_scorer ───────────────────────────────────
+function tokenize(text) {
+    const tokens = text.toLowerCase().replace(/[^a-z0-9\s]/g, "").split(/\s+/).filter((t) => t.length > 2);
+    const freq = new Map();
+    for (const t of tokens)
+        freq.set(t, (freq.get(t) ?? 0) + 1);
+    return freq;
+}
+function tfidfVector(docs) {
+    const docFreqs = new Map();
+    const termFreqs = docs.map((d) => {
+        const tf = tokenize(d);
+        for (const term of tf.keys())
+            docFreqs.set(term, (docFreqs.get(term) ?? 0) + 1);
+        return tf;
+    });
+    const n = docs.length;
+    return termFreqs.map((tf) => {
+        const tfidf = new Map();
+        for (const [term, count] of tf) {
+            const df = docFreqs.get(term) ?? 1;
+            tfidf.set(term, count * Math.log(n / df));
+        }
+        return tfidf;
+    });
+}
+function cosineSim(a, b) {
+    let dot = 0, magA = 0, magB = 0;
+    for (const [term, val] of a) {
+        magA += val * val;
+        if (b.has(term))
+            dot += val * b.get(term);
+    }
+    for (const val of b.values())
+        magB += val * val;
+    const denom = Math.sqrt(magA) * Math.sqrt(magB);
+    return denom > 0 ? dot / denom : 0;
+}
+export function scoreDocumentSimilarity(opts) {
+    if (opts.test)
+        return MOCK_SIMILARITY;
+    const docs = opts.documents;
+    const vectors = tfidfVector(docs.map((d) => d.text));
+    const pairs = [];
+    for (let i = 0; i < docs.length; i++) {
+        for (let j = i + 1; j < docs.length; j++) {
+            const sim = cosineSim(vectors[i], vectors[j]);
+            const termsA = new Set(vectors[i].keys());
+            const termsB = new Set(vectors[j].keys());
+            const shared = [...termsA].filter((t) => termsB.has(t)).slice(0, 10);
+            const divergent = [...termsA].filter((t) => !termsB.has(t))
+                .sort((a, b) => (vectors[i].get(b) ?? 0) - (vectors[i].get(a) ?? 0))
+                .slice(0, 5);
+            pairs.push({
+                docA: docs[i].name,
+                docB: docs[j].name,
+                cosineSimilarity: Math.round(sim * 1000) / 1000,
+                sharedTerms: shared,
+                topDivergentTerms: divergent,
+            });
+        }
+    }
+    pairs.sort((a, b) => b.cosineSimilarity - a.cosineSimilarity);
+    return { pairs, provenance: makeProvenance("document_similarity") };
+}
+// ── sentiment_analyzer ───────────────────────────────────────────
+const PERSON_RE = /\b(?:Mr|Mrs|Ms|Dr|Sen|Rep|CEO|CFO|CTO|COO)\b\.?\s+[A-Z][a-z]+(?:\s+[A-Z][a-z]+)*/g;
+const ORG_RE = /\b(?:SEC|FBI|DOJ|FTC|CFTC|FINRA|NYSE|NASDAQ|ASX|OpenAI|Google|Microsoft|Apple|Meta)\b/g;
+const TICKER_RE = /\$([A-Z]{2,5})\b/g;
+const MONEY_RE = /\$[\d,]+(?:\.\d+)?(?:\s*(?:million|billion|thousand))?/gi;
+const DATE_RE = /\b(?:\d{4}-\d{2}-\d{2}|\w+ \d{1,2},? \d{4})\b/g;
+export function analyzeSentiment(opts) {
+    if (opts.test)
+        return MOCK_SENTIMENT;
+    const text = opts.text;
+    const sentences = text.split(/[.!?]+/).map((s) => s.trim()).filter((s) => s.length > 10);
+    const sentencesResult = sentences.map((s) => {
+        const score = sentimentScore(s);
+        return {
+            text: s.slice(0, 200),
+            sentiment: Math.round(score * 100) / 100,
+            label: sentimentLabel(score),
+            isRumor: isRumor(s),
+        };
+    });
+    const overallSentiment = sentencesResult.length > 0
+        ? sentencesResult.reduce((sum, s) => sum + s.sentiment, 0) / sentencesResult.length
+        : 0;
+    const entities = [];
+    if (opts.extractEntities !== false) {
+        const seen = new Map();
+        const addEntity = (match, type) => {
+            const key = `${type}:${match[0]}`;
+            const existing = seen.get(key);
+            if (existing) {
+                existing.count++;
+                return;
+            }
+            const entity = {
+                text: match[0], type, start: match.index ?? 0,
+                end: (match.index ?? 0) + match[0].length, count: 1,
+            };
+            seen.set(key, entity);
+            entities.push(entity);
+        };
+        for (const m of text.matchAll(PERSON_RE))
+            addEntity(m, "PERSON");
+        for (const m of text.matchAll(ORG_RE))
+            addEntity(m, "ORG");
+        for (const m of text.matchAll(TICKER_RE))
+            addEntity(m, "TICKER");
+        for (const m of text.matchAll(MONEY_RE))
+            addEntity(m, "MONEY");
+        for (const m of text.matchAll(DATE_RE))
+            addEntity(m, "DATE");
+    }
+    const lower = text.toLowerCase();
+    const keyPhrases = [
+        ...BULLISH_KEYWORDS.filter((k) => lower.includes(k)),
+        ...BEARISH_KEYWORDS.filter((k) => lower.includes(k)),
+    ];
+    const rumorIndicators = RUMOR_KEYWORDS.filter((k) => lower.includes(k));
+    return {
+        overallSentiment: Math.round(overallSentiment * 100) / 100,
+        overallLabel: sentimentLabel(overallSentiment),
+        sentences: sentencesResult,
+        entities,
+        keyPhrases: [...new Set(keyPhrases)],
+        rumorIndicators,
+        provenance: makeProvenance("sentiment_analyzer"),
+    };
+}
+//# sourceMappingURL=document-processing.js.map

package/dist/investigation-tools/document-processing.js.map

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

package/dist/investigation-tools/dune-analytics.d.ts

@@ -0,0 +1,47 @@
+/**
+ * dune-analytics.ts — Dune Analytics query tools for blockchain data.
+ *
+ * Tools: dune_query_executor, dune_polymarket
+ */
+import { type Provenance } from "./shared-crypto.js";
+export interface DuneQueryResult {
+    queryId: number;
+    executionId: string;
+    state: "COMPLETE" | "EXECUTING" | "FAILED" | "CANCELLED";
+    columns: string[];
+    rows: Array<Record<string, unknown>>;
+    rowCount: number;
+    executionTimeMs: number;
+    provenance: Provenance;
+}
+export interface DunePolymarketResult {
+    metrics: {
+        totalVolume: number;
+        uniqueTraders: number;
+        avgTradeSize: number;
+        topMarkets: Array<{
+            market: string;
+            volume: number;
+        }>;
+        dailyVolumes: Array<{
+            date: string;
+            volume: number;
+        }>;
+    };
+    provenance: Provenance;
+}
+export declare function executeDuneQuery(opts: {
+    queryId?: number;
+    sql?: string;
+    parameters?: Record<string, string>;
+    apiKey?: string;
+    maxWaitSec?: number;
+    test?: boolean;
+}): Promise<DuneQueryResult>;
+export declare function dunePolymarket(opts: {
+    metric?: string;
+    daysBack?: number;
+    apiKey?: string;
+    test?: boolean;
+}): Promise<DunePolymarketResult>;
+//# sourceMappingURL=dune-analytics.d.ts.map

package/dist/investigation-tools/dune-analytics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dune-analytics.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/dune-analytics.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAIrE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;IACzD,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,KAAK,CAAC;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACtD,YAAY,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KACvD,CAAC;IACF,UAAU,EAAE,UAAU,CAAC;CACxB;AAyCD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0E3B;AAOD,wBAAsB,cAAc,CAAC,IAAI,EAAE;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CA2ChC"}

package/dist/investigation-tools/dune-analytics.js

@@ -0,0 +1,160 @@
+/**
+ * dune-analytics.ts — Dune Analytics query tools for blockchain data.
+ *
+ * Tools: dune_query_executor, dune_polymarket
+ */
+import { sleep } from "./shared.js";
+import { makeProvenance } from "./shared-crypto.js";
+// ── Constants ────────────────────────────────────────────────────
+const DUNE_API = "https://api.dune.com/api/v1";
+const MOCK_QUERY_RESULT = {
+    queryId: 12345,
+    executionId: "exec_mock_001",
+    state: "COMPLETE",
+    columns: ["wallet", "volume_usd", "num_trades", "pnl_usd"],
+    rows: [
+        { wallet: "0xabc123", volume_usd: 5200000, num_trades: 342, pnl_usd: 482000 },
+        { wallet: "0xdef456", volume_usd: 3100000, num_trades: 187, pnl_usd: 310000 },
+        { wallet: "0x789abc", volume_usd: 1800000, num_trades: 94, pnl_usd: -45000 },
+    ],
+    rowCount: 3,
+    executionTimeMs: 4200,
+    provenance: makeProvenance("dune_analytics", "test://mock", ["test_mode"]),
+};
+const MOCK_POLYMARKET_METRICS = {
+    metrics: {
+        totalVolume: 847_000_000,
+        uniqueTraders: 142_000,
+        avgTradeSize: 5960,
+        topMarkets: [
+            { market: "US Presidential Election 2028", volume: 120_000_000 },
+            { market: "BTC Price EOY 2026", volume: 45_000_000 },
+        ],
+        dailyVolumes: [
+            { date: "2026-02-20", volume: 12_400_000 },
+            { date: "2026-02-19", volume: 10_800_000 },
+            { date: "2026-02-18", volume: 11_200_000 },
+        ],
+    },
+    provenance: makeProvenance("dune_analytics", "test://mock", ["test_mode"]),
+};
+// ── dune_query_executor ──────────────────────────────────────────
+export async function executeDuneQuery(opts) {
+    if (opts.test)
+        return MOCK_QUERY_RESULT;
+    const apiKey = opts.apiKey ?? process.env.DUNE_API_KEY;
+    if (!apiKey)
+        throw new Error("DUNE_API_KEY required (pass apiKey or set env var)");
+    const headers = { "X-Dune-API-Key": apiKey, "Content-Type": "application/json" };
+    const maxWait = opts.maxWaitSec ?? 120;
+    let executionId;
+    if (opts.queryId) {
+        const body = opts.parameters ? JSON.stringify({ query_parameters: opts.parameters }) : "{}";
+        const resp = await fetch(`${DUNE_API}/query/${opts.queryId}/execute`, {
+            method: "POST", headers, body,
+        });
+        if (!resp.ok)
+            throw new Error(`Dune execute failed: HTTP ${resp.status}`);
+        const data = await resp.json();
+        executionId = String(data.execution_id ?? "");
+    }
+    else if (opts.sql) {
+        const resp = await fetch(`${DUNE_API}/query/execute`, {
+            method: "POST", headers,
+            body: JSON.stringify({ query: opts.sql, parameters: opts.parameters }),
+        });
+        if (!resp.ok)
+            throw new Error(`Dune execute failed: HTTP ${resp.status}`);
+        const data = await resp.json();
+        executionId = String(data.execution_id ?? "");
+    }
+    else {
+        throw new Error("Either queryId or sql must be provided");
+    }
+    const startTime = Date.now();
+    while (Date.now() - startTime < maxWait * 1000) {
+        await sleep(2000);
+        const resp = await fetch(`${DUNE_API}/execution/${executionId}/status`, { headers });
+        if (!resp.ok)
+            continue;
+        const status = await resp.json();
+        const state = String(status.state ?? "");
+        if (state === "QUERY_STATE_COMPLETED" || state === "COMPLETE") {
+            const resultResp = await fetch(`${DUNE_API}/execution/${executionId}/results?limit=1000`, { headers });
+            if (!resultResp.ok)
+                throw new Error(`Dune results fetch failed: HTTP ${resultResp.status}`);
+            const resultData = await resultResp.json();
+            const result = resultData.result;
+            const metadata = result?.metadata;
+            const rows = (result?.rows ?? []);
+            return {
+                queryId: opts.queryId ?? 0,
+                executionId,
+                state: "COMPLETE",
+                columns: (metadata?.column_names ?? []),
+                rows,
+                rowCount: rows.length,
+                executionTimeMs: Date.now() - startTime,
+                provenance: makeProvenance("dune_analytics", `${DUNE_API}/execution/${executionId}`),
+            };
+        }
+        if (state === "QUERY_STATE_FAILED" || state === "FAILED") {
+            throw new Error(`Dune query failed: ${status.error ?? "unknown error"}`);
+        }
+    }
+    return {
+        queryId: opts.queryId ?? 0,
+        executionId,
+        state: "EXECUTING",
+        columns: [],
+        rows: [],
+        rowCount: 0,
+        executionTimeMs: Date.now() - startTime,
+        provenance: makeProvenance("dune_analytics", `${DUNE_API}/execution/${executionId}`, ["timeout"]),
+    };
+}
+// ── dune_polymarket ──────────────────────────────────────────────
+const POLYMARKET_VOLUME_QUERY = 3_865_647;
+const POLYMARKET_TRADERS_QUERY = 3_865_650;
+export async function dunePolymarket(opts) {
+    if (opts.test)
+        return MOCK_POLYMARKET_METRICS;
+    const queryId = opts.metric === "traders" ? POLYMARKET_TRADERS_QUERY : POLYMARKET_VOLUME_QUERY;
+    const params = opts.daysBack ? { days_back: String(opts.daysBack) } : undefined;
+    const result = await executeDuneQuery({
+        queryId,
+        parameters: params,
+        apiKey: opts.apiKey,
+    });
+    let totalVolume = 0;
+    let uniqueTraders = 0;
+    const dailyVolumes = [];
+    const marketVolumes = new Map();
+    for (const row of result.rows) {
+        const vol = Number(row.volume_usd ?? row.volume ?? 0);
+        totalVolume += vol;
+        if (row.date)
+            dailyVolumes.push({ date: String(row.date), volume: vol });
+        if (row.market) {
+            const mkt = String(row.market);
+            marketVolumes.set(mkt, (marketVolumes.get(mkt) ?? 0) + vol);
+        }
+        if (row.unique_traders)
+            uniqueTraders = Math.max(uniqueTraders, Number(row.unique_traders));
+    }
+    const topMarkets = [...marketVolumes.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 10)
+        .map(([market, volume]) => ({ market, volume }));
+    return {
+        metrics: {
+            totalVolume,
+            uniqueTraders,
+            avgTradeSize: uniqueTraders > 0 ? totalVolume / uniqueTraders : 0,
+            topMarkets,
+            dailyVolumes: dailyVolumes.slice(-30),
+        },
+        provenance: makeProvenance("dune_analytics", `${DUNE_API}/query/${queryId}`),
+    };
+}
+//# sourceMappingURL=dune-analytics.js.map

package/dist/investigation-tools/dune-analytics.js.map

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

package/dist/investigation-tools/global-registries.d.ts

@@ -0,0 +1,86 @@
+/**
+ * global-registries.ts — Global corporate registries, sanctions, and beneficial ownership tools.
+ *
+ * Tools: opencorporates_lookup, ofac_sanctions_checker, beneficial_ownership_tracer
+ */
+import { type Provenance, type ConfidenceScore } from "./shared-crypto.js";
+export interface CorporateEntity {
+    name: string;
+    jurisdictionCode: string;
+    companyNumber: string;
+    companyType: string;
+    status: string;
+    incorporationDate: string;
+    registeredAddress: string;
+    officers: Array<{
+        name: string;
+        role: string;
+        startDate: string;
+    }>;
+    source: string;
+    url: string;
+}
+export interface CorporateResult {
+    entities: CorporateEntity[];
+    total: number;
+    provenance: Provenance;
+}
+export interface SanctionsMatch {
+    name: string;
+    matchScore: number;
+    program: string;
+    entityType: string;
+    country: string;
+    aliases: string[];
+    listDate: string;
+    source: string;
+    sdnId: string;
+}
+export interface SanctionsResult {
+    matches: SanctionsMatch[];
+    queryName: string;
+    isMatch: boolean;
+    highestScore: number;
+    provenance: Provenance;
+}
+export interface BeneficialOwner {
+    name: string;
+    ownershipPercentage: number | null;
+    controlType: string;
+    nationality: string;
+    throughEntities: string[];
+    confidence: ConfidenceScore;
+}
+export interface OwnershipResult {
+    company: string;
+    beneficialOwners: BeneficialOwner[];
+    ownershipChain: Array<{
+        from: string;
+        to: string;
+        percentage: number | null;
+        type: string;
+    }>;
+    provenance: Provenance;
+}
+export declare function lookupCorporate(opts: {
+    query: string;
+    jurisdiction?: string;
+    companyNumber?: string;
+    apiKey?: string;
+    limit?: number;
+    test?: boolean;
+}): Promise<CorporateResult>;
+export declare function checkSanctions(opts: {
+    name: string;
+    entityType?: string;
+    country?: string;
+    threshold?: number;
+    test?: boolean;
+}): Promise<SanctionsResult>;
+export declare function traceBeneficialOwnership(opts: {
+    companyName: string;
+    jurisdiction?: string;
+    apiKey?: string;
+    test?: boolean;
+}): Promise<OwnershipResult>;
+//# sourceMappingURL=global-registries.d.ts.map

package/dist/investigation-tools/global-registries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-registries.d.ts","sourceRoot":"","sources":["../../src/investigation-tools/global-registries.ts"],"names":[],"mappings":"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"}