@epcc-sdk/sdks-files 0.2.0 → 0.4.0

package/README.md

@@ -173,7 +173,7 @@ interceptor: an interceptor cannot see the response, so it can never retry a 401
 ## Validation schemas
 
 Zod schemas for every request body, path and response are published under the `/zod`
-subpath. `zod` is an optional peer dependency (3.x), so the root entry never imports it.
+subpath. `zod` is an optional peer dependency (4.x), so the root entry never imports it.
 
 ```ts
 import { zFile } from "@epcc-sdk/sdks-files/zod";
@@ -181,6 +181,79 @@ import { zFile } from "@epcc-sdk/sdks-files/zod";
 const file = zFile.parse(data?.data?.[0]);
 ```
 
+## MCP endpoint tools
+
+The `/mcp` subpath turns each of the 4 files operations into a Model Context Protocol (MCP) tool.
+The main entry imports none of it. `zod` 4 and `@modelcontextprotocol/sdk` are needed only for this
+subpath.
+
+Each operation has one tool factory, named after its function with `Tool` added, such as
+`getAllFilesTool`. A factory returns `{ name, config, handler }`, the three arguments that
+`McpServer.registerTool` takes. `tools()` returns all 4 in operation order. A handler returns an API
+error as an `isError` result and does not throw.
+
+Register one tool:
+
+```ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"
+import { getAllFilesTool } from "@epcc-sdk/sdks-files/mcp"
+
+const server = new McpServer({ name: "files", version: "1.0.0" })
+const tool = getAllFilesTool()
+server.registerTool(tool.name, tool.config, tool.handler)
+```
+A tool built without a client calls through the package's module level `client`, like an operation
+does. That client has no credentials until you configure it. Configure it once:
+
+```ts
+import { client, createFilesClient } from "@epcc-sdk/sdks-files"
+
+client.setConfig(createFilesClient({ baseUrl, clientId, clientSecret }).getConfig())
+```
+Register every tool, with a client that sends the same headers on every call:
+
+```ts
+import * as files from "@epcc-sdk/sdks-files/mcp"
+
+const client = createFilesClient({
+  baseUrl,
+  clientId,
+  clientSecret,
+  config: { headers: { "EP-Store-Id": storeId, "EP-Org-Id": orgId } },
+})
+files
+  .tools({ client })
+  .forEach((t) => server.registerTool(t.name, t.config, t.handler))
+```
+Register the read-only tools only:
+
+```ts
+files
+  .tools({ client })
+  .filter((t) => t.config._meta["com.elasticpath/operation"].risk === "read")
+  .forEach((t) => server.registerTool(t.name, t.config, t.handler))
+```
+Each tool is named `files_<snake_case_function>`, and its arguments are grouped under `path`,
+`query`, `headers` and `body`. The `path`, `query` and `headers` groups reject keys the spec does not
+list. The `body` keeps them, so an attribute the spec does not list still reaches the API. The client
+supplies the `Authorization` header, so no tool asks for it. Cancelling the MCP request cancels the
+HTTP request.
+
+`files_create_a_file` uploads a file. Its `file` field takes the file as a `data:` URI, such as
+`data:image/png;base64,iVBORw0KGgo…`, and `file_name` takes its name, such as `photo.png`. The tool
+decodes the file and sends it with that type and name. It accepts a file of at most 8,388,608 bytes (8 MiB), the API's default
+limit, and returns an `isError` result for a larger file, a malformed URI, or a URL, without sending
+anything. It never downloads a URL. The field carries `x-mcp-file: { maxSize: 8388608 }`, so a host that recognises the MCP file-input marker can offer a file picker. The design follows the MCP File Uploads Working Group's drafts; see [File uploads](../README.md#file-uploads) in the SDKs README for its sources. To register a file hosted elsewhere, send its URL in
+`file_location`, which the API fetches.
+
+Each tool's description is written for a model choosing between tools: what the tool does, when to
+use it rather than a similar tool, and any caveat that changes when to call it, in at most 600
+characters. The full spec description stays in the doc comment of the operation's function and its
+tool factory.
+
+`config._meta["com.elasticpath/operation"]` holds the operation's `id`, `method`, `path` and `risk`.
+The risk is `read`, `create`, `update` or `delete`, and the annotations follow from it.
+
 ## Build URL
 
 If you need to access the compiled URL, you can use the buildUrl() method. It's loosely typed by default to accept almost any value; in practice, you will want to pass a type hint.

package/dist/client/mcp-support.gen.cjs

@@ -0,0 +1,209 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mcp_support_gen_exports = {};
+__export(mcp_support_gen_exports, {
+  dataUriFields: () => dataUriFields,
+  decodeDataUris: () => decodeDataUris,
+  loose: () => loose,
+  toToolResult: () => toToolResult
+});
+module.exports = __toCommonJS(mcp_support_gen_exports);
+var z = __toESM(require("zod"), 1);
+const messageOf = (error) => error instanceof Error ? error.message : JSON.stringify(error);
+const toToolResult = async (request) => {
+  let text;
+  try {
+    const result = await request;
+    if (result.error === void 0) {
+      const structuredContent = typeof result.data === "object" && result.data !== null && !Array.isArray(result.data) ? result.data : { data: result.data ?? null };
+      return {
+        structuredContent,
+        content: [{ type: "text", text: JSON.stringify(structuredContent) }]
+      };
+    }
+    text = result.response ? `HTTP ${result.response.status}: ${JSON.stringify(result.error)}` : messageOf(result.error);
+  } catch (error) {
+    text = messageOf(error);
+  }
+  return { isError: true, content: [{ type: "text", text }] };
+};
+const loose = (schema) => {
+  const def = schema._zod.def;
+  const copy = (changes) => schema.clone({ ...def, ...changes }, { parent: true });
+  if (def.type === "object") {
+    return copy({
+      catchall: z.unknown(),
+      shape: Object.fromEntries(
+        Object.keys(def.shape).map((key) => [key, loose(def.shape[key])])
+      )
+    });
+  }
+  if (def.type === "array") {
+    return copy({ element: loose(def.element) });
+  }
+  if (def.type === "record") {
+    return copy({ valueType: loose(def.valueType) });
+  }
+  if (def.type === "lazy") {
+    return copy({ getter: () => loose(def.getter()) });
+  }
+  if ([
+    "optional",
+    "nullable",
+    "default",
+    "readonly",
+    "nonoptional",
+    "catch",
+    "prefault"
+  ].includes(def.type)) {
+    return copy({ innerType: loose(def.innerType) });
+  }
+  if (def.type === "union") {
+    return copy({ options: def.options.map(loose) });
+  }
+  if (def.type === "intersection") {
+    return copy({ left: loose(def.left), right: loose(def.right) });
+  }
+  return schema;
+};
+const dataUriFields = (schema, fields, maxBytes) => schema.extend(
+  Object.fromEntries(
+    fields.flatMap((field) => {
+      const current = schema.shape[field];
+      const uri = z.string().meta({
+        format: "uri",
+        "x-mcp-file": { maxSize: maxBytes },
+        description: [
+          current.description,
+          `Send the file as a data: URI, such as data:text/csv;base64,<base64 bytes>, at most ${maxBytes} bytes once decoded.`
+        ].filter(Boolean).join(" ")
+      });
+      const name = z.string().meta({
+        description: `The name of the file sent in ${field}, such as products.csv.`
+      }).optional();
+      return [
+        [field, current.isOptional() ? uri.optional() : uri],
+        [`${field}_name`, name]
+      ];
+    })
+  )
+);
+const DATA_URI = /^data:([^,]*),(.*)$/is;
+const PERCENT_ENCODED = /^[0-9a-f]{2}$/i;
+const notADataUriError = (field) => new Error(
+  `${field} must be a data: URI, such as data:image/png;base64,iVBORw0KGgo. This tool does not download URLs.`
+);
+const fileTooBigError = (field, bytes, maxBytes) => new Error(
+  `${field} is ${bytes} bytes, over the ${maxBytes} bytes this tool accepts`
+);
+function percentDecoded(field, text) {
+  const bytes = [];
+  const encoder = new TextEncoder();
+  for (let index = 0; index < text.length; index++) {
+    if (text[index] === "%") {
+      const hex = text.slice(index + 1, index + 3);
+      if (!PERCENT_ENCODED.test(hex)) throw notADataUriError(field);
+      bytes.push(parseInt(hex, 16));
+      index += 2;
+    } else {
+      const codePoint = text.codePointAt(index);
+      const character = String.fromCodePoint(codePoint);
+      bytes.push(...encoder.encode(character));
+      index += character.length - 1;
+    }
+  }
+  return new Uint8Array(bytes);
+}
+function base64Decoded(field, text, maxBytes) {
+  const data = text.replace(/\s/g, "");
+  const padding = data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0;
+  const bytes = Math.floor(data.length * 3 / 4) - padding;
+  if (bytes > maxBytes) throw fileTooBigError(field, bytes, maxBytes);
+  let binary;
+  try {
+    binary = atob(data);
+  } catch {
+    throw new Error(`${field} is not valid base64`);
+  }
+  return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+}
+function fileFromDataUri(field, uri, maxBytes, givenName) {
+  const match = typeof uri === "string" ? DATA_URI.exec(uri) : null;
+  if (!match) throw notADataUriError(field);
+  const parameters = match[1].split(";");
+  const isBase64 = parameters.at(-1).toLowerCase() === "base64";
+  if (isBase64) parameters.pop();
+  const mediaType = parameters.shift().trim();
+  const nameParameter = parameters.find(
+    (parameter) => parameter.trim().toLowerCase().startsWith("name=")
+  );
+  let name = field;
+  if (typeof givenName === "string" && givenName.trim()) {
+    name = givenName.trim();
+  } else if (nameParameter) {
+    try {
+      name = decodeURIComponent(nameParameter.trim().slice("name=".length));
+    } catch {
+      throw notADataUriError(field);
+    }
+  }
+  const bytes = isBase64 ? base64Decoded(field, match[2], maxBytes) : percentDecoded(field, match[2]);
+  if (bytes.length > maxBytes)
+    throw fileTooBigError(field, bytes.length, maxBytes);
+  return new File([bytes], name, {
+    type: mediaType.includes("/") ? mediaType : "text/plain"
+  });
+}
+const decodeDataUris = async (body, fields, maxBytes) => {
+  if (typeof body !== "object" || body === null) {
+    return body;
+  }
+  const decoded = { ...body };
+  for (const field of fields) {
+    const givenName = decoded[`${field}_name`];
+    delete decoded[`${field}_name`];
+    if (decoded[field] !== void 0) {
+      decoded[field] = fileFromDataUri(
+        field,
+        decoded[field],
+        maxBytes,
+        givenName
+      );
+    }
+  }
+  return decoded;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  dataUriFields,
+  decodeDataUris,
+  loose,
+  toToolResult
+});
+//# sourceMappingURL=mcp-support.gen.cjs.map

package/dist/client/mcp-support.gen.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/mcp-support.gen.ts"],"sourcesContent":["import type { ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport type { AnySchema } from \"@modelcontextprotocol/sdk/server/zod-compat.js\"\nimport type {\n  CallToolResult,\n  ToolAnnotations,\n} from \"@modelcontextprotocol/sdk/types.js\"\nimport * as z from \"zod\"\n\nexport type OperationMeta = {\n  id: string\n  method: string\n  path: string\n  risk: \"read\" | \"create\" | \"update\" | \"delete\"\n}\n\nexport type ToolConfig = {\n  title?: string\n  description?: string\n  inputSchema: z.ZodObject<Record<string, z.ZodType<any>>>\n  outputSchema?: AnySchema\n  annotations?: ToolAnnotations\n  _meta: {\n    \"com.elasticpath/operation\": OperationMeta\n  }\n}\n\nexport type Tool = {\n  readonly name: string\n  readonly config: ToolConfig\n  readonly handler: ToolCallback<AnySchema>\n}\n\nconst messageOf = (error: unknown) =>\n  error instanceof Error ? error.message : JSON.stringify(error)\n\nexport const toToolResult = async (\n  request: Promise<{\n    data?: unknown\n    error?: unknown\n    response?: Response\n  }>,\n): Promise<CallToolResult> => {\n  let text: string\n  try {\n    const result = await request\n    if (result.error === undefined) {\n      const structuredContent =\n        typeof result.data === \"object\" &&\n        result.data !== null &&\n        !Array.isArray(result.data)\n          ? (result.data as Record<string, unknown>)\n          : { data: result.data ?? null }\n      return {\n        structuredContent,\n        content: [{ type: \"text\", text: JSON.stringify(structuredContent) }],\n      }\n    }\n    text = result.response\n      ? `HTTP ${result.response.status}: ${JSON.stringify(result.error)}`\n      : messageOf(result.error)\n  } catch (error) {\n    text = messageOf(error)\n  }\n  return { isError: true, content: [{ type: \"text\", text }] }\n}\n\nexport const loose = <T extends z.ZodType>(schema: T): T => {\n  const def: any = schema._zod.def\n  const copy = (changes: object): T =>\n    schema.clone({ ...def, ...changes }, { parent: true })\n  if (def.type === \"object\") {\n    return copy({\n      catchall: z.unknown(),\n      shape: Object.fromEntries(\n        Object.keys(def.shape).map((key) => [key, loose(def.shape[key])]),\n      ),\n    })\n  }\n  if (def.type === \"array\") {\n    return copy({ element: loose(def.element) })\n  }\n  if (def.type === \"record\") {\n    return copy({ valueType: loose(def.valueType) })\n  }\n  if (def.type === \"lazy\") {\n    return copy({ getter: () => loose(def.getter()) })\n  }\n  if (\n    [\n      \"optional\",\n      \"nullable\",\n      \"default\",\n      \"readonly\",\n      \"nonoptional\",\n      \"catch\",\n      \"prefault\",\n    ].includes(def.type)\n  ) {\n    return copy({ innerType: loose(def.innerType) })\n  }\n  if (def.type === \"union\") {\n    return copy({ options: def.options.map(loose) })\n  }\n  if (def.type === \"intersection\") {\n    return copy({ left: loose(def.left), right: loose(def.right) })\n  }\n  return schema\n}\n\ntype FileNameFields<K extends string> = {\n  [P in `${K}_name`]: z.ZodOptional<z.ZodString>\n}\n\nexport const dataUriFields = <\n  S extends z.ZodRawShape,\n  C extends z.core.$ZodObjectConfig,\n  K extends string,\n>(\n  schema: z.ZodObject<S, C>,\n  fields: ReadonlyArray<K>,\n  maxBytes: number,\n): z.ZodObject<z.core.util.Extend<S, FileNameFields<K>>, C> =>\n  schema.extend(\n    Object.fromEntries(\n      fields.flatMap((field) => {\n        const current = schema.shape[field] as unknown as z.ZodType\n        const uri = z.string().meta({\n          format: \"uri\",\n          \"x-mcp-file\": { maxSize: maxBytes },\n          description: [\n            current.description,\n            `Send the file as a data: URI, such as data:text/csv;base64,<base64 bytes>, at most ${maxBytes} bytes once decoded.`,\n          ]\n            .filter(Boolean)\n            .join(\" \"),\n        })\n        const name = z\n          .string()\n          .meta({\n            description: `The name of the file sent in ${field}, such as products.csv.`,\n          })\n          .optional()\n        return [\n          [field, current.isOptional() ? uri.optional() : uri],\n          [`${field}_name`, name],\n        ]\n      }),\n    ),\n  ) as unknown as z.ZodObject<z.core.util.Extend<S, FileNameFields<K>>, C>\n\ntype DataUrisDecoded<T, K extends string> = T extends object\n  ? Omit<T, K | `${K}_name`> & {\n      [P in K & keyof T]: undefined extends T[P] ? File | undefined : File\n    }\n  : T\n\nconst DATA_URI = /^data:([^,]*),(.*)$/is\nconst PERCENT_ENCODED = /^[0-9a-f]{2}$/i\n\nconst notADataUriError = (field: string) =>\n  new Error(\n    `${field} must be a data: URI, such as data:image/png;base64,iVBORw0KGgo. This tool does not download URLs.`,\n  )\n\nconst fileTooBigError = (field: string, bytes: number, maxBytes: number) =>\n  new Error(\n    `${field} is ${bytes} bytes, over the ${maxBytes} bytes this tool accepts`,\n  )\n\nfunction percentDecoded(field: string, text: string) {\n  const bytes: number[] = []\n  const encoder = new TextEncoder()\n  for (let index = 0; index < text.length; index++) {\n    if (text[index] === \"%\") {\n      const hex = text.slice(index + 1, index + 3)\n      if (!PERCENT_ENCODED.test(hex)) throw notADataUriError(field)\n      bytes.push(parseInt(hex, 16))\n      index += 2\n    } else {\n      const codePoint = text.codePointAt(index)!\n      const character = String.fromCodePoint(codePoint)\n      bytes.push(...encoder.encode(character))\n      index += character.length - 1\n    }\n  }\n  return new Uint8Array(bytes)\n}\n\nfunction base64Decoded(field: string, text: string, maxBytes: number) {\n  const data = text.replace(/\\s/g, \"\")\n  const padding = data.endsWith(\"==\") ? 2 : data.endsWith(\"=\") ? 1 : 0\n  const bytes = Math.floor((data.length * 3) / 4) - padding\n  if (bytes > maxBytes) throw fileTooBigError(field, bytes, maxBytes)\n  let binary: string\n  try {\n    binary = atob(data)\n  } catch {\n    throw new Error(`${field} is not valid base64`)\n  }\n  return Uint8Array.from(binary, (character) => character.charCodeAt(0))\n}\n\nfunction fileFromDataUri(\n  field: string,\n  uri: unknown,\n  maxBytes: number,\n  givenName: unknown,\n) {\n  const match = typeof uri === \"string\" ? DATA_URI.exec(uri) : null\n  if (!match) throw notADataUriError(field)\n  const parameters = match[1]!.split(\";\")\n  const isBase64 = parameters.at(-1)!.toLowerCase() === \"base64\"\n  if (isBase64) parameters.pop()\n  const mediaType = parameters.shift()!.trim()\n  const nameParameter = parameters.find((parameter) =>\n    parameter.trim().toLowerCase().startsWith(\"name=\"),\n  )\n  let name = field\n  if (typeof givenName === \"string\" && givenName.trim()) {\n    name = givenName.trim()\n  } else if (nameParameter) {\n    try {\n      name = decodeURIComponent(nameParameter.trim().slice(\"name=\".length))\n    } catch {\n      throw notADataUriError(field)\n    }\n  }\n  const bytes = isBase64\n    ? base64Decoded(field, match[2]!, maxBytes)\n    : percentDecoded(field, match[2]!)\n  if (bytes.length > maxBytes)\n    throw fileTooBigError(field, bytes.length, maxBytes)\n  return new File([bytes], name, {\n    type: mediaType.includes(\"/\") ? mediaType : \"text/plain\",\n  })\n}\n\nexport const decodeDataUris = async <T, K extends string>(\n  body: T,\n  fields: ReadonlyArray<K>,\n  maxBytes: number,\n): Promise<DataUrisDecoded<T, K>> => {\n  if (typeof body !== \"object\" || body === null) {\n    return body as DataUrisDecoded<T, K>\n  }\n  const decoded = { ...body } as Record<string, unknown>\n  for (const field of fields) {\n    const givenName = decoded[`${field}_name`]\n    delete decoded[`${field}_name`]\n    if (decoded[field] !== undefined) {\n      decoded[field] = fileFromDataUri(\n        field,\n        decoded[field],\n        maxBytes,\n        givenName,\n      )\n    }\n  }\n  return decoded as DataUrisDecoded<T, K>\n}\n"],"mappings":"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","names":[]}

package/dist/client/mcp-support.gen.d.cts

@@ -0,0 +1,42 @@
+import { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { AnySchema } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import { ToolAnnotations, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import * as z from 'zod';
+
+type OperationMeta = {
+    id: string;
+    method: string;
+    path: string;
+    risk: "read" | "create" | "update" | "delete";
+};
+type ToolConfig = {
+    title?: string;
+    description?: string;
+    inputSchema: z.ZodObject<Record<string, z.ZodType<any>>>;
+    outputSchema?: AnySchema;
+    annotations?: ToolAnnotations;
+    _meta: {
+        "com.elasticpath/operation": OperationMeta;
+    };
+};
+type Tool = {
+    readonly name: string;
+    readonly config: ToolConfig;
+    readonly handler: ToolCallback<AnySchema>;
+};
+declare const toToolResult: (request: Promise<{
+    data?: unknown;
+    error?: unknown;
+    response?: Response;
+}>) => Promise<CallToolResult>;
+declare const loose: <T extends z.ZodType>(schema: T) => T;
+type FileNameFields<K extends string> = {
+    [P in `${K}_name`]: z.ZodOptional<z.ZodString>;
+};
+declare const dataUriFields: <S extends z.ZodRawShape, C extends z.core.$ZodObjectConfig, K extends string>(schema: z.ZodObject<S, C>, fields: ReadonlyArray<K>, maxBytes: number) => z.ZodObject<z.core.util.Extend<S, FileNameFields<K>>, C>;
+type DataUrisDecoded<T, K extends string> = T extends object ? Omit<T, K | `${K}_name`> & {
+    [P in K & keyof T]: undefined extends T[P] ? File | undefined : File;
+} : T;
+declare const decodeDataUris: <T, K extends string>(body: T, fields: ReadonlyArray<K>, maxBytes: number) => Promise<DataUrisDecoded<T, K>>;
+
+export { type OperationMeta, type Tool, type ToolConfig, dataUriFields, decodeDataUris, loose, toToolResult };

package/dist/client/mcp-support.gen.d.ts

@@ -0,0 +1,42 @@
+import { ToolCallback } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { AnySchema } from '@modelcontextprotocol/sdk/server/zod-compat.js';
+import { ToolAnnotations, CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import * as z from 'zod';
+
+type OperationMeta = {
+    id: string;
+    method: string;
+    path: string;
+    risk: "read" | "create" | "update" | "delete";
+};
+type ToolConfig = {
+    title?: string;
+    description?: string;
+    inputSchema: z.ZodObject<Record<string, z.ZodType<any>>>;
+    outputSchema?: AnySchema;
+    annotations?: ToolAnnotations;
+    _meta: {
+        "com.elasticpath/operation": OperationMeta;
+    };
+};
+type Tool = {
+    readonly name: string;
+    readonly config: ToolConfig;
+    readonly handler: ToolCallback<AnySchema>;
+};
+declare const toToolResult: (request: Promise<{
+    data?: unknown;
+    error?: unknown;
+    response?: Response;
+}>) => Promise<CallToolResult>;
+declare const loose: <T extends z.ZodType>(schema: T) => T;
+type FileNameFields<K extends string> = {
+    [P in `${K}_name`]: z.ZodOptional<z.ZodString>;
+};
+declare const dataUriFields: <S extends z.ZodRawShape, C extends z.core.$ZodObjectConfig, K extends string>(schema: z.ZodObject<S, C>, fields: ReadonlyArray<K>, maxBytes: number) => z.ZodObject<z.core.util.Extend<S, FileNameFields<K>>, C>;
+type DataUrisDecoded<T, K extends string> = T extends object ? Omit<T, K | `${K}_name`> & {
+    [P in K & keyof T]: undefined extends T[P] ? File | undefined : File;
+} : T;
+declare const decodeDataUris: <T, K extends string>(body: T, fields: ReadonlyArray<K>, maxBytes: number) => Promise<DataUrisDecoded<T, K>>;
+
+export { type OperationMeta, type Tool, type ToolConfig, dataUriFields, decodeDataUris, loose, toToolResult };

package/dist/client/mcp-support.gen.mjs

@@ -0,0 +1,172 @@
+import * as z from "zod";
+const messageOf = (error) => error instanceof Error ? error.message : JSON.stringify(error);
+const toToolResult = async (request) => {
+  let text;
+  try {
+    const result = await request;
+    if (result.error === void 0) {
+      const structuredContent = typeof result.data === "object" && result.data !== null && !Array.isArray(result.data) ? result.data : { data: result.data ?? null };
+      return {
+        structuredContent,
+        content: [{ type: "text", text: JSON.stringify(structuredContent) }]
+      };
+    }
+    text = result.response ? `HTTP ${result.response.status}: ${JSON.stringify(result.error)}` : messageOf(result.error);
+  } catch (error) {
+    text = messageOf(error);
+  }
+  return { isError: true, content: [{ type: "text", text }] };
+};
+const loose = (schema) => {
+  const def = schema._zod.def;
+  const copy = (changes) => schema.clone({ ...def, ...changes }, { parent: true });
+  if (def.type === "object") {
+    return copy({
+      catchall: z.unknown(),
+      shape: Object.fromEntries(
+        Object.keys(def.shape).map((key) => [key, loose(def.shape[key])])
+      )
+    });
+  }
+  if (def.type === "array") {
+    return copy({ element: loose(def.element) });
+  }
+  if (def.type === "record") {
+    return copy({ valueType: loose(def.valueType) });
+  }
+  if (def.type === "lazy") {
+    return copy({ getter: () => loose(def.getter()) });
+  }
+  if ([
+    "optional",
+    "nullable",
+    "default",
+    "readonly",
+    "nonoptional",
+    "catch",
+    "prefault"
+  ].includes(def.type)) {
+    return copy({ innerType: loose(def.innerType) });
+  }
+  if (def.type === "union") {
+    return copy({ options: def.options.map(loose) });
+  }
+  if (def.type === "intersection") {
+    return copy({ left: loose(def.left), right: loose(def.right) });
+  }
+  return schema;
+};
+const dataUriFields = (schema, fields, maxBytes) => schema.extend(
+  Object.fromEntries(
+    fields.flatMap((field) => {
+      const current = schema.shape[field];
+      const uri = z.string().meta({
+        format: "uri",
+        "x-mcp-file": { maxSize: maxBytes },
+        description: [
+          current.description,
+          `Send the file as a data: URI, such as data:text/csv;base64,<base64 bytes>, at most ${maxBytes} bytes once decoded.`
+        ].filter(Boolean).join(" ")
+      });
+      const name = z.string().meta({
+        description: `The name of the file sent in ${field}, such as products.csv.`
+      }).optional();
+      return [
+        [field, current.isOptional() ? uri.optional() : uri],
+        [`${field}_name`, name]
+      ];
+    })
+  )
+);
+const DATA_URI = /^data:([^,]*),(.*)$/is;
+const PERCENT_ENCODED = /^[0-9a-f]{2}$/i;
+const notADataUriError = (field) => new Error(
+  `${field} must be a data: URI, such as data:image/png;base64,iVBORw0KGgo. This tool does not download URLs.`
+);
+const fileTooBigError = (field, bytes, maxBytes) => new Error(
+  `${field} is ${bytes} bytes, over the ${maxBytes} bytes this tool accepts`
+);
+function percentDecoded(field, text) {
+  const bytes = [];
+  const encoder = new TextEncoder();
+  for (let index = 0; index < text.length; index++) {
+    if (text[index] === "%") {
+      const hex = text.slice(index + 1, index + 3);
+      if (!PERCENT_ENCODED.test(hex)) throw notADataUriError(field);
+      bytes.push(parseInt(hex, 16));
+      index += 2;
+    } else {
+      const codePoint = text.codePointAt(index);
+      const character = String.fromCodePoint(codePoint);
+      bytes.push(...encoder.encode(character));
+      index += character.length - 1;
+    }
+  }
+  return new Uint8Array(bytes);
+}
+function base64Decoded(field, text, maxBytes) {
+  const data = text.replace(/\s/g, "");
+  const padding = data.endsWith("==") ? 2 : data.endsWith("=") ? 1 : 0;
+  const bytes = Math.floor(data.length * 3 / 4) - padding;
+  if (bytes > maxBytes) throw fileTooBigError(field, bytes, maxBytes);
+  let binary;
+  try {
+    binary = atob(data);
+  } catch {
+    throw new Error(`${field} is not valid base64`);
+  }
+  return Uint8Array.from(binary, (character) => character.charCodeAt(0));
+}
+function fileFromDataUri(field, uri, maxBytes, givenName) {
+  const match = typeof uri === "string" ? DATA_URI.exec(uri) : null;
+  if (!match) throw notADataUriError(field);
+  const parameters = match[1].split(";");
+  const isBase64 = parameters.at(-1).toLowerCase() === "base64";
+  if (isBase64) parameters.pop();
+  const mediaType = parameters.shift().trim();
+  const nameParameter = parameters.find(
+    (parameter) => parameter.trim().toLowerCase().startsWith("name=")
+  );
+  let name = field;
+  if (typeof givenName === "string" && givenName.trim()) {
+    name = givenName.trim();
+  } else if (nameParameter) {
+    try {
+      name = decodeURIComponent(nameParameter.trim().slice("name=".length));
+    } catch {
+      throw notADataUriError(field);
+    }
+  }
+  const bytes = isBase64 ? base64Decoded(field, match[2], maxBytes) : percentDecoded(field, match[2]);
+  if (bytes.length > maxBytes)
+    throw fileTooBigError(field, bytes.length, maxBytes);
+  return new File([bytes], name, {
+    type: mediaType.includes("/") ? mediaType : "text/plain"
+  });
+}
+const decodeDataUris = async (body, fields, maxBytes) => {
+  if (typeof body !== "object" || body === null) {
+    return body;
+  }
+  const decoded = { ...body };
+  for (const field of fields) {
+    const givenName = decoded[`${field}_name`];
+    delete decoded[`${field}_name`];
+    if (decoded[field] !== void 0) {
+      decoded[field] = fileFromDataUri(
+        field,
+        decoded[field],
+        maxBytes,
+        givenName
+      );
+    }
+  }
+  return decoded;
+};
+export {
+  dataUriFields,
+  decodeDataUris,
+  loose,
+  toToolResult
+};
+//# sourceMappingURL=mcp-support.gen.mjs.map

package/dist/client/mcp-support.gen.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/mcp-support.gen.ts"],"sourcesContent":["import type { ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport type { AnySchema } from \"@modelcontextprotocol/sdk/server/zod-compat.js\"\nimport type {\n  CallToolResult,\n  ToolAnnotations,\n} from \"@modelcontextprotocol/sdk/types.js\"\nimport * as z from \"zod\"\n\nexport type OperationMeta = {\n  id: string\n  method: string\n  path: string\n  risk: \"read\" | \"create\" | \"update\" | \"delete\"\n}\n\nexport type ToolConfig = {\n  title?: string\n  description?: string\n  inputSchema: z.ZodObject<Record<string, z.ZodType<any>>>\n  outputSchema?: AnySchema\n  annotations?: ToolAnnotations\n  _meta: {\n    \"com.elasticpath/operation\": OperationMeta\n  }\n}\n\nexport type Tool = {\n  readonly name: string\n  readonly config: ToolConfig\n  readonly handler: ToolCallback<AnySchema>\n}\n\nconst messageOf = (error: unknown) =>\n  error instanceof Error ? error.message : JSON.stringify(error)\n\nexport const toToolResult = async (\n  request: Promise<{\n    data?: unknown\n    error?: unknown\n    response?: Response\n  }>,\n): Promise<CallToolResult> => {\n  let text: string\n  try {\n    const result = await request\n    if (result.error === undefined) {\n      const structuredContent =\n        typeof result.data === \"object\" &&\n        result.data !== null &&\n        !Array.isArray(result.data)\n          ? (result.data as Record<string, unknown>)\n          : { data: result.data ?? null }\n      return {\n        structuredContent,\n        content: [{ type: \"text\", text: JSON.stringify(structuredContent) }],\n      }\n    }\n    text = result.response\n      ? `HTTP ${result.response.status}: ${JSON.stringify(result.error)}`\n      : messageOf(result.error)\n  } catch (error) {\n    text = messageOf(error)\n  }\n  return { isError: true, content: [{ type: \"text\", text }] }\n}\n\nexport const loose = <T extends z.ZodType>(schema: T): T => {\n  const def: any = schema._zod.def\n  const copy = (changes: object): T =>\n    schema.clone({ ...def, ...changes }, { parent: true })\n  if (def.type === \"object\") {\n    return copy({\n      catchall: z.unknown(),\n      shape: Object.fromEntries(\n        Object.keys(def.shape).map((key) => [key, loose(def.shape[key])]),\n      ),\n    })\n  }\n  if (def.type === \"array\") {\n    return copy({ element: loose(def.element) })\n  }\n  if (def.type === \"record\") {\n    return copy({ valueType: loose(def.valueType) })\n  }\n  if (def.type === \"lazy\") {\n    return copy({ getter: () => loose(def.getter()) })\n  }\n  if (\n    [\n      \"optional\",\n      \"nullable\",\n      \"default\",\n      \"readonly\",\n      \"nonoptional\",\n      \"catch\",\n      \"prefault\",\n    ].includes(def.type)\n  ) {\n    return copy({ innerType: loose(def.innerType) })\n  }\n  if (def.type === \"union\") {\n    return copy({ options: def.options.map(loose) })\n  }\n  if (def.type === \"intersection\") {\n    return copy({ left: loose(def.left), right: loose(def.right) })\n  }\n  return schema\n}\n\ntype FileNameFields<K extends string> = {\n  [P in `${K}_name`]: z.ZodOptional<z.ZodString>\n}\n\nexport const dataUriFields = <\n  S extends z.ZodRawShape,\n  C extends z.core.$ZodObjectConfig,\n  K extends string,\n>(\n  schema: z.ZodObject<S, C>,\n  fields: ReadonlyArray<K>,\n  maxBytes: number,\n): z.ZodObject<z.core.util.Extend<S, FileNameFields<K>>, C> =>\n  schema.extend(\n    Object.fromEntries(\n      fields.flatMap((field) => {\n        const current = schema.shape[field] as unknown as z.ZodType\n        const uri = z.string().meta({\n          format: \"uri\",\n          \"x-mcp-file\": { maxSize: maxBytes },\n          description: [\n            current.description,\n            `Send the file as a data: URI, such as data:text/csv;base64,<base64 bytes>, at most ${maxBytes} bytes once decoded.`,\n          ]\n            .filter(Boolean)\n            .join(\" \"),\n        })\n        const name = z\n          .string()\n          .meta({\n            description: `The name of the file sent in ${field}, such as products.csv.`,\n          })\n          .optional()\n        return [\n          [field, current.isOptional() ? uri.optional() : uri],\n          [`${field}_name`, name],\n        ]\n      }),\n    ),\n  ) as unknown as z.ZodObject<z.core.util.Extend<S, FileNameFields<K>>, C>\n\ntype DataUrisDecoded<T, K extends string> = T extends object\n  ? Omit<T, K | `${K}_name`> & {\n      [P in K & keyof T]: undefined extends T[P] ? File | undefined : File\n    }\n  : T\n\nconst DATA_URI = /^data:([^,]*),(.*)$/is\nconst PERCENT_ENCODED = /^[0-9a-f]{2}$/i\n\nconst notADataUriError = (field: string) =>\n  new Error(\n    `${field} must be a data: URI, such as data:image/png;base64,iVBORw0KGgo. This tool does not download URLs.`,\n  )\n\nconst fileTooBigError = (field: string, bytes: number, maxBytes: number) =>\n  new Error(\n    `${field} is ${bytes} bytes, over the ${maxBytes} bytes this tool accepts`,\n  )\n\nfunction percentDecoded(field: string, text: string) {\n  const bytes: number[] = []\n  const encoder = new TextEncoder()\n  for (let index = 0; index < text.length; index++) {\n    if (text[index] === \"%\") {\n      const hex = text.slice(index + 1, index + 3)\n      if (!PERCENT_ENCODED.test(hex)) throw notADataUriError(field)\n      bytes.push(parseInt(hex, 16))\n      index += 2\n    } else {\n      const codePoint = text.codePointAt(index)!\n      const character = String.fromCodePoint(codePoint)\n      bytes.push(...encoder.encode(character))\n      index += character.length - 1\n    }\n  }\n  return new Uint8Array(bytes)\n}\n\nfunction base64Decoded(field: string, text: string, maxBytes: number) {\n  const data = text.replace(/\\s/g, \"\")\n  const padding = data.endsWith(\"==\") ? 2 : data.endsWith(\"=\") ? 1 : 0\n  const bytes = Math.floor((data.length * 3) / 4) - padding\n  if (bytes > maxBytes) throw fileTooBigError(field, bytes, maxBytes)\n  let binary: string\n  try {\n    binary = atob(data)\n  } catch {\n    throw new Error(`${field} is not valid base64`)\n  }\n  return Uint8Array.from(binary, (character) => character.charCodeAt(0))\n}\n\nfunction fileFromDataUri(\n  field: string,\n  uri: unknown,\n  maxBytes: number,\n  givenName: unknown,\n) {\n  const match = typeof uri === \"string\" ? DATA_URI.exec(uri) : null\n  if (!match) throw notADataUriError(field)\n  const parameters = match[1]!.split(\";\")\n  const isBase64 = parameters.at(-1)!.toLowerCase() === \"base64\"\n  if (isBase64) parameters.pop()\n  const mediaType = parameters.shift()!.trim()\n  const nameParameter = parameters.find((parameter) =>\n    parameter.trim().toLowerCase().startsWith(\"name=\"),\n  )\n  let name = field\n  if (typeof givenName === \"string\" && givenName.trim()) {\n    name = givenName.trim()\n  } else if (nameParameter) {\n    try {\n      name = decodeURIComponent(nameParameter.trim().slice(\"name=\".length))\n    } catch {\n      throw notADataUriError(field)\n    }\n  }\n  const bytes = isBase64\n    ? base64Decoded(field, match[2]!, maxBytes)\n    : percentDecoded(field, match[2]!)\n  if (bytes.length > maxBytes)\n    throw fileTooBigError(field, bytes.length, maxBytes)\n  return new File([bytes], name, {\n    type: mediaType.includes(\"/\") ? mediaType : \"text/plain\",\n  })\n}\n\nexport const decodeDataUris = async <T, K extends string>(\n  body: T,\n  fields: ReadonlyArray<K>,\n  maxBytes: number,\n): Promise<DataUrisDecoded<T, K>> => {\n  if (typeof body !== \"object\" || body === null) {\n    return body as DataUrisDecoded<T, K>\n  }\n  const decoded = { ...body } as Record<string, unknown>\n  for (const field of fields) {\n    const givenName = decoded[`${field}_name`]\n    delete decoded[`${field}_name`]\n    if (decoded[field] !== undefined) {\n      decoded[field] = fileFromDataUri(\n        field,\n        decoded[field],\n        maxBytes,\n        givenName,\n      )\n    }\n  }\n  return decoded as DataUrisDecoded<T, K>\n}\n"],"mappings":"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","names":[]}