@epcc-sdk/sdks-cart-checkout-order 0.5.0 → 0.5.2

package/README.md

@@ -266,6 +266,11 @@ does not list. The `body` keeps them, so an attribute the spec does not list sti
 The client supplies the `Authorization` header, so no tool asks for it. Cancelling the MCP request
 cancels the HTTP request.
 
+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.
 `anonymizeOrders` is a `POST` that replaces customer data in existing orders and cannot be undone,

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

@@ -28,6 +28,8 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 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
 });
@@ -90,8 +92,117 @@ const loose = (schema) => {
   }
   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
 });

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

@@ -1 +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"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,QAAmB;AA0BnB,MAAM,YAAY,CAAC,UACjB,iBAAiB,QAAQ,MAAM,UAAU,KAAK,UAAU,KAAK;AAExD,MAAM,eAAe,OAC1B,YAK4B;AAC5B,MAAI;AACJ,MAAI;AACF,UAAM,SAAS,MAAM;AACrB,QAAI,OAAO,UAAU,QAAW;AAC9B,YAAM,oBACJ,OAAO,OAAO,SAAS,YACvB,OAAO,SAAS,QAChB,CAAC,MAAM,QAAQ,OAAO,IAAI,IACrB,OAAO,OACR,EAAE,MAAM,OAAO,QAAQ,KAAK;AAClC,aAAO;AAAA,QACL;AAAA,QACA,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,iBAAiB,EAAE,CAAC;AAAA,MACrE;AAAA,IACF;AACA,WAAO,OAAO,WACV,QAAQ,OAAO,SAAS,MAAM,KAAK,KAAK,UAAU,OAAO,KAAK,CAAC,KAC/D,UAAU,OAAO,KAAK;AAAA,EAC5B,SAAS,OAAO;AACd,WAAO,UAAU,KAAK;AAAA,EACxB;AACA,SAAO,EAAE,SAAS,MAAM,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAC5D;AAEO,MAAM,QAAQ,CAAsB,WAAiB;AAC1D,QAAM,MAAW,OAAO,KAAK;AAC7B,QAAM,OAAO,CAAC,YACZ,OAAO,MAAM,EAAE,GAAG,KAAK,GAAG,QAAQ,GAAG,EAAE,QAAQ,KAAK,CAAC;AACvD,MAAI,IAAI,SAAS,UAAU;AACzB,WAAO,KAAK;AAAA,MACV,UAAU,EAAE,QAAQ;AAAA,MACpB,OAAO,OAAO;AAAA,QACZ,OAAO,KAAK,IAAI,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;AAAA,MAClE;AAAA,IACF,CAAC;AAAA,EACH;AACA,MAAI,IAAI,SAAS,SAAS;AACxB,WAAO,KAAK,EAAE,SAAS,MAAM,IAAI,OAAO,EAAE,CAAC;AAAA,EAC7C;AACA,MAAI,IAAI,SAAS,UAAU;AACzB,WAAO,KAAK,EAAE,WAAW,MAAM,IAAI,SAAS,EAAE,CAAC;AAAA,EACjD;AACA,MAAI,IAAI,SAAS,QAAQ;AACvB,WAAO,KAAK,EAAE,QAAQ,MAAM,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;AAAA,EACnD;AACA,MACE;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,SAAS,IAAI,IAAI,GACnB;AACA,WAAO,KAAK,EAAE,WAAW,MAAM,IAAI,SAAS,EAAE,CAAC;AAAA,EACjD;AACA,MAAI,IAAI,SAAS,SAAS;AACxB,WAAO,KAAK,EAAE,SAAS,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;AAAA,EACjD;AACA,MAAI,IAAI,SAAS,gBAAgB;AAC/B,WAAO,KAAK,EAAE,MAAM,MAAM,IAAI,IAAI,GAAG,OAAO,MAAM,IAAI,KAAK,EAAE,CAAC;AAAA,EAChE;AACA,SAAO;AACT;","names":[]}
+{"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.mjs

@@ -56,7 +56,116 @@ const loose = (schema) => {
   }
   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
 };

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

@@ -1 +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"],"mappings":"AAMA,YAAY,OAAO;AA0BnB,MAAM,YAAY,CAAC,UACjB,iBAAiB,QAAQ,MAAM,UAAU,KAAK,UAAU,KAAK;AAExD,MAAM,eAAe,OAC1B,YAK4B;AAC5B,MAAI;AACJ,MAAI;AACF,UAAM,SAAS,MAAM;AACrB,QAAI,OAAO,UAAU,QAAW;AAC9B,YAAM,oBACJ,OAAO,OAAO,SAAS,YACvB,OAAO,SAAS,QAChB,CAAC,MAAM,QAAQ,OAAO,IAAI,IACrB,OAAO,OACR,EAAE,MAAM,OAAO,QAAQ,KAAK;AAClC,aAAO;AAAA,QACL;AAAA,QACA,SAAS,CAAC,EAAE,MAAM,QAAQ,MAAM,KAAK,UAAU,iBAAiB,EAAE,CAAC;AAAA,MACrE;AAAA,IACF;AACA,WAAO,OAAO,WACV,QAAQ,OAAO,SAAS,MAAM,KAAK,KAAK,UAAU,OAAO,KAAK,CAAC,KAC/D,UAAU,OAAO,KAAK;AAAA,EAC5B,SAAS,OAAO;AACd,WAAO,UAAU,KAAK;AAAA,EACxB;AACA,SAAO,EAAE,SAAS,MAAM,SAAS,CAAC,EAAE,MAAM,QAAQ,KAAK,CAAC,EAAE;AAC5D;AAEO,MAAM,QAAQ,CAAsB,WAAiB;AAC1D,QAAM,MAAW,OAAO,KAAK;AAC7B,QAAM,OAAO,CAAC,YACZ,OAAO,MAAM,EAAE,GAAG,KAAK,GAAG,QAAQ,GAAG,EAAE,QAAQ,KAAK,CAAC;AACvD,MAAI,IAAI,SAAS,UAAU;AACzB,WAAO,KAAK;AAAA,MACV,UAAU,EAAE,QAAQ;AAAA,MACpB,OAAO,OAAO;AAAA,QACZ,OAAO,KAAK,IAAI,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,MAAM,IAAI,MAAM,GAAG,CAAC,CAAC,CAAC;AAAA,MAClE;AAAA,IACF,CAAC;AAAA,EACH;AACA,MAAI,IAAI,SAAS,SAAS;AACxB,WAAO,KAAK,EAAE,SAAS,MAAM,IAAI,OAAO,EAAE,CAAC;AAAA,EAC7C;AACA,MAAI,IAAI,SAAS,UAAU;AACzB,WAAO,KAAK,EAAE,WAAW,MAAM,IAAI,SAAS,EAAE,CAAC;AAAA,EACjD;AACA,MAAI,IAAI,SAAS,QAAQ;AACvB,WAAO,KAAK,EAAE,QAAQ,MAAM,MAAM,IAAI,OAAO,CAAC,EAAE,CAAC;AAAA,EACnD;AACA,MACE;AAAA,IACE;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,EAAE,SAAS,IAAI,IAAI,GACnB;AACA,WAAO,KAAK,EAAE,WAAW,MAAM,IAAI,SAAS,EAAE,CAAC;AAAA,EACjD;AACA,MAAI,IAAI,SAAS,SAAS;AACxB,WAAO,KAAK,EAAE,SAAS,IAAI,QAAQ,IAAI,KAAK,EAAE,CAAC;AAAA,EACjD;AACA,MAAI,IAAI,SAAS,gBAAgB;AAC/B,WAAO,KAAK,EAAE,MAAM,MAAM,IAAI,IAAI,GAAG,OAAO,MAAM,IAAI,KAAK,EAAE,CAAC;AAAA,EAChE;AACA,SAAO;AACT;","names":[]}
+{"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":[]}