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

package/dist/client/http-client.js

@@ -0,0 +1,419 @@
+/**
+ * HTTP client for Dimensions API requests.
+ * Handles retry logic, timeout, and error mapping.
+ * @module core/http-client
+ */
+import { AuthenticationError, DimensionsError, NetworkError, NotFoundError, QuerySyntaxError, RateLimitError, ServerError, sanitizeErrorMessage, TimeoutError, UnprocessableEntityError, } from "./errors.js";
+/**
+ * HTTP client for making requests to the Dimensions API.
+ * Implements retry logic with client-side throttling and exponential backoff for transient errors.
+ */
+export class HttpClient {
+    baseUrl;
+    authProvider;
+    timeout;
+    maxRetries;
+    retryDelay;
+    rateLimiter;
+    /**
+     * Creates a new HttpClient instance.
+     * @param config - HTTP client configuration
+     */
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.authProvider = config.authProvider;
+        this.timeout = config.timeout ?? 30000;
+        this.maxRetries = config.maxRetries ?? 3;
+        this.retryDelay = config.retryDelay ?? 1000;
+        this.rateLimiter = config.rateLimiter;
+    }
+    /**
+     * Executes a DSL query against the Dimensions API.
+     * @param dsl - The DSL query string
+     * @param endpoint - API endpoint (default: /api/dsl/v2)
+     * @param options - Optional request overrides (timeout, signal)
+     * @returns The API response
+     * @throws {QuerySyntaxError} If the query syntax is invalid
+     * @throws {RateLimitError} If rate limit is exceeded after retries
+     * @throws {ServerError} If server error persists after retries
+     * @throws {NetworkError} If network error occurs after retries
+     * @throws {TimeoutError} If request times out
+     * @throws {AuthenticationError} If authentication fails
+     */
+    async query(dsl, endpoint = "/api/dsl/v2", options) {
+        const url = `${this.baseUrl}${endpoint}`;
+        return this.executeWithRetry(() => this.executeDslRequest(url, dsl, options));
+    }
+    /**
+     * Executes a single DSL request with raw body.
+     * @param url - Full request URL
+     * @param dsl - DSL query string (sent as raw body)
+     * @returns Parsed response
+     */
+    async executeDslRequest(url, dsl, options) {
+        return this.wrapFetch({
+            url,
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded" },
+            body: dsl,
+            timeoutMs: options?.timeout ?? this.timeout,
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Maps HTTP response status to appropriate error type.
+     * @param response - HTTP response
+     * @returns Appropriate error instance
+     */
+    async mapHttpError(response) {
+        const status = response.status;
+        switch (status) {
+            case 400: {
+                let message = "Query syntax error";
+                try {
+                    const body = (await response.json());
+                    if (body.error?.message) {
+                        message = body.error.message;
+                    }
+                }
+                catch {
+                    // Ignore JSON parse errors
+                }
+                return new QuerySyntaxError(message);
+            }
+            case 401:
+                return new AuthenticationError("Authentication failed");
+            case 403:
+                return new DimensionsError("Access denied", 403);
+            case 404: {
+                let message = "Resource not found";
+                try {
+                    const body = (await response.json());
+                    if (body.error?.message) {
+                        message = body.error.message;
+                    }
+                    else if (body.detail) {
+                        message = body.detail;
+                    }
+                }
+                catch {
+                    // Ignore JSON parse errors
+                }
+                return new NotFoundError(message);
+            }
+            case 422: {
+                let message = "Unprocessable entity";
+                let details;
+                try {
+                    const body = (await response.json());
+                    if (body.error?.message) {
+                        message = body.error.message;
+                    }
+                    else if (typeof body.detail === "string") {
+                        message = body.detail;
+                    }
+                    else if (body.detail) {
+                        details = body.detail;
+                    }
+                }
+                catch {
+                    // Ignore JSON parse errors
+                }
+                return new UnprocessableEntityError(message, details);
+            }
+            case 429: {
+                const retryAfterMs = this.rateLimiter?.getRetryDelayMs() ?? 2000;
+                const clientRateLimit = {
+                    remaining: this.rateLimiter?.getRemainingRequests() ?? 0,
+                    retryAfterMs,
+                };
+                return new RateLimitError("Rate limit exceeded — wait before retrying", Math.ceil(retryAfterMs / 1000), clientRateLimit);
+            }
+            default:
+                if (status >= 500) {
+                    return new ServerError(`Server error: ${response.statusText}`, status);
+                }
+                return new DimensionsError(`HTTP error: ${status} ${response.statusText}`, status);
+        }
+    }
+    /**
+     * Executes a fetch request with timeout management and unified error mapping.
+     * @param options - Request configuration
+     * @returns Parsed JSON response
+     * @throws {TimeoutError} If the request times out or the external signal fires
+     * @throws {NetworkError} If a network-level error occurs
+     * @throws {DimensionsError} If the HTTP response indicates an error
+     */
+    async wrapFetch(options) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), options.timeoutMs);
+        try {
+            const authHeaders = await this.authProvider.getHeaders();
+            const response = await fetch(options.url, {
+                method: options.method,
+                headers: { ...authHeaders, ...options.headers },
+                body: options.body,
+                signal: options.signal != null
+                    ? AbortSignal.any([options.signal, controller.signal])
+                    : controller.signal,
+            });
+            if (!response.ok) {
+                throw await this.mapHttpError(response);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof DimensionsError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new TimeoutError("Request timeout");
+                }
+                throw new NetworkError(`Network error: ${sanitizeErrorMessage(error)}`);
+            }
+            throw new NetworkError("Unknown network error");
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Determines if an error is retryable.
+     * @param error - Error to check
+     * @returns True if the error should be retried
+     */
+    isRetryable(error) {
+        // Retry rate limit errors
+        if (error instanceof RateLimitError) {
+            return true;
+        }
+        // Retry server errors (5xx)
+        if (error instanceof ServerError) {
+            return true;
+        }
+        // Retry network errors
+        if (error instanceof NetworkError) {
+            return true;
+        }
+        // Retry timeout errors
+        if (error instanceof TimeoutError) {
+            return true;
+        }
+        // Don't retry other errors (400, 401, 403, etc.)
+        return false;
+    }
+    /**
+     * Delays execution for the specified time.
+     * @param ms - Delay in milliseconds
+     */
+    delay(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+    /**
+     * Sends a GET request with optional query parameters.
+     * @param path - URL path (appended to baseUrl)
+     * @param options - Request options including params
+     * @returns Parsed JSON response
+     */
+    async get(path, options) {
+        const url = this.buildUrl(path, options?.params);
+        return this.executeWithRetry(() => this.executeGetRequest(url, options));
+    }
+    /**
+     * Builds URL with query parameters.
+     * @param path - URL path
+     * @param params - Query parameters
+     * @returns Full URL with query string
+     */
+    buildUrl(path, params) {
+        const url = `${this.baseUrl}${path}`;
+        if (!params || Object.keys(params).length === 0) {
+            return url;
+        }
+        const searchParams = new URLSearchParams();
+        for (const [key, value] of Object.entries(params)) {
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    searchParams.append(key, String(item));
+                }
+            }
+            else {
+                searchParams.append(key, String(value));
+            }
+        }
+        return `${url}?${searchParams.toString()}`;
+    }
+    /**
+     * Executes a single GET request.
+     * @param url - Full request URL
+     * @param options - Request options
+     * @returns Parsed response
+     */
+    async executeGetRequest(url, options) {
+        return this.wrapFetch({
+            url,
+            method: "GET",
+            headers: options?.headers,
+            timeoutMs: options?.timeout ?? this.timeout,
+            signal: options?.signal,
+        });
+    }
+    /**
+     * Calculates the delay before the next retry attempt.
+     * For rate-limit errors, uses the client rate limiter's slot timing.
+     * For other transient errors, uses exponential backoff with jitter.
+     * The result is capped at 60 seconds.
+     * @param error - The error that triggered the retry
+     * @param attempt - The current attempt number (0-based)
+     * @returns Delay in milliseconds
+     */
+    calculateRetryDelay(error, attempt) {
+        const MAX_DELAY = 60_000;
+        if (error instanceof RateLimitError) {
+            const delay = error.clientRateLimit?.retryAfterMs ??
+                this.rateLimiter?.getRetryDelayMs() ??
+                2000 * 2 ** attempt;
+            return Math.min(delay, MAX_DELAY);
+        }
+        const backoff = this.retryDelay * 2 ** attempt * (0.5 + Math.random() * 0.5);
+        return Math.min(backoff, MAX_DELAY);
+    }
+    /**
+     * Executes a request with retry logic.
+     * Uses client-side throttling before each attempt and exponential backoff for transient errors.
+     * @param requestFn - Function that executes the request
+     * @returns Response from successful request
+     */
+    async executeWithRetry(requestFn) {
+        let lastError = null;
+        for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
+            await this.rateLimiter?.waitIfNeeded();
+            try {
+                const result = await requestFn();
+                this.rateLimiter?.recordRequest();
+                return result;
+            }
+            catch (error) {
+                lastError = error;
+                if (!this.isRetryable(error)) {
+                    throw error;
+                }
+                if (attempt >= this.maxRetries) {
+                    throw error;
+                }
+                const retryDelay = this.calculateRetryDelay(error, attempt);
+                await this.delay(retryDelay);
+            }
+        }
+        throw lastError ?? new NetworkError("Unknown error occurred");
+    }
+    /**
+     * Sends a POST request with JSON body.
+     * @param path - URL path (appended to baseUrl)
+     * @param options - Request options with JSON body
+     * @returns Parsed JSON response
+     */
+    async postJson(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        return this.executeWithRetry(() => this.executePostJsonRequest(url, options));
+    }
+    /**
+     * Executes a single POST JSON request.
+     * @param url - Full request URL
+     * @param options - Request options with JSON body
+     * @returns Parsed response
+     */
+    async executePostJsonRequest(url, options) {
+        return this.wrapFetch({
+            url,
+            method: "POST",
+            headers: { "Content-Type": "application/json", ...options.headers },
+            body: JSON.stringify(options.json),
+            timeoutMs: options.timeout ?? this.timeout,
+            signal: options.signal,
+        });
+    }
+    /**
+     * Sends a POST request with JSON body and returns the raw `Response`.
+     * The caller owns the response body and must consume or close it.
+     * Auth, timeout, retry, and error-status handling are applied identically
+     * to {@link postJson}, but the body is **not** read or parsed.
+     * @param path - URL path (appended to baseUrl)
+     * @param options - Request options with JSON body
+     * @returns The raw fetch Response (body unconsumed)
+     */
+    async postJsonRaw(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        return this.executeWithRetry(() => this.executePostJsonRawRequest(url, options));
+    }
+    /**
+     * Executes a single POST JSON request and returns the raw Response.
+     * @param url - Full request URL
+     * @param options - Request options with JSON body
+     * @returns Raw Response with unconsumed body
+     */
+    async executePostJsonRawRequest(url, options) {
+        const controller = new AbortController();
+        const timeoutMs = options.timeout ?? this.timeout;
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        try {
+            const authHeaders = await this.authProvider.getHeaders();
+            const response = await fetch(url, {
+                method: "POST",
+                headers: { "Content-Type": "application/json", ...authHeaders, ...options.headers },
+                body: JSON.stringify(options.json),
+                signal: options.signal != null
+                    ? AbortSignal.any([options.signal, controller.signal])
+                    : controller.signal,
+            });
+            if (!response.ok) {
+                throw await this.mapHttpError(response);
+            }
+            // Clear timeout only for the request phase — the caller is responsible
+            // for consuming the body within a reasonable timeframe.
+            clearTimeout(timeoutId);
+            return response;
+        }
+        catch (error) {
+            clearTimeout(timeoutId);
+            if (error instanceof DimensionsError) {
+                throw error;
+            }
+            if (error instanceof Error) {
+                if (error.name === "AbortError") {
+                    throw new TimeoutError("Request timeout");
+                }
+                throw new NetworkError(`Network error: ${sanitizeErrorMessage(error)}`);
+            }
+            throw new NetworkError("Unknown network error");
+        }
+    }
+    /**
+     * Sends a POST request with form-urlencoded body.
+     * @param path - URL path (appended to baseUrl)
+     * @param options - Request options with form data
+     * @returns Parsed JSON response
+     */
+    async postForm(path, options) {
+        const url = `${this.baseUrl}${path}`;
+        return this.executeWithRetry(() => this.executePostFormRequest(url, options));
+    }
+    /**
+     * Executes a single POST form-urlencoded request.
+     * @param url - Full request URL
+     * @param options - Request options with form data
+     * @returns Parsed response
+     */
+    async executePostFormRequest(url, options) {
+        return this.wrapFetch({
+            url,
+            method: "POST",
+            headers: { "Content-Type": "application/x-www-form-urlencoded", ...options.headers },
+            body: new URLSearchParams(options.form).toString(),
+            timeoutMs: options.timeout ?? this.timeout,
+            signal: options.signal,
+        });
+    }
+}
+//# sourceMappingURL=http-client.js.map

package/dist/client/http-client.js.map

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

package/dist/client/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * HTTP client, authentication, and shared infrastructure for the Dimensions API.
+ * @module client
+ */
+export type { CachingOptions } from "./auth/decorators/index.js";
+export { withCaching } from "./auth/decorators/index.js";
+export { createAuthProvider } from "./auth/factory.js";
+export { JwtAuthProvider } from "./auth/providers/jwt-auth-provider.js";
+export { AuthResponseSchema } from "./auth/schemas.js";
+export type { AuthConfig, AuthProvider, JwtAuthConfig } from "./auth/types.js";
+export type { CommandInput, CommandOutput } from "./command.js";
+export { Command } from "./command.js";
+export type { ConfigLoaderOptions, ConfigResult, DslConfig, RawConfigFile, } from "./config/index.js";
+export { DslConfigSchema, RawConfigFileSchema } from "./config/index.js";
+export type { DimensionsClientConfig, ResolvedDimensionsClientConfig } from "./config.js";
+export { DimensionsClientConfigSchema } from "./config.js";
+export type { AppDeploymentConfig, DeploymentMode, HostedEnvConfig, InternalDslEnvConfig, } from "./deployment-config.js";
+export { hostedBootstrapUser, InternalDslEnvSchema, loadDeploymentConfig, } from "./deployment-config.js";
+export type { ClientRateLimitInfo } from "./errors.js";
+export { AuthenticationError, DimensionsError, isDimensionsError, isNotFoundError, isUnprocessableEntityError, NetworkError, NotFoundError, QuerySyntaxError, RateLimitError, ServerError, sanitizeErrorMessage, TimeoutError, UnprocessableEntityError, ValidationError, } from "./errors.js";
+export type { DimensionsResponse, GetOptions, HttpClientConfig, PostFormOptions, PostJsonOptions, RequestOptions, } from "./http-client.js";
+export { HttpClient } from "./http-client.js";
+export { InternalDslClient } from "./internal-dsl-client.js";
+export type { RateLimiterConfig } from "./rate-limiter.js";
+export { RateLimiter } from "./rate-limiter.js";
+export { JWT_API_KEY_SUB_PREFIX, parseBearerToken, resolveUserFromApiKey, } from "./resolve-api-key-user.js";
+export type { DslResponse, QueryExecutor, QueryExecutorOptions } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC/E,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,SAAS,EACT,aAAa,GACd,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACzE,YAAY,EAAE,sBAAsB,EAAE,8BAA8B,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EACV,mBAAmB,EACnB,cAAc,EACd,eAAe,EACf,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,wBAAwB,EACxB,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,YAAY,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC;AACnC,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC"}

package/dist/client/index.js

@@ -0,0 +1,18 @@
+/**
+ * HTTP client, authentication, and shared infrastructure for the Dimensions API.
+ * @module client
+ */
+export { withCaching } from "./auth/decorators/index.js";
+export { createAuthProvider } from "./auth/factory.js";
+export { JwtAuthProvider } from "./auth/providers/jwt-auth-provider.js";
+export { AuthResponseSchema } from "./auth/schemas.js";
+export { Command } from "./command.js";
+export { DslConfigSchema, RawConfigFileSchema } from "./config/index.js";
+export { DimensionsClientConfigSchema } from "./config.js";
+export { hostedBootstrapUser, InternalDslEnvSchema, loadDeploymentConfig, } from "./deployment-config.js";
+export { AuthenticationError, DimensionsError, isDimensionsError, isNotFoundError, isUnprocessableEntityError, NetworkError, NotFoundError, QuerySyntaxError, RateLimitError, ServerError, sanitizeErrorMessage, TimeoutError, UnprocessableEntityError, ValidationError, } from "./errors.js";
+export { HttpClient } from "./http-client.js";
+export { InternalDslClient } from "./internal-dsl-client.js";
+export { RateLimiter } from "./rate-limiter.js";
+export { JWT_API_KEY_SUB_PREFIX, parseBearerToken, resolveUserFromApiKey, } from "./resolve-api-key-user.js";
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAGvD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAOvC,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAEzE,OAAO,EAAE,4BAA4B,EAAE,MAAM,aAAa,CAAC;AAO3D,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,oBAAoB,GACrB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,mBAAmB,EACnB,eAAe,EACf,iBAAiB,EACjB,eAAe,EACf,0BAA0B,EAC1B,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,cAAc,EACd,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,wBAAwB,EACxB,eAAe,GAChB,MAAM,aAAa,CAAC;AASrB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAE7D,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,qBAAqB,GACtB,MAAM,2BAA2B,CAAC"}

package/dist/client/internal-dsl-client.d.ts

@@ -0,0 +1,30 @@
+/**
+ * dsl-service adapter for hosted deployment (POST /query, JSON body).
+ * @module client/internal-dsl-client
+ */
+import type { InternalDslEnvConfig } from "./deployment-config.js";
+import type { DslResponse, QueryExecutorOptions } from "./types.js";
+export interface InternalDslClientOptions {
+    readonly config: InternalDslEnvConfig;
+    /** User email for X-DIMENSIONS-USER (required by dsl-service) */
+    readonly userEmail: string;
+    /** Optional client IP to forward */
+    readonly clientIp?: string;
+    readonly timeout?: number;
+}
+/**
+ * Executes DSL queries against dsl-service internal API.
+ */
+export declare class InternalDslClient {
+    private readonly config;
+    private readonly userEmail;
+    private readonly clientIp?;
+    private readonly timeout;
+    constructor(options: InternalDslClientOptions);
+    /**
+     * Runs a DSL query through dsl-service POST /query.
+     */
+    query(dsl: string, options?: QueryExecutorOptions): Promise<DslResponse>;
+    private mapError;
+}
+//# sourceMappingURL=internal-dsl-client.d.ts.map

package/dist/client/internal-dsl-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-dsl-client.d.ts","sourceRoot":"","sources":["../../src/client/internal-dsl-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAUnE,OAAO,KAAK,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEpE,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,CAAC;IACtC,iEAAiE;IACjE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,EAAE,wBAAwB;IAO7C;;OAEG;IACG,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,WAAW,CAAC;YAyDhE,QAAQ;CAyBvB"}

package/dist/client/internal-dsl-client.js

@@ -0,0 +1,101 @@
+/**
+ * dsl-service adapter for hosted deployment (POST /query, JSON body).
+ * @module client/internal-dsl-client
+ */
+import { AuthenticationError, DimensionsError, NetworkError, QuerySyntaxError, ServerError, sanitizeErrorMessage, TimeoutError, } from "./errors.js";
+/**
+ * Executes DSL queries against dsl-service internal API.
+ */
+export class InternalDslClient {
+    config;
+    userEmail;
+    clientIp;
+    timeout;
+    constructor(options) {
+        this.config = options.config;
+        this.userEmail = options.userEmail;
+        this.clientIp = options.clientIp;
+        this.timeout = options.timeout ?? 30_000;
+    }
+    /**
+     * Runs a DSL query through dsl-service POST /query.
+     */
+    async query(dsl, options) {
+        const url = `${this.config.serviceUrl.replace(/\/$/, "")}/query`;
+        const controller = new AbortController();
+        const timeoutMs = options?.timeout ?? this.timeout;
+        const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+        const headers = {
+            "Content-Type": "application/json",
+            "X-DIMENSIONS-USER": this.userEmail,
+            Authorization: `Basic ${Buffer.from(`${this.config.username}:${this.config.password}`).toString("base64")}`,
+        };
+        if (this.clientIp) {
+            headers["X-Forwarded-For"] = this.clientIp;
+        }
+        const body = {
+            query: dsl,
+            dsl_schema: this.config.dslSchema,
+            host: this.config.host,
+            variant: this.config.variant,
+            additional_logging_info: {
+                user: this.userEmail,
+                product_variant: this.config.variant,
+                source: "dimensions-analytics-mcp-hosted",
+            },
+        };
+        try {
+            const response = await fetch(url, {
+                method: "POST",
+                headers,
+                body: JSON.stringify(body),
+                signal: options?.signal != null
+                    ? AbortSignal.any([options.signal, controller.signal])
+                    : controller.signal,
+            });
+            if (!response.ok) {
+                throw await this.mapError(response);
+            }
+            return (await response.json());
+        }
+        catch (error) {
+            if (error instanceof DimensionsError) {
+                throw error;
+            }
+            if (error instanceof Error && error.name === "AbortError") {
+                throw new TimeoutError("Request timeout");
+            }
+            throw new NetworkError(`Network error: ${sanitizeErrorMessage(error)}`);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async mapError(response) {
+        let message = response.statusText;
+        try {
+            const body = (await response.json());
+            if (typeof body.error === "string") {
+                message = body.error;
+            }
+            else if (Array.isArray(body.error)) {
+                message = JSON.stringify(body.error);
+            }
+        }
+        catch {
+            // ignore parse errors
+        }
+        switch (response.status) {
+            case 401:
+                return new AuthenticationError(message);
+            case 400:
+                return new QuerySyntaxError(message);
+            default:
+                if (response.status >= 500) {
+                    return new ServerError(message, response.status);
+                }
+                return new DimensionsError(message, response.status);
+        }
+    }
+}
+//# sourceMappingURL=internal-dsl-client.js.map

package/dist/client/internal-dsl-client.js.map

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