@harnessio/react-ti-service-client 0.1.0

package/README.md

@@ -0,0 +1,40 @@
+# React TI Service Client(WIP)
+
+**OpenAPI -> OA**
+
+**TypeScript -> TS**
+
+**OpenAPI + TypeScript -> OATS**
+
+This React API client will store a collection of Harness TI Service APIs and Interfaces contracts generated from Open API Spec using `OATS CLI` internally.
+APIs are using hooks from `@tanstack/react-query`
+
+## Steps To Generate API Client build as dist folder
+
+```
+yarn build
+```
+
+## For NextGen UI adoption : HarnessReactAPIClient should be initialized
+
+Before using API Client, it must be initilaized with required `ClientCallbacks`.
+
+Example:
+
+```
+ new TIServiceAPIClient({
+    getHeaders: () => {
+        return { token: SessionToken.getToken(), 'Harness-Account': accountId }
+    }}
+```
+
+## Versioning
+
+![@harnessio/react-ti-service-client](https://img.shields.io/npm/v/@harnessio/react-ti-service-client.svg?style=flat-square)
+
+Once development phase is completed, this repo will have changes and versioning driven by API spec only.
+
+## License
+
+[MIT](./LICENSE.md). Copyright(c) [Harness Inc](https://harness.io)
+

package/dist/fetcher/index.d.ts

@@ -0,0 +1,17 @@
+import type { IStringifyOptions } from 'qs';
+export interface FetcherOptions<TQueryParams = never, TBody = never, THeaderParams = HeadersInit> extends Omit<RequestInit, 'body' | 'headers'> {
+    url: string;
+    queryParams?: TQueryParams extends never ? undefined : TQueryParams;
+    body?: TBody extends never ? undefined : TBody;
+    stringifyQueryParamsOptions?: IStringifyOptions;
+    headers?: THeaderParams;
+}
+export interface ClientCallbacks {
+    responseInterceptor?: (response: Response) => Response;
+    requestInterceptor?: (request: Request) => Request;
+    urlInterceptor?: (url: string) => string;
+    getRequestHeaders?: () => Record<string, any>;
+}
+export declare function setupClient(callbacks: ClientCallbacks): void;
+export declare const updateClientHeaders: (headers: Record<string, any>) => void;
+export declare function fetcher<TResponse = unknown, TQueryParams = never, TBody = never, THeaderParams = HeadersInit>(options: FetcherOptions<TQueryParams, TBody, THeaderParams>): Promise<TResponse>;

package/dist/fetcher/index.js

@@ -0,0 +1,65 @@
+import { __awaiter, __rest } from "tslib";
+import { stringify } from 'qs';
+const JSON_CONTENT_TYPES = ['application/json'];
+let APIClientInitialized = false;
+let fetcherCallbacks;
+let customHeaders = {
+    'Content-Type': JSON_CONTENT_TYPES[0],
+};
+export function setupClient(callbacks) {
+    fetcherCallbacks = callbacks;
+    customHeaders = Object.assign(Object.assign({}, customHeaders), ((fetcherCallbacks === null || fetcherCallbacks === void 0 ? void 0 : fetcherCallbacks.getRequestHeaders) ? fetcherCallbacks === null || fetcherCallbacks === void 0 ? void 0 : fetcherCallbacks.getRequestHeaders() : {}));
+    APIClientInitialized = true;
+}
+export const updateClientHeaders = (headers) => {
+    customHeaders = Object.assign(Object.assign({}, customHeaders), headers);
+};
+export function fetcher(options) {
+    var _a, _b;
+    return __awaiter(this, void 0, void 0, function* () {
+        // If not initialized throw error even without making request
+        if (!APIClientInitialized) {
+            throw { reason: 'HarnessReactAPIClient has not been initialized' };
+        }
+        const { stringifyQueryParamsOptions, headers, body, url, queryParams = { account: customHeaders['Harness-Account'] } } = options, rest = __rest(options, ["stringifyQueryParamsOptions", "headers", "body", "url", "queryParams"]);
+        const token = customHeaders.token;
+        let finalUrl = url;
+        if (queryParams) {
+            finalUrl += stringify(queryParams, Object.assign(Object.assign({}, stringifyQueryParamsOptions), { addQueryPrefix: true }));
+        }
+        if (fetcherCallbacks === null || fetcherCallbacks === void 0 ? void 0 : fetcherCallbacks.urlInterceptor) {
+            finalUrl = (_a = fetcherCallbacks === null || fetcherCallbacks === void 0 ? void 0 : fetcherCallbacks.urlInterceptor) === null || _a === void 0 ? void 0 : _a.call(fetcherCallbacks, finalUrl);
+        }
+        let request = new Request(finalUrl, Object.assign({ headers: Object.assign(Object.assign(Object.assign({}, (token ? { Authorization: `Bearer ${token}` } : {})), headers), customHeaders), body: body ? JSON.stringify(body) : undefined }, rest));
+        if (fetcherCallbacks === null || fetcherCallbacks === void 0 ? void 0 : fetcherCallbacks.requestInterceptor) {
+            request = fetcherCallbacks.requestInterceptor(request.clone());
+        }
+        let response = yield fetch(request);
+        if (fetcherCallbacks === null || fetcherCallbacks === void 0 ? void 0 : fetcherCallbacks.responseInterceptor) {
+            response = (_b = fetcherCallbacks === null || fetcherCallbacks === void 0 ? void 0 : fetcherCallbacks.responseInterceptor) === null || _b === void 0 ? void 0 : _b.call(fetcherCallbacks, response.clone());
+        }
+        const contentType = response.headers.get('Content-Type');
+        let total, pageSize, pageNumber, pageCount, pagination;
+        try {
+            total = response.headers.get('x-total-elements');
+            pageSize = response.headers.get('x-page-size');
+            pageNumber = response.headers.get('x-page-number');
+            pagination = total || pageSize || pageNumber;
+            if (pagination) {
+                total = Number(total);
+                pageSize = Number(pageSize);
+                pageCount = Math.ceil(total / pageSize);
+                pageNumber = Number(pageNumber);
+            }
+        }
+        catch (e) {
+            throw new Error('HarnessReactAPIClient: An error occurred while parsing pagination headers. ' + e);
+        }
+        const asJson = contentType && JSON_CONTENT_TYPES.some((h) => contentType.startsWith(h));
+        const data = yield (asJson ? response.json() : response.text());
+        if (response.ok) {
+            return Object.assign({ content: data }, (pagination ? { pagination: { total, pageCount, pageSize, pageNumber } } : {}));
+        }
+        throw data;
+    });
+}

package/dist/ti-service/src/helpers.d.ts

@@ -0,0 +1,14 @@
+export type GetPathParamsType<T> = T extends {
+    pathParams: infer R;
+} ? R : never;
+export interface ResponseWithPagination<T> {
+    content: T;
+    pagination?: {
+        total?: number;
+        pageSize?: number;
+        pageCount?: number;
+        pageNumber?: number;
+    };
+}
+export type WithOptional<TInput, Tkeys extends keyof TInput> = Omit<TInput, Tkeys> & Partial<Pick<TInput, Tkeys>>;
+export type PickPartial<TInput, Tkeys extends keyof TInput> = Pick<Partial<TInput>, Tkeys>;

package/dist/ti-service/src/helpers.js

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

package/dist/ti-service/src/index.d.ts

@@ -0,0 +1,6 @@
+import { ClientCallbacks } from '../../fetcher';
+export * from './services/index';
+export declare class TIServiceAPIClient {
+    updateHeaders: (headers: Record<string, any>) => void;
+    constructor(callbacks: ClientCallbacks);
+}

package/dist/ti-service/src/index.js

@@ -0,0 +1,10 @@
+import { setupClient, updateClientHeaders } from '../../fetcher';
+export * from './services/index';
+export class TIServiceAPIClient {
+    constructor(callbacks) {
+        setupClient(callbacks);
+        this.updateHeaders = (headers) => {
+            updateClientHeaders(headers);
+        };
+    }
+}

package/dist/ti-service/src/services/helpers.d.ts

@@ -0,0 +1,14 @@
+export type GetPathParamsType<T> = T extends {
+    pathParams: infer R;
+} ? R : never;
+export interface ResponseWithPagination<T> {
+    content: T;
+    pagination?: {
+        total?: number;
+        pageSize?: number;
+        pageCount?: number;
+        pageNumber?: number;
+    };
+}
+export type WithOptional<TInput, Tkeys extends keyof TInput> = Omit<TInput, Tkeys> & Partial<Pick<TInput, Tkeys>>;
+export type PickPartial<TInput, Tkeys extends keyof TInput> = Pick<Partial<TInput>, Tkeys>;

package/dist/ti-service/src/services/helpers.js

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

package/dist/ti-service/src/services/hooks/useGetExecutionCoverageReportQuery.d.ts

@@ -0,0 +1,29 @@
+import { UseQueryOptions } from '@tanstack/react-query';
+import type { ReportPipelineExecutionOutput } from '../schemas/ReportPipelineExecutionOutput';
+import type { BadRequestResponse } from '../responses/BadRequestResponse';
+import type { UnauthenticatedResponse } from '../responses/UnauthenticatedResponse';
+import type { UnauthorizedResponse } from '../responses/UnauthorizedResponse';
+import type { InternalErrorResponse } from '../responses/InternalErrorResponse';
+import type { ResponseWithPagination } from '../helpers';
+import { FetcherOptions } from '../../../../fetcher/index.js';
+export interface GetExecutionCoverageReportQueryPathParams {
+    account_identifier: string;
+    execution_id: string;
+    tree_path: string;
+}
+export interface GetExecutionCoverageReportQueryQueryParams {
+    tag?: string[];
+}
+export interface GetExecutionCoverageReportQueryHeaderParams {
+    'harness-account'?: string;
+}
+export type GetExecutionCoverageReportOkResponse = ResponseWithPagination<ReportPipelineExecutionOutput>;
+export type GetExecutionCoverageReportErrorResponse = BadRequestResponse | UnauthenticatedResponse | UnauthorizedResponse | InternalErrorResponse;
+export interface GetExecutionCoverageReportProps extends GetExecutionCoverageReportQueryPathParams, Omit<FetcherOptions<GetExecutionCoverageReportQueryQueryParams, unknown, GetExecutionCoverageReportQueryHeaderParams>, 'url'> {
+    queryParams: GetExecutionCoverageReportQueryQueryParams;
+}
+export declare function getExecutionCoverageReport(props: GetExecutionCoverageReportProps): Promise<GetExecutionCoverageReportOkResponse>;
+/**
+ * Retrieve pipeline execution coverage data for a specific file path or directory tree
+ */
+export declare function useGetExecutionCoverageReportQuery(props: GetExecutionCoverageReportProps, options?: Omit<UseQueryOptions<GetExecutionCoverageReportOkResponse, GetExecutionCoverageReportErrorResponse>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<GetExecutionCoverageReportOkResponse, import("..").Error>;

package/dist/ti-service/src/services/hooks/useGetExecutionCoverageReportQuery.js

@@ -0,0 +1,20 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+import { useQuery } from '@tanstack/react-query';
+import { fetcher } from '../../../../fetcher/index.js';
+export function getExecutionCoverageReport(props) {
+    return fetcher(Object.assign({ url: `/coverage/api/v1/accounts/${props.account_identifier}/executions/${props.execution_id}/tree/${props.tree_path}`, method: 'GET' }, props));
+}
+/**
+ * Retrieve pipeline execution coverage data for a specific file path or directory tree
+ */
+export function useGetExecutionCoverageReportQuery(props, options) {
+    return useQuery([
+        'getExecutionCoverageReport',
+        props.account_identifier,
+        props.execution_id,
+        props.tree_path,
+        props.queryParams,
+    ], ({ signal }) => getExecutionCoverageReport(Object.assign(Object.assign({}, props), { signal })), options);
+}

package/dist/ti-service/src/services/hooks/useSearchCoverageFilesQuery.d.ts

@@ -0,0 +1,28 @@
+import { UseQueryOptions } from '@tanstack/react-query';
+import type { SearchResults } from '../schemas/SearchResults';
+import type { BadRequestResponse } from '../responses/BadRequestResponse';
+import type { UnauthenticatedResponse } from '../responses/UnauthenticatedResponse';
+import type { UnauthorizedResponse } from '../responses/UnauthorizedResponse';
+import type { InternalErrorResponse } from '../responses/InternalErrorResponse';
+import type { ResponseWithPagination } from '../helpers';
+import { FetcherOptions } from '../../../../fetcher/index.js';
+export interface SearchCoverageFilesQueryPathParams {
+    account_identifier: string;
+    execution_id: string;
+}
+export interface SearchCoverageFilesQueryQueryParams {
+    query: string;
+}
+export interface SearchCoverageFilesQueryHeaderParams {
+    'harness-account'?: string;
+}
+export type SearchCoverageFilesOkResponse = ResponseWithPagination<SearchResults>;
+export type SearchCoverageFilesErrorResponse = BadRequestResponse | UnauthenticatedResponse | UnauthorizedResponse | InternalErrorResponse;
+export interface SearchCoverageFilesProps extends SearchCoverageFilesQueryPathParams, Omit<FetcherOptions<SearchCoverageFilesQueryQueryParams, unknown, SearchCoverageFilesQueryHeaderParams>, 'url'> {
+    queryParams: SearchCoverageFilesQueryQueryParams;
+}
+export declare function searchCoverageFiles(props: SearchCoverageFilesProps): Promise<SearchCoverageFilesOkResponse>;
+/**
+ * Search for files in a pipeline execution
+ */
+export declare function useSearchCoverageFilesQuery(props: SearchCoverageFilesProps, options?: Omit<UseQueryOptions<SearchCoverageFilesOkResponse, SearchCoverageFilesErrorResponse>, 'queryKey' | 'queryFn'>): import("@tanstack/react-query").UseQueryResult<SearchCoverageFilesOkResponse, import("..").Error>;

package/dist/ti-service/src/services/hooks/useSearchCoverageFilesQuery.js

@@ -0,0 +1,14 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+import { useQuery } from '@tanstack/react-query';
+import { fetcher } from '../../../../fetcher/index.js';
+export function searchCoverageFiles(props) {
+    return fetcher(Object.assign({ url: `/coverage/api/v1/accounts/${props.account_identifier}/executions/${props.execution_id}/search`, method: 'GET' }, props));
+}
+/**
+ * Search for files in a pipeline execution
+ */
+export function useSearchCoverageFilesQuery(props, options) {
+    return useQuery(['searchCoverageFiles', props.account_identifier, props.execution_id, props.queryParams], ({ signal }) => searchCoverageFiles(Object.assign(Object.assign({}, props), { signal })), options);
+}

package/dist/ti-service/src/services/index.d.ts

@@ -0,0 +1,14 @@
+export type { GetPathParamsType, ResponseWithPagination } from './helpers';
+export type { GetExecutionCoverageReportErrorResponse, GetExecutionCoverageReportOkResponse, GetExecutionCoverageReportProps, GetExecutionCoverageReportQueryPathParams, GetExecutionCoverageReportQueryQueryParams, } from './hooks/useGetExecutionCoverageReportQuery';
+export { getExecutionCoverageReport, useGetExecutionCoverageReportQuery, } from './hooks/useGetExecutionCoverageReportQuery';
+export type { SearchCoverageFilesErrorResponse, SearchCoverageFilesOkResponse, SearchCoverageFilesProps, SearchCoverageFilesQueryPathParams, SearchCoverageFilesQueryQueryParams, } from './hooks/useSearchCoverageFilesQuery';
+export { searchCoverageFiles, useSearchCoverageFilesQuery, } from './hooks/useSearchCoverageFilesQuery';
+export type { BadRequestResponse } from './responses/BadRequestResponse';
+export type { InternalErrorResponse } from './responses/InternalErrorResponse';
+export type { UnauthenticatedResponse } from './responses/UnauthenticatedResponse';
+export type { UnauthorizedResponse } from './responses/UnauthorizedResponse';
+export type { CoverageSummary } from './schemas/CoverageSummary';
+export type { Error } from './schemas/Error';
+export type { FileSummary } from './schemas/FileSummary';
+export type { ReportPipelineExecutionOutput } from './schemas/ReportPipelineExecutionOutput';
+export type { SearchResults } from './schemas/SearchResults';

package/dist/ti-service/src/services/index.js

@@ -0,0 +1,2 @@
+export { getExecutionCoverageReport, useGetExecutionCoverageReportQuery, } from './hooks/useGetExecutionCoverageReportQuery';
+export { searchCoverageFiles, useSearchCoverageFilesQuery, } from './hooks/useSearchCoverageFilesQuery';

package/dist/ti-service/src/services/responses/BadRequestResponse.d.ts

@@ -0,0 +1,2 @@
+import type { Error } from '../schemas/Error';
+export type BadRequestResponse = Error;

package/dist/ti-service/src/services/responses/BadRequestResponse.js

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

package/dist/ti-service/src/services/responses/InternalErrorResponse.d.ts

@@ -0,0 +1,2 @@
+import type { Error } from '../schemas/Error';
+export type InternalErrorResponse = Error;

package/dist/ti-service/src/services/responses/InternalErrorResponse.js

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

package/dist/ti-service/src/services/responses/UnauthenticatedResponse.d.ts

@@ -0,0 +1,2 @@
+import type { Error } from '../schemas/Error';
+export type UnauthenticatedResponse = Error;

package/dist/ti-service/src/services/responses/UnauthenticatedResponse.js

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

package/dist/ti-service/src/services/responses/UnauthorizedResponse.d.ts

@@ -0,0 +1,2 @@
+import type { Error } from '../schemas/Error';
+export type UnauthorizedResponse = Error;

package/dist/ti-service/src/services/responses/UnauthorizedResponse.js

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

package/dist/ti-service/src/services/schemas/CoverageSummary.d.ts

@@ -0,0 +1,8 @@
+export interface CoverageSummary {
+    coverage: number;
+    files: number;
+    hits: number;
+    lines: number;
+    misses: number;
+    partials: number;
+}

package/dist/ti-service/src/services/schemas/CoverageSummary.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ti-service/src/services/schemas/Error.d.ts

@@ -0,0 +1,6 @@
+export interface Error {
+    /**
+     * Details about the error encountered
+     */
+    error_msg?: string;
+}

package/dist/ti-service/src/services/schemas/Error.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/dist/ti-service/src/services/schemas/FileSummary.d.ts

@@ -0,0 +1,5 @@
+import type { CoverageSummary } from '../schemas/CoverageSummary';
+export interface FileSummary extends CoverageSummary {
+    path?: string;
+    type?: 'dir' | 'file' | 'repo';
+}

package/dist/ti-service/src/services/schemas/FileSummary.js

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

package/dist/ti-service/src/services/schemas/ReportPipelineExecutionOutput.d.ts

@@ -0,0 +1,11 @@
+import type { FileSummary } from '../schemas/FileSummary';
+import type { CoverageSummary } from '../schemas/CoverageSummary';
+export interface ReportPipelineExecutionOutput {
+    files: FileSummary[];
+    lines?: Array<number[]>;
+    path?: string;
+    summary: CoverageSummary | {
+        report_count?: number;
+    };
+    type?: 'dir' | 'file' | 'repo';
+}

package/dist/ti-service/src/services/schemas/ReportPipelineExecutionOutput.js

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

package/dist/ti-service/src/services/schemas/SearchResults.d.ts

@@ -0,0 +1,3 @@
+export interface SearchResults {
+    files: string[];
+}

package/dist/ti-service/src/services/schemas/SearchResults.js

@@ -0,0 +1,4 @@
+/* eslint-disable */
+// This code is autogenerated using @harnessio/oats-cli.
+// Please do not modify this code directly.
+export {};

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@harnessio/react-ti-service-client",
+  "version": "0.1.0",
+  "description": "Harness React TI service client - TI APIs integrated with react hooks",
+  "author": "Harness Inc",
+  "license": "MIT",
+  "source": "src/index.ts",
+  "main": "./dist/ti-service/src/index.js",
+  "exports": {
+    ".": "./dist/ti-service/src/index.js"
+  },
+  "types": "./dist/ti-service/src/index.d.ts",
+  "files": [
+    "dist/*"
+  ],
+  "homepage": "https://github.com/harness/react-api-client",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/harness/react-api-client.git"
+  },
+  "bugs": {
+    "url": "https://github.com/harness/react-api-client/issues"
+  },
+  "keywords": [],
+  "scripts": {
+    "prebuild": "rimraf dist",
+    "build": "yarn generate && tsc",
+    "generate": "oats import --config='./oats.config.ts'",
+    "fmt": "prettier --write ./index.ts"
+  }
+}