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

package/dist/client/deployment-config.js.map

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

package/dist/client/errors.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Base error class for all Dimensions API errors.
+ * Provides consistent error structure with optional status codes and JSON serialization.
+ */
+export declare class DimensionsError extends Error {
+    /** HTTP status code associated with this error, if applicable */
+    readonly statusCode?: number;
+    /**
+     * Creates a new DimensionsError.
+     * @param message - Human-readable error description
+     * @param statusCode - Optional HTTP status code
+     */
+    constructor(message: string, statusCode?: number);
+    /**
+     * Serializes the error to a plain object for logging or API responses.
+     * @returns Plain object representation of the error
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when authentication fails (invalid API key, expired token, etc.).
+ * HTTP Status: 401 Unauthorized
+ */
+export declare class AuthenticationError extends DimensionsError {
+    /**
+     * Creates a new AuthenticationError.
+     * @param message - Error description (defaults to "Authentication failed")
+     */
+    constructor(message?: string);
+}
+/**
+ * Client-side rate-limit state surfaced on 429 errors.
+ * Dimensions does not send rate-limit response headers; this reflects local throttling.
+ */
+export interface ClientRateLimitInfo {
+    /** Requests remaining in the client sliding window */
+    readonly remaining: number;
+    /** Suggested wait before retrying, in milliseconds */
+    readonly retryAfterMs: number;
+}
+/**
+ * Thrown when the API rate limit is exceeded.
+ * HTTP Status: 429 Too Many Requests
+ */
+export declare class RateLimitError extends DimensionsError {
+    /** Suggested seconds to wait before retrying (from client-side throttling) */
+    readonly retryAfter?: number;
+    /** Client-side rate-limit state when a rate limiter is configured */
+    readonly clientRateLimit?: ClientRateLimitInfo;
+    /**
+     * Creates a new RateLimitError.
+     * @param message - Error description (defaults to "Rate limit exceeded")
+     * @param retryAfterSeconds - Suggested seconds to wait before retrying
+     * @param clientRateLimit - Optional client-side rate-limit snapshot
+     */
+    constructor(message?: string, retryAfterSeconds?: number, clientRateLimit?: ClientRateLimitInfo);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when input validation fails (invalid parameters, missing required fields, etc.).
+ * HTTP Status: 400 Bad Request
+ */
+export declare class ValidationError extends DimensionsError {
+    /** Additional details about what failed validation */
+    readonly details?: Record<string, unknown>;
+    /**
+     * Creates a new ValidationError.
+     * @param message - Error description
+     * @param details - Optional object with validation failure details
+     */
+    constructor(message: string, details?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Thrown when the DSL query syntax is invalid.
+ * HTTP Status: 400 Bad Request
+ */
+export declare class QuerySyntaxError extends DimensionsError {
+    /**
+     * Creates a new QuerySyntaxError.
+     * @param message - Description of the syntax error
+     */
+    constructor(message: string);
+}
+/**
+ * Thrown when a network-level error occurs (connection refused, DNS failure, etc.).
+ * No HTTP status code as the request never completed.
+ */
+export declare class NetworkError extends DimensionsError {
+    /**
+     * Creates a new NetworkError.
+     * @param message - Error description (defaults to "Network error")
+     */
+    constructor(message?: string);
+}
+/**
+ * Thrown when a request times out before receiving a response.
+ * No HTTP status code as the request never completed.
+ */
+export declare class TimeoutError extends DimensionsError {
+    /**
+     * Creates a new TimeoutError.
+     * @param message - Error description (defaults to "Request timeout")
+     */
+    constructor(message?: string);
+}
+/**
+ * Thrown when the server returns a 5xx error.
+ * HTTP Status: 500-599 (configurable, defaults to 500)
+ */
+export declare class ServerError extends DimensionsError {
+    /**
+     * Creates a new ServerError.
+     * @param message - Error description (defaults to "Server error")
+     * @param statusCode - HTTP status code in range 500-599 (defaults to 500)
+     * @throws {TypeError} If statusCode is not an integer in range 500-599
+     */
+    constructor(message?: string, statusCode?: number);
+}
+/**
+ * Thrown when a requested resource is not found.
+ * HTTP Status: 404 Not Found
+ */
+export declare class NotFoundError extends DimensionsError {
+    /**
+     * Creates a new NotFoundError.
+     * @param message - Error description (defaults to "Resource not found")
+     */
+    constructor(message?: string);
+}
+/**
+ * Thrown when the request is syntactically valid but contains invalid data.
+ * HTTP Status: 422 Unprocessable Entity
+ */
+export declare class UnprocessableEntityError extends DimensionsError {
+    /** Additional details about what failed processing */
+    readonly details?: Record<string, unknown>;
+    /**
+     * Creates a new UnprocessableEntityError.
+     * @param message - Error description
+     * @param details - Optional object with processing failure details
+     */
+    constructor(message: string, details?: Record<string, unknown>);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Checks if an error is a DimensionsError instance.
+ * @param error - Value to check
+ * @returns True if error is a DimensionsError
+ */
+export declare function isDimensionsError(error: unknown): error is DimensionsError;
+/**
+ * Checks if an error is a NotFoundError instance.
+ * @param error - Value to check
+ * @returns True if error is a NotFoundError
+ */
+export declare function isNotFoundError(error: unknown): error is NotFoundError;
+/**
+ * Checks if an error is an UnprocessableEntityError instance.
+ * @param error - Value to check
+ * @returns True if error is an UnprocessableEntityError
+ */
+export declare function isUnprocessableEntityError(error: unknown): error is UnprocessableEntityError;
+/**
+ * Exhaustiveness check for discriminated unions.
+ * Local copy to keep `core` free of `dimensions-dsl` dependency.
+ * @param value - Should be `never` at compile time
+ * @param message - Optional error message
+ */
+export declare function assertNever(value: never, message?: string): never;
+/**
+ * Extracts a safe error message from an unknown error value.
+ * Uses `.message` for Error instances (never `.toString()` which includes the stack).
+ * Returns `"Unknown error"` for non-Error values.
+ * Redacts credentials that may appear in error messages.
+ * @param error - The caught error value
+ * @returns A sanitized error message safe for logging or re-throwing
+ */
+export declare function sanitizeErrorMessage(error: unknown): string;
+//# sourceMappingURL=errors.d.ts.map

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

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

package/dist/client/errors.js

@@ -0,0 +1,253 @@
+/**
+ * Base error class for all Dimensions API errors.
+ * Provides consistent error structure with optional status codes and JSON serialization.
+ */
+export class DimensionsError extends Error {
+    /** HTTP status code associated with this error, if applicable */
+    statusCode;
+    /**
+     * Creates a new DimensionsError.
+     * @param message - Human-readable error description
+     * @param statusCode - Optional HTTP status code
+     */
+    constructor(message, statusCode) {
+        super(message);
+        this.name = "DimensionsError";
+        this.statusCode = statusCode;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+    /**
+     * Serializes the error to a plain object for logging or API responses.
+     * @returns Plain object representation of the error
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            statusCode: this.statusCode,
+        };
+    }
+}
+/**
+ * Thrown when authentication fails (invalid API key, expired token, etc.).
+ * HTTP Status: 401 Unauthorized
+ */
+export class AuthenticationError extends DimensionsError {
+    /**
+     * Creates a new AuthenticationError.
+     * @param message - Error description (defaults to "Authentication failed")
+     */
+    constructor(message = "Authentication failed") {
+        super(message, 401);
+        this.name = "AuthenticationError";
+    }
+}
+/**
+ * Thrown when the API rate limit is exceeded.
+ * HTTP Status: 429 Too Many Requests
+ */
+export class RateLimitError extends DimensionsError {
+    /** Suggested seconds to wait before retrying (from client-side throttling) */
+    retryAfter;
+    /** Client-side rate-limit state when a rate limiter is configured */
+    clientRateLimit;
+    /**
+     * Creates a new RateLimitError.
+     * @param message - Error description (defaults to "Rate limit exceeded")
+     * @param retryAfterSeconds - Suggested seconds to wait before retrying
+     * @param clientRateLimit - Optional client-side rate-limit snapshot
+     */
+    constructor(message = "Rate limit exceeded", retryAfterSeconds, clientRateLimit) {
+        super(message, 429);
+        this.name = "RateLimitError";
+        this.clientRateLimit = clientRateLimit;
+        this.retryAfter =
+            retryAfterSeconds ??
+                (clientRateLimit != null ? Math.ceil(clientRateLimit.retryAfterMs / 1000) : undefined);
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            retryAfter: this.retryAfter,
+            clientRateLimit: this.clientRateLimit,
+        };
+    }
+}
+/**
+ * Thrown when input validation fails (invalid parameters, missing required fields, etc.).
+ * HTTP Status: 400 Bad Request
+ */
+export class ValidationError extends DimensionsError {
+    /** Additional details about what failed validation */
+    details;
+    /**
+     * Creates a new ValidationError.
+     * @param message - Error description
+     * @param details - Optional object with validation failure details
+     */
+    constructor(message, details) {
+        super(message, 400);
+        this.name = "ValidationError";
+        this.details = details;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            details: this.details,
+        };
+    }
+}
+/**
+ * Thrown when the DSL query syntax is invalid.
+ * HTTP Status: 400 Bad Request
+ */
+export class QuerySyntaxError extends DimensionsError {
+    /**
+     * Creates a new QuerySyntaxError.
+     * @param message - Description of the syntax error
+     */
+    constructor(message) {
+        super(message, 400);
+        this.name = "QuerySyntaxError";
+    }
+}
+/**
+ * Thrown when a network-level error occurs (connection refused, DNS failure, etc.).
+ * No HTTP status code as the request never completed.
+ */
+export class NetworkError extends DimensionsError {
+    /**
+     * Creates a new NetworkError.
+     * @param message - Error description (defaults to "Network error")
+     */
+    constructor(message = "Network error") {
+        super(message);
+        this.name = "NetworkError";
+    }
+}
+/**
+ * Thrown when a request times out before receiving a response.
+ * No HTTP status code as the request never completed.
+ */
+export class TimeoutError extends DimensionsError {
+    /**
+     * Creates a new TimeoutError.
+     * @param message - Error description (defaults to "Request timeout")
+     */
+    constructor(message = "Request timeout") {
+        super(message);
+        this.name = "TimeoutError";
+    }
+}
+/**
+ * Thrown when the server returns a 5xx error.
+ * HTTP Status: 500-599 (configurable, defaults to 500)
+ */
+export class ServerError extends DimensionsError {
+    /**
+     * Creates a new ServerError.
+     * @param message - Error description (defaults to "Server error")
+     * @param statusCode - HTTP status code in range 500-599 (defaults to 500)
+     * @throws {TypeError} If statusCode is not an integer in range 500-599
+     */
+    constructor(message = "Server error", statusCode = 500) {
+        if (!Number.isInteger(statusCode) || statusCode < 500 || statusCode > 599) {
+            throw new TypeError(`ServerError statusCode must be an integer in range 500-599, got ${statusCode}`);
+        }
+        super(message, statusCode);
+        this.name = "ServerError";
+    }
+}
+/**
+ * Thrown when a requested resource is not found.
+ * HTTP Status: 404 Not Found
+ */
+export class NotFoundError extends DimensionsError {
+    /**
+     * Creates a new NotFoundError.
+     * @param message - Error description (defaults to "Resource not found")
+     */
+    constructor(message = "Resource not found") {
+        super(message, 404);
+        this.name = "NotFoundError";
+    }
+}
+/**
+ * Thrown when the request is syntactically valid but contains invalid data.
+ * HTTP Status: 422 Unprocessable Entity
+ */
+export class UnprocessableEntityError extends DimensionsError {
+    /** Additional details about what failed processing */
+    details;
+    /**
+     * Creates a new UnprocessableEntityError.
+     * @param message - Error description
+     * @param details - Optional object with processing failure details
+     */
+    constructor(message, details) {
+        super(message, 422);
+        this.name = "UnprocessableEntityError";
+        this.details = details;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            details: this.details,
+        };
+    }
+}
+/**
+ * Checks if an error is a DimensionsError instance.
+ * @param error - Value to check
+ * @returns True if error is a DimensionsError
+ */
+export function isDimensionsError(error) {
+    return error instanceof DimensionsError;
+}
+/**
+ * Checks if an error is a NotFoundError instance.
+ * @param error - Value to check
+ * @returns True if error is a NotFoundError
+ */
+export function isNotFoundError(error) {
+    return error instanceof NotFoundError;
+}
+/**
+ * Checks if an error is an UnprocessableEntityError instance.
+ * @param error - Value to check
+ * @returns True if error is an UnprocessableEntityError
+ */
+export function isUnprocessableEntityError(error) {
+    return error instanceof UnprocessableEntityError;
+}
+/**
+ * Exhaustiveness check for discriminated unions.
+ * Local copy to keep `core` free of `dimensions-dsl` dependency.
+ * @param value - Should be `never` at compile time
+ * @param message - Optional error message
+ */
+export function assertNever(value, message) {
+    throw new Error(message ?? `Unexpected value: ${JSON.stringify(value)}`);
+}
+/** Patterns that match credentials in error messages, paired with their replacements */
+const CREDENTIAL_PATTERNS = [
+    [/:\/\/([^:]+):([^@]+)@/g, "://[redacted]@"],
+    [/Bearer\s+\S+/gi, "Bearer [redacted]"],
+    [/password\s*[=:]\s*\S+/gi, "[redacted]"],
+    [/api_?key\s*[=:]\s*\S+/gi, "[redacted]"],
+    [/token\s*[=:]\s*\S+/gi, "[redacted]"],
+    [/secret\s*[=:]\s*\S+/gi, "[redacted]"],
+];
+/**
+ * Extracts a safe error message from an unknown error value.
+ * Uses `.message` for Error instances (never `.toString()` which includes the stack).
+ * Returns `"Unknown error"` for non-Error values.
+ * Redacts credentials that may appear in error messages.
+ * @param error - The caught error value
+ * @returns A sanitized error message safe for logging or re-throwing
+ */
+export function sanitizeErrorMessage(error) {
+    const raw = error instanceof Error ? error.message : "Unknown error";
+    return CREDENTIAL_PATTERNS.reduce((msg, [pattern, replacement]) => msg.replace(pattern, replacement), raw);
+}
+//# sourceMappingURL=errors.js.map

package/dist/client/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/client/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACxC,iEAAiE;IACxD,UAAU,CAAU;IAE7B;;;;OAIG;IACH,YAAY,OAAe,EAAE,UAAmB;QAC9C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,UAAU,EAAE,IAAI,CAAC,UAAU;SAC5B,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD;;;OAGG;IACH,YAAY,UAAkB,uBAAuB;QACnD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAaD;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,eAAe;IACjD,8EAA8E;IACrE,UAAU,CAAU;IAC7B,qEAAqE;IAC5D,eAAe,CAAuB;IAE/C;;;;;OAKG;IACH,YACE,UAAkB,qBAAqB,EACvC,iBAA0B,EAC1B,eAAqC;QAErC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,UAAU;YACb,iBAAiB;gBACjB,CAAC,eAAe,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3F,CAAC;IAED,MAAM;QACJ,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,eAAe,EAAE,IAAI,CAAC,eAAe;SACtC,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,eAAgB,SAAQ,eAAe;IAClD,sDAAsD;IAC7C,OAAO,CAA2B;IAE3C;;;;OAIG;IACH,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,gBAAiB,SAAQ,eAAe;IACnD;;;OAGG;IACH,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C;;;OAGG;IACH,YAAY,UAAkB,eAAe;QAC3C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,YAAa,SAAQ,eAAe;IAC/C;;;OAGG;IACH,YAAY,UAAkB,iBAAiB;QAC7C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,eAAe;IAC9C;;;;;OAKG;IACH,YAAY,UAAkB,cAAc,EAAE,aAAqB,GAAG;QACpE,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,GAAG,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YAC1E,MAAM,IAAI,SAAS,CACjB,mEAAmE,UAAU,EAAE,CAChF,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,aAAc,SAAQ,eAAe;IAChD;;;OAGG;IACH,YAAY,UAAkB,oBAAoB;QAChD,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,wBAAyB,SAAQ,eAAe;IAC3D,sDAAsD;IAC7C,OAAO,CAA2B;IAE3C;;;;OAIG;IACH,YAAY,OAAe,EAAE,OAAiC;QAC5D,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;QACvC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,MAAM;QACJ,OAAO;YACL,GAAG,KAAK,CAAC,MAAM,EAAE;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,CAAC;IACJ,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,OAAO,KAAK,YAAY,eAAe,CAAC;AAC1C,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC5C,OAAO,KAAK,YAAY,aAAa,CAAC;AACxC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAAc;IACvD,OAAO,KAAK,YAAY,wBAAwB,CAAC;AACnD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY,EAAE,OAAgB;IACxD,MAAM,IAAI,KAAK,CAAC,OAAO,IAAI,qBAAqB,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;AAC3E,CAAC;AAED,wFAAwF;AACxF,MAAM,mBAAmB,GAA6C;IACpE,CAAC,wBAAwB,EAAE,gBAAgB,CAAC;IAC5C,CAAC,gBAAgB,EAAE,mBAAmB,CAAC;IACvC,CAAC,yBAAyB,EAAE,YAAY,CAAC;IACzC,CAAC,yBAAyB,EAAE,YAAY,CAAC;IACzC,CAAC,sBAAsB,EAAE,YAAY,CAAC;IACtC,CAAC,uBAAuB,EAAE,YAAY,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;IACrE,OAAO,mBAAmB,CAAC,MAAM,CAC/B,CAAC,GAAG,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,EAClE,GAAG,CACJ,CAAC;AACJ,CAAC"}

package/dist/client/http-client.d.ts

@@ -0,0 +1,215 @@
+/**
+ * HTTP client for Dimensions API requests.
+ * Handles retry logic, timeout, and error mapping.
+ * @module core/http-client
+ */
+import type { AuthProvider } from "./auth/types.js";
+import type { RateLimiter } from "./rate-limiter.js";
+/**
+ * Configuration options for the HTTP client.
+ */
+export interface HttpClientConfig {
+    /** Base URL for API requests */
+    readonly baseUrl: string;
+    /** Authentication provider for generating request headers */
+    readonly authProvider: AuthProvider;
+    /** Request timeout in milliseconds (default: 30000) */
+    readonly timeout?: number;
+    /** Maximum number of retry attempts (default: 3) */
+    readonly maxRetries?: number;
+    /** Delay between retries in milliseconds (default: 1000) */
+    readonly retryDelay?: number;
+    /** Optional rate limiter for client-side request throttling */
+    readonly rateLimiter?: RateLimiter;
+}
+/**
+ * Base options for all request types.
+ */
+export interface RequestOptions {
+    /** Additional headers to include */
+    readonly headers?: Record<string, string>;
+    /** Request timeout override */
+    readonly timeout?: number;
+    /** AbortSignal for cancellation */
+    readonly signal?: AbortSignal;
+}
+/**
+ * Options for GET requests.
+ */
+export interface GetOptions extends RequestOptions {
+    /** Query parameters to append to URL */
+    readonly params?: Record<string, string | number | boolean | string[] | number[]>;
+}
+/**
+ * Options for POST requests with JSON body.
+ */
+export interface PostJsonOptions extends RequestOptions {
+    /** JSON body (will be serialized) */
+    readonly json: unknown;
+}
+/**
+ * Options for POST requests with form-urlencoded body.
+ */
+export interface PostFormOptions extends RequestOptions {
+    /** Form data (will be URL-encoded) */
+    readonly form: Record<string, string>;
+}
+/**
+ * Generic response structure from Dimensions API.
+ */
+export interface DimensionsResponse {
+    /** Statistics about the query result */
+    _stats?: {
+        total_count: number;
+    };
+    /** Additional response fields (dynamic based on query) */
+    [key: string]: unknown;
+}
+/**
+ * HTTP client for making requests to the Dimensions API.
+ * Implements retry logic with client-side throttling and exponential backoff for transient errors.
+ */
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly authProvider;
+    private readonly timeout;
+    private readonly maxRetries;
+    private readonly retryDelay;
+    private readonly rateLimiter;
+    /**
+     * Creates a new HttpClient instance.
+     * @param config - HTTP client configuration
+     */
+    constructor(config: HttpClientConfig);
+    /**
+     * 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
+     */
+    query(dsl: string, endpoint?: string, options?: RequestOptions): Promise<DimensionsResponse>;
+    /**
+     * 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
+     */
+    private executeDslRequest;
+    /**
+     * Maps HTTP response status to appropriate error type.
+     * @param response - HTTP response
+     * @returns Appropriate error instance
+     */
+    private mapHttpError;
+    /**
+     * 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
+     */
+    private wrapFetch;
+    /**
+     * Determines if an error is retryable.
+     * @param error - Error to check
+     * @returns True if the error should be retried
+     */
+    private isRetryable;
+    /**
+     * Delays execution for the specified time.
+     * @param ms - Delay in milliseconds
+     */
+    private delay;
+    /**
+     * 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
+     */
+    get<T = unknown>(path: string, options?: GetOptions): Promise<T>;
+    /**
+     * Builds URL with query parameters.
+     * @param path - URL path
+     * @param params - Query parameters
+     * @returns Full URL with query string
+     */
+    private buildUrl;
+    /**
+     * Executes a single GET request.
+     * @param url - Full request URL
+     * @param options - Request options
+     * @returns Parsed response
+     */
+    private executeGetRequest;
+    /**
+     * 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
+     */
+    private calculateRetryDelay;
+    /**
+     * 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
+     */
+    private executeWithRetry;
+    /**
+     * 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
+     */
+    postJson<T = unknown>(path: string, options: PostJsonOptions): Promise<T>;
+    /**
+     * Executes a single POST JSON request.
+     * @param url - Full request URL
+     * @param options - Request options with JSON body
+     * @returns Parsed response
+     */
+    private executePostJsonRequest;
+    /**
+     * 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)
+     */
+    postJsonRaw(path: string, options: PostJsonOptions): Promise<Response>;
+    /**
+     * 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
+     */
+    private executePostJsonRawRequest;
+    /**
+     * 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
+     */
+    postForm<T = unknown>(path: string, options: PostFormOptions): Promise<T>;
+    /**
+     * Executes a single POST form-urlencoded request.
+     * @param url - Full request URL
+     * @param options - Request options with form data
+     * @returns Parsed response
+     */
+    private executePostFormRequest;
+}
+//# sourceMappingURL=http-client.d.ts.map

package/dist/client/http-client.d.ts.map

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