@bankofai/x402-extensions 2.6.0-beta.0

package/dist/esm/chunk-UHTNEDIJ.mjs

@@ -0,0 +1,580 @@
+// src/bazaar/http/types.ts
+var isQueryExtensionConfig = (config) => {
+  return !("bodyType" in config) && !("toolName" in config);
+};
+var isBodyExtensionConfig = (config) => {
+  return "bodyType" in config;
+};
+
+// src/bazaar/mcp/types.ts
+var isMcpExtensionConfig = (config) => {
+  return "toolName" in config;
+};
+
+// src/bazaar/types.ts
+var BAZAAR = { key: "bazaar" };
+
+// src/bazaar/http/resourceService.ts
+function createQueryDiscoveryExtension({
+  method,
+  input = {},
+  inputSchema = { properties: {} },
+  output
+}) {
+  return {
+    info: {
+      input: {
+        type: "http",
+        ...method ? { method } : {},
+        ...input ? { queryParams: input } : {}
+      },
+      ...output?.example ? {
+        output: {
+          type: "json",
+          example: output.example
+        }
+      } : {}
+    },
+    schema: {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      type: "object",
+      properties: {
+        input: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              const: "http"
+            },
+            method: {
+              type: "string",
+              enum: ["GET", "HEAD", "DELETE"]
+            },
+            ...inputSchema ? {
+              queryParams: {
+                type: "object",
+                ...typeof inputSchema === "object" ? inputSchema : {}
+              }
+            } : {}
+          },
+          required: ["type"],
+          additionalProperties: false
+        },
+        ...output?.example ? {
+          output: {
+            type: "object",
+            properties: {
+              type: {
+                type: "string"
+              },
+              example: {
+                type: "object",
+                ...output.schema && typeof output.schema === "object" ? output.schema : {}
+              }
+            },
+            required: ["type"]
+          }
+        } : {}
+      },
+      required: ["input"]
+    }
+  };
+}
+function createBodyDiscoveryExtension({
+  method,
+  input = {},
+  inputSchema = { properties: {} },
+  bodyType,
+  output
+}) {
+  return {
+    info: {
+      input: {
+        type: "http",
+        ...method ? { method } : {},
+        bodyType,
+        body: input
+      },
+      ...output?.example ? {
+        output: {
+          type: "json",
+          example: output.example
+        }
+      } : {}
+    },
+    schema: {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      type: "object",
+      properties: {
+        input: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              const: "http"
+            },
+            method: {
+              type: "string",
+              enum: ["POST", "PUT", "PATCH"]
+            },
+            bodyType: {
+              type: "string",
+              enum: ["json", "form-data", "text"]
+            },
+            body: inputSchema
+          },
+          required: ["type", "bodyType", "body"],
+          additionalProperties: false
+        },
+        ...output?.example ? {
+          output: {
+            type: "object",
+            properties: {
+              type: {
+                type: "string"
+              },
+              example: {
+                type: "object",
+                ...output.schema && typeof output.schema === "object" ? output.schema : {}
+              }
+            },
+            required: ["type"]
+          }
+        } : {}
+      },
+      required: ["input"]
+    }
+  };
+}
+
+// src/bazaar/mcp/resourceService.ts
+function createMcpDiscoveryExtension({
+  toolName,
+  description,
+  transport,
+  inputSchema,
+  example,
+  output
+}) {
+  return {
+    info: {
+      input: {
+        type: "mcp",
+        toolName,
+        ...description !== void 0 ? { description } : {},
+        ...transport !== void 0 ? { transport } : {},
+        inputSchema,
+        ...example !== void 0 ? { example } : {}
+      },
+      ...output?.example ? {
+        output: {
+          type: "json",
+          example: output.example
+        }
+      } : {}
+    },
+    schema: {
+      $schema: "https://json-schema.org/draft/2020-12/schema",
+      type: "object",
+      properties: {
+        input: {
+          type: "object",
+          properties: {
+            type: {
+              type: "string",
+              const: "mcp"
+            },
+            toolName: {
+              type: "string"
+            },
+            ...description !== void 0 ? {
+              description: {
+                type: "string"
+              }
+            } : {},
+            ...transport !== void 0 ? {
+              transport: {
+                type: "string",
+                enum: ["streamable-http", "sse"]
+              }
+            } : {},
+            inputSchema: {
+              type: "object"
+            },
+            ...example !== void 0 ? {
+              example: {
+                type: "object"
+              }
+            } : {}
+          },
+          required: ["type", "toolName", "inputSchema"],
+          additionalProperties: false
+        },
+        ...output?.example ? {
+          output: {
+            type: "object",
+            properties: {
+              type: {
+                type: "string"
+              },
+              example: {
+                type: "object",
+                ...output.schema && typeof output.schema === "object" ? output.schema : {}
+              }
+            },
+            required: ["type"]
+          }
+        } : {}
+      },
+      required: ["input"]
+    }
+  };
+}
+
+// src/bazaar/resourceService.ts
+function declareDiscoveryExtension(config) {
+  if ("toolName" in config) {
+    const extension2 = createMcpDiscoveryExtension(config);
+    return { bazaar: extension2 };
+  }
+  const bodyType = config.bodyType;
+  const isBodyMethod2 = bodyType !== void 0;
+  const extension = isBodyMethod2 ? createBodyDiscoveryExtension(config) : createQueryDiscoveryExtension(config);
+  return { bazaar: extension };
+}
+
+// src/bazaar/server.ts
+function isHTTPRequestContext(ctx) {
+  return ctx !== null && typeof ctx === "object" && "method" in ctx && "adapter" in ctx;
+}
+var bazaarResourceServerExtension = {
+  key: BAZAAR.key,
+  enrichDeclaration: (declaration, transportContext) => {
+    if (!isHTTPRequestContext(transportContext)) {
+      return declaration;
+    }
+    const extension = declaration;
+    if (extension.info?.input?.type === "mcp") {
+      return declaration;
+    }
+    const method = transportContext.method;
+    const existingInputProps = extension.schema?.properties?.input?.properties || {};
+    const updatedInputProps = {
+      ...existingInputProps,
+      method: {
+        type: "string",
+        enum: [method]
+      }
+    };
+    return {
+      ...extension,
+      info: {
+        ...extension.info || {},
+        input: {
+          ...extension.info?.input || {},
+          method
+        }
+      },
+      schema: {
+        ...extension.schema || {},
+        properties: {
+          ...extension.schema?.properties || {},
+          input: {
+            ...extension.schema?.properties?.input || {},
+            properties: updatedInputProps,
+            required: [
+              ...extension.schema?.properties?.input?.required || [],
+              ...!(extension.schema?.properties?.input?.required || []).includes("method") ? ["method"] : []
+            ]
+          }
+        }
+      }
+    };
+  }
+};
+
+// src/bazaar/facilitator.ts
+import Ajv from "ajv/dist/2020.js";
+
+// src/bazaar/v1/facilitator.ts
+function hasV1OutputSchema(obj) {
+  return obj !== null && typeof obj === "object" && "input" in obj && obj.input !== null && typeof obj.input === "object" && "type" in obj.input && obj.input.type === "http" && "method" in obj.input;
+}
+function isQueryMethod(method) {
+  const upperMethod = method.toUpperCase();
+  return upperMethod === "GET" || upperMethod === "HEAD" || upperMethod === "DELETE";
+}
+function isBodyMethod(method) {
+  const upperMethod = method.toUpperCase();
+  return upperMethod === "POST" || upperMethod === "PUT" || upperMethod === "PATCH";
+}
+function extractQueryParams(v1Input) {
+  if (v1Input.queryParams && typeof v1Input.queryParams === "object") {
+    return v1Input.queryParams;
+  }
+  if (v1Input.query_params && typeof v1Input.query_params === "object") {
+    return v1Input.query_params;
+  }
+  if (v1Input.query && typeof v1Input.query === "object") {
+    return v1Input.query;
+  }
+  if (v1Input.params && typeof v1Input.params === "object") {
+    return v1Input.params;
+  }
+  return void 0;
+}
+function extractBodyInfo(v1Input) {
+  let bodyType = "json";
+  const bodyTypeField = v1Input.bodyType || v1Input.body_type;
+  if (bodyTypeField && typeof bodyTypeField === "string") {
+    const type = bodyTypeField.toLowerCase();
+    if (type.includes("form") || type.includes("multipart")) {
+      bodyType = "form-data";
+    } else if (type.includes("text") || type.includes("plain")) {
+      bodyType = "text";
+    } else {
+      bodyType = "json";
+    }
+  }
+  let body = {};
+  if (v1Input.bodyFields && typeof v1Input.bodyFields === "object") {
+    body = v1Input.bodyFields;
+  } else if (v1Input.body_fields && v1Input.body_fields !== null && typeof v1Input.body_fields === "object") {
+    body = v1Input.body_fields;
+  } else if (v1Input.bodyParams && typeof v1Input.bodyParams === "object") {
+    body = v1Input.bodyParams;
+  } else if (v1Input.body && typeof v1Input.body === "object") {
+    body = v1Input.body;
+  } else if (v1Input.data && typeof v1Input.data === "object") {
+    body = v1Input.data;
+  } else if (v1Input.properties && typeof v1Input.properties === "object") {
+    body = v1Input.properties;
+  }
+  return { body, bodyType };
+}
+function extractDiscoveryInfoV1(paymentRequirements) {
+  const { outputSchema } = paymentRequirements;
+  if (!outputSchema || !hasV1OutputSchema(outputSchema)) {
+    return null;
+  }
+  const v1Input = outputSchema.input;
+  const isDiscoverable = v1Input.discoverable ?? true;
+  if (!isDiscoverable) {
+    return null;
+  }
+  const method = typeof v1Input.method === "string" ? v1Input.method.toUpperCase() : "";
+  const headersRaw = v1Input.headerFields || v1Input.header_fields || v1Input.headers;
+  const headers = headersRaw && typeof headersRaw === "object" ? headersRaw : void 0;
+  const output = outputSchema.output ? {
+    type: "json",
+    example: outputSchema.output
+  } : void 0;
+  if (isQueryMethod(method)) {
+    const queryParams = extractQueryParams(v1Input);
+    const discoveryInfo = {
+      input: {
+        type: "http",
+        method,
+        ...queryParams ? { queryParams } : {},
+        ...headers ? { headers } : {}
+      },
+      ...output ? { output } : {}
+    };
+    return discoveryInfo;
+  } else if (isBodyMethod(method)) {
+    const { body, bodyType } = extractBodyInfo(v1Input);
+    const queryParams = extractQueryParams(v1Input);
+    const discoveryInfo = {
+      input: {
+        type: "http",
+        method,
+        bodyType,
+        body,
+        ...queryParams ? { queryParams } : {},
+        ...headers ? { headers } : {}
+      },
+      ...output ? { output } : {}
+    };
+    return discoveryInfo;
+  }
+  return null;
+}
+function isDiscoverableV1(paymentRequirements) {
+  return extractDiscoveryInfoV1(paymentRequirements) !== null;
+}
+function extractResourceMetadataV1(paymentRequirements) {
+  return {
+    url: paymentRequirements.resource,
+    description: paymentRequirements.description,
+    mimeType: paymentRequirements.mimeType
+  };
+}
+
+// src/bazaar/facilitator.ts
+function validateDiscoveryExtension(extension) {
+  try {
+    const ajv = new Ajv({ strict: false, allErrors: true });
+    const validate = ajv.compile(extension.schema);
+    const valid = validate(extension.info);
+    if (valid) {
+      return { valid: true };
+    }
+    const errors = validate.errors?.map((err) => {
+      const path = err.instancePath || "(root)";
+      return `${path}: ${err.message}`;
+    }) || ["Unknown validation error"];
+    return { valid: false, errors };
+  } catch (error) {
+    return {
+      valid: false,
+      errors: [
+        `Schema validation failed: ${error instanceof Error ? error.message : String(error)}`
+      ]
+    };
+  }
+}
+function extractDiscoveryInfo(paymentPayload, paymentRequirements, validate = true) {
+  let discoveryInfo = null;
+  let resourceUrl;
+  if (paymentPayload.x402Version === 2) {
+    resourceUrl = paymentPayload.resource?.url ?? "";
+    if (paymentPayload.extensions) {
+      const bazaarExtension = paymentPayload.extensions[BAZAAR.key];
+      if (bazaarExtension && typeof bazaarExtension === "object") {
+        try {
+          const extension = bazaarExtension;
+          if (validate) {
+            const result = validateDiscoveryExtension(extension);
+            if (!result.valid) {
+              console.warn(
+                `V2 discovery extension validation failed: ${result.errors?.join(", ")}`
+              );
+            } else {
+              discoveryInfo = extension.info;
+            }
+          } else {
+            discoveryInfo = extension.info;
+          }
+        } catch (error) {
+          console.warn(`V2 discovery extension extraction failed: ${error}`);
+        }
+      }
+    }
+  } else if (paymentPayload.x402Version === 1) {
+    const requirementsV1 = paymentRequirements;
+    resourceUrl = requirementsV1.resource;
+    discoveryInfo = extractDiscoveryInfoV1(requirementsV1);
+  } else {
+    return null;
+  }
+  if (!discoveryInfo) {
+    return null;
+  }
+  const url = new URL(resourceUrl);
+  const normalizedResourceUrl = `${url.origin}${url.pathname}`;
+  let description;
+  let mimeType;
+  if (paymentPayload.x402Version === 2) {
+    description = paymentPayload.resource?.description;
+    mimeType = paymentPayload.resource?.mimeType;
+  } else if (paymentPayload.x402Version === 1) {
+    const requirementsV1 = paymentRequirements;
+    description = requirementsV1.description;
+    mimeType = requirementsV1.mimeType;
+  }
+  const base = {
+    resourceUrl: normalizedResourceUrl,
+    description,
+    mimeType,
+    x402Version: paymentPayload.x402Version,
+    discoveryInfo
+  };
+  if (discoveryInfo.input.type === "mcp") {
+    return { ...base, toolName: discoveryInfo.input.toolName };
+  }
+  return { ...base, method: discoveryInfo.input.method };
+}
+function extractDiscoveryInfoFromExtension(extension, validate = true) {
+  if (validate) {
+    const result = validateDiscoveryExtension(extension);
+    if (!result.valid) {
+      throw new Error(
+        `Invalid discovery extension: ${result.errors?.join(", ") || "Unknown error"}`
+      );
+    }
+  }
+  return extension.info;
+}
+function validateAndExtract(extension) {
+  const result = validateDiscoveryExtension(extension);
+  if (result.valid) {
+    return {
+      valid: true,
+      info: extension.info
+    };
+  }
+  return {
+    valid: false,
+    errors: result.errors
+  };
+}
+
+// src/bazaar/facilitatorClient.ts
+function withBazaar(client) {
+  const existingExtensions = client.extensions ?? {};
+  const extended = client;
+  extended.extensions = {
+    ...existingExtensions,
+    discovery: {
+      async listResources(params) {
+        let headers = {
+          "Content-Type": "application/json"
+        };
+        const authHeaders = await client.createAuthHeaders("discovery");
+        headers = { ...headers, ...authHeaders.headers };
+        const queryParams = new URLSearchParams();
+        if (params?.type !== void 0) {
+          queryParams.set("type", params.type);
+        }
+        if (params?.limit !== void 0) {
+          queryParams.set("limit", params.limit.toString());
+        }
+        if (params?.offset !== void 0) {
+          queryParams.set("offset", params.offset.toString());
+        }
+        const queryString = queryParams.toString();
+        const endpoint = `${client.url}/discovery/resources${queryString ? `?${queryString}` : ""}`;
+        const response = await fetch(endpoint, {
+          method: "GET",
+          headers
+        });
+        if (!response.ok) {
+          const errorText = await response.text().catch(() => response.statusText);
+          throw new Error(
+            `Facilitator listDiscoveryResources failed (${response.status}): ${errorText}`
+          );
+        }
+        return await response.json();
+      }
+    }
+  };
+  return extended;
+}
+
+export {
+  isQueryExtensionConfig,
+  isBodyExtensionConfig,
+  isMcpExtensionConfig,
+  BAZAAR,
+  declareDiscoveryExtension,
+  bazaarResourceServerExtension,
+  extractDiscoveryInfoV1,
+  isDiscoverableV1,
+  extractResourceMetadataV1,
+  validateDiscoveryExtension,
+  extractDiscoveryInfo,
+  extractDiscoveryInfoFromExtension,
+  validateAndExtract,
+  withBazaar
+};
+//# sourceMappingURL=chunk-UHTNEDIJ.mjs.map