@cyanheads/imf-mcp-server 0.1.1

package/dist/services/imf-sdmx/imf-sdmx-service.js

@@ -0,0 +1,415 @@
+/**
+ * @fileoverview IMF SDMX 3.0 REST API service — fetches dataflows, data structures,
+ * and observations from api.imf.org. Implements caching via ctx.state and retry.
+ * @module services/imf-sdmx/imf-sdmx-service
+ */
+import { notFound, serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout, withRetry } from '@cyanheads/mcp-ts-core/utils';
+const DATAFLOWS_CACHE_TTL = 3600; // 1 hour
+const DSD_CACHE_TTL = 86_400; // 24 hours
+export class ImfSdmxService {
+    baseUrl;
+    timeoutMs;
+    constructor(_config, _storage, baseUrl, timeoutMs) {
+        this.baseUrl = baseUrl.replace(/\/+$/, '');
+        this.timeoutMs = timeoutMs;
+    }
+    // ---------------------------------------------------------------------------
+    // Dataflow list
+    // ---------------------------------------------------------------------------
+    /** Fetch all dataflows, with 1-hour caching. */
+    async fetchDataflows(ctx) {
+        const cacheKey = 'imf/dataflows/all';
+        const cached = await ctx.state.get(cacheKey);
+        if (cached) {
+            ctx.log.debug('Dataflows served from cache', { count: cached.length });
+            return cached;
+        }
+        const raw = await withRetry(async () => {
+            const url = `${this.baseUrl}/structure/dataflow`;
+            ctx.log.debug('Fetching dataflow list', { url });
+            const response = await fetchWithTimeout(url, this.timeoutMs, ctx, {
+                headers: { Accept: 'application/json' },
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            return this.parseJson(text, 'dataflow list');
+        }, {
+            operation: 'ImfSdmxService.fetchDataflows',
+            context: ctx,
+            maxRetries: 3,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+        const dataflows = this.normalizeDataflows(raw);
+        await ctx.state.set(cacheKey, dataflows, { ttl: DATAFLOWS_CACHE_TTL });
+        ctx.log.info('Dataflows fetched and cached', { count: dataflows.length });
+        return dataflows;
+    }
+    /** Find a dataflow by id, optionally constraining by agencyId/version. */
+    async findDataflow(dataflowId, agencyId, version, ctx) {
+        const all = await this.fetchDataflows(ctx);
+        return all.find((df) => df.id === dataflowId &&
+            (agencyId == null || df.agencyId === agencyId) &&
+            (version == null || df.version === version));
+    }
+    // ---------------------------------------------------------------------------
+    // Data structure (DSD + codelists)
+    // ---------------------------------------------------------------------------
+    /** Fetch DSD with all codelists for a dataflow, with 24-hour caching. */
+    async fetchDataStructure(agencyId, dsdId, version, ctx) {
+        const cacheKey = `imf/dsd/${agencyId}/${dsdId}/${version}`;
+        const cached = await ctx.state.get(cacheKey);
+        if (cached) {
+            ctx.log.debug('DSD served from cache', { dsdId });
+            return cached;
+        }
+        const raw = await withRetry(async () => {
+            const url = `${this.baseUrl}/structure/datastructure/${encodeURIComponent(agencyId)}/${encodeURIComponent(dsdId)}/${encodeURIComponent(version)}?references=all`;
+            ctx.log.debug('Fetching data structure', { url });
+            const response = await fetchWithTimeout(url, this.timeoutMs, ctx, {
+                headers: { Accept: 'application/json' },
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            return this.parseJson(text, 'data structure');
+        }, {
+            operation: 'ImfSdmxService.fetchDataStructure',
+            context: ctx,
+            maxRetries: 3,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+        const structure = this.normalizeDsd(raw, agencyId, dsdId, version);
+        if (!structure)
+            return;
+        await ctx.state.set(cacheKey, structure, { ttl: DSD_CACHE_TTL });
+        return structure;
+    }
+    /**
+     * Fetch a dataflow's structure, resolving the DSD reference from the dataflow
+     * list if not provided.
+     */
+    async fetchDataflowStructure(dataflowId, agencyId, version, ctx) {
+        const dataflow = await this.findDataflow(dataflowId, agencyId, version, ctx);
+        if (!dataflow) {
+            throw notFound(`Dataflow '${dataflowId}' not found`, {
+                reason: 'dataflow_not_found',
+                dataflowId,
+            });
+        }
+        // Derive DSD id from the dataflow — IMF SDMX 3.0 uses DSD_<FLOW_ID> naming for most flows.
+        // We fetch the structure endpoint directly using the dataflow's agency+version.
+        const dsdId = `DSD_${dataflowId}`;
+        let structure;
+        try {
+            structure = await this.fetchDataStructure(dataflow.agencyId, dsdId, dataflow.version, ctx).catch(() => this.fetchDataflowStructureFallback(dataflowId, dataflow.agencyId, dataflow.version, ctx));
+        }
+        catch {
+            // Both primary and fallback DSD fetch failed; throw a controlled message
+            // (the raw McpError would carry the upstream URL path in its message).
+            throw serviceUnavailable(`Structure unavailable for dataflow '${dataflowId}'`, {
+                reason: 'structure_unavailable',
+                dataflowId,
+            });
+        }
+        if (!structure) {
+            throw serviceUnavailable(`Structure unavailable for dataflow '${dataflowId}'`, {
+                reason: 'structure_unavailable',
+                dataflowId,
+            });
+        }
+        // Merge name/description from the dataflow into the structure.
+        const mergedDescription = structure.description ?? dataflow.description;
+        return {
+            ...structure,
+            dataflowId,
+            name: structure.name || dataflow.name,
+            ...(mergedDescription ? { description: mergedDescription } : {}),
+        };
+    }
+    /** Fallback: fetch structure using the dataflow endpoint path directly. */
+    async fetchDataflowStructureFallback(dataflowId, agencyId, version, ctx) {
+        const cacheKey = `imf/dsd-fb/${agencyId}/${dataflowId}/${version}`;
+        const cached = await ctx.state.get(cacheKey);
+        if (cached)
+            return cached;
+        const raw = await withRetry(async () => {
+            const url = `${this.baseUrl}/structure/dataflow/${encodeURIComponent(agencyId)}/${encodeURIComponent(dataflowId)}/${encodeURIComponent(version)}?references=all`;
+            ctx.log.debug('Fetching dataflow structure (fallback)', { url });
+            const response = await fetchWithTimeout(url, this.timeoutMs, ctx, {
+                headers: { Accept: 'application/json' },
+                signal: ctx.signal,
+            });
+            const text = await response.text();
+            return this.parseJson(text, 'dataflow structure (fallback)');
+        }, {
+            operation: 'ImfSdmxService.fetchDataflowStructureFallback',
+            context: ctx,
+            maxRetries: 3,
+            baseDelayMs: 1000,
+            signal: ctx.signal,
+        });
+        const structure = this.normalizeDsd(raw, agencyId, dataflowId, version);
+        if (structure) {
+            await ctx.state.set(cacheKey, structure, { ttl: DSD_CACHE_TTL });
+        }
+        return structure;
+    }
+    // ---------------------------------------------------------------------------
+    // Data query
+    // ---------------------------------------------------------------------------
+    /** Fetch observations for a dataflow key over a time range. No cache — always live. */
+    async fetchData(agencyId, dataflowId, version, key, startPeriod, endPeriod, ctx, signal) {
+        const queryParams = new URLSearchParams();
+        if (startPeriod)
+            queryParams.set('startPeriod', startPeriod);
+        if (endPeriod)
+            queryParams.set('endPeriod', endPeriod);
+        const qsStr = queryParams.toString();
+        const qs = qsStr ? `?${qsStr}` : '';
+        // Build a minimal RequestContextLike for fetchWithTimeout when no ctx provided
+        const now = new Date().toISOString();
+        const fetchCtx = ctx
+            ? ctx
+            : { requestId: 'internal', timestamp: now };
+        const effectiveSignal = signal ?? ctx?.signal;
+        const raw = await withRetry(async () => {
+            const url = `${this.baseUrl}/data/dataflow/${encodeURIComponent(agencyId)}/${encodeURIComponent(dataflowId)}/${encodeURIComponent(version)}/${encodeURIComponent(key)}${qs}`;
+            if (ctx)
+                ctx.log.debug('Fetching data', { url });
+            const response = await fetchWithTimeout(url, this.timeoutMs, fetchCtx, {
+                headers: { Accept: 'application/json' },
+                ...(effectiveSignal ? { signal: effectiveSignal } : {}),
+            });
+            const text = await response.text();
+            return this.parseJson(text, 'data query');
+        }, {
+            operation: 'ImfSdmxService.fetchData',
+            context: ctx,
+            maxRetries: 3,
+            baseDelayMs: 1000,
+            ...(effectiveSignal ? { signal: effectiveSignal } : {}),
+        });
+        return this.decodeObservations(raw, dataflowId, key, startPeriod, endPeriod);
+    }
+    // ---------------------------------------------------------------------------
+    // Normalizers
+    // ---------------------------------------------------------------------------
+    normalizeDataflows(raw) {
+        const flows = raw.data?.dataflows ?? [];
+        return flows.map((f) => ({
+            id: f.id,
+            agencyId: f.agencyID ?? 'IMF',
+            version: f.version ?? '1.0',
+            name: f.names?.en ?? f.id,
+            ...(f.descriptions?.en ? { description: f.descriptions.en } : {}),
+        }));
+    }
+    normalizeDsd(raw, agencyId, id, version) {
+        const dsds = raw.data?.dataStructures ?? [];
+        const codelists = raw.data?.codelists ?? [];
+        const dataflows = raw.data?.dataflows ?? [];
+        // Build a codelist map: id → entries
+        const clMap = new Map();
+        for (const cl of codelists) {
+            const entries = (cl.codes ?? []).map((c) => ({
+                id: c.id,
+                name: c.names?.en ?? c.id,
+            }));
+            clMap.set(cl.id, entries);
+            if (cl.agencyID) {
+                clMap.set(`${cl.agencyID}:${cl.id}`, entries);
+                clMap.set(`${cl.agencyID}:${cl.id}:${cl.version ?? '1.0'}`, entries);
+            }
+        }
+        const dsd = dsds[0];
+        if (!dsd)
+            return;
+        const dimList = dsd.dataStructureComponents?.dimensionList?.dimensions ?? [];
+        // IMF SDMX 3.0 uses `position` (SDMX 3.0 spec); legacy used `keyPosition`.
+        const sorted = [...dimList].sort((a, b) => (a.position ?? a.keyPosition ?? 0) - (b.position ?? b.keyPosition ?? 0));
+        // Derive the dataflow ID portion for IMF naming-convention codelist lookup.
+        // IMF SDMX 3.0 does not populate localRepresentation.enumeration — codelists are
+        // identified by naming convention: CL_<FLOW_ID>_<DIM_ID> (flow-specific) or
+        // CL_<DIM_ID> (shared). Try flow-specific first, then shared.
+        const flowIdForCl = id.replace(/^DSD_/, '');
+        const dimensions = sorted.map((d, idx) => {
+            const dimId = d.id ?? `DIM_${idx}`;
+            const enumRef = d.localRepresentation?.enumeration;
+            let codelist = [];
+            // 1. IMF naming convention (primary path — enumeration is null on SDMX 3.0).
+            // Also try the concept ID extracted from the conceptIdentity URN (e.g. FREQ from
+            // "urn:sdmx:...CS_MASTER_SYSTEM(1.0).FREQ") since some shared codelists use the
+            // concept ID rather than the dimension ID (e.g. FREQUENCY dim → CL_FREQ codelist).
+            const conceptId = typeof d.conceptIdentity === 'string' ? d.conceptIdentity.replace(/^.*\./, '') : undefined;
+            const conventionKeys = [
+                `CL_${flowIdForCl}_${dimId}`,
+                `CL_${dimId}`,
+                ...(conceptId && conceptId !== dimId
+                    ? [`CL_${flowIdForCl}_${conceptId}`, `CL_${conceptId}`]
+                    : []),
+            ];
+            for (const k of conventionKeys) {
+                const found = clMap.get(k);
+                if (found && found.length > 0) {
+                    codelist = found;
+                    break;
+                }
+            }
+            // 2. Explicit enumeration reference (fallback for servers that populate it)
+            if (codelist.length === 0 && enumRef) {
+                const enumKeys = [
+                    `${enumRef.agencyID ?? ''}:${enumRef.id ?? ''}:${enumRef.version ?? ''}`,
+                    `${enumRef.agencyID ?? ''}:${enumRef.id ?? ''}`,
+                    enumRef.id ?? '',
+                ];
+                for (const k of enumKeys) {
+                    const found = clMap.get(k);
+                    if (found && found.length > 0) {
+                        codelist = found;
+                        break;
+                    }
+                }
+            }
+            return {
+                id: dimId,
+                name: dimId,
+                position: d.position ?? d.keyPosition ?? idx,
+                codelist,
+            };
+        });
+        // Build key format string from sorted dimension ids
+        const keyFormat = dimensions.map((d) => d.id).join('.');
+        // Get name from dataflow if available
+        const df = dataflows[0];
+        const name = dsd.names?.en ?? df?.names?.en ?? id;
+        const description = dsd.descriptions?.en ?? df?.descriptions?.en;
+        return {
+            dataflowId: id,
+            agencyId: dsd.agencyID ?? agencyId,
+            version: dsd.version ?? version,
+            name,
+            ...(description ? { description } : {}),
+            keyFormat,
+            dimensions,
+        };
+    }
+    decodeObservations(raw, dataflowId, key, startPeriod, endPeriod) {
+        const dataset = raw.data?.dataSets?.[0];
+        const structure = raw.data?.structures?.[0];
+        // Observation dimension (TIME_PERIOD)
+        const obsDims = structure?.dimensions?.observation ?? [];
+        const timeDim = obsDims[0];
+        const timeValues = timeDim?.values ?? [];
+        // Series attributes (UNIT, SCALE, DECIMALS, etc.)
+        const seriesAttrs = structure?.attributes?.series ?? [];
+        const obsAttrs = structure?.attributes?.observation ?? [];
+        // Find STATUS attribute index in observation attributes
+        const statusObsIdx = obsAttrs.findIndex((a) => a.id === 'STATUS');
+        // Find attribute indices in series attributes
+        const unitIdx = seriesAttrs.findIndex((a) => a.id === 'UNIT');
+        const scaleIdx = seriesAttrs.findIndex((a) => a.id === 'SCALE');
+        const decimalsIdx = seriesAttrs.findIndex((a) => a.id === 'DECIMALS_DISPLAYED');
+        const series = dataset?.series ?? {};
+        const observations = [];
+        let seriesAttributes = { unit: null, scale: null, decimals: null };
+        // Series-level dimensions for decoding the colon-separated series key ("0:0:0").
+        const seriesDims = structure?.dimensions?.series ?? [];
+        for (const [seriesKey, seriesData] of Object.entries(series)) {
+            // Decode the series key ("0:1:0") into dimension code values ("USA.NGDP_RPCH.A").
+            const seriesKeyParts = seriesKey.split(':');
+            const seriesCodeParts = seriesDims.map((dim, dimIdx) => {
+                const valIdx = parseInt(seriesKeyParts[dimIdx] ?? '0', 10);
+                const val = dim.values[valIdx];
+                return val?.id ?? val?.value ?? seriesKeyParts[dimIdx] ?? '';
+            });
+            const decodedSeriesKey = seriesCodeParts.join('.');
+            // Extract series-level attributes for the first series we find
+            if (seriesData.attributes) {
+                const attrs = seriesData.attributes;
+                seriesAttributes = {
+                    unit: this.resolveAttrValue(unitIdx, attrs, seriesAttrs),
+                    scale: this.resolveAttrValue(scaleIdx, attrs, seriesAttrs),
+                    decimals: this.resolveDecimalsValue(decimalsIdx, attrs),
+                };
+            }
+            // Decode observations
+            for (const [obsIdx, obsValues] of Object.entries(seriesData.observations ?? {})) {
+                const timeIdx = parseInt(obsIdx, 10);
+                // IMF SDMX 3.0 uses `value` field for time periods; fallback to `id` for legacy compat.
+                const timePeriod = timeValues[timeIdx]?.value ?? timeValues[timeIdx]?.id ?? obsIdx;
+                const rawValue = obsValues?.[0];
+                const value = rawValue != null && rawValue !== '' ? parseFloat(rawValue) : null;
+                let status = null;
+                if (statusObsIdx >= 0 && obsValues && obsValues[statusObsIdx + 1] != null) {
+                    const statusCode = obsValues[statusObsIdx + 1];
+                    const statusAttr = obsAttrs[statusObsIdx];
+                    if (statusCode != null && statusAttr?.values) {
+                        const idx2 = parseInt(statusCode, 10);
+                        status = statusAttr.values[idx2]?.id ?? statusCode;
+                    }
+                }
+                observations.push({ series_key: decodedSeriesKey, time_period: timePeriod, value, status });
+            }
+        }
+        // Sort observations by time_period
+        observations.sort((a, b) => a.time_period.localeCompare(b.time_period));
+        return {
+            dataflowId,
+            key,
+            ...(startPeriod ? { startPeriod } : {}),
+            ...(endPeriod ? { endPeriod } : {}),
+            observations,
+            seriesAttributes,
+        };
+    }
+    resolveAttrValue(attrIdx, attrValues, attrDefs) {
+        if (attrIdx < 0 || attrIdx >= attrValues.length)
+            return null;
+        const raw = attrValues[attrIdx];
+        if (raw == null)
+            return null;
+        const def = attrDefs[attrIdx];
+        if (def?.values) {
+            const idx = parseInt(raw, 10);
+            if (!Number.isNaN(idx))
+                return def.values[idx]?.name ?? def.values[idx]?.id ?? raw;
+        }
+        return raw;
+    }
+    resolveDecimalsValue(attrIdx, attrValues) {
+        if (attrIdx < 0 || attrIdx >= attrValues.length)
+            return null;
+        const raw = attrValues[attrIdx];
+        if (raw == null)
+            return null;
+        const n = parseInt(raw, 10);
+        return Number.isNaN(n) ? null : n;
+    }
+    parseJson(text, context) {
+        if (/^\s*<(!DOCTYPE\s+html|html[\s>])/i.test(text)) {
+            throw serviceUnavailable(`IMF API returned HTML instead of JSON (${context})`);
+        }
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            throw serviceUnavailable(`Failed to parse IMF API response as JSON (${context})`);
+        }
+    }
+}
+// ---------------------------------------------------------------------------
+// Init/accessor pattern
+// ---------------------------------------------------------------------------
+let _service;
+export function initImfSdmxService(config, storage, baseUrl, timeoutMs) {
+    _service = new ImfSdmxService(config, storage, baseUrl, timeoutMs);
+}
+export function getImfSdmxService() {
+    if (!_service) {
+        throw new Error('ImfSdmxService not initialized — call initImfSdmxService() in setup()');
+    }
+    return _service;
+}
+//# sourceMappingURL=imf-sdmx-service.js.map

package/dist/services/imf-sdmx/imf-sdmx-service.js.map

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

package/dist/services/imf-sdmx/types.d.ts

@@ -0,0 +1,157 @@
+/**
+ * @fileoverview Domain types for the IMF SDMX 3.0 service.
+ * @module services/imf-sdmx/types
+ */
+/** A single dataflow entry from the IMF SDMX structure/dataflow endpoint. */
+export interface Dataflow {
+    agencyId: string;
+    description?: string;
+    id: string;
+    name: string;
+    version: string;
+}
+/** A single codelist entry: the machine code and human-readable name. */
+export interface CodelistEntry {
+    id: string;
+    name: string;
+}
+/** A single dimension in a dataflow's data structure definition. */
+export interface Dimension {
+    codelist: CodelistEntry[];
+    id: string;
+    name: string;
+    position: number;
+}
+/** Fully-described dataflow including all dimensions and their codelists. */
+export interface DataflowStructure {
+    agencyId: string;
+    dataflowId: string;
+    description?: string;
+    dimensions: Dimension[];
+    /** Dimension names in keyPosition order, e.g. "COUNTRY.INDICATOR.FREQUENCY" */
+    keyFormat: string;
+    name: string;
+    version: string;
+}
+/** A decoded observation row. */
+export interface Observation {
+    /** Dot-separated dimension codes for this series, e.g. "USA.NGDP_RPCH.A". */
+    series_key: string;
+    status: string | null;
+    time_period: string;
+    value: number | null;
+}
+/** Attributes carried per-series (unit, scale, decimals). */
+export interface SeriesAttributes {
+    decimals: number | null;
+    scale: string | null;
+    unit: string | null;
+}
+/** Result of a data query, pre-spill. */
+export interface DataQueryResult {
+    dataflowId: string;
+    endPeriod?: string;
+    key: string;
+    observations: Observation[];
+    seriesAttributes: SeriesAttributes;
+    startPeriod?: string;
+}
+/** Raw SDMX 3.0 JSON response shape (compact format). */
+export interface SdmxDataResponse {
+    data?: {
+        dataSets?: Array<{
+            series?: Record<string, SdmxSeries>;
+        }>;
+        structures?: Array<SdmxStructure>;
+    };
+}
+export interface SdmxSeries {
+    attributes?: Array<string | null>;
+    observations?: Record<string, Array<string | null>>;
+}
+export interface SdmxStructure {
+    attributes?: {
+        series?: Array<SdmxAttributeDef>;
+        observation?: Array<SdmxAttributeDef>;
+    };
+    dimensions?: {
+        /** Series-level dimensions — values array lists the code for each index position in the series key. */
+        series?: Array<SdmxDimensionDef>;
+        observation?: Array<SdmxDimensionDef>;
+    };
+}
+export interface SdmxDimensionDef {
+    id: string;
+    /** IMF SDMX 3.0 uses `value` for observation dimension values (e.g. time periods);
+     *  legacy SDMX 2.1 used `id`. Both are optional to handle either format. */
+    values: Array<{
+        id?: string;
+        value?: string;
+        name?: string;
+    }>;
+}
+export interface SdmxAttributeDef {
+    id: string;
+    values?: Array<{
+        id: string;
+        name?: string;
+    }>;
+}
+/** Raw SDMX structure response shape. */
+export interface SdmxStructureResponse {
+    data?: {
+        dataflows?: Array<{
+            id: string;
+            agencyID?: string;
+            version?: string;
+            names?: Record<string, string>;
+            descriptions?: Record<string, string>;
+            structure?: {
+                id: string;
+                agencyID?: string;
+                version?: string;
+            };
+        }>;
+        dataStructures?: Array<{
+            id: string;
+            agencyID?: string;
+            version?: string;
+            names?: Record<string, string>;
+            descriptions?: Record<string, string>;
+            dataStructureComponents?: {
+                dimensionList?: {
+                    dimensions?: Array<{
+                        id?: string;
+                        /** String URN in IMF SDMX 3.0 (e.g. "urn:sdmx:...=IMF.RES:CS_WEO(4.0).COUNTRY"). */
+                        conceptIdentity?: string | {
+                            id?: string;
+                            urn?: string;
+                        };
+                        /** SDMX 3.0 position — IMF returns this field instead of keyPosition. */
+                        position?: number;
+                        /** Legacy SDMX 2.1 position field — absent on IMF SDMX 3.0. */
+                        keyPosition?: number;
+                        localRepresentation?: {
+                            enumeration?: {
+                                id?: string;
+                                agencyID?: string;
+                                version?: string;
+                            };
+                        };
+                    }>;
+                };
+            };
+        }>;
+        codelists?: Array<{
+            id: string;
+            agencyID?: string;
+            version?: string;
+            names?: Record<string, string>;
+            codes?: Array<{
+                id: string;
+                names?: Record<string, string>;
+            }>;
+        }>;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/imf-sdmx/types.d.ts.map

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

package/dist/services/imf-sdmx/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Domain types for the IMF SDMX 3.0 service.
+ * @module services/imf-sdmx/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/imf-sdmx/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/imf-sdmx/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}