ibm-cloud-sdk-core 3.2.2-beta-5 → 3.2.2

package/temp/ibm-cloud-sdk-core.api.md

@@ -0,0 +1,483 @@
+## API Report File for "ibm-cloud-sdk-core"
+
+> Do not edit this file. It is a report generated by [API Extractor](https://api-extractor.com/).
+
+```ts
+
+/// <reference types="node" />
+
+import { AxiosInstance } from 'axios';
+import type { CookieJar } from 'tough-cookie';
+import { Debugger } from 'debug';
+import { OutgoingHttpHeaders } from 'http';
+import { Stream } from 'stream';
+
+// @public
+export function atLeastOne(a: any, b: any): boolean;
+
+// @public
+export function atMostOne(a: any, b: any): boolean;
+
+// @public
+export class Authenticator implements AuthenticatorInterface {
+    constructor();
+    // Warning: (ae-forgotten-export) The symbol "AuthenticateOptions" needs to be exported by the entry point index.d.ts
+    authenticate(requestOptions: AuthenticateOptions): Promise<void>;
+    authenticationType(): string;
+    static AUTHTYPE_BASIC: string;
+    // (undocumented)
+    static AUTHTYPE_BEARERTOKEN: string;
+    // (undocumented)
+    static AUTHTYPE_CONTAINER: string;
+    // (undocumented)
+    static AUTHTYPE_CP4D: string;
+    // (undocumented)
+    static AUTHTYPE_IAM: string;
+    // (undocumented)
+    static AUTHTYPE_NOAUTH: string;
+    // (undocumented)
+    static AUTHTYPE_UNKNOWN: string;
+    // (undocumented)
+    static AUTHTYPE_VPC: string;
+}
+
+// @public
+export interface AuthenticatorInterface {
+    authenticate(requestOptions: AuthenticateOptions): Promise<void>;
+    authenticationType(): string;
+}
+
+// @public
+export class BaseService {
+    constructor(userOptions: UserOptions);
+    // Warning: (ae-forgotten-export) The symbol "BaseServiceOptions" needs to be exported by the entry point index.d.ts
+    //
+    // (undocumented)
+    protected baseOptions: BaseServiceOptions;
+    protected configureService(serviceName: string): void;
+    protected createRequest(parameters: any): Promise<any>;
+    // (undocumented)
+    static DEFAULT_SERVICE_NAME: string;
+    // (undocumented)
+    static DEFAULT_SERVICE_URL: string;
+    disableRetries(): void;
+    // Warning: (ae-forgotten-export) The symbol "RetryOptions" needs to be exported by the entry point index.d.ts
+    enableRetries(retryOptions?: RetryOptions): void;
+    getAuthenticator(): any;
+    getHttpClient(): AxiosInstance;
+    setDefaultHeaders(headers: OutgoingHttpHeaders): void;
+    setEnableGzipCompression(setting: boolean): void;
+    setServiceUrl(url: string): void;
+}
+
+// @public
+export class BasicAuthenticator extends Authenticator {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options);
+    authenticate(requestOptions: AuthenticateOptions): Promise<void>;
+    authenticationType(): string;
+    // (undocumented)
+    protected authHeader: {
+        Authorization: string;
+    };
+    // (undocumented)
+    protected requiredOptions: string[];
+}
+
+// @public
+export class BearerTokenAuthenticator extends Authenticator {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_2);
+    authenticate(requestOptions: AuthenticateOptions): Promise<void>;
+    authenticationType(): string;
+    // (undocumented)
+    protected requiredOptions: string[];
+    setBearerToken(bearerToken: string): void;
+}
+
+// @public
+export function buildRequestFileObject(fileParam: FileWithMetadata): Promise<FileObject>;
+
+// @public
+export function checkCredentials(obj: any, credsToCheck: string[]): Error | null;
+
+// @public
+function checkForSuccessfulExecution(createRequestMock: any): void;
+
+// @public
+function checkMediaHeaders(createRequestMock: any, accept: string, contentType: string): void;
+
+// @public
+function checkUrlAndMethod(options: any, url: string, method: any): void;
+
+// @public
+function checkUserHeader(createRequestMock: any, userHeaderName: string, userHeaderValue: string): void;
+
+// @public
+export class CloudPakForDataAuthenticator extends TokenRequestBasedAuthenticator {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_4);
+    authenticationType(): string;
+    // (undocumented)
+    protected requiredOptions: string[];
+    // (undocumented)
+    protected tokenManager: Cp4dTokenManager;
+}
+
+// @public
+export function computeBasicAuthHeader(username: string, password: string): string;
+
+// @public (undocumented)
+export function constructFilepath(filepath: string): string;
+
+// @public
+export function constructServiceUrl(parameterizedUrl: string, defaultUrlVariables: Map<string, string>, providedUrlVariables: Map<string, string> | null): string;
+
+// @public
+export class ContainerAuthenticator extends IamRequestBasedAuthenticator {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_8);
+    authenticationType(): string;
+    setCrTokenFilename(crTokenFilename: string): void;
+    setIamProfileId(iamProfileId: string): void;
+    setIamProfileName(iamProfileName: string): void;
+    // (undocumented)
+    protected tokenManager: ContainerTokenManager;
+}
+
+// @public
+export class ContainerTokenManager extends IamRequestBasedTokenManager {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_7);
+    protected requestToken(): Promise<any>;
+    setCrTokenFilename(crTokenFilename: string): void;
+    setIamProfileId(iamProfileId: string): void;
+    setIamProfileName(iamProfileName: string): void;
+}
+
+// @public (undocumented)
+export const contentType: {
+    fromFilename: (file: String | File | FileObject | NodeJS.ReadableStream | Buffer) => string;
+    fromHeader: (buffer: Buffer) => string;
+};
+
+// @public
+export class Cp4dTokenManager extends JwtTokenManager {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_3);
+    // (undocumented)
+    protected requestToken(): Promise<any>;
+    // (undocumented)
+    protected requiredOptions: string[];
+}
+
+// @public
+function expectToBePromise(sdkPromise: any): void;
+
+// @public (undocumented)
+export function fileExistsAtPath(filepath: string): boolean;
+
+// @public
+export interface FileObject {
+    // (undocumented)
+    options?: FileOptions;
+    // (undocumented)
+    value: NodeJS.ReadableStream | Buffer | string;
+}
+
+// @public (undocumented)
+export interface FileOptions {
+    // (undocumented)
+    contentType?: string;
+    // (undocumented)
+    filename?: string;
+}
+
+// @public (undocumented)
+export interface FileStream extends NodeJS.ReadableStream {
+    // (undocumented)
+    path: string | Buffer;
+}
+
+// @public (undocumented)
+export interface FileWithMetadata {
+    // (undocumented)
+    contentType: string;
+    // (undocumented)
+    data: NodeJS.ReadableStream | Buffer;
+    // (undocumented)
+    filename: string;
+}
+
+// @public
+export function getAuthenticatorFromEnvironment(serviceName: string): Authenticator;
+
+// @public
+export function getContentType(inputData: NodeJS.ReadableStream | Buffer): Promise<string>;
+
+// @public
+export function getCurrentTime(): number;
+
+// @public
+export function getFormat(params: {
+    [key: string]: any;
+}, formats: string[]): string;
+
+// @public
+export function getMissingParams(params: {
+    [key: string]: any;
+}, requires: string[]): null | Error;
+
+// @public
+export function getNewLogger(moduleName: string): SDKLogger;
+
+// @public
+function getOptions(createRequestMock: any): any;
+
+// @public
+export function getQueryParam(urlStr: string, param: string): string;
+
+// @public
+export class IamAuthenticator extends IamRequestBasedAuthenticator {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_6);
+    authenticationType(): string;
+    // (undocumented)
+    protected requiredOptions: string[];
+    // (undocumented)
+    protected tokenManager: IamTokenManager;
+}
+
+// @public
+export class IamRequestBasedAuthenticator extends TokenRequestBasedAuthenticator {
+    // Warning: (ae-forgotten-export) The symbol "IamRequestOptions" needs to be exported by the entry point index.d.ts
+    constructor(options: IamRequestOptions_2);
+    // (undocumented)
+    protected clientId: string;
+    // (undocumented)
+    protected clientSecret: string;
+    getRefreshToken(): string;
+    // (undocumented)
+    protected scope: string;
+    setClientIdAndSecret(clientId: string, clientSecret: string): void;
+    setScope(scope: string): void;
+    // (undocumented)
+    protected tokenManager: IamRequestBasedTokenManager;
+}
+
+// @public
+export class IamRequestBasedTokenManager extends JwtTokenManager {
+    constructor(options: IamRequestOptions);
+    // (undocumented)
+    protected formData: any;
+    getRefreshToken(): string;
+    // (undocumented)
+    protected refreshToken: string;
+    protected requestToken(): Promise<any>;
+    protected saveTokenInfo(tokenResponse: any): void;
+    setClientIdAndSecret(clientId: string, clientSecret: string): void;
+    setScope(scope: string): void;
+}
+
+// @public
+export interface IamRequestOptions extends JwtTokenManagerOptions {
+    // (undocumented)
+    clientId?: string;
+    // (undocumented)
+    clientSecret?: string;
+    // (undocumented)
+    scope?: string;
+}
+
+// @public
+export class IamTokenManager extends IamRequestBasedTokenManager {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_5);
+    // (undocumented)
+    protected requiredOptions: string[];
+}
+
+// @public (undocumented)
+export function isEmptyObject(obj: any): boolean;
+
+// @public (undocumented)
+export function isFileData(obj: any): obj is NodeJS.ReadableStream | Buffer;
+
+// @public (undocumented)
+export function isFileWithMetadata(obj: any): obj is FileWithMetadata;
+
+// @public
+export function isHTML(text: string): boolean;
+
+// @public
+export class JwtTokenManager extends TokenManager {
+    constructor(options: JwtTokenManagerOptions);
+    protected requestToken(): Promise<any>;
+    protected saveTokenInfo(tokenResponse: any): void;
+    // (undocumented)
+    protected tokenInfo: any;
+    // (undocumented)
+    protected tokenName: string;
+}
+
+// @public
+export type JwtTokenManagerOptions = TokenManagerOptions;
+
+// @public
+export class NoAuthAuthenticator extends Authenticator {
+    // (undocumented)
+    authenticate(requestOptions: AuthenticateOptions): Promise<void>;
+    authenticationType(): string;
+}
+
+// @public
+export function onlyOne(a: any, b: any): boolean;
+
+// @public
+export const qs: {
+    stringify: (queryParams: Object) => string;
+};
+
+// @public
+export function readCredentialsFile(): any;
+
+// @public (undocumented)
+export function readCrTokenFile(filepath: string): string;
+
+// @public
+export function readExternalSources(serviceName: string): any;
+
+// @public
+export function removeSuffix(str: string, suffix: string): string;
+
+// @public (undocumented)
+export interface SDKLogger {
+    // (undocumented)
+    debug: Debugger;
+    // (undocumented)
+    error: Debugger;
+    // (undocumented)
+    info: Debugger;
+    // (undocumented)
+    verbose: Debugger;
+    // (undocumented)
+    warn: Debugger;
+}
+
+// @public
+export function streamToPromise(stream: Stream): Promise<any>;
+
+// @public (undocumented)
+export function stripTrailingSlash(url: string): string;
+
+// @public
+export class TokenManager {
+    constructor(options: TokenManagerOptions);
+    // (undocumented)
+    protected accessToken: string;
+    // (undocumented)
+    protected disableSslVerification: boolean;
+    // (undocumented)
+    protected expireTime: number;
+    getToken(): Promise<any>;
+    // (undocumented)
+    protected headers: OutgoingHttpHeaders;
+    protected pacedRequestToken(): Promise<any>;
+    // (undocumented)
+    protected refreshTime: number;
+    protected requestToken(): Promise<any>;
+    // Warning: (ae-forgotten-export) The symbol "RequestWrapper" needs to be exported by the entry point index.d.ts
+    //
+    // (undocumented)
+    protected requestWrapperInstance: RequestWrapper;
+    protected saveTokenInfo(tokenResponse: any): void;
+    setDisableSslVerification(value: boolean): void;
+    setHeaders(headers: OutgoingHttpHeaders): void;
+    // (undocumented)
+    protected url: string;
+}
+
+// @public
+export type TokenManagerOptions = {
+    url?: string;
+    headers?: OutgoingHttpHeaders;
+    disableSslVerification?: boolean;
+    [propName: string]: any;
+};
+
+// @public
+export class TokenRequestBasedAuthenticator extends Authenticator {
+    // Warning: (ae-forgotten-export) The symbol "BaseOptions" needs to be exported by the entry point index.d.ts
+    constructor(options: BaseOptions);
+    authenticate(requestOptions: AuthenticateOptions): Promise<void>;
+    // (undocumented)
+    protected disableSslVerification: boolean;
+    // (undocumented)
+    protected headers: OutgoingHttpHeaders;
+    setDisableSslVerification(value: boolean): void;
+    setHeaders(headers: OutgoingHttpHeaders): void;
+    // (undocumented)
+    protected tokenManager: JwtTokenManager;
+    // (undocumented)
+    protected url: string;
+}
+
+// @public
+export function toLowerKeys(obj: Object): Object;
+
+declare namespace unitTestUtils {
+    export {
+        checkUrlAndMethod,
+        checkMediaHeaders,
+        checkUserHeader,
+        checkForSuccessfulExecution,
+        getOptions,
+        expectToBePromise
+    }
+}
+export { unitTestUtils }
+
+// @public
+export interface UserOptions {
+    [propName: string]: any;
+    authenticator?: AuthenticatorInterface;
+    disableSslVerification?: boolean;
+    headers?: OutgoingHttpHeaders;
+    jar?: CookieJar | boolean;
+    serviceUrl?: string;
+    url?: string;
+    version?: string;
+}
+
+// @public (undocumented)
+export function validateInput(options: any, requiredOptions: string[]): void;
+
+// @public
+export function validateParams(params: {
+    [key: string]: any;
+}, requiredParams: string[], allParams: string[]): null | Error;
+
+// @public
+export class VpcInstanceAuthenticator extends TokenRequestBasedAuthenticator {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_10);
+    authenticationType(): string;
+    setIamProfileCrn(iamProfileCrn: string): void;
+    setIamProfileId(iamProfileId: string): void;
+    // (undocumented)
+    protected tokenManager: VpcInstanceTokenManager;
+}
+
+// @public
+export class VpcInstanceTokenManager extends JwtTokenManager {
+    // Warning: (ae-forgotten-export) The symbol "Options" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_9);
+    // (undocumented)
+    protected requestToken(): Promise<any>;
+    setIamProfileCrn(iamProfileCrn: string): void;
+    setIamProfileId(iamProfileId: string): void;
+}
+
+// (No @packageDocumentation comment for this package)
+
+```

package/tsconfig-es6.json

@@ -0,0 +1,9 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "target": "ES6",
+    "module": "ESNext",
+    "outDir": "./dist/es",
+    "declaration": true
+  }
+}

package/es/lib/cookie-support.d.ts

@@ -1,23 +0,0 @@
-/**
- * (C) Copyright IBM Corp. 2022.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { AxiosRequestConfig, AxiosResponse } from 'axios';
-import { CookieJar } from 'tough-cookie';
-export declare class CookieInterceptor {
-    private readonly cookieJar;
-    constructor(cookieJar: CookieJar | boolean);
-    requestInterceptor(config: AxiosRequestConfig): Promise<AxiosRequestConfig<any>>;
-    responseInterceptor(response: AxiosResponse): Promise<AxiosResponse<any, any>>;
-}

package/es/lib/cookie-support.js

@@ -1,86 +0,0 @@
-/**
- * (C) Copyright IBM Corp. 2022.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-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());
-    });
-};
-import extend from 'extend';
-import { CookieJar } from 'tough-cookie';
-import logger from './logger';
-export class CookieInterceptor {
-    constructor(cookieJar) {
-        if (cookieJar) {
-            if (cookieJar === true) {
-                logger.debug('CookieInterceptor: creating new CookieJar');
-                this.cookieJar = new CookieJar();
-            }
-            else {
-                logger.debug('CookieInterceptor: using supplied CookieJar');
-                this.cookieJar = cookieJar;
-            }
-        }
-        else {
-            throw new Error('Must supply a cookie jar or true.');
-        }
-    }
-    requestInterceptor(config) {
-        return __awaiter(this, void 0, void 0, function* () {
-            logger.debug('CookieInterceptor: intercepting request');
-            if (config && config.url) {
-                logger.debug(`CookieInterceptor: getting cookies for: ${config.url}`);
-                const cookieHeaderValue = yield this.cookieJar.getCookieString(config.url);
-                if (cookieHeaderValue) {
-                    logger.debug('CookieInterceptor: setting cookie header');
-                    const cookieHeader = { cookie: cookieHeaderValue };
-                    config.headers = extend(true, {}, config.headers, cookieHeader);
-                }
-                else {
-                    logger.debug(`CookieInterceptor: no cookies for: ${config.url}`);
-                }
-            }
-            else {
-                logger.debug('CookieInterceptor: no request URL.');
-            }
-            return config;
-        });
-    }
-    responseInterceptor(response) {
-        return __awaiter(this, void 0, void 0, function* () {
-            logger.debug('CookieInterceptor: intercepting response.');
-            if (response && response.headers) {
-                logger.debug('CookieInterceptor: checking for set-cookie headers.');
-                const cookies = response.headers['set-cookie'];
-                if (cookies) {
-                    logger.debug(`CookieInterceptor: setting cookies in jar for URL ${response.config.url}.`);
-                    // Write cookies sequentially by chaining the promises in a reduce
-                    yield cookies.reduce((cookiePromise, cookie) => cookiePromise.then(() => this.cookieJar.setCookie(cookie, response.config.url)), Promise.resolve(null));
-                }
-                else {
-                    logger.debug('CookieInterceptor: no set-cookie headers.');
-                }
-            }
-            else {
-                logger.debug('CookieInterceptor: no response headers.');
-            }
-            return response;
-        });
-    }
-}

package/lib/cookie-support.d.ts

@@ -1,23 +0,0 @@
-/**
- * (C) Copyright IBM Corp. 2022.
- *
- * Licensed under the Apache License, Version 2.0 (the "License");
- * you may not use this file except in compliance with the License.
- * You may obtain a copy of the License at
- *
- *      http://www.apache.org/licenses/LICENSE-2.0
- *
- * Unless required by applicable law or agreed to in writing, software
- * distributed under the License is distributed on an "AS IS" BASIS,
- * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
- * See the License for the specific language governing permissions and
- * limitations under the License.
- */
-import { AxiosRequestConfig, AxiosResponse } from 'axios';
-import { CookieJar } from 'tough-cookie';
-export declare class CookieInterceptor {
-    private readonly cookieJar;
-    constructor(cookieJar: CookieJar | boolean);
-    requestInterceptor(config: AxiosRequestConfig): Promise<AxiosRequestConfig<any>>;
-    responseInterceptor(response: AxiosResponse): Promise<AxiosResponse<any, any>>;
-}