feat(management): endpoint schemas + facilitator/x402Version on createApi

[TheRealAlexandre]

Summary

Fill in the remaining gaps in the Management API TypeScript types so every field the server already accepts is reachable from the SDK — and APIs created through the SDK show up in the marketplace with fully populated test forms.

1. Endpoint schemas (commit a39dc09)

Without schema info, the marketplace Test tab renders no inputs. Callers now have three ergonomic options (any one is enough):

• Per-endpoint parameters — OpenAPI Parameter Objects (query / path / header), with full field preservation (schema, style, example, deprecated, ...).
• Per-endpoint requestBody — full OpenAPI shape ({ content: { 'application/json': { schema } } }) or simplified inner-schema shape ({ required: [...], properties: {...} }).
• Top-level openApi on CreateApiInput — pass a full OpenAPI 3.x document (object or JSON string). If endpoints is omitted, endpoints are derived from the spec's paths with a default price.

New types: OpenApiParameter, OpenApiRequestBody.

2. Facilitator & x402Version (commit ba85de1)

facilitator and x402Version were accepted server-side but not typed. Expose them on CreateApiInput, export a Facilitator union (with a (string & {}) escape hatch so new facilitators don't break builds) and an X402Version = 1 | 2 alias. Server still validates the (facilitator, network, version) triple against its support matrix.

No breaking changes — every new field is optional.

Usage

await mgmt.createApi({
  name, baseUrl, merchantWallet,
  network: 'base',
  facilitator: 'payai',
  x402Version: 2,
  endpoints: [
    {
      path: '/v1/search',
      method: 'get',
      usdPrice: 0.05,
      parameters: [
        { name: 'q', in: 'query', required: true, description: 'Search query' },
        { name: 'limit', in: 'query', schema: { type: 'integer' } },
      ],
    },
    {
      path: '/v1/predict',
      method: 'post',
      usdPrice: 0.10,
      requestBody: {
        required: ['prompt'],
        properties: {
          prompt: { type: 'string' },
          temperature: { type: 'number', minimum: 0, maximum: 1 },
        },
      },
    },
  ],
});

// Alternative — pass a full OpenAPI spec:
await mgmt.createApi({
  name, baseUrl, merchantWallet, network: 'base',
  openApi: require('./my-openapi.json'),
});

Test plan

• npx tsc --noEmit passes (verified).
• Per-endpoint parameters renders query inputs on the marketplace test tab.
• Per-endpoint requestBody (simplified shape) renders the body form.
• Full openApi spec — endpoints auto-derived, schemas available.
• facilitator: 'relai' with network: 'skale-base' accepted; facilitator: 'dexter' with network: 'skale-base' rejected with 400.
• Omitting all new fields is still accepted (backwards-compatible).