Invalid Typescript schema requested for POST

Hi, love this initiative. It’s allowed me to remove hundreds of lines of code.

I’ve got a strange problem trying to wire up a POST request using the standard approach:

export const submitForm = fetcher.path('/form/{formId}/submit').method('post').create();

The Swagger API definition requests formId as a parameter and formFields as the post body, but the returned function requests the following input, a intersection between an object and an array, which is impossible to provide:

I might be doing something wrong, but it seems like a potential bug. Here’s the type for the request:

"/form/{formId}/submit": {
    post: {
      parameters: {
        path: {
          formId: string;
        };
      };
      responses: {
        /** Success */
        200: {
          content: {
            "text/plain": components["schemas"]["FormModel"];
            "application/json": components["schemas"]["FormModel"];
            "text/json": components["schemas"]["FormModel"];
          };
        };
      };
      requestBody: {
        content: {
          "application/json":
            | components["schemas"]["FormFieldInputModel"][]
            | null;
          "text/json": components["schemas"]["FormFieldInputModel"][] | null;
          "application/*+json":
            | components["schemas"]["FormFieldInputModel"][]
            | null;
        };
      };
    };
  };

[ajaishankar]

@bnhovde as a workaround you could try

submitForm(
  Object.assign(
    [ { identifier: "id", value: 1, observedAt: "now" } ], // body array first
    { formId: "form1" } // param next
  )
)

You still get type safety on the required properties.

[kirypto]

Hate to say it, but I think I might have evidence that top level arrays in a body is a fairly common usecase: RFC 6902 - Section 3.

That being said, it does look like the workaround and the utility function arrayRequestBody you provided is doing the trick! Just made use of it, and as with the rest of the library, it trivialized the problem. Really glad I ran across this library. Honestly this is the first time I’ve had an API service actually backed directly by the openapi spec with type validation and it’s fantastic.