@hubspot/ui-extensions-dev-server 0.10.1 → 1.0.0

package/dist/lib/plugins/manifestPlugin.d.ts

@@ -1,5 +1,5 @@
 import { Rollup } from 'vite';
-import { Logger, ManifestConfig } from '../types';
+import { Logger, ManifestConfig } from '../types.ts';
 export interface ManifestPluginOptions {
     output: string;
     minify?: boolean;

package/dist/lib/plugins/manifestPlugin.js

@@ -1,18 +1,24 @@
-"use strict";
-/* hs-eslint ignored failing-rules */
-/* eslint-disable hubspot-dev/no-unsupported-ts-syntax */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const fs_1 = require("fs");
-const path_1 = require("path");
-const constants_1 = require("../constants");
-const path_2 = __importDefault(require("path"));
-const utils_1 = require("../utils");
-const ast_1 = require("../ast");
+import { readFileSync } from 'fs';
+import { normalize } from 'path';
+import { MANIFEST_FILE } from "../constants.js";
+import path from 'path';
+import { isExtensionFile, isNodeModule } from "../utils.js";
+import { traverseAbstractSyntaxTree } from "../ast.js";
 const PACKAGE_LOCK_FILE = 'package-lock.json';
 const PACKAGE_FILE = 'package.json';
+/**
+ * Checks if a given filename is a valid module file path. This is necessary because
+ * Rollup sometimes passes in a filename that starts with a null byte, which is not a valid
+ * module file path. From the Rollup documentation:
+ *
+ * > If your plugin uses 'virtual modules' (e.g. for helper functions), prefix the module ID with \0.
+ * > This prevents other plugins from trying to process it.
+ * Source: https://rollupjs.org/plugin-development/#conventions
+ *
+ * @param filename The filename to check.
+ * @returns Whether the filename is a valid module file path.
+ */
+const isRealModuleFile = (filename) => typeof filename === 'string' && !filename.startsWith('\0');
 const manifestPlugin = (options) => {
     let allDataDependencies;
     return {
@@ -25,13 +31,14 @@ const manifestPlugin = (options) => {
         transform(code, filename) {
             const { logger } = options;
             // We only need to parse the AST for extension files, so check that first.
-            const isExtension = (0, utils_1.isExtensionFile)(filename, options.extensionPath || '');
+            const isExtension = isRealModuleFile(filename) &&
+                isExtensionFile(filename, options.extensionPath || '');
             if (!isExtension) {
                 return { code, map: null };
             }
             try {
                 const ast = this.parse(code);
-                const sourceCodeMetadata = (0, ast_1.traverseAbstractSyntaxTree)(ast, [], options.extensionPath || process.cwd(), logger);
+                const sourceCodeMetadata = traverseAbstractSyntaxTree(ast, [], options.extensionPath || process.cwd(), logger);
                 allDataDependencies = [
                     ...allDataDependencies,
                     ...sourceCodeMetadata.dataDependencies.dependencies,
@@ -46,14 +53,14 @@ const manifestPlugin = (options) => {
         generateBundle(_rollupOptions, bundle) {
             const { output, minify = false, extensionPath = process.cwd(), logger, } = options;
             try {
-                const filename = path_2.default.parse(output).name;
-                const manifest = _generateManifestContents(bundle, extensionPath, allDataDependencies, options === null || options === void 0 ? void 0 : options.manifestConfig);
+                const filename = path.parse(output).name;
+                const manifest = _generateManifestContents(bundle, extensionPath, allDataDependencies, options?.manifestConfig);
                 this.emitFile({
                     type: 'asset',
                     source: minify
                         ? JSON.stringify(manifest)
                         : JSON.stringify(manifest, null, 2),
-                    fileName: (0, path_1.normalize)(`${filename}-${constants_1.MANIFEST_FILE}`),
+                    fileName: normalize(`${filename}-${MANIFEST_FILE}`),
                 });
             }
             catch (e) {
@@ -67,7 +74,7 @@ function _generateManifestContents(bundle, extensionPath, allDataDependencies, a
         package: _loadPackageFile(extensionPath),
     };
     const dataDependencies = {
-        dataDeps: allDataDependencies !== null && allDataDependencies !== void 0 ? allDataDependencies : [],
+        dataDeps: allDataDependencies ?? [],
     };
     const variables = {
         variables: {},
@@ -81,12 +88,25 @@ function _generateManifestContents(bundle, extensionPath, allDataDependencies, a
     // The keys to bundle are the filename without any path information
     const bundles = Object.keys(bundle).filter((cur) => cur.endsWith('.js'));
     if (bundles.length === 1) {
-        return Object.assign(Object.assign(Object.assign(Object.assign({}, _generateManifestEntry(bundle[bundles[0]], extensionPath)), dataDependencies), baseManifest), variables);
+        return {
+            ..._generateManifestEntry(bundle[bundles[0]], extensionPath),
+            ...dataDependencies,
+            ...baseManifest,
+            ...variables,
+        };
     }
     const manifest = bundles.reduce((acc, current) => {
-        return Object.assign(Object.assign({}, acc), { [current]: _generateManifestEntry(bundle[current], extensionPath) });
+        return {
+            ...acc,
+            [current]: _generateManifestEntry(bundle[current], extensionPath),
+        };
     }, {});
-    return Object.assign(Object.assign(Object.assign(Object.assign({}, manifest), dataDependencies), baseManifest), variables);
+    return {
+        ...manifest,
+        ...dataDependencies,
+        ...baseManifest,
+        ...variables,
+    };
 }
 function _generateManifestEntry(subBundle, extensionPath) {
     const { facadeModuleId, moduleIds, modules } = subBundle;
@@ -97,7 +117,7 @@ function _generateManifestEntry(subBundle, extensionPath) {
 }
 function _loadJsonFileSafely(extensionPath, filename) {
     try {
-        return JSON.parse((0, fs_1.readFileSync)(path_2.default.join(extensionPath, filename)).toString());
+        return JSON.parse(readFileSync(path.join(extensionPath, filename)).toString());
     }
     catch (e) {
         return undefined;
@@ -113,7 +133,7 @@ function _stripPathPriorToExtDir(filepath, extensionPath) {
     extensionPath = extensionPath.endsWith('/')
         ? extensionPath
         : `${extensionPath}/`;
-    return filepath === null || filepath === void 0 ? void 0 : filepath.split(extensionPath).pop();
+    return filepath?.split(extensionPath).pop();
 }
 function _buildModulesInfo(moduleIds, modules, extensionPath) {
     const accumulator = {
@@ -126,7 +146,7 @@ function _buildModulesInfo(moduleIds, modules, extensionPath) {
             module: _stripPathPriorToExtDir(mod, extensionPath),
             renderedExports,
         };
-        if ((0, utils_1.isNodeModule)(moduleData.module)) {
+        if (isNodeModule(moduleData.module)) {
             acc.external.push(moduleData);
         }
         else {
@@ -135,4 +155,4 @@ function _buildModulesInfo(moduleIds, modules, extensionPath) {
         return acc;
     }, accumulator);
 }
-exports.default = manifestPlugin;
+export default manifestPlugin;

package/dist/lib/plugins/relevantModulesPlugin.d.ts

@@ -1,5 +1,5 @@
-import Vite from 'vite';
-import { Logger } from '../types';
+import * as Vite from 'vite';
+import { Logger } from '../types.ts';
 export interface RelevantModules {
     [key: string]: string[];
 }

package/dist/lib/plugins/relevantModulesPlugin.js

@@ -1,9 +1,6 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getRelevantModules = getRelevantModules;
-const utils_1 = require("../utils");
+import { isNodeModule } from "../utils.js";
 const relevantModules = {};
-function getRelevantModules(output) {
+export function getRelevantModules(output) {
     return relevantModules[output] || [];
 }
 const relevantModulesPlugin = ({ output, logger }) => {
@@ -16,7 +13,7 @@ const relevantModulesPlugin = ({ output, logger }) => {
                 logger.error('Invalid bundle format, please try saving the extension again.  If the problem persists try restarting `hs project dev`');
                 return;
             }
-            const updatedRelevantModules = subBundle.moduleIds.filter((moduleId) => !(0, utils_1.isNodeModule)(moduleId));
+            const updatedRelevantModules = subBundle.moduleIds.filter((moduleId) => !isNodeModule(moduleId));
             if (updatedRelevantModules.length === 0) {
                 logger.error('Unable to determine relevant files to watch, please try saving the extension again. If the problem persists try restarting `hs project dev`');
                 return;
@@ -25,4 +22,4 @@ const relevantModulesPlugin = ({ output, logger }) => {
         },
     };
 };
-exports.default = relevantModulesPlugin;
+export default relevantModulesPlugin;

package/dist/lib/server.d.ts

@@ -1,8 +1,13 @@
+import { Server } from 'http';
 import { ViteDevServer } from 'vite';
-import { DevServerState } from './DevServerState';
+import { DevServerState } from './DevServerState.ts';
 interface StartDevServerArgs {
     devServerState: DevServerState;
     viteDevServer: ViteDevServer;
 }
-declare function startDevServer({ devServerState, viteDevServer, }: StartDevServerArgs): Promise<() => Promise<void>>;
+interface StartDevServerReturn {
+    httpServer: Server;
+    shutdown: () => Promise<void>;
+}
+declare function startDevServer({ devServerState, viteDevServer, }: StartDevServerArgs): Promise<StartDevServerReturn>;
 export default startDevServer;

package/dist/lib/server.js

@@ -1,25 +1,10 @@
-"use strict";
-/* eslint-disable hubspot-dev/no-unsupported-ts-syntax */
-/* eslint-disable no-unused-expressions */
-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 __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const express_1 = __importDefault(require("express"));
-const cors_1 = __importDefault(require("cors"));
-const constants_1 = require("./constants");
-const extensionsService_1 = __importDefault(require("./extensionsService"));
-const app_functions_dev_server_1 = require("@hubspot/app-functions-dev-server");
-const utils_1 = require("./utils");
+import express from 'express';
+import cors from 'cors';
+import { PROXY_CAPABILITY, SERVER_CAPABILITIES } from "./constants.js";
+import extensionsService from "./extensionsService.js";
+import { AppFunctionExecutionService, AppProxyService, } from '@hubspot/app-functions-dev-server';
+import { extractAllowedUrls } from "./utils.js";
+import { ExtensionsWebSocket } from "./ExtensionsWebSocket.js";
 function listen(app, port) {
     return new Promise((resolve, reject) => {
         const server = app
@@ -31,68 +16,84 @@ function listen(app, port) {
         });
     });
 }
-function startDevServer(_a) {
-    return __awaiter(this, arguments, void 0, function* ({ devServerState, viteDevServer, }) {
-        var _b;
-        const app = (0, express_1.default)();
-        // Setup middleware
-        app.use((0, cors_1.default)());
-        app.use(express_1.default.static(devServerState.outputDir));
-        const capabilities = [...constants_1.SERVER_CAPABILITIES];
-        const middlewares = [];
-        if (!devServerState.isPublicApp()) {
-            middlewares.push((0, app_functions_dev_server_1.AppFunctionExecutionService)(Object.assign(Object.assign({}, devServerState.functionsConfig), { logger: devServerState.logger })));
-            devServerState.logger.info(`Serving app functions locally (platform version ${devServerState.functionsConfig.platformVersion})`);
-        }
-        if (devServerState.localDevUrlMapping &&
-            Object.keys(devServerState.localDevUrlMapping).length > 0) {
-            devServerState.logger.info('Proxy config discovered, enabling local proxy mode');
-            middlewares.push((0, app_functions_dev_server_1.AppProxyService)({
-                localDevUrlMapping: devServerState.localDevUrlMapping,
-                logger: devServerState.logger,
-                accountId: devServerState.functionsConfig.accountId,
-                allowedUrls: (0, utils_1.extractAllowedUrls)(devServerState.appConfig),
-            }));
-            capabilities.push(constants_1.PROXY_CAPABILITY);
-        }
-        if (middlewares.length > 0) {
-            app.use('/api/crm-extensibility/execution/internal/v3', ...middlewares);
-        }
-        const endpointsAdded = extensionsService_1.default.add(app, devServerState, capabilities);
-        const { expressPort } = devServerState;
-        endpointsAdded.forEach((endpoint) => {
-            devServerState.logger.debug(`Listening at http://hslocal.net:${expressPort}${endpoint}`);
-        });
-        // Vite middlewares needs to go last because it's greedy and will block other middleware
-        app.use(viteDevServer.middlewares);
-        let server;
-        try {
-            server = yield listen(app, devServerState.expressPort);
-        }
-        catch (e) {
-            if (e.code === 'EADDRINUSE') {
-                throw new Error(`Port ${devServerState.expressPort} is already in use.`);
-            }
-            throw new Error(e);
+async function startDevServer({ devServerState, viteDevServer, }) {
+    const app = express();
+    // Setup middleware
+    app.use(cors());
+    app.use(express.static(devServerState.outputDir));
+    const capabilities = [...SERVER_CAPABILITIES];
+    const middlewares = [];
+    if (!devServerState.isPublicApp()) {
+        middlewares.push(AppFunctionExecutionService({
+            ...devServerState.functionsConfig,
+            logger: devServerState.logger,
+        }));
+        devServerState.logger.info(`Serving app functions locally (platform version ${devServerState.functionsConfig.platformVersion})`);
+    }
+    if (devServerState.localDevUrlMapping &&
+        Object.keys(devServerState.localDevUrlMapping).length > 0) {
+        devServerState.logger.info('Proxy config discovered, enabling local proxy mode');
+        middlewares.push(AppProxyService({
+            localDevUrlMapping: devServerState.localDevUrlMapping,
+            logger: devServerState.logger,
+            accountId: devServerState.functionsConfig.accountId,
+            allowedUrls: extractAllowedUrls(devServerState.appConfig),
+        }));
+        capabilities.push(PROXY_CAPABILITY);
+    }
+    if (middlewares.length > 0) {
+        app.use('/api/crm-extensibility/execution/internal/v3', ...middlewares);
+    }
+    const endpointsAdded = extensionsService.add(app, devServerState, capabilities);
+    const { expressPort } = devServerState;
+    endpointsAdded.forEach((endpoint) => {
+        devServerState.logger.debug(`Listening at http://hslocal.net:${expressPort}${endpoint}`);
+    });
+    // Vite middlewares needs to go last because it's greedy and will block other middleware
+    app.use(viteDevServer.middlewares);
+    let server;
+    try {
+        server = await listen(app, devServerState.expressPort);
+    }
+    catch (e) {
+        if (e.code === 'EADDRINUSE') {
+            throw new Error(`Port ${devServerState.expressPort} is already in use.`);
         }
-        (_b = devServerState.extensionsMetadata) === null || _b === void 0 ? void 0 : _b.forEach((metadata) => {
-            const { baseMessage } = metadata;
-            devServerState.logger.debug(`Listening at ${baseMessage.callback}`);
-        });
-        return function shutdown() {
-            return __awaiter(this, void 0, void 0, function* () {
-                try {
-                    yield viteDevServer.pluginContainer.close();
-                    // Stop new connections to express server
-                    server.close(() => { });
-                    yield viteDevServer.close();
-                }
-                catch (e) {
-                    devServerState.logger.debug(`Error shutting down ${e}`);
-                }
-                devServerState.logger.info('Extension dev server done cleaning up');
-            });
-        };
+        throw new Error(e);
+    }
+    /**
+     * We use a custom WebSocket server instead of Vite's built-in one because:
+     * 1. We send HubSpot-specific extension metadata (not standard HMR messages)
+     * 2. We need cross-origin connections from HubSpot iframes
+     * 3. Our message format { event: 'start', ...metadata } doesn't match Vite's protocol
+     */
+    const wss = new ExtensionsWebSocket(server, devServerState);
+    devServerState.extensionsWebSocket = wss;
+    // Trigger the WebSocket setup that was deferred from the plugin's configureServer hook
+    // This must happen after the WebSocket is initialized to avoid race conditions
+    devServerState.triggerWebSocketSetup();
+    devServerState.extensionsMetadata?.forEach((metadata) => {
+        const { baseMessage } = metadata;
+        devServerState.logger.debug(`Listening at ${baseMessage.callback}`);
     });
+    return {
+        httpServer: server,
+        shutdown: async function shutdown() {
+            try {
+                await viteDevServer.pluginContainer.close();
+                // Close WebSocket server first to reject new connections
+                await devServerState.getExtensionsWebSocket().close();
+                // Close HTTP server
+                await new Promise((resolve) => {
+                    server.close(() => resolve());
+                });
+                await viteDevServer.close();
+            }
+            catch (e) {
+                devServerState.logger.debug(`Error shutting down ${e}`);
+            }
+            devServerState.logger.info('Extension dev server done cleaning up');
+        },
+    };
 }
-exports.default = startDevServer;
+export default startDevServer;

package/dist/lib/types.d.ts

@@ -1,4 +1,4 @@
-import { PLATFORM_VERSION, PRIVATE_APP, PUBLIC_APP } from './constants';
+import { PLATFORM_VERSION, PRIVATE_APP, PUBLIC_APP } from './constants.ts';
 import { LocalDevUrlMapping } from '@hubspot/app-functions-dev-server';
 export interface ObjectTypes {
     name: string;

package/dist/lib/types.js

@@ -1,15 +1,12 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnifiedComponentTypes = exports.UnifiedAppAuthTypes = void 0;
-var UnifiedAppAuthTypes;
+export var UnifiedAppAuthTypes;
 (function (UnifiedAppAuthTypes) {
     UnifiedAppAuthTypes["OAUTH"] = "OAUTH";
     UnifiedAppAuthTypes["STATIC"] = "STATIC";
-})(UnifiedAppAuthTypes || (exports.UnifiedAppAuthTypes = UnifiedAppAuthTypes = {}));
-var UnifiedComponentTypes;
+})(UnifiedAppAuthTypes || (UnifiedAppAuthTypes = {}));
+export var UnifiedComponentTypes;
 (function (UnifiedComponentTypes) {
     UnifiedComponentTypes["CARD"] = "CARD";
     UnifiedComponentTypes["APPLICATION"] = "APPLICATION";
     UnifiedComponentTypes["SETTINGS"] = "SETTINGS";
     UnifiedComponentTypes["PAGE"] = "PAGE";
-})(UnifiedComponentTypes || (exports.UnifiedComponentTypes = UnifiedComponentTypes = {}));
+})(UnifiedComponentTypes || (UnifiedComponentTypes = {}));

package/dist/lib/utils.d.ts

@@ -1,4 +1,4 @@
-import { AppConfig, ExtensionConfig } from './types';
+import { AppConfig, ExtensionConfig } from './types.ts';
 export declare function getUrlSafeFileName(filePath: string): string;
 export declare function stripAnsiColorCodes(stringWithColorCodes: string | undefined | null): string | null;
 export declare function loadManifest(outputDir: string, output: string): any;

package/dist/lib/utils.js

@@ -1,28 +1,12 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.UnhandledPlatformVersionError = void 0;
-exports.getUrlSafeFileName = getUrlSafeFileName;
-exports.stripAnsiColorCodes = stripAnsiColorCodes;
-exports.loadManifest = loadManifest;
-exports.buildSourceId = buildSourceId;
-exports.isNodeModule = isNodeModule;
-exports.isExtensionFile = isExtensionFile;
-exports.throwUnhandledPlatformVersionError = throwUnhandledPlatformVersionError;
-exports.extractAllowedUrls = extractAllowedUrls;
-exports.generateHash = generateHash;
-exports.isImage = isImage;
-const path_1 = __importDefault(require("path"));
-const fs_1 = __importDefault(require("fs"));
-const constants_1 = require("./constants");
-function getUrlSafeFileName(filePath) {
-    const { name } = path_1.default.parse(filePath);
+import path from 'path';
+import fs from 'fs';
+import { MANIFEST_FILE } from "./constants.js";
+export function getUrlSafeFileName(filePath) {
+    const { name } = path.parse(filePath);
     return encodeURIComponent(`${name}.js`);
 }
 // Strips ANSI color codes out of strings because we don't want to pass them to the browser
-function stripAnsiColorCodes(stringWithColorCodes) {
+export function stripAnsiColorCodes(stringWithColorCodes) {
     if (!stringWithColorCodes) {
         return null;
     }
@@ -30,41 +14,41 @@ function stripAnsiColorCodes(stringWithColorCodes) {
     // eslint-disable-next-line no-control-regex
     /[\u001b][[]*([0-9]{1,4};?)*[m]/g, '');
 }
-function loadManifest(outputDir, output) {
+export function loadManifest(outputDir, output) {
     try {
-        return JSON.parse(fs_1.default
-            .readFileSync(path_1.default.join(outputDir, `${output}-${constants_1.MANIFEST_FILE}`))
+        return JSON.parse(fs
+            .readFileSync(path.join(outputDir, `${output}-${MANIFEST_FILE}`))
             .toString());
     }
     catch (e) {
         return {};
     }
 }
-function buildSourceId(appConfig, extensionConfig) {
+export function buildSourceId(appConfig, extensionConfig) {
     if (appConfig.uid && extensionConfig.data.uid) {
         return `${appConfig.uid}::${extensionConfig.data.uid}`;
     }
     return null;
 }
-function isNodeModule(filepath) {
+export function isNodeModule(filepath) {
     if (!filepath) {
         return false;
     }
-    const directory = path_1.default.parse(filepath).dir;
+    const directory = path.parse(filepath).dir;
     return directory.includes('node_modules');
 }
 /**
  * Check if a given file is within the extension path
  */
-function isExtensionFile(filepath, extensionPath) {
+export function isExtensionFile(filepath, extensionPath) {
     if (!filepath) {
         return false;
     }
     try {
-        const absoluteFilePath = fs_1.default.realpathSync(filepath);
-        const absoluteExtensionDirPath = fs_1.default.realpathSync(extensionPath);
-        const relativePath = path_1.default.relative(absoluteExtensionDirPath, absoluteFilePath);
-        return !relativePath.startsWith('..') && !path_1.default.isAbsolute(relativePath);
+        const absoluteFilePath = fs.realpathSync(filepath);
+        const absoluteExtensionDirPath = fs.realpathSync(extensionPath);
+        const relativePath = path.relative(absoluteExtensionDirPath, absoluteFilePath);
+        return !relativePath.startsWith('..') && !path.isAbsolute(relativePath);
     }
     catch (e) {
         console.log(`Error checking if ${filepath} is in extension path: ${e}`);
@@ -72,16 +56,15 @@ function isExtensionFile(filepath, extensionPath) {
         return false;
     }
 }
-class UnhandledPlatformVersionError extends Error {
+export class UnhandledPlatformVersionError extends Error {
     constructor(platformVersion) {
         super(`Unsupported platform version "${platformVersion}"`);
     }
 }
-exports.UnhandledPlatformVersionError = UnhandledPlatformVersionError;
-function throwUnhandledPlatformVersionError(platformVersion) {
+export function throwUnhandledPlatformVersionError(platformVersion) {
     throw new UnhandledPlatformVersionError(platformVersion);
 }
-function extractAllowedUrls(appConfig) {
+export function extractAllowedUrls(appConfig) {
     if (!appConfig || !('allowedUrls' in appConfig) || !appConfig.allowedUrls) {
         return [];
     }
@@ -100,7 +83,7 @@ function simpleHash(input) {
  * Arrays and objects are stringified to ensure it works for all types.
  * Uses the same simple hash algorithm as the browser version for consistency.
  */
-function generateHash(...args) {
+export function generateHash(...args) {
     try {
         // First make sure all the values are strings
         const normalizedArgs = args.map((arg) => {
@@ -125,6 +108,6 @@ function generateHash(...args) {
 /**
  * Check if a given URL is an image (of a type we support)
  */
-function isImage(url) {
+export function isImage(url) {
     return /\.(png|jpg|jpeg|gif|svg|webp|avif|raw|url|inline)$/.test(url);
 }