@quantum-hub/qhub-api 1.0.4

package/src/api/service/api/resources/serviceApi/client/Client.ts

@@ -0,0 +1,443 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type { BaseClientOptions, BaseRequestOptions } from "../../../../BaseClient.js";
+import { type NormalizedClientOptionsWithAuth, normalizeClientOptionsWithAuth } from "../../../../BaseClient.js";
+import { mergeHeaders } from "../../../../core/headers.js";
+import * as core from "../../../../core/index.js";
+import * as environments from "../../../../environments.js";
+import { handleNonStatusCodeError } from "../../../../errors/handleNonStatusCodeError.js";
+import * as errors from "../../../../errors/index.js";
+import type * as HubService from "../../../index.js";
+
+export declare namespace ServiceApiClient {
+    export type Options = BaseClientOptions;
+
+    export interface RequestOptions extends BaseRequestOptions {}
+}
+
+export class ServiceApiClient {
+    protected readonly _options: NormalizedClientOptionsWithAuth<ServiceApiClient.Options>;
+
+    constructor(options: ServiceApiClient.Options) {
+        this._options = normalizeClientOptionsWithAuth(options);
+    }
+
+    /**
+     * Retrieves a list of all service executions.
+     * The response includes links to each service execution, allowing for further queries on their status and results.
+     *
+     * @param {ServiceApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.serviceApi.getServiceExecutions()
+     */
+    public getServiceExecutions(
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): core.HttpResponsePromise<HubService.ServiceExecution[]> {
+        return core.HttpResponsePromise.fromPromise(this.__getServiceExecutions(requestOptions));
+    }
+
+    private async __getServiceExecutions(
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): Promise<core.WithRawResponse<HubService.ServiceExecution[]>> {
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            requestOptions?.headers,
+        );
+        const _response = await core.fetcher({
+            url:
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HubServiceEnvironment.Default,
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as HubService.ServiceExecution[], rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            throw new errors.HubServiceError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/");
+    }
+
+    /**
+     * Starts a service execution, which in turn is processed asynchronously.
+     * The location header of the response contains the URL which can be used to query the status and the result of the service execution.
+     *
+     * @param {HubService.RequestBody} request
+     * @param {ServiceApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.serviceApi.startExecution({
+     *         "key": "value"
+     *     })
+     */
+    public startExecution(
+        request: HubService.RequestBody,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): core.HttpResponsePromise<HubService.ServiceExecution> {
+        return core.HttpResponsePromise.fromPromise(this.__startExecution(request, requestOptions));
+    }
+
+    private async __startExecution(
+        request: HubService.RequestBody,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): Promise<core.WithRawResponse<HubService.ServiceExecution>> {
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            requestOptions?.headers,
+        );
+        const _response = await core.fetcher({
+            url:
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                (await core.Supplier.get(this._options.environment)) ??
+                environments.HubServiceEnvironment.Default,
+            method: "POST",
+            headers: _headers,
+            contentType: "application/json",
+            queryParameters: requestOptions?.queryParams,
+            requestType: "json",
+            body: request,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as HubService.ServiceExecution, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            throw new errors.HubServiceError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "POST", "/");
+    }
+
+    /**
+     * Retrieves the status of a service execution.
+     * The status can be one of the following: UNKNOWN, PENDING, RUNNING, SUCCEEDED, CANCELLED, FAILED.
+     *
+     * @param {HubService.GetStatusRequest} request
+     * @param {ServiceApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.serviceApi.getStatus({
+     *         id: "id"
+     *     })
+     */
+    public getStatus(
+        request: HubService.GetStatusRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): core.HttpResponsePromise<HubService.ServiceExecution> {
+        return core.HttpResponsePromise.fromPromise(this.__getStatus(request, requestOptions));
+    }
+
+    private async __getStatus(
+        request: HubService.GetStatusRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): Promise<core.WithRawResponse<HubService.ServiceExecution>> {
+        const { id } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            requestOptions?.headers,
+        );
+        const _response = await core.fetcher({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.HubServiceEnvironment.Default,
+                `${core.url.encodePathParam(id)}`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as HubService.ServiceExecution, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            throw new errors.HubServiceError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/{id}");
+    }
+
+    /**
+     * Retrieves the result of a service execution.
+     * The result is returned as a JSON object containing the status and any additional data.
+     * The result may include links to download specific result files.
+     *
+     * @param {HubService.GetResultRequest} request
+     * @param {ServiceApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.serviceApi.getResult({
+     *         id: "id"
+     *     })
+     */
+    public getResult(
+        request: HubService.GetResultRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): core.HttpResponsePromise<HubService.ResultResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__getResult(request, requestOptions));
+    }
+
+    private async __getResult(
+        request: HubService.GetResultRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): Promise<core.WithRawResponse<HubService.ResultResponse>> {
+        const { id } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            requestOptions?.headers,
+        );
+        const _response = await core.fetcher({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.HubServiceEnvironment.Default,
+                `${core.url.encodePathParam(id)}/result`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as HubService.ResultResponse, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            throw new errors.HubServiceError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/{id}/result");
+    }
+
+    /**
+     * Retrieves a specific result file of a service execution.
+     * The file name is provided in the path parameter.
+     * The result file is returned as a binary stream.
+     */
+    public getResultFile(
+        request: HubService.GetResultFileRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): core.HttpResponsePromise<core.BinaryResponse> {
+        return core.HttpResponsePromise.fromPromise(this.__getResultFile(request, requestOptions));
+    }
+
+    private async __getResultFile(
+        request: HubService.GetResultFileRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): Promise<core.WithRawResponse<core.BinaryResponse>> {
+        const { id, file } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            requestOptions?.headers,
+        );
+        const _response = await core.fetcher<core.BinaryResponse>({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.HubServiceEnvironment.Default,
+                `${core.url.encodePathParam(id)}/result/${core.url.encodePathParam(file)}`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            responseType: "binary-response",
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            throw new errors.HubServiceError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/{id}/result/{file}");
+    }
+
+    /**
+     * Returns a list of log entries for a service execution in chronological order, where the first entry is the oldest.
+     *
+     * @param {HubService.GetLogsRequest} request
+     * @param {ServiceApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.serviceApi.getLogs({
+     *         id: "id"
+     *     })
+     */
+    public getLogs(
+        request: HubService.GetLogsRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): core.HttpResponsePromise<HubService.LogEntry[]> {
+        return core.HttpResponsePromise.fromPromise(this.__getLogs(request, requestOptions));
+    }
+
+    private async __getLogs(
+        request: HubService.GetLogsRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): Promise<core.WithRawResponse<HubService.LogEntry[]>> {
+        const { id } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            requestOptions?.headers,
+        );
+        const _response = await core.fetcher({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.HubServiceEnvironment.Default,
+                `${core.url.encodePathParam(id)}/log`,
+            ),
+            method: "GET",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as HubService.LogEntry[], rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            throw new errors.HubServiceError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "GET", "/{id}/log");
+    }
+
+    /**
+     * Cancel a pending or running service execution.
+     *
+     * @param {HubService.CancelExecutionRequest} request
+     * @param {ServiceApiClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @example
+     *     await client.serviceApi.cancelExecution({
+     *         id: "id"
+     *     })
+     */
+    public cancelExecution(
+        request: HubService.CancelExecutionRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): core.HttpResponsePromise<HubService.ServiceExecution> {
+        return core.HttpResponsePromise.fromPromise(this.__cancelExecution(request, requestOptions));
+    }
+
+    private async __cancelExecution(
+        request: HubService.CancelExecutionRequest,
+        requestOptions?: ServiceApiClient.RequestOptions,
+    ): Promise<core.WithRawResponse<HubService.ServiceExecution>> {
+        const { id } = request;
+        const _authRequest: core.AuthRequest = await this._options.authProvider.getAuthRequest();
+        const _headers: core.Fetcher.Args["headers"] = mergeHeaders(
+            _authRequest.headers,
+            this._options?.headers,
+            requestOptions?.headers,
+        );
+        const _response = await core.fetcher({
+            url: core.url.join(
+                (await core.Supplier.get(this._options.baseUrl)) ??
+                    (await core.Supplier.get(this._options.environment)) ??
+                    environments.HubServiceEnvironment.Default,
+                `${core.url.encodePathParam(id)}/cancel`,
+            ),
+            method: "PUT",
+            headers: _headers,
+            queryParameters: requestOptions?.queryParams,
+            timeoutMs: (requestOptions?.timeoutInSeconds ?? this._options?.timeoutInSeconds ?? 60) * 1000,
+            maxRetries: requestOptions?.maxRetries ?? this._options?.maxRetries,
+            withCredentials: true,
+            abortSignal: requestOptions?.abortSignal,
+            fetchFn: this._options?.fetch,
+            logging: this._options.logging,
+        });
+        if (_response.ok) {
+            return { data: _response.body as HubService.ServiceExecution, rawResponse: _response.rawResponse };
+        }
+
+        if (_response.error.reason === "status-code") {
+            throw new errors.HubServiceError({
+                statusCode: _response.error.statusCode,
+                body: _response.error.body,
+                rawResponse: _response.rawResponse,
+            });
+        }
+
+        return handleNonStatusCodeError(_response.error, _response.rawResponse, "PUT", "/{id}/cancel");
+    }
+}

package/src/api/service/api/resources/serviceApi/client/index.ts

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

package/src/api/service/api/resources/serviceApi/client/requests/CancelExecutionRequest.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface CancelExecutionRequest {
+    /** The id of a service execution */
+    id: string;
+}

package/src/api/service/api/resources/serviceApi/client/requests/GetLogsRequest.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface GetLogsRequest {
+    /** The id of a service execution */
+    id: string;
+}

package/src/api/service/api/resources/serviceApi/client/requests/GetResultFileRequest.ts

@@ -0,0 +1,8 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface GetResultFileRequest {
+    /** The id of a service execution */
+    id: string;
+    /** The name of the result file */
+    file: string;
+}

package/src/api/service/api/resources/serviceApi/client/requests/GetResultRequest.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface GetResultRequest {
+    /** The id of a service execution */
+    id: string;
+}

package/src/api/service/api/resources/serviceApi/client/requests/GetStatusRequest.ts

@@ -0,0 +1,12 @@
+// This file was auto-generated by Fern from our API Definition.
+
+/**
+ * @example
+ *     {
+ *         id: "id"
+ *     }
+ */
+export interface GetStatusRequest {
+    /** The id of a service execution */
+    id: string;
+}

package/src/api/service/api/resources/serviceApi/client/requests/index.ts

@@ -0,0 +1,5 @@
+export type { CancelExecutionRequest } from "./CancelExecutionRequest.js";
+export type { GetLogsRequest } from "./GetLogsRequest.js";
+export type { GetResultFileRequest } from "./GetResultFileRequest.js";
+export type { GetResultRequest } from "./GetResultRequest.js";
+export type { GetStatusRequest } from "./GetStatusRequest.js";

package/src/api/service/api/resources/serviceApi/index.ts

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

package/src/api/service/api/types/HalLink.ts

@@ -0,0 +1,20 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface HalLink {
+    /** The URL of the link */
+    href?: string | undefined;
+    /** Whether the link is templated (optional) */
+    templated?: boolean | undefined;
+    /** The media type of the link (optional) */
+    type?: string | undefined;
+    /** A URL that provides further information about the deprecation of the link (optional) */
+    deprecation?: string | undefined;
+    /** The name of the link (optional) */
+    name?: string | undefined;
+    /** A URL that provides further information about the profile of the link (optional) */
+    profile?: string | undefined;
+    /** The title of the link (optional) */
+    title?: string | undefined;
+    /** The language of the link's target resource (optional) */
+    hreflang?: string | undefined;
+}

package/src/api/service/api/types/LogEntry.ts

@@ -0,0 +1,22 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface LogEntry {
+    /** Log message content. */
+    message?: string | undefined;
+    /** Severity of the log entry. */
+    severity?: LogEntry.Severity | undefined;
+    /** Timestamp when the entry was logged. */
+    timestamp?: string | undefined;
+}
+
+export namespace LogEntry {
+    /** Severity of the log entry. */
+    export const Severity = {
+        Debug: "DEBUG",
+        Notice: "NOTICE",
+        Info: "INFO",
+        Warning: "WARNING",
+        Error: "ERROR",
+    } as const;
+    export type Severity = (typeof Severity)[keyof typeof Severity];
+}

package/src/api/service/api/types/RequestBody.ts

@@ -0,0 +1,3 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export type RequestBody = Record<string, any>;

package/src/api/service/api/types/ResultResponse.ts

@@ -0,0 +1,20 @@
+// This file was auto-generated by Fern from our API Definition.
+
+import type * as HubService from "../index.js";
+
+export interface ResultResponse {
+    _links?: ResultResponse.Links | undefined;
+    _embedded?: ResultResponse.Embedded | undefined;
+    /** Accepts any additional properties */
+    [key: string]: any;
+}
+
+export namespace ResultResponse {
+    export interface Links {
+        status?: HubService.HalLink | undefined;
+    }
+
+    export interface Embedded {
+        status?: HubService.ServiceExecution | undefined;
+    }
+}

package/src/api/service/api/types/ServiceExecution.ts

@@ -0,0 +1,41 @@
+// This file was auto-generated by Fern from our API Definition.
+
+export interface ServiceExecution {
+    /** Unique identifier of the service execution. */
+    id?: string | undefined;
+    /** Timestamp when the service execution was created. */
+    createdAt?: string | undefined;
+    /** Timestamp when the service execution started. */
+    startedAt?: string | undefined;
+    /** Timestamp when the service execution ended. */
+    endedAt?: string | undefined;
+    /** Status of the service execution. */
+    status?: ServiceExecution.Status | undefined;
+    /** Type identifier indicating whether the underlying service is a 'managed' or 'workflow' service. */
+    type?: ServiceExecution.Type | undefined;
+    /** The ID of the service for which this service execution was created. */
+    serviceId?: string | undefined;
+    /** The ID of the service definition for which this service execution was created. */
+    serviceDefinitionId?: string | undefined;
+    /** The ID of the application for which this service execution was created. */
+    applicationId?: string | undefined;
+}
+
+export namespace ServiceExecution {
+    /** Status of the service execution. */
+    export const Status = {
+        Unknown: "UNKNOWN",
+        Pending: "PENDING",
+        Running: "RUNNING",
+        Succeeded: "SUCCEEDED",
+        Cancelled: "CANCELLED",
+        Failed: "FAILED",
+    } as const;
+    export type Status = (typeof Status)[keyof typeof Status];
+    /** Type identifier indicating whether the underlying service is a 'managed' or 'workflow' service. */
+    export const Type = {
+        Managed: "MANAGED",
+        Workflow: "WORKFLOW",
+    } as const;
+    export type Type = (typeof Type)[keyof typeof Type];
+}

package/src/api/service/api/types/index.ts

@@ -0,0 +1,5 @@
+export * from "./HalLink.js";
+export * from "./LogEntry.js";
+export * from "./RequestBody.js";
+export * from "./ResultResponse.js";
+export * from "./ServiceExecution.js";