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

package/dist/dsl/commands/functions/ExtractGrantsCommand.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Command for extracting/resolving grants using the Dimensions API.
+ * @module commands/functions/ExtractGrantsCommand
+ */
+import { z } from "zod";
+import { Command } from "../../../client/index.js";
+import type { ExtractGrantsInput, ExtractGrantsResponse } from "../../types/special-functions.js";
+/**
+ * Zod schema for ExtractGrantsCommand input validation.
+ */
+export declare const ExtractGrantsInputSchema: z.ZodObject<{
+    grantNumber: z.ZodString;
+    fundref: z.ZodOptional<z.ZodString>;
+    funderName: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Input type for ExtractGrantsCommand (raw input).
+ */
+export type ExtractGrantsCommandInput = z.input<typeof ExtractGrantsInputSchema>;
+/**
+ * Parsed input type for ExtractGrantsCommand (after validation).
+ */
+export type ExtractGrantsCommandParsedInput = z.output<typeof ExtractGrantsInputSchema>;
+/**
+ * Command for extracting/resolving grants using the Dimensions API.
+ * Takes a grant number and optional funder information to find matching grants.
+ *
+ * @example
+ * ```typescript
+ * const cmd = new ExtractGrantsCommand({
+ *   grantNumber: "R01HL117329",
+ *   fundref: "100000050"
+ * });
+ *
+ * const result = await client.send(cmd);
+ * console.log(result.extracted_grants);
+ * // [{ id: "grant.xxx", title: "...", funder: "NIH", ... }]
+ * ```
+ */
+export declare class ExtractGrantsCommand extends Command<ExtractGrantsCommandParsedInput, ExtractGrantsResponse> {
+    static readonly inputSchema: z.ZodObject<{
+        grantNumber: z.ZodString;
+        fundref: z.ZodOptional<z.ZodString>;
+        funderName: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    readonly input: ExtractGrantsCommandParsedInput;
+    /**
+     * Creates a new ExtractGrantsCommand.
+     * @param input - Command input parameters
+     * @throws {ValidationError} If input validation fails
+     */
+    constructor(input: ExtractGrantsInput);
+    /**
+     * Resolves the DSL query for this command.
+     * @returns The constructed DSL query string
+     */
+    resolveQuery(): string;
+    /**
+     * Transforms raw API response to typed output.
+     * @param response - Raw API response
+     * @returns Typed extraction results
+     * @throws {ValidationError} If response structure is invalid
+     */
+    transformResponse(response: unknown): ExtractGrantsResponse;
+}
+//# sourceMappingURL=ExtractGrantsCommand.d.ts.map

package/dist/dsl/commands/functions/ExtractGrantsCommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtractGrantsCommand.d.ts","sourceRoot":"","sources":["../../../../src/dsl/commands/functions/ExtractGrantsCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAmB,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC;AAIlG;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;iBAOnC,CAAC;AAEH;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAEjF;;GAEG;AACH,MAAM,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAUxF;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,oBAAqB,SAAQ,OAAO,CAC/C,+BAA+B,EAC/B,qBAAqB,CACtB;IACC,MAAM,CAAC,QAAQ,CAAC,WAAW;;;;sBAA4B;IAEvD,QAAQ,CAAC,KAAK,EAAE,+BAA+B,CAAC;IAEhD;;;;OAIG;gBACS,KAAK,EAAE,kBAAkB;IAKrC;;;OAGG;IACH,YAAY,IAAI,MAAM;IAetB;;;;;OAKG;IACH,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,qBAAqB;CAW5D"}

package/dist/dsl/commands/functions/ExtractGrantsCommand.js

@@ -0,0 +1,87 @@
+/**
+ * Command for extracting/resolving grants using the Dimensions API.
+ * @module commands/functions/ExtractGrantsCommand
+ */
+import { z } from "zod";
+import { Command, ValidationError } from "../../../client/index.js";
+import { escapeDslString } from "../../utils/escape.js";
+import { validateInput } from "../validate-input.js";
+/**
+ * Zod schema for ExtractGrantsCommand input validation.
+ */
+export const ExtractGrantsInputSchema = z.object({
+    grantNumber: z
+        .string()
+        .min(1, "Grant number must not be empty")
+        .describe("Grant number to look up"),
+    fundref: z.string().optional().describe("FundRef ID of the funder"),
+    funderName: z.string().optional().describe("Funder name (alternative to fundref)"),
+});
+/**
+ * Zod schema for validating API response structure.
+ * The Dimensions API returns a single resolved grant ID, or null if not found.
+ */
+const ExtractGrantsResponseSchema = z.object({
+    grant_id: z.string().nullable(),
+});
+/**
+ * Command for extracting/resolving grants using the Dimensions API.
+ * Takes a grant number and optional funder information to find matching grants.
+ *
+ * @example
+ * ```typescript
+ * const cmd = new ExtractGrantsCommand({
+ *   grantNumber: "R01HL117329",
+ *   fundref: "100000050"
+ * });
+ *
+ * const result = await client.send(cmd);
+ * console.log(result.extracted_grants);
+ * // [{ id: "grant.xxx", title: "...", funder: "NIH", ... }]
+ * ```
+ */
+export class ExtractGrantsCommand extends Command {
+    static inputSchema = ExtractGrantsInputSchema;
+    input;
+    /**
+     * Creates a new ExtractGrantsCommand.
+     * @param input - Command input parameters
+     * @throws {ValidationError} If input validation fails
+     */
+    constructor(input) {
+        super();
+        this.input = validateInput(ExtractGrantsInputSchema, input);
+    }
+    /**
+     * Resolves the DSL query for this command.
+     * @returns The constructed DSL query string
+     */
+    resolveQuery() {
+        const parts = [];
+        parts.push(`grant_number="${escapeDslString(this.input.grantNumber)}"`);
+        // Prefer fundref over funderName if both are provided
+        if (this.input.fundref) {
+            parts.push(`fundref="${escapeDslString(this.input.fundref)}"`);
+        }
+        else if (this.input.funderName) {
+            parts.push(`funder_name="${escapeDslString(this.input.funderName)}"`);
+        }
+        return `extract_grants(${parts.join(", ")})`;
+    }
+    /**
+     * Transforms raw API response to typed output.
+     * @param response - Raw API response
+     * @returns Typed extraction results
+     * @throws {ValidationError} If response structure is invalid
+     */
+    transformResponse(response) {
+        const parseResult = ExtractGrantsResponseSchema.safeParse(response);
+        if (!parseResult.success) {
+            throw new ValidationError("Invalid API response structure", {
+                zodErrors: parseResult.error.issues,
+            });
+        }
+        return parseResult.data;
+    }
+}
+//# sourceMappingURL=ExtractGrantsCommand.js.map

package/dist/dsl/commands/functions/ExtractGrantsCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExtractGrantsCommand.js","sourceRoot":"","sources":["../../../../src/dsl/commands/functions/ExtractGrantsCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAEpE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,gCAAgC,CAAC;SACxC,QAAQ,CAAC,yBAAyB,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC;IACnE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;CACnF,CAAC,CAAC;AAYH;;;GAGG;AACH,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAChC,CAAC,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,oBAAqB,SAAQ,OAGzC;IACC,MAAM,CAAU,WAAW,GAAG,wBAAwB,CAAC;IAE9C,KAAK,CAAkC;IAEhD;;;;OAIG;IACH,YAAY,KAAyB;QACnC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,KAAK,CAAC,IAAI,CAAC,iBAAiB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAExE,sDAAsD;QACtD,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,YAAY,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACjE,CAAC;aAAM,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC;YACjC,KAAK,CAAC,IAAI,CAAC,gBAAgB,eAAe,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QACxE,CAAC;QAED,OAAO,kBAAkB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;IAC/C,CAAC;IAED;;;;;OAKG;IACH,iBAAiB,CAAC,QAAiB;QACjC,MAAM,WAAW,GAAG,2BAA2B,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEpE,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;YACzB,MAAM,IAAI,eAAe,CAAC,gCAAgC,EAAE;gBAC1D,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM;aACpC,CAAC,CAAC;QACL,CAAC;QAED,OAAO,WAAW,CAAC,IAAI,CAAC;IAC1B,CAAC"}

package/dist/dsl/commands/functions/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * DSL special function commands for the Dimensions API.
+ * Provides classify, extract_concepts, extract_affiliations, and extract_grants operations.
+ * @module commands/functions
+ */
+export { ClassifyCommand, type ClassifyCommandInput, type ClassifyCommandParsedInput, ClassifyInputSchema, } from "./ClassifyCommand.js";
+export { ExtractAffiliationsCommand, type ExtractAffiliationsCommandInput, type ExtractAffiliationsCommandParsedInput, ExtractAffiliationsInputSchema, } from "./ExtractAffiliationsCommand.js";
+export { ExtractConceptsCommand, type ExtractConceptsCommandInput, type ExtractConceptsCommandParsedInput, ExtractConceptsInputSchema, } from "./ExtractConceptsCommand.js";
+export { ExtractGrantsCommand, type ExtractGrantsCommandInput, type ExtractGrantsCommandParsedInput, ExtractGrantsInputSchema, } from "./ExtractGrantsCommand.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dsl/commands/functions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/dsl/commands/functions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,0BAA0B,EAC1B,KAAK,+BAA+B,EACpC,KAAK,qCAAqC,EAC1C,8BAA8B,GAC/B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EACtC,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,EACpC,wBAAwB,GACzB,MAAM,2BAA2B,CAAC"}

package/dist/dsl/commands/functions/index.js

@@ -0,0 +1,10 @@
+/**
+ * DSL special function commands for the Dimensions API.
+ * Provides classify, extract_concepts, extract_affiliations, and extract_grants operations.
+ * @module commands/functions
+ */
+export { ClassifyCommand, ClassifyInputSchema, } from "./ClassifyCommand.js";
+export { ExtractAffiliationsCommand, ExtractAffiliationsInputSchema, } from "./ExtractAffiliationsCommand.js";
+export { ExtractConceptsCommand, ExtractConceptsInputSchema, } from "./ExtractConceptsCommand.js";
+export { ExtractGrantsCommand, ExtractGrantsInputSchema, } from "./ExtractGrantsCommand.js";
+//# sourceMappingURL=index.js.map

package/dist/dsl/commands/functions/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/dsl/commands/functions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,eAAe,EAGf,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,0BAA0B,EAG1B,8BAA8B,GAC/B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,sBAAsB,EAGtB,0BAA0B,GAC3B,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,oBAAoB,EAGpB,wBAAwB,GACzB,MAAM,2BAA2B,CAAC"}

package/dist/dsl/commands/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Commands for the Dimensions API client.
+ * @module commands
+ */
+export type { ExtendedWhereFilterInput, WhereFilterInput } from "./facet/index.js";
+export { EntitySchema, ExtendedWhereFilterSchema, WhereFilterSchema, } from "./facet/index.js";
+export { ClassifyCommand, type ClassifyCommandInput, type ClassifyCommandParsedInput, ClassifyInputSchema, ExtractAffiliationsCommand, type ExtractAffiliationsCommandInput, type ExtractAffiliationsCommandParsedInput, ExtractAffiliationsInputSchema, ExtractConceptsCommand, type ExtractConceptsCommandInput, type ExtractConceptsCommandParsedInput, ExtractConceptsInputSchema, ExtractGrantsCommand, type ExtractGrantsCommandInput, type ExtractGrantsCommandParsedInput, ExtractGrantsInputSchema, } from "./functions/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/dsl/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/dsl/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,+BAA+B,EACpC,KAAK,qCAAqC,EAC1C,8BAA8B,EAC9B,sBAAsB,EACtB,KAAK,2BAA2B,EAChC,KAAK,iCAAiC,EACtC,0BAA0B,EAC1B,oBAAoB,EACpB,KAAK,yBAAyB,EAC9B,KAAK,+BAA+B,EACpC,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}

package/dist/dsl/commands/index.js

@@ -0,0 +1,7 @@
+/**
+ * Commands for the Dimensions API client.
+ * @module commands
+ */
+export { EntitySchema, ExtendedWhereFilterSchema, WhereFilterSchema, } from "./facet/index.js";
+export { ClassifyCommand, ClassifyInputSchema, ExtractAffiliationsCommand, ExtractAffiliationsInputSchema, ExtractConceptsCommand, ExtractConceptsInputSchema, ExtractGrantsCommand, ExtractGrantsInputSchema, } from "./functions/index.js";
+//# sourceMappingURL=index.js.map

package/dist/dsl/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/dsl/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,YAAY,EACZ,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EAGf,mBAAmB,EACnB,0BAA0B,EAG1B,8BAA8B,EAC9B,sBAAsB,EAGtB,0BAA0B,EAC1B,oBAAoB,EAGpB,wBAAwB,GACzB,MAAM,sBAAsB,CAAC"}

package/dist/dsl/commands/validate-input.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Shared input validation helper for command constructors.
+ * Reduces boilerplate across all Command subclasses.
+ * @module commands/validate-input
+ */
+import type { z } from "zod";
+/**
+ * Validates input against a Zod schema, returning the parsed result.
+ * Throws a {@link ValidationError} with the first Zod issue message on failure.
+ *
+ * @template T - The Zod schema type
+ * @param schema - Zod schema to validate against
+ * @param input - Raw input to validate
+ * @returns The parsed and validated input
+ * @throws {ValidationError} If validation fails
+ */
+export declare function validateInput<T extends z.ZodTypeAny>(schema: T, input: unknown): z.output<T>;
+//# sourceMappingURL=validate-input.d.ts.map

package/dist/dsl/commands/validate-input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-input.d.ts","sourceRoot":"","sources":["../../../src/dsl/commands/validate-input.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAS5F"}

package/dist/dsl/commands/validate-input.js

@@ -0,0 +1,27 @@
+/**
+ * Shared input validation helper for command constructors.
+ * Reduces boilerplate across all Command subclasses.
+ * @module commands/validate-input
+ */
+import { ValidationError } from "../../client/index.js";
+/**
+ * Validates input against a Zod schema, returning the parsed result.
+ * Throws a {@link ValidationError} with the first Zod issue message on failure.
+ *
+ * @template T - The Zod schema type
+ * @param schema - Zod schema to validate against
+ * @param input - Raw input to validate
+ * @returns The parsed and validated input
+ * @throws {ValidationError} If validation fails
+ */
+export function validateInput(schema, input) {
+    const result = schema.safeParse(input);
+    if (!result.success) {
+        const firstError = result.error.issues[0];
+        throw new ValidationError(firstError?.message ?? "Validation failed", {
+            zodErrors: result.error.issues,
+        });
+    }
+    return result.data;
+}
+//# sourceMappingURL=validate-input.js.map

package/dist/dsl/commands/validate-input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-input.js","sourceRoot":"","sources":["../../../src/dsl/commands/validate-input.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAAyB,MAAS,EAAE,KAAc;IAC7E,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,IAAI,eAAe,CAAC,UAAU,EAAE,OAAO,IAAI,mBAAmB,EAAE;YACpE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM;SAC/B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC"}

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

@@ -0,0 +1,32 @@
+/**
+ * Factory for DimensionsClient (public API vs internal dsl-service).
+ * @module dsl/create-client
+ */
+import type { DimensionsClientConfig } from "../client/config.js";
+import { type HostedEnvConfig } from "../client/deployment-config.js";
+import { DimensionsClient } from "./client.js";
+export interface BuildDimensionsClientConfigOptions {
+    readonly mode: "local" | "hosted";
+    readonly hosted?: HostedEnvConfig;
+    readonly apiKey?: string;
+    readonly userEmail?: string;
+    readonly clientIp?: string;
+    readonly baseUrl?: string;
+    readonly maxRetries?: number;
+    readonly retryDelay?: number;
+    readonly rateLimitPerMinute?: number;
+}
+/**
+ * Builds validated DimensionsClient configuration for local or hosted deployment.
+ */
+export declare function buildDimensionsClientConfig(options: BuildDimensionsClientConfigOptions): DimensionsClientConfig;
+export type CreateDimensionsClientOptions = BuildDimensionsClientConfigOptions;
+/**
+ * Creates a DimensionsClient backed by the public API or internal dsl-service.
+ */
+export declare function createDimensionsClient(options: CreateDimensionsClientOptions): DimensionsClient;
+/**
+ * Bootstrap client for hosted schema warmup (uses `mcp@DSL_HOST` identity).
+ */
+export declare function createBootstrapDimensionsClient(hosted: HostedEnvConfig): DimensionsClient;
+//# sourceMappingURL=create-client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.d.ts","sourceRoot":"","sources":["../../src/dsl/create-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,KAAK,eAAe,EAAuB,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,WAAW,kCAAkC;IACjD,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,kCAAkC,GAC1C,sBAAsB,CAiCxB;AAED,MAAM,MAAM,6BAA6B,GAAG,kCAAkC,CAAC;AAE/E;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,gBAAgB,CAE/F;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,CAMzF"}

package/dist/dsl/create-client.js

@@ -0,0 +1,58 @@
+/**
+ * Factory for DimensionsClient (public API vs internal dsl-service).
+ * @module dsl/create-client
+ */
+import { hostedBootstrapUser } from "../client/deployment-config.js";
+import { DimensionsClient } from "./client.js";
+/**
+ * Builds validated DimensionsClient configuration for local or hosted deployment.
+ */
+export function buildDimensionsClientConfig(options) {
+    if (options.mode === "hosted") {
+        const hosted = options.hosted;
+        if (!hosted) {
+            throw new Error("Hosted deployment config is required");
+        }
+        if (!options.userEmail) {
+            throw new Error("userEmail is required for hosted MCP sessions");
+        }
+        return {
+            backend: "internal",
+            internal: {
+                service: hosted.internal,
+                userEmail: options.userEmail,
+                clientIp: options.clientIp,
+            },
+            maxRetries: options.maxRetries,
+            retryDelay: options.retryDelay,
+        };
+    }
+    if (!options.apiKey) {
+        throw new Error("Dimensions API key required");
+    }
+    return {
+        backend: "public",
+        apiKey: options.apiKey,
+        baseUrl: options.baseUrl,
+        maxRetries: options.maxRetries,
+        retryDelay: options.retryDelay,
+        rateLimitPerMinute: options.rateLimitPerMinute,
+    };
+}
+/**
+ * Creates a DimensionsClient backed by the public API or internal dsl-service.
+ */
+export function createDimensionsClient(options) {
+    return new DimensionsClient(buildDimensionsClientConfig(options));
+}
+/**
+ * Bootstrap client for hosted schema warmup (uses `mcp@DSL_HOST` identity).
+ */
+export function createBootstrapDimensionsClient(hosted) {
+    return createDimensionsClient({
+        mode: "hosted",
+        hosted,
+        userEmail: hostedBootstrapUser(hosted.internal.host),
+    });
+}
+//# sourceMappingURL=create-client.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-client.js","sourceRoot":"","sources":["../../src/dsl/create-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAwB,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC3F,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAc/C;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,OAA2C;IAE3C,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;QACnE,CAAC;QACD,OAAO;YACL,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE;gBACR,OAAO,EAAE,MAAM,CAAC,QAAQ;gBACxB,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;aAC3B;YACD,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IAED,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,UAAU,EAAE,OAAO,CAAC,UAAU;QAC9B,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;KAC/C,CAAC;AACJ,CAAC;AAID;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,OAAsC;IAC3E,OAAO,IAAI,gBAAgB,CAAC,2BAA2B,CAAC,OAAO,CAAC,CAAC,CAAC;AACpE,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,+BAA+B,CAAC,MAAuB;IACrE,OAAO,sBAAsB,CAAC;QAC5B,IAAI,EAAE,QAAQ;QACd,MAAM;QACN,SAAS,EAAE,mBAAmB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;KACrD,CAAC,CAAC;AACL,CAAC"}