@lwc/hmr-client 7.0.0-6.6.3

package/LICENSE.txt

@@ -0,0 +1,21 @@
+Terms of Use
+
+Copyright 2022 Salesforce, Inc. All rights reserved.
+
+These Terms of Use govern the download, installation, and/or use of this software provided by Salesforce, Inc. (“Salesforce”) (the “Software”), were last updated on April 15, 2022, ** and constitute a legally binding agreement between you and Salesforce. If you do not agree to these Terms of Use, do not install or use the Software.
+
+Salesforce grants you a worldwide, non-exclusive, no-charge, royalty-free copyright license to reproduce, prepare derivative works of, publicly display, publicly perform, sublicense, and distribute the Software and derivative works subject to these Terms. These Terms shall be included in all copies or substantial portions of the Software.
+
+Subject to the limited rights expressly granted hereunder, Salesforce reserves all rights, title, and interest in and to all intellectual property subsisting in the Software. No rights are granted to you hereunder other than as expressly set forth herein. Users residing in countries on the United States Office of Foreign Assets Control sanction list, or which are otherwise subject to a US export embargo, may not use the Software.
+
+Implementation of the Software may require development work, for which you are responsible. The Software may contain bugs, errors and incompatibilities and is made available on an AS IS basis without support, updates, or service level commitments.
+
+Salesforce reserves the right at any time to modify, suspend, or discontinue, the Software (or any part thereof) with or without notice. You agree that Salesforce shall not be liable to you or to any third party for any modification, suspension, or discontinuance.
+
+You agree to defend Salesforce against any claim, demand, suit or proceeding made or brought against Salesforce by a third party arising out of or accruing from (a) your use of the Software, and (b) any application you develop with the Software that infringes any copyright, trademark, trade secret, trade dress, patent, or other intellectual property right of any person or defames any person or violates their rights of publicity or privacy (each a “Claim Against Salesforce”), and will indemnify Salesforce from any damages, attorney fees, and costs finally awarded against Salesforce as a result of, or for any amounts paid by Salesforce under a settlement approved by you in writing of, a Claim Against Salesforce, provided Salesforce (x) promptly gives you written notice of the Claim Against Salesforce, (y) gives you sole control of the defense and settlement of the Claim Against Salesforce (except that you may not settle any Claim Against Salesforce unless it unconditionally releases Salesforce of all liability), and (z) gives you all reasonable assistance, at your expense.
+
+WITHOUT LIMITING THE GENERALITY OF THE FOREGOING, THE SOFTWARE IS NOT SUPPORTED AND IS PROVIDED "AS IS," WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED. IN NO EVENT SHALL SALESFORCE HAVE ANY LIABILITY FOR ANY DAMAGES, INCLUDING, BUT NOT LIMITED TO, DIRECT, INDIRECT, SPECIAL, INCIDENTAL, PUNITIVE, OR CONSEQUENTIAL DAMAGES, OR DAMAGES BASED ON LOST PROFITS, DATA, OR USE, IN CONNECTION WITH THE SOFTWARE, HOWEVER CAUSED AND WHETHER IN CONTRACT, TORT, OR UNDER ANY OTHER THEORY OF LIABILITY, WHETHER OR NOT YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+These Terms of Use shall be governed exclusively by the internal laws of the State of California, without regard to its conflicts of laws rules. Each party hereby consents to the exclusive jurisdiction of the state and federal courts located in San Francisco County, California to adjudicate any dispute arising out of or relating to these Terms of Use and the download, installation, and/or use of the Software. Except as expressly stated herein, these Terms of Use constitute the entire agreement between the parties, and supersede all prior and contemporaneous agreements, proposals, or representations, written or oral, concerning their subject matter. No modification, amendment, or waiver of any provision of these Terms of Use shall be effective unless it is by an update to these Terms of Use that Salesforce makes available, or is in writing and signed by the party against whom the modification, amendment, or waiver is to be asserted.
+
+Data Privacy: Salesforce may collect, process, and store device, system, and other information related to your use of the Software. This information includes, but is not limited to, IP address, user metrics, and other data (“Usage Data”). Salesforce may use Usage Data for analytics, product development, and marketing purposes. You acknowledge that files generated in conjunction with the Software may contain sensitive or confidential data, and you are solely responsible for anonymizing and protecting such data.

package/dist/api.d.ts

@@ -0,0 +1,37 @@
+import type { Module, HMR_Register } from '@lwc/lwc-dev-server-types';
+import type { TransformOptions } from '@lwc/compiler';
+export type HotModuleCallback = (mod: Module) => void;
+/**
+ * API call to self update.
+ * @param modulePath {string} The module path.
+ * @param cb {function} The callback function to invoke for self update.
+ */
+export declare function accept(modulePath: string, cb: HotModuleCallback): void;
+/**
+ * API call for owner module to ingest updates to dependencies.
+ * @param ownerPath {string} The owner module's path or module identifier.
+ * @param modulePath {string} The module path.
+ * @param cb {function} The callback function to invoke for self update.
+ */
+export declare function acceptDeps(_ownerPath: string, modulePath: string, cb: HotModuleCallback): void;
+export declare const activeModules: Map<string, HMR_Register['data']>;
+/**
+ * Register a module path used by the client along with its state.
+ * @param modulePath {string} The module path.
+ * @param hash {string} A hash representation of the module's source to perform freshness check.
+ * @param compileOptions {object} The compiler config that was used to bundle this module.
+ */
+export declare function register(modulePath: string, hash: string, compileOptions: TransformOptions): void;
+export type UpdateHandler = (mod: Module) => void;
+export declare function updateHandler(modulePath: string): UpdateHandler | undefined;
+/**
+ * Provide a list of all module paths that of interest to the current page.
+ * This will be registered with the dev server as modules of interest.
+ * @returns A list of all the paths that was used to load the current page.
+ */
+export declare function getActiveModulePaths(): string[];
+/**
+ * Get module state for all active modules on the client.
+ * @returns An array of objects containing modulePath, hash and compiler config.
+ */
+export declare function getActiveModules(): HMR_Register['data'][];

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+import { ModuleUpdateObserver } from './notify/notify';
+export declare function initializeClient(protocol: 'ws' | 'wss', host: string, port: string, hotModuleHandler: HotModuleHandler, errorCallback?: (error: Error) => void, observer?: ModuleUpdateObserver): void;
+/**
+ * This interface defines capabilities that need to be implemented by the container to handle hot module
+ * updates.
+ */
+export interface HotModuleHandler {
+    /**
+     * Fetch all dependencies that are required for a hot module before its evaluation.
+     * @param moduleSpecifiers List of dependent modules specifiers.
+     */
+    fetchDependencies(moduleSpecifiers: string[]): Promise<any>;
+    /**
+     * Give an dependency's module specifier, return the module definition.
+     * @param moduleSpecifier Module id in the format of
+     *      <namespace>/<name> in the case of LWCs
+     *      <name> in the case of standard modules like 'lwc', 'wire-service' etc.
+     */
+    getDependency(moduleSpecifier: string): any;
+    /**
+     * Evalaute a given Javascript source code.
+     * @param source Javascript in string format.
+     */
+    evaluateModule(ownerModuleId: string, hotModulePath: string, source: string): Promise<unknown>;
+}

package/dist/connection.d.ts

@@ -0,0 +1,12 @@
+import type { HMR_Data } from '@lwc/lwc-dev-server-types';
+export declare class Connection {
+    protocol: string;
+    host: string;
+    port: string;
+    socket: WebSocket | undefined;
+    init(protocol: string, host: string, port: string): void;
+    fetchModule(modulePath: string): void;
+    initializeConnection(initCallback: () => void, messageCallback: (data: HMR_Data) => void, errorCallback?: (error: Error) => void): void;
+    send(data: HMR_Data): void;
+    close(): void;
+}

package/dist/index.cjs.js

@@ -0,0 +1,287 @@
+/**
+ * LWC Hot Module Replacement(HMR) client code 
+ */
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+const hotModuleCbs = new Map();
+function accept(modulePath, cb) {
+    const callbacks = hotModuleCbs.get(modulePath) || [];
+    callbacks.push(cb);
+    hotModuleCbs.set(modulePath, callbacks);
+}
+/**
+ * API call for owner module to ingest updates to dependencies.
+ * @param ownerPath {string} The owner module's path or module identifier.
+ * @param modulePath {string} The module path.
+ * @param cb {function} The callback function to invoke for self update.
+ */
+function acceptDeps(_ownerPath, modulePath, cb) {
+    const callbacks = hotModuleCbs.get(modulePath) || [];
+    callbacks.push(cb);
+    hotModuleCbs.set(modulePath, callbacks);
+}
+const activeModules = new Map();
+const staleModules = new Map();
+/**
+ * Register a module path used by the client along with its state.
+ * @param modulePath {string} The module path.
+ * @param hash {string} A hash representation of the module's source to perform freshness check.
+ * @param compileOptions {object} The compiler config that was used to bundle this module.
+ */
+function register(modulePath, hash, compileOptions) {
+    const moduleState = {
+        modulePath,
+        hash,
+        compileOptions,
+    };
+    const staleModule = activeModules.get(moduleState.modulePath);
+    if (staleModule) {
+        // This is a new version of an existing module
+        // Potentially clean up old handlers, call dispose()
+        staleModules.set(modulePath, staleModule);
+    }
+    activeModules.set(modulePath, moduleState);
+}
+function updateHandler(modulePath) {
+    let callbacks = [];
+    if (activeModules.has(modulePath)) {
+        // Create a copy of the callbacks to retain the current list in a closure for when the hot
+        // module is available. Otherwise, the incoming hot module's callback will also be invoked
+        // and removed. Thus future updates won't have a callback to process.
+        callbacks = [...hotModuleCbs.get(modulePath)];
+        return (hotModule) => {
+            callbacks.forEach((cb) => {
+                cb(hotModule);
+            });
+            const existingCbs = hotModuleCbs.get(modulePath) || [];
+            hotModuleCbs.set(modulePath, existingCbs.filter((cb) => !callbacks.includes(cb)));
+        };
+    }
+}
+/**
+ * Get module state for all active modules on the client.
+ * @returns An array of objects containing modulePath, hash and compiler config.
+ */
+function getActiveModules() {
+    return Array.from(activeModules.values());
+}
+
+/**
+ * This module is responsible for notfying the user about module updates in the server
+ **/
+class NotifyModuleUpdate {
+    constructor() {
+        this.observers = new Set();
+    }
+    register(observer) {
+        if (observer) {
+            this.observers.add(observer);
+        }
+    }
+    deregister(observer) {
+        if (observer) {
+            this.observers.delete(observer);
+        }
+    }
+    notify(message) {
+        this.observers.forEach((observer) => observer.notify(message));
+    }
+}
+
+class Connection {
+    constructor() {
+        this.protocol = 'ws';
+        this.host = 'localhost';
+        this.port = '8080';
+    }
+    init(protocol, host, port) {
+        this.protocol = protocol;
+        this.host = host;
+        this.port = port;
+    }
+    fetchModule(modulePath) {
+        const fetchData = { type: 'fetch', data: { modulePath } };
+        // fetch the new module from the server
+        // eval it and return the new module
+        this.send(fetchData);
+    }
+    initializeConnection(initCallback, messageCallback, errorCallback) {
+        const socket = new WebSocket(`${this.protocol}://${this.host}:${this.port}`);
+        this.socket = socket;
+        this.socket.addEventListener('error', () => {
+            if (errorCallback) {
+                errorCallback(new Error('Failed to start a WebSocket connection. Running page without Local Development support.'));
+            }
+        });
+        this.socket.addEventListener('open', () => {
+            initCallback();
+        });
+        this.socket.addEventListener('message', ({ data }) => {
+            if (data) {
+                // When there is an update, handle the incoming message and request an updated module
+                messageCallback(JSON.parse(data));
+            }
+        });
+    }
+    send(data) {
+        if (this.socket && this.socket.readyState === this.socket.OPEN) {
+            this.socket.send(JSON.stringify(data));
+        }
+    }
+    close() {
+        var _a;
+        (_a = this.socket) === null || _a === void 0 ? void 0 : _a.close();
+    }
+}
+
+class ConsoleNotifier {
+    notify(message) {
+        switch (message.eventType) {
+            case 'create':
+                console.log(`A new module was added at ${message.modulePath}`);
+                break;
+            case 'delete':
+                console.log(`A module was deleted at ${message.modulePath}`);
+                break;
+            case 'update':
+                console.log(`A source change detected at ${message.modulePath}`);
+                break;
+            case 'hot-swapped':
+                console.log(`Receipt a hot module with path ${message.modulePath}, attempting to hot swap`);
+                break;
+        }
+        if (message.action) {
+            console.log(`Taking the following action on module update ${message.action.message}`);
+        }
+    }
+}
+
+function initCallback() {
+    const activeModules = getActiveModules();
+    const initData = {
+        type: 'init',
+        data: {
+            url: window.location.href,
+            activePaths: activeModules.map((m) => {
+                return { type: 'register', data: m };
+            }),
+            target: 'LEX',
+        },
+    };
+    if (activeModules.length) {
+        hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.connection.send(initData);
+    }
+}
+const pendingHandlers = new Map();
+let hotModuleCounter = 0;
+function messageCallback(data) {
+    switch (data.type) {
+        // Some paths were updated
+        case 'update': {
+            const moduleUpdate = data;
+            moduleUpdate.data.forEach(({ modulePath }) => {
+                hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.notifyModuleUpdate.notify({
+                    eventType: 'update',
+                    modulePath,
+                });
+                const handler = updateHandler(modulePath);
+                if (handler) {
+                    // Possibly use the module hash as key and allow overlapping handlers for same path.
+                    pendingHandlers.set(modulePath, handler);
+                    hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.connection.fetchModule(modulePath);
+                }
+            });
+            break;
+        }
+        // In coming hot module
+        case 'module-update': {
+            const hotModules = data;
+            // Process each incoming hot module
+            hotModules.data.forEach(async ({ modulePath, src }) => {
+                hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.notifyModuleUpdate.notify({
+                    eventType: 'hot-swapped',
+                    modulePath,
+                });
+                // Step 1: extract the dependencies and owner path
+                const descriptors = extractDescriptorsFromSource(src);
+                if (descriptors && hmrClient) {
+                    // Step 2: Wait for dependencies to be fetched, waiting here also pauses the hot module processing
+                    await hmrClient.moduleHandlerHooks.fetchDependencies(descriptors.deps);
+                    // Step 3: Evaluate the hot module
+                    // Create temporary descriptor for the hot module
+                    const hotModulePath = modulePath + `-hmr-${hotModuleCounter++}`;
+                    const evaledModule = await (hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.moduleHandlerHooks.evaluateModule(descriptors.parentDescriptor, hotModulePath, adaptSourceForLex(src, hotModulePath, descriptors.parentDescriptor)));
+                    // Step 4: Invoke callback handler to use the hot module
+                    const handler = pendingHandlers.get(modulePath);
+                    handler(evaledModule);
+                }
+            });
+            break;
+        }
+        case 'module-delete': {
+            const deletedModule = data;
+            deletedModule.data.forEach(({ modulePath }) => {
+                hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.notifyModuleUpdate.notify({
+                    eventType: 'delete',
+                    modulePath,
+                });
+            });
+            // A module was deleted
+            // reload page?
+            break;
+        }
+        case 'error':
+            // eslint-disable-next-line no-console
+            console.log('LWC dev server encountered an error, reloading page');
+            window.location.reload();
+            break;
+    }
+}
+function extractDescriptorsFromSource(src) {
+    const amdPattern = /^define\('([^']+)',\s*\[([^\]]*)\],/;
+    const match = amdPattern.exec(src);
+    if (match) {
+        return {
+            parentDescriptor: match[1],
+            deps: match[2].split(',').map((i) => i.trim().replace(/[']/g, '')),
+        };
+    }
+}
+/**
+ * Adapt source provided by dev server to LEX format.
+ * Note: This logic comes from [core:]BundleModuleDefFactory.processCompiledCode()
+ * @param src compiled module file
+ */
+function adaptSourceForLex(src, hotModulePath, parentDescriptor) {
+    return src
+        .replace(`define('${parentDescriptor}',`, `function() { $A.componentService.addModule('${hotModulePath}', '${hotModulePath}',`)
+        .concat('}');
+}
+class HMRClient {
+    constructor(moduleHandlerHooks) {
+        this.notifyModuleUpdate = new NotifyModuleUpdate();
+        this.connection = new Connection();
+        this.moduleHandlerHooks = moduleHandlerHooks;
+    }
+}
+let hmrClient;
+function initializeClient(protocol, host, port, hotModuleHandler, errorCallback, observer) {
+    if (hmrClient)
+        return;
+    hmrClient = new HMRClient(hotModuleHandler);
+    // Register any container specific observers
+    hmrClient.notifyModuleUpdate.register(observer);
+    // Register a console logger
+    hmrClient.notifyModuleUpdate.register(new ConsoleNotifier());
+    // Initialize connection to dev server
+    hmrClient.connection.init(protocol, host, port);
+    hmrClient.connection.initializeConnection(initCallback, messageCallback, errorCallback);
+}
+
+exports.accept = accept;
+exports.acceptDeps = acceptDeps;
+exports.initializeHmrClient = initializeClient;
+exports.register = register;
+//# sourceMappingURL=index.cjs.js.map

package/dist/index.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs.js","sources":["../src/api.ts","../src/notify/notify.ts","../src/connection.ts","../src/notify/consoleNotifier.ts","../src/client.ts"],"sourcesContent":[null,null,null,null,null],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { initializeClient as initializeHmrClient } from './client';
+export { accept, register, acceptDeps } from './api';

package/dist/index.js

@@ -0,0 +1,280 @@
+/**
+ * LWC Hot Module Replacement(HMR) client code 
+ */
+const hotModuleCbs = new Map();
+function accept(modulePath, cb) {
+    const callbacks = hotModuleCbs.get(modulePath) || [];
+    callbacks.push(cb);
+    hotModuleCbs.set(modulePath, callbacks);
+}
+/**
+ * API call for owner module to ingest updates to dependencies.
+ * @param ownerPath {string} The owner module's path or module identifier.
+ * @param modulePath {string} The module path.
+ * @param cb {function} The callback function to invoke for self update.
+ */
+function acceptDeps(_ownerPath, modulePath, cb) {
+    const callbacks = hotModuleCbs.get(modulePath) || [];
+    callbacks.push(cb);
+    hotModuleCbs.set(modulePath, callbacks);
+}
+const activeModules = new Map();
+const staleModules = new Map();
+/**
+ * Register a module path used by the client along with its state.
+ * @param modulePath {string} The module path.
+ * @param hash {string} A hash representation of the module's source to perform freshness check.
+ * @param compileOptions {object} The compiler config that was used to bundle this module.
+ */
+function register(modulePath, hash, compileOptions) {
+    const moduleState = {
+        modulePath,
+        hash,
+        compileOptions,
+    };
+    const staleModule = activeModules.get(moduleState.modulePath);
+    if (staleModule) {
+        // This is a new version of an existing module
+        // Potentially clean up old handlers, call dispose()
+        staleModules.set(modulePath, staleModule);
+    }
+    activeModules.set(modulePath, moduleState);
+}
+function updateHandler(modulePath) {
+    let callbacks = [];
+    if (activeModules.has(modulePath)) {
+        // Create a copy of the callbacks to retain the current list in a closure for when the hot
+        // module is available. Otherwise, the incoming hot module's callback will also be invoked
+        // and removed. Thus future updates won't have a callback to process.
+        callbacks = [...hotModuleCbs.get(modulePath)];
+        return (hotModule) => {
+            callbacks.forEach((cb) => {
+                cb(hotModule);
+            });
+            const existingCbs = hotModuleCbs.get(modulePath) || [];
+            hotModuleCbs.set(modulePath, existingCbs.filter((cb) => !callbacks.includes(cb)));
+        };
+    }
+}
+/**
+ * Get module state for all active modules on the client.
+ * @returns An array of objects containing modulePath, hash and compiler config.
+ */
+function getActiveModules() {
+    return Array.from(activeModules.values());
+}
+
+/**
+ * This module is responsible for notfying the user about module updates in the server
+ **/
+class NotifyModuleUpdate {
+    constructor() {
+        this.observers = new Set();
+    }
+    register(observer) {
+        if (observer) {
+            this.observers.add(observer);
+        }
+    }
+    deregister(observer) {
+        if (observer) {
+            this.observers.delete(observer);
+        }
+    }
+    notify(message) {
+        this.observers.forEach((observer) => observer.notify(message));
+    }
+}
+
+class Connection {
+    constructor() {
+        this.protocol = 'ws';
+        this.host = 'localhost';
+        this.port = '8080';
+    }
+    init(protocol, host, port) {
+        this.protocol = protocol;
+        this.host = host;
+        this.port = port;
+    }
+    fetchModule(modulePath) {
+        const fetchData = { type: 'fetch', data: { modulePath } };
+        // fetch the new module from the server
+        // eval it and return the new module
+        this.send(fetchData);
+    }
+    initializeConnection(initCallback, messageCallback, errorCallback) {
+        const socket = new WebSocket(`${this.protocol}://${this.host}:${this.port}`);
+        this.socket = socket;
+        this.socket.addEventListener('error', () => {
+            if (errorCallback) {
+                errorCallback(new Error('Failed to start a WebSocket connection. Running page without Local Development support.'));
+            }
+        });
+        this.socket.addEventListener('open', () => {
+            initCallback();
+        });
+        this.socket.addEventListener('message', ({ data }) => {
+            if (data) {
+                // When there is an update, handle the incoming message and request an updated module
+                messageCallback(JSON.parse(data));
+            }
+        });
+    }
+    send(data) {
+        if (this.socket && this.socket.readyState === this.socket.OPEN) {
+            this.socket.send(JSON.stringify(data));
+        }
+    }
+    close() {
+        var _a;
+        (_a = this.socket) === null || _a === void 0 ? void 0 : _a.close();
+    }
+}
+
+class ConsoleNotifier {
+    notify(message) {
+        switch (message.eventType) {
+            case 'create':
+                console.log(`A new module was added at ${message.modulePath}`);
+                break;
+            case 'delete':
+                console.log(`A module was deleted at ${message.modulePath}`);
+                break;
+            case 'update':
+                console.log(`A source change detected at ${message.modulePath}`);
+                break;
+            case 'hot-swapped':
+                console.log(`Receipt a hot module with path ${message.modulePath}, attempting to hot swap`);
+                break;
+        }
+        if (message.action) {
+            console.log(`Taking the following action on module update ${message.action.message}`);
+        }
+    }
+}
+
+function initCallback() {
+    const activeModules = getActiveModules();
+    const initData = {
+        type: 'init',
+        data: {
+            url: window.location.href,
+            activePaths: activeModules.map((m) => {
+                return { type: 'register', data: m };
+            }),
+            target: 'LEX',
+        },
+    };
+    if (activeModules.length) {
+        hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.connection.send(initData);
+    }
+}
+const pendingHandlers = new Map();
+let hotModuleCounter = 0;
+function messageCallback(data) {
+    switch (data.type) {
+        // Some paths were updated
+        case 'update': {
+            const moduleUpdate = data;
+            moduleUpdate.data.forEach(({ modulePath }) => {
+                hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.notifyModuleUpdate.notify({
+                    eventType: 'update',
+                    modulePath,
+                });
+                const handler = updateHandler(modulePath);
+                if (handler) {
+                    // Possibly use the module hash as key and allow overlapping handlers for same path.
+                    pendingHandlers.set(modulePath, handler);
+                    hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.connection.fetchModule(modulePath);
+                }
+            });
+            break;
+        }
+        // In coming hot module
+        case 'module-update': {
+            const hotModules = data;
+            // Process each incoming hot module
+            hotModules.data.forEach(async ({ modulePath, src }) => {
+                hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.notifyModuleUpdate.notify({
+                    eventType: 'hot-swapped',
+                    modulePath,
+                });
+                // Step 1: extract the dependencies and owner path
+                const descriptors = extractDescriptorsFromSource(src);
+                if (descriptors && hmrClient) {
+                    // Step 2: Wait for dependencies to be fetched, waiting here also pauses the hot module processing
+                    await hmrClient.moduleHandlerHooks.fetchDependencies(descriptors.deps);
+                    // Step 3: Evaluate the hot module
+                    // Create temporary descriptor for the hot module
+                    const hotModulePath = modulePath + `-hmr-${hotModuleCounter++}`;
+                    const evaledModule = await (hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.moduleHandlerHooks.evaluateModule(descriptors.parentDescriptor, hotModulePath, adaptSourceForLex(src, hotModulePath, descriptors.parentDescriptor)));
+                    // Step 4: Invoke callback handler to use the hot module
+                    const handler = pendingHandlers.get(modulePath);
+                    handler(evaledModule);
+                }
+            });
+            break;
+        }
+        case 'module-delete': {
+            const deletedModule = data;
+            deletedModule.data.forEach(({ modulePath }) => {
+                hmrClient === null || hmrClient === void 0 ? void 0 : hmrClient.notifyModuleUpdate.notify({
+                    eventType: 'delete',
+                    modulePath,
+                });
+            });
+            // A module was deleted
+            // reload page?
+            break;
+        }
+        case 'error':
+            // eslint-disable-next-line no-console
+            console.log('LWC dev server encountered an error, reloading page');
+            window.location.reload();
+            break;
+    }
+}
+function extractDescriptorsFromSource(src) {
+    const amdPattern = /^define\('([^']+)',\s*\[([^\]]*)\],/;
+    const match = amdPattern.exec(src);
+    if (match) {
+        return {
+            parentDescriptor: match[1],
+            deps: match[2].split(',').map((i) => i.trim().replace(/[']/g, '')),
+        };
+    }
+}
+/**
+ * Adapt source provided by dev server to LEX format.
+ * Note: This logic comes from [core:]BundleModuleDefFactory.processCompiledCode()
+ * @param src compiled module file
+ */
+function adaptSourceForLex(src, hotModulePath, parentDescriptor) {
+    return src
+        .replace(`define('${parentDescriptor}',`, `function() { $A.componentService.addModule('${hotModulePath}', '${hotModulePath}',`)
+        .concat('}');
+}
+class HMRClient {
+    constructor(moduleHandlerHooks) {
+        this.notifyModuleUpdate = new NotifyModuleUpdate();
+        this.connection = new Connection();
+        this.moduleHandlerHooks = moduleHandlerHooks;
+    }
+}
+let hmrClient;
+function initializeClient(protocol, host, port, hotModuleHandler, errorCallback, observer) {
+    if (hmrClient)
+        return;
+    hmrClient = new HMRClient(hotModuleHandler);
+    // Register any container specific observers
+    hmrClient.notifyModuleUpdate.register(observer);
+    // Register a console logger
+    hmrClient.notifyModuleUpdate.register(new ConsoleNotifier());
+    // Initialize connection to dev server
+    hmrClient.connection.init(protocol, host, port);
+    hmrClient.connection.initializeConnection(initCallback, messageCallback, errorCallback);
+}
+
+export { accept, acceptDeps, initializeClient as initializeHmrClient, register };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../src/api.ts","../src/notify/notify.ts","../src/connection.ts","../src/notify/consoleNotifier.ts","../src/client.ts"],"sourcesContent":[null,null,null,null,null],"names":[],"mappings":"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"}

package/dist/notify/consoleNotifier.d.ts

@@ -0,0 +1,4 @@
+import { ModuleUpdateMessage, ModuleUpdateObserver } from './notify';
+export declare class ConsoleNotifier implements ModuleUpdateObserver {
+    notify(message: ModuleUpdateMessage): void;
+}

package/dist/notify/notify.d.ts

@@ -0,0 +1,26 @@
+/**
+ * This module is responsible for notfying the user about module updates in the server
+ **/
+interface HMRAction {
+    message: string;
+}
+interface PageReloadAction {
+    message: string;
+    action?: () => boolean;
+}
+declare type ModuleUpdateAction = HMRAction | PageReloadAction;
+export type ModuleUpdateMessage = {
+    modulePath: string;
+    eventType: 'update' | 'delete' | 'create' | 'hot-swapped';
+    action?: ModuleUpdateAction;
+};
+export type ModuleUpdateObserver = {
+    notify: (message: ModuleUpdateMessage) => void;
+};
+export declare class NotifyModuleUpdate {
+    observers: Set<ModuleUpdateObserver>;
+    register(observer: ModuleUpdateObserver | undefined): void;
+    deregister(observer: ModuleUpdateObserver | undefined): void;
+    notify(message: ModuleUpdateMessage): void;
+}
+export {};

package/package.json

@@ -0,0 +1,26 @@
+{
+    "name": "@lwc/hmr-client",
+    "description": "Provide hot module reloading capabilities to @lwc/engine-dom.",
+    "version": "7.0.0-6.6.3",
+    "keywords": [
+        "lwc dev server",
+        "lwc hmr plugin"
+    ],
+    "main": "dist/index.cjs.js",
+    "typings": "dist/index.d.ts",
+    "module": "dist/index.js",
+    "files": [
+        "dist",
+        "LICENSE.txt"
+    ],
+    "license": "SEE LICENSE IN LICENSE.txt",
+    "scripts": {
+        "build": "rollup --config ./scripts/rollup.config.js"
+    },
+    "dependencies": {},
+    "devDependencies": {
+        "@lwc/compiler": "6.6.3",
+        "@types/websocket": "^1.0.10",
+        "@lwc/lwc-dev-server-types": "7.0.0-6.6.3"
+    }
+}