@digital-science-dsl/dimensions-analytics-mcp 0.5.3

package/dist/client/rate-limiter.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Rate limiter using sliding window algorithm.
+ * @module core/rate-limiter
+ */
+/**
+ * Configuration options for the rate limiter.
+ */
+export interface RateLimiterConfig {
+    /** Maximum number of requests allowed within the window */
+    readonly maxRequests: number;
+    /** Time window in milliseconds */
+    readonly windowMs: number;
+}
+/**
+ * Implements rate limiting using a sliding window algorithm.
+ * Tracks request timestamps and enforces request limits over a rolling time window.
+ */
+export declare class RateLimiter {
+    private maxRequests;
+    private readonly windowMs;
+    private timestamps;
+    /**
+     * Creates a new RateLimiter instance.
+     * @param config - Rate limiter configuration
+     * @throws {Error} If maxRequests or windowMs is not positive
+     */
+    constructor(config: RateLimiterConfig);
+    /**
+     * Returns the current `maxRequests` ceiling.
+     */
+    getMaxRequests(): number;
+    /**
+     * Updates the `maxRequests` ceiling in place. Useful for callers that want
+     * to temporarily raise the limit for a high-throughput operation and
+     * restore it afterwards. Existing tracked timestamps are kept — only the
+     * ceiling moves.
+     * @throws {Error} If `n` is not positive
+     */
+    setMaxRequests(n: number): void;
+    /**
+     * Removes expired timestamps from the tracking array.
+     */
+    private cleanup;
+    /**
+     * Checks if a new request can be made without exceeding the rate limit.
+     * @returns True if a request is allowed, false if rate limited
+     */
+    canMakeRequest(): boolean;
+    /**
+     * Records a request timestamp. Call this when a request is made.
+     */
+    recordRequest(): void;
+    /**
+     * Gets the number of requests remaining in the current window.
+     * @returns Number of requests that can still be made
+     */
+    getRemainingRequests(): number;
+    /**
+     * Gets the time in milliseconds until the next request slot is available.
+     * @returns Time to wait in milliseconds, or 0 if a request can be made now
+     */
+    getTimeUntilNextSlot(): number;
+    /**
+     * Waits until a request slot is available.
+     * Use this to automatically throttle requests.
+     */
+    waitIfNeeded(): Promise<void>;
+    /**
+     * Suggested delay before retrying after a 429 from the API.
+     * Waits for the oldest in-window request to expire, or one minimum slot spacing.
+     * @returns Delay in milliseconds
+     */
+    getRetryDelayMs(): number;
+    /**
+     * Resets the rate limiter, clearing all recorded timestamps.
+     */
+    reset(): void;
+}
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/client/rate-limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.ts","sourceRoot":"","sources":["../../src/client/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,kCAAkC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,UAAU,CAAgB;IAElC;;;;OAIG;gBACS,MAAM,EAAE,iBAAiB;IAWrC;;OAEG;IACH,cAAc,IAAI,MAAM;IAIxB;;;;;;OAMG;IACH,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAO/B;;OAEG;IACH,OAAO,CAAC,OAAO;IAMf;;;OAGG;IACH,cAAc,IAAI,OAAO;IAKzB;;OAEG;IACH,aAAa,IAAI,IAAI;IAIrB;;;OAGG;IACH,oBAAoB,IAAI,MAAM;IAK9B;;;OAGG;IACH,oBAAoB,IAAI,MAAM;IAS9B;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAOnC;;;;OAIG;IACH,eAAe,IAAI,MAAM;IAQzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/client/rate-limiter.js

@@ -0,0 +1,118 @@
+/**
+ * Rate limiter using sliding window algorithm.
+ * @module core/rate-limiter
+ */
+/**
+ * Implements rate limiting using a sliding window algorithm.
+ * Tracks request timestamps and enforces request limits over a rolling time window.
+ */
+export class RateLimiter {
+    maxRequests;
+    windowMs;
+    timestamps = [];
+    /**
+     * Creates a new RateLimiter instance.
+     * @param config - Rate limiter configuration
+     * @throws {Error} If maxRequests or windowMs is not positive
+     */
+    constructor(config) {
+        if (config.maxRequests <= 0) {
+            throw new Error("maxRequests must be positive");
+        }
+        if (config.windowMs <= 0) {
+            throw new Error("windowMs must be positive");
+        }
+        this.maxRequests = config.maxRequests;
+        this.windowMs = config.windowMs;
+    }
+    /**
+     * Returns the current `maxRequests` ceiling.
+     */
+    getMaxRequests() {
+        return this.maxRequests;
+    }
+    /**
+     * Updates the `maxRequests` ceiling in place. Useful for callers that want
+     * to temporarily raise the limit for a high-throughput operation and
+     * restore it afterwards. Existing tracked timestamps are kept — only the
+     * ceiling moves.
+     * @throws {Error} If `n` is not positive
+     */
+    setMaxRequests(n) {
+        if (n <= 0) {
+            throw new Error("maxRequests must be positive");
+        }
+        this.maxRequests = n;
+    }
+    /**
+     * Removes expired timestamps from the tracking array.
+     */
+    cleanup() {
+        const now = Date.now();
+        const cutoff = now - this.windowMs;
+        this.timestamps = this.timestamps.filter((ts) => ts > cutoff);
+    }
+    /**
+     * Checks if a new request can be made without exceeding the rate limit.
+     * @returns True if a request is allowed, false if rate limited
+     */
+    canMakeRequest() {
+        this.cleanup();
+        return this.timestamps.length < this.maxRequests;
+    }
+    /**
+     * Records a request timestamp. Call this when a request is made.
+     */
+    recordRequest() {
+        this.timestamps.push(Date.now());
+    }
+    /**
+     * Gets the number of requests remaining in the current window.
+     * @returns Number of requests that can still be made
+     */
+    getRemainingRequests() {
+        this.cleanup();
+        return Math.max(0, this.maxRequests - this.timestamps.length);
+    }
+    /**
+     * Gets the time in milliseconds until the next request slot is available.
+     * @returns Time to wait in milliseconds, or 0 if a request can be made now
+     */
+    getTimeUntilNextSlot() {
+        this.cleanup();
+        if (this.timestamps.length < this.maxRequests) {
+            return 0;
+        }
+        const oldest = this.timestamps[0];
+        return Math.max(0, oldest + this.windowMs - Date.now());
+    }
+    /**
+     * Waits until a request slot is available.
+     * Use this to automatically throttle requests.
+     */
+    async waitIfNeeded() {
+        const waitTime = this.getTimeUntilNextSlot();
+        if (waitTime > 0) {
+            await new Promise((resolve) => setTimeout(resolve, waitTime));
+        }
+    }
+    /**
+     * Suggested delay before retrying after a 429 from the API.
+     * Waits for the oldest in-window request to expire, or one minimum slot spacing.
+     * @returns Delay in milliseconds
+     */
+    getRetryDelayMs() {
+        const slotWait = this.getTimeUntilNextSlot();
+        if (slotWait > 0) {
+            return slotWait + 50;
+        }
+        return Math.ceil(this.windowMs / this.maxRequests) + 50;
+    }
+    /**
+     * Resets the rate limiter, clearing all recorded timestamps.
+     */
+    reset() {
+        this.timestamps = [];
+    }
+}
+//# sourceMappingURL=rate-limiter.js.map

package/dist/client/rate-limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.js","sourceRoot":"","sources":["../../src/client/rate-limiter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,WAAW,CAAS;IACX,QAAQ,CAAS;IAC1B,UAAU,GAAa,EAAE,CAAC;IAElC;;;;OAIG;IACH,YAAY,MAAyB;QACnC,IAAI,MAAM,CAAC,WAAW,IAAI,CAAC,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,MAAM,CAAC,QAAQ,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;;;OAMG;IACH,cAAc,CAAC,CAAS;QACtB,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAClD,CAAC;QACD,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC;IACvB,CAAC;IAED;;OAEG;IACK,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC;QACnC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,cAAc;QACZ,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,aAAa;QACX,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACnC,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAChE,CAAC;IAED;;;OAGG;IACH,oBAAoB;QAClB,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC7C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAChE,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,eAAe;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,oBAAoB,EAAE,CAAC;QAC7C,IAAI,QAAQ,GAAG,CAAC,EAAE,CAAC;YACjB,OAAO,QAAQ,GAAG,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC;IAC1D,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC;IACvB,CAAC;CACF"}

package/dist/client/resolve-api-key-user.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Validates a Dimensions user API key via Radar auth.json and resolves user identity.
+ * @module client/resolve-api-key-user
+ */
+/** JWT `sub` prefix for internal API keys (not end-user keys). */
+export declare const JWT_API_KEY_SUB_PREFIX = "JWT_API_KEY_";
+export interface ResolveApiKeyUserOptions {
+    readonly apiKey: string;
+    readonly authUrl: string;
+    readonly clientIp?: string;
+    readonly timeout?: number;
+}
+/**
+ * Exchanges a user API key for identity via POST /api/auth.json.
+ * @returns User email (`sub` claim) for X-DIMENSIONS-USER
+ * @throws {AuthenticationError} When the key is invalid or is an internal service key
+ */
+export declare function resolveUserFromApiKey(options: ResolveApiKeyUserOptions): Promise<string>;
+/**
+ * Parses `Authorization: Bearer <token>` from an HTTP header value.
+ * @throws {AuthenticationError} When the header is missing or malformed
+ */
+export declare function parseBearerToken(authorizationHeader: string | undefined): string;
+//# sourceMappingURL=resolve-api-key-user.d.ts.map

package/dist/client/resolve-api-key-user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-api-key-user.d.ts","sourceRoot":"","sources":["../../src/client/resolve-api-key-user.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,kEAAkE;AAClE,eAAO,MAAM,sBAAsB,iBAAiB,CAAC;AAErD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAyD9F;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAWhF"}

package/dist/client/resolve-api-key-user.js

@@ -0,0 +1,80 @@
+/**
+ * Validates a Dimensions user API key via Radar auth.json and resolves user identity.
+ * @module client/resolve-api-key-user
+ */
+import { decodeJwtPayload, validateJwtStructure } from "./auth/jwt-utils.js";
+import { AuthResponseSchema } from "./auth/schemas.js";
+import { AuthenticationError, NetworkError, sanitizeErrorMessage } from "./errors.js";
+/** JWT `sub` prefix for internal API keys (not end-user keys). */
+export const JWT_API_KEY_SUB_PREFIX = "JWT_API_KEY_";
+/**
+ * Exchanges a user API key for identity via POST /api/auth.json.
+ * @returns User email (`sub` claim) for X-DIMENSIONS-USER
+ * @throws {AuthenticationError} When the key is invalid or is an internal service key
+ */
+export async function resolveUserFromApiKey(options) {
+    const authUrl = options.authUrl.replace(/\/$/, "");
+    const url = authUrl.endsWith("/api/auth.json") ? authUrl : `${authUrl}/api/auth.json`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), options.timeout ?? 30_000);
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (options.clientIp) {
+        headers["X-Forwarded-For"] = options.clientIp;
+    }
+    try {
+        const response = await fetch(url, {
+            method: "POST",
+            headers,
+            body: JSON.stringify({ key: options.apiKey }),
+            signal: controller.signal,
+        });
+        if (!response.ok) {
+            throw new AuthenticationError("Invalid or revoked API key");
+        }
+        const rawData = await response.json();
+        const parsed = AuthResponseSchema.safeParse(rawData);
+        if (!parsed.success) {
+            throw new AuthenticationError("Invalid authentication response");
+        }
+        const rawToken = parsed.data.token || parsed.data.access_token;
+        const token = validateJwtStructure(rawToken);
+        const payload = decodeJwtPayload(token);
+        const sub = payload.sub;
+        if (typeof sub !== "string" || sub.length === 0) {
+            throw new AuthenticationError("Authentication response missing user identity");
+        }
+        if (sub.startsWith(JWT_API_KEY_SUB_PREFIX)) {
+            throw new AuthenticationError("Internal API keys cannot be used with hosted MCP");
+        }
+        return sub;
+    }
+    catch (error) {
+        if (error instanceof AuthenticationError) {
+            throw error;
+        }
+        if (error instanceof Error && error.name === "AbortError") {
+            throw new NetworkError("Authentication request timeout");
+        }
+        throw new NetworkError(`Authentication failed: ${sanitizeErrorMessage(error)}`);
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Parses `Authorization: Bearer <token>` from an HTTP header value.
+ * @throws {AuthenticationError} When the header is missing or malformed
+ */
+export function parseBearerToken(authorizationHeader) {
+    if (!authorizationHeader?.trim()) {
+        throw new AuthenticationError("Missing Authorization header");
+    }
+    const match = /^Bearer\s+(\S+)\s*$/i.exec(authorizationHeader);
+    if (!match?.[1]) {
+        throw new AuthenticationError("Authorization header must be Bearer <api-key>");
+    }
+    return match[1];
+}
+//# sourceMappingURL=resolve-api-key-user.js.map

package/dist/client/resolve-api-key-user.js.map

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

package/dist/client/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Core type definitions for the Dimensions API infrastructure layer.
+ *
+ * DSL vocabulary types (operators, entities, search indexes) live in
+ * `@digital-science/dimensions-dsl` (`types/vocabulary`) — import from there.
+ *
+ * @module types
+ */
+/**
+ * Typed response from a Dimensions DSL query.
+ * Contains entity arrays keyed by entity type (e.g., `publications`, `grants`)
+ * and optional statistics metadata.
+ */
+export interface DslResponse {
+    /** Query statistics including total result count */
+    readonly _stats?: {
+        readonly total_count: number;
+    };
+    /** Entity results and other response fields */
+    [key: string]: unknown;
+}
+/**
+ * Options for individual query execution.
+ */
+export interface QueryExecutorOptions {
+    /** AbortSignal for cancellation */
+    readonly signal?: AbortSignal;
+    /** Request timeout override in milliseconds */
+    readonly timeout?: number;
+}
+/**
+ * Interface for executing raw DSL queries.
+ * Used to decouple FluentQueryBuilder from the concrete DimensionsClient.
+ */
+export interface QueryExecutor {
+    /**
+     * Executes a raw DSL query against the Dimensions API.
+     * @param dsl - The DSL query string to execute
+     * @param options - Optional signal and timeout overrides
+     * @returns The parsed API response with entity data and stats
+     */
+    rawQuery(dsl: string, options?: QueryExecutorOptions): Promise<DslResponse>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,+CAA+C;IAC/C,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,mCAAmC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7E"}

package/dist/client/types.js

@@ -0,0 +1,10 @@
+/**
+ * Core type definitions for the Dimensions API infrastructure layer.
+ *
+ * DSL vocabulary types (operators, entities, search indexes) live in
+ * `@digital-science/dimensions-dsl` (`types/vocabulary`) — import from there.
+ *
+ * @module types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/types.js.map

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