chore(examples/apis): upgrade dependencies and refactor API client usage

fix(examples/apis): fix type errors caused by TypeScript 6.0 and updated package APIs

- Add types: ["node"] to tsconfig.json for @types/node resolution under moduleResolution: "bundler"
- Update all sample files to use RequestArgs object signature for ApiClient.request()
- Replace new Client<T>() with createClient<T>() factory function
- Fix superagent import to use default import (import superagent from "superagent")
- Remove unsupported timeout option from node-fetch v3 request options
- Update dependencies: axios 1.15.2, superagent 10.3.0, typescript 6.0.3

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: Himenon

examples/apis/package.json

@@ -11,16 +11,16 @@
     "ts": "node --no-warnings=ExperimentalWarning --experimental-specifier-resolution=node --loader ts-node/esm"
   },
   "dependencies": {
-    "@himenon/openapi-parameter-formatter": "0.3.1",
+    "@himenon/openapi-parameter-formatter": "2.1.0",
     "@himenon/openapi-typescript-code-generator": "link:../..",
-    "axios": "1.6.7",
-    "superagent": "8.1.2"
+    "axios": "1.15.2",
+    "superagent": "10.3.0"
   },
   "devDependencies": {
-    "@types/node-fetch": "^2.6.12",
+    "@types/node-fetch": "^2.6.13",
     "@types/superagent": "^8.1.9",
     "node-fetch": "^3.3.2",
     "ts-node": "10.9.2",
-    "typescript": "5.3.3"
+    "typescript": "6.0.3"
   }
 }

examples/apis/pnpm-lock.yaml

@@ -1,6 +1,6 @@
 import * as axios from "axios";
 
-import { ApiClient, Client, HttpMethod, ObjectLike, QueryParameters } from "./client";
+import { ApiClient, RequestArgs, createClient } from "./client";
 import { generateQueryString } from "./utils";
 
 export interface RequestOption {
@@ -9,34 +9,14 @@ export interface RequestOption {
   deadline?: number;
 }
 
-const convertHttpMethodToAxiosMethod = (httpMethod: HttpMethod): axios.Method => {
-  const patterns: { [key in HttpMethod]: axios.Method } = {
-    GET: "GET",
-    PUT: "PUT",
-    POST: "POST",
-    DELETE: "DELETE",
-    OPTIONS: "OPTIONS",
-    HEAD: "HEAD",
-    PATCH: "PATCH",
-    TRACE: "POST", // ?
-  };
-  return patterns[httpMethod];
-};
-
 const apiClientImpl: ApiClient<RequestOption> = {
-  request: async (
-    httpMethod: HttpMethod,
-    url: string,
-    headers: ObjectLike | any,
-    requestBody: ObjectLike | any,
-    queryParameters: QueryParameters | undefined,
-    options?: RequestOption,
-  ): Promise<any> => {
+  request: async (requestArgs: RequestArgs, options?: RequestOption): Promise<any> => {
+    const { httpMethod, url, headers, requestBody, queryParameters } = requestArgs;
     const query = generateQueryString(queryParameters);
     const requestUrl = query ? `${url}?${encodeURI(query)}` : url;
     const response = await axios.default.request({
       url: requestUrl,
-      method: convertHttpMethodToAxiosMethod(httpMethod),
+      method: httpMethod,
       headers,
       data: requestBody,
       timeout: options?.timeout,
@@ -46,7 +26,7 @@ const apiClientImpl: ApiClient<RequestOption> = {
 };
 
 const main = async () => {
-  const client = new Client<RequestOption>(apiClientImpl, "https://example.com");
+  const client = createClient<RequestOption>(apiClientImpl, "https://example.com");
   await client.getBooks({
     retries: 50,
   });

examples/apis/sample-axios.ts

@@ -1,19 +1,13 @@
-import { ApiClient, Client, HttpMethod, ObjectLike, QueryParameters } from "./client";
+import { ApiClient, RequestArgs, createClient } from "./client";
 import { generateQueryString } from "./utils";
 
 export interface RequestOption {
   timeout?: number;
 }
 
 const apiClientImpl: ApiClient<RequestOption> = {
-  request: async (
-    httpMethod: HttpMethod,
-    url: string,
-    headers: ObjectLike | any,
-    requestBody: ObjectLike | any,
-    queryParameters: QueryParameters | undefined,
-    options?: RequestOption,
-  ): Promise<any> => {
+  request: async (requestArgs: RequestArgs, options?: RequestOption): Promise<any> => {
+    const { httpMethod, url, headers, requestBody, queryParameters } = requestArgs;
     const query = generateQueryString(queryParameters);
     const requestUrl = query ? `${url}?${encodeURI(query)}` : url;
     console.log({
@@ -30,7 +24,7 @@ const apiClientImpl: ApiClient<RequestOption> = {
 };
 
 const main = async () => {
-  const client = new Client<RequestOption>(apiClientImpl, "https://example.com");
+  const client = createClient<RequestOption>(apiClientImpl, "https://example.com");
   await client.getBooks({
     timeout: 1000,
   });

examples/apis/sample-debug.ts

@@ -1,35 +1,28 @@
 import fetch from "node-fetch";
 
-import { ApiClient, Client, HttpMethod, ObjectLike, QueryParameters } from "./client";
+import { ApiClient, RequestArgs, createClient } from "./client";
 import { generateQueryString } from "./utils";
 
 export interface RequestOption {
   timeout?: number;
 }
 
 const apiClientImpl: ApiClient<RequestOption> = {
-  request: async (
-    httpMethod: HttpMethod,
-    url: string,
-    headers: ObjectLike | any,
-    requestBody: ObjectLike | any,
-    queryParameters: QueryParameters | undefined,
-    options?: RequestOption,
-  ): Promise<any> => {
+  request: async (requestArgs: RequestArgs, _options?: RequestOption): Promise<any> => {
+    const { httpMethod, url, headers, requestBody, queryParameters } = requestArgs;
     const query = generateQueryString(queryParameters);
     const requestUrl = query ? `${url}?${encodeURI(query)}` : url;
     const response = await fetch(requestUrl, {
-      body: JSON.stringify(requestBody),
-      headers,
+      body: requestBody !== undefined ? JSON.stringify(requestBody) : undefined,
+      headers: headers as Record<string, string>,
       method: httpMethod,
-      timeout: options?.timeout,
     });
     return await response.json();
   },
 };
 
 const main = async () => {
-  const client = new Client<RequestOption>(apiClientImpl, "https://example.com");
+  const client = createClient<RequestOption>(apiClientImpl, "https://example.com");
   await client.getBooks({
     timeout: 1000,
   });

examples/apis/sample-fetch.ts

@@ -1,6 +1,6 @@
-import * as Superagent from "superagent";
+import superagent from "superagent";
 
-import { ApiClient, Client, HttpMethod, ObjectLike, QueryParameters } from "./client";
+import { ApiClient, RequestArgs, createClient } from "./client";
 import { generateQueryString } from "./utils";
 
 export interface RequestOption {
@@ -10,20 +10,13 @@ export interface RequestOption {
 }
 
 const apiClientImpl: ApiClient<RequestOption> = {
-  request: (
-    httpMethod: HttpMethod,
-    url: string,
-    headers: ObjectLike | any,
-    requestBody: ObjectLike | any,
-    queryParameters: QueryParameters | undefined,
-    options?: RequestOption,
-  ): Promise<any> => {
+  request: (requestArgs: RequestArgs, options?: RequestOption): Promise<any> => {
+    const { httpMethod, url, headers, requestBody, queryParameters } = requestArgs;
     const query = generateQueryString(queryParameters);
     const requestUrl = query ? `${url}?${encodeURI(query)}` : url;
 
     return new Promise((resolve, reject) => {
-      const agent = Superagent;
-      const request = agent(httpMethod, requestUrl);
+      const request = superagent(httpMethod, requestUrl);
       if (headers) {
         request.set(headers);
       }
@@ -48,7 +41,7 @@ const apiClientImpl: ApiClient<RequestOption> = {
 };
 
 const main = async () => {
-  const client = new Client<RequestOption>(apiClientImpl, "https://example.com");
+  const client = createClient<RequestOption>(apiClientImpl, "https://example.com");
   await client.getBooks({
     retries: 50,
   });

examples/apis/sample-superagent.ts

@@ -2,7 +2,8 @@
   "compilerOptions": {
     "module": "esnext",
     "declaration": false,
-    "moduleResolution": "node"
+    "moduleResolution": "bundler",
+    "types": ["node"]
   },
   "include": ["."],
   "exclude": ["node_modules"],