@epcc-sdk/sdks-files 0.3.0 → 0.4.0

package/dist/client/mcp.gen.mjs

@@ -0,0 +1,175 @@
+import * as z from "zod";
+import {
+  dataUriFields,
+  decodeDataUris,
+  loose,
+  toToolResult
+} from "./mcp-support.gen.mjs";
+import { createAFile, deleteAFile, getAFile, getAllFiles } from "./sdk.gen.mjs";
+import {
+  zCreateAFileBody,
+  zDeleteAFilePath,
+  zGetAFilePath,
+  zGetAllFilesQuery
+} from "./zod.gen.mjs";
+const getAllFilesInput = z.object({
+  query: zGetAllFilesQuery.strict().optional()
+}).strict();
+const getAllFilesTool = (options) => {
+  const handler = (args, extra) => toToolResult(
+    getAllFiles({
+      ...args,
+      client: options?.client,
+      signal: extra.signal,
+      throwOnError: false
+    })
+  );
+  return {
+    name: "files_get_all_files",
+    config: {
+      title: "Get all Files",
+      description: "Lists the files in the store, such as product images, videos and documents, with each file's link, name, type and size. Filter by file name, width, height or file size, or get several files at once by ID with the in operator; IDs that do not exist are left out without an error. Returns at most 100 files per page.",
+      inputSchema: getAllFilesInput,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      },
+      _meta: {
+        "com.elasticpath/operation": {
+          id: "files.getAllFiles",
+          method: "GET",
+          path: "/v2/files",
+          risk: "read"
+        }
+      }
+    },
+    handler
+  };
+};
+const createAFileInput = z.object({
+  body: dataUriFields(loose(zCreateAFileBody), ["file"], 8388608)
+}).strict();
+const createAFileTool = (options) => {
+  const handler = (args, extra) => toToolResult(
+    decodeDataUris(args.body, ["file"], 8388608).then(
+      (body) => createAFile({
+        ...args,
+        client: options?.client,
+        signal: extra.signal,
+        throwOnError: false,
+        body
+      })
+    )
+  );
+  return {
+    name: "files_create_a_file",
+    config: {
+      title: "Create a File",
+      description: "Uploads a file, such as a product image, video or PDF, or registers an image hosted elsewhere by its URL. Files are limited to 8MB by default; store a larger file elsewhere and register it by URL. Returns the new file's ID and link, which you use to attach the file to a product.",
+      inputSchema: createAFileInput,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: false,
+        idempotentHint: false,
+        openWorldHint: true
+      },
+      _meta: {
+        "com.elasticpath/operation": {
+          id: "files.createAFile",
+          method: "POST",
+          path: "/v2/files",
+          risk: "create"
+        }
+      }
+    },
+    handler
+  };
+};
+const deleteAFileInput = z.object({
+  path: zDeleteAFilePath.strict()
+}).strict();
+const deleteAFileTool = (options) => {
+  const handler = (args, extra) => toToolResult(
+    deleteAFile({
+      ...args,
+      client: options?.client,
+      signal: extra.signal,
+      throwOnError: false
+    })
+  );
+  return {
+    name: "files_delete_a_file",
+    config: {
+      title: "Delete a File",
+      description: "Deletes a file from the store by its ID. To find a file's ID, list the files and filter by file name.",
+      inputSchema: deleteAFileInput,
+      annotations: {
+        readOnlyHint: false,
+        destructiveHint: true,
+        idempotentHint: true,
+        openWorldHint: true
+      },
+      _meta: {
+        "com.elasticpath/operation": {
+          id: "files.deleteAFile",
+          method: "DELETE",
+          path: "/v2/files/{fileID}",
+          risk: "delete"
+        }
+      }
+    },
+    handler
+  };
+};
+const getAFileInput = z.object({
+  path: zGetAFilePath.strict()
+}).strict();
+const getAFileTool = (options) => {
+  const handler = (args, extra) => toToolResult(
+    getAFile({
+      ...args,
+      client: options?.client,
+      signal: extra.signal,
+      throwOnError: false
+    })
+  );
+  return {
+    name: "files_get_a_file",
+    config: {
+      title: "Get a File",
+      description: "Gets one file by ID, including its link, name, type, size and dimensions. To get several files at once, list the files filtered by ID.",
+      inputSchema: getAFileInput,
+      annotations: {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true
+      },
+      _meta: {
+        "com.elasticpath/operation": {
+          id: "files.getAFile",
+          method: "GET",
+          path: "/v2/files/{fileID}",
+          risk: "read"
+        }
+      }
+    },
+    handler
+  };
+};
+const tools = (options) => [
+  getAllFilesTool(options),
+  createAFileTool(options),
+  deleteAFileTool(options),
+  getAFileTool(options)
+];
+export {
+  createAFileTool,
+  deleteAFileTool,
+  getAFileTool,
+  getAllFilesTool,
+  tools
+};
+//# sourceMappingURL=mcp.gen.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/mcp.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nimport type { ToolCallback } from \"@modelcontextprotocol/sdk/server/mcp.js\"\nimport * as z from \"zod\"\n\nimport type { Client } from \"./client\"\nimport {\n  dataUriFields,\n  decodeDataUris,\n  loose,\n  type Tool,\n  toToolResult,\n} from \"./mcp-support.gen\"\nimport { createAFile, deleteAFile, getAFile, getAllFiles } from \"./sdk.gen\"\nimport {\n  zCreateAFileBody,\n  zDeleteAFilePath,\n  zGetAFilePath,\n  zGetAllFilesQuery,\n} from \"./zod.gen\"\n\ntype ToolOptions = {\n  client?: Client\n}\n\nconst getAllFilesInput = z\n  .object({\n    query: zGetAllFilesQuery.strict().optional(),\n  })\n  .strict()\n\n/**\n * Get all Files\n *\n * Retrieves all files.\n *\n * ### Filtering\n *\n * For general filtering syntax, see [Filtering](/guides/Getting-Started/filtering).\n *\n * The following operators and attributes are available when filtering on this endpoint.\n *\n * | Attribute             | Type      | Operators           | Example |\n * |:----------------------|:----------|:--------------------------|:-------------|\n * | `id`                  | `string`  | `in`                      | `in(id,file-id-1,file-id-2,file-id-3)` |\n * | `file_name`           | `string`  | `eq` / `like`             | `eq(file_name, my_image.jpg)` |\n * | `width`               | `integer` | `gt` / `ge` / `lt` / `le` | `gt(width,200)` |\n * | `height`              | `integer` | `gt` / `ge` / `lt` / `le` | `lt(height,500)` |\n * | `file_size`           | `integer` | `gt` / `ge` / `lt` / `le` | `le(file_size,20953)` |\n *\n * #### Bulk File Retrieval\n *\n * To retrieve multiple files by their IDs in a single request, use the `in` operator with a comma-separated list of file IDs:\n *\n * ```\n * GET /v2/files?filter=in(id,06b881bd-f152-4c36-8658-7132a8fab49c,ec73567b-04e8-4000-a11a-7e1407cc2f21)\n * ```\n *\n * This is more efficient than making separate requests for each file and is recommended for bulk operations.\n *\n * **Note on invalid IDs**: If any IDs in the filter are missing, malformed, or do not exist in the store, they will be silently ignored. The response will only include files that were successfully found. For example, if you request 5 IDs but only 3 exist, the response will contain 3 files with `total: 3` in the metadata.\n *\n */\nexport const getAllFilesTool = (options?: ToolOptions) => {\n  const handler: ToolCallback<typeof getAllFilesInput> = (args, extra) =>\n    toToolResult(\n      getAllFiles({\n        ...args,\n        client: options?.client,\n        signal: extra.signal,\n        throwOnError: false,\n      }),\n    )\n  return {\n    name: \"files_get_all_files\" as const,\n    config: {\n      title: \"Get all Files\",\n      description:\n        \"Lists the files in the store, such as product images, videos and documents, with each file's link, name, type and size. Filter by file name, width, height or file size, or get several files at once by ID with the in operator; IDs that do not exist are left out without an error. Returns at most 100 files per page.\",\n      inputSchema: getAllFilesInput,\n      annotations: {\n        readOnlyHint: true,\n        destructiveHint: false,\n        idempotentHint: true,\n        openWorldHint: true,\n      },\n      _meta: {\n        \"com.elasticpath/operation\": {\n          id: \"files.getAllFiles\",\n          method: \"GET\",\n          path: \"/v2/files\",\n          risk: \"read\" as const,\n        },\n      },\n    },\n    handler,\n  }\n}\n\nconst createAFileInput = z\n  .object({\n    body: dataUriFields(loose(zCreateAFileBody), [\"file\"], 8388608),\n  })\n  .strict()\n\n/**\n * Create a File\n *\n * Create a File\n */\nexport const createAFileTool = (options?: ToolOptions) => {\n  const handler: ToolCallback<typeof createAFileInput> = (args, extra) =>\n    toToolResult(\n      decodeDataUris(args.body, [\"file\"], 8388608).then((body) =>\n        createAFile({\n          ...args,\n          client: options?.client,\n          signal: extra.signal,\n          throwOnError: false,\n          body,\n        }),\n      ),\n    )\n  return {\n    name: \"files_create_a_file\" as const,\n    config: {\n      title: \"Create a File\",\n      description:\n        \"Uploads a file, such as a product image, video or PDF, or registers an image hosted elsewhere by its URL. Files are limited to 8MB by default; store a larger file elsewhere and register it by URL. Returns the new file's ID and link, which you use to attach the file to a product.\",\n      inputSchema: createAFileInput,\n      annotations: {\n        readOnlyHint: false,\n        destructiveHint: false,\n        idempotentHint: false,\n        openWorldHint: true,\n      },\n      _meta: {\n        \"com.elasticpath/operation\": {\n          id: \"files.createAFile\",\n          method: \"POST\",\n          path: \"/v2/files\",\n          risk: \"create\" as const,\n        },\n      },\n    },\n    handler,\n  }\n}\n\nconst deleteAFileInput = z\n  .object({\n    path: zDeleteAFilePath.strict(),\n  })\n  .strict()\n\n/**\n * Delete a File\n *\n * Delete a File\n */\nexport const deleteAFileTool = (options?: ToolOptions) => {\n  const handler: ToolCallback<typeof deleteAFileInput> = (args, extra) =>\n    toToolResult(\n      deleteAFile({\n        ...args,\n        client: options?.client,\n        signal: extra.signal,\n        throwOnError: false,\n      }),\n    )\n  return {\n    name: \"files_delete_a_file\" as const,\n    config: {\n      title: \"Delete a File\",\n      description:\n        \"Deletes a file from the store by its ID. To find a file's ID, list the files and filter by file name.\",\n      inputSchema: deleteAFileInput,\n      annotations: {\n        readOnlyHint: false,\n        destructiveHint: true,\n        idempotentHint: true,\n        openWorldHint: true,\n      },\n      _meta: {\n        \"com.elasticpath/operation\": {\n          id: \"files.deleteAFile\",\n          method: \"DELETE\",\n          path: \"/v2/files/{fileID}\",\n          risk: \"delete\" as const,\n        },\n      },\n    },\n    handler,\n  }\n}\n\nconst getAFileInput = z\n  .object({\n    path: zGetAFilePath.strict(),\n  })\n  .strict()\n\n/**\n * Get a File\n *\n * Get a File\n */\nexport const getAFileTool = (options?: ToolOptions) => {\n  const handler: ToolCallback<typeof getAFileInput> = (args, extra) =>\n    toToolResult(\n      getAFile({\n        ...args,\n        client: options?.client,\n        signal: extra.signal,\n        throwOnError: false,\n      }),\n    )\n  return {\n    name: \"files_get_a_file\" as const,\n    config: {\n      title: \"Get a File\",\n      description:\n        \"Gets one file by ID, including its link, name, type, size and dimensions. To get several files at once, list the files filtered by ID.\",\n      inputSchema: getAFileInput,\n      annotations: {\n        readOnlyHint: true,\n        destructiveHint: false,\n        idempotentHint: true,\n        openWorldHint: true,\n      },\n      _meta: {\n        \"com.elasticpath/operation\": {\n          id: \"files.getAFile\",\n          method: \"GET\",\n          path: \"/v2/files/{fileID}\",\n          risk: \"read\" as const,\n        },\n      },\n    },\n    handler,\n  }\n}\n\nexport const tools = (options?: ToolOptions): Array<Tool> => [\n  getAllFilesTool(options),\n  createAFileTool(options),\n  deleteAFileTool(options),\n  getAFileTool(options),\n]\n"],"mappings":"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","names":[]}

package/dist/client/types.gen.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/types.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nexport type ClientOptions = {\n  baseUrl:\n    | \"https://euwest.api.elasticpath.com\"\n    | \"https://useast.api.elasticpath.com\"\n    | (string & {})\n}\n\nexport type ErrorResponse = {\n  errors: Array<Error>\n}\n\nexport type File = {\n  /**\n   * The unique identifier for this file.\n   */\n  id?: Uuid\n  /**\n   * The type represents the object being returned.\n   */\n  type?: string\n  /**\n   * The name of the file.\n   */\n  file_name?: string\n  /**\n   * The mime type of the file.\n   */\n  mime_type?: string\n  /**\n   * The size of the file. Required when uploading files.\n   */\n  file_size?: number\n  /**\n   * DEPRECATED Whether the file public or not. Required when uploading files.\n   */\n  public?: boolean\n  meta?: FileMeta\n  links?: Links\n  link?: FileLink\n}\n\nexport type FileMeta = {\n  /**\n   * The date and time the file was created.\n   */\n  timestamps?: {\n    /**\n     * The date and time the file was created.\n     */\n    created_at?: string\n  }\n  /**\n   * The file dimensions.\n   */\n  dimensions?: {\n    /**\n     * The width of the file.\n     */\n    width?: number\n    /**\n     * The height of the file.\n     */\n    height?: number\n  }\n}\n\nexport type ResultsMeta = {\n  /**\n   * Contains the results for the entire collection.\n   */\n  page?: {\n    /**\n     * The maximum number of records for all pages.\n     */\n    limit?: number\n    /**\n     * The current offset by number of pages.\n     */\n    offset?: number\n    /**\n     * The current number of pages.\n     */\n    current?: number\n    /**\n     * The total number of records for the entire collection.\n     */\n    total?: number\n  }\n  /**\n   * Contains the results for the entire collection.\n   */\n  results?: {\n    /**\n     * The total number of records for the entire collection.\n     */\n    total?: number\n  }\n}\n\n/**\n * Links are used to allow you to move between requests.\n */\nexport type Links = {\n  /**\n   * Single entities use a self parameter with a link to that specific resource.\n   */\n  self?: string\n}\n\n/**\n * Links are used to allow you to move between requests.\n */\nexport type ResultsLinks = {\n  /**\n   * Single entities use a self parameter with a link to that specific resource.\n   */\n  self?: string | null\n  /**\n   * The current page.\n   */\n  current?: string | null\n  /**\n   * Always the first page.\n   */\n  first?: string | null\n  /**\n   * This is `null` if there is only one page.\n   */\n  last?: string | null\n  /**\n   * The previous page. This is `null` if on the first page.\n   */\n  prev?: string | null\n  /**\n   * The next page. This is `null` if there is no next page.\n   */\n  next?: string | null\n}\n\n/**\n * The publicly available URL for this file.\n */\nexport type FileLink = {\n  /**\n   * The publicly available URL for this file.\n   */\n  href?: string\n}\n\nexport type Uuid = string\n\nexport type Error = {\n  /**\n   * The HTTP response code of the error.\n   */\n  status: number\n  /**\n   * A brief summary of the error.\n   */\n  title: string\n  /**\n   * Optional additional detail about the error.\n   */\n  detail?: string\n  /**\n   * Internal request ID.\n   */\n  request_id?: string\n  /**\n   * Additional supporting meta data for the error.\n   */\n  meta?: {\n    [key: string]: unknown\n  }\n}\n\n/**\n *\n * Filtering is available for this endpoint. See [Filtering](/docs/api/pxm/files/get-all-files#filtering).\n *\n */\nexport type Filter = string\n\n/**\n * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n */\nexport type PageOffset = string\n\n/**\n * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n */\nexport type PageLimit = string\n\nexport type GetAllFilesData = {\n  body?: never\n  path?: never\n  query?: {\n    /**\n     *\n     * Filtering is available for this endpoint. See [Filtering](/docs/api/pxm/files/get-all-files#filtering).\n     *\n     */\n    filter?: string\n    /**\n     * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n     */\n    \"page[limit]\"?: string\n    /**\n     * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n     */\n    \"page[offset]\"?: string\n  }\n  url: \"/v2/files\"\n}\n\nexport type GetAllFilesErrors = {\n  /**\n   * Bad request. The request failed validation.\n   */\n  400: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type GetAllFilesError = GetAllFilesErrors[keyof GetAllFilesErrors]\n\nexport type GetAllFilesResponses = {\n  /**\n   * OK\n   */\n  200: {\n    data?: Array<File>\n    meta?: ResultsMeta\n    links?: ResultsLinks\n  }\n}\n\nexport type GetAllFilesResponse =\n  GetAllFilesResponses[keyof GetAllFilesResponses]\n\nexport type CreateAFileData = {\n  body: {\n    /**\n     * Indicates the file you want to upload.\n     */\n    file?: Blob | File\n    /**\n     * Use this parameter to reference a file stored at a specific location. This must be the URL that points to an image file.\n     */\n    file_location?: string\n  }\n  path?: never\n  query?: never\n  url: \"/v2/files\"\n}\n\nexport type CreateAFileErrors = {\n  /**\n   * Bad request. The request failed validation.\n   */\n  400: ErrorResponse\n  /**\n   * Bad request. The request failed validation.\n   */\n  422: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type CreateAFileError = CreateAFileErrors[keyof CreateAFileErrors]\n\nexport type CreateAFileResponses = {\n  /**\n   * Created\n   */\n  201: {\n    data?: File\n  }\n}\n\nexport type CreateAFileResponse =\n  CreateAFileResponses[keyof CreateAFileResponses]\n\nexport type DeleteAFileData = {\n  body?: never\n  path: {\n    /**\n     * The unique identifier of the file you want to delete.\n     */\n    fileID: string\n  }\n  query?: never\n  url: \"/v2/files/{fileID}\"\n}\n\nexport type DeleteAFileErrors = {\n  /**\n   * Bad request. The request failed validation.\n   */\n  403: ErrorResponse\n  /**\n   * Forbidden. The operation is forbidden on this entity.\n   */\n  404: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type DeleteAFileError = DeleteAFileErrors[keyof DeleteAFileErrors]\n\nexport type DeleteAFileResponses = {\n  /**\n   * No Content\n   */\n  204: void\n}\n\nexport type DeleteAFileResponse =\n  DeleteAFileResponses[keyof DeleteAFileResponses]\n\nexport type GetAFileData = {\n  body?: never\n  path: {\n    /**\n     * The unique identifier for a file.\n     */\n    fileID: string\n  }\n  query?: never\n  url: \"/v2/files/{fileID}\"\n}\n\nexport type GetAFileErrors = {\n  /**\n   * Forbidden. The operation is forbidden on this entity.\n   */\n  404: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type GetAFileError = GetAFileErrors[keyof GetAFileErrors]\n\nexport type GetAFileResponses = {\n  200: {\n    data?: File\n  }\n}\n\nexport type GetAFileResponse = GetAFileResponses[keyof GetAFileResponses]\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../../src/client/types.gen.ts"],"sourcesContent":["// This file is auto-generated by @hey-api/openapi-ts\n\nexport type ClientOptions = {\n  baseUrl:\n    | \"https://euwest.api.elasticpath.com\"\n    | \"https://useast.api.elasticpath.com\"\n    | (string & {})\n}\n\nexport type ErrorResponse = {\n  errors: Array<Error>\n}\n\nexport type File = {\n  /**\n   * The unique identifier for this file.\n   */\n  id?: Uuid\n  /**\n   * The type represents the object being returned.\n   */\n  type?: string\n  /**\n   * The name of the file.\n   */\n  file_name?: string\n  /**\n   * The mime type of the file.\n   */\n  mime_type?: string\n  /**\n   * The size of the file. Required when uploading files.\n   */\n  file_size?: number\n  /**\n   * DEPRECATED Whether the file public or not. Required when uploading files.\n   */\n  public?: boolean\n  meta?: FileMeta\n  links?: Links\n  link?: FileLink\n}\n\nexport type FileMeta = {\n  /**\n   * The date and time the file was created.\n   */\n  timestamps?: {\n    /**\n     * The date and time the file was created.\n     */\n    created_at?: string\n  }\n  /**\n   * The file dimensions.\n   */\n  dimensions?: {\n    /**\n     * The width of the file.\n     */\n    width?: number\n    /**\n     * The height of the file.\n     */\n    height?: number\n  }\n}\n\nexport type ResultsMeta = {\n  /**\n   * Contains the results for the entire collection.\n   */\n  page?: {\n    /**\n     * The maximum number of records for all pages.\n     */\n    limit?: number\n    /**\n     * The current offset by number of pages.\n     */\n    offset?: number\n    /**\n     * The current number of pages.\n     */\n    current?: number\n    /**\n     * The total number of records for the entire collection.\n     */\n    total?: number\n  }\n  /**\n   * Contains the results for the entire collection.\n   */\n  results?: {\n    /**\n     * The total number of records for the entire collection.\n     */\n    total?: number\n  }\n}\n\n/**\n * Links are used to allow you to move between requests.\n */\nexport type Links = {\n  /**\n   * Single entities use a self parameter with a link to that specific resource.\n   */\n  self?: string\n}\n\n/**\n * Links are used to allow you to move between requests.\n */\nexport type ResultsLinks = {\n  /**\n   * Single entities use a self parameter with a link to that specific resource.\n   */\n  self?: string | null\n  /**\n   * The current page.\n   */\n  current?: string | null\n  /**\n   * Always the first page.\n   */\n  first?: string | null\n  /**\n   * This is `null` if there is only one page.\n   */\n  last?: string | null\n  /**\n   * The previous page. This is `null` if on the first page.\n   */\n  prev?: string | null\n  /**\n   * The next page. This is `null` if there is no next page.\n   */\n  next?: string | null\n}\n\n/**\n * The publicly available URL for this file.\n */\nexport type FileLink = {\n  /**\n   * The publicly available URL for this file.\n   */\n  href?: string\n}\n\nexport type Uuid = string\n\nexport type Error = {\n  /**\n   * The HTTP response code of the error.\n   */\n  status: number\n  /**\n   * A brief summary of the error.\n   */\n  title: string\n  /**\n   * Optional additional detail about the error.\n   */\n  detail?: string\n  /**\n   * Internal request ID.\n   */\n  request_id?: string\n  /**\n   * Additional supporting meta data for the error.\n   */\n  meta?: {\n    [key: string]: unknown\n  }\n}\n\n/**\n *\n * Filtering is available for this endpoint. See [Filtering](/docs/api/pxm/files/get-all-files#filtering).\n *\n */\nexport type Filter = string\n\n/**\n * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n */\nexport type PageOffset = number\n\n/**\n * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n */\nexport type PageLimit = number\n\nexport type GetAllFilesData = {\n  body?: never\n  path?: never\n  query?: {\n    /**\n     *\n     * Filtering is available for this endpoint. See [Filtering](/docs/api/pxm/files/get-all-files#filtering).\n     *\n     */\n    filter?: string\n    /**\n     * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n     */\n    \"page[limit]\"?: number\n    /**\n     * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.\n     */\n    \"page[offset]\"?: number\n  }\n  url: \"/v2/files\"\n}\n\nexport type GetAllFilesErrors = {\n  /**\n   * Bad request. The request failed validation.\n   */\n  400: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type GetAllFilesError = GetAllFilesErrors[keyof GetAllFilesErrors]\n\nexport type GetAllFilesResponses = {\n  /**\n   * OK\n   */\n  200: {\n    data?: Array<File>\n    meta?: ResultsMeta\n    links?: ResultsLinks\n  }\n}\n\nexport type GetAllFilesResponse =\n  GetAllFilesResponses[keyof GetAllFilesResponses]\n\nexport type CreateAFileData = {\n  body: {\n    /**\n     * Indicates the file you want to upload.\n     */\n    file?: Blob | File\n    /**\n     * Use this parameter to reference a file stored at a specific location. This must be the URL that points to an image file.\n     */\n    file_location?: string\n  }\n  path?: never\n  query?: never\n  url: \"/v2/files\"\n}\n\nexport type CreateAFileErrors = {\n  /**\n   * Bad request. The request failed validation.\n   */\n  400: ErrorResponse\n  /**\n   * Bad request. The request failed validation.\n   */\n  422: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type CreateAFileError = CreateAFileErrors[keyof CreateAFileErrors]\n\nexport type CreateAFileResponses = {\n  /**\n   * Created\n   */\n  201: {\n    data?: File\n  }\n}\n\nexport type CreateAFileResponse =\n  CreateAFileResponses[keyof CreateAFileResponses]\n\nexport type DeleteAFileData = {\n  body?: never\n  path: {\n    /**\n     * The unique identifier of the file you want to delete.\n     */\n    fileID: string\n  }\n  query?: never\n  url: \"/v2/files/{fileID}\"\n}\n\nexport type DeleteAFileErrors = {\n  /**\n   * Bad request. The request failed validation.\n   */\n  403: ErrorResponse\n  /**\n   * Forbidden. The operation is forbidden on this entity.\n   */\n  404: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type DeleteAFileError = DeleteAFileErrors[keyof DeleteAFileErrors]\n\nexport type DeleteAFileResponses = {\n  /**\n   * No Content\n   */\n  204: void\n}\n\nexport type DeleteAFileResponse =\n  DeleteAFileResponses[keyof DeleteAFileResponses]\n\nexport type GetAFileData = {\n  body?: never\n  path: {\n    /**\n     * The unique identifier for a file.\n     */\n    fileID: string\n  }\n  query?: never\n  url: \"/v2/files/{fileID}\"\n}\n\nexport type GetAFileErrors = {\n  /**\n   * Forbidden. The operation is forbidden on this entity.\n   */\n  404: ErrorResponse\n  /**\n   * Internal server error. There was a system failure in the platform.\n   */\n  500: ErrorResponse\n}\n\nexport type GetAFileError = GetAFileErrors[keyof GetAFileErrors]\n\nexport type GetAFileResponses = {\n  200: {\n    data?: File\n  }\n}\n\nexport type GetAFileResponse = GetAFileResponses[keyof GetAFileResponses]\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/client/types.gen.d.cts

@@ -170,11 +170,11 @@ type Filter = string;
 /**
  * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
  */
-type PageOffset = string;
+type PageOffset = number;
 /**
  * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
  */
-type PageLimit = string;
+type PageLimit = number;
 type GetAllFilesData = {
     body?: never;
     path?: never;
@@ -188,11 +188,11 @@ type GetAllFilesData = {
         /**
          * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
          */
-        "page[limit]"?: string;
+        "page[limit]"?: number;
         /**
          * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
          */
-        "page[offset]"?: string;
+        "page[offset]"?: number;
     };
     url: "/v2/files";
 };

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

@@ -170,11 +170,11 @@ type Filter = string;
 /**
  * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
  */
-type PageOffset = string;
+type PageOffset = number;
 /**
  * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
  */
-type PageLimit = string;
+type PageLimit = number;
 type GetAllFilesData = {
     body?: never;
     path?: never;
@@ -188,11 +188,11 @@ type GetAllFilesData = {
         /**
          * The maximum number of records per page for this response. You can set this value up to 100. If no page size is set, the the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
          */
-        "page[limit]"?: string;
+        "page[limit]"?: number;
         /**
          * The current offset by number of records, not pages. Offset is zero-based. The maximum records you can offset is 10,000. If no page size is set, the [**page length**](/docs/commerce-cloud/global-project-settings/settings-overview#page-length) store setting is used.
          */
-        "page[offset]"?: string;
+        "page[offset]"?: number;
     };
     url: "/v2/files";
 };

package/dist/mcp.cjs

@@ -0,0 +1,23 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var mcp_exports = {};
+module.exports = __toCommonJS(mcp_exports);
+__reExport(mcp_exports, require('./client/mcp.gen.cjs'), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require('./client/mcp.gen.cjs')
+});
+//# sourceMappingURL=mcp.cjs.map

package/dist/mcp.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["export * from \"./client/mcp.gen\"\nexport type { OperationMeta, Tool, ToolConfig } from \"./client/mcp-support.gen\"\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,wBAAc,6BAAd;","names":[]}

package/dist/mcp.d.cts

@@ -0,0 +1,14 @@
+export { createAFileTool, deleteAFileTool, getAFileTool, getAllFilesTool, tools } from './client/mcp.gen.cjs';
+export { OperationMeta, Tool, ToolConfig } from './client/mcp-support.gen.cjs';
+import '@modelcontextprotocol/sdk/shared/protocol';
+import '@modelcontextprotocol/sdk/types';
+import 'zod';
+import './types.gen-mB6gWg8u.cjs';
+import './client/core/auth.gen.cjs';
+import './client/core/serverSentEvents.gen.cjs';
+import './client/core/types.gen.cjs';
+import './client/core/bodySerializer.gen.cjs';
+import './client/core/pathSerializer.gen.cjs';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+import '@modelcontextprotocol/sdk/server/zod-compat.js';
+import '@modelcontextprotocol/sdk/types.js';

package/dist/mcp.d.ts

@@ -0,0 +1,14 @@
+export { createAFileTool, deleteAFileTool, getAFileTool, getAllFilesTool, tools } from './client/mcp.gen.js';
+export { OperationMeta, Tool, ToolConfig } from './client/mcp-support.gen.js';
+import '@modelcontextprotocol/sdk/shared/protocol';
+import '@modelcontextprotocol/sdk/types';
+import 'zod';
+import './types.gen-DXwTHYA3.js';
+import './client/core/auth.gen.js';
+import './client/core/serverSentEvents.gen.js';
+import './client/core/types.gen.js';
+import './client/core/bodySerializer.gen.js';
+import './client/core/pathSerializer.gen.js';
+import '@modelcontextprotocol/sdk/server/mcp.js';
+import '@modelcontextprotocol/sdk/server/zod-compat.js';
+import '@modelcontextprotocol/sdk/types.js';

package/dist/mcp.mjs

@@ -0,0 +1,2 @@
+export * from "./client/mcp.gen.mjs";
+//# sourceMappingURL=mcp.mjs.map

package/dist/mcp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/mcp.ts"],"sourcesContent":["export * from \"./client/mcp.gen\"\nexport type { OperationMeta, Tool, ToolConfig } from \"./client/mcp-support.gen\"\n"],"mappings":"AAAA,cAAc;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epcc-sdk/sdks-files",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -27,12 +27,25 @@
         "default": "./dist/zod.cjs"
       }
     },
+    "./mcp": {
+      "import": {
+        "types": "./dist/mcp.d.ts",
+        "default": "./dist/mcp.mjs"
+      },
+      "require": {
+        "types": "./dist/mcp.d.cts",
+        "default": "./dist/mcp.cjs"
+      }
+    },
     "./package.json": "./package.json"
   },
   "typesVersions": {
     "*": {
       "zod": [
         "./dist/zod.d.ts"
+      ],
+      "mcp": [
+        "./dist/mcp.d.ts"
       ]
     }
   },
@@ -48,6 +61,9 @@
   },
   "devDependencies": {
     "@hey-api/openapi-ts": "0.99.0",
+    "@modelcontextprotocol/sdk": "1.31.0",
+    "@redocly/cli": "^1.21.0",
+    "@redocly/openapi-core": "^1.21.0",
     "@types/ejs": "^3.1.5",
     "ejs": "^3.1.10",
     "esbuild-fix-imports-plugin": "^1.0.19",
@@ -58,16 +74,21 @@
     "zod": "4.6.5"
   },
   "peerDependencies": {
+    "@modelcontextprotocol/sdk": "^1.31.0",
     "zod": "^4.0.0"
   },
   "peerDependenciesMeta": {
+    "@modelcontextprotocol/sdk": {
+      "optional": true
+    },
     "zod": {
       "optional": true
     }
   },
   "scripts": {
-    "build": "pnpm openapi-ts && pnpm build:tsup",
+    "build": "pnpm oas:build && pnpm openapi-ts && pnpm build:tsup",
     "build:tsup": "tsup",
+    "oas:build": "redocly bundle files-standalone@v1 --config ../specs/config/redocly.yaml",
     "openapi-ts": "openapi-ts",
     "test": "vitest run",
     "test:watch": "vitest"