1
0
mirror of https://github.com/lensapp/lens.git synced 2025-05-20 05:10:56 +00:00

chore: extract json-api from core

Signed-off-by: Jari Kolehmainen <jari.kolehmainen@gmail.com>
This commit is contained in:
Jari Kolehmainen 2023-05-04 10:37:50 +03:00
parent f1f2634490
commit 04a23fc4f9
20 changed files with 164 additions and 55 deletions

37
package-lock.json generated
View File

@ -4008,6 +4008,10 @@
"resolved": "packages/infrastructure/jest", "resolved": "packages/infrastructure/jest",
"link": true "link": true
}, },
"node_modules/@k8slens/json-api": {
"resolved": "packages/utility-features/json-api",
"link": true
},
"node_modules/@k8slens/keyboard-shortcuts": { "node_modules/@k8slens/keyboard-shortcuts": {
"resolved": "packages/business-features/keyboard-shortcuts", "resolved": "packages/business-features/keyboard-shortcuts",
"link": true "link": true
@ -38315,6 +38319,28 @@
"@k8slens/webpack": "6.5.0-alpha.4" "@k8slens/webpack": "6.5.0-alpha.4"
} }
}, },
"packages/utility-features/json-api": {
"name": "@k8slens/json-api",
"version": "1.0.0-alpha.1",
"license": "MIT",
"dependencies": {
"@k8slens/node-fetch": "^6.5.0-alpha.3"
},
"devDependencies": {
"@k8slens/eslint-config": "^6.5.0-alpha.2",
"@k8slens/jest": "^6.5.0-alpha.4",
"@k8slens/typescript": "^6.5.0-alpha.2",
"@types/node": "^16.18.25",
"type-fest": "^2.14.0"
},
"peerDependencies": {
"@k8slens/event-emitter": "^1.0.0-alpha.1",
"@k8slens/logger": "^1.0.0-alpha.5",
"@k8slens/utilities": "^1.0.0-alpha.1",
"lodash": "^4.17.15",
"rfc6902": "^5.0.1"
}
},
"packages/utility-features/react-testing-library-discovery": { "packages/utility-features/react-testing-library-discovery": {
"name": "@k8slens/react-testing-library-discovery", "name": "@k8slens/react-testing-library-discovery",
"version": "1.0.0-alpha.3", "version": "1.0.0-alpha.3",
@ -41913,6 +41939,17 @@
} }
} }
}, },
"@k8slens/json-api": {
"version": "file:packages/utility-features/json-api",
"requires": {
"@k8slens/eslint-config": "^6.5.0-alpha.2",
"@k8slens/jest": "^6.5.0-alpha.4",
"@k8slens/node-fetch": "^6.5.0-alpha.3",
"@k8slens/typescript": "^6.5.0-alpha.2",
"@types/node": "^16.18.25",
"type-fest": "^2.14.0"
}
},
"@k8slens/keyboard-shortcuts": { "@k8slens/keyboard-shortcuts": {
"version": "file:packages/business-features/keyboard-shortcuts", "version": "file:packages/business-features/keyboard-shortcuts",
"requires": { "requires": {

View File

@ -3,14 +3,13 @@
* Licensed under MIT License. See LICENSE in root directory for more information. * Licensed under MIT License. See LICENSE in root directory for more information.
*/ */
import { getInjectable } from "@ogre-tools/injectable"; import { getInjectable } from "@ogre-tools/injectable";
import type { RequestInit, Response } from "@k8slens/node-fetch";
import fetch from "@k8slens/node-fetch"; import fetch from "@k8slens/node-fetch";
export type Fetch = (url: string, init?: RequestInit) => Promise<Response>; export type Fetch = typeof fetch;
const fetchInjectable = getInjectable({ const fetchInjectable = getInjectable({
id: "fetch", id: "fetch",
instantiate: () => fetch as Fetch, instantiate: () => fetch,
causesSideEffects: true, causesSideEffects: true,
}); });

View File

@ -8,8 +8,8 @@ import type { RequestInit } from "@k8slens/node-fetch";
import lensProxyCertificateInjectable from "../certificate/lens-proxy-certificate.injectable"; import lensProxyCertificateInjectable from "../certificate/lens-proxy-certificate.injectable";
import fetchInjectable from "../fetch/fetch.injectable"; import fetchInjectable from "../fetch/fetch.injectable";
import { loggerInjectionToken } from "@k8slens/logger"; import { loggerInjectionToken } from "@k8slens/logger";
import type { JsonApiConfig, JsonApiData, JsonApiDependencies, JsonApiParams } from "./json-api"; import type { JsonApiConfig, JsonApiData, JsonApiDependencies, JsonApiParams } from "@k8slens/json-api";
import { JsonApi } from "./json-api"; import { JsonApi } from "@k8slens/json-api";
export type CreateJsonApi = <Data = JsonApiData, Params extends JsonApiParams<Data> = JsonApiParams<Data>>(config: JsonApiConfig, reqInit?: RequestInit) => JsonApi<Data, Params>; export type CreateJsonApi = <Data = JsonApiData, Params extends JsonApiParams<Data> = JsonApiParams<Data>>(config: JsonApiConfig, reqInit?: RequestInit) => JsonApi<Data, Params>;

View File

@ -8,7 +8,7 @@ import type { RequestInit } from "@k8slens/node-fetch";
import lensProxyCertificateInjectable from "../certificate/lens-proxy-certificate.injectable"; import lensProxyCertificateInjectable from "../certificate/lens-proxy-certificate.injectable";
import fetchInjectable from "../fetch/fetch.injectable"; import fetchInjectable from "../fetch/fetch.injectable";
import { loggerInjectionToken } from "@k8slens/logger"; import { loggerInjectionToken } from "@k8slens/logger";
import type { JsonApiConfig, JsonApiDependencies } from "./json-api"; import type { JsonApiConfig, JsonApiDependencies } from "@k8slens/json-api";
import { KubeJsonApi } from "./kube-json-api"; import { KubeJsonApi } from "./kube-json-api";
export type CreateKubeJsonApi = (config: JsonApiConfig, reqInit?: RequestInit) => KubeJsonApi; export type CreateKubeJsonApi = (config: JsonApiConfig, reqInit?: RequestInit) => KubeJsonApi;

View File

@ -3,8 +3,8 @@
* Licensed under MIT License. See LICENSE in root directory for more information. * Licensed under MIT License. See LICENSE in root directory for more information.
*/ */
import type { JsonApiError } from "./json-api"; import type { JsonApiError } from "@k8slens/json-api";
import { JsonApi } from "./json-api"; import { JsonApi } from "@k8slens/json-api";
import type { Response } from "@k8slens/node-fetch"; import type { Response } from "@k8slens/node-fetch";
import type { KubeJsonApiData } from "@k8slens/kube-object"; import type { KubeJsonApiData } from "@k8slens/kube-object";

View File

@ -3,7 +3,7 @@
* Licensed under MIT License. See LICENSE in root directory for more information. * Licensed under MIT License. See LICENSE in root directory for more information.
*/ */
import { JsonApiErrorParsed } from "../k8s-api/json-api"; import { JsonApiErrorParsed } from "@k8slens/json-api";
export const getErrorMessage = (error: unknown): string => { export const getErrorMessage = (error: unknown): string => {
if (typeof error === "string") { if (typeof error === "string") {

View File

@ -25,7 +25,7 @@ import { loggerInjectionToken } from "@k8slens/logger";
import maybeKubeApiInjectable from "../../common/k8s-api/maybe-kube-api.injectable"; import maybeKubeApiInjectable from "../../common/k8s-api/maybe-kube-api.injectable";
import { DeploymentApi as InternalDeploymentApi, IngressApi as InternalIngressApi, NodeApi, PersistentVolumeClaimApi, PodApi } from "../../common/k8s-api/endpoints"; import { DeploymentApi as InternalDeploymentApi, IngressApi as InternalIngressApi, NodeApi, PersistentVolumeClaimApi, PodApi } from "../../common/k8s-api/endpoints";
import { storesAndApisCanBeCreatedInjectionToken } from "../../common/k8s-api/stores-apis-can-be-created.token"; import { storesAndApisCanBeCreatedInjectionToken } from "../../common/k8s-api/stores-apis-can-be-created.token";
import type { JsonApiConfig } from "../../common/k8s-api/json-api"; import type { JsonApiConfig } from "@k8slens/json-api";
import type { KubeJsonApi as InternalKubeJsonApi } from "../../common/k8s-api/kube-json-api"; import type { KubeJsonApi as InternalKubeJsonApi } from "../../common/k8s-api/kube-json-api";
import createKubeJsonApiInjectable from "../../common/k8s-api/create-kube-json-api.injectable"; import createKubeJsonApiInjectable from "../../common/k8s-api/create-kube-json-api.injectable";
import type { RequestInit } from "@k8slens/node-fetch"; import type { RequestInit } from "@k8slens/node-fetch";

View File

@ -24,7 +24,7 @@ import type { ApiKubeGet } from "../../../renderer/k8s/api-kube-get.injectable";
import apiKubePatchInjectable from "../../../renderer/k8s/api-kube-patch.injectable"; import apiKubePatchInjectable from "../../../renderer/k8s/api-kube-patch.injectable";
import apiKubeGetInjectable from "../../../renderer/k8s/api-kube-get.injectable"; import apiKubeGetInjectable from "../../../renderer/k8s/api-kube-get.injectable";
import type { BaseKubeJsonApiObjectMetadata, KubeObjectScope, KubeJsonApiData } from "@k8slens/kube-object"; import type { BaseKubeJsonApiObjectMetadata, KubeObjectScope, KubeJsonApiData } from "@k8slens/kube-object";
import { JsonApiErrorParsed } from "../../../common/k8s-api/json-api"; import { JsonApiErrorParsed } from "@k8slens/json-api";
import type { ShowNotification } from "../../../renderer/components/notifications"; import type { ShowNotification } from "../../../renderer/components/notifications";
import React from "react"; import React from "react";

View File

@ -6,7 +6,7 @@
import type React from "react"; import type React from "react";
import { action, observable, makeObservable } from "mobx"; import { action, observable, makeObservable } from "mobx";
import uniqueId from "lodash/uniqueId"; import uniqueId from "lodash/uniqueId";
import type { JsonApiErrorParsed } from "../../../common/k8s-api/json-api"; import type { JsonApiErrorParsed } from "@k8slens/json-api";
import type { SetRequired } from "type-fest"; import type { SetRequired } from "type-fest";
import autoBind from "auto-bind"; import autoBind from "auto-bind";

View File

@ -8,7 +8,7 @@ import "./notifications.scss";
import React from "react"; import React from "react";
import { reaction } from "mobx"; import { reaction } from "mobx";
import { disposeOnUnmount, observer } from "mobx-react"; import { disposeOnUnmount, observer } from "mobx-react";
import { JsonApiErrorParsed } from "../../../common/k8s-api/json-api"; import { JsonApiErrorParsed } from "@k8slens/json-api";
import type { Disposer } from "@k8slens/utilities"; import type { Disposer } from "@k8slens/utilities";
import { cssNames, prevDefault } from "@k8slens/utilities"; import { cssNames, prevDefault } from "@k8slens/utilities";
import type { CreateNotificationOptions, Notification, NotificationMessage, NotificationsStore } from "./notifications.store"; import type { CreateNotificationOptions, Notification, NotificationMessage, NotificationsStore } from "./notifications.store";

View File

@ -3,7 +3,7 @@
* Licensed under MIT License. See LICENSE in root directory for more information. * Licensed under MIT License. See LICENSE in root directory for more information.
*/ */
import { getInjectable } from "@ogre-tools/injectable"; import { getInjectable } from "@ogre-tools/injectable";
import { JsonApiErrorParsed } from "../../../common/k8s-api/json-api"; import { JsonApiErrorParsed } from "@k8slens/json-api";
import { loggerInjectionToken } from "@k8slens/logger"; import { loggerInjectionToken } from "@k8slens/logger";
import type { Disposer } from "@k8slens/utilities"; import type { Disposer } from "@k8slens/utilities";
import type { CreateNotificationOptions } from "./notifications.store"; import type { CreateNotificationOptions } from "./notifications.store";

View File

@ -11,7 +11,7 @@ import type { ForwardedPort } from "../port-forward-item";
import { PortForwardItem } from "../port-forward-item"; import { PortForwardItem } from "../port-forward-item";
import { waitUntilFree } from "tcp-port-used"; import { waitUntilFree } from "tcp-port-used";
import type { Logger } from "@k8slens/logger"; import type { Logger } from "@k8slens/logger";
import type { JsonApi } from "../../../common/k8s-api/json-api"; import type { JsonApi } from "@k8slens/json-api";
import type { RequestActivePortForward } from "./request-active-port-forward.injectable"; import type { RequestActivePortForward } from "./request-active-port-forward.injectable";
import autoBind from "auto-bind"; import autoBind from "auto-bind";

View File

@ -0,0 +1,6 @@
module.exports = {
extends: "@k8slens/eslint-config/eslint",
parserOptions: {
project: "./tsconfig.json",
},
};

View File

@ -0,0 +1 @@
"@k8slens/eslint-config/prettier"

View File

@ -0,0 +1 @@
export * from "./src/json-api";

View File

@ -0,0 +1 @@
module.exports = require("@k8slens/jest").monorepoPackageConfig(__dirname).configForNode;

View File

@ -0,0 +1,51 @@
{
"name": "@k8slens/json-api",
"private": false,
"version": "1.0.0-alpha.1",
"description": "JSON api client",
"type": "commonjs",
"publishConfig": {
"access": "public",
"registry": "https://registry.npmjs.org/"
},
"files": [
"dist"
],
"repository": {
"type": "git",
"url": "git+https://github.com/lensapp/lens.git"
},
"main": "dist/index.js",
"types": "dist/index.d.ts",
"author": {
"name": "OpenLens Authors",
"email": "info@k8slens.dev"
},
"license": "MIT",
"homepage": "https://github.com/lensapp/lens",
"scripts": {
"build": "webpack",
"clean": "rimraf dist/",
"dev": "webpack --mode=development --watch",
"test": "jest --coverage --runInBand",
"lint": "lens-lint",
"lint:fix": "lens-lint --fix"
},
"dependencies": {
"@k8slens/node-fetch": "^6.5.0-alpha.3"
},
"peerDependencies": {
"@k8slens/event-emitter": "^1.0.0-alpha.1",
"@k8slens/logger": "^1.0.0-alpha.5",
"@k8slens/utilities": "^1.0.0-alpha.1",
"lodash": "^4.17.15",
"rfc6902": "^5.0.1"
},
"devDependencies": {
"@k8slens/eslint-config": "^6.5.0-alpha.2",
"@k8slens/jest": "^6.5.0-alpha.4",
"@k8slens/typescript": "^6.5.0-alpha.2",
"@types/node": "^16.18.25",
"type-fest": "^2.14.0"
}
}

View File

@ -3,18 +3,16 @@
* Licensed under MIT License. See LICENSE in root directory for more information. * Licensed under MIT License. See LICENSE in root directory for more information.
*/ */
// Base http-service / json-api class
import { Agent as HttpAgent } from "http"; import { Agent as HttpAgent } from "http";
import { Agent as HttpsAgent } from "https"; import { Agent as HttpsAgent } from "https";
import { merge } from "lodash"; import { merge } from "lodash";
import type { Response, RequestInit } from "@k8slens/node-fetch";
import { stringify } from "querystring"; import { stringify } from "querystring";
import type { Patch } from "rfc6902"; import type { Patch } from "rfc6902";
import type { PartialDeep, ValueOf } from "type-fest"; import type { PartialDeep, ValueOf } from "type-fest";
import { EventEmitter } from "@k8slens/event-emitter"; import { EventEmitter } from "@k8slens/event-emitter";
import type { Logger } from "@k8slens/logger"; import type { Logger } from "@k8slens/logger";
import type { Fetch } from "../fetch/fetch.injectable"; import type Fetch from "@k8slens/node-fetch";
import type { RequestInit, Response } from "@k8slens/node-fetch";
import type { Defaulted } from "@k8slens/utilities"; import type { Defaulted } from "@k8slens/utilities";
import { isObject, isString, json } from "@k8slens/utilities"; import { isObject, isString, json } from "@k8slens/utilities";
@ -74,33 +72,58 @@ export interface JsonApiConfig {
const httpAgent = new HttpAgent({ keepAlive: true }); const httpAgent = new HttpAgent({ keepAlive: true });
const httpsAgent = new HttpsAgent({ keepAlive: true }); const httpsAgent = new HttpsAgent({ keepAlive: true });
export type QueryParam = string | number | boolean | null | undefined | readonly string[] | readonly number[] | readonly boolean[]; export type QueryParam =
| string
| number
| boolean
| null
| undefined
| readonly string[]
| readonly number[]
| readonly boolean[];
export type QueryParams = Partial<Record<string, QueryParam | undefined>>; export type QueryParams = Partial<Record<string, QueryParam | undefined>>;
export type ParamsAndQuery<Params, Query> = ( export type ParamsAndQuery<Params, Query> = ValueOf<Query> extends QueryParam
ValueOf<Query> extends QueryParam
? Params & { query?: Query } ? Params & { query?: Query }
: Params & { query?: undefined } : Params & { query?: undefined };
);
export interface JsonApiDependencies { export interface JsonApiDependencies {
fetch: Fetch; fetch: typeof Fetch;
readonly logger: Logger; readonly logger: Logger;
} }
export class JsonApiErrorParsed {
isUsedForNotification = false;
constructor(private error: JsonApiError | DOMException | KubeJsonApiError, private messages: string[]) {}
get isAborted() {
return this.error.code === DOMException.ABORT_ERR;
}
toString() {
return this.messages.join("\n");
}
}
export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = JsonApiParams<Data>> { export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = JsonApiParams<Data>> {
static readonly reqInitDefault = { static readonly reqInitDefault = {
headers: { headers: {
"content-type": "application/json", "content-type": "application/json",
}, },
}; };
protected readonly reqInit: Defaulted<RequestInit, keyof typeof JsonApi["reqInitDefault"]>;
protected readonly reqInit: Defaulted<RequestInit, keyof (typeof JsonApi)["reqInitDefault"]>;
static readonly configDefault: Partial<JsonApiConfig> = { static readonly configDefault: Partial<JsonApiConfig> = {
debug: false, debug: false,
}; };
constructor(protected readonly dependencies: JsonApiDependencies, public readonly config: JsonApiConfig, reqInit?: RequestInit) { constructor(
protected readonly dependencies: JsonApiDependencies,
public readonly config: JsonApiConfig,
reqInit?: RequestInit,
) {
this.config = Object.assign({}, JsonApi.configDefault, config); this.config = Object.assign({}, JsonApi.configDefault, config);
this.reqInit = merge({}, JsonApi.reqInitDefault, reqInit); this.reqInit = merge({}, JsonApi.reqInitDefault, reqInit);
this.parseResponse = this.parseResponse.bind(this); this.parseResponse = this.parseResponse.bind(this);
@ -108,7 +131,9 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
} }
public readonly onData = new EventEmitter<[Data, Response]>(); public readonly onData = new EventEmitter<[Data, Response]>();
public readonly onError = new EventEmitter<[JsonApiErrorParsed, Response]>(); public readonly onError = new EventEmitter<[JsonApiErrorParsed, Response]>();
private readonly getRequestOptions: GetRequestOptions; private readonly getRequestOptions: GetRequestOptions;
async getResponse<Query>( async getResponse<Query>(
@ -163,7 +188,7 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
patch<OutData = Data, Query = QueryParams>( patch<OutData = Data, Query = QueryParams>(
path: string, path: string,
params?: (ParamsAndQuery<Omit<Params, "data">, Query> & { data?: Patch | PartialDeep<Data> }), params?: ParamsAndQuery<Omit<Params, "data">, Query> & { data?: Patch | PartialDeep<Data> },
reqInit: RequestInit = {}, reqInit: RequestInit = {},
) { ) {
return this.request<OutData, Query>(path, params, { ...reqInit, method: "patch" }); return this.request<OutData, Query>(path, params, { ...reqInit, method: "patch" });
@ -183,12 +208,7 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
init: Defaulted<RequestInit, "method">, init: Defaulted<RequestInit, "method">,
) { ) {
let reqUrl = `${this.config.serverAddress}${this.config.apiBase}${path}`; let reqUrl = `${this.config.serverAddress}${this.config.apiBase}${path}`;
const reqInit = merge( const reqInit = merge({}, this.reqInit, await this.getRequestOptions(), init);
{},
this.reqInit,
await this.getRequestOptions(),
init,
);
const { data, query } = params || {}; const { data, query } = params || {};
if (data && !reqInit.body) { if (data && !reqInit.body) {
@ -208,7 +228,7 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
const res = await this.dependencies.fetch(reqUrl, reqInit); const res = await this.dependencies.fetch(reqUrl, reqInit);
return await this.parseResponse(res, infoLog) as OutData; return (await this.parseResponse(res, infoLog)) as OutData;
} }
protected async parseResponse(res: Response, log: JsonApiLog): Promise<Data> { protected async parseResponse(res: Response, log: JsonApiLog): Promise<Data> {
@ -216,9 +236,7 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
const text = await res.text(); const text = await res.text();
const parseResponse = json.parse(text || "{}"); const parseResponse = json.parse(text || "{}");
const data = parseResponse.callWasSuccessful const data = parseResponse.callWasSuccessful ? (parseResponse.response as Data) : (text as Data);
? parseResponse.response as Data
: text as Data;
if (status >= 200 && status < 300) { if (status >= 200 && status < 300) {
this.onData.emit(data, res); this.onData.emit(data, res);
@ -229,6 +247,7 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
if (log.method === "GET" && res.status === 403) { if (log.method === "GET" && res.status === 403) {
this.writeLog({ ...log, error: data }); this.writeLog({ ...log, error: data });
// eslint-disable-next-line @typescript-eslint/no-throw-literal
throw data; throw data;
} }
@ -237,6 +256,7 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
this.onError.emit(error, res); this.onError.emit(error, res);
this.writeLog({ ...log, error }); this.writeLog({ ...log, error });
// eslint-disable-next-line @typescript-eslint/no-throw-literal
throw error; throw error;
} }
@ -252,7 +272,7 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
const { errors, message } = error as { errors?: { title: string }[]; message?: string }; const { errors, message } = error as { errors?: { title: string }[]; message?: string };
if (Array.isArray(errors)) { if (Array.isArray(errors)) {
return errors.map(error => error.title); return errors.map((error) => error.title);
} }
if (isString(message)) { if (isString(message)) {
@ -268,18 +288,3 @@ export class JsonApi<Data = JsonApiData, Params extends JsonApiParams<Data> = Js
this.dependencies.logger.debug(`[JSON-API] request ${method} ${reqUrl}`, params); this.dependencies.logger.debug(`[JSON-API] request ${method} ${reqUrl}`, params);
} }
} }
export class JsonApiErrorParsed {
isUsedForNotification = false;
constructor(private error: JsonApiError | DOMException | KubeJsonApiError, private messages: string[]) {
}
get isAborted() {
return this.error.code === DOMException.ABORT_ERR;
}
toString() {
return this.messages.join("\n");
}
}

View File

@ -0,0 +1,7 @@
{
"extends": "@k8slens/typescript/config/base.json",
"include": ["**/*.ts"],
"compilerOptions": {
"moduleResolution": "node"
}
}

View File

@ -0,0 +1 @@
module.exports = require("@k8slens/webpack").configForNode;