@amazon/vinyl-build-utils 1.0.0

package/dist/browserstack/configureReporterApi.d.ts

@@ -0,0 +1,85 @@
+import type { Express } from 'express';
+export interface StartedRequest {
+    /**
+     * The identifier, provided in the url for the session.
+     */
+    readonly id: string;
+    /**
+     * The total number of specs.
+     */
+    readonly totalSpecs: number;
+}
+export interface ProgressRequest {
+    /**
+     * The identifier, provided in the url for the session.
+     */
+    readonly id: string;
+    /**
+     * The number of specs completed.
+     */
+    readonly totalCompleted: number;
+    /**
+     * The total number of specs.
+     */
+    readonly totalSpecs: number;
+    /**
+     * The console logs.
+     */
+    readonly logs: readonly LogEntry[];
+}
+export type LogEntry = [
+    level: 'debug' | 'log' | 'info' | 'warn' | 'error',
+    /**
+     * An iso 8601 date string.
+     */
+    dateStr: string,
+    /**
+     * The log message.
+     */
+    message: string
+];
+export interface DoneRequest extends ProgressRequest {
+    /**
+     * Set session status to either passed or failed.
+     */
+    readonly overallStatus: 'passed' | 'failed' | 'incomplete';
+    /**
+     * Reason for session failure.
+     */
+    readonly reason?: string;
+}
+/**
+ * Callbacks for the REST API provided to the test reporter.
+ */
+export interface ReportingListener {
+    /**
+     * Return true if this listener handles the given request id.
+     * If the BrowserStack runner is restarted, workers from the previous session may invoke the listener for the new
+     * session. Return false to ignore the orphaned testing session.
+     *
+     * @param id
+     */
+    shouldHandleRequest(id: string): boolean;
+    /**
+     * The suite has begun. Provides the total number of specs.
+     * @param request
+     */
+    onStarted(request: StartedRequest): void;
+    /**
+     * One spec has completed.
+     */
+    onProgress(request: ProgressRequest): void;
+    /**
+     * The suite has finished.
+     */
+    onDone(request: DoneRequest): void;
+}
+/**
+ * Creates a REST API the test reporter can use to notify the browserstack runner of current progress.
+ * See Vinyl's `test/browserTestUtil/reporters/RestApiReporter.ts`
+ *
+ * @param app The Express application.
+ * @param listener Callbacks invoked when the API endpoints are called.
+ */
+export declare function configureReportingApi(app: Express, listener: ReportingListener): void;
+//# sourceMappingURL=configureReporterApi.d.ts.map

package/dist/browserstack/configureReporterApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configureReporterApi.d.ts","sourceRoot":"","sources":["../../src/browserstack/configureReporterApi.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAA;AAGtC,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAC9B;AAED,MAAM,WAAW,eAAe;IAC5B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IAEnB;;OAEG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;IAE/B;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAE3B;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,EAAE,CAAA;CACrC;AAED,MAAM,MAAM,QAAQ,GAAG;IACnB,KAAK,EAAE,OAAO,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO;IAElD;;OAEG;IACH,OAAO,EAAE,MAAM;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM;CAClB,CAAA;AAED,MAAM,WAAW,WAAY,SAAQ,eAAe;IAChD;;OAEG;IACH,QAAQ,CAAC,aAAa,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,CAAA;IAE1D;;OAEG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAC9B;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAExC;;;OAGG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAA;IAExC;;OAEG;IACH,UAAU,CAAC,OAAO,EAAE,eAAe,GAAG,IAAI,CAAA;IAE1C;;OAEG;IACH,MAAM,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAAA;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACjC,GAAG,EAAE,OAAO,EACZ,QAAQ,EAAE,iBAAiB,QAwC9B"}

package/dist/browserstack/configureReporterApi.js

@@ -0,0 +1,51 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { json as expressJson } from 'express';
+/**
+ * Creates a REST API the test reporter can use to notify the browserstack runner of current progress.
+ * See Vinyl's `test/browserTestUtil/reporters/RestApiReporter.ts`
+ *
+ * @param app The Express application.
+ * @param listener Callbacks invoked when the API endpoints are called.
+ */
+export function configureReportingApi(app, listener) {
+    app.use(expressJson({ limit: '10mb' }));
+    app.post('/report/:id/started', (req, res) => {
+        if (listener.shouldHandleRequest(req.params.id)) {
+            listener.onStarted({
+                id: req.params.id,
+                totalSpecs: req.body.totalSpecs,
+            });
+            res.status(200).send({ ok: true });
+        }
+        else {
+            res.status(400).send({ ok: false });
+        }
+    });
+    app.post('/report/:id/progress', (req, res) => {
+        if (listener.shouldHandleRequest(req.params.id)) {
+            listener.onProgress({
+                id: req.params.id,
+                ...req.body,
+            });
+            res.status(200).send({ ok: true });
+        }
+        else {
+            res.status(400).send({ ok: false });
+        }
+    });
+    app.post('/report/:id/done', (req, res) => {
+        if (listener.shouldHandleRequest(req.params.id)) {
+            listener.onDone({
+                id: req.params.id,
+                ...req.body,
+            });
+            res.status(200).send({ ok: true });
+        }
+        else {
+            res.status(400).send({ ok: false });
+        }
+    });
+}

package/dist/browserstack/runBrowserStack.d.ts

@@ -0,0 +1,123 @@
+import type { ServerOptions } from '../express/serve';
+import type { BrowserDetails, BrowserStackCredentials, WorkerOptions } from './browserStackRestApi';
+import type { Options as BsLocalOptions } from 'browserstack-local';
+import type { BrowserStackWorkerControllerOptions } from './BrowserStackWorkerController';
+import { LogLevel } from '../util/Logger';
+export interface BrowserStackOptions extends BrowserStackWorkerControllerOptions {
+    /**
+     * BrowserStack local connection options.
+     */
+    readonly local?: Partial<BsLocalOptions>;
+    /**
+     * Local server configuration.
+     */
+    readonly server: ServerOptions;
+    /**
+     * The BrowserStack credentials, if undefined these will be taken from the environment variables
+     * BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY.
+     * If a `.env` file exists, it will be used to populate environmental variables.
+     */
+    readonly credentials?: BrowserStackCredentials | Promise<BrowserStackCredentials>;
+    /**
+     * The list of browsers to test against.
+     * `name` if not provided will be generated using '<device> <os> <browser> <browser_version>'.
+     *
+     * Valid browsers and devices can be obtained using the SDK config generator at:
+     * {@link https://www.browserstack.com/docs/automate/selenium/sdk-config-generator}
+     */
+    readonly browsers: readonly WorkerInitOptions[];
+    /**
+     * Options common to all workers.
+     *
+     * `build` will default to a unique identifier if not provided.
+     */
+    readonly workerCommon?: CommonWorkerInitOptions;
+    /**
+     * If true, shows continuous progress in the console.
+     * If false, progress will be logged in at most 10% increments.
+     *
+     * Recommended to set to false for CI environments.
+     * Default: true when the process.stdout is a terminal.
+     */
+    readonly stickyProgress?: boolean;
+    /**
+     * If true, terminates all workers on the first failure.
+     * Default: false
+     */
+    readonly stopOnFirstFailure?: boolean;
+    /**
+     * Sets the log verbosity.
+     * Default: LogLevel.INFO
+     */
+    readonly logLevel?: LogLevel;
+}
+/**
+ * Options to be used as defaults for all workers.
+ * Values set on the worker will take priority.
+ */
+export type CommonWorkerInitOptions = Omit<WorkerInitOptions, keyof BrowserDetails>;
+export interface WorkerInitOptions extends Omit<WorkerOptions, 'url'> {
+    /**
+     * A valid url to navigate the browser to.
+     * If not set, the local server URL will be used.
+     */
+    readonly url?: string;
+}
+/**
+ * Attempts to get the BrowserStackCredentials from the environment.
+ */
+export declare function getEnvBrowserStackCredentials(): BrowserStackCredentials;
+/**
+ * When the BrowserStack run has completed, provides the final results.
+ */
+export interface BrowserStackResults {
+    readonly passed: boolean;
+}
+/**
+ * Runs tests on BrowserStack.
+ *
+ * This will:
+ * - Start a local server including a REST API for serving tests that are expected to report their progress to the
+ * service.
+ * - Start the BrowserStack local tunnel.
+ * - Enqueue workers for each provided browser.
+ *
+ * @return Returns a Promise with the test results.
+ *
+ * Example:
+ *
+ * ```
+ * void runBrowserStack({
+ *     server: {
+ *         port: 9009,
+ *         staticDir: './dist/test',
+ *     },
+ *     browsers: [
+ *         {
+ *             browser: 'chrome',
+ *             browser_version: 'latest',
+ *             os: 'OS X',
+ *             os_version: 'Monterey',
+ *         },
+ *         {
+ *             browser: 'safari',
+ *             browser_version: 'latest',
+ *             os: 'OS X',
+ *             os_version: 'Monterey',
+ *         },
+ *     ],
+ *     workerCommon: {
+ *         project: 'MyProject',
+ *     },
+ * }).then((result) => {
+ *     if (!result.passed) process.exit(1)
+ * })
+ * ```
+ */
+export declare function runBrowserStack(options: BrowserStackOptions): Promise<BrowserStackResults>;
+/**
+ * Calls {@link runBrowserStack}, exiting the process when settled.
+ * @param options
+ */
+export declare function runBrowserStackAndExit(options: BrowserStackOptions): void;
+//# sourceMappingURL=runBrowserStack.d.ts.map

package/dist/browserstack/runBrowserStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runBrowserStack.d.ts","sourceRoot":"","sources":["../../src/browserstack/runBrowserStack.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,KAAK,EACR,cAAc,EACd,uBAAuB,EACvB,aAAa,EAChB,MAAM,uBAAuB,CAAA;AAG9B,OAAO,KAAK,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACnE,OAAO,KAAK,EAAE,mCAAmC,EAAE,MAAM,gCAAgC,CAAA;AAIzF,OAAO,EAAU,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAMjD,MAAM,WAAW,mBAAoB,SAAQ,mCAAmC;IAC5E;;OAEG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAA;IAExC;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAE9B;;;;OAIG;IACH,QAAQ,CAAC,WAAW,CAAC,EACf,uBAAuB,GACvB,OAAO,CAAC,uBAAuB,CAAC,CAAA;IAEtC;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAA;IAE/C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,uBAAuB,CAAA;IAE/C;;;;;;OAMG;IACH,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAA;IAEjC;;;OAGG;IACH,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;IAErC;;;OAGG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAA;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACtC,iBAAiB,EACjB,MAAM,cAAc,CACvB,CAAA;AAED,MAAM,WAAW,iBAAkB,SAAQ,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC;IACjE;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;GAEG;AACH,wBAAgB,6BAA6B,IAAI,uBAAuB,CAavE;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAsB,eAAe,CACjC,OAAO,EAAE,mBAAmB,GAC7B,OAAO,CAAC,mBAAmB,CAAC,CAoH9B;AAiBD;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAazE"}

package/dist/browserstack/runBrowserStack.js

@@ -0,0 +1,204 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { config as dotEnvConfig } from 'dotenv';
+import express from 'express';
+import { startExpressServer } from '../express/startExpressServer';
+import { configureExpress } from '../express/serve';
+import { BrowserStackAutomateClient } from './browserStackRestApi';
+import { startBrowserStackLocal } from './browserStackLocal';
+import { BrowserStackWorkerController } from './BrowserStackWorkerController';
+import { configureReportingApi } from './configureReporterApi';
+import process from 'node:process';
+import { logger, LogLevel } from '../util/Logger';
+import { ansi, progressBar } from '../util/console';
+import { getRootProjectDir } from '../util/getRootProjectDir';
+import path from 'node:path';
+import crypto from 'node:crypto';
+/**
+ * Attempts to get the BrowserStackCredentials from the environment.
+ */
+export function getEnvBrowserStackCredentials() {
+    const rootDir = getRootProjectDir();
+    if (!rootDir)
+        throw new Error('Could not find root project dir from current working directory.');
+    dotEnvConfig({
+        path: path.resolve(rootDir, '.env'),
+    });
+    return {
+        username: process.env.BROWSERSTACK_USERNAME,
+        key: process.env.BROWSERSTACK_ACCESS_KEY,
+    };
+}
+/**
+ * Runs tests on BrowserStack.
+ *
+ * This will:
+ * - Start a local server including a REST API for serving tests that are expected to report their progress to the
+ * service.
+ * - Start the BrowserStack local tunnel.
+ * - Enqueue workers for each provided browser.
+ *
+ * @return Returns a Promise with the test results.
+ *
+ * Example:
+ *
+ * ```
+ * void runBrowserStack({
+ *     server: {
+ *         port: 9009,
+ *         staticDir: './dist/test',
+ *     },
+ *     browsers: [
+ *         {
+ *             browser: 'chrome',
+ *             browser_version: 'latest',
+ *             os: 'OS X',
+ *             os_version: 'Monterey',
+ *         },
+ *         {
+ *             browser: 'safari',
+ *             browser_version: 'latest',
+ *             os: 'OS X',
+ *             os_version: 'Monterey',
+ *         },
+ *     ],
+ *     workerCommon: {
+ *         project: 'MyProject',
+ *     },
+ * }).then((result) => {
+ *     if (!result.passed) process.exit(1)
+ * })
+ * ```
+ */
+export async function runBrowserStack(options) {
+    // Validate options argument
+    if (!options.browsers.length)
+        throw new Error('options.browsers is required');
+    let done;
+    const donePromise = new Promise((r) => (done = r));
+    const bsCredentials = (await options.credentials) ?? getEnvBrowserStackCredentials();
+    if (!bsCredentials.username || !bsCredentials.key)
+        throw new Error('Missing BrowserStack credentials. May be provided via options.credentials, or the environmental ' +
+            'variables BROWSERSTACK_USERNAME and BROWSERSTACK_ACCESS_KEY. ' +
+            'Environmental variables may be set via a .env file.');
+    // Use the explicitly set stickyProgress value, or default to true if the stdout is a terminal.
+    const useSticky = options.stickyProgress ?? process.stdout.isTTY;
+    logger.level = options.logLevel ?? LogLevel.INFO;
+    const localOptions = {
+        key: bsCredentials.key,
+        logFile: './bStackLogs/local.log',
+        ...options.local,
+    };
+    const shutdownLocalTunnel = await startBrowserStackLocal(localOptions);
+    const app = express();
+    configureExpress(app, options.server);
+    const serverHandle = await startExpressServer({ app }, options.server);
+    const client = new BrowserStackAutomateClient(bsCredentials);
+    const build = `build-${crypto.randomUUID()}`;
+    const workerOptions = options.browsers.map((browser) => {
+        const name = browser.name ?? generateNameForBrowser(browser);
+        // Url precedence:
+        const url = browser.url ??
+            options.workerCommon?.url ??
+            serverHandle.https?.url ??
+            serverHandle.http.url;
+        return {
+            build,
+            name,
+            ...options.workerCommon,
+            ...browser,
+            url,
+        };
+    });
+    const workerController = new BrowserStackWorkerController({ client }, workerOptions, options);
+    configureReportingApi(app, workerController);
+    const state = workerController.state;
+    function createProgressMessage() {
+        let failedStr = `failed: ${state.failed}`;
+        if (state.failed > 0)
+            failedStr = ansi.red + failedStr + ansi.resetColor;
+        return (`${ansi.green}passed: ${state.passed}${ansi.resetColor}, ${failedStr}, running: ${state.running}, pending: ${state.pending}\n` +
+            progressBar(state.percentComplete));
+    }
+    let previousDecile = 0;
+    workerController.onUpdate = () => {
+        if (disposed)
+            return;
+        const progressStr = createProgressMessage();
+        if (useSticky)
+            logger.sticky(progressStr);
+        else {
+            const decile = Math.trunc(state.percentComplete * 10);
+            if (decile !== previousDecile) {
+                logger.info(progressStr);
+                previousDecile = decile;
+            }
+        }
+        if (options.stopOnFirstFailure && state.failed)
+            void shutdown();
+        if (!state.remaining)
+            void shutdown();
+    };
+    const sigIntHandler = () => {
+        logger.info('SIGINT signal received.');
+        void shutdown().then(() => {
+            process.exit(1);
+        });
+    };
+    process.once('SIGINT', sigIntHandler);
+    let disposed = false;
+    async function shutdown() {
+        if (disposed)
+            return;
+        disposed = true;
+        logger.clearSticky();
+        logger.info(createProgressMessage());
+        logger.debug('Shutting down');
+        process.removeListener('SIGINT', sigIntHandler);
+        await workerController.terminate();
+        await serverHandle.close();
+        await shutdownLocalTunnel();
+        // Resolve the promise with the final results:
+        const passed = workerController.allPassed;
+        if (passed)
+            logger.info('✅ All tests passed');
+        done({
+            passed,
+        });
+    }
+    workerController.start();
+    return await donePromise;
+}
+/**
+ * Creates a session name for the given browser options.
+ */
+function generateNameForBrowser(browser) {
+    return [
+        browser.device,
+        browser.os,
+        browser.os_version,
+        browser.browser,
+        browser.browser_version,
+    ]
+        .filter((str) => str)
+        .join(' ');
+}
+/**
+ * Calls {@link runBrowserStack}, exiting the process when settled.
+ * @param options
+ */
+export function runBrowserStackAndExit(options) {
+    runBrowserStack(options)
+        .then((result) => {
+        if (!result.passed)
+            process.exit(1);
+    })
+        .catch((error) => {
+        console.error(ansi.red +
+            String('message' in error ? error.message : error) +
+            ansi.resetColor);
+        process.exit(1);
+    });
+}

package/dist/esbuild/CompatTransformPlugin.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin } from 'esbuild';
+export interface CompatTransformPluginOptions {
+    readonly enabled?: boolean;
+}
+export declare function compatTransformPlugin(options?: CompatTransformPluginOptions): Plugin;
+//# sourceMappingURL=CompatTransformPlugin.d.ts.map

package/dist/esbuild/CompatTransformPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CompatTransformPlugin.d.ts","sourceRoot":"","sources":["../../src/esbuild/CompatTransformPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAe,MAAM,SAAS,CAAA;AAKlD,MAAM,WAAW,4BAA4B;IACzC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAC7B;AAYD,wBAAgB,qBAAqB,CACjC,OAAO,GAAE,4BAAiC,GAC3C,MAAM,CAoDR"}

package/dist/esbuild/CompatTransformPlugin.js

@@ -0,0 +1,59 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { compatTransform } from '../babel/compatTransform';
+import path from 'path';
+import { logger } from '../util/Logger';
+/**
+ * Changes a path's file extension.
+ */
+function changeExtension(filePath, newExtension) {
+    const dir = path.dirname(filePath);
+    const ext = path.extname(filePath);
+    const base = path.basename(filePath, ext);
+    return path.join(dir, base) + '.' + newExtension;
+}
+export function compatTransformPlugin(options = {}) {
+    return {
+        name: 'CompatTransformPlugin',
+        setup(build) {
+            build.onEnd(async (result) => {
+                if (options.enabled === false || result.errors.length)
+                    return;
+                if (!result.metafile) {
+                    return {
+                        errors: [
+                            {
+                                text: 'CompatTransformPlugin requires metafile: true',
+                            },
+                        ],
+                    };
+                }
+                const jsOutputs = Object.keys(result.metafile.outputs).filter((f) => /\.([cm])?js$/i.test(f));
+                await Promise.all(jsOutputs.map(async (srcPath) => {
+                    const destPath = changeExtension(srcPath, 'es5.js');
+                    logger.debug(`babel: transpiling '${srcPath}' -> '${destPath}' ...`);
+                    try {
+                        await compatTransform({
+                            src: srcPath,
+                            dest: destPath,
+                        });
+                        logger.info(`babel: '${destPath}'`);
+                    }
+                    catch (e) {
+                        return {
+                            errors: [
+                                {
+                                    text: `babel failed: ${e}`,
+                                    location: { file: srcPath },
+                                    detail: e,
+                                },
+                            ],
+                        };
+                    }
+                }));
+            });
+        },
+    };
+}

package/dist/esbuild/PureExportsPlugin.d.ts

@@ -0,0 +1,11 @@
+import type { OnLoadArgs, OnLoadResult, Plugin } from 'esbuild';
+/**
+ * Adds a PURE annotation to call expressions and `new` expressions
+ * inside object literals that are not within any function-like scope.
+ * This allows exported config-like structures to be tree-shaken safely
+ * when not referenced.
+ */
+export declare const pureExportsPlugin: Plugin;
+export declare function onLoad(args: OnLoadArgs): Promise<OnLoadResult | null>;
+export declare function annotatePureComments(source: string): string;
+//# sourceMappingURL=PureExportsPlugin.d.ts.map

package/dist/esbuild/PureExportsPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PureExportsPlugin.d.ts","sourceRoot":"","sources":["../../src/esbuild/PureExportsPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAU,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AAQvE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAK/B,CAAA;AAED,wBAAsB,MAAM,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAM3E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAmB3D"}

package/dist/esbuild/PureExportsPlugin.js

@@ -0,0 +1,55 @@
+/*
+ * Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { readFile } from 'fs/promises';
+import { extname } from 'path';
+import { parse } from '@babel/parser';
+import MagicString from 'magic-string';
+import { traverse } from '@babel/core';
+/**
+ * Adds a PURE annotation to call expressions and `new` expressions
+ * inside object literals that are not within any function-like scope.
+ * This allows exported config-like structures to be tree-shaken safely
+ * when not referenced.
+ */
+export const pureExportsPlugin = {
+    name: 'pure-exports',
+    setup(build) {
+        build.onLoad({ filter: /\.[jt]sx?$/ }, onLoad);
+    },
+};
+export async function onLoad(args) {
+    const source = await readFile(args.path, 'utf8');
+    return {
+        contents: annotatePureComments(source),
+        loader: extname(args.path).slice(1),
+    };
+}
+export function annotatePureComments(source) {
+    const ast = parse(source, {
+        sourceType: 'module',
+        plugins: ['typescript', 'jsx'],
+        ranges: true,
+    });
+    const ms = new MagicString(source);
+    traverse(ast, {
+        CallExpression(path) {
+            maybeAnnotate(path, ms);
+        },
+        NewExpression(path) {
+            maybeAnnotate(path, ms);
+        },
+    });
+    return ms.toString();
+}
+function maybeAnnotate(path, ms) {
+    const { node } = path;
+    if (node.start == null)
+        return;
+    // Disallow annotation if the object literal is within any function-like scope
+    if (path.findParent((p) => p.isFunctionParent()))
+        return;
+    // Annotate as PURE
+    ms.prependLeft(node.start, '/* @__PURE__ */ ');
+}

package/dist/esbuild/TypeDeclarationsPlugin.d.ts

@@ -0,0 +1,9 @@
+import type { Plugin } from 'esbuild';
+import { type TypeDeclarationOptions } from '../typescript/buildTypeDeclarations';
+/**
+ * A plugin to emit type declarations after each build.
+ *
+ * @param options
+ */
+export declare function tscPlugin(options?: TypeDeclarationOptions): Plugin;
+//# sourceMappingURL=TypeDeclarationsPlugin.d.ts.map

package/dist/esbuild/TypeDeclarationsPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeDeclarationsPlugin.d.ts","sourceRoot":"","sources":["../../src/esbuild/TypeDeclarationsPlugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAA+B,MAAM,EAAe,MAAM,SAAS,CAAA;AAG/E,OAAO,EAEH,KAAK,sBAAsB,EAC9B,MAAM,qCAAqC,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAE,sBAA2B,GAAG,MAAM,CA4BtE"}