ibm-cloud-sdk-core 4.3.2-beta-1 → 4.3.2

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

@@ -0,0 +1,517 @@
+## 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_MCSP: 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;
+    static convertModel(input: any, converterFn: any, isMap?: boolean): any;
+    protected createRequest(parameters: any): Promise<any>;
+    protected createRequestAndDeserializeResponse(parameters: any, deserializerFn: (any: any) => any, isMap?: boolean): 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_2" 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_4" 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_8" 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_7" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_7);
+    protected getCrToken(): string;
+    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_3" 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_6" 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_2" 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;
+    protected isTokenExpired(): boolean;
+    // (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_5" 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 function isJsonMimeType(mimeType: 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 McspAuthenticator extends TokenRequestBasedAuthenticator {
+    // Warning: (ae-forgotten-export) The symbol "Options_12" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_12);
+    authenticationType(): string;
+    // (undocumented)
+    protected requiredOptions: string[];
+    // (undocumented)
+    protected tokenManager: McspTokenManager;
+}
+
+// @public
+export class McspTokenManager extends JwtTokenManager {
+    // Warning: (ae-forgotten-export) The symbol "Options_11" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_11);
+    // (undocumented)
+    protected requestToken(): Promise<any>;
+    // (undocumented)
+    protected requiredOptions: string[];
+}
+
+// @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
+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 isTokenExpired(): boolean;
+    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;
+    // (undocumented)
+    protected userAgent: 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
+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_10" 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_9" needs to be exported by the entry point index.d.ts
+    constructor(options: Options_9);
+    protected isTokenExpired(): boolean;
+    // (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/auth/user-temp/get-authenticator-from-environment.d.ts

@@ -1,28 +0,0 @@
-/**
- * (C) Copyright IBM Corp. 2019, 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 { Authenticator } from '../authenticators';
-/**
- * Look for external configuration of authenticator.
- *
- * Try to get authenticator from external sources, with the following priority:
- * 1. Credentials file (ibm-credentials.env)
- * 2. Environment variables
- * 3. VCAP Services (Cloud Foundry)
- *
- * @param serviceName - the service name prefix.
- *
- */
-export declare function getAuthenticatorFromEnvironment(serviceName: string): Authenticator;

package/auth/user-temp/get-authenticator-from-environment.js

@@ -1,95 +0,0 @@
-"use strict";
-/**
- * (C) Copyright IBM Corp. 2019, 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.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAuthenticatorFromEnvironment = void 0;
-var authenticators_1 = require("../authenticators");
-var read_external_sources_1 = require("./read-external-sources");
-/**
- * Look for external configuration of authenticator.
- *
- * Try to get authenticator from external sources, with the following priority:
- * 1. Credentials file (ibm-credentials.env)
- * 2. Environment variables
- * 3. VCAP Services (Cloud Foundry)
- *
- * @param serviceName - the service name prefix.
- *
- */
-function getAuthenticatorFromEnvironment(serviceName) {
-    if (!serviceName) {
-        throw new Error('Service name is required.');
-    }
-    // construct the credentials object from the environment
-    var credentials = (0, read_external_sources_1.readExternalSources)(serviceName);
-    if (credentials === null) {
-        throw new Error('Unable to create an authenticator from the environment.');
-    }
-    // remove client-level properties
-    delete credentials.url;
-    delete credentials.disableSsl;
-    // convert "auth" properties to their proper keys
-    if (credentials.authUrl) {
-        credentials.url = credentials.authUrl;
-        delete credentials.authUrl;
-    }
-    if (credentials.authDisableSsl) {
-        credentials.disableSslVerification = credentials.authDisableSsl;
-        delete credentials.authDisableSsl;
-    }
-    // in the situation where the auth type is not provided:
-    // if an apikey is provided, default to IAM
-    // if not, default to container auth
-    var authType = credentials.authType;
-    if (!authType) {
-        // Support the alternate "AUTHTYPE" config property.
-        authType = credentials.authtype;
-    }
-    if (!authType || typeof authType !== 'string') {
-        authType = credentials.apikey ? authenticators_1.Authenticator.AUTHTYPE_IAM : authenticators_1.Authenticator.AUTHTYPE_CONTAINER;
-    }
-    // Create and return the appropriate authenticator.
-    var authenticator;
-    // Compare the authType against our constants case-insensitively to
-    // determine which authenticator type needs to be constructed.
-    authType = authType.toLowerCase();
-    if (authType === authenticators_1.Authenticator.AUTHTYPE_NOAUTH.toLowerCase()) {
-        authenticator = new authenticators_1.NoAuthAuthenticator();
-    }
-    else if (authType === authenticators_1.Authenticator.AUTHTYPE_BASIC.toLowerCase()) {
-        authenticator = new authenticators_1.BasicAuthenticator(credentials);
-    }
-    else if (authType === authenticators_1.Authenticator.AUTHTYPE_BEARERTOKEN.toLowerCase()) {
-        authenticator = new authenticators_1.BearerTokenAuthenticator(credentials);
-    }
-    else if (authType === authenticators_1.Authenticator.AUTHTYPE_CP4D.toLowerCase()) {
-        authenticator = new authenticators_1.CloudPakForDataAuthenticator(credentials);
-    }
-    else if (authType === authenticators_1.Authenticator.AUTHTYPE_IAM.toLowerCase()) {
-        authenticator = new authenticators_1.IamAuthenticator(credentials);
-    }
-    else if (authType === authenticators_1.Authenticator.AUTHTYPE_CONTAINER.toLowerCase()) {
-        authenticator = new authenticators_1.ContainerAuthenticator(credentials);
-    }
-    else if (authType === authenticators_1.Authenticator.AUTHTYPE_VPC.toLowerCase()) {
-        authenticator = new authenticators_1.VpcInstanceAuthenticator(credentials);
-    }
-    else {
-        throw new Error("Invalid value for AUTH_TYPE: ".concat(authType));
-    }
-    return authenticator;
-}
-exports.getAuthenticatorFromEnvironment = getAuthenticatorFromEnvironment;

package/auth/user-temp/index.d.ts

@@ -1,25 +0,0 @@
-/**
- * (C) Copyright IBM Corp. 2019, 2021.
- *
- * 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.
- */
-/**
- * @module utils
- * Helper functions used by generated SDKs.
- *
- * functions:
- *   getAuthenticatorFromEnvironment: Get authenticator from external sources.
- *   readExternalSources: Get config object from external sources.
- */
-export { getAuthenticatorFromEnvironment } from './get-authenticator-from-environment';
-export { readExternalSources } from './read-external-sources';