@cyanheads/gbif-biodiversity-mcp-server 0.2.0

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

@@ -0,0 +1,48 @@
+/**
+ * @fileoverview Search or browse the GBIF backbone taxonomy.
+ * @module mcp-server/tools/definitions/gbif-search-species
+ */
+import { z } from '@cyanheads/mcp-ts-core';
+export declare const gbifSearchSpecies: import("@cyanheads/mcp-ts-core").ToolDefinition<z.ZodObject<{
+    q: z.ZodOptional<z.ZodString>;
+    rank: z.ZodOptional<z.ZodEnum<{
+        KINGDOM: "KINGDOM";
+        PHYLUM: "PHYLUM";
+        CLASS: "CLASS";
+        ORDER: "ORDER";
+        FAMILY: "FAMILY";
+        GENUS: "GENUS";
+        SPECIES: "SPECIES";
+        SUBSPECIES: "SUBSPECIES";
+    }>>;
+    kingdom: z.ZodOptional<z.ZodString>;
+    family: z.ZodOptional<z.ZodString>;
+    genus: z.ZodOptional<z.ZodString>;
+    isExtinct: z.ZodOptional<z.ZodBoolean>;
+    datasetKey: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodNumber>;
+    offset: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+    taxa: z.ZodArray<z.ZodObject<{
+        key: z.ZodOptional<z.ZodNumber>;
+        scientificName: z.ZodOptional<z.ZodString>;
+        canonicalName: z.ZodOptional<z.ZodString>;
+        rank: z.ZodOptional<z.ZodString>;
+        taxonomicStatus: z.ZodOptional<z.ZodString>;
+        kingdom: z.ZodOptional<z.ZodString>;
+        phylum: z.ZodOptional<z.ZodString>;
+        class: z.ZodOptional<z.ZodString>;
+        order: z.ZodOptional<z.ZodString>;
+        family: z.ZodOptional<z.ZodString>;
+        genus: z.ZodOptional<z.ZodString>;
+        vernacularName: z.ZodOptional<z.ZodString>;
+        numOccurrences: z.ZodOptional<z.ZodNumber>;
+        numDescendants: z.ZodOptional<z.ZodNumber>;
+        extinct: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    totalCount: z.ZodNumber;
+    offset: z.ZodNumber;
+    limit: z.ZodNumber;
+    endOfRecords: z.ZodBoolean;
+}, z.core.$strip>, undefined>;
+//# sourceMappingURL=gbif-search-species.tool.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"gbif-search-species.tool.d.ts","sourceRoot":"","sources":["../../../../src/mcp-server/tools/definitions/gbif-search-species.tool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAQ,CAAC,EAAE,MAAM,wBAAwB,CAAC;AAGjD,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;6BA8I5B,CAAC"}

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

@@ -0,0 +1,151 @@
+/**
+ * @fileoverview Search or browse the GBIF backbone taxonomy.
+ * @module mcp-server/tools/definitions/gbif-search-species
+ */
+import { tool, z } from '@cyanheads/mcp-ts-core';
+import { getGbifService } from '../../../services/gbif/gbif-service.js';
+export const gbifSearchSpecies = tool('gbif_search_species', {
+    title: 'Search Species Taxonomy',
+    description: 'Search or browse the GBIF backbone taxonomy. Accepts scientific name fragments, rank filters, ' +
+        'and higher-taxon constraints. Useful for exploring what species exist under a higher taxon ' +
+        '(e.g., "list all families of Coleoptera"), for simple name-fragment searches, or when ' +
+        'gbif_match_species returns too narrow a result. Paginated — use limit and offset to walk through results.',
+    annotations: { readOnlyHint: true, idempotentHint: true, openWorldHint: false },
+    input: z.object({
+        q: z
+            .string()
+            .optional()
+            .describe('Name fragment to search for. Matches scientific and vernacular names.'),
+        rank: z
+            .enum(['KINGDOM', 'PHYLUM', 'CLASS', 'ORDER', 'FAMILY', 'GENUS', 'SPECIES', 'SUBSPECIES'])
+            .optional()
+            .describe('Filter to a specific taxonomic rank.'),
+        kingdom: z
+            .string()
+            .optional()
+            .describe('Scope search to a kingdom (e.g., "Animalia", "Plantae").'),
+        family: z.string().optional().describe('Scope search to a family name.'),
+        genus: z.string().optional().describe('Scope search to a genus name.'),
+        isExtinct: z.boolean().optional().describe('Filter to extinct (true) or extant (false) taxa.'),
+        datasetKey: z
+            .string()
+            .optional()
+            .describe('Scope to a specific checklist dataset UUID. Omit to search the GBIF backbone.'),
+        limit: z
+            .number()
+            .min(1)
+            .max(1000)
+            .default(20)
+            .describe('Number of records to return (default 20, max 1000).'),
+        offset: z.number().min(0).default(0).describe('Pagination offset.'),
+    }),
+    output: z.object({
+        taxa: z
+            .array(z
+            .object({
+            key: z.number().optional().describe('GBIF backbone taxon key.'),
+            scientificName: z.string().optional().describe('Full scientific name with authorship.'),
+            canonicalName: z.string().optional().describe('Scientific name without authorship.'),
+            rank: z.string().optional().describe('Taxonomic rank.'),
+            taxonomicStatus: z.string().optional().describe('ACCEPTED, SYNONYM, DOUBTFUL, etc.'),
+            kingdom: z.string().optional().describe('Kingdom classification.'),
+            phylum: z.string().optional().describe('Phylum classification.'),
+            class: z.string().optional().describe('Class classification.'),
+            order: z.string().optional().describe('Order classification.'),
+            family: z.string().optional().describe('Family classification.'),
+            genus: z.string().optional().describe('Genus classification.'),
+            vernacularName: z.string().optional().describe('Common name when available.'),
+            numOccurrences: z.number().optional().describe('Occurrence record count in GBIF.'),
+            numDescendants: z.number().optional().describe('Count of child taxa in the backbone.'),
+            extinct: z.boolean().optional().describe('True when explicitly flagged as extinct.'),
+        })
+            .describe('A backbone taxon with classification, status, and occurrence counts.'))
+            .describe('Matching taxa.'),
+        totalCount: z.number().describe('Total matches before pagination.'),
+        offset: z.number().describe('Current pagination offset.'),
+        limit: z.number().describe('Records returned in this page.'),
+        endOfRecords: z.boolean().describe('True when there are no more results after this page.'),
+    }),
+    async handler(input, ctx) {
+        ctx.log.info('Searching species taxonomy', { q: input.q, rank: input.rank });
+        const raw = await getGbifService().searchSpecies({
+            ...(input.q?.trim() && { q: input.q }),
+            ...(input.rank && { rank: input.rank }),
+            ...(input.kingdom?.trim() && { kingdom: input.kingdom }),
+            ...(input.family?.trim() && { family: input.family }),
+            ...(input.genus?.trim() && { genus: input.genus }),
+            ...(input.isExtinct !== undefined && { isExtinct: input.isExtinct }),
+            ...(input.datasetKey?.trim() && { datasetKey: input.datasetKey }),
+            limit: input.limit,
+            offset: input.offset,
+        }, ctx);
+        const taxa = (raw.results ?? []).map((r) => ({
+            key: r.key,
+            scientificName: r.scientificName,
+            canonicalName: r.canonicalName,
+            rank: r.rank,
+            taxonomicStatus: r.taxonomicStatus,
+            kingdom: r.kingdom,
+            phylum: r.phylum,
+            class: r.clazz,
+            order: r.order,
+            family: r.family,
+            genus: r.genus,
+            vernacularName: r.vernacularName,
+            numOccurrences: r.numOccurrences,
+            numDescendants: r.numDescendants,
+            ...(typeof r.extinct === 'boolean' && { extinct: r.extinct }),
+        }));
+        return {
+            taxa,
+            totalCount: raw.count ?? 0,
+            offset: raw.offset ?? input.offset,
+            limit: raw.limit ?? input.limit,
+            endOfRecords: raw.endOfRecords ?? true,
+        };
+    },
+    format: (result) => {
+        const lines = [
+            `**Total matches:** ${result.totalCount} | **Showing:** ${result.taxa.length} | **Limit:** ${result.limit} | **End of records:** ${result.endOfRecords} (offset ${result.offset})`,
+        ];
+        for (const t of result.taxa) {
+            const name = t.canonicalName ?? 'Unknown';
+            const sci = t.scientificName && t.scientificName !== name ? ` [${t.scientificName}]` : '';
+            lines.push(`\n## ${name}${sci}`);
+            if (t.key != null)
+                lines.push(`**Taxon key:** ${t.key}`);
+            if (t.rank)
+                lines.push(`**Rank:** ${t.rank}`);
+            if (t.taxonomicStatus)
+                lines.push(`**Status:** ${t.taxonomicStatus}`);
+            if (t.vernacularName)
+                lines.push(`**Common name:** ${t.vernacularName}`);
+            const classificationParts = [];
+            if (t.kingdom)
+                classificationParts.push(`Kingdom: ${t.kingdom}`);
+            if (t.phylum)
+                classificationParts.push(`Phylum: ${t.phylum}`);
+            if (t.class)
+                classificationParts.push(`Class: ${t.class}`);
+            if (t.order)
+                classificationParts.push(`Order: ${t.order}`);
+            if (t.family)
+                classificationParts.push(`Family: ${t.family}`);
+            if (t.genus)
+                classificationParts.push(`Genus: ${t.genus}`);
+            if (classificationParts.length > 0)
+                lines.push(`**Classification:** ${classificationParts.join(' › ')}`);
+            if (t.numOccurrences != null)
+                lines.push(`**Occurrences:** ${t.numOccurrences}`);
+            if (t.numDescendants != null)
+                lines.push(`**Descendants:** ${t.numDescendants}`);
+            if (typeof t.extinct === 'boolean')
+                lines.push(`**Extinct:** ${t.extinct ? 'Yes' : 'No'}`);
+        }
+        if (!result.endOfRecords) {
+            lines.push(`\n*More results available — use offset ${result.offset + result.limit} to continue.*`);
+        }
+        return [{ type: 'text', text: lines.join('\n') }];
+    },
+});
+//# sourceMappingURL=gbif-search-species.tool.js.map

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

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

package/dist/mcp-server/tools/utils.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @fileoverview Shared utilities for tool definitions.
+ * @module mcp-server/tools/utils
+ */
+/** Strip HTML tags and decode common entities. */
+export declare function stripHtml(html: string): string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/mcp-server/tools/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/mcp-server/tools/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAClD,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAa9C"}

package/dist/mcp-server/tools/utils.js

@@ -0,0 +1,20 @@
+/**
+ * @fileoverview Shared utilities for tool definitions.
+ * @module mcp-server/tools/utils
+ */
+/** Strip HTML tags and decode common entities. */
+export function stripHtml(html) {
+    return html
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/&amp;/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#34;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&#61;/g, '=')
+        .replace(/&#43;/g, '+')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+//# sourceMappingURL=utils.js.map

package/dist/mcp-server/tools/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/mcp-server/tools/utils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,kDAAkD;AAClD,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC;SACxB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACrB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/services/gbif/gbif-service.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @fileoverview GBIF API v1 service — wraps api.gbif.org/v1 with retry, auth, and response parsing.
+ * @module services/gbif/gbif-service
+ */
+import type { Context } from '@cyanheads/mcp-ts-core';
+import type { AppConfig } from '@cyanheads/mcp-ts-core/config';
+import type { StorageService } from '@cyanheads/mcp-ts-core/storage';
+import type { BasisOfRecord, RawChildrenResponse, RawDatasetRecord, RawDatasetSearchResponse, RawOccurrenceRecord, RawOccurrenceSearchResponse, RawOrganizationSearchResponse, RawParentNode, RawSpeciesMatch, RawSpeciesRecord, RawSpeciesSearchResponse } from './types.js';
+export declare class GbifService {
+    private readonly baseUrl;
+    private readonly timeoutMs;
+    private readonly authHeader;
+    constructor(_config: AppConfig, _storage: StorageService, opts: {
+        baseUrl: string;
+        timeoutMs: number;
+        apiKey?: string;
+    });
+    private buildHeaders;
+    private buildUrl;
+    private getJson;
+    matchSpecies(params: {
+        name: string;
+        strict?: boolean;
+        kingdom?: string;
+        rank?: string;
+    }, ctx: Context): Promise<RawSpeciesMatch>;
+    getSpecies(taxonKey: number, ctx: Context): Promise<RawSpeciesRecord>;
+    searchSpecies(params: {
+        q?: string;
+        rank?: string;
+        kingdom?: string;
+        family?: string;
+        genus?: string;
+        isExtinct?: boolean;
+        datasetKey?: string;
+        limit?: number;
+        offset?: number;
+    }, ctx: Context): Promise<RawSpeciesSearchResponse>;
+    getSpeciesParents(taxonKey: number, ctx: Context): Promise<RawParentNode[]>;
+    getSpeciesChildren(taxonKey: number, params: {
+        limit?: number;
+        offset?: number;
+    }, ctx: Context): Promise<RawChildrenResponse>;
+    searchOccurrences(params: {
+        taxonKey?: number;
+        scientificName?: string;
+        country?: string;
+        decimalLatitude?: string;
+        decimalLongitude?: string;
+        geometry?: string;
+        year?: string;
+        month?: number;
+        basisOfRecord?: BasisOfRecord;
+        hasCoordinate?: boolean;
+        isInCluster?: boolean;
+        datasetKey?: string;
+        limit?: number;
+        offset?: number;
+    }, ctx: Context): Promise<RawOccurrenceSearchResponse>;
+    countOccurrences(params: {
+        taxonKey?: number;
+        country?: string;
+        isGeoreferenced?: boolean;
+        datasetKey?: string;
+        year?: string;
+    }, ctx: Context): Promise<number>;
+    getOccurrence(occurrenceKey: number, ctx: Context): Promise<RawOccurrenceRecord>;
+    getOccurrenceFacets(params: {
+        taxonKey?: number;
+        country?: string;
+        year?: string;
+        basisOfRecord?: BasisOfRecord;
+        geometry?: string;
+        facet: string;
+        facetLimit?: number;
+    }, ctx: Context): Promise<RawOccurrenceSearchResponse>;
+    searchDatasets(params: {
+        q?: string;
+        type?: string;
+        publishingCountry?: string;
+        hostingOrg?: string;
+        limit?: number;
+        offset?: number;
+    }, ctx: Context): Promise<RawDatasetSearchResponse>;
+    getDataset(datasetKey: string, ctx: Context): Promise<RawDatasetRecord>;
+    searchPublishers(params: {
+        q?: string;
+        country?: string;
+        limit?: number;
+        offset?: number;
+    }, ctx: Context): Promise<RawOrganizationSearchResponse>;
+}
+export declare function initGbifService(config: AppConfig, storage: StorageService, opts: {
+    baseUrl: string;
+    timeoutMs: number;
+    apiKey?: string;
+}): void;
+export declare function getGbifService(): GbifService;
+//# sourceMappingURL=gbif-service.d.ts.map

package/dist/services/gbif/gbif-service.d.ts.map

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

package/dist/services/gbif/gbif-service.js

@@ -0,0 +1,255 @@
+/**
+ * @fileoverview GBIF API v1 service — wraps api.gbif.org/v1 with retry, auth, and response parsing.
+ * @module services/gbif/gbif-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { httpErrorFromResponse, withRetry } from '@cyanheads/mcp-ts-core/utils';
+// ─── Service class ─────────────────────────────────────────────────────────────
+export class GbifService {
+    baseUrl;
+    timeoutMs;
+    authHeader;
+    constructor(_config, _storage, opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/$/, '');
+        this.timeoutMs = opts.timeoutMs;
+        if (opts.apiKey) {
+            // GBIF auth: Basic base64(apiKey + ':')
+            this.authHeader = `Basic ${btoa(`${opts.apiKey}:`)}`;
+        }
+    }
+    // ─── Private helpers ─────────────────────────────────────────────────────────
+    buildHeaders() {
+        const headers = { Accept: 'application/json' };
+        if (this.authHeader)
+            headers.Authorization = this.authHeader;
+        return headers;
+    }
+    buildUrl(path, params = {}) {
+        const url = new URL(`${this.baseUrl}${path}`);
+        for (const [key, value] of Object.entries(params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (Array.isArray(value)) {
+                for (const v of value)
+                    url.searchParams.append(key, String(v));
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+        return url.toString();
+    }
+    getJson(url, ctx) {
+        return withRetry(async () => {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => controller.abort(), this.timeoutMs);
+            // Propagate ctx.signal cancellation; once:true cleans up after each attempt
+            const onAbort = () => controller.abort();
+            ctx.signal.addEventListener('abort', onAbort, { once: true });
+            try {
+                const response = await fetch(url, {
+                    headers: this.buildHeaders(),
+                    signal: controller.signal,
+                });
+                if (!response.ok) {
+                    throw await httpErrorFromResponse(response, { service: 'GBIF API', data: { url } });
+                }
+                const text = await response.text();
+                if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+                    throw serviceUnavailable('GBIF API returned HTML — likely rate-limited or unavailable.');
+                }
+                return JSON.parse(text);
+            }
+            finally {
+                clearTimeout(timeoutId);
+                ctx.signal.removeEventListener('abort', onAbort);
+            }
+        }, {
+            operation: 'GbifService.getJson',
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+    }
+    // ─── Species/Taxonomy ─────────────────────────────────────────────────────────
+    matchSpecies(params, ctx) {
+        const queryParams = { name: params.name };
+        if (params.strict !== undefined)
+            queryParams.strict = params.strict;
+        if (params.kingdom)
+            queryParams.kingdom = params.kingdom;
+        if (params.rank)
+            queryParams.rank = params.rank;
+        const url = this.buildUrl('/species/match', queryParams);
+        ctx.log.debug('Matching species', { name: params.name });
+        return this.getJson(url, ctx);
+    }
+    getSpecies(taxonKey, ctx) {
+        const url = this.buildUrl(`/species/${taxonKey}`);
+        ctx.log.debug('Fetching species record', { taxonKey });
+        return this.getJson(url, ctx);
+    }
+    searchSpecies(params, ctx) {
+        const queryParams = {};
+        if (params.q)
+            queryParams.q = params.q;
+        if (params.rank)
+            queryParams.rank = params.rank;
+        if (params.kingdom)
+            queryParams.kingdom = params.kingdom;
+        if (params.family)
+            queryParams.family = params.family;
+        if (params.genus)
+            queryParams.genus = params.genus;
+        if (params.isExtinct !== undefined)
+            queryParams.isExtinct = params.isExtinct;
+        if (params.datasetKey)
+            queryParams.datasetKey = params.datasetKey;
+        if (params.limit !== undefined)
+            queryParams.limit = params.limit;
+        if (params.offset !== undefined)
+            queryParams.offset = params.offset;
+        const url = this.buildUrl('/species/search', queryParams);
+        ctx.log.debug('Searching species', { q: params.q, rank: params.rank });
+        return this.getJson(url, ctx);
+    }
+    getSpeciesParents(taxonKey, ctx) {
+        const url = this.buildUrl(`/species/${taxonKey}/parents`);
+        ctx.log.debug('Fetching species parents', { taxonKey });
+        return this.getJson(url, ctx);
+    }
+    getSpeciesChildren(taxonKey, params, ctx) {
+        const queryParams = {};
+        if (params.limit !== undefined)
+            queryParams.limit = params.limit;
+        if (params.offset !== undefined)
+            queryParams.offset = params.offset;
+        const url = this.buildUrl(`/species/${taxonKey}/children`, queryParams);
+        ctx.log.debug('Fetching species children', { taxonKey });
+        return this.getJson(url, ctx);
+    }
+    // ─── Occurrences ─────────────────────────────────────────────────────────────
+    searchOccurrences(params, ctx) {
+        const queryParams = {};
+        if (params.taxonKey !== undefined)
+            queryParams.taxonKey = params.taxonKey;
+        if (params.scientificName)
+            queryParams.scientificName = params.scientificName;
+        if (params.country)
+            queryParams.country = params.country;
+        if (params.decimalLatitude)
+            queryParams.decimalLatitude = params.decimalLatitude;
+        if (params.decimalLongitude)
+            queryParams.decimalLongitude = params.decimalLongitude;
+        if (params.geometry)
+            queryParams.geometry = params.geometry;
+        if (params.year)
+            queryParams.year = params.year;
+        if (params.month !== undefined)
+            queryParams.month = params.month;
+        if (params.basisOfRecord)
+            queryParams.basisOfRecord = params.basisOfRecord;
+        if (params.hasCoordinate !== undefined)
+            queryParams.hasCoordinate = params.hasCoordinate;
+        if (params.isInCluster !== undefined)
+            queryParams.isInCluster = params.isInCluster;
+        if (params.datasetKey)
+            queryParams.datasetKey = params.datasetKey;
+        if (params.limit !== undefined)
+            queryParams.limit = params.limit;
+        if (params.offset !== undefined)
+            queryParams.offset = params.offset;
+        const url = this.buildUrl('/occurrence/search', queryParams);
+        ctx.log.debug('Searching occurrences', { taxonKey: params.taxonKey, country: params.country });
+        return this.getJson(url, ctx);
+    }
+    countOccurrences(params, ctx) {
+        const queryParams = {};
+        if (params.taxonKey !== undefined)
+            queryParams.taxonKey = params.taxonKey;
+        if (params.country)
+            queryParams.country = params.country;
+        if (params.isGeoreferenced !== undefined)
+            queryParams.isGeoreferenced = params.isGeoreferenced;
+        if (params.datasetKey)
+            queryParams.datasetKey = params.datasetKey;
+        if (params.year)
+            queryParams.year = params.year;
+        const url = this.buildUrl('/occurrence/count', queryParams);
+        ctx.log.debug('Counting occurrences', { taxonKey: params.taxonKey });
+        return this.getJson(url, ctx);
+    }
+    getOccurrence(occurrenceKey, ctx) {
+        const url = this.buildUrl(`/occurrence/${occurrenceKey}`);
+        ctx.log.debug('Fetching occurrence record', { occurrenceKey });
+        return this.getJson(url, ctx);
+    }
+    getOccurrenceFacets(params, ctx) {
+        const queryParams = { limit: 0, facet: params.facet };
+        if (params.taxonKey !== undefined)
+            queryParams.taxonKey = params.taxonKey;
+        if (params.country)
+            queryParams.country = params.country;
+        if (params.year)
+            queryParams.year = params.year;
+        if (params.basisOfRecord)
+            queryParams.basisOfRecord = params.basisOfRecord;
+        if (params.geometry)
+            queryParams.geometry = params.geometry;
+        if (params.facetLimit !== undefined)
+            queryParams.facetLimit = params.facetLimit;
+        const url = this.buildUrl('/occurrence/search', queryParams);
+        ctx.log.debug('Fetching occurrence facets', { facet: params.facet });
+        return this.getJson(url, ctx);
+    }
+    // ─── Datasets ─────────────────────────────────────────────────────────────────
+    searchDatasets(params, ctx) {
+        const queryParams = {};
+        if (params.q)
+            queryParams.q = params.q;
+        if (params.type)
+            queryParams.type = params.type;
+        if (params.publishingCountry)
+            queryParams.publishingCountry = params.publishingCountry;
+        if (params.hostingOrg)
+            queryParams.hostingOrg = params.hostingOrg;
+        if (params.limit !== undefined)
+            queryParams.limit = params.limit;
+        if (params.offset !== undefined)
+            queryParams.offset = params.offset;
+        const url = this.buildUrl('/dataset/search', queryParams);
+        ctx.log.debug('Searching datasets', { q: params.q, type: params.type });
+        return this.getJson(url, ctx);
+    }
+    getDataset(datasetKey, ctx) {
+        const url = this.buildUrl(`/dataset/${datasetKey}`);
+        ctx.log.debug('Fetching dataset record', { datasetKey });
+        return this.getJson(url, ctx);
+    }
+    // ─── Publishers/Organizations ─────────────────────────────────────────────────
+    searchPublishers(params, ctx) {
+        const queryParams = {};
+        if (params.q)
+            queryParams.q = params.q;
+        if (params.country)
+            queryParams.country = params.country;
+        if (params.limit !== undefined)
+            queryParams.limit = params.limit;
+        if (params.offset !== undefined)
+            queryParams.offset = params.offset;
+        const url = this.buildUrl('/organization', queryParams);
+        ctx.log.debug('Searching publishers', { q: params.q, country: params.country });
+        return this.getJson(url, ctx);
+    }
+}
+// ─── Init/accessor pattern ────────────────────────────────────────────────────
+let _service;
+export function initGbifService(config, storage, opts) {
+    _service = new GbifService(config, storage, opts);
+}
+export function getGbifService() {
+    if (!_service) {
+        throw new Error('GbifService not initialized — call initGbifService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=gbif-service.js.map

package/dist/services/gbif/gbif-service.js.map

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