tntd 1.4.29 → 1.4.30

package/common/temp/rush-recycler/install-run-1678274025679/@rushstack/node-core-library/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.32.0"
+    }
+  ]
+}

package/common/temp/rush-recycler/install-run-1678274025679/@rushstack/package-deps-hash/dist/package-deps-hash.d.ts

@@ -0,0 +1,80 @@
+/**
+ * This package builds a JSON object containing the git hashes of all files used to produce a given NPM package.
+ * The {@link https://rushjs.io/ | Rush} tool uses this library to implement incremental build detection.
+ *
+ * @remarks
+ *
+ * For more info, please see the package {@link https://www.npmjs.com/package/@rushstack/package-deps-hash
+ * | README}.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Checks the git version and throws an error if it is less than the minimum required version.
+ *
+ * @public
+ */
+export declare function ensureGitMinimumVersion(gitPath?: string): void;
+
+/**
+ * Takes a list of files and returns the current git hashes for them
+ *
+ * @public
+ */
+export declare function getGitHashForFiles(filesToHash: string[], packagePath: string, gitPath?: string): Map<string, string>;
+
+/**
+ * Builds an object containing hashes for the files under the specified `packagePath` folder.
+ * @param packagePath - The folder path to derive the package dependencies from. This is typically the folder
+ *                      containing package.json.  If omitted, the default value is the current working directory.
+ * @param excludedPaths - An optional array of file path exclusions. If a file should be omitted from the list
+ *                         of dependencies, use this to exclude it.
+ * @returns the package-deps.json file content
+ *
+ * @public
+ */
+export declare function getPackageDeps(packagePath?: string, excludedPaths?: string[], gitPath?: string): Map<string, string>;
+
+/**
+ * Find all changed files tracked by Git, their current hashes, and the nature of the change. Only useful if all changes are staged or committed.
+ * @param currentWorkingDirectory - The working directory. Only used to find the repository root.
+ * @param revision - The Git revision specifier to detect changes relative to. Defaults to HEAD (i.e. will compare staged vs. committed)
+ *   If comparing against a different branch, call `git merge-base` first to find the target commit.
+ * @param gitPath - The path to the Git executable
+ * @returns A map from the Git file path to the corresponding file change metadata
+ * @beta
+ */
+export declare function getRepoChanges(currentWorkingDirectory: string, revision?: string, gitPath?: string): Map<string, IFileDiffStatus>;
+
+/**
+ * Finds the root of the current Git repository
+ *
+ * @param currentWorkingDirectory - The working directory for which to locate the repository
+ * @param gitPath - The path to the Git executable
+ *
+ * @returns The full path to the root directory of the Git repository
+ * @beta
+ */
+export declare function getRepoRoot(currentWorkingDirectory: string, gitPath?: string): string;
+
+/**
+ * Gets the object hashes for all files in the Git repo, combining the current commit with working tree state.
+ * @param currentWorkingDirectory - The working directory. Only used to find the repository root.
+ * @param gitPath - The path to the Git executable
+ * @beta
+ */
+export declare function getRepoState(currentWorkingDirectory: string, gitPath?: string): Map<string, string>;
+
+/**
+ * Information about the changes to a file.
+ * @beta
+ */
+export declare interface IFileDiffStatus {
+    mode: string;
+    oldhash: string;
+    newhash: string;
+    status: 'A' | 'D' | 'M';
+}
+
+export { }

package/common/temp/rush-recycler/install-run-1678274025679/@rushstack/package-deps-hash/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.33.3"
+    }
+  ]
+}

package/common/temp/rush-recycler/install-run-1678274025679/@rushstack/rig-package/dist/rig-package.d.ts

@@ -0,0 +1,198 @@
+/**
+ * A system for sharing tool configurations between projects without duplicating config files.
+ *
+ * @remarks
+ * The `config/rig.json` file is a system that Node.js build tools can support, in order to eliminate
+ * duplication of config files when many projects share a common configuration.  This is particularly valuable
+ * in a setup where hundreds of projects may be built using a small set of reusable recipes.
+ *
+ * @packageDocumentation
+ */
+
+/**
+ * Options for {@link RigConfig.loadForProjectFolder}.
+ *
+ * @public
+ */
+export declare interface ILoadForProjectFolderOptions {
+    /**
+     * The path to the folder of the project to be analyzed.  This folder should contain a `package.json` file.
+     */
+    projectFolderPath: string;
+    /**
+     * If specified, instead of loading the `config/rig.json` from disk, this object will be substituted instead.
+     */
+    overrideRigJsonObject?: IRigConfigJson;
+    /**
+     * If specified, force a fresh load instead of returning a cached entry, if one existed.
+     */
+    bypassCache?: boolean;
+}
+
+/**
+ * Represents the literal contents of the `config/rig.json` file.
+ *
+ * @public
+ */
+export declare interface IRigConfigJson {
+    /**
+     * The name of the rig package to use.
+     *
+     * @remarks
+     * The name must be a valid NPM package name, and must end with the `-rig` suffix.
+     *
+     * Example: `example-rig`
+     */
+    rigPackageName: string;
+    /**
+     * Specify which rig profile to use from the rig package.
+     *
+     * @remarks
+     * The name must consist of lowercase alphanumeric words separated by hyphens, for example `"sample-profile"`.
+     * If the `"rigProfile"` is not specified, then the profile name `"default"` will be used.
+     *
+     * Example: `example-profile`
+     */
+    rigProfile?: string;
+}
+
+/**
+ * This is the main API for loading the `config/rig.json` file format.
+ *
+ * @public
+ */
+export declare class RigConfig {
+    private static readonly _packageNameRegExp;
+    private static readonly _rigNameRegExp;
+    private static readonly _profileNameRegExp;
+    /**
+     * Returns the absolute path of the `rig.schema.json` JSON schema file for `config/rig.json`,
+     * which is bundled with this NPM package.
+     *
+     * @remarks
+     * The `RigConfig` class already performs schema validation when loading `rig.json`; however
+     * this schema file may be useful for integration with other validation tools.
+     *
+     * @public
+     */
+    static jsonSchemaPath: string;
+    private static _jsonSchemaObject;
+    private static readonly _configCache;
+    /**
+     * The project folder path that was passed to {@link RigConfig.loadForProjectFolder},
+     * which maybe an absolute or relative path.
+     *
+     * @remarks
+     * Example: `.`
+     */
+    readonly projectFolderOriginalPath: string;
+    /**
+     * The absolute path for the project folder path that was passed to {@link RigConfig.loadForProjectFolder}.
+     *
+     * @remarks
+     * Example: `/path/to/your-project`
+     */
+    readonly projectFolderPath: string;
+    /**
+     * Returns `true` if `config/rig.json` was found, or `false` otherwise.
+     */
+    readonly rigFound: boolean;
+    /**
+     * The full path to the `rig.json` file that was found, or `""` if none was found.
+     *
+     * @remarks
+     * Example: `/path/to/your-project/config/rig.json`
+     */
+    readonly filePath: string;
+    /**
+     * The `"rigPackageName"` field from `rig.json`, or `""` if the file was not found.
+     *
+     * @remarks
+     * The name must be a valid NPM package name, and must end with the `-rig` suffix.
+     *
+     * Example: `example-rig`
+     */
+    readonly rigPackageName: string;
+    /**
+     * The `"rigProfile"` value that was loaded from `rig.json`, or `""` if the file was not found.
+     *
+     * @remarks
+     * The name must consist of lowercase alphanumeric words separated by hyphens, for example `"sample-profile"`.
+     * If the `rig.json` file exists, but the `"rigProfile"` is not specified, then the profile
+     * name will be `"default"`.
+     *
+     * Example: `example-profile`
+     */
+    readonly rigProfile: string;
+    /**
+     * The relative path to the rig profile specified by `rig.json`, or `""` if the file was not found.
+     *
+     * @remarks
+     * Example: `profiles/example-profile`
+     */
+    readonly relativeProfileFolderPath: string;
+    private _resolvedRigPackageFolder;
+    private _resolvedProfileFolder;
+    private constructor();
+    /**
+     * The JSON contents of the {@link RigConfig.jsonSchemaPath} file.
+     *
+     * @remarks
+     * The JSON object will be lazily loaded when this property getter is accessed, and the result
+     * will be cached.
+     * Accessing this property may make a synchronous filesystem call.
+     */
+    static get jsonSchemaObject(): object;
+    /**
+     * Use this method to load the `config/rig.json` file for a given project.
+     *
+     * @remarks
+     * If the file cannot be found, an empty `RigConfig` object will be returned with {@link RigConfig.rigFound}
+     * equal to `false`.
+     */
+    static loadForProjectFolder(options: ILoadForProjectFolderOptions): RigConfig;
+    /**
+     * An async variant of {@link RigConfig.loadForProjectFolder}
+     */
+    static loadForProjectFolderAsync(options: ILoadForProjectFolderOptions): Promise<RigConfig>;
+    private static _handleConfigError;
+    /**
+     * Performs Node.js module resolution to locate the rig package folder, then returns the absolute path
+     * of the rig profile folder specified by `rig.json`.
+     *
+     * @remarks
+     * If no `rig.json` file was found, then this method throws an error.  The first time this method
+     * is called, the result is cached and will be returned by all subsequent calls.
+     *
+     * Example: `/path/to/your-project/node_modules/example-rig/profiles/example-profile`
+     */
+    getResolvedProfileFolder(): string;
+    /**
+     * An async variant of {@link RigConfig.getResolvedProfileFolder}
+     */
+    getResolvedProfileFolderAsync(): Promise<string>;
+    /**
+     * This lookup first checks for the specified relative path under `projectFolderPath`; if it does
+     * not exist there, then it checks in the resolved rig profile folder.  If the file is found,
+     * its absolute path is returned. Otherwise, `undefined` is returned.
+     *
+     * @remarks
+     * For example, suppose the rig profile is:
+     *
+     * `/path/to/your-project/node_modules/example-rig/profiles/example-profile`
+     *
+     * And suppose `configFileRelativePath` is `folder/file.json`. Then the following locations will be checked:
+     *
+     * `/path/to/your-project/folder/file.json`
+     *
+     * `/path/to/your-project/node_modules/example-rig/profiles/example-profile/folder/file.json`
+     */
+    tryResolveConfigFilePath(configFileRelativePath: string): string | undefined;
+    /**
+     * An async variant of {@link RigConfig.tryResolveConfigFilePath}
+     */
+    tryResolveConfigFilePathAsync(configFileRelativePath: string): Promise<string | undefined>;
+    private static _validateSchema;
+}
+
+export { }

package/common/temp/rush-recycler/install-run-1678274025679/@rushstack/rig-package/dist/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.32.0"
+    }
+  ]
+}

package/common/temp/rush-recycler/install-run-1678274025679/@rushstack/rush-amazon-s3-build-cache-plugin/dist/rush-amazon-s3-build-cache-plugin.d.ts

@@ -0,0 +1,150 @@
+/// <reference types="node" />
+
+import * as fetch from 'node-fetch';
+import type { IRushPlugin } from '@rushstack/rush-sdk';
+import { ITerminal } from '@rushstack/node-core-library';
+import type { RushConfiguration } from '@rushstack/rush-sdk';
+import type { RushSession } from '@rushstack/rush-sdk';
+
+/**
+ * A helper for reading and updating objects on Amazon S3
+ *
+ * @public
+ */
+export declare class AmazonS3Client {
+    private readonly _credentials;
+    private readonly _s3Endpoint;
+    private readonly _s3Region;
+    private readonly _webClient;
+    private readonly _terminal;
+    constructor(credentials: IAmazonS3Credentials | undefined, options: IAmazonS3BuildCacheProviderOptionsAdvanced, webClient: WebClient, terminal: ITerminal);
+    static UriEncode(input: string): string;
+    static tryDeserializeCredentials(credentialString: string | undefined): IAmazonS3Credentials | undefined;
+    getObjectAsync(objectName: string): Promise<Buffer | undefined>;
+    uploadObjectAsync(objectName: string, objectBuffer: Buffer): Promise<void>;
+    private _writeDebugLine;
+    private _writeWarningLine;
+    private _makeRequestAsync;
+    _getSha256Hmac(key: string | Buffer, data: string): Buffer;
+    _getSha256Hmac(key: string | Buffer, data: string, encoding: 'hex'): string;
+    private _getSha256;
+    private _getIsoDateString;
+    private _safeReadResponseText;
+    private _getS3ErrorAsync;
+    /**
+     * Validates a S3 endpoint which is http(s):// + hostname + port. Hostname validated according to RFC 1123
+     * {@link https://docs.aws.amazon.com/general/latest/gr/s3.html}
+     */
+    private _validateEndpoint;
+    private _sendCacheRequestWithRetries;
+}
+
+/**
+ * Advanced options where user has the specify the full http endpoint
+ * @public
+ */
+export declare interface IAmazonS3BuildCacheProviderOptionsAdvanced extends IAmazonS3BuildCacheProviderOptionsBase {
+    s3Endpoint: string;
+}
+
+/**
+ * @public
+ */
+export declare interface IAmazonS3BuildCacheProviderOptionsBase {
+    s3Region: string;
+    s3Prefix: string | undefined;
+    isCacheWriteAllowed: boolean;
+}
+
+/**
+ * Simple options where user only provides the bucket and the endpoint is automatically built
+ * @public
+ */
+export declare interface IAmazonS3BuildCacheProviderOptionsSimple extends IAmazonS3BuildCacheProviderOptionsBase {
+    s3Bucket: string;
+}
+
+/**
+ * Credentials for authorizing and signing requests to an Amazon S3 endpoint.
+ *
+ * @public
+ */
+export declare interface IAmazonS3Credentials {
+    accessKeyId: string;
+    secretAccessKey: string;
+    sessionToken: string | undefined;
+}
+
+/**
+ * For use with {@link WebClient}.
+ *
+ * @public
+ */
+export declare interface IGetFetchOptions extends IWebFetchOptionsBase {
+    verb: 'GET' | never;
+}
+
+/**
+ * For use with {@link WebClient}.
+ *
+ * @public
+ */
+export declare interface IPutFetchOptions extends IWebFetchOptionsBase {
+    verb: 'PUT';
+    body?: Buffer;
+}
+
+/**
+ * For use with {@link WebClient}.
+ *
+ * @public
+ */
+declare interface IWebFetchOptionsBase {
+    timeoutMs?: number;
+    verb?: 'GET' | 'PUT';
+    headers?: fetch.Headers;
+}
+
+/**
+ * @public
+ */
+declare class RushAmazonS3BuildCachePlugin implements IRushPlugin {
+    pluginName: string;
+    apply(rushSession: RushSession, rushConfig: RushConfiguration): void;
+}
+export default RushAmazonS3BuildCachePlugin;
+
+/**
+ * A helper for issuing HTTP requests.
+ *
+ * @public
+ */
+export declare class WebClient {
+    readonly standardHeaders: fetch.Headers;
+    accept: string | undefined;
+    userAgent: string | undefined;
+    proxy: WebClientProxy;
+    constructor();
+    static mergeHeaders(target: fetch.Headers, source: fetch.Headers): void;
+    addBasicAuthHeader(userName: string, password: string): void;
+    fetchAsync(url: string, options?: IGetFetchOptions | IPutFetchOptions): Promise<WebClientResponse>;
+}
+
+/**
+ * For use with {@link WebClient}.
+ * @public
+ */
+declare enum WebClientProxy {
+    None = 0,
+    Detect = 1,
+    Fiddler = 2
+}
+
+/**
+ * For use with {@link WebClient}.
+ *
+ * @public
+ */
+export declare type WebClientResponse = fetch.Response;
+
+export { }

package/common/temp/rush-recycler/install-run-1678274025679/@rushstack/rush-azure-storage-build-cache-plugin/dist/rush-azure-storage-build-cache-plugin.d.ts

@@ -0,0 +1,93 @@
+import { AzureAuthorityHosts } from '@azure/identity';
+import { DeviceCodeCredential } from '@azure/identity';
+import type { IRushPlugin } from '@rushstack/rush-sdk';
+import type { ITerminal } from '@rushstack/node-core-library';
+import type { RushConfiguration } from '@rushstack/rush-sdk';
+import type { RushSession } from '@rushstack/rush-sdk';
+
+/**
+ * @public
+ */
+export declare abstract class AzureAuthenticationBase {
+    protected abstract readonly _credentialNameForCache: string;
+    protected abstract readonly _credentialKindForLogging: string;
+    protected abstract readonly _credentialUpdateCommandForLogging: string | undefined;
+    protected readonly _azureEnvironment: AzureEnvironmentName;
+    private __credentialCacheId;
+    private get _credentialCacheId();
+    constructor(options: IAzureAuthenticationBaseOptions);
+    updateCachedCredentialAsync(terminal: ITerminal, credential: string): Promise<void>;
+    /**
+     * Launches an interactive flow to renew a cached credential.
+     *
+     * @param terminal - The terminal to log output to
+     * @param onlyIfExistingCredentialExpiresAfter - If specified, and a cached credential exists that is still valid
+     * after the date specified, no action will be taken.
+     */
+    updateCachedCredentialInteractiveAsync(terminal: ITerminal, onlyIfExistingCredentialExpiresAfter?: Date): Promise<void>;
+    deleteCachedCredentialsAsync(terminal: ITerminal): Promise<void>;
+    tryGetCachedCredentialAsync(doNotThrowIfExpired?: boolean): Promise<string | undefined>;
+    /**
+     * Get parts of the cache ID that are specific to the credential type. Note that this should
+     * not contain the Azure environment or the {@link AzureAuthenticationBase._credentialNameForCache}
+     * value, as those are added automatically.
+     */
+    protected abstract _getCacheIdParts(): string[];
+    protected abstract _getCredentialFromDeviceCodeAsync(terminal: ITerminal, deviceCodeCredential: DeviceCodeCredential): Promise<ICredentialResult>;
+    private _getCredentialAsync;
+}
+
+/**
+ * @public
+ */
+export declare type AzureEnvironmentName = keyof typeof AzureAuthorityHosts;
+
+/**
+ * @public
+ */
+export declare class AzureStorageAuthentication extends AzureAuthenticationBase {
+    protected readonly _credentialNameForCache: string;
+    protected readonly _credentialKindForLogging: string;
+    protected readonly _credentialUpdateCommandForLogging: string;
+    protected readonly _storageAccountName: string;
+    protected readonly _storageContainerName: string;
+    protected readonly _isCacheWriteAllowedByConfiguration: boolean;
+    protected readonly _storageAccountUrl: string;
+    constructor(options: IAzureStorageAuthenticationOptions);
+    protected _getCacheIdParts(): string[];
+    protected _getCredentialFromDeviceCodeAsync(terminal: ITerminal, deviceCodeCredential: DeviceCodeCredential): Promise<ICredentialResult>;
+}
+
+/**
+ * @public
+ */
+export declare interface IAzureAuthenticationBaseOptions {
+    azureEnvironment?: AzureEnvironmentName;
+}
+
+/**
+ * @public
+ */
+export declare interface IAzureStorageAuthenticationOptions extends IAzureAuthenticationBaseOptions {
+    storageContainerName: string;
+    storageAccountName: string;
+    isCacheWriteAllowed: boolean;
+}
+
+/**
+ * @public
+ */ export declare interface ICredentialResult {
+    credentialString: string;
+    expiresOn: Date | undefined;
+}
+
+/**
+ * @public
+ */
+declare class RushAzureStorageBuildCachePlugin implements IRushPlugin {
+    pluginName: string;
+    apply(rushSession: RushSession, rushConfig: RushConfiguration): void;
+}
+export default RushAzureStorageBuildCachePlugin;
+
+export { }