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

package/dist/client/config/loader.js

@@ -0,0 +1,128 @@
+/**
+ * Configuration file loader with environment variable support.
+ * @module core/config/loader
+ */
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { ValidationError } from "../errors.js";
+import { RawConfigFileSchema } from "./schemas.js";
+const CONFIG_FILE_NAME = ".dimensions.config.json";
+/**
+ * Environment variable mapping for each service.
+ */
+const ENV_VAR_MAP = {
+    dsl: {
+        apiKey: "DIMENSIONS_DSL_API_KEY",
+        baseUrl: "DIMENSIONS_DSL_BASE_URL",
+    },
+};
+/**
+ * Loads and parses a JSON config file.
+ * @param filePath - Path to the config file
+ * @returns Parsed config object, or undefined if file not found
+ * @throws Error if file exists but cannot be parsed
+ */
+export async function loadConfigFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        return RawConfigFileSchema.parse(parsed);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return undefined;
+        }
+        throw error;
+    }
+}
+/**
+ * Loads config from environment variables for a service.
+ * @param service - Service name
+ * @returns Config object from env vars, or undefined if not set
+ */
+function loadFromEnv(service) {
+    const mapping = ENV_VAR_MAP[service];
+    if (!mapping) {
+        return undefined;
+    }
+    const config = {};
+    let hasAnyValue = false;
+    for (const [key, envVar] of Object.entries(mapping)) {
+        const value = process.env[envVar];
+        if (value) {
+            config[key] = value;
+            hasAnyValue = true;
+        }
+    }
+    return hasAnyValue ? config : undefined;
+}
+/**
+ * Loads configuration with priority:
+ * 1. Explicit configPath
+ * 2. Environment variables (DIMENSIONS_{SERVICE}_{KEY})
+ * 3. .dimensions.config.json in cwd
+ * 4. .dimensions.config.json in home directory
+ *
+ * @param options - Loader options (service is required to extract config from file)
+ * @param schema - Zod schema for validation
+ * @returns Config result with source, or undefined if not found or service not specified
+ * @throws ValidationError if config fails schema validation
+ */
+export async function loadConfig(options, schema) {
+    const { configPath, service, cwd = process.cwd(), homedir = os.homedir() } = options;
+    if (configPath) {
+        const rawConfig = await loadConfigFile(configPath);
+        if (rawConfig && service) {
+            const serviceConfig = rawConfig[service];
+            if (serviceConfig) {
+                return validateAndReturn(serviceConfig, schema, "explicit");
+            }
+        }
+        return undefined;
+    }
+    if (service) {
+        const envConfig = loadFromEnv(service);
+        if (envConfig) {
+            const result = schema.safeParse(envConfig);
+            if (result.success) {
+                return { config: result.data, source: "env" };
+            }
+        }
+    }
+    const cwdConfigPath = path.join(cwd, CONFIG_FILE_NAME);
+    const cwdConfig = await loadConfigFile(cwdConfigPath);
+    if (cwdConfig && service) {
+        const serviceConfig = cwdConfig[service];
+        if (serviceConfig) {
+            return validateAndReturn(serviceConfig, schema, "cwd");
+        }
+    }
+    const homeConfigPath = path.join(homedir, CONFIG_FILE_NAME);
+    const homeConfig = await loadConfigFile(homeConfigPath);
+    if (homeConfig && service) {
+        const serviceConfig = homeConfig[service];
+        if (serviceConfig) {
+            return validateAndReturn(serviceConfig, schema, "home");
+        }
+    }
+    return undefined;
+}
+/**
+ * Validates config against schema and returns result.
+ * @param config - Raw config object
+ * @param schema - Zod schema
+ * @param source - Config source
+ * @returns Validated config result
+ * @throws ValidationError if validation fails
+ */
+function validateAndReturn(config, schema, source) {
+    const result = schema.safeParse(config);
+    if (!result.success) {
+        throw new ValidationError(`Configuration validation failed (source: ${source}): ${result.error.message}`, { issues: result.error.issues, source });
+    }
+    return { config: result.data, source };
+}
+//# sourceMappingURL=loader.js.map

package/dist/client/config/loader.js.map

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

package/dist/client/config/node.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Node.js-only configuration file loaders.
+ *
+ * These utilities read `.dimensions.config.json` from disk and merge with
+ * environment variables. They depend on `node:fs/promises` and must not be
+ * imported in browser/edge contexts.
+ *
+ * @example
+ * ```typescript
+ * import { loadDimensionsConfig, loadServiceConfig } from "./node.js";
+ * ```
+ *
+ * @module core/config/node
+ */
+export { loadConfig, loadConfigFile } from "./loader.js";
+export type { DimensionsConfigFile } from "./unified-loader.js";
+export { DimensionsConfigFileSchema, loadDimensionsConfig, loadServiceConfig, } from "./unified-loader.js";
+//# sourceMappingURL=node.d.ts.map

package/dist/client/config/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/client/config/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzD,YAAY,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/client/config/node.js

@@ -0,0 +1,17 @@
+/**
+ * Node.js-only configuration file loaders.
+ *
+ * These utilities read `.dimensions.config.json` from disk and merge with
+ * environment variables. They depend on `node:fs/promises` and must not be
+ * imported in browser/edge contexts.
+ *
+ * @example
+ * ```typescript
+ * import { loadDimensionsConfig, loadServiceConfig } from "./node.js";
+ * ```
+ *
+ * @module core/config/node
+ */
+export { loadConfig, loadConfigFile } from "./loader.js";
+export { DimensionsConfigFileSchema, loadDimensionsConfig, loadServiceConfig, } from "./unified-loader.js";
+//# sourceMappingURL=node.js.map

package/dist/client/config/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../../src/client/config/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEzD,OAAO,EACL,0BAA0B,EAC1B,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC"}

package/dist/client/config/schemas.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Zod schemas for config validation.
+ * @module core/config/schemas
+ */
+import { z } from "zod";
+/**
+ * Schema for DSL service configuration.
+ */
+export declare const DslConfigSchema: z.ZodObject<{
+    apiKey: z.ZodString;
+    baseUrl: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * Schema for the raw config file structure.
+ */
+export declare const RawConfigFileSchema: z.ZodObject<{
+    dsl: z.ZodOptional<z.ZodObject<{
+        apiKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type DslConfig = z.infer<typeof DslConfigSchema>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/client/config/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/client/config/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;iBAO9B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/client/config/schemas.js

@@ -0,0 +1,24 @@
+/**
+ * Zod schemas for config validation.
+ * @module core/config/schemas
+ */
+import { z } from "zod";
+/**
+ * Schema for DSL service configuration.
+ */
+export const DslConfigSchema = z.object({
+    apiKey: z.string().min(1, "API key is required"),
+    baseUrl: z.string().url().optional().default("https://app.dimensions.ai"),
+});
+/**
+ * Schema for the raw config file structure.
+ */
+export const RawConfigFileSchema = z.object({
+    dsl: z
+        .object({
+        apiKey: z.string().optional(),
+        baseUrl: z.string().optional(),
+    })
+        .optional(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/client/config/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../../src/client/config/schemas.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,qBAAqB,CAAC;IAChD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC;CAC1E,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,GAAG,EAAE,CAAC;SACH,MAAM,CAAC;QACN,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC/B,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAC"}

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

@@ -0,0 +1,37 @@
+/**
+ * Configuration loader types.
+ * @module core/config/types
+ */
+/**
+ * Options for loading configuration.
+ */
+export interface ConfigLoaderOptions {
+    /** Explicit path to config file */
+    configPath?: string;
+    /** Service to load config for (e.g., 'dsl') */
+    service?: string;
+    /** @internal Override cwd for tests; defaults to `process.cwd()`. */
+    cwd?: string;
+    /** @internal Override home directory for tests; defaults to `os.homedir()`. */
+    homedir?: string;
+}
+/**
+ * Result of loading configuration.
+ */
+export interface ConfigResult<T> {
+    /** Loaded configuration */
+    readonly config: T;
+    /** Source of the configuration */
+    readonly source: "explicit" | "env" | "cwd" | "home";
+}
+/**
+ * Raw config file structure with nested service configs.
+ */
+export interface RawConfigFile {
+    /** DSL service configuration */
+    readonly dsl?: {
+        readonly apiKey?: string;
+        readonly baseUrl?: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/config/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC;IAC7B,2BAA2B;IAC3B,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;IACnB,kCAAkC;IAClC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE;QACb,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH"}

package/dist/client/config/types.js

@@ -0,0 +1,6 @@
+/**
+ * Configuration loader types.
+ * @module core/config/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/client/config/types.js.map

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

package/dist/client/config/unified-loader.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Unified configuration loader for Dimensions DSL settings.
+ * Reads `.dimensions.config.json` with cwd → home fallback and env var override.
+ * @module core/config/unified-loader
+ */
+import { z } from "zod";
+/**
+ * Schema for the Dimensions config file.
+ */
+export declare const DimensionsConfigFileSchema: z.ZodObject<{
+    dsl: z.ZodOptional<z.ZodObject<{
+        apiKey: z.ZodOptional<z.ZodString>;
+        baseUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Full config file type */
+export type DimensionsConfigFile = z.infer<typeof DimensionsConfigFileSchema>;
+/**
+ * Options for `loadDimensionsConfig`. All fields are optional overrides
+ * intended for tests; production callers should omit `options` entirely.
+ */
+export interface LoadDimensionsConfigOptions {
+    /** @internal Override cwd for tests; defaults to `process.cwd()`. */
+    cwd?: string;
+    /** @internal Override home directory for tests; defaults to `os.homedir()`. */
+    homedir?: string;
+}
+/**
+ * Loads and parses the Dimensions config file, checking cwd then home directory.
+ * @param options - Optional cwd/homedir overrides (test-only)
+ * @returns Parsed config file, or undefined if no file found
+ */
+export declare function loadDimensionsConfig(options?: LoadDimensionsConfigOptions): Promise<DimensionsConfigFile | undefined>;
+/**
+ * Loads a specific service section from the config file with env var fallback.
+ * @param section - Config file section key (e.g., "dsl")
+ * @param envVars - Mapping from config field names to environment variable names
+ * @returns Merged service config, or undefined if nothing found
+ */
+export declare function loadServiceConfig<K extends keyof DimensionsConfigFile>(section: K, envVars?: Record<string, string>, options?: LoadDimensionsConfigOptions): Promise<DimensionsConfigFile[K] | undefined>;
+//# sourceMappingURL=unified-loader.d.ts.map

package/dist/client/config/unified-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified-loader.d.ts","sourceRoot":"","sources":["../../../src/client/config/unified-loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,eAAO,MAAM,0BAA0B;;;;;iBAOrC,CAAC;AAEH,4BAA4B;AAC5B,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,+EAA+E;IAC/E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAgB3C;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,SAAS,MAAM,oBAAoB,EAC1E,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAChC,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAqB9C"}

package/dist/client/config/unified-loader.js

@@ -0,0 +1,86 @@
+/**
+ * Unified configuration loader for Dimensions DSL settings.
+ * Reads `.dimensions.config.json` with cwd → home fallback and env var override.
+ * @module core/config/unified-loader
+ */
+import * as fs from "node:fs/promises";
+import * as os from "node:os";
+import * as path from "node:path";
+import { z } from "zod";
+const CONFIG_FILE_NAME = ".dimensions.config.json";
+/**
+ * Schema for the Dimensions config file.
+ */
+export const DimensionsConfigFileSchema = z.object({
+    dsl: z
+        .object({
+        apiKey: z.string().optional(),
+        baseUrl: z.string().optional(),
+    })
+        .optional(),
+});
+/**
+ * Loads and parses the Dimensions config file, checking cwd then home directory.
+ * @param options - Optional cwd/homedir overrides (test-only)
+ * @returns Parsed config file, or undefined if no file found
+ */
+export async function loadDimensionsConfig(options = {}) {
+    const { cwd = process.cwd(), homedir = os.homedir() } = options;
+    const cwdPath = path.join(cwd, CONFIG_FILE_NAME);
+    const cwdConfig = await readConfigFile(cwdPath);
+    if (cwdConfig) {
+        return cwdConfig;
+    }
+    const homePath = path.join(homedir, CONFIG_FILE_NAME);
+    const homeConfig = await readConfigFile(homePath);
+    if (homeConfig) {
+        return homeConfig;
+    }
+    return undefined;
+}
+/**
+ * Loads a specific service section from the config file with env var fallback.
+ * @param section - Config file section key (e.g., "dsl")
+ * @param envVars - Mapping from config field names to environment variable names
+ * @returns Merged service config, or undefined if nothing found
+ */
+export async function loadServiceConfig(section, envVars, options = {}) {
+    const fileConfig = await loadDimensionsConfig(options);
+    const sectionConfig = fileConfig?.[section];
+    let merged = sectionConfig
+        ? { ...sectionConfig }
+        : undefined;
+    if (envVars) {
+        for (const [field, envVar] of Object.entries(envVars)) {
+            const value = process.env[envVar];
+            if (value) {
+                if (!merged) {
+                    merged = {};
+                }
+                merged[field] = value;
+            }
+        }
+    }
+    return merged;
+}
+/**
+ * Reads and parses a config file at the given path.
+ * @param filePath - Absolute path to the config file
+ * @returns Parsed config, or undefined if file not found or invalid
+ */
+async function readConfigFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, "utf-8");
+        const parsed = JSON.parse(content);
+        return DimensionsConfigFileSchema.parse(parsed);
+    }
+    catch (error) {
+        if (error instanceof Error &&
+            "code" in error &&
+            error.code === "ENOENT") {
+            return undefined;
+        }
+        return undefined;
+    }
+}
+//# sourceMappingURL=unified-loader.js.map

package/dist/client/config/unified-loader.js.map

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

package/dist/client/config.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Configuration schema and types for DimensionsClient.
+ * @module config
+ */
+import { z } from "zod";
+/**
+ * Zod schema for DimensionsClient configuration.
+ * Validates and provides defaults for all configuration options.
+ */
+export declare const DimensionsClientConfigSchema: z.ZodObject<{
+    apiKey: z.ZodOptional<z.ZodString>;
+    backend: z.ZodDefault<z.ZodEnum<{
+        internal: "internal";
+        public: "public";
+    }>>;
+    internal: z.ZodOptional<z.ZodObject<{
+        service: z.ZodObject<{
+            serviceUrl: z.ZodString;
+            username: z.ZodString;
+            password: z.ZodString;
+            dslSchema: z.ZodString;
+            host: z.ZodString;
+            variant: z.ZodString;
+        }, z.core.$strip>;
+        userEmail: z.ZodString;
+        clientIp: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    baseUrl: z.ZodDefault<z.ZodString>;
+    timeout: z.ZodDefault<z.ZodNumber>;
+    maxRetries: z.ZodDefault<z.ZodNumber>;
+    retryDelay: z.ZodDefault<z.ZodNumber>;
+    rateLimitPerMinute: z.ZodDefault<z.ZodNumber>;
+    validateQueries: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Configuration options for DimensionsClient.
+ */
+export type DimensionsClientConfig = z.input<typeof DimensionsClientConfigSchema>;
+/**
+ * Validated configuration with defaults applied.
+ */
+export type ResolvedDimensionsClientConfig = z.output<typeof DimensionsClientConfigSchema>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AASxB;;;GAGG;AACH,eAAO,MAAM,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;;iBAwCrC,CAAC;AAEL;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF;;GAEG;AACH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/client/config.js

@@ -0,0 +1,56 @@
+/**
+ * Configuration schema and types for DimensionsClient.
+ * @module config
+ */
+import { z } from "zod";
+import { InternalDslEnvSchema } from "./deployment-config.js";
+const InternalClientConfigSchema = z.object({
+    service: InternalDslEnvSchema,
+    userEmail: z.string().min(1),
+    clientIp: z.string().optional(),
+});
+/**
+ * Zod schema for DimensionsClient configuration.
+ * Validates and provides defaults for all configuration options.
+ */
+export const DimensionsClientConfigSchema = z
+    .object({
+    /** Dimensions API key (required for public backend) */
+    apiKey: z.string().min(1).optional(),
+    /** DSL backend: public JWT API or internal dsl-service */
+    backend: z.enum(["public", "internal"]).default("public"),
+    /** Internal dsl-service settings (required when backend is internal) */
+    internal: InternalClientConfigSchema.optional(),
+    /** Base URL for Dimensions API (public backend only) */
+    baseUrl: z.string().url().default("https://app.dimensions.ai"),
+    /** Request timeout in milliseconds */
+    timeout: z.number().positive().default(30000),
+    /** Maximum number of retry attempts */
+    maxRetries: z.number().nonnegative().default(3),
+    /** Delay between retries in milliseconds */
+    retryDelay: z.number().positive().default(1000),
+    /** Maximum requests per minute (public backend client-side limiter) */
+    rateLimitPerMinute: z.number().positive().default(30),
+    /** Validate DSL queries before sending. Default: true */
+    validateQueries: z.boolean().default(false),
+})
+    .superRefine((value, ctx) => {
+    if (value.backend === "public") {
+        if (!value.apiKey) {
+            ctx.addIssue({
+                code: "custom",
+                message: "apiKey is required for public backend",
+                path: ["apiKey"],
+            });
+        }
+        return;
+    }
+    if (!value.internal) {
+        ctx.addIssue({
+            code: "custom",
+            message: "internal config is required for internal backend",
+            path: ["internal"],
+        });
+    }
+});
+//# sourceMappingURL=config.js.map

package/dist/client/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/client/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,oBAAoB;IAC7B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACN,uDAAuD;IACvD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpC,0DAA0D;IAC1D,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC;IACzD,wEAAwE;IACxE,QAAQ,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IAC/C,wDAAwD;IACxD,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC;IAC9D,sCAAsC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;IAC7C,uCAAuC;IACvC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAC/C,4CAA4C;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC/C,uEAAuE;IACvE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACrD,yDAAyD;IACzD,eAAe,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CAC5C,CAAC;KACD,WAAW,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;IAC1B,IAAI,KAAK,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YAClB,GAAG,CAAC,QAAQ,CAAC;gBACX,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,uCAAuC;gBAChD,IAAI,EAAE,CAAC,QAAQ,CAAC;aACjB,CAAC,CAAC;QACL,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;QACpB,GAAG,CAAC,QAAQ,CAAC;YACX,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,kDAAkD;YAC3D,IAAI,EAAE,CAAC,UAAU,CAAC;SACnB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/client/deployment-config.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Deployment mode and hosted backend configuration from environment.
+ * @module client/deployment-config
+ */
+import { z } from "zod";
+export type DeploymentMode = "local" | "hosted";
+export declare const InternalDslEnvSchema: z.ZodObject<{
+    serviceUrl: z.ZodString;
+    username: z.ZodString;
+    password: z.ZodString;
+    dslSchema: z.ZodString;
+    host: z.ZodString;
+    variant: z.ZodString;
+}, z.core.$strip>;
+export type InternalDslEnvConfig = z.infer<typeof InternalDslEnvSchema>;
+export interface HostedEnvConfig {
+    readonly deploymentMode: "hosted";
+    readonly radarAuthUrl: string;
+    readonly internal: InternalDslEnvConfig;
+    readonly httpPort: number;
+}
+export interface LocalEnvConfig {
+    readonly deploymentMode: "local";
+}
+export type AppDeploymentConfig = HostedEnvConfig | LocalEnvConfig;
+/**
+ * User identity for hosted schema warmup (`describe schema` at startup).
+ * dsl-service requires X-DIMENSIONS-USER before any MCP client has authenticated.
+ */
+export declare function hostedBootstrapUser(host: string): string;
+/**
+ * Loads deployment configuration from environment variables.
+ * @throws {Error} When hosted mode is enabled but required vars are missing
+ */
+export declare function loadDeploymentConfig(): AppDeploymentConfig;
+//# sourceMappingURL=deployment-config.d.ts.map

package/dist/client/deployment-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployment-config.d.ts","sourceRoot":"","sources":["../../src/client/deployment-config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,MAAM,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC;AAEhD,eAAO,MAAM,oBAAoB;;;;;;;iBAO/B,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAExE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC;IAClC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,MAAM,mBAAmB,GAAG,eAAe,GAAG,cAAc,CAAC;AAanE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,CAyC1D"}

package/dist/client/deployment-config.js

@@ -0,0 +1,79 @@
+/**
+ * Deployment mode and hosted backend configuration from environment.
+ * @module client/deployment-config
+ */
+import { z } from "zod";
+export const InternalDslEnvSchema = z.object({
+    serviceUrl: z.string().url(),
+    username: z.string().min(1),
+    password: z.string().min(1),
+    dslSchema: z.string().min(1),
+    host: z.string().min(1),
+    variant: z.string().min(1),
+});
+function readDeploymentMode() {
+    const raw = process.env.DEPLOYMENT_MODE?.trim().toLowerCase();
+    return raw === "hosted" ? "hosted" : "local";
+}
+function readIntEnv(raw, fallback, min) {
+    if (raw == null || raw.trim() === "")
+        return fallback;
+    const value = Number.parseInt(raw, 10);
+    return Number.isFinite(value) && value >= min ? value : fallback;
+}
+/**
+ * User identity for hosted schema warmup (`describe schema` at startup).
+ * dsl-service requires X-DIMENSIONS-USER before any MCP client has authenticated.
+ */
+export function hostedBootstrapUser(host) {
+    return `mcp@${host}`;
+}
+/**
+ * Loads deployment configuration from environment variables.
+ * @throws {Error} When hosted mode is enabled but required vars are missing
+ */
+export function loadDeploymentConfig() {
+    if (readDeploymentMode() !== "hosted") {
+        return { deploymentMode: "local" };
+    }
+    const serviceUrl = process.env.DSL_SERVICE_URL;
+    const username = process.env.DSL_SERVICE_USERNAME;
+    const password = process.env.DSL_SERVICE_PASSWORD;
+    const dslSchema = process.env.DSL_SCHEMA;
+    const host = process.env.DSL_HOST;
+    const variant = process.env.DSL_VARIANT;
+    const radarAuthUrl = process.env.RADAR_AUTH_URL;
+    const missing = [];
+    if (!serviceUrl)
+        missing.push("DSL_SERVICE_URL");
+    if (!username)
+        missing.push("DSL_SERVICE_USERNAME");
+    if (!password)
+        missing.push("DSL_SERVICE_PASSWORD");
+    if (!dslSchema)
+        missing.push("DSL_SCHEMA");
+    if (!host)
+        missing.push("DSL_HOST");
+    if (!variant)
+        missing.push("DSL_VARIANT");
+    if (!radarAuthUrl)
+        missing.push("RADAR_AUTH_URL");
+    if (missing.length > 0) {
+        throw new Error(`Hosted deployment requires: ${missing.join(", ")}`);
+    }
+    const internal = InternalDslEnvSchema.parse({
+        serviceUrl,
+        username,
+        password,
+        dslSchema,
+        host,
+        variant,
+    });
+    return {
+        deploymentMode: "hosted",
+        radarAuthUrl: radarAuthUrl.replace(/\/$/, ""),
+        internal,
+        httpPort: readIntEnv(process.env.MCP_HTTP_PORT, 8080, 1),
+    };
+}
+//# sourceMappingURL=deployment-config.js.map