@let-aurn/swagger-client 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,89 @@
+export type ClientKind = "angular" | "react";
+export type EndpointNameStrategy = "operationId" | "tagAndOperationId";
+export interface SwaggerClientConfig {
+    client: ClientKind;
+    "swaggers-directory": string;
+    "endpoint-name-strategy"?: EndpointNameStrategy;
+    output: {
+        "api-models.ts": string;
+        "api-endpoints.ts": string;
+        "client.ts": string;
+    };
+}
+export interface ProjectModel {
+    schemas: SchemaModel[];
+    endpoints: EndpointModel[];
+}
+export interface SchemaModel {
+    name: string;
+    schema: OpenApiSchema;
+}
+export interface EndpointModel {
+    name: string;
+    method: HttpMethod;
+    path: string;
+    operationId: string;
+    sourceFile: string;
+    pathVariables: VariableModel[];
+    queryVariables: VariableModel[];
+    headerVariables: VariableModel[];
+    bodyType: string | null;
+    responseType: string;
+}
+export interface VariableModel {
+    name: string;
+    type: string;
+    required: boolean;
+}
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+export interface OpenApiDocument {
+    openapi?: string;
+    swagger?: string;
+    info?: {
+        title?: string;
+        version?: string;
+    };
+    paths?: Record<string, Record<string, OpenApiOperation | unknown>>;
+    components?: {
+        schemas?: Record<string, OpenApiSchema>;
+    };
+    definitions?: Record<string, OpenApiSchema>;
+}
+export interface OpenApiOperation {
+    operationId?: string;
+    tags?: string[];
+    parameters?: OpenApiParameter[];
+    requestBody?: {
+        required?: boolean;
+        content?: Record<string, {
+            schema?: OpenApiSchema;
+        }>;
+    };
+    responses?: Record<string, OpenApiResponse>;
+}
+export interface OpenApiParameter {
+    name: string;
+    in: "path" | "query" | "header" | "cookie";
+    required?: boolean;
+    schema?: OpenApiSchema;
+}
+export interface OpenApiResponse {
+    description?: string;
+    content?: Record<string, {
+        schema?: OpenApiSchema;
+    }>;
+}
+export interface OpenApiSchema {
+    $ref?: string;
+    type?: string;
+    format?: string;
+    enum?: unknown[];
+    nullable?: boolean;
+    required?: string[];
+    properties?: Record<string, OpenApiSchema>;
+    items?: OpenApiSchema;
+    additionalProperties?: boolean | OpenApiSchema;
+    allOf?: OpenApiSchema[];
+    oneOf?: OpenApiSchema[];
+    anyOf?: OpenApiSchema[];
+}

package/dist/core/types.js

@@ -0,0 +1 @@
+export {};

package/dist/generators/angular-client.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Emits the generated Angular swagger client implementation.
+ *
+ * @returns The TypeScript source for the Angular client file.
+ */
+export interface EmitAngularClientOptions {
+    endpointsImportPath?: string;
+}
+export declare function emitAngularClient(options?: EmitAngularClientOptions): string;

package/dist/generators/angular-client.js

@@ -0,0 +1,210 @@
+export function emitAngularClient(options = {}) {
+    const endpointsImportPath = options.endpointsImportPath ?? "./api-endpoints";
+    return String.raw `
+/* eslint-disable */
+// This file was generated by @let-aurn/swagger-client.
+import { HttpClient, HttpHeaders, HttpParams } from '@angular/common/http';
+import { Inject, Injectable, InjectionToken, Provider, Type } from '@angular/core';
+import { Observable } from 'rxjs';
+import type {
+  AnyApiEndpoint,
+  BodyVariablesOf,
+  HeaderVariablesOf,
+  PathVariablesOf,
+  QueryVariablesOf,
+  ResponseOf
+} from '${endpointsImportPath}';
+
+/**
+ * Configures the generated Angular swagger client.
+ */
+export interface SwaggerClientConfig {
+  baseUrl: string;
+  httpClient?: Type<SwaggerHttpClient>;
+}
+
+/**
+ * Describes an HTTP request produced by the generated swagger client.
+ */
+export interface SwaggerHttpRequest {
+  method: string;
+  url: string;
+  headers?: Record<string, string>;
+  query?: Record<string, unknown>;
+  body?: unknown;
+}
+
+/**
+ * Defines the HTTP adapter contract used by the generated Angular swagger client.
+ */
+export interface SwaggerHttpClient {
+  /**
+   * Executes an HTTP request and returns the typed response stream.
+   *
+   * @param request The normalized swagger HTTP request.
+   * @returns An observable of the typed response body.
+   */
+  request<T>(request: SwaggerHttpRequest): Observable<T>;
+}
+
+/**
+ * Resolves the request variable object accepted by a generated endpoint.
+ */
+export type SwaggerRequestVariables<TEndpoint extends AnyApiEndpoint> =
+  OptionalProperty<'pathVariables', PathVariablesOf<TEndpoint>> &
+  OptionalProperty<'queryVariables', QueryVariablesOf<TEndpoint>> &
+  OptionalProperty<'headerVariables', HeaderVariablesOf<TEndpoint>> &
+  OptionalProperty<'bodyVariables', BodyVariablesOf<TEndpoint>>;
+
+type OptionalProperty<TKey extends string, TValue> = IsEmptyVariables<TValue> extends true
+  ? { [K in TKey]?: never }
+  : undefined extends TValue
+    ? { [K in TKey]?: TValue }
+    : { [K in TKey]: TValue };
+
+type IsEmptyVariables<TValue> = keyof TValue extends never
+  ? true
+  : TValue extends Record<string, never>
+    ? true
+    : false;
+
+export const SWAGGER_CLIENT_CONFIG = new InjectionToken<SwaggerClientConfig>('SWAGGER_CLIENT_CONFIG');
+export const SWAGGER_HTTP_CLIENT = new InjectionToken<SwaggerHttpClient>('SWAGGER_HTTP_CLIENT');
+
+/**
+ * Adapts Angular HttpClient to the generated swagger HTTP adapter contract.
+ */
+@Injectable()
+export class AngularSwaggerHttpClient implements SwaggerHttpClient {
+  /**
+   * Creates the default Angular HTTP adapter.
+   *
+   * @param http The Angular HttpClient used to execute requests.
+   */
+  constructor(private readonly http: HttpClient) {}
+
+  /**
+   * Executes a normalized swagger request with Angular HttpClient.
+   *
+   * @param request The normalized swagger HTTP request.
+   * @returns An observable of the typed response body.
+   */
+  request<T>(request: SwaggerHttpRequest): Observable<T> {
+    return this.http.request<T>(request.method, request.url, {
+      body: request.body,
+      headers: new HttpHeaders(request.headers ?? {}),
+      params: toHttpParams(request.query)
+    });
+  }
+}
+
+/**
+ * Sends typed requests to generated API endpoint definitions.
+ */
+@Injectable()
+export class SwaggerClientService {
+  /**
+   * Creates the generated swagger client service.
+   *
+   * @param config The swagger client runtime configuration.
+   * @param http The HTTP adapter used to execute requests.
+   */
+  constructor(
+    @Inject(SWAGGER_CLIENT_CONFIG) private readonly config: SwaggerClientConfig,
+    @Inject(SWAGGER_HTTP_CLIENT) private readonly http: SwaggerHttpClient
+  ) {}
+
+  /**
+   * Sends a typed request for a generated API endpoint.
+   *
+   * @param endpoint The generated endpoint definition to call.
+   * @param variables The path, query, header, and body variables for the endpoint.
+   * @returns An observable of the endpoint response type.
+   */
+  request<TEndpoint extends AnyApiEndpoint>(
+    endpoint: TEndpoint,
+    variables?: SwaggerRequestVariables<TEndpoint>
+  ): Observable<ResponseOf<TEndpoint>> {
+    return this.http.request<ResponseOf<TEndpoint>>(buildRequest(this.config.baseUrl, endpoint, variables));
+  }
+}
+
+/**
+ * Provides the generated Angular swagger client and its HTTP adapter.
+ *
+ * @param config The swagger client runtime configuration.
+ * @returns Angular providers for the generated client.
+ */
+export function provideSwaggerClient(config: SwaggerClientConfig): Provider[] {
+  return [
+    { provide: SWAGGER_CLIENT_CONFIG, useValue: config },
+    { provide: SWAGGER_HTTP_CLIENT, useClass: config.httpClient ?? AngularSwaggerHttpClient },
+    SwaggerClientService
+  ];
+}
+
+function buildRequest<TEndpoint extends AnyApiEndpoint>(
+  baseUrl: string,
+  endpoint: TEndpoint,
+  variables?: SwaggerRequestVariables<TEndpoint>
+): SwaggerHttpRequest {
+  const pathVariables = variables?.pathVariables as Record<string, unknown> | undefined;
+  const queryVariables = variables?.queryVariables as Record<string, unknown> | undefined;
+  const headerVariables = variables?.headerVariables as Record<string, unknown> | undefined;
+  const bodyVariables = variables?.bodyVariables;
+  const path = endpoint.path.replace(/\{([^}]+)\}/g, (_, key: string) => {
+    const value = pathVariables?.[key];
+
+    if (value === undefined || value === null) {
+      throw new Error('Missing path variable "' + key + '" for endpoint "' + endpoint.name + '".');
+    }
+
+    return encodeURIComponent(String(value));
+  });
+
+  return {
+    method: endpoint.method,
+    url: joinUrl(baseUrl, path),
+    headers: stringifyRecord(headerVariables),
+    query: queryVariables,
+    body: bodyVariables
+  };
+}
+
+function toHttpParams(query: Record<string, unknown> | undefined): HttpParams {
+  let params = new HttpParams();
+
+  for (const [key, value] of Object.entries(query ?? {})) {
+    if (value === undefined || value === null) {
+      continue;
+    }
+
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        params = params.append(key, String(item));
+      }
+    } else {
+      params = params.set(key, String(value));
+    }
+  }
+
+  return params;
+}
+
+function stringifyRecord(record: Record<string, unknown> | undefined): Record<string, string> | undefined {
+  if (!record) {
+    return undefined;
+  }
+
+  return Object.fromEntries(
+    Object.entries(record)
+      .filter(([, value]) => value !== undefined && value !== null)
+      .map(([key, value]) => [key, String(value)])
+  );
+}
+
+function joinUrl(baseUrl: string, path: string): string {
+  return baseUrl.replace(/\/+$/, '') + '/' + path.replace(/^\/+/, '');
+}
+`;
+}

package/dist/generators/endpoints.d.ts

@@ -0,0 +1,11 @@
+import type { ProjectModel } from "../core/types.js";
+/**
+ * Emits the generated typed API endpoint definition file.
+ *
+ * @param project The normalized OpenAPI project model.
+ * @returns The TypeScript source for api-endpoints.ts.
+ */
+export interface EmitEndpointsOptions {
+    modelsImportPath?: string;
+}
+export declare function emitEndpoints(project: ProjectModel, options?: EmitEndpointsOptions): string;

package/dist/generators/endpoints.js

@@ -0,0 +1,142 @@
+import { quote } from "../core/names.js";
+export function emitEndpoints(project, options = {}) {
+    const modelsImportPath = options.modelsImportPath ?? "./api-models";
+    const modelNames = new Set(project.schemas.map((schema) => schema.name));
+    const lines = [
+        "/* eslint-disable */",
+        "// This file was generated by @let-aurn/swagger-client.",
+        `import type * as ApiModels from '${modelsImportPath}';`,
+        "",
+        "/**",
+        " * Represents the HTTP methods supported by generated endpoints.",
+        " */",
+        "export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';",
+        "",
+        "/**",
+        " * Describes a generated API endpoint and carries its request and response types.",
+        " */",
+        "export interface ApiEndpointDefinition<TPathVariables, TQueryVariables, THeaderVariables, TBody, TResponse> {",
+        "  readonly name: string;",
+        "  readonly method: HttpMethod;",
+        "  readonly path: string;",
+        "  readonly operationId: string;",
+        "  readonly sourceFile: string;",
+        "  readonly pathVariables: readonly ApiVariableDefinition[];",
+        "  readonly queryVariables: readonly ApiVariableDefinition[];",
+        "  readonly headerVariables: readonly ApiVariableDefinition[];",
+        "  readonly __types?: {",
+        "    readonly pathVariables: TPathVariables;",
+        "    readonly queryVariables: TQueryVariables;",
+        "    readonly headerVariables: THeaderVariables;",
+        "    readonly bodyVariables: TBody;",
+        "    readonly response: TResponse;",
+        "  };",
+        "}",
+        "",
+        "/**",
+        " * Describes a request variable using its exact OpenAPI parameter name.",
+        " */",
+        "export interface ApiVariableDefinition {",
+        "  readonly name: string;",
+        "  readonly required: boolean;",
+        "}",
+        "",
+        "/**",
+        " * Creates a typed endpoint definition while preserving phantom request and response types.",
+        " *",
+        " * @param endpoint The serializable endpoint metadata.",
+        " * @returns The endpoint metadata with request and response type information.",
+        " */",
+        "function defineEndpoint<TPathVariables, TQueryVariables, THeaderVariables, TBody, TResponse>(",
+        "  endpoint: Omit<ApiEndpointDefinition<TPathVariables, TQueryVariables, THeaderVariables, TBody, TResponse>, '__types'>",
+        "): ApiEndpointDefinition<TPathVariables, TQueryVariables, THeaderVariables, TBody, TResponse> {",
+        "  return endpoint as ApiEndpointDefinition<TPathVariables, TQueryVariables, THeaderVariables, TBody, TResponse>;",
+        "}",
+        "",
+        "/**",
+        " * Represents any generated API endpoint.",
+        " */",
+        "export type AnyApiEndpoint = ApiEndpointDefinition<any, any, any, any, any>;",
+        "/**",
+        " * Extracts the path variable type from a generated endpoint.",
+        " */",
+        "export type PathVariablesOf<TEndpoint extends AnyApiEndpoint> = NonNullable<TEndpoint['__types']>['pathVariables'];",
+        "/**",
+        " * Extracts the query variable type from a generated endpoint.",
+        " */",
+        "export type QueryVariablesOf<TEndpoint extends AnyApiEndpoint> = NonNullable<TEndpoint['__types']>['queryVariables'];",
+        "/**",
+        " * Extracts the header variable type from a generated endpoint.",
+        " */",
+        "export type HeaderVariablesOf<TEndpoint extends AnyApiEndpoint> = NonNullable<TEndpoint['__types']>['headerVariables'];",
+        "/**",
+        " * Extracts the body variable type from a generated endpoint.",
+        " */",
+        "export type BodyVariablesOf<TEndpoint extends AnyApiEndpoint> = NonNullable<TEndpoint['__types']>['bodyVariables'];",
+        "/**",
+        " * Extracts the response type from a generated endpoint.",
+        " */",
+        "export type ResponseOf<TEndpoint extends AnyApiEndpoint> = NonNullable<TEndpoint['__types']>['response'];",
+        "",
+        "type EmptyObject = Record<string, never>;",
+        "",
+        "/**",
+        " * Contains all generated API endpoint definitions.",
+        " */",
+        "export namespace ApiEndpoints {"
+    ];
+    for (const endpoint of project.endpoints) {
+        lines.push(emitEndpoint(endpoint, modelNames));
+    }
+    lines.push("}", "");
+    return lines.join("\n");
+}
+function emitEndpoint(endpoint, modelNames) {
+    const pathType = variablesObjectType(endpoint.pathVariables, modelNames);
+    const queryType = variablesObjectType(endpoint.queryVariables, modelNames);
+    const headerType = variablesObjectType(endpoint.headerVariables, modelNames);
+    const bodyType = endpoint.bodyType ? qualifyModelTypes(endpoint.bodyType, modelNames) : "void";
+    const responseType = qualifyModelTypes(endpoint.responseType, modelNames);
+    return [
+        "  /**",
+        `   * Defines the ${endpoint.operationId} API endpoint.`,
+        "   */",
+        `  export const ${endpoint.name} = defineEndpoint<${pathType}, ${queryType}, ${headerType}, ${bodyType}, ${responseType}>({`,
+        `    name: ${quote(endpoint.name)},`,
+        `    method: ${quote(endpoint.method)},`,
+        `    path: ${quote(endpoint.path)},`,
+        `    operationId: ${quote(endpoint.operationId)},`,
+        `    sourceFile: ${quote(endpoint.sourceFile)},`,
+        `    pathVariables: ${variablesMetadata(endpoint.pathVariables)},`,
+        `    queryVariables: ${variablesMetadata(endpoint.queryVariables)},`,
+        `    headerVariables: ${variablesMetadata(endpoint.headerVariables)}`,
+        "  });"
+    ].join("\n");
+}
+function variablesMetadata(variables) {
+    if (variables.length === 0) {
+        return "[]";
+    }
+    const entries = variables.map((variable) => {
+        return `{ name: ${quote(variable.name)}, required: ${String(variable.required)} }`;
+    });
+    return `[${entries.join(", ")}]`;
+}
+function variablesObjectType(variables, modelNames = new Set()) {
+    if (variables.length === 0) {
+        return "EmptyObject";
+    }
+    const props = variables.map((variable) => {
+        const optional = variable.required ? "" : "?";
+        return `${propertyKey(variable.name)}${optional}: ${qualifyModelTypes(variable.type, modelNames)}`;
+    });
+    return `{ ${props.join("; ")} }`;
+}
+function propertyKey(name) {
+    return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(name) ? name : quote(name);
+}
+function qualifyModelTypes(type, modelNames) {
+    return type.replace(/\b[A-Z][A-Za-z0-9_]*\b/g, (name) => {
+        return modelNames.has(name) ? `ApiModels.${name}` : name;
+    });
+}

package/dist/generators/models.d.ts

@@ -0,0 +1,8 @@
+import type { ProjectModel } from "../core/types.js";
+/**
+ * Emits the generated TypeScript API model file.
+ *
+ * @param project The normalized OpenAPI project model.
+ * @returns The TypeScript source for api-models.ts.
+ */
+export declare function emitModels(project: ProjectModel): string;

package/dist/generators/models.js

@@ -0,0 +1,18 @@
+import { emitSchemaInterface } from "../core/schema-to-typescript.js";
+/**
+ * Emits the generated TypeScript API model file.
+ *
+ * @param project The normalized OpenAPI project model.
+ * @returns The TypeScript source for api-models.ts.
+ */
+export function emitModels(project) {
+    const lines = [
+        "/* eslint-disable */",
+        "// This file was generated by @let-aurn/swagger-client.",
+        ""
+    ];
+    for (const schema of project.schemas) {
+        lines.push(emitSchemaInterface(schema.name, schema.schema), "");
+    }
+    return lines.join("\n");
+}

package/dist/generators/react-client.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Emits the generated React swagger client implementation.
+ *
+ * @returns The TypeScript source for the React client file.
+ */
+export interface EmitReactClientOptions {
+    endpointsImportPath?: string;
+}
+export declare function emitReactClient(options?: EmitReactClientOptions): string;

package/dist/generators/react-client.js

@@ -0,0 +1,187 @@
+export function emitReactClient(options = {}) {
+    const endpointsImportPath = options.endpointsImportPath ?? "./api-endpoints";
+    return String.raw `
+/* eslint-disable */
+// This file was generated by @let-aurn/swagger-client.
+import { useMemo } from 'react';
+import type {
+  AnyApiEndpoint,
+  BodyVariablesOf,
+  HeaderVariablesOf,
+  PathVariablesOf,
+  QueryVariablesOf,
+  ResponseOf
+} from '${endpointsImportPath}';
+
+/**
+ * Configures the generated React swagger client.
+ */
+export interface SwaggerClientConfig {
+  baseUrl: string;
+  fetch?: typeof globalThis.fetch;
+  headers?: Record<string, string>;
+}
+
+/**
+ * Resolves the request variable object accepted by a generated endpoint.
+ */
+export type SwaggerRequestVariables<TEndpoint extends AnyApiEndpoint> =
+  OptionalProperty<'pathVariables', PathVariablesOf<TEndpoint>> &
+  OptionalProperty<'queryVariables', QueryVariablesOf<TEndpoint>> &
+  OptionalProperty<'headerVariables', HeaderVariablesOf<TEndpoint>> &
+  OptionalProperty<'bodyVariables', BodyVariablesOf<TEndpoint>>;
+
+type OptionalProperty<TKey extends string, TValue> = IsEmptyVariables<TValue> extends true
+  ? { [K in TKey]?: never }
+  : undefined extends TValue
+    ? { [K in TKey]?: TValue }
+    : { [K in TKey]: TValue };
+
+type IsEmptyVariables<TValue> = keyof TValue extends never
+  ? true
+  : TValue extends Record<string, never>
+    ? true
+    : false;
+
+/**
+ * Sends typed requests to one generated API endpoint.
+ */
+export interface SwaggerEndpointClient<TEndpoint extends AnyApiEndpoint> {
+  /**
+   * Sends a typed request for the configured endpoint.
+   *
+   * @param variables The path, query, header, and body variables for the endpoint.
+   * @returns A promise of the endpoint response type.
+   * @throws SwaggerHttpError when the HTTP response status is not successful.
+   */
+  request(variables?: SwaggerRequestVariables<TEndpoint>): Promise<ResponseOf<TEndpoint>>;
+}
+
+/**
+ * Creates a memoized typed client for a generated API endpoint.
+ *
+ * @param endpoint The generated endpoint definition to call.
+ * @param config The swagger client runtime configuration.
+ * @returns A typed endpoint client.
+ */
+export function useSwaggerClient<TEndpoint extends AnyApiEndpoint>(
+  endpoint: TEndpoint,
+  config: SwaggerClientConfig
+): SwaggerEndpointClient<TEndpoint> {
+  return useMemo(() => createSwaggerClient(endpoint, config), [endpoint, config]);
+}
+
+/**
+ * Creates a typed client for a generated API endpoint.
+ *
+ * @param endpoint The generated endpoint definition to call.
+ * @param config The swagger client runtime configuration.
+ * @returns A typed endpoint client.
+ */
+export function createSwaggerClient<TEndpoint extends AnyApiEndpoint>(
+  endpoint: TEndpoint,
+  config: SwaggerClientConfig
+): SwaggerEndpointClient<TEndpoint> {
+  return {
+    async request(variables?: SwaggerRequestVariables<TEndpoint>): Promise<ResponseOf<TEndpoint>> {
+      const fetchImpl = config.fetch ?? globalThis.fetch;
+      const request = buildRequest(config, endpoint, variables);
+      const response = await fetchImpl(request.url, request.init);
+
+      if (!response.ok) {
+        throw new SwaggerHttpError(response);
+      }
+
+      if (response.status === 204) {
+        return undefined as ResponseOf<TEndpoint>;
+      }
+
+      return await response.json() as ResponseOf<TEndpoint>;
+    }
+  };
+}
+
+/**
+ * Represents a failed HTTP response from the generated React swagger client.
+ */
+export class SwaggerHttpError extends Error {
+  /**
+   * Creates an error for a failed HTTP response.
+   *
+   * @param response The failed fetch response.
+   */
+  constructor(readonly response: Response) {
+    super('Swagger request failed with status ' + response.status + '.');
+  }
+}
+
+function buildRequest<TEndpoint extends AnyApiEndpoint>(
+  config: SwaggerClientConfig,
+  endpoint: TEndpoint,
+  variables?: SwaggerRequestVariables<TEndpoint>
+): { url: string; init: RequestInit } {
+  const pathVariables = variables?.pathVariables as Record<string, unknown> | undefined;
+  const queryVariables = variables?.queryVariables as Record<string, unknown> | undefined;
+  const headerVariables = variables?.headerVariables as Record<string, unknown> | undefined;
+  const bodyVariables = variables?.bodyVariables;
+  const path = endpoint.path.replace(/\{([^}]+)\}/g, (_, key: string) => {
+    const value = pathVariables?.[key];
+
+    if (value === undefined || value === null) {
+      throw new Error('Missing path variable "' + key + '" for endpoint "' + endpoint.name + '".');
+    }
+
+    return encodeURIComponent(String(value));
+  });
+  const url = new URL(joinUrl(config.baseUrl, path));
+
+  for (const [key, value] of Object.entries(queryVariables ?? {})) {
+    if (value === undefined || value === null) {
+      continue;
+    }
+
+    if (Array.isArray(value)) {
+      for (const item of value) {
+        url.searchParams.append(key, String(item));
+      }
+    } else {
+      url.searchParams.set(key, String(value));
+    }
+  }
+
+  const headers = {
+    ...config.headers,
+    ...stringifyRecord(headerVariables)
+  };
+
+  if (bodyVariables !== undefined) {
+    headers['content-type'] ??= 'application/json';
+  }
+
+  return {
+    url: url.toString(),
+    init: {
+      method: endpoint.method,
+      headers,
+      body: bodyVariables === undefined ? undefined : JSON.stringify(bodyVariables)
+    }
+  };
+}
+
+function stringifyRecord(record: Record<string, unknown> | undefined): Record<string, string> | undefined {
+  if (!record) {
+    return undefined;
+  }
+
+  return Object.fromEntries(
+    Object.entries(record)
+      .filter(([, value]) => value !== undefined && value !== null)
+      .map(([key, value]) => [key, String(value)])
+  );
+}
+
+function joinUrl(baseUrl: string, path: string): string {
+  return baseUrl.replace(/\/+$/, '') + '/' + path.replace(/^\/+/, '');
+}
+`;
+}