var { _optionalChain } = require('@sentry/utils'); Object.defineProperty(exports, '__esModule', { value: true }); const core = require('@sentry/core'); const utils = require('@sentry/utils'); const debugBuild = require('../../common/debug-build.js'); const nodeUtils = require('./utils/node-utils.js'); /* eslint-disable max-lines */ /** * Express integration * * Provides an request and error handler for Express framework as well as tracing capabilities */ class Express { /** * @inheritDoc */ static __initStatic() {this.id = 'Express';} /** * @inheritDoc */ /** * Express App instance */ /** * @inheritDoc */ constructor(options = {}) { this.name = Express.id; this._router = options.router || options.app; this._methods = (Array.isArray(options.methods) ? options.methods : []).concat('use'); } /** * @inheritDoc */ setupOnce(_, getCurrentHub) { if (!this._router) { debugBuild.DEBUG_BUILD && utils.logger.error('ExpressIntegration is missing an Express instance'); return; } if (nodeUtils.shouldDisableAutoInstrumentation(getCurrentHub)) { debugBuild.DEBUG_BUILD && utils.logger.log('Express Integration is skipped because of instrumenter configuration.'); return; } instrumentMiddlewares(this._router, this._methods); instrumentRouter(this._router ); } }Express.__initStatic(); /** * Wraps original middleware function in a tracing call, which stores the info about the call as a span, * and finishes it once the middleware is done invoking. * * Express middlewares have 3 various forms, thus we have to take care of all of them: * // sync * app.use(function (req, res) { ... }) * // async * app.use(function (req, res, next) { ... }) * // error handler * app.use(function (err, req, res, next) { ... }) * * They all internally delegate to the `router[method]` of the given application instance. */ // eslint-disable-next-line @typescript-eslint/ban-types, @typescript-eslint/no-explicit-any function wrap(fn, method) { const arity = fn.length; switch (arity) { case 2: { return function ( req, res) { const transaction = res.__sentry_transaction; if (transaction) { // eslint-disable-next-line deprecation/deprecation const span = transaction.startChild({ description: fn.name, op: `middleware.express.${method}`, origin: 'auto.middleware.express', }); res.once('finish', () => { span.end(); }); } return fn.call(this, req, res); }; } case 3: { return function ( req, res, next, ) { const transaction = res.__sentry_transaction; // eslint-disable-next-line deprecation/deprecation const span = _optionalChain([transaction, 'optionalAccess', _2 => _2.startChild, 'call', _3 => _3({ description: fn.name, op: `middleware.express.${method}`, origin: 'auto.middleware.express', })]); fn.call(this, req, res, function ( ...args) { _optionalChain([span, 'optionalAccess', _4 => _4.end, 'call', _5 => _5()]); next.call(this, ...args); }); }; } case 4: { return function ( err, req, res, next, ) { const transaction = res.__sentry_transaction; // eslint-disable-next-line deprecation/deprecation const span = _optionalChain([transaction, 'optionalAccess', _6 => _6.startChild, 'call', _7 => _7({ description: fn.name, op: `middleware.express.${method}`, origin: 'auto.middleware.express', })]); fn.call(this, err, req, res, function ( ...args) { _optionalChain([span, 'optionalAccess', _8 => _8.end, 'call', _9 => _9()]); next.call(this, ...args); }); }; } default: { throw new Error(`Express middleware takes 2-4 arguments. Got: ${arity}`); } } } /** * Takes all the function arguments passed to the original `app` or `router` method, eg. `app.use` or `router.use` * and wraps every function, as well as array of functions with a call to our `wrap` method. * We have to take care of the arrays as well as iterate over all of the arguments, * as `app.use` can accept middlewares in few various forms. * * app.use([], ) * app.use([], , ...) * app.use([], ...[]) */ function wrapMiddlewareArgs(args, method) { return args.map((arg) => { if (typeof arg === 'function') { return wrap(arg, method); } if (Array.isArray(arg)) { return arg.map((a) => { if (typeof a === 'function') { return wrap(a, method); } return a; }); } return arg; }); } /** * Patches original router to utilize our tracing functionality */ function patchMiddleware(router, method) { const originalCallback = router[method]; router[method] = function (...args) { return originalCallback.call(this, ...wrapMiddlewareArgs(args, method)); }; return router; } /** * Patches original router methods */ function instrumentMiddlewares(router, methods = []) { methods.forEach((method) => patchMiddleware(router, method)); } /** * Patches the prototype of Express.Router to accumulate the resolved route * if a layer instance's `match` function was called and it returned a successful match. * * @see https://github.com/expressjs/express/blob/master/lib/router/index.js * * @param appOrRouter the router instance which can either be an app (i.e. top-level) or a (nested) router. */ function instrumentRouter(appOrRouter) { // This is how we can distinguish between app and routers const isApp = 'settings' in appOrRouter; // In case the app's top-level router hasn't been initialized yet, we have to do it now if (isApp && appOrRouter._router === undefined && appOrRouter.lazyrouter) { appOrRouter.lazyrouter(); } const router = isApp ? appOrRouter._router : appOrRouter; if (!router) { /* If we end up here, this means likely that this integration is used with Express 3 or Express 5. For now, we don't support these versions (3 is very old and 5 is still in beta). To support Express 5, we'd need to make more changes to the routing instrumentation because the router is no longer part of the Express core package but maintained in its own package. The new router has different function signatures and works slightly differently, demanding more changes than just taking the router from `app.router` instead of `app._router`. @see https://github.com/pillarjs/router TODO: Proper Express 5 support */ debugBuild.DEBUG_BUILD && utils.logger.debug('Cannot instrument router for URL Parameterization (did not find a valid router).'); debugBuild.DEBUG_BUILD && utils.logger.debug('Routing instrumentation is currently only supported in Express 4.'); return; } const routerProto = Object.getPrototypeOf(router) ; const originalProcessParams = routerProto.process_params; routerProto.process_params = function process_params( layer, called, req, res, done, ) { // Base case: We're in the first part of the URL (thus we start with the root '/') if (!req._reconstructedRoute) { req._reconstructedRoute = ''; } // If the layer's partial route has params, is a regex or an array, the route is stored in layer.route. const { layerRoutePath, isRegex, isArray, numExtraSegments } = getLayerRoutePathInfo(layer); if (layerRoutePath || isRegex || isArray) { req._hasParameters = true; } // Otherwise, the hardcoded path (i.e. a partial route without params) is stored in layer.path let partialRoute; if (layerRoutePath) { partialRoute = layerRoutePath; } else { /** * prevent duplicate segment in _reconstructedRoute param if router match multiple routes before final path * example: * original url: /api/v1/1234 * prevent: /api/api/v1/:userId * router structure * /api -> middleware * /api/v1 -> middleware * /1234 -> endpoint with param :userId * final _reconstructedRoute is /api/v1/:userId */ partialRoute = preventDuplicateSegments(req.originalUrl, req._reconstructedRoute, layer.path) || ''; } // Normalize the partial route so that it doesn't contain leading or trailing slashes // and exclude empty or '*' wildcard routes. // The exclusion of '*' routes is our best effort to not "pollute" the transaction name // with interim handlers (e.g. ones that check authentication or do other middleware stuff). // We want to end up with the parameterized URL of the incoming request without any extraneous path segments. const finalPartialRoute = partialRoute .split('/') .filter(segment => segment.length > 0 && (isRegex || isArray || !segment.includes('*'))) .join('/'); // If we found a valid partial URL, we append it to the reconstructed route if (finalPartialRoute && finalPartialRoute.length > 0) { // If the partial route is from a regex route, we append a '/' to close the regex req._reconstructedRoute += `/${finalPartialRoute}${isRegex ? '/' : ''}`; } // Now we check if we are in the "last" part of the route. We determine this by comparing the // number of URL segments from the original URL to that of our reconstructed parameterized URL. // If we've reached our final destination, we update the transaction name. const urlLength = utils.getNumberOfUrlSegments(utils.stripUrlQueryAndFragment(req.originalUrl || '')) + numExtraSegments; const routeLength = utils.getNumberOfUrlSegments(req._reconstructedRoute); if (urlLength === routeLength) { if (!req._hasParameters) { if (req._reconstructedRoute !== req.originalUrl) { req._reconstructedRoute = req.originalUrl ? utils.stripUrlQueryAndFragment(req.originalUrl) : req.originalUrl; } } const transaction = res.__sentry_transaction; const attributes = (transaction && core.spanToJSON(transaction).data) || {}; if (transaction && attributes[core.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE] !== 'custom') { // If the request URL is '/' or empty, the reconstructed route will be empty. // Therefore, we fall back to setting the final route to '/' in this case. const finalRoute = req._reconstructedRoute || '/'; const [name, source] = utils.extractPathForTransaction(req, { path: true, method: true, customRoute: finalRoute }); transaction.updateName(name); transaction.setAttribute(core.SEMANTIC_ATTRIBUTE_SENTRY_SOURCE, source); } } return originalProcessParams.call(this, layer, called, req, res, done); }; } /** * Recreate layer.route.path from layer.regexp and layer.keys. * Works until express.js used package path-to-regexp@0.1.7 * or until layer.keys contain offset attribute * * @param layer the layer to extract the stringified route from * * @returns string in layer.route.path structure 'router/:pathParam' or undefined */ const extractOriginalRoute = ( path, regexp, keys, ) => { if (!path || !regexp || !keys || Object.keys(keys).length === 0 || !_optionalChain([keys, 'access', _10 => _10[0], 'optionalAccess', _11 => _11.offset])) { return undefined; } const orderedKeys = keys.sort((a, b) => a.offset - b.offset); // add d flag for getting indices from regexp result // eslint-disable-next-line @sentry-internal/sdk/no-regexp-constructor -- regexp comes from express.js const pathRegex = new RegExp(regexp, `${regexp.flags}d`); /** * use custom type cause of TS error with missing indices in RegExpExecArray */ const execResult = pathRegex.exec(path) ; if (!execResult || !execResult.indices) { return undefined; } /** * remove first match from regex cause contain whole layer.path */ const [, ...paramIndices] = execResult.indices; if (paramIndices.length !== orderedKeys.length) { return undefined; } let resultPath = path; let indexShift = 0; /** * iterate param matches from regexp.exec */ paramIndices.forEach((item, index) => { /** check if offsets is define because in some cases regex d flag returns undefined */ if (item) { const [startOffset, endOffset] = item; /** * isolate part before param */ const substr1 = resultPath.substring(0, startOffset - indexShift); /** * define paramName as replacement in format :pathParam */ const replacement = `:${orderedKeys[index].name}`; /** * isolate part after param */ const substr2 = resultPath.substring(endOffset - indexShift); /** * recreate original path but with param replacement */ resultPath = substr1 + replacement + substr2; /** * calculate new index shift after resultPath was modified */ indexShift = indexShift + (endOffset - startOffset - replacement.length); } }); return resultPath; }; /** * Extracts and stringifies the layer's route which can either be a string with parameters (`users/:id`), * a RegEx (`/test/`) or an array of strings and regexes (`['/path1', /\/path[2-5]/, /path/:id]`). Additionally * returns extra information about the route, such as if the route is defined as regex or as an array. * * @param layer the layer to extract the stringified route from * * @returns an object containing the stringified route, a flag determining if the route was a regex * and the number of extra segments to the matched path that are additionally in the route, * if the route was an array (defaults to 0). */ function getLayerRoutePathInfo(layer) { let lrp = _optionalChain([layer, 'access', _12 => _12.route, 'optionalAccess', _13 => _13.path]); const isRegex = utils.isRegExp(lrp); const isArray = Array.isArray(lrp); if (!lrp) { // parse node.js major version // Next.js will complain if we directly use `proces.versions` here because of edge runtime. const [major] = (utils.GLOBAL_OBJ ).process.versions.node.split('.').map(Number); // allow call extractOriginalRoute only if node version support Regex d flag, node 16+ if (major >= 16) { /** * If lrp does not exist try to recreate original layer path from route regexp */ lrp = extractOriginalRoute(layer.path, layer.regexp, layer.keys); } } if (!lrp) { return { isRegex, isArray, numExtraSegments: 0 }; } const numExtraSegments = isArray ? Math.max(getNumberOfArrayUrlSegments(lrp ) - utils.getNumberOfUrlSegments(layer.path || ''), 0) : 0; const layerRoutePath = getLayerRoutePathString(isArray, lrp); return { layerRoutePath, isRegex, isArray, numExtraSegments }; } /** * Returns the number of URL segments in an array of routes * * Example: ['/api/test', /\/api\/post[0-9]/, '/users/:id/details`] -> 7 */ function getNumberOfArrayUrlSegments(routesArray) { return routesArray.reduce((accNumSegments, currentRoute) => { // array members can be a RegEx -> convert them toString return accNumSegments + utils.getNumberOfUrlSegments(currentRoute.toString()); }, 0); } /** * Extracts and returns the stringified version of the layers route path * Handles route arrays (by joining the paths together) as well as RegExp and normal * string values (in the latter case the toString conversion is technically unnecessary but * it doesn't hurt us either). */ function getLayerRoutePathString(isArray, lrp) { if (isArray) { return (lrp ).map(r => r.toString()).join(','); } return lrp && lrp.toString(); } /** * remove duplicate segment contain in layerPath against reconstructedRoute, * and return only unique segment that can be added into reconstructedRoute */ function preventDuplicateSegments( originalUrl, reconstructedRoute, layerPath, ) { // filter query params const normalizeURL = utils.stripUrlQueryAndFragment(originalUrl || ''); const originalUrlSplit = _optionalChain([normalizeURL, 'optionalAccess', _14 => _14.split, 'call', _15 => _15('/'), 'access', _16 => _16.filter, 'call', _17 => _17(v => !!v)]); let tempCounter = 0; const currentOffset = _optionalChain([reconstructedRoute, 'optionalAccess', _18 => _18.split, 'call', _19 => _19('/'), 'access', _20 => _20.filter, 'call', _21 => _21(v => !!v), 'access', _22 => _22.length]) || 0; const result = _optionalChain([layerPath , 'optionalAccess', _23 => _23.split, 'call', _24 => _24('/') , 'access', _25 => _25.filter, 'call', _26 => _26(segment => { if (_optionalChain([originalUrlSplit, 'optionalAccess', _27 => _27[currentOffset + tempCounter]]) === segment) { tempCounter += 1; return true; } return false; }) , 'access', _28 => _28.join, 'call', _29 => _29('/')]); return result; } exports.Express = Express; exports.extractOriginalRoute = extractOriginalRoute; exports.preventDuplicateSegments = preventDuplicateSegments; //# sourceMappingURL=express.js.map