ibm-cloud-sdk-core 4.0.6 → 4.0.8

package/es/auth/authenticators/basic-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/authenticators/basic-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import extend from 'extend';
-import { computeBasicAuthHeader, validateInput } from '../utils';
+import { computeBasicAuthHeader, validateInput } from '../utils/helpers';
 import { Authenticator } from './authenticator';
 /**
  * The BasicAuthenticator is used to add basic authentication information to

package/es/auth/authenticators/bearer-token-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/authenticators/bearer-token-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import extend from 'extend';
-import { validateInput } from '../utils';
+import { validateInput } from '../utils/helpers';
 import { Authenticator } from './authenticator';
 /**
  * The BearerTokenAuthenticator will set a user-provided bearer token

package/es/auth/authenticators/cloud-pak-for-data-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { Cp4dTokenManager } from '../token-managers';
+import { Cp4dTokenManager } from '../token-managers/cp4d-token-manager';
 import { BaseOptions, TokenRequestBasedAuthenticator } from './token-request-based-authenticator';
 /** Configuration options for CloudPakForData authentication. */
 export interface Options extends BaseOptions {

package/es/auth/authenticators/cloud-pak-for-data-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { Authenticator } from './authenticator';
-import { Cp4dTokenManager } from '../token-managers';
+import { Cp4dTokenManager } from '../token-managers/cp4d-token-manager';
 import { TokenRequestBasedAuthenticator } from './token-request-based-authenticator';
 /**
  * The CloudPakForDataAuthenticator will either use a username/password pair or a username/apikey pair to obtain

package/es/auth/authenticators/container-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2021, 2022 IBM Corp. All Rights Reserved.
+ * Copyright 2021, 202e IBM Corp. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { ContainerTokenManager } from '../token-managers';
+import { ContainerTokenManager } from '../token-managers/container-token-manager';
 import { IamRequestOptions, IamRequestBasedAuthenticator } from './iam-request-based-authenticator';
 /** Configuration options for IAM authentication. */
 export interface Options extends IamRequestOptions {

package/es/auth/authenticators/container-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2021, 2022 IBM Corp. All Rights Reserved.
+ * Copyright 2021, 202e IBM Corp. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { Authenticator } from './authenticator';
-import { ContainerTokenManager } from '../token-managers';
+import { ContainerTokenManager } from '../token-managers/container-token-manager';
 import { IamRequestBasedAuthenticator } from './iam-request-based-authenticator';
 /**
  * The ContainerAuthenticator will read a compute resource token from the file system

package/es/auth/authenticators/iam-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { IamTokenManager } from '../token-managers';
+import { IamTokenManager } from '../token-managers/iam-token-manager';
 import { IamRequestOptions, IamRequestBasedAuthenticator } from './iam-request-based-authenticator';
 /** Configuration options for IAM authentication. */
 export interface Options extends IamRequestOptions {

package/es/auth/authenticators/iam-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,8 +14,8 @@
  * limitations under the License.
  */
 import { Authenticator } from './authenticator';
-import { IamTokenManager } from '../token-managers';
-import { validateInput } from '../utils';
+import { IamTokenManager } from '../token-managers/iam-token-manager';
+import { validateInput } from '../utils/helpers';
 import { IamRequestBasedAuthenticator } from './iam-request-based-authenticator';
 /**
  * The IamAuthenticator will use the user-supplied `apikey`

package/es/auth/authenticators/iam-request-based-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 202e.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { IamRequestBasedTokenManager } from '../token-managers';
+import { IamRequestBasedTokenManager } from '../token-managers/iam-request-based-token-manager';
 import { BaseOptions, TokenRequestBasedAuthenticator } from './token-request-based-authenticator';
 /** Configuration options for IAM Request based authentication. */
 export interface IamRequestOptions extends BaseOptions {

package/es/auth/authenticators/iam-request-based-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 202e.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { IamRequestBasedTokenManager } from '../token-managers';
+import { IamRequestBasedTokenManager } from '../token-managers/iam-request-based-token-manager';
 import { TokenRequestBasedAuthenticator } from './token-request-based-authenticator';
 /**
  * The IamRequestBasedAuthenticator provides shared configuration and functionality

package/es/auth/authenticators/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2021.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -29,7 +29,7 @@
  * authentication type is implemented as an Authenticator for consumption by a service.
  *
  * classes:
- *   AuthenticatorInterface: Implement this class to provide custom authentication schemes to services.
+ *   AuthenticatorInterface: Implement this interface to provide custom authentication schemes to services.
  *   Authenticator: Extend this class to provide custom authentication schemes to services.
  *   BasicAuthenticator: Authenticator for passing supplied basic authentication information to service endpoint.
  *   BearerTokenAuthenticator: Authenticator for passing supplied bearer token to service endpoint.

package/es/auth/authenticators/index.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2021.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/authenticators/token-request-based-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,7 +15,7 @@
  */
 /// <reference types="node" />
 import { OutgoingHttpHeaders } from 'http';
-import { JwtTokenManager } from '../token-managers';
+import { JwtTokenManager } from '../token-managers/jwt-token-manager';
 import { Authenticator } from './authenticator';
 import { AuthenticateOptions } from './authenticator-interface';
 /** Configuration options for token-based authentication. */

package/es/auth/authenticators/token-request-based-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import extend from 'extend';
-import { JwtTokenManager } from '../token-managers';
+import { JwtTokenManager } from '../token-managers/jwt-token-manager';
 import { Authenticator } from './authenticator';
 /**
  * Class for common functionality shared by token-request authenticators.

package/es/auth/authenticators/vpc-instance-authenticator.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2021, 2022.
+ * (C) Copyright IBM Corp. 2021, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { VpcInstanceTokenManager } from '../token-managers';
+import { VpcInstanceTokenManager } from '../token-managers/vpc-instance-token-manager';
 import { BaseOptions, TokenRequestBasedAuthenticator } from './token-request-based-authenticator';
 /** Configuration options for VpcInstance authentication. */
 export interface Options extends BaseOptions {

package/es/auth/authenticators/vpc-instance-authenticator.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2021, 2022.
+ * (C) Copyright IBM Corp. 2021, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import { Authenticator } from './authenticator';
-import { VpcInstanceTokenManager } from '../token-managers';
+import { VpcInstanceTokenManager } from '../token-managers/vpc-instance-token-manager';
 import { TokenRequestBasedAuthenticator } from './token-request-based-authenticator';
 /**
  * The VpcInstanceAuthenticator implements an authentication scheme in which it retrieves an "instance identity token"

package/es/auth/token-managers/container-token-manager.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2021, 2022 IBM Corp. All Rights Reserved.
+ * Copyright 2021, 2023 IBM Corp. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -69,5 +69,15 @@ export declare class ContainerTokenManager extends IamRequestBasedTokenManager {
      * Request an IAM token using a compute resource token.
      */
     protected requestToken(): Promise<any>;
+    /**
+     * Retrieves the CR token from a file using this search order:
+     * 1. User-specified filename (if specified)
+     * 2. Default file #1 (/var/run/secrets/tokens/vault-token)
+     * 3. Default file #2 (/var/run/secrets/tokens/sa-token)
+     * First one found wins.
+     *
+     * @returns the CR token value as a string
+     */
+    protected getCrToken(): string;
 }
 export {};

package/es/auth/token-managers/container-token-manager.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2021, 2022 IBM Corp. All Rights Reserved.
+ * Copyright 2021, 2023 IBM Corp. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -22,10 +22,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
-import logger from '../../lib/logger';
-import { atLeastOne, readCrTokenFile } from '../utils';
+import { atLeastOne } from '../utils/helpers';
+import { readCrTokenFile } from '../utils/file-reading-helpers';
 import { IamRequestBasedTokenManager } from './iam-request-based-token-manager';
-const DEFAULT_CR_TOKEN_FILEPATH = '/var/run/secrets/tokens/vault-token';
+const DEFAULT_CR_TOKEN_FILEPATH1 = '/var/run/secrets/tokens/vault-token';
+const DEFAULT_CR_TOKEN_FILEPATH2 = '/var/run/secrets/tokens/sa-token';
 /**
  * The ContainerTokenManager retrieves a compute resource token from a file on the container. This token
  * is used to perform the necessary interactions with the IAM token service to obtain and store a suitable
@@ -59,7 +60,9 @@ export class ContainerTokenManager extends IamRequestBasedTokenManager {
         if (!atLeastOne(options.iamProfileId, options.iamProfileName)) {
             throw new Error('At least one of `iamProfileName` or `iamProfileId` must be specified.');
         }
-        this.crTokenFilename = options.crTokenFilename || DEFAULT_CR_TOKEN_FILEPATH;
+        if (options.crTokenFilename) {
+            this.crTokenFilename = options.crTokenFilename;
+        }
         if (options.iamProfileName) {
             this.iamProfileName = options.iamProfileName;
         }
@@ -98,8 +101,7 @@ export class ContainerTokenManager extends IamRequestBasedTokenManager {
             requestToken: { get: () => super.requestToken }
         });
         return __awaiter(this, void 0, void 0, function* () {
-            const crToken = getCrToken(this.crTokenFilename);
-            this.formData.cr_token = crToken;
+            this.formData.cr_token = this.getCrToken();
             // these member variables can be reset, set them in the form data right
             // before making the request to ensure they're up to date
             if (this.iamProfileName) {
@@ -111,9 +113,35 @@ export class ContainerTokenManager extends IamRequestBasedTokenManager {
             return _super.requestToken.call(this);
         });
     }
-}
-function getCrToken(filename) {
-    logger.debug(`Attempting to read CR token from file: ${filename}`);
-    // moving the actual read to another file to isolate usage of node-only packages like `fs`
-    return readCrTokenFile(filename);
+    /**
+     * Retrieves the CR token from a file using this search order:
+     * 1. User-specified filename (if specified)
+     * 2. Default file #1 (/var/run/secrets/tokens/vault-token)
+     * 3. Default file #2 (/var/run/secrets/tokens/sa-token)
+     * First one found wins.
+     *
+     * @returns the CR token value as a string
+     */
+    getCrToken() {
+        try {
+            let crToken = null;
+            if (this.crTokenFilename) {
+                // If the user specified a filename, then try to read from that.
+                crToken = readCrTokenFile(this.crTokenFilename);
+            }
+            else {
+                // If no filename was specified, then try our two default filenames.
+                try {
+                    crToken = readCrTokenFile(DEFAULT_CR_TOKEN_FILEPATH1);
+                }
+                catch (err) {
+                    crToken = readCrTokenFile(DEFAULT_CR_TOKEN_FILEPATH2);
+                }
+            }
+            return crToken;
+        }
+        catch (err) {
+            throw new Error(`Error reading CR token file: ${err.toString()}`);
+        }
+    }
 }

package/es/auth/token-managers/cp4d-token-manager.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/token-managers/cp4d-token-manager.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -14,7 +14,7 @@
  * limitations under the License.
  */
 import extend from 'extend';
-import { validateInput } from '../utils';
+import { validateInput } from '../utils/helpers';
 import { JwtTokenManager } from './jwt-token-manager';
 /**
  * Token Manager of CloudPak for data.

package/es/auth/token-managers/iam-request-based-token-manager.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/token-managers/iam-request-based-token-manager.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -15,7 +15,7 @@
  */
 import extend from 'extend';
 import logger from '../../lib/logger';
-import { computeBasicAuthHeader, onlyOne, removeSuffix } from '../utils';
+import { computeBasicAuthHeader, onlyOne, removeSuffix } from '../utils/helpers';
 import { JwtTokenManager } from './jwt-token-manager';
 const CLIENT_ID_SECRET_WARNING = 'Warning: Client ID and Secret must BOTH be given, or the header will not be included.';
 const DEFAULT_IAM_URL = 'https://iam.cloud.ibm.com';

package/es/auth/token-managers/iam-token-manager.d.ts

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/token-managers/iam-token-manager.js

@@ -1,5 +1,5 @@
 /**
- * (C) Copyright IBM Corp. 2019, 2022.
+ * (C) Copyright IBM Corp. 2019, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -13,7 +13,7 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-import { validateInput } from '../utils';
+import { validateInput } from '../utils/helpers';
 import { IamRequestBasedTokenManager } from './iam-request-based-token-manager';
 /**
  * The IAMTokenManager takes an api key and performs the necessary interactions with

package/es/auth/token-managers/token-manager.d.ts

@@ -1,6 +1,6 @@
 /// <reference types="node" />
 /**
- * (C) Copyright IBM Corp. 2020, 2022.
+ * (C) Copyright IBM Corp. 2020, 2023.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/token-managers/token-manager.js

@@ -2,7 +2,7 @@
 import { stripTrailingSlash } from '../../lib/helper';
 import logger from '../../lib/logger';
 import { RequestWrapper } from '../../lib/request-wrapper';
-import { getCurrentTime } from '../utils';
+import { getCurrentTime } from '../utils/helpers';
 /**
  * A class for shared functionality for storing, and requesting tokens.
  * Intended to be used as a parent to be extended for token request management.

package/es/auth/token-managers/vpc-instance-token-manager.js

@@ -23,7 +23,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import logger from '../../lib/logger';
-import { atMostOne } from '../utils';
+import { atMostOne } from '../utils/helpers';
 import { JwtTokenManager } from './jwt-token-manager';
 const DEFAULT_IMS_ENDPOINT = 'http://169.254.169.254';
 const METADATA_SERVICE_VERSION = '2022-03-01';

package/es/auth/utils/file-reading-helpers.d.ts

@@ -1,5 +1,5 @@
 /**
- * Copyright 2021 IBM Corp. All Rights Reserved.
+ * Copyright 2021, 2023 IBM Corp. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/es/auth/utils/file-reading-helpers.js

@@ -1,5 +1,5 @@
 /**
- * Copyright 2021 IBM Corp. All Rights Reserved.
+ * Copyright 2021, 2023 IBM Corp. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
@@ -79,20 +79,16 @@ export function readCrTokenFile(filepath) {
     if (!existsSync) {
         return '';
     }
-    let token = '';
-    const fileExists = fileExistsAtPath(filepath);
-    if (fileExists) {
+    try {
+        let token = '';
+        logger.debug(`Attempting to read CR token from file: ${filepath}`);
         token = readFileSync(filepath, 'utf8');
         logger.debug(`Successfully read CR token from file: ${filepath}`);
+        return token;
     }
-    if (token === '') {
-        if (fileExists) {
-            logger.error(`Expected to read CR token from file but the file is empty: ${filepath}`);
-        }
-        else {
-            logger.error(`Expected to find CR token file but the file does not exist: ${filepath}`);
-        }
-        throw new Error(`Unable to retrieve the CR token value from file: ${filepath}`);
+    catch (err) {
+        const msg = `Error reading CR token: ${err.toString()}`;
+        logger.debug(msg);
+        throw new Error(msg);
     }
-    return token;
 }

package/es/tsdoc-metadata.json

@@ -5,7 +5,7 @@
   "toolPackages": [
     {
       "packageName": "@microsoft/api-extractor",
-      "packageVersion": "7.33.7"
+      "packageVersion": "7.34.9"
     }
   ]
 }

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

@@ -149,6 +149,7 @@ export class ContainerAuthenticator extends IamRequestBasedAuthenticator {
 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;

package/ibm-cloud-sdk-core.d.ts

@@ -567,6 +567,16 @@ export declare class ContainerTokenManager extends IamRequestBasedTokenManager {
      * Request an IAM token using a compute resource token.
      */
     protected requestToken(): Promise<any>;
+    /**
+     * Retrieves the CR token from a file using this search order:
+     * 1. User-specified filename (if specified)
+     * 2. Default file #1 (/var/run/secrets/tokens/vault-token)
+     * 3. Default file #2 (/var/run/secrets/tokens/sa-token)
+     * First one found wins.
+     *
+     * @returns the CR token value as a string
+     */
+    protected getCrToken(): string;
 }
 
 export declare const contentType: {
@@ -1138,7 +1148,7 @@ export declare const qs: {
 };
 
 /**
- * Copyright 2021 IBM Corp. All Rights Reserved.
+ * Copyright 2021, 2023 IBM Corp. All Rights Reserved.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ibm-cloud-sdk-core",
-  "version": "4.0.6",
+  "version": "4.0.8",
   "description": "Core functionality to support SDKs generated with IBM's OpenAPI SDK Generator.",
   "main": "index.js",
   "typings": "./es/index.d.ts",