@twilio/flex-plugin-webpack5 0.0.1 → 7.1.4-alpha.202610140448

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (C) 2018, Twilio, Inc. <help@twilio.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the "Software"), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies
+of the Software, and to permit persons to whom the Software is furnished to do
+so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,4 +1,40 @@
-# @twilio/flex-plugin-webpack5
+![npm](https://img.shields.io/npm/v/flex-plugin-webpack5.svg?style=square)
+![npm](https://img.shields.io/npm/dt/flex-plugin-webpack5.svg?style=square)
+[![NpmLicense](https://img.shields.io/npm/l/flex-plugin-webpack5.svg?style=square)](../../LICENSE)
 
-Placeholder release. Real releases are published from
-[twilio/flex-plugin-builder](https://github.com/twilio/flex-plugin-builder).
+# Flex Plugin Webpack 5
+
+Webpack 5 configurations for building and running Flex plugins - the Webpack 5 counterpart to
+[`@twilio/flex-plugin-webpack`](../flex-plugin-webpack), which remains on Webpack 4 and is still the default.
+
+This package is not used directly; it is consumed by
+[`@twilio/flex-plugin-scripts`](../flex-plugin-scripts), which selects between the two webpack
+major versions based on the `--wp5` flag passed to the `flex-plugin build`/`flex-plugin start`
+scripts (surfaced through the `twilio flex:plugins:build`/`twilio flex:plugins:start` CLI commands
+as `--wp5`).
+
+Because a project can only ever depend on one version of a given npm package at a time, every
+export from this package is named with a `Wp5` suffix (`webpackFactoryWp5`, `compilerWp5`,
+`WebpackTypeWp5`, and so on) so it can be imported side by side with `@twilio/flex-plugin-webpack`'s
+un-suffixed equivalents without collisions. Its Webpack-version-specific dependencies (`webpack`,
+`webpack-dev-server`, `html-webpack-plugin`, `terser-webpack-plugin`, etc.) are similarly installed
+under aliased package names (e.g. `webpack5`, `html-webpack-plugin-wp5`) so both webpack majors can
+coexist in the same `node_modules` tree without version conflicts.
+
+## Notable differences from `@twilio/flex-plugin-webpack`
+
+- Uses `fork-ts-checker-webpack-plugin@^9`, a modern, actively maintained major version compatible
+  with current TypeScript syntax - unlike webpack 4's still-pinned `^4.1.6`. TypeScript type-checking
+  prefers the **plugin project's own installed TypeScript** version over this package's own, so a
+  plugin's dependencies (e.g. newer `@twilio/flex-ui`/`@apollo/client` releases using modern
+  `.d.ts` syntax) are checked with a compatible compiler rather than failing against a stale one.
+- Targets Webpack 5's APIs directly (asset modules, the new `Stats` schema, `processAssets` hooks)
+  rather than Webpack 4's.
+
+## Contributors
+
+Thank you to all the lovely contributors to this project. Please check the main repository to see [all contributors](https://github.com/twilio/flex-plugin-builder#contributors).
+
+## License
+
+[MIT](../../LICENSE)

package/dist/compiler.d.ts

@@ -0,0 +1,38 @@
+import { AsyncSeriesHook, SyncHook } from 'tapable';
+import { Compiler as WebpackCompiler, Configuration, Stats } from 'webpack5';
+import { OnCompileCompletePayload } from './devServer/ipcServer';
+import { OnRemotePlugins } from './devServer/pluginServer';
+type OnCompile = (payload: OnCompileCompletePayload) => void;
+interface CompilerHooks {
+    beforeCompile: AsyncSeriesHook<[any]>;
+    done: AsyncSeriesHook<Stats>;
+    invalid: SyncHook<[null | string, number]>;
+}
+interface Hook extends CompilerHooks {
+    tsCompiled: SyncHook<string[], string[]>;
+}
+export interface Compiler extends WebpackCompiler {
+    hooks: Hook;
+}
+interface CompilerRenderer {
+    onCompile: OnCompile;
+    onRemotePlugins: OnRemotePlugins;
+}
+/**
+ * Creates a webpack compiler
+ *
+ * @param config      the Webpack configuration
+ * @param devServer   whether to run the devserver or not
+ * @param type        the webpack compile type
+ * @param localPlugins  the names of plugins to run locally
+ */
+declare const _default: (config: Configuration, devServer: boolean, isJavaScriptServer: boolean, onCompile: OnCompile) => Compiler;
+export default _default;
+/**
+ * Prints the errors and warnings or a successful message when compilation finishes
+ * @param port    the port the server is running on
+ * @param localPlugins the local plugins running
+ * @param showSuccessMsg    whether to show succecss message or not
+ * @param hasRemote         whether there are any remote plugins
+ */
+export declare const compilerRenderer: (port: number, localPlugins: string[], showSuccessMsg: boolean, hasRemote: boolean) => CompilerRenderer;

package/dist/compiler.js

@@ -0,0 +1,252 @@
+"use strict";
+/* c8 ignore start */
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var __read = (this && this.__read) || function (o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compilerRenderer = void 0;
+var flex_dev_utils_1 = require("@twilio/flex-dev-utils");
+var errors_1 = require("@twilio/flex-dev-utils/dist/errors");
+var tapable_1 = require("tapable");
+var fork_ts_checker_webpack_plugin_1 = __importDefault(require("fork-ts-checker-webpack-plugin"));
+var webpack5_1 = __importDefault(require("webpack5"));
+var fs_1 = require("@twilio/flex-dev-utils/dist/fs");
+var format_webpack_messages_1 = __importDefault(require("@k88/format-webpack-messages"));
+var urls_1 = require("@twilio/flex-dev-utils/dist/urls");
+var prints_1 = require("./prints");
+// Holds all compilation errors
+var results = {};
+/**
+ * Creates a webpack compiler
+ *
+ * @param config      the Webpack configuration
+ * @param devServer   whether to run the devserver or not
+ * @param type        the webpack compile type
+ * @param localPlugins  the names of plugins to run locally
+ */
+/* c8 ignore next */
+exports.default = (function (config, devServer, isJavaScriptServer, onCompile) {
+    flex_dev_utils_1.logger.debug('Creating webpack compiler');
+    try {
+        var compiler_1 = (0, webpack5_1.default)(config);
+        if (!Object.isExtensible(compiler_1.hooks)) {
+            compiler_1.hooks = __assign({}, compiler_1.hooks);
+        }
+        compiler_1.hooks.tsCompiled = new tapable_1.SyncHook(['warnings', 'errors']);
+        // For build, we don't need to tap into any hooks
+        if (!devServer) {
+            return compiler_1;
+        }
+        var tsMessagesPromise_1;
+        var tsMessagesResolver_1;
+        if ((0, fs_1.getPaths)().app.isTSProject()) {
+            compiler_1.hooks.beforeCompile.tap('beforeCompile', function () {
+                tsMessagesPromise_1 = new Promise(function (resolve) {
+                    tsMessagesResolver_1 = function (msgs) { return resolve(msgs); };
+                });
+            });
+            /*
+             * fork-ts-checker-webpack-plugin resolves its own nested copy of the `webpack` peer dependency,
+             * which TypeScript sees as a distinct (though compatible) Compiler type from our own webpack5 import.
+             */
+            fork_ts_checker_webpack_plugin_1.default.getCompilerHooks(compiler_1).issues.tap('afterTSCheck', function (issues) {
+                var format = function (issue) {
+                    var _a;
+                    var location = issue.location ? ":".concat(issue.location.start.line, ":").concat(issue.location.start.column) : '';
+                    return "".concat((_a = issue.file) !== null && _a !== void 0 ? _a : '').concat(location, "\n").concat(issue.code, ": ").concat(issue.message);
+                };
+                if (tsMessagesResolver_1) {
+                    tsMessagesResolver_1({
+                        errors: issues.filter(function (issue) { return issue.severity === 'error'; }).map(format),
+                        warnings: issues.filter(function (issue) { return issue.severity === 'warning'; }).map(format),
+                    });
+                }
+                // issues is a SyncWaterfallHook - must return the (possibly filtered) issues to pass along
+                return issues;
+            });
+        }
+        // invalid is `bundle invalidated` and is invoked when files are modified in dev-server.
+        compiler_1.hooks.invalid.tap('invalid', function () {
+            flex_dev_utils_1.logger.clearTerminal();
+            flex_dev_utils_1.logger.info("Re-compiling **".concat((0, fs_1.getPaths)().app.name, "**"));
+        });
+        compiler_1.hooks.done.tap('done', function (stats) { return __awaiter(void 0, void 0, void 0, function () {
+            var result, delayedMsg, messages, config;
+            var _a, _b;
+            var _c, _d;
+            return __generator(this, function (_e) {
+                switch (_e.label) {
+                    case 0:
+                        result = stats === null || stats === void 0 ? void 0 : stats.toJson({ all: false, errors: true, warnings: true });
+                        if (!((0, fs_1.getPaths)().app.isTSProject() && !stats.hasErrors())) return [3 /*break*/, 2];
+                        delayedMsg = setTimeout(function () {
+                            flex_dev_utils_1.logger.notice('Waiting for Typescript check results...');
+                        }, 100);
+                        return [4 /*yield*/, tsMessagesPromise_1];
+                    case 1:
+                        messages = _e.sent();
+                        clearTimeout(delayedMsg);
+                        // Push ts-compile errors into compiler
+                        (_c = result === null || result === void 0 ? void 0 : result.errors) === null || _c === void 0 ? void 0 : _c.push.apply(_c, __spreadArray([], __read(messages.errors), false));
+                        (_a = stats.compilation.errors).push.apply(_a, __spreadArray([], __read(messages.errors), false));
+                        (_d = result === null || result === void 0 ? void 0 : result.warnings) === null || _d === void 0 ? void 0 : _d.push.apply(_d, __spreadArray([], __read(messages.warnings), false));
+                        (_b = stats.compilation.warnings).push.apply(_b, __spreadArray([], __read(messages.warnings), false));
+                        compiler_1.hooks.tsCompiled.call(messages.warnings, messages.errors);
+                        _e.label = 2;
+                    case 2:
+                        config = (0, fs_1.readRunPluginsJson)();
+                        // Add the plugin to the loaded plugins configuration file
+                        if (isJavaScriptServer) {
+                            config.loadedPlugins.push((0, fs_1.getPaths)().app.name);
+                            (0, fs_1.writeJSONFile)(config, (0, fs_1.getCliPaths)().localPluginsJsonPath);
+                        }
+                        // Check to see if the plugin is the last bundle to be loaded
+                        onCompile({
+                            result: result,
+                            appName: (0, fs_1.getPaths)().app.name,
+                            lastPluginBundle: config.plugins.length === config.loadedPlugins.length,
+                        });
+                        return [2 /*return*/];
+                }
+            });
+        }); });
+        return compiler_1;
+    }
+    catch (err) {
+        // @ts-ignore
+        throw new errors_1.FlexPluginError("Failed to create a webpack compiler: ".concat(err.message));
+    }
+});
+/**
+ * Prints the errors and warnings or a successful message when compilation finishes
+ * @param port    the port the server is running on
+ * @param localPlugins the local plugins running
+ * @param showSuccessMsg    whether to show succecss message or not
+ * @param hasRemote         whether there are any remote plugins
+ */
+var compilerRenderer = function (port, localPlugins, showSuccessMsg, hasRemote) {
+    var _a = (0, urls_1.getLocalAndNetworkUrls)(port), local = _a.local, network = _a.network;
+    var remotePlugins = [];
+    var serverSuccessful = function (list) {
+        list.forEach(function (l) {
+            if (!remotePlugins.some(function (r) { return r.name === l.name; })) {
+                remotePlugins.push(l);
+            }
+        });
+        flex_dev_utils_1.logger.clearTerminal();
+        (0, prints_1.devServerSuccessful)(local, network, localPlugins, remotePlugins, hasRemote);
+    };
+    return {
+        onRemotePlugins: serverSuccessful,
+        onCompile: function (_a) {
+            var result = _a.result, appName = _a.appName;
+            flex_dev_utils_1.logger.clearTerminal();
+            results[appName] = result;
+            var isSuccessful = Object.values(results).every(function (r) { return r.errors && r.errors.length === 0 && r.warnings && r.warnings.length === 0; });
+            if (isSuccessful) {
+                if (showSuccessMsg) {
+                    serverSuccessful([]);
+                }
+                return;
+            }
+            Object.keys(results).forEach(function (name) {
+                var formatted = (0, format_webpack_messages_1.default)({
+                    errors: results[name].errors,
+                    warnings: results[name].warnings,
+                });
+                // Only show errors if both exist
+                if (results[name].errors.length) {
+                    /*
+                     * Most errors are duplicate of the same error
+                     * So only show the first error
+                     */
+                    formatted.errors.length = 1;
+                    flex_dev_utils_1.logger.error("Failed to compile plugin ".concat(flex_dev_utils_1.logger.colors.red.bold(name), "."));
+                    flex_dev_utils_1.logger.info(formatted.errors.join('\n'));
+                    flex_dev_utils_1.logger.newline();
+                    return;
+                }
+                if (results[name].warnings.length) {
+                    flex_dev_utils_1.logger.warning("Compiled plugin ".concat(flex_dev_utils_1.logger.colors.yellow.bold(name), " with warning(s)."));
+                    flex_dev_utils_1.logger.info(formatted.warnings.join('\n'));
+                    flex_dev_utils_1.logger.newline();
+                }
+            });
+        },
+    };
+};
+exports.compilerRenderer = compilerRenderer;
+/* c8 ignore stop */
+//# sourceMappingURL=compiler.js.map

package/dist/compiler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.js","sourceRoot":"","sources":["../src/compiler.ts"],"names":[],"mappings":"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"}

package/dist/devServer/ipcServer.d.ts

@@ -0,0 +1,73 @@
+import webpack from 'webpack5';
+import * as self from './ipcServer';
+import ToJsonOutput = webpack.StatsCompilation;
+export declare enum IPCType {
+    onCompileComplete = "onCompileComplete",
+    onDevServerCrashed = "onDevServerCrashed",
+    onEmitAllCompilesComplete = "onEmitAllCompilesComplete"
+}
+export interface OnCompileCompletePayload {
+    result: ToJsonOutput;
+    appName: string;
+    lastPluginBundle: boolean;
+}
+export interface OnDevServerCrashedPayload {
+    exception: {
+        message: string;
+        stack?: string;
+    };
+}
+interface IPCPayload {
+    onCompileComplete: OnCompileCompletePayload;
+    onDevServerCrashed: OnDevServerCrashedPayload;
+    onEmitAllCompilesComplete: unknown;
+}
+type MessageCallback<T extends IPCType> = (payload: IPCPayload[T]) => void;
+/**
+ * Processes the emit queue
+ * @private
+ */
+export declare const _processEmitQueue: () => Promise<void>;
+/**
+ * Processes on client connected
+ * @private
+ */
+export declare const _onClientConnected: () => Promise<void>;
+/**
+ * Emits to the server
+ * @param type      the event type
+ * @param payload   the event payload
+ * @private
+ */
+export declare const _emitToServer: <T extends self.IPCType>(type: T, payload: IPCPayload[T]) => Promise<void>;
+/**
+ * Starts an IPC server
+ */
+export declare const startIPCServer: () => void;
+/**
+ * Starts an IPC Client
+ */
+export declare const startIPCClient: () => void;
+/**
+ * onMessage event for the IPC server
+ * @param type
+ * @param callback
+ */
+export declare const onIPCServerMessage: <T extends self.IPCType>(type: T, callback: MessageCallback<T>) => void;
+/**
+ * Emits to the server that all of the JS Bundles have completed compiling
+ * @param payload
+ * @returns
+ */
+export declare const emitAllCompilesComplete: () => Promise<void>;
+/**
+ * Emits a compilation complete event
+ * @param payload
+ */
+export declare const emitCompileComplete: (payload: OnCompileCompletePayload) => Promise<void>;
+/**
+ * Emits a dev-server failed event
+ * @param error
+ */
+export declare const emitDevServerCrashed: (error: Error) => Promise<void>;
+export {};