@mittwald/api-client-commons 2.0.1 → 2.0.3

package/README.md

@@ -1 +1,33 @@
 Common code base used by `@mittwald/api-client-*` package.
+
+## API
+
+### assertStatus
+
+The API client does not validate any response status by design, to give you the
+most flexibility while handling also erroneous responses. If you want to assert
+some desired response status, you can use the `assertStatus` function.
+
+#### assertStatus(response, expectedStatus)
+
+Returns: void
+
+This method throws an `ApiClientError` if the given `response` does not match
+the `expectedStatus`.
+
+When you are using TypeScript this function also asserts the correct response
+type.
+
+```ts
+const response = await client.project.getProject({
+  pathParameters: {
+    projectId: "...",
+  },
+});
+
+assertStatus(response, 200);
+
+const project = response.data;
+// Project properties can now be accessed safely
+const name = project.name;
+```

package/dist/types/assertStatus.d.ts

@@ -0,0 +1,5 @@
+import { Response } from "./Response.js";
+export declare function assertStatus<T extends Response, S extends T["status"]>(response: T, expectedStatus: S): asserts response is T & {
+    status: S;
+};
+export default assertStatus;

package/dist/types/assertStatus.js

@@ -0,0 +1,7 @@
+import ApiClientError from "../core/ApiClientError.js";
+export function assertStatus(response, expectedStatus) {
+    if (response.status !== expectedStatus) {
+        throw ApiClientError.fromResponse(`Unexpected response status (expected ${expectedStatus}, got: ${response.status})`, response);
+    }
+}
+export default assertStatus;

package/dist/types/index.d.ts

@@ -3,4 +3,4 @@ export * from "./RequestFunction.js";
 export * from "./Response.js";
 export * from "./OpenAPIOperation.js";
 export * from "./http.js";
-export { Simplify } from "type-fest";
+export * from "./simplify.js";

package/dist/types/index.js

@@ -3,3 +3,4 @@ export * from "./RequestFunction.js";
 export * from "./Response.js";
 export * from "./OpenAPIOperation.js";
 export * from "./http.js";
+export * from "./simplify.js";

package/dist/types/simplify.d.ts

@@ -0,0 +1,3 @@
+export type Simplify<T> = {
+    [KeyType in keyof T]: T[KeyType];
+} & {};

package/dist/types/simplify.js

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

package/dist-cjs/core/ApiClientBase.js

@@ -1,34 +1,8 @@
 "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 = __importStar(require("axios"));
-const Request_js_1 = __importDefault(require("./Request.js"));
+const axios_1 = require("axios");
+const Request_js_1 = require("./Request.js");
 class ApiClientBase {
     constructor(axiosConfig = axios_1.default) {
         this.axios =

package/dist-cjs/core/Request.js

@@ -1,10 +1,7 @@
 "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 = __importDefault(require("./OpenAPIPath.js"));
+const OpenAPIPath_js_1 = require("./OpenAPIPath.js");
 class Request {
     constructor(axiosInstance, operationDescriptor, config) {
         this.axios = axiosInstance;

package/dist-cjs/types/assertStatus.d.ts

@@ -0,0 +1,5 @@
+import { Response } from "./Response.js";
+export declare function assertStatus<T extends Response, S extends T["status"]>(response: T, expectedStatus: S): asserts response is T & {
+    status: S;
+};
+export default assertStatus;

package/dist-cjs/types/assertStatus.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertStatus = void 0;
+const ApiClientError_js_1 = 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);
+    }
+}
+exports.assertStatus = assertStatus;
+exports.default = assertStatus;

package/dist-cjs/types/index.d.ts

@@ -3,4 +3,4 @@ export * from "./RequestFunction.js";
 export * from "./Response.js";
 export * from "./OpenAPIOperation.js";
 export * from "./http.js";
-export { Simplify } from "type-fest";
+export * from "./simplify.js";

package/dist-cjs/types/index.js

@@ -19,3 +19,4 @@ __exportStar(require("./RequestFunction.js"), exports);
 __exportStar(require("./Response.js"), exports);
 __exportStar(require("./OpenAPIOperation.js"), exports);
 __exportStar(require("./http.js"), exports);
+__exportStar(require("./simplify.js"), exports);

package/dist-cjs/types/simplify.d.ts

@@ -0,0 +1,3 @@
+export type Simplify<T> = {
+    [KeyType in keyof T]: T[KeyType];
+} & {};

package/dist-cjs/types/simplify.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mittwald/api-client-commons",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "Common types and utilities for mittwald API clients",
   "license": "MIT",
   "repository": "https://github.com/mittwald/api-client-js.git",
@@ -13,16 +13,34 @@
   "type": "module",
   "exports": {
     ".": {
-      "import": "./dist/core/index.js",
-      "default": "./dist-cjs/core/index.js"
+      "types": {
+        "require": "./dist-cjs/core/index.d.ts",
+        "default": "./dist/core/index.d.ts"
+      },
+      "default": {
+        "require": "./dist-cjs/core/index.js",
+        "default": "./dist/core/index.js"
+      }
     },
     "./axios": {
-      "import": "./dist/axios.js",
-      "default": "./dist-cjs/axios.js"
+      "types": {
+        "require": "./dist-cjs/axios.d.ts",
+        "default": "./dist/axios.d.ts"
+      },
+      "default": {
+        "require": "./dist-cjs/axios.js",
+        "default": "./dist/axios.js"
+      }
     },
     "./types": {
-      "import": "./dist/types/index.js",
-      "default": "./dist-cjs/types/index.js"
+      "types": {
+        "require": "./dist-cjs/types/index.d.ts",
+        "default": "./dist/types/index.d.ts"
+      },
+      "default": {
+        "require": "./dist-cjs/types/index.js",
+        "default": "./dist/types/index.js"
+      }
     }
   },
   "scripts": {
@@ -44,10 +62,10 @@
     "axios": "^1.4.0",
     "parse-path": "^7.0.0",
     "path-to-regexp": "^6.2.1",
-    "type-fest": "^3.10.0"
+    "type-fest": "^3.12.0"
   },
   "devDependencies": {
-    "@yarnpkg/pnpify": "^4.0.0-rc.43",
+    "@yarnpkg/pnpify": "^4.0.0-rc.48",
     "tsd": "^0.28.1"
   },
   "types": "./dist/index.d.ts"