@epcc-sdk/sdks-files 0.3.0 → 0.4.1

package/README.md

@@ -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,316 @@
+"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,
+  withSharedSchemaIds: () => withSharedSchemaIds
+});
+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 WRAPPER_TYPES = [
+  "optional",
+  "nullable",
+  "default",
+  "readonly",
+  "nonoptional",
+  "catch",
+  "prefault"
+];
+const madeByLoose = /* @__PURE__ */ new WeakSet();
+function shapeCopiedOnFirstRead(copies, shape) {
+  const copy = {};
+  for (const key of Object.keys(shape)) {
+    Object.defineProperty(copy, key, {
+      configurable: true,
+      enumerable: true,
+      get() {
+        const value = looseIn(copies, shape[key]);
+        Object.defineProperty(copy, key, {
+          configurable: true,
+          enumerable: true,
+          writable: true,
+          value
+        });
+        return value;
+      }
+    });
+  }
+  return copy;
+}
+function looseCopyOf(copies, schema) {
+  const def = schema._zod.def;
+  const copy = (changes) => schema.clone({ ...def, ...changes }, { parent: true });
+  const looseChild = (child) => looseIn(copies, child);
+  if (def.type === "object") {
+    return copy({
+      catchall: z.unknown(),
+      shape: shapeCopiedOnFirstRead(copies, def.shape)
+    });
+  }
+  if (def.type === "array") {
+    return copy({ element: looseChild(def.element) });
+  }
+  if (def.type === "record") {
+    return copy({ valueType: looseChild(def.valueType) });
+  }
+  if (def.type === "lazy") {
+    return copy({ getter: () => looseChild(def.getter()) });
+  }
+  if (WRAPPER_TYPES.includes(def.type)) {
+    return copy({ innerType: looseChild(def.innerType) });
+  }
+  if (def.type === "union") {
+    return copy({ options: def.options.map(looseChild) });
+  }
+  if (def.type === "intersection") {
+    return copy({ left: looseChild(def.left), right: looseChild(def.right) });
+  }
+  return schema;
+}
+function looseIn(copies, schema) {
+  if (madeByLoose.has(schema)) return schema;
+  const known = copies.get(schema);
+  if (known) return known;
+  const copy = looseCopyOf(copies, schema);
+  copies.set(schema, copy);
+  if (copy !== schema) madeByLoose.add(copy);
+  return copy;
+}
+const loose = (schema) => looseIn(/* @__PURE__ */ new WeakMap(), schema);
+const SHARED_SCHEMA_MIN_LENGTH = 1e3;
+function reachesFrom(schema, name) {
+  const def = schema._zod.def;
+  const reach = (child) => [name, child];
+  if (def.type === "object") {
+    return Object.keys(def.shape).map((key) => [
+      key,
+      def.shape[key]
+    ]);
+  }
+  if (def.type === "array") return [reach(def.element)];
+  if (def.type === "record") return [reach(def.valueType)];
+  if (def.type === "lazy") return [reach(def.getter())];
+  if (WRAPPER_TYPES.includes(def.type)) return [reach(def.innerType)];
+  if (def.type === "union") {
+    return def.options.map((option) => reach(option));
+  }
+  if (def.type === "intersection") return [reach(def.left), reach(def.right)];
+  return [];
+}
+function reachedSchemas(input) {
+  const reached = /* @__PURE__ */ new Map();
+  const visit = (name, schema) => {
+    const seen = reached.get(schema);
+    if (seen) {
+      seen.count++;
+      return;
+    }
+    reached.set(schema, { name, count: 1 });
+    for (const [childName, child] of reachesFrom(schema, name)) {
+      visit(childName, child);
+    }
+  };
+  visit("input", input);
+  return reached;
+}
+const listedLengthOf = (schema) => JSON.stringify(
+  z.toJSONSchema(schema, {
+    io: "input",
+    target: "draft-7",
+    unrepresentable: "any"
+  })
+).length;
+function unusedIdFor(api, name) {
+  const base = `${api}_${name.replace(/[^A-Za-z0-9_]/g, "_")}`;
+  let id = base;
+  for (let suffix = 2; z.globalRegistry._idmap.has(id); suffix++) {
+    id = `${base}_${suffix}`;
+  }
+  return id;
+}
+const withSharedSchemaIds = (api, input) => {
+  const candidates = [...reachedSchemas(input)].filter(
+    ([schema, { count }]) => count > 1 && madeByLoose.has(schema) && !z.globalRegistry.has(schema)
+  ).map(([schema, { name }]) => ({
+    schema,
+    name,
+    length: listedLengthOf(schema)
+  })).filter(({ length }) => length >= SHARED_SCHEMA_MIN_LENGTH).sort((a, b) => b.length - a.length);
+  let inputLength = listedLengthOf(input);
+  for (const { schema, name } of candidates) {
+    z.globalRegistry.add(schema, {
+      ...z.globalRegistry.get(schema),
+      id: unusedIdFor(api, name)
+    });
+    const lengthWithId = listedLengthOf(input);
+    if (lengthWithId < inputLength) {
+      inputLength = lengthWithId;
+    } else {
+      z.globalRegistry.remove(schema);
+    }
+  }
+  return input;
+};
+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,
+  withSharedSchemaIds
+});
+//# 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\nconst WRAPPER_TYPES = [\n  \"optional\",\n  \"nullable\",\n  \"default\",\n  \"readonly\",\n  \"nonoptional\",\n  \"catch\",\n  \"prefault\",\n]\n\ntype LooseCopies = WeakMap<z.ZodType, z.ZodType>\n\nconst madeByLoose = new WeakSet<z.ZodType>()\n\nfunction shapeCopiedOnFirstRead(\n  copies: LooseCopies,\n  shape: Record<string, z.ZodType>,\n) {\n  const copy: Record<string, z.ZodType> = {}\n  for (const key of Object.keys(shape)) {\n    Object.defineProperty(copy, key, {\n      configurable: true,\n      enumerable: true,\n      get() {\n        const value = looseIn(copies, shape[key]!)\n        Object.defineProperty(copy, key, {\n          configurable: true,\n          enumerable: true,\n          writable: true,\n          value,\n        })\n        return value\n      },\n    })\n  }\n  return copy\n}\n\nfunction looseCopyOf<T extends z.ZodType>(copies: LooseCopies, schema: T): T {\n  const def: any = schema._zod.def\n  const copy = (changes: object): T =>\n    schema.clone({ ...def, ...changes }, { parent: true })\n  const looseChild = (child: z.ZodType) => looseIn(copies, child)\n  if (def.type === \"object\") {\n    return copy({\n      catchall: z.unknown(),\n      shape: shapeCopiedOnFirstRead(copies, def.shape),\n    })\n  }\n  if (def.type === \"array\") {\n    return copy({ element: looseChild(def.element) })\n  }\n  if (def.type === \"record\") {\n    return copy({ valueType: looseChild(def.valueType) })\n  }\n  if (def.type === \"lazy\") {\n    return copy({ getter: () => looseChild(def.getter()) })\n  }\n  if (WRAPPER_TYPES.includes(def.type)) {\n    return copy({ innerType: looseChild(def.innerType) })\n  }\n  if (def.type === \"union\") {\n    return copy({ options: def.options.map(looseChild) })\n  }\n  if (def.type === \"intersection\") {\n    return copy({ left: looseChild(def.left), right: looseChild(def.right) })\n  }\n  return schema\n}\n\nfunction looseIn<T extends z.ZodType>(copies: LooseCopies, schema: T): T {\n  if (madeByLoose.has(schema)) return schema\n  const known = copies.get(schema)\n  if (known) return known as T\n  const copy = looseCopyOf(copies, schema)\n  copies.set(schema, copy)\n  if (copy !== schema) madeByLoose.add(copy)\n  return copy\n}\n\nexport const loose = <T extends z.ZodType>(schema: T): T =>\n  looseIn(new WeakMap(), schema)\n\nconst SHARED_SCHEMA_MIN_LENGTH = 1000\n\nfunction reachesFrom(schema: z.ZodType, name: string) {\n  const def: any = schema._zod.def\n  const reach = (child: z.ZodType): [string, z.ZodType] => [name, child]\n  if (def.type === \"object\") {\n    return Object.keys(def.shape).map((key): [string, z.ZodType] => [\n      key,\n      def.shape[key],\n    ])\n  }\n  if (def.type === \"array\") return [reach(def.element)]\n  if (def.type === \"record\") return [reach(def.valueType)]\n  if (def.type === \"lazy\") return [reach(def.getter())]\n  if (WRAPPER_TYPES.includes(def.type)) return [reach(def.innerType)]\n  if (def.type === \"union\") {\n    return def.options.map((option: z.ZodType) => reach(option))\n  }\n  if (def.type === \"intersection\") return [reach(def.left), reach(def.right)]\n  return []\n}\n\nfunction reachedSchemas(input: z.ZodType) {\n  const reached = new Map<z.ZodType, { name: string; count: number }>()\n  const visit = (name: string, schema: z.ZodType) => {\n    const seen = reached.get(schema)\n    if (seen) {\n      seen.count++\n      return\n    }\n    reached.set(schema, { name, count: 1 })\n    for (const [childName, child] of reachesFrom(schema, name)) {\n      visit(childName, child)\n    }\n  }\n  visit(\"input\", input)\n  return reached\n}\n\nconst listedLengthOf = (schema: z.ZodType) =>\n  JSON.stringify(\n    z.toJSONSchema(schema, {\n      io: \"input\",\n      target: \"draft-7\",\n      unrepresentable: \"any\",\n    }),\n  ).length\n\nfunction unusedIdFor(api: string, name: string) {\n  const base = `${api}_${name.replace(/[^A-Za-z0-9_]/g, \"_\")}`\n  let id = base\n  for (let suffix = 2; z.globalRegistry._idmap.has(id); suffix++) {\n    id = `${base}_${suffix}`\n  }\n  return id\n}\n\nexport const withSharedSchemaIds = <T extends z.ZodType>(\n  api: string,\n  input: T,\n): T => {\n  const candidates = [...reachedSchemas(input)]\n    .filter(\n      ([schema, { count }]) =>\n        count > 1 && madeByLoose.has(schema) && !z.globalRegistry.has(schema),\n    )\n    .map(([schema, { name }]) => ({\n      schema,\n      name,\n      length: listedLengthOf(schema),\n    }))\n    .filter(({ length }) => length >= SHARED_SCHEMA_MIN_LENGTH)\n    .sort((a, b) => b.length - a.length)\n  let inputLength = listedLengthOf(input)\n  for (const { schema, name } of candidates) {\n    z.globalRegistry.add(schema, {\n      ...z.globalRegistry.get(schema),\n      id: unusedIdFor(api, name),\n    })\n    const lengthWithId = listedLengthOf(input)\n    if (lengthWithId < inputLength) {\n      inputLength = lengthWithId\n    } else {\n      z.globalRegistry.remove(schema)\n    }\n  }\n  return input\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,43 @@
+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;
+declare const withSharedSchemaIds: <T extends z.ZodType>(api: string, input: 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, withSharedSchemaIds };

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

@@ -0,0 +1,43 @@
+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;
+declare const withSharedSchemaIds: <T extends z.ZodType>(api: string, input: 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, withSharedSchemaIds };