@mittwald/api-client-commons 3.1.0 → 4.0.2

package/dist/cjs/core/ApiClientBase.js

@@ -1,15 +1,41 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ApiClientBase = void 0;
-const axios_1 = require("axios");
-const Request_js_1 = require("./Request.js");
+const axios_1 = __importStar(require("axios"));
+const Request_js_1 = __importDefault(require("./Request.js"));
 class ApiClientBase {
     constructor(axiosConfig = axios_1.default) {
         this.axios =
             axiosConfig instanceof axios_1.Axios ? axiosConfig : axios_1.default.create(axiosConfig);
     }
     requestFunctionFactory(operation) {
-        return (conf) => new Request_js_1.default(this.axios, operation, conf).execute();
+        return (conf) => new Request_js_1.default(operation, conf).execute(this.axios);
     }
 }
 exports.ApiClientBase = ApiClientBase;

package/dist/cjs/core/Request.d.ts

@@ -1,11 +1,11 @@
-import { OpenAPIOperation, RequestConfig, ResponsePromise } from "../types/index.js";
-import { AxiosInstance } from "axios";
+import { OpenAPIOperation, RequestObject, ResponsePromise } from "../types/index.js";
+import { AxiosInstance, AxiosRequestConfig } from "axios";
 export declare class Request<TOp extends OpenAPIOperation> {
-    private readonly axios;
     private readonly operationDescriptor;
-    private readonly config?;
-    constructor(axiosInstance: AxiosInstance, operationDescriptor: TOp, config?: RequestConfig<TOp>);
-    execute(): ResponsePromise<TOp>;
+    private readonly requestObject?;
+    readonly requestConfig: AxiosRequestConfig;
+    constructor(operationDescriptor: TOp, requestObject?: RequestObject<TOp>);
+    execute(axios: AxiosInstance): ResponsePromise<TOp>;
     private buildAxiosConfig;
     private makeAxiosHeaders;
     private convertQueryToUrlSearchParams;

package/dist/cjs/core/Request.js

@@ -1,32 +1,35 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Request = void 0;
-const OpenAPIPath_js_1 = require("./OpenAPIPath.js");
+const OpenAPIPath_js_1 = __importDefault(require("./OpenAPIPath.js"));
 class Request {
-    constructor(axiosInstance, operationDescriptor, config) {
-        this.axios = axiosInstance;
+    constructor(operationDescriptor, requestObject) {
         this.operationDescriptor = operationDescriptor;
-        this.config = config;
+        this.requestObject = requestObject;
+        this.requestConfig = Object.freeze(this.buildAxiosConfig());
     }
-    execute() {
-        return this.axios.request(this.buildAxiosConfig());
+    execute(axios) {
+        return axios.request(this.requestConfig);
     }
     buildAxiosConfig() {
         const { method, path } = this.operationDescriptor;
-        const pathParameters = this.config &&
-            "pathParameters" in this.config &&
-            this.config.pathParameters !== null
-            ? this.config.pathParameters
-            : undefined;
+        const pathParameters = this.requestObject;
         const openApiPath = new OpenAPIPath_js_1.default(path, pathParameters);
         const url = openApiPath.buildUrl();
-        const data = this.config && "data" in this.config ? this.config.data : undefined;
-        const headersConfig = this.config && "headers" in this.config ? this.config.headers : undefined;
+        const data = this.requestObject && "data" in this.requestObject
+            ? this.requestObject.data
+            : undefined;
+        const headersConfig = this.requestObject && "headers" in this.requestObject
+            ? this.requestObject.headers
+            : undefined;
         const headers = headersConfig
             ? this.makeAxiosHeaders(headersConfig)
             : undefined;
-        const queryParametersConfig = this.config && "queryParameters" in this.config
-            ? this.config.queryParameters
+        const queryParametersConfig = this.requestObject && "queryParameters" in this.requestObject
+            ? this.requestObject.queryParameters
             : undefined;
         const params = this.convertQueryToUrlSearchParams(queryParametersConfig);
         return {

package/dist/cjs/core/Request.test.js

@@ -1,6 +1,9 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-const Request_js_1 = require("./Request.js");
+const Request_js_1 = __importDefault(require("./Request.js"));
 const globals_1 = require("@jest/globals");
 const requestFn = globals_1.jest.fn();
 const mockedAxios = {
@@ -16,8 +19,8 @@ describe("query parameters", () => {
         method: "GET",
     };
     const executeRequest = (query) => {
-        const request = new Request_js_1.default(mockedAxios, op, { queryParameters: query });
-        request.execute();
+        const request = new Request_js_1.default(op, { queryParameters: query });
+        request.execute(mockedAxios);
         const requestConfig = requestFn.mock.calls[0][0];
         return requestConfig.params.toString();
     };

package/dist/cjs/react/ApiCallAsyncResourceFactory.d.ts

@@ -0,0 +1,12 @@
+import { OpenAPIOperation, RequestFunction } from "../types/index.js";
+import { GetApiResourceFn } from "./types.js";
+export declare class ApiCallAsyncResourceFactory<TOp extends OpenAPIOperation> {
+    private static namespace;
+    private readonly operation;
+    private readonly requestFn;
+    constructor(operation: TOp, requestFn: RequestFunction<TOp>);
+    private getAsyncResourceId;
+    private getAsyncResourceTags;
+    private executeRequest;
+    getApiResource: GetApiResourceFn<TOp>;
+}

package/dist/cjs/react/ApiCallAsyncResourceFactory.js

@@ -0,0 +1,52 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiCallAsyncResourceFactory = void 0;
+const react_use_promise_1 = require("@mittwald/react-use-promise");
+const index_js_1 = require("../types/index.js");
+const Request_js_1 = __importDefault(require("../core/Request.js"));
+class ApiCallAsyncResourceFactory {
+    constructor(operation, requestFn) {
+        this.getApiResource = ((requestObj) => {
+            const request = new Request_js_1.default(this.operation, requestObj);
+            return (0, react_use_promise_1.getAsyncResource)((requestObj) => this.executeRequest(requestObj), [requestObj], {
+                tags: this.getAsyncResourceTags(request),
+                loaderId: this.getAsyncResourceId(),
+            });
+        });
+        this.operation = operation;
+        this.requestFn = requestFn;
+    }
+    getAsyncResourceId() {
+        return `${ApiCallAsyncResourceFactory.namespace}/${this.operation.operationId}`;
+    }
+    getAsyncResourceTags(request) {
+        var _a;
+        const url = (_a = request.requestConfig.url) !== null && _a !== void 0 ? _a : "";
+        return [
+            this.getAsyncResourceId(),
+            `${ApiCallAsyncResourceFactory.namespace}/${this.operation.method}`,
+            `${ApiCallAsyncResourceFactory.namespace}/${url}`,
+        ];
+    }
+    executeRequest(requestObj) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.requestFn(requestObj);
+            (0, index_js_1.assertStatus)(response, 200);
+            return response.data;
+        });
+    }
+}
+exports.ApiCallAsyncResourceFactory = ApiCallAsyncResourceFactory;
+ApiCallAsyncResourceFactory.namespace = "@mittwald/api-client";

package/dist/cjs/react/ApiCallAsyncResourceFactory.test-types.d.ts

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

package/dist/cjs/react/ApiCallAsyncResourceFactory.test-types.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const ApiCallAsyncResourceFactory_js_1 = require("./ApiCallAsyncResourceFactory.js");
+const getStuff = new ApiCallAsyncResourceFactory_js_1.ApiCallAsyncResourceFactory({
+    operationId: "getStuff",
+    path: "/stuff",
+    method: "GET",
+}, {});
+function ignoredCheckRequestType() {
+    getStuff.getApiResource({
+        data: {
+            // @ts-expect-error Not matching request type
+            foo: "",
+        },
+    });
+    getStuff.getApiResource({
+        data: {
+            requestString: "",
+        },
+    });
+}
+function ignoredCheckResponseType() {
+    const stuff = getStuff
+        .getApiResource({
+        data: {
+            requestString: "",
+        },
+    })
+        .watch();
+    // @ts-expect-error Accessing unknown prop
+    stuff.foo;
+    (function (ignored) {
+        // @ts-expect-error is a number
+    })(stuff.responseData);
+    (function (ignored) {
+        // is number
+    })(stuff.responseData);
+}

package/dist/cjs/react/ApiCallAsyncResourceFactory.test.d.ts

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

package/dist/cjs/react/ApiCallAsyncResourceFactory.test.js

@@ -0,0 +1,57 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const globals_1 = require("@jest/globals");
+const ApiCallAsyncResourceFactory_js_1 = require("./ApiCallAsyncResourceFactory.js");
+const react_use_promise_1 = require("@mittwald/react-use-promise");
+(0, globals_1.beforeEach)(() => {
+    (0, react_use_promise_1.refresh)();
+    globals_1.jest.resetAllMocks();
+});
+const requestMock = globals_1.jest.fn();
+const getStuff = new ApiCallAsyncResourceFactory_js_1.ApiCallAsyncResourceFactory({
+    operationId: "getStuff",
+    path: "/stuff",
+    method: "GET",
+}, requestMock);
+const testRequest1 = {
+    data: {
+        foo: "bar",
+    },
+};
+const testRequest2 = {
+    data: {
+        foo: "baz",
+    },
+};
+test("Resource loader executes request", () => __awaiter(void 0, void 0, void 0, function* () {
+    yield getStuff.getApiResource(testRequest1).load();
+    (0, globals_1.expect)(requestMock).toHaveBeenCalledTimes(1);
+    const firstRequestParams = requestMock.mock.calls[0][0];
+    (0, globals_1.expect)(firstRequestParams).toMatchObject(testRequest1);
+}));
+test("Resource is cached under URL", () => __awaiter(void 0, void 0, void 0, function* () {
+    yield getStuff.getApiResource(testRequest1).load();
+    (0, globals_1.expect)(requestMock).toHaveBeenCalledTimes(1);
+    yield getStuff.getApiResource(testRequest1).load();
+    (0, globals_1.expect)(requestMock).toHaveBeenCalledTimes(1);
+    (0, react_use_promise_1.refresh)({
+        tag: "@mittwald/api-client/stuff",
+    });
+    yield getStuff.getApiResource(testRequest1).load();
+    (0, globals_1.expect)(requestMock).toHaveBeenCalledTimes(2);
+}));
+test("Resources are different when request object changes", () => __awaiter(void 0, void 0, void 0, function* () {
+    yield getStuff.getApiResource(testRequest1).load();
+    (0, globals_1.expect)(requestMock).toHaveBeenCalledTimes(1);
+    yield getStuff.getApiResource(testRequest2).load();
+    (0, globals_1.expect)(requestMock).toHaveBeenCalledTimes(2);
+}));

package/dist/cjs/react/index.d.ts

@@ -0,0 +1 @@
+export * from "./ApiCallAsyncResourceFactory.js";

package/dist/cjs/react/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ApiCallAsyncResourceFactory.js"), exports);

package/dist/cjs/react/types.d.ts

@@ -0,0 +1,3 @@
+import { OpenAPIOperation, RequestObject, ResponseData } from "../types/index.js";
+import { AsyncResource } from "@mittwald/react-use-promise";
+export type GetApiResourceFn<TOp extends OpenAPIOperation> = null extends RequestObject<TOp> ? (conf?: RequestObject<TOp>) => AsyncResource<ResponseData<TOp>> : (conf: RequestObject<TOp>) => AsyncResource<ResponseData<TOp>>;

package/dist/cjs/react/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/types/OpenAPIOperation.d.ts

@@ -1,6 +1,6 @@
 import { AnyResponse, Response } from "./Response.js";
 import { AnyRequest, RequestType } from "./RequestType.js";
-import { HttpMethod } from "./http.js";
+import { HttpMethod, HttpStatus } from "./http.js";
 export interface OpenAPIOperation<TIgnoredRequest extends AnyRequest = RequestType, IgnoredResponse extends AnyResponse = Response> {
     operationId: string;
     path: string;
@@ -8,3 +8,9 @@ export interface OpenAPIOperation<TIgnoredRequest extends AnyRequest = RequestTy
 }
 export type InferredRequestType<TOp> = TOp extends OpenAPIOperation<infer TReq> ? TReq : never;
 export type InferredResponseType<TOp> = TOp extends OpenAPIOperation<RequestType, infer TRes> ? TRes : never;
+export type ResponseData<TOp, TStatus extends HttpStatus = 200> = Extract<InferredResponseType<TOp>, {
+    status: TStatus;
+}>["data"];
+export type RequestData<TOp> = TOp extends OpenAPIOperation ? InferredRequestType<TOp> extends {
+    data: infer TData;
+} ? TData : never : never;

package/dist/cjs/types/RequestFunction.d.ts

@@ -1,8 +1,11 @@
 import { InferredRequestType, InferredResponseType, OpenAPIOperation } from "./OpenAPIOperation.js";
 import { NullableOnNoRequiredKeysDeep } from "./NullableOnNoRequiredKeysDeep.js";
-export type RequestConfig<TOp extends OpenAPIOperation> = NullableOnNoRequiredKeysDeep<InferredRequestType<TOp>>;
+type UnboxPathParameters<T> = T extends {
+    pathParameters: infer TPath;
+} ? Omit<T, "pathParameters"> & TPath : T;
+export type RequestObject<TOp extends OpenAPIOperation> = NullableOnNoRequiredKeysDeep<UnboxPathParameters<InferredRequestType<TOp>>>;
 export type ResponsePromise<TOp extends OpenAPIOperation> = Promise<InferredResponseType<TOp>>;
-type RequestFunctionWithOptionalRequest<TOp extends OpenAPIOperation> = (request?: RequestConfig<TOp>) => ResponsePromise<TOp>;
-type RequestFunctionWithRequiredRequest<TOp extends OpenAPIOperation> = (request: RequestConfig<TOp>) => ResponsePromise<TOp>;
-export type RequestFunction<TOp extends OpenAPIOperation> = null extends RequestConfig<TOp> ? RequestFunctionWithOptionalRequest<TOp> : RequestFunctionWithRequiredRequest<TOp>;
+type RequestFunctionWithOptionalRequest<TOp extends OpenAPIOperation> = (request?: RequestObject<TOp>) => ResponsePromise<TOp>;
+type RequestFunctionWithRequiredRequest<TOp extends OpenAPIOperation> = (request: RequestObject<TOp>) => ResponsePromise<TOp>;
+export type RequestFunction<TOp extends OpenAPIOperation> = null extends RequestObject<TOp> ? RequestFunctionWithOptionalRequest<TOp> : RequestFunctionWithRequiredRequest<TOp>;
 export {};

package/dist/cjs/types/RequestFunction.test-types.js

@@ -20,3 +20,11 @@ function ignoredTestOptionalHeadersRequestTypes() {
         headers: { extra: true },
     });
 }
+function ignoredTestPathParametersAreInRootOfRequestConfig() {
+    const f = {};
+    void f({
+        foo: "",
+    });
+    // @ts-expect-error Missing parameter
+    void f({});
+}

package/dist/cjs/types/assertStatus.js

@@ -1,7 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.assertStatus = void 0;
-const ApiClientError_js_1 = require("../core/ApiClientError.js");
+const ApiClientError_js_1 = __importDefault(require("../core/ApiClientError.js"));
 function assertStatus(response, expectedStatus) {
     if (response.status !== expectedStatus) {
         throw ApiClientError_js_1.default.fromResponse(`Unexpected response status (expected ${expectedStatus}, got: ${response.status})`, response);

package/dist/cjs/types/assertStatus.test-types.js

@@ -1,7 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 const tsd_1 = require("tsd");
-const assertStatus_js_1 = require("./assertStatus.js");
+const assertStatus_js_1 = __importDefault(require("./assertStatus.js"));
 function ignoredTestAssertStatusAssertsAlsoTheCorrectResponseType() {
     (0, assertStatus_js_1.default)(someResponse, 200);
     (0, tsd_1.expectAssignable)(someResponse);

package/dist/esm/core/ApiClientBase.js

@@ -7,7 +7,7 @@ export class ApiClientBase {
             axiosConfig instanceof Axios ? axiosConfig : axios.create(axiosConfig);
     }
     requestFunctionFactory(operation) {
-        return (conf) => new Request(this.axios, operation, conf).execute();
+        return (conf) => new Request(operation, conf).execute(this.axios);
     }
 }
 export default ApiClientBase;

package/dist/esm/core/Request.d.ts

@@ -1,11 +1,11 @@
-import { OpenAPIOperation, RequestConfig, ResponsePromise } from "../types/index.js";
-import { AxiosInstance } from "axios";
+import { OpenAPIOperation, RequestObject, ResponsePromise } from "../types/index.js";
+import { AxiosInstance, AxiosRequestConfig } from "axios";
 export declare class Request<TOp extends OpenAPIOperation> {
-    private readonly axios;
     private readonly operationDescriptor;
-    private readonly config?;
-    constructor(axiosInstance: AxiosInstance, operationDescriptor: TOp, config?: RequestConfig<TOp>);
-    execute(): ResponsePromise<TOp>;
+    private readonly requestObject?;
+    readonly requestConfig: AxiosRequestConfig;
+    constructor(operationDescriptor: TOp, requestObject?: RequestObject<TOp>);
+    execute(axios: AxiosInstance): ResponsePromise<TOp>;
     private buildAxiosConfig;
     private makeAxiosHeaders;
     private convertQueryToUrlSearchParams;

package/dist/esm/core/Request.js

@@ -1,32 +1,32 @@
 import OpenAPIPath from "./OpenAPIPath.js";
 export class Request {
-    axios;
     operationDescriptor;
-    config;
-    constructor(axiosInstance, operationDescriptor, config) {
-        this.axios = axiosInstance;
+    requestObject;
+    requestConfig;
+    constructor(operationDescriptor, requestObject) {
         this.operationDescriptor = operationDescriptor;
-        this.config = config;
+        this.requestObject = requestObject;
+        this.requestConfig = Object.freeze(this.buildAxiosConfig());
     }
-    execute() {
-        return this.axios.request(this.buildAxiosConfig());
+    execute(axios) {
+        return axios.request(this.requestConfig);
     }
     buildAxiosConfig() {
         const { method, path } = this.operationDescriptor;
-        const pathParameters = this.config &&
-            "pathParameters" in this.config &&
-            this.config.pathParameters !== null
-            ? this.config.pathParameters
-            : undefined;
+        const pathParameters = this.requestObject;
         const openApiPath = new OpenAPIPath(path, pathParameters);
         const url = openApiPath.buildUrl();
-        const data = this.config && "data" in this.config ? this.config.data : undefined;
-        const headersConfig = this.config && "headers" in this.config ? this.config.headers : undefined;
+        const data = this.requestObject && "data" in this.requestObject
+            ? this.requestObject.data
+            : undefined;
+        const headersConfig = this.requestObject && "headers" in this.requestObject
+            ? this.requestObject.headers
+            : undefined;
         const headers = headersConfig
             ? this.makeAxiosHeaders(headersConfig)
             : undefined;
-        const queryParametersConfig = this.config && "queryParameters" in this.config
-            ? this.config.queryParameters
+        const queryParametersConfig = this.requestObject && "queryParameters" in this.requestObject
+            ? this.requestObject.queryParameters
             : undefined;
         const params = this.convertQueryToUrlSearchParams(queryParametersConfig);
         return {

package/dist/esm/core/Request.test.js

@@ -14,8 +14,8 @@ describe("query parameters", () => {
         method: "GET",
     };
     const executeRequest = (query) => {
-        const request = new Request(mockedAxios, op, { queryParameters: query });
-        request.execute();
+        const request = new Request(op, { queryParameters: query });
+        request.execute(mockedAxios);
         const requestConfig = requestFn.mock.calls[0][0];
         return requestConfig.params.toString();
     };

package/dist/esm/react/ApiCallAsyncResourceFactory.d.ts

@@ -0,0 +1,12 @@
+import { OpenAPIOperation, RequestFunction } from "../types/index.js";
+import { GetApiResourceFn } from "./types.js";
+export declare class ApiCallAsyncResourceFactory<TOp extends OpenAPIOperation> {
+    private static namespace;
+    private readonly operation;
+    private readonly requestFn;
+    constructor(operation: TOp, requestFn: RequestFunction<TOp>);
+    private getAsyncResourceId;
+    private getAsyncResourceTags;
+    private executeRequest;
+    getApiResource: GetApiResourceFn<TOp>;
+}

package/dist/esm/react/ApiCallAsyncResourceFactory.js

@@ -0,0 +1,35 @@
+import { getAsyncResource } from "@mittwald/react-use-promise";
+import { assertStatus, } from "../types/index.js";
+import Request from "../core/Request.js";
+export class ApiCallAsyncResourceFactory {
+    static namespace = "@mittwald/api-client";
+    operation;
+    requestFn;
+    constructor(operation, requestFn) {
+        this.operation = operation;
+        this.requestFn = requestFn;
+    }
+    getAsyncResourceId() {
+        return `${ApiCallAsyncResourceFactory.namespace}/${this.operation.operationId}`;
+    }
+    getAsyncResourceTags(request) {
+        const url = request.requestConfig.url ?? "";
+        return [
+            this.getAsyncResourceId(),
+            `${ApiCallAsyncResourceFactory.namespace}/${this.operation.method}`,
+            `${ApiCallAsyncResourceFactory.namespace}/${url}`,
+        ];
+    }
+    async executeRequest(requestObj) {
+        const response = await this.requestFn(requestObj);
+        assertStatus(response, 200);
+        return response.data;
+    }
+    getApiResource = ((requestObj) => {
+        const request = new Request(this.operation, requestObj);
+        return getAsyncResource((requestObj) => this.executeRequest(requestObj), [requestObj], {
+            tags: this.getAsyncResourceTags(request),
+            loaderId: this.getAsyncResourceId(),
+        });
+    });
+}

package/dist/esm/react/ApiCallAsyncResourceFactory.test-types.d.ts

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

package/dist/esm/react/ApiCallAsyncResourceFactory.test-types.js

@@ -0,0 +1,36 @@
+import { ApiCallAsyncResourceFactory } from "./ApiCallAsyncResourceFactory.js";
+const getStuff = new ApiCallAsyncResourceFactory({
+    operationId: "getStuff",
+    path: "/stuff",
+    method: "GET",
+}, {});
+function ignoredCheckRequestType() {
+    getStuff.getApiResource({
+        data: {
+            // @ts-expect-error Not matching request type
+            foo: "",
+        },
+    });
+    getStuff.getApiResource({
+        data: {
+            requestString: "",
+        },
+    });
+}
+function ignoredCheckResponseType() {
+    const stuff = getStuff
+        .getApiResource({
+        data: {
+            requestString: "",
+        },
+    })
+        .watch();
+    // @ts-expect-error Accessing unknown prop
+    stuff.foo;
+    (function (ignored) {
+        // @ts-expect-error is a number
+    })(stuff.responseData);
+    (function (ignored) {
+        // is number
+    })(stuff.responseData);
+}

package/dist/esm/react/ApiCallAsyncResourceFactory.test.d.ts

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

package/dist/esm/react/ApiCallAsyncResourceFactory.test.js

@@ -0,0 +1,46 @@
+import { beforeEach, expect, jest } from "@jest/globals";
+import { ApiCallAsyncResourceFactory } from "./ApiCallAsyncResourceFactory.js";
+import { refresh } from "@mittwald/react-use-promise";
+beforeEach(() => {
+    refresh();
+    jest.resetAllMocks();
+});
+const requestMock = jest.fn();
+const getStuff = new ApiCallAsyncResourceFactory({
+    operationId: "getStuff",
+    path: "/stuff",
+    method: "GET",
+}, requestMock);
+const testRequest1 = {
+    data: {
+        foo: "bar",
+    },
+};
+const testRequest2 = {
+    data: {
+        foo: "baz",
+    },
+};
+test("Resource loader executes request", async () => {
+    await getStuff.getApiResource(testRequest1).load();
+    expect(requestMock).toHaveBeenCalledTimes(1);
+    const firstRequestParams = requestMock.mock.calls[0][0];
+    expect(firstRequestParams).toMatchObject(testRequest1);
+});
+test("Resource is cached under URL", async () => {
+    await getStuff.getApiResource(testRequest1).load();
+    expect(requestMock).toHaveBeenCalledTimes(1);
+    await getStuff.getApiResource(testRequest1).load();
+    expect(requestMock).toHaveBeenCalledTimes(1);
+    refresh({
+        tag: "@mittwald/api-client/stuff",
+    });
+    await getStuff.getApiResource(testRequest1).load();
+    expect(requestMock).toHaveBeenCalledTimes(2);
+});
+test("Resources are different when request object changes", async () => {
+    await getStuff.getApiResource(testRequest1).load();
+    expect(requestMock).toHaveBeenCalledTimes(1);
+    await getStuff.getApiResource(testRequest2).load();
+    expect(requestMock).toHaveBeenCalledTimes(2);
+});

package/dist/esm/react/index.d.ts

@@ -0,0 +1 @@
+export * from "./ApiCallAsyncResourceFactory.js";

package/dist/esm/react/index.js

@@ -0,0 +1 @@
+export * from "./ApiCallAsyncResourceFactory.js";

package/dist/esm/react/types.d.ts

@@ -0,0 +1,3 @@
+import { OpenAPIOperation, RequestObject, ResponseData } from "../types/index.js";
+import { AsyncResource } from "@mittwald/react-use-promise";
+export type GetApiResourceFn<TOp extends OpenAPIOperation> = null extends RequestObject<TOp> ? (conf?: RequestObject<TOp>) => AsyncResource<ResponseData<TOp>> : (conf: RequestObject<TOp>) => AsyncResource<ResponseData<TOp>>;

package/dist/esm/react/types.js

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

package/dist/esm/types/OpenAPIOperation.d.ts

@@ -1,6 +1,6 @@
 import { AnyResponse, Response } from "./Response.js";
 import { AnyRequest, RequestType } from "./RequestType.js";
-import { HttpMethod } from "./http.js";
+import { HttpMethod, HttpStatus } from "./http.js";
 export interface OpenAPIOperation<TIgnoredRequest extends AnyRequest = RequestType, IgnoredResponse extends AnyResponse = Response> {
     operationId: string;
     path: string;
@@ -8,3 +8,9 @@ export interface OpenAPIOperation<TIgnoredRequest extends AnyRequest = RequestTy
 }
 export type InferredRequestType<TOp> = TOp extends OpenAPIOperation<infer TReq> ? TReq : never;
 export type InferredResponseType<TOp> = TOp extends OpenAPIOperation<RequestType, infer TRes> ? TRes : never;
+export type ResponseData<TOp, TStatus extends HttpStatus = 200> = Extract<InferredResponseType<TOp>, {
+    status: TStatus;
+}>["data"];
+export type RequestData<TOp> = TOp extends OpenAPIOperation ? InferredRequestType<TOp> extends {
+    data: infer TData;
+} ? TData : never : never;

package/dist/esm/types/RequestFunction.d.ts

@@ -1,8 +1,11 @@
 import { InferredRequestType, InferredResponseType, OpenAPIOperation } from "./OpenAPIOperation.js";
 import { NullableOnNoRequiredKeysDeep } from "./NullableOnNoRequiredKeysDeep.js";
-export type RequestConfig<TOp extends OpenAPIOperation> = NullableOnNoRequiredKeysDeep<InferredRequestType<TOp>>;
+type UnboxPathParameters<T> = T extends {
+    pathParameters: infer TPath;
+} ? Omit<T, "pathParameters"> & TPath : T;
+export type RequestObject<TOp extends OpenAPIOperation> = NullableOnNoRequiredKeysDeep<UnboxPathParameters<InferredRequestType<TOp>>>;
 export type ResponsePromise<TOp extends OpenAPIOperation> = Promise<InferredResponseType<TOp>>;
-type RequestFunctionWithOptionalRequest<TOp extends OpenAPIOperation> = (request?: RequestConfig<TOp>) => ResponsePromise<TOp>;
-type RequestFunctionWithRequiredRequest<TOp extends OpenAPIOperation> = (request: RequestConfig<TOp>) => ResponsePromise<TOp>;
-export type RequestFunction<TOp extends OpenAPIOperation> = null extends RequestConfig<TOp> ? RequestFunctionWithOptionalRequest<TOp> : RequestFunctionWithRequiredRequest<TOp>;
+type RequestFunctionWithOptionalRequest<TOp extends OpenAPIOperation> = (request?: RequestObject<TOp>) => ResponsePromise<TOp>;
+type RequestFunctionWithRequiredRequest<TOp extends OpenAPIOperation> = (request: RequestObject<TOp>) => ResponsePromise<TOp>;
+export type RequestFunction<TOp extends OpenAPIOperation> = null extends RequestObject<TOp> ? RequestFunctionWithOptionalRequest<TOp> : RequestFunctionWithRequiredRequest<TOp>;
 export {};

package/dist/esm/types/RequestFunction.test-types.js

@@ -18,4 +18,12 @@ function ignoredTestOptionalHeadersRequestTypes() {
         headers: { extra: true },
     });
 }
+function ignoredTestPathParametersAreInRootOfRequestConfig() {
+    const f = {};
+    void f({
+        foo: "",
+    });
+    // @ts-expect-error Missing parameter
+    void f({});
+}
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/api-client-commons",
-  "version": "3.1.0",
+  "version": "4.0.2",
   "description": "Common types and utilities for mittwald API clients",
   "license": "MIT",
   "repository": "https://github.com/mittwald/api-client-js.git",
@@ -22,6 +22,16 @@
         "require": "./dist/cjs/index.js",
         "default": "./dist/esm/index.js"
       }
+    },
+    "./react": {
+      "types": {
+        "require": "./dist/cjs/react/index.d.ts",
+        "default": "./dist/esm/react/index.d.ts"
+      },
+      "default": {
+        "require": "./dist/cjs/react/index.js",
+        "default": "./dist/esm/react/index.js"
+      }
     }
   },
   "scripts": {
@@ -37,6 +47,14 @@
     "sdk",
     "rest"
   ],
+  "peerDependencies": {
+    "@mittwald/react-use-promise": "^1.3.2"
+  },
+  "peerDependenciesMeta": {
+    "@mittwald/react-use-promise": {
+      "optional": true
+    }
+  },
   "dependencies": {
     "@types/parse-path": "^7.0.0",
     "axios": "^1.4.0",
@@ -46,9 +64,11 @@
   },
   "devDependencies": {
     "@jest/globals": "^29.6.0",
+    "@mittwald/react-use-promise": "^1.3.2",
     "@types/jest": "^29.5.2",
     "@yarnpkg/pnpify": "^4.0.0-rc.48",
     "jest": "^29.6.1",
+    "react": "^18.2.0",
     "ts-jest": "^29.1.1",
     "tsd": "^0.28.1"
   },