@littlebearapps/australian-history-mcp 0.6.0

package/dist/sources/iiif/index.js

@@ -0,0 +1,31 @@
+/**
+ * IIIF (International Image Interoperability Framework) Source Module
+ *
+ * Provides tools for working with IIIF-compliant image repositories
+ * including manifest retrieval and image URL construction.
+ *
+ * Works with any institution implementing IIIF APIs including:
+ * - State Library Victoria (rosetta.slv.vic.gov.au)
+ * - National Library of Australia (nla.gov.au)
+ * - Bodleian Libraries, Oxford
+ * - Many other GLAM institutions worldwide
+ *
+ * No API key required.
+ */
+import { defineSource } from '../../core/base-source.js';
+import { iiifGetManifestTool } from './tools/get-manifest.js';
+import { iiifGetImageUrlTool } from './tools/get-image-url.js';
+export const iiifSource = defineSource({
+    name: 'iiif',
+    displayName: 'IIIF (International Image Interoperability Framework)',
+    description: 'Generic IIIF tools for fetching manifests and constructing image URLs from any IIIF-compliant institution.',
+    requiresAuth: false,
+    tools: [
+        iiifGetManifestTool,
+        iiifGetImageUrlTool,
+    ],
+});
+// Re-export types and client for external use
+export * from './types.js';
+export { iiifClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/sources/iiif/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/sources/iiif/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAE/D,MAAM,CAAC,MAAM,UAAU,GAAG,YAAY,CAAC;IACrC,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,uDAAuD;IACpE,WAAW,EAAE,4GAA4G;IACzH,YAAY,EAAE,KAAK;IACnB,KAAK,EAAE;QACL,mBAAmB;QACnB,mBAAmB;KACpB;CACF,CAAC,CAAC;AAEH,8CAA8C;AAC9C,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/sources/iiif/tools/get-image-url.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IIIF Get Image URL Tool
+ *
+ * Constructs IIIF Image API URLs for various sizes, regions, and formats.
+ * Works with any IIIF Image API v2.x compliant server.
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const iiifGetImageUrlTool: SourceTool;
+//# sourceMappingURL=get-image-url.d.ts.map

package/dist/sources/iiif/tools/get-image-url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-image-url.d.ts","sourceRoot":"","sources":["../../../../src/sources/iiif/tools/get-image-url.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI/D,eAAO,MAAM,mBAAmB,EAAE,UAmGjC,CAAC"}

package/dist/sources/iiif/tools/get-image-url.js

@@ -0,0 +1,101 @@
+/**
+ * IIIF Get Image URL Tool
+ *
+ * Constructs IIIF Image API URLs for various sizes, regions, and formats.
+ * Works with any IIIF Image API v2.x compliant server.
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { iiifClient } from '../client.js';
+export const iiifGetImageUrlTool = {
+    schema: {
+        name: 'iiif_get_image_url',
+        description: `Construct IIIF Image API URLs for downloading images in various sizes and formats.
+
+Requires an image service URL from a manifest (imageServiceUrl field from iiif_get_manifest).
+
+Examples:
+- Full size: region=full, size=max
+- Thumbnail: region=full, size=!200,200
+- Specific region: region=100,100,500,500, size=max
+- Percentage: region=full, size=pct:50`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                imageServiceUrl: {
+                    type: 'string',
+                    description: 'The IIIF Image API base URL (from manifest imageServiceUrl field)',
+                },
+                region: {
+                    type: 'string',
+                    description: 'Image region: "full", "square", or "x,y,w,h" coordinates, or "pct:x,y,w,h" for percentages',
+                    default: 'full',
+                },
+                size: {
+                    type: 'string',
+                    description: 'Image size: "max", "full", "w,", ",h", "pct:n", "w,h", or "!w,h" (best fit)',
+                    default: 'max',
+                },
+                rotation: {
+                    type: 'string',
+                    description: 'Rotation in degrees: "0", "90", "180", "270", or "!n" for mirrored',
+                    default: '0',
+                },
+                quality: {
+                    type: 'string',
+                    description: 'Image quality: "default", "color", "gray", or "bitonal"',
+                    enum: ['default', 'color', 'gray', 'bitonal'],
+                    default: 'default',
+                },
+                format: {
+                    type: 'string',
+                    description: 'Output format: "jpg", "png", "gif", "webp", or "tif"',
+                    enum: ['jpg', 'png', 'gif', 'webp', 'tif'],
+                    default: 'jpg',
+                },
+            },
+            required: ['imageServiceUrl'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        try {
+            const url = iiifClient.constructImageUrl({
+                baseUrl: input.imageServiceUrl,
+                region: (input.region ?? 'full'),
+                size: (input.size ?? 'max'),
+                rotation: (input.rotation ?? '0'),
+                quality: input.quality ?? 'default',
+                format: input.format ?? 'jpg',
+            });
+            // Parse size for response description
+            let sizeDescription = input.size ?? 'max (full resolution)';
+            if (input.size?.startsWith('!')) {
+                sizeDescription = `Best fit within ${input.size.substring(1)} pixels`;
+            }
+            else if (input.size?.startsWith('pct:')) {
+                sizeDescription = `${input.size.substring(4)}% of original`;
+            }
+            else if (input.size === 'max' || input.size === 'full') {
+                sizeDescription = 'Full resolution';
+            }
+            return successResponse({
+                source: 'iiif',
+                imageUrl: url,
+                parameters: {
+                    imageServiceUrl: input.imageServiceUrl,
+                    region: input.region ?? 'full',
+                    size: input.size ?? 'max',
+                    rotation: input.rotation ?? '0',
+                    quality: input.quality ?? 'default',
+                    format: input.format ?? 'jpg',
+                },
+                description: `IIIF Image URL constructed. Size: ${sizeDescription}`,
+                usageNote: 'Use this URL to download the image directly. The server will generate the requested variant on-demand.',
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-image-url.js.map

package/dist/sources/iiif/tools/get-image-url.js.map

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

package/dist/sources/iiif/tools/get-manifest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * IIIF Get Manifest Tool
+ *
+ * Fetches and parses IIIF Presentation API manifests from any institution.
+ * Returns structured data about the manifest including canvas/image information.
+ */
+import type { SourceTool } from '../../../core/base-source.js';
+export declare const iiifGetManifestTool: SourceTool;
+//# sourceMappingURL=get-manifest.d.ts.map

package/dist/sources/iiif/tools/get-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-manifest.d.ts","sourceRoot":"","sources":["../../../../src/sources/iiif/tools/get-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAI/D,eAAO,MAAM,mBAAmB,EAAE,UAoFjC,CAAC"}

package/dist/sources/iiif/tools/get-manifest.js

@@ -0,0 +1,87 @@
+/**
+ * IIIF Get Manifest Tool
+ *
+ * Fetches and parses IIIF Presentation API manifests from any institution.
+ * Returns structured data about the manifest including canvas/image information.
+ */
+import { successResponse, errorResponse } from '../../../core/types.js';
+import { iiifClient } from '../client.js';
+export const iiifGetManifestTool = {
+    schema: {
+        name: 'iiif_get_manifest',
+        description: `Fetch and parse an IIIF manifest from any IIIF-compliant institution.
+
+Common manifest URL patterns:
+- SLV: https://rosetta.slv.vic.gov.au/delivery/iiif/presentation/2.1/{IE_ID}/manifest
+- NLA: https://nla.gov.au/nla.obj-{ID}/manifest
+- Bodleian: https://iiif.bodleian.ox.ac.uk/iiif/manifest/{ID}.json
+
+Returns structured data including label, description, attribution, and canvas/image details.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                manifestUrl: {
+                    type: 'string',
+                    description: 'Full URL to the IIIF manifest (e.g., https://rosetta.slv.vic.gov.au/delivery/iiif/presentation/2.1/IE145082/manifest)',
+                },
+                includeCanvases: {
+                    type: 'boolean',
+                    description: 'Include detailed canvas/image information (default: true)',
+                    default: true,
+                },
+                maxCanvases: {
+                    type: 'number',
+                    description: 'Maximum number of canvases to include in response (default: 50)',
+                    default: 50,
+                },
+            },
+            required: ['manifestUrl'],
+        },
+    },
+    async execute(args) {
+        const input = args;
+        try {
+            const manifest = await iiifClient.getManifest(input.manifestUrl);
+            const includeCanvases = input.includeCanvases !== false;
+            const maxCanvases = Math.min(input.maxCanvases ?? 50, 200);
+            return successResponse({
+                source: 'iiif',
+                manifestUrl: input.manifestUrl,
+                id: manifest.id,
+                label: manifest.label,
+                description: manifest.description,
+                attribution: manifest.attribution,
+                license: manifest.license,
+                thumbnailUrl: manifest.thumbnailUrl,
+                metadata: manifest.metadata,
+                totalCanvases: manifest.totalCanvases,
+                canvases: includeCanvases
+                    ? manifest.canvases.slice(0, maxCanvases).map((c) => ({
+                        id: c.id,
+                        label: c.label,
+                        width: c.width,
+                        height: c.height,
+                        thumbnailUrl: c.thumbnailUrl,
+                        imageServiceUrl: c.imageServiceUrl,
+                        // Construct full-size image URL if service is available
+                        fullImageUrl: c.imageServiceUrl
+                            ? iiifClient.constructImageUrl({
+                                baseUrl: c.imageServiceUrl,
+                                region: 'full',
+                                size: 'max',
+                                rotation: '0',
+                                quality: 'default',
+                                format: 'jpg',
+                            })
+                            : c.imageUrl,
+                    }))
+                    : undefined,
+                hasMoreCanvases: manifest.totalCanvases > maxCanvases,
+            });
+        }
+        catch (error) {
+            return errorResponse(error);
+        }
+    },
+};
+//# sourceMappingURL=get-manifest.js.map

package/dist/sources/iiif/tools/get-manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-manifest.js","sourceRoot":"","sources":["../../../../src/sources/iiif/tools/get-manifest.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACxE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,CAAC,MAAM,mBAAmB,GAAe;IAC7C,MAAM,EAAE;QACN,IAAI,EAAE,mBAAmB;QACzB,WAAW,EAAE;;;;;;;6FAO4E;QACzF,WAAW,EAAE;YACX,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uHAAuH;iBACrI;gBACD,eAAe,EAAE;oBACf,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,2DAA2D;oBACxE,OAAO,EAAE,IAAI;iBACd;gBACD,WAAW,EAAE;oBACX,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iEAAiE;oBAC9E,OAAO,EAAE,EAAE;iBACZ;aACF;YACD,QAAQ,EAAE,CAAC,aAAa,CAAC;SAC1B;KACF;IAED,KAAK,CAAC,OAAO,CAAC,IAA6B;QACzC,MAAM,KAAK,GAAG,IAIb,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAEjE,MAAM,eAAe,GAAG,KAAK,CAAC,eAAe,KAAK,KAAK,CAAC;YACxD,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,IAAI,EAAE,EAAE,GAAG,CAAC,CAAC;YAE3D,OAAO,eAAe,CAAC;gBACrB,MAAM,EAAE,MAAM;gBACd,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,EAAE,EAAE,QAAQ,CAAC,EAAE;gBACf,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,WAAW,EAAE,QAAQ,CAAC,WAAW;gBACjC,OAAO,EAAE,QAAQ,CAAC,OAAO;gBACzB,YAAY,EAAE,QAAQ,CAAC,YAAY;gBACnC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,aAAa,EAAE,QAAQ,CAAC,aAAa;gBACrC,QAAQ,EAAE,eAAe;oBACvB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;wBAClD,EAAE,EAAE,CAAC,CAAC,EAAE;wBACR,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,KAAK,EAAE,CAAC,CAAC,KAAK;wBACd,MAAM,EAAE,CAAC,CAAC,MAAM;wBAChB,YAAY,EAAE,CAAC,CAAC,YAAY;wBAC5B,eAAe,EAAE,CAAC,CAAC,eAAe;wBAClC,wDAAwD;wBACxD,YAAY,EAAE,CAAC,CAAC,eAAe;4BAC7B,CAAC,CAAC,UAAU,CAAC,iBAAiB,CAAC;gCAC3B,OAAO,EAAE,CAAC,CAAC,eAAe;gCAC1B,MAAM,EAAE,MAAM;gCACd,IAAI,EAAE,KAAK;gCACX,QAAQ,EAAE,GAAG;gCACb,OAAO,EAAE,SAAS;gCAClB,MAAM,EAAE,KAAK;6BACd,CAAC;4BACJ,CAAC,CAAC,CAAC,CAAC,QAAQ;qBACf,CAAC,CAAC;oBACL,CAAC,CAAC,SAAS;gBACb,eAAe,EAAE,QAAQ,CAAC,aAAa,GAAG,WAAW;aACtD,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/sources/iiif/types.d.ts

@@ -0,0 +1,123 @@
+/**
+ * IIIF (International Image Interoperability Framework) Type Definitions
+ *
+ * Supports IIIF Presentation API v2.x manifests and Image API v2.x
+ */
+export interface IIIFManifest {
+    '@context': string;
+    '@id': string;
+    '@type': 'sc:Manifest';
+    label: string;
+    description?: string;
+    attribution?: string;
+    license?: string;
+    logo?: string;
+    thumbnail?: string | IIIFThumbnail;
+    metadata?: IIIFMetadata[];
+    sequences: IIIFSequence[];
+    structures?: IIIFRange[];
+}
+export interface IIIFThumbnail {
+    '@id': string;
+    '@type'?: string;
+    service?: IIIFImageService;
+}
+export interface IIIFMetadata {
+    label: string;
+    value: string | string[];
+}
+export interface IIIFSequence {
+    '@id': string;
+    '@type': 'sc:Sequence';
+    label?: string;
+    viewingDirection?: 'left-to-right' | 'right-to-left' | 'top-to-bottom' | 'bottom-to-top';
+    viewingHint?: string;
+    canvases: IIIFCanvas[];
+}
+export interface IIIFCanvas {
+    '@id': string;
+    '@type': 'sc:Canvas';
+    label: string;
+    height: number;
+    width: number;
+    thumbnail?: string | IIIFThumbnail;
+    images: IIIFAnnotation[];
+}
+export interface IIIFAnnotation {
+    '@id': string;
+    '@type': 'oa:Annotation';
+    motivation: string;
+    resource: IIIFResource;
+    on: string;
+}
+export interface IIIFResource {
+    '@id': string;
+    '@type': string;
+    format: string;
+    height: number;
+    width: number;
+    service?: IIIFImageService;
+}
+export interface IIIFImageService {
+    '@context': string;
+    '@id': string;
+    profile: string;
+}
+export interface IIIFRange {
+    '@id': string;
+    '@type': 'sc:Range';
+    label: string;
+    canvases?: string[];
+    ranges?: string[];
+}
+export type IIIFRegion = 'full' | 'square' | `${number},${number},${number},${number}` | `pct:${number},${number},${number},${number}`;
+export type IIIFSize = 'full' | 'max' | `${number},` | `,${number}` | `pct:${number}` | `${number},${number}` | `!${number},${number}`;
+export type IIIFRotation = '0' | '90' | '180' | '270' | `!${number}` | `${number}`;
+export type IIIFQuality = 'default' | 'color' | 'gray' | 'bitonal';
+export type IIIFFormat = 'jpg' | 'png' | 'gif' | 'webp' | 'tif';
+export interface IIIFImageParams {
+    baseUrl: string;
+    region?: IIIFRegion;
+    size?: IIIFSize;
+    rotation?: IIIFRotation;
+    quality?: IIIFQuality;
+    format?: IIIFFormat;
+}
+export interface ParsedManifest {
+    id: string;
+    label: string;
+    description?: string;
+    attribution?: string;
+    license?: string;
+    thumbnailUrl?: string;
+    metadata: Record<string, string | string[]>;
+    totalCanvases: number;
+    canvases: ParsedCanvas[];
+}
+export interface ParsedCanvas {
+    id: string;
+    label: string;
+    width: number;
+    height: number;
+    thumbnailUrl?: string;
+    imageServiceUrl?: string;
+    imageUrl?: string;
+}
+export declare const KNOWN_IIIF_PROVIDERS: {
+    readonly slv: {
+        readonly name: "State Library Victoria";
+        readonly manifestPattern: "https://rosetta.slv.vic.gov.au/delivery/iiif/presentation/2.1/{id}/manifest";
+        readonly imagePattern: "https://rosetta.slv.vic.gov.au:2083/iiif/2/{id}/{region}/{size}/{rotation}/{quality}.{format}";
+    };
+    readonly nla: {
+        readonly name: "National Library of Australia";
+        readonly manifestPattern: "https://nla.gov.au/nla.obj-{id}/manifest";
+        readonly imagePattern: "https://nla.gov.au/nla.obj-{id}/image";
+    };
+    readonly bodleian: {
+        readonly name: "Bodleian Libraries, Oxford";
+        readonly manifestPattern: "https://iiif.bodleian.ox.ac.uk/iiif/manifest/{id}.json";
+        readonly imagePattern: "https://iiif.bodleian.ox.ac.uk/iiif/image/{id}";
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/sources/iiif/types.d.ts.map

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

package/dist/sources/iiif/types.js

@@ -0,0 +1,26 @@
+/**
+ * IIIF (International Image Interoperability Framework) Type Definitions
+ *
+ * Supports IIIF Presentation API v2.x manifests and Image API v2.x
+ */
+// ============================================================================
+// Known IIIF Providers (for documentation)
+// ============================================================================
+export const KNOWN_IIIF_PROVIDERS = {
+    slv: {
+        name: 'State Library Victoria',
+        manifestPattern: 'https://rosetta.slv.vic.gov.au/delivery/iiif/presentation/2.1/{id}/manifest',
+        imagePattern: 'https://rosetta.slv.vic.gov.au:2083/iiif/2/{id}/{region}/{size}/{rotation}/{quality}.{format}',
+    },
+    nla: {
+        name: 'National Library of Australia',
+        manifestPattern: 'https://nla.gov.au/nla.obj-{id}/manifest',
+        imagePattern: 'https://nla.gov.au/nla.obj-{id}/image',
+    },
+    bodleian: {
+        name: 'Bodleian Libraries, Oxford',
+        manifestPattern: 'https://iiif.bodleian.ox.ac.uk/iiif/manifest/{id}.json',
+        imagePattern: 'https://iiif.bodleian.ox.ac.uk/iiif/image/{id}',
+    },
+};
+//# sourceMappingURL=types.js.map

package/dist/sources/iiif/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/sources/iiif/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA+HH,+EAA+E;AAC/E,2CAA2C;AAC3C,+EAA+E;AAE/E,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,EAAE;QACH,IAAI,EAAE,wBAAwB;QAC9B,eAAe,EAAE,6EAA6E;QAC9F,YAAY,EAAE,+FAA+F;KAC9G;IACD,GAAG,EAAE;QACH,IAAI,EAAE,+BAA+B;QACrC,eAAe,EAAE,0CAA0C;QAC3D,YAAY,EAAE,uCAAuC;KACtD;IACD,QAAQ,EAAE;QACR,IAAI,EAAE,4BAA4B;QAClC,eAAe,EAAE,wDAAwD;QACzE,YAAY,EAAE,gDAAgD;KAC/D;CACO,CAAC"}

package/dist/sources/museums-victoria/client.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Museums Victoria Collections API Client
+ *
+ * Provides access to Museums Victoria's collection of objects, specimens,
+ * species, and articles. No API key required.
+ *
+ * API Documentation: https://collections.museumsvictoria.com.au/developers
+ */
+import { BaseClient } from '../../core/base-client.js';
+import type { MuseumSearchParams, MuseumSearchResult, MuseumArticle, MuseumItem, MuseumSpecies, MuseumSpecimen } from './types.js';
+export declare class MuseumsVictoriaClient extends BaseClient {
+    constructor();
+    /**
+     * Search across the entire collection
+     */
+    search(params: MuseumSearchParams): Promise<MuseumSearchResult>;
+    /**
+     * Strip type prefix from ID (e.g., "species/8436" -> "8436")
+     */
+    private stripIdPrefix;
+    /**
+     * Get an article by ID
+     */
+    getArticle(id: string): Promise<MuseumArticle | null>;
+    /**
+     * Get an item (object) by ID
+     */
+    getItem(id: string): Promise<MuseumItem | null>;
+    /**
+     * Get a species by ID
+     */
+    getSpecies(id: string): Promise<MuseumSpecies | null>;
+    /**
+     * Get a specimen by ID
+     */
+    getSpecimen(id: string): Promise<MuseumSpecimen | null>;
+    /**
+     * Search only articles
+     */
+    searchArticles(query: string, options?: Omit<MuseumSearchParams, 'query' | 'recordType'>): Promise<MuseumSearchResult>;
+    /**
+     * Search only items (objects)
+     */
+    searchItems(query: string, options?: Omit<MuseumSearchParams, 'query' | 'recordType'>): Promise<MuseumSearchResult>;
+    /**
+     * Search only species
+     */
+    searchSpecies(query: string, options?: Omit<MuseumSearchParams, 'query' | 'recordType'>): Promise<MuseumSearchResult>;
+    /**
+     * Search only specimens
+     */
+    searchSpecimens(query: string, options?: Omit<MuseumSearchParams, 'query' | 'recordType'>): Promise<MuseumSearchResult>;
+    private parseRecord;
+    private extractRecordType;
+    private parseArticle;
+    private parseItem;
+    private parseSpecies;
+    private parseSpecimen;
+    private parseMedia;
+    private parseTaxonomy;
+    private parseLicence;
+}
+export declare const museumsVictoriaClient: MuseumsVictoriaClient;
+//# sourceMappingURL=client.d.ts.map

package/dist/sources/museums-victoria/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/sources/museums-victoria/client.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AACvD,OAAO,KAAK,EACV,kBAAkB,EAClB,kBAAkB,EAElB,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EAGf,MAAM,YAAY,CAAC;AAIpB,qBAAa,qBAAsB,SAAQ,UAAU;;IASnD;;OAEG;IACG,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA6ErE;;OAEG;IACH,OAAO,CAAC,aAAa;IAIrB;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAe3D;;OAEG;IACG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAerD;;OAEG;IACG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAe3D;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAmB7D;;OAEG;IACG,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,YAAY,CAAC;IAI9F;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,YAAY,CAAC;IAI3F;;OAEG;IACG,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,YAAY,CAAC;IAI7F;;OAEG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,OAAO,GAAG,YAAY,CAAC;IAQ/F,OAAO,CAAC,WAAW;IAmBnB,OAAO,CAAC,iBAAiB;IAUzB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,SAAS;IAsBjB,OAAO,CAAC,YAAY;IAkBpB,OAAO,CAAC,aAAa;IA+BrB,OAAO,CAAC,UAAU;IAoClB,OAAO,CAAC,aAAa;IA0BrB,OAAO,CAAC,YAAY;CAUrB;AAGD,eAAO,MAAM,qBAAqB,uBAA8B,CAAC"}