@sitecore-jss/sitecore-jss-nextjs 21.10.0 → 21.10.1-canary.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -17,6 +17,7 @@ const regex_parser_1 = __importDefault(require("regex-parser"));
17
17
  const server_1 = require("next/server");
18
18
  const site_1 = require("@sitecore-jss/sitecore-jss/site");
19
19
  const sitecore_jss_1 = require("@sitecore-jss/sitecore-jss");
20
+ const utils_1 = require("@sitecore-jss/sitecore-jss/utils");
20
21
  const middleware_1 = require("./middleware");
21
22
  const REGEXP_CONTEXT_SITE_LANG = new RegExp(/\$siteLang/, 'i');
22
23
  const REGEXP_ABSOLUTE_URL = new RegExp('^(?:[a-z]+:)?//', 'i');
@@ -25,13 +26,100 @@ const REGEXP_ABSOLUTE_URL = new RegExp('^(?:[a-z]+:)?//', 'i');
25
26
  * compares with current url and redirects to target url
26
27
  */
27
28
  class RedirectsMiddleware extends middleware_1.MiddlewareBase {
28
- /**
29
- * @param {RedirectsMiddlewareConfig} [config] redirects middleware config
30
- */
31
29
  constructor(config) {
32
30
  super(config);
33
31
  this.config = config;
34
- this.handler = (req, res) => __awaiter(this, void 0, void 0, function* () {
32
+ // NOTE: we provide native fetch for compatibility on Next.js Edge Runtime
33
+ // (underlying default 'cross-fetch' is not currently compatible: https://github.com/lquixada/cross-fetch/issues/78)
34
+ this.redirectsService = new site_1.GraphQLRedirectsService(Object.assign(Object.assign({}, config), { fetch: fetch }));
35
+ this.locales = config.locales;
36
+ }
37
+ /**
38
+ * Gets the Next.js middleware handler with error handling
39
+ * @returns route handler
40
+ */
41
+ getHandler() {
42
+ return (req, res) => __awaiter(this, void 0, void 0, function* () {
43
+ try {
44
+ return this.processRedirectRequest(req, res);
45
+ }
46
+ catch (error) {
47
+ console.log('Redirect middleware failed:');
48
+ console.log(error);
49
+ return res || server_1.NextResponse.next();
50
+ }
51
+ });
52
+ }
53
+ /**
54
+ * Method returns RedirectInfo when matches
55
+ * @param {NextRequest} req request
56
+ * @param {string} siteName site name
57
+ * @returns Promise<RedirectInfo | undefined> The redirect info or undefined if no redirect is found
58
+ * @protected
59
+ */
60
+ getExistsRedirect(req, siteName) {
61
+ return __awaiter(this, void 0, void 0, function* () {
62
+ const { pathname: incomingURL, search: incomingQS = '' } = this.normalizeUrl(req.nextUrl.clone());
63
+ const locale = this.getLanguage(req);
64
+ const normalizedPath = incomingURL.replace(/\/*$/gi, '').toLowerCase();
65
+ const redirects = yield this.getRedirects(siteName);
66
+ const language = this.getLanguage(req);
67
+ const modifyRedirects = structuredClone(redirects);
68
+ let matchedQueryString;
69
+ const localePath = `/${locale.toLowerCase()}${normalizedPath}`;
70
+ return modifyRedirects.length
71
+ ? modifyRedirects.find((redirect) => {
72
+ // process static URL (non-regex) rules
73
+ if ((0, utils_1.isRegexOrUrl)(redirect.pattern) === 'url') {
74
+ const urlArray = redirect.pattern.endsWith('/')
75
+ ? redirect.pattern.slice(0, -1).split('?')
76
+ : redirect.pattern.split('?');
77
+ const patternQS = urlArray[1];
78
+ let patternPath = urlArray[0].toLowerCase();
79
+ // nextjs routes are case-sensitive, but locales should be compared case-insensitively
80
+ const patternParts = patternPath.split('/');
81
+ const maybeLocale = patternParts[1].toLowerCase();
82
+ // case insensitive lookup of locales
83
+ if (new RegExp(this.locales.join('|'), 'i').test(maybeLocale)) {
84
+ patternPath = patternPath.replace(`/${patternParts[1]}`, `/${maybeLocale}`);
85
+ }
86
+ return ((patternPath === localePath || patternPath === normalizedPath) &&
87
+ (!patternQS ||
88
+ (0, utils_1.areURLSearchParamsEqual)(new URLSearchParams(patternQS), new URLSearchParams(incomingQS))));
89
+ }
90
+ // process regex rules
91
+ // Modify the redirect pattern to ignore the language prefix in the path
92
+ // And escapes non-special "?" characters in a string or regex.
93
+ redirect.pattern = (0, utils_1.escapeNonSpecialQuestionMarks)(redirect.pattern.replace(new RegExp(`^[^]?/${language}/`, 'gi'), ''));
94
+ // Prepare the redirect pattern as a regular expression, making it more flexible for matching URLs
95
+ redirect.pattern = `/^\/${redirect.pattern
96
+ .replace(/^\/|\/$/g, '') // Removes leading and trailing slashes
97
+ .replace(/^\^\/|\/\$$/g, '') // Removes unnecessary start (^) and end ($) anchors
98
+ .replace(/^\^|\$$/g, '') // Further cleans up anchors
99
+ .replace(/\$\/gi$/g, '')}[\/]?$/i`; // Ensures the pattern allows an optional trailing slash
100
+ // Redirect pattern matches the full incoming URL with query string present
101
+ matchedQueryString = [
102
+ (0, regex_parser_1.default)(redirect.pattern).test(`/${localePath}${incomingQS}`),
103
+ (0, regex_parser_1.default)(redirect.pattern).test(`${normalizedPath}${incomingQS}`),
104
+ ].some(Boolean)
105
+ ? incomingQS
106
+ : undefined;
107
+ // Save the matched query string (if found) into the redirect object
108
+ redirect.matchedQueryString = matchedQueryString || '';
109
+ return (!!((0, regex_parser_1.default)(redirect.pattern).test(`/${req.nextUrl.locale}${incomingURL}`) ||
110
+ (0, regex_parser_1.default)(redirect.pattern).test(incomingURL) ||
111
+ matchedQueryString) && (redirect.locale ? redirect.locale.toLowerCase() === locale.toLowerCase() : true));
112
+ })
113
+ : undefined;
114
+ });
115
+ }
116
+ /**
117
+ * @param {NextRequest} req request
118
+ * @param {Response} res response
119
+ * @returns {Promise<NextResponse>} The redirect response.
120
+ */
121
+ processRedirectRequest(req, res) {
122
+ return __awaiter(this, void 0, void 0, function* () {
35
123
  const pathname = req.nextUrl.pathname;
36
124
  const language = this.getLanguage(req);
37
125
  const hostname = this.getHostHeader(req) || this.defaultHostname;
@@ -43,70 +131,69 @@ class RedirectsMiddleware extends middleware_1.MiddlewareBase {
43
131
  hostname,
44
132
  });
45
133
  const createResponse = () => __awaiter(this, void 0, void 0, function* () {
46
- if (this.config.disabled && this.config.disabled(req, res || server_1.NextResponse.next())) {
134
+ var _a;
135
+ const response = res || server_1.NextResponse.next();
136
+ if (this.config.disabled && this.config.disabled(req, response)) {
47
137
  sitecore_jss_1.debug.redirects('skipped (redirects middleware is disabled)');
48
- return res || server_1.NextResponse.next();
138
+ return response;
49
139
  }
50
140
  if (this.isPreview(req) || this.excludeRoute(pathname)) {
51
141
  sitecore_jss_1.debug.redirects('skipped (%s)', this.isPreview(req) ? 'preview' : 'route excluded');
52
- return res || server_1.NextResponse.next();
142
+ return response;
53
143
  }
54
- site = this.getSite(req, res);
144
+ // Skip prefetch requests from Next.js, which are not original client requests
145
+ // as they load unnecessary requests that burden the redirects middleware with meaningless traffic
146
+ if (this.isPrefetch(req)) {
147
+ sitecore_jss_1.debug.redirects('skipped (prefetch)');
148
+ response.headers.set('x-middleware-cache', 'no-cache');
149
+ response.headers.set('Cache-Control', 'no-store, must-revalidate');
150
+ return response;
151
+ }
152
+ site = this.getSite(req, response);
55
153
  // Find the redirect from result of RedirectService
56
154
  const existsRedirect = yield this.getExistsRedirect(req, site.name);
57
155
  if (!existsRedirect) {
58
156
  sitecore_jss_1.debug.redirects('skipped (redirect does not exist)');
59
- return res || server_1.NextResponse.next();
157
+ return response;
60
158
  }
159
+ sitecore_jss_1.debug.redirects('Matched redirect rule: %o', { existsRedirect });
61
160
  // Find context site language and replace token
62
161
  if (REGEXP_CONTEXT_SITE_LANG.test(existsRedirect.target) &&
63
162
  !(REGEXP_ABSOLUTE_URL.test(existsRedirect.target) &&
64
163
  existsRedirect.target.includes(hostname))) {
65
164
  existsRedirect.target = existsRedirect.target.replace(REGEXP_CONTEXT_SITE_LANG, site.language);
165
+ req.nextUrl.locale = site.language;
66
166
  }
67
- const url = req.nextUrl.clone();
167
+ const url = this.normalizeUrl(req.nextUrl.clone());
68
168
  if (REGEXP_ABSOLUTE_URL.test(existsRedirect.target)) {
69
- url.href = existsRedirect.target;
169
+ return this.dispatchRedirect(existsRedirect.target, existsRedirect.redirectType, req, response, true);
70
170
  }
71
171
  else {
72
- const source = `${url.pathname}${url.search}`;
73
- url.search = existsRedirect.isQueryStringPreserved ? url.search : '';
74
- const urlFirstPart = existsRedirect.target.split('/')[1];
172
+ const isUrl = (0, utils_1.isRegexOrUrl)(existsRedirect.pattern) === 'url';
173
+ const targetParts = existsRedirect.target.split('/');
174
+ const urlFirstPart = targetParts[1];
75
175
  if (this.locales.includes(urlFirstPart)) {
76
- url.locale = urlFirstPart;
176
+ req.nextUrl.locale = urlFirstPart;
77
177
  existsRedirect.target = existsRedirect.target.replace(`/${urlFirstPart}`, '');
78
178
  }
79
- const target = source
80
- .replace((0, regex_parser_1.default)(existsRedirect.pattern), existsRedirect.target)
81
- .replace(/^\/\//, '/')
82
- .split('?');
83
- url.pathname = target[0];
84
- if (target[1]) {
85
- const newParams = new URLSearchParams(target[1]);
86
- for (const [key, val] of newParams.entries()) {
87
- url.searchParams.append(key, val);
88
- }
89
- }
90
- }
91
- const redirectUrl = decodeURIComponent(url.href);
92
- /** return Response redirect with http code of redirect type **/
93
- switch (existsRedirect.redirectType) {
94
- case site_1.REDIRECT_TYPE_301:
95
- return server_1.NextResponse.redirect(redirectUrl, {
96
- status: 301,
97
- statusText: 'Moved Permanently',
98
- headers: res === null || res === void 0 ? void 0 : res.headers,
99
- });
100
- case site_1.REDIRECT_TYPE_302:
101
- return server_1.NextResponse.redirect(redirectUrl, {
102
- status: 302,
103
- statusText: 'Found',
104
- headers: res === null || res === void 0 ? void 0 : res.headers,
105
- });
106
- case site_1.REDIRECT_TYPE_SERVER_TRANSFER:
107
- return server_1.NextResponse.rewrite(redirectUrl, res);
108
- default:
109
- return res || server_1.NextResponse.next();
179
+ const targetSegments = isUrl
180
+ ? existsRedirect.target.split('?')
181
+ : url.pathname.replace(/\/*$/gi, '') + existsRedirect.matchedQueryString;
182
+ const [targetPath, targetQueryString] = isUrl
183
+ ? targetSegments
184
+ : targetSegments
185
+ .replace((0, regex_parser_1.default)(existsRedirect.pattern), existsRedirect.target)
186
+ .replace(/^\/\//, '/')
187
+ .split('?');
188
+ const mergedQueryString = existsRedirect.isQueryStringPreserved
189
+ ? (0, utils_1.mergeURLSearchParams)(new URLSearchParams((_a = url.search) !== null && _a !== void 0 ? _a : ''), new URLSearchParams(targetQueryString || ''))
190
+ : targetQueryString || '';
191
+ const prepareNewURL = new URL(`${targetPath}${mergedQueryString ? `?${mergedQueryString}` : ''}`, url.origin);
192
+ url.href = prepareNewURL.href;
193
+ url.pathname = prepareNewURL.pathname;
194
+ url.search = prepareNewURL.search;
195
+ url.locale = req.nextUrl.locale;
196
+ return this.dispatchRedirect(url, existsRedirect.redirectType, req, response, false);
110
197
  }
111
198
  });
112
199
  const response = yield createResponse();
@@ -118,60 +205,95 @@ class RedirectsMiddleware extends middleware_1.MiddlewareBase {
118
205
  });
119
206
  return response;
120
207
  });
121
- // NOTE: we provide native fetch for compatibility on Next.js Edge Runtime
122
- // (underlying default 'cross-fetch' is not currently compatible: https://github.com/lquixada/cross-fetch/issues/78)
123
- this.redirectsService = new site_1.GraphQLRedirectsService(Object.assign(Object.assign({}, config), { fetch: fetch }));
124
- this.locales = config.locales;
125
208
  }
126
209
  /**
127
- * Gets the Next.js middleware handler with error handling
128
- * @returns route handler
210
+ * Fetches all redirects for a given site from the Sitecore instance
211
+ * @param {string} siteName - The name of the site to fetch redirects for
212
+ * @returns {Promise<RedirectInfo[]>} A promise that resolves to an array of redirect information
213
+ * @protected
129
214
  */
130
- getHandler() {
131
- return (req, res) => __awaiter(this, void 0, void 0, function* () {
132
- try {
133
- return yield this.handler(req, res);
134
- }
135
- catch (error) {
136
- console.log('Redirect middleware failed:');
137
- console.log(error);
138
- return res || server_1.NextResponse.next();
139
- }
215
+ getRedirects(siteName) {
216
+ return __awaiter(this, void 0, void 0, function* () {
217
+ return this.redirectsService.fetchRedirects(siteName);
140
218
  });
141
219
  }
142
220
  /**
143
- * Method returns RedirectInfo when matches
144
- * @param {NextRequest} req request
145
- * @param {string} siteName site name
146
- * @returns Promise<RedirectInfo | undefined>
147
- * @private
221
+ * When a user clicks on a link generated by the Link component from next/link,
222
+ * Next.js adds special parameters in the route called path.
223
+ * This method removes these special parameters.
224
+ * @param {NextURL} url
225
+ * @returns {string} normalize url
148
226
  */
149
- getExistsRedirect(req, siteName) {
150
- return __awaiter(this, void 0, void 0, function* () {
151
- const redirects = yield this.redirectsService.fetchRedirects(siteName);
152
- const tragetURL = req.nextUrl.pathname;
153
- const targetQS = req.nextUrl.search || '';
154
- const language = this.getLanguage(req);
155
- const modifyRedirects = structuredClone(redirects);
156
- return modifyRedirects.length
157
- ? modifyRedirects.find((redirect) => {
158
- redirect.pattern = redirect.pattern.replace(RegExp(`^[^]?/${language}/`, 'gi'), '');
159
- redirect.pattern = `/^\/${redirect.pattern
160
- .replace(/^\/|\/$/g, '')
161
- .replace(/^\^\/|\/\$$/g, '')
162
- .replace(/^\^|\$$/g, '')
163
- .replace(/(?<!\\)\?/g, '\\?')
164
- .replace(/\$\/gi$/g, '')}[\/]?$/gi`;
165
- return (((0, regex_parser_1.default)(redirect.pattern).test(tragetURL) ||
166
- (0, regex_parser_1.default)(redirect.pattern).test(`${tragetURL}${targetQS}`) ||
167
- (0, regex_parser_1.default)(redirect.pattern).test(`/${req.nextUrl.locale}${tragetURL}`) ||
168
- (0, regex_parser_1.default)(redirect.pattern).test(`/${req.nextUrl.locale}${tragetURL}${targetQS}`)) &&
169
- (redirect.locale
170
- ? redirect.locale.toLowerCase() === req.nextUrl.locale.toLowerCase()
171
- : true));
172
- })
173
- : undefined;
227
+ normalizeUrl(url) {
228
+ if (!url.search)
229
+ return url;
230
+ /**
231
+ * Prepare special parameters for exclusion.
232
+ */
233
+ const splittedPathname = url.pathname
234
+ .split('/')
235
+ .filter((route) => route)
236
+ .map((route) => `path=${route}`);
237
+ /**
238
+ * Remove special parameters(Next.JS)
239
+ * Example: /about/contact/us
240
+ * When a user clicks on this link, Next.js should generate a link for the middleware, formatted like this:
241
+ * http://host/about/contact/us?path=about&path=contact&path=us
242
+ */
243
+ const newQueryString = url.search
244
+ .replace(/^\?/, '')
245
+ .split('&')
246
+ .filter((param) => !splittedPathname.includes(param))
247
+ .join('&');
248
+ const newUrl = new URL(`${url.pathname.toLowerCase()}?${newQueryString}`, url.origin);
249
+ url.search = newUrl.search;
250
+ url.pathname = newUrl.pathname.toLowerCase();
251
+ url.href = newUrl.href;
252
+ return url;
253
+ }
254
+ /**
255
+ * Dispatch a redirect or rewrite based on type.
256
+ * @param {NextURL | string} target Final target to redirect/rewrite to (NextURL or string for externals).
257
+ * @param {string} type One of `REDIRECT_TYPE_301`, `REDIRECT_TYPE_302`, or `REDIRECT_TYPE_SERVER_TRANSFER`.
258
+ * @param {NextRequest} req Incoming request.
259
+ * @param {NextResponse} res Current response (used for header cleanup/carry-over).
260
+ * @param {boolean} isExternal Set to `true` when target is an external absolute URL.
261
+ * @returns A NextResponse.
262
+ */
263
+ dispatchRedirect(target, type, req, res, isExternal = false) {
264
+ switch (type) {
265
+ case site_1.REDIRECT_TYPE_301:
266
+ return this.createRedirectResponse(target, res, 301, 'Moved Permanently');
267
+ case site_1.REDIRECT_TYPE_302:
268
+ return this.createRedirectResponse(target, res, 302, 'Found');
269
+ case site_1.REDIRECT_TYPE_SERVER_TRANSFER:
270
+ // rewrite expects a string; unwrap NextURL if needed
271
+ return this.rewrite(typeof target === 'string' ? target : target.href, req, res, isExternal);
272
+ default:
273
+ // Unknown type: return the input response unchanged
274
+ return res;
275
+ }
276
+ }
277
+ /**
278
+ * Helper function to create a redirect response and remove the x-middleware-next header.
279
+ * @param {NextURL} url The URL to redirect to.
280
+ * @param {Response} res The response object.
281
+ * @param {number} status The HTTP status code of the redirect.
282
+ * @param {string} statusText The status text of the redirect.
283
+ * @returns {NextResponse<unknown>} The redirect response.
284
+ */
285
+ createRedirectResponse(url, res, status, statusText) {
286
+ const redirect = server_1.NextResponse.redirect(url, {
287
+ status,
288
+ statusText,
289
+ headers: res === null || res === void 0 ? void 0 : res.headers,
174
290
  });
291
+ if (res === null || res === void 0 ? void 0 : res.headers) {
292
+ redirect.headers.delete('x-middleware-next');
293
+ redirect.headers.delete('x-middleware-rewrite');
294
+ redirect.headers.delete(middleware_1.REWRITE_HEADER_NAME);
295
+ }
296
+ return redirect;
175
297
  }
176
298
  }
177
299
  exports.RedirectsMiddleware = RedirectsMiddleware;
@@ -1,4 +1,5 @@
1
1
  import { NextResponse } from 'next/server';
2
+ export const REWRITE_HEADER_NAME = 'x-sc-rewrite';
2
3
  export class MiddlewareBase {
3
4
  constructor(config) {
4
5
  this.config = config;
@@ -33,6 +34,27 @@ export class MiddlewareBase {
33
34
  incomingHeaders.forEach((value, key) => (headers[key] = value));
34
35
  return headers;
35
36
  }
37
+ /**
38
+ * Determines if the request is a Next.js (next/link) prefetch request
39
+ * @param {NextRequest} req request
40
+ * @returns {boolean} is prefetch
41
+ */
42
+ isPrefetch(req) {
43
+ const isMobile = req.headers.get('sec-ch-ua-mobile') === '?1';
44
+ const userAgent = req.headers.get('user-agent') || '';
45
+ const isKnownPlatform = /iPhone|Mac|Linux|Windows|Android/i.test(userAgent);
46
+ const isKnownDevice = isMobile || isKnownPlatform;
47
+ const purpose = req.headers.get('purpose');
48
+ const nextRouterPrefetch = req.headers.get('Next-Router-Prefetch');
49
+ const middlewarePrefetch = req.headers.get('x-middleware-prefetch');
50
+ // Some real navigations on different devices may incorrectly include 'prefetch' headers.
51
+ // To avoid skipping personalization in such cases, we treat 'x-middleware-prefetch' as a more reliable signal of true prefetch behavior.
52
+ if (isKnownDevice && middlewarePrefetch === '1') {
53
+ return false;
54
+ }
55
+ // Otherwise, standard prefetch detection
56
+ return purpose === 'prefetch' || nextRouterPrefetch === '1' || middlewarePrefetch === '1';
57
+ }
36
58
  /**
37
59
  * Provides used language
38
60
  * @param {NextRequest} req request
@@ -69,14 +91,17 @@ export class MiddlewareBase {
69
91
  * @param {string} rewritePath the destionation path
70
92
  * @param {NextRequest} req the current request
71
93
  * @param {NextResponse} res the current response
94
+ * @param {boolean} [skipHeader] don't write 'x-sc-rewrite' header
72
95
  */
73
- rewrite(rewritePath, req, res) {
96
+ rewrite(rewritePath, req, res, skipHeader) {
74
97
  // Note an absolute URL is required: https://nextjs.org/docs/messages/middleware-relative-urls
75
98
  const rewriteUrl = req.nextUrl.clone();
76
99
  rewriteUrl.pathname = rewritePath;
77
100
  const response = NextResponse.rewrite(rewriteUrl, res);
78
101
  // Share rewrite path with following executed middlewares
79
- response.headers.set(this.REWRITE_HEADER_NAME, rewritePath);
102
+ if (!skipHeader) {
103
+ response.headers.set(REWRITE_HEADER_NAME, rewritePath);
104
+ }
80
105
  return response;
81
106
  }
82
107
  }