msw 2.15.0 → 3.0.0

package/lib/_chunks/cookie-store.js

@@ -0,0 +1,348 @@
+import { getCleanUrlString } from "../utils/get-clean-url-string.js";
+import { isNodeProcess } from "is-node-process";
+import { format, invariant } from "outvariant";
+import { getCleanUrl } from "@mswjs/interceptors";
+import { matchPattern } from "@msw/url";
+import { Cookie, CookieJar, MemoryCookieStore } from "tough-cookie";
+//#region src/core/handlers/handler.ts
+/**
+* The base class for all the handlers.
+*/
+var Handler = class {
+	/**
+	* Reset the runtime state this handler accumulated while handling
+	* the network (e.g. generator resolver progress).
+	*
+	* @note This method is invoked automatically when the handlers are
+	* reset (e.g. `server.resetHandlers()`).
+	*/
+	reset() {}
+	/**
+	* Restore this handler so it can handle the network again after
+	* being exhausted (e.g. via `{ once: true }`).
+	*
+	* @note This method is invoked automatically when the handlers are
+	* restored (e.g. `server.restoreHandlers()`).
+	*/
+	restore() {}
+	/**
+	* Release the resources held by this handler.
+	*
+	* @note This method is invoked automatically when the network is
+	* disabled (e.g. `server.close()`). Override it in the handlers that
+	* hold onto anything beyond a single frame, like timers, connections,
+	* or event listeners. Returning a promise makes the network await
+	* this handler's disposal before it tears itself down.
+	*/
+	dispose() {}
+};
+//#endregion
+//#region src/core/utils/internal/get-call-frame.ts
+const SOURCE_FRAME = /[/\\]msw[/\\]src[/\\](.+)/;
+const BUILD_FRAME = /(node_modules)?[/\\]lib[/\\](core|browser|node|iife)[/\\]|^[^/\\]*$/;
+/**
+* Return the stack trace frame of a function's invocation.
+*/
+function getCallFrame(error) {
+	const stack = error.stack;
+	if (!stack) return;
+	const declarationFrame = stack.split("\n").slice(1).find((frame) => {
+		return !(SOURCE_FRAME.test(frame) || BUILD_FRAME.test(frame));
+	});
+	if (!declarationFrame) return;
+	return declarationFrame.replace(/\s*at [^()]*\(([^)]+)\)/, "$1").replace(/^@/, "");
+}
+//#endregion
+//#region src/core/utils/internal/dev-utils.ts
+const LIBRARY_PREFIX = "[MSW]";
+/**
+* Formats a given message by appending the library's prefix string.
+*/
+function formatMessage(message, ...positionals) {
+	const interpolatedMessage = format(message, ...positionals);
+	return `${LIBRARY_PREFIX} ${interpolatedMessage}`;
+}
+/**
+* Prints a library-specific warning.
+*/
+function warn(message, ...positionals) {
+	console.warn(formatMessage(message, ...positionals));
+}
+/**
+* Prints a library-specific error.
+*/
+function error(message, ...positionals) {
+	console.error(formatMessage(message, ...positionals));
+}
+const devUtils = {
+	formatMessage,
+	warn,
+	error
+};
+/**
+* Internal error instance.
+* Used to differentiate the library errors that must be forwarded
+* to the user from the unhandled exceptions. Use this if you don't
+* wish for the error to be coerced to a 500 fallback response.
+*/
+var InternalError = class extends Error {
+	constructor(message) {
+		super(message);
+		this.name = "InternalError";
+	}
+};
+//#endregion
+//#region src/core/utils/http-status-messages.ts
+/**
+* Reason phrases of the known HTTP status codes.
+* @see https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml
+*/
+const httpStatusMessages = {
+	100: "Continue",
+	101: "Switching Protocols",
+	102: "Processing",
+	103: "Early Hints",
+	200: "OK",
+	201: "Created",
+	202: "Accepted",
+	203: "Non-Authoritative Information",
+	204: "No Content",
+	205: "Reset Content",
+	206: "Partial Content",
+	207: "Multi-Status",
+	208: "Already Reported",
+	226: "IM Used",
+	300: "Multiple Choices",
+	301: "Moved Permanently",
+	302: "Found",
+	303: "See Other",
+	304: "Not Modified",
+	305: "Use Proxy",
+	307: "Temporary Redirect",
+	308: "Permanent Redirect",
+	400: "Bad Request",
+	401: "Unauthorized",
+	402: "Payment Required",
+	403: "Forbidden",
+	404: "Not Found",
+	405: "Method Not Allowed",
+	406: "Not Acceptable",
+	407: "Proxy Authentication Required",
+	408: "Request Timeout",
+	409: "Conflict",
+	410: "Gone",
+	411: "Length Required",
+	412: "Precondition Failed",
+	413: "Payload Too Large",
+	414: "URI Too Long",
+	415: "Unsupported Media Type",
+	416: "Range Not Satisfiable",
+	417: "Expectation Failed",
+	418: "I'm a Teapot",
+	421: "Misdirected Request",
+	422: "Unprocessable Entity",
+	423: "Locked",
+	424: "Failed Dependency",
+	425: "Too Early",
+	426: "Upgrade Required",
+	428: "Precondition Required",
+	429: "Too Many Requests",
+	431: "Request Header Fields Too Large",
+	451: "Unavailable For Legal Reasons",
+	500: "Internal Server Error",
+	501: "Not Implemented",
+	502: "Bad Gateway",
+	503: "Service Unavailable",
+	504: "Gateway Timeout",
+	505: "HTTP Version Not Supported",
+	506: "Variant Also Negotiates",
+	507: "Insufficient Storage",
+	508: "Loop Detected",
+	509: "Bandwidth Limit Exceeded",
+	510: "Not Extended",
+	511: "Network Authentication Required"
+};
+//#endregion
+//#region src/core/utils/response-decorators.ts
+const kSetCookie = Symbol("kSetCookie");
+function normalizeResponseInit(init = {}) {
+	const status = init?.status || 200;
+	const statusText = init?.statusText || httpStatusMessages[status] || "";
+	const headers = new Headers(init?.headers);
+	return {
+		...init,
+		headers,
+		status,
+		statusText
+	};
+}
+function decorateResponse(response, init) {
+	if (init.type) Object.defineProperty(response, "type", {
+		value: init.type,
+		enumerable: true,
+		writable: false
+	});
+	const responseCookies = init.headers.getSetCookie();
+	if (responseCookies) Object.defineProperty(response, kSetCookie, {
+		value: responseCookies,
+		enumerable: false,
+		writable: false
+	});
+	return response;
+}
+function getRawSetCookie(response) {
+	return Reflect.get(response, kSetCookie) || [];
+}
+/**
+* Copy the given response own properties, like internal symbols,
+* onto another response. Used for faithful internal copying of responses.
+*/
+function copyResponseOwnProperties(source, target) {
+	for (const propertyName of Reflect.ownKeys(source)) {
+		const descriptor = Object.getOwnPropertyDescriptor(source, propertyName);
+		const existingDescriptor = Object.getOwnPropertyDescriptor(target, propertyName);
+		if (descriptor && existingDescriptor == null) Object.defineProperty(target, propertyName, descriptor);
+	}
+}
+//#endregion
+//#region src/core/utils/logging/get-timestamp.ts
+/**
+* Returns a timestamp string in a "HH:MM:SS" format.
+*/
+function getTimestamp(options) {
+	const now = /* @__PURE__ */ new Date();
+	const timestamp = `${now.getHours().toString().padStart(2, "0")}:${now.getMinutes().toString().padStart(2, "0")}:${now.getSeconds().toString().padStart(2, "0")}`;
+	if (options?.milliseconds) return `${timestamp}.${now.getMilliseconds().toString().padStart(3, "0")}`;
+	return timestamp;
+}
+//#endregion
+//#region src/core/utils/url/is-absolute-url.ts
+/**
+* Determines if the given URL string is an absolute URL.
+*/
+function isAbsoluteUrl(url) {
+	return /^([a-z][a-z\d+\-.]*:)?\/\//i.test(url);
+}
+//#endregion
+//#region src/core/utils/url/get-absolute-url.ts
+/**
+* Returns an absolute URL based on the given path.
+*/
+function getAbsoluteUrl(path, baseUrl) {
+	if (isAbsoluteUrl(path)) return path;
+	if (path.startsWith("*")) return path;
+	const origin = baseUrl || typeof location !== "undefined" && location.href;
+	return origin ? decodeURI(new URL(encodeURI(path), origin).href) : path;
+}
+//#endregion
+//#region src/core/utils/matching/normalize-path.ts
+/**
+* Normalizes a given request handler path:
+* - Preserves RegExp.
+* - Removes query parameters and hashes.
+* - Rebases relative URLs against the "baseUrl" or the current location.
+* - Preserves relative URLs in Node.js, unless specified otherwise.
+* - Preserves optional path parameters.
+*/
+function normalizePath(path, baseUrl) {
+	if (path instanceof RegExp) return path;
+	const maybeAbsoluteUrl = getAbsoluteUrl(path, baseUrl);
+	return getCleanUrlString(maybeAbsoluteUrl);
+}
+//#endregion
+//#region src/core/utils/matching/match-request-url.ts
+function isPath(value) {
+	return typeof value === "string" || value instanceof RegExp;
+}
+/**
+* Match the given URL against a path pattern.
+*/
+function matchRequestUrl(url, pattern, baseUrl) {
+	const cleanUrl = getCleanUrl(url);
+	if (pattern instanceof RegExp) {
+		const match = pattern.flags.includes("g") ? [...cleanUrl.matchAll(pattern)].flat() : cleanUrl.match(pattern);
+		return {
+			matches: match != null && match.length > 0,
+			params: Object.fromEntries((match ?? []).slice(1).map((value, index) => [index, value]))
+		};
+	}
+	const normalizedPath = normalizePath(pattern, baseUrl);
+	return matchPattern(normalizedPath, cleanUrl);
+}
+//#endregion
+//#region src/core/utils/request/to-public-url.ts
+/**
+* Returns a relative URL if the given request URL is relative
+* to the current origin. Otherwise returns an absolute URL.
+*/
+function toPublicUrl(url) {
+	const urlInstance = url instanceof URL ? url : new URL(url);
+	if (typeof location !== "undefined" && urlInstance.origin === location.origin) return urlInstance.pathname;
+	return urlInstance.origin + urlInstance.pathname;
+}
+//#endregion
+//#region src/core/utils/internal/json-parse.ts
+/**
+* Parses a given value into a JSON.
+* Does not throw an exception on an invalid JSON string.
+*/
+function jsonParse(value) {
+	try {
+		return JSON.parse(value);
+	} catch {
+		return;
+	}
+}
+//#endregion
+//#region src/core/utils/cookie-store.ts
+var CookieStore = class {
+	#storageKey = "__msw-cookie-store__";
+	#jar;
+	#memoryStore;
+	constructor() {
+		invariant(typeof localStorage !== "undefined", "Failed to create a CookieStore: `localStorage` is not available in this environment. This is likely an issue with your environment, which has been detected as browser (or browser-like) environment and must implement global browser APIs correctly.");
+		this.#memoryStore = new MemoryCookieStore();
+		this.#memoryStore.idx = this.getCookieStoreIndex();
+		this.#jar = new CookieJar(this.#memoryStore);
+	}
+	getCookies(url) {
+		return this.#jar.getCookiesSync(url);
+	}
+	async setCookie(cookieName, url) {
+		await this.#jar.setCookie(cookieName, url);
+		this.persist();
+	}
+	getCookieStoreIndex() {
+		if (typeof localStorage === "undefined" || typeof localStorage.getItem !== "function") return {};
+		const cookiesString = localStorage.getItem(this.#storageKey);
+		if (cookiesString == null) return {};
+		const rawCookies = jsonParse(cookiesString);
+		if (rawCookies == null) return {};
+		const cookies = {};
+		for (const rawCookie of rawCookies) {
+			const cookie = Cookie.fromJSON(rawCookie);
+			if (cookie != null && cookie.domain != null && cookie.path != null) {
+				cookies[cookie.domain] ||= {};
+				cookies[cookie.domain][cookie.path] ||= {};
+				cookies[cookie.domain][cookie.path][cookie.key] = cookie;
+			}
+		}
+		return cookies;
+	}
+	persist() {
+		if (typeof localStorage === "undefined" || typeof localStorage.setItem !== "function") return;
+		const data = [];
+		const { idx } = this.#memoryStore;
+		for (const domain in idx) for (const path in idx[domain]) for (const key in idx[domain][path]) data.push(idx[domain][path][key].toJSON());
+		try {
+			localStorage.setItem(this.#storageKey, JSON.stringify(data));
+		} catch {
+			return;
+		}
+	}
+};
+const cookieStore = isNodeProcess() ? null : new CookieStore();
+//#endregion
+export { matchRequestUrl as a, copyResponseOwnProperties as c, normalizeResponseInit as d, httpStatusMessages as f, Handler as g, getCallFrame as h, isPath as i, decorateResponse as l, devUtils as m, jsonParse as n, isAbsoluteUrl as o, InternalError as p, toPublicUrl as r, getTimestamp as s, cookieStore as t, getRawSetCookie as u };
+
+//# sourceMappingURL=cookie-store.js.map

package/lib/_chunks/cookie-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cookie-store.js","names":[],"sources":["../../src/core/handlers/handler.ts","../../src/core/utils/internal/get-call-frame.ts","../../src/core/utils/internal/dev-utils.ts","../../src/core/utils/http-status-messages.ts","../../src/core/utils/response-decorators.ts","../../src/core/utils/logging/get-timestamp.ts","../../src/core/utils/url/is-absolute-url.ts","../../src/core/utils/url/get-absolute-url.ts","../../src/core/utils/matching/normalize-path.ts","../../src/core/utils/matching/match-request-url.ts","../../src/core/utils/request/to-public-url.ts","../../src/core/utils/internal/json-parse.ts","../../src/core/utils/cookie-store.ts"],"sourcesContent":["import type { MaybePromise } from '../type-utils'\n\nexport type HandlerKind = 'request' | 'websocket'\n\n/**\n * The base class for all the handlers.\n */\nexport abstract class Handler {\n  /**\n   * The kind of the network frame this handler handles.\n   */\n  abstract readonly kind: HandlerKind\n\n  /**\n   * Reset the runtime state this handler accumulated while handling\n   * the network (e.g. generator resolver progress).\n   *\n   * @note This method is invoked automatically when the handlers are\n   * reset (e.g. `server.resetHandlers()`).\n   */\n  public reset(): void {}\n\n  /**\n   * Restore this handler so it can handle the network again after\n   * being exhausted (e.g. via `{ once: true }`).\n   *\n   * @note This method is invoked automatically when the handlers are\n   * restored (e.g. `server.restoreHandlers()`).\n   */\n  public restore(): void {}\n\n  /**\n   * Release the resources held by this handler.\n   *\n   * @note This method is invoked automatically when the network is\n   * disabled (e.g. `server.close()`). Override it in the handlers that\n   * hold onto anything beyond a single frame, like timers, connections,\n   * or event listeners. Returning a promise makes the network await\n   * this handler's disposal before it tears itself down.\n   */\n  public dispose(): MaybePromise<void> {}\n}\n","// Ignore the source files traces for local testing.\nconst SOURCE_FRAME = /[/\\\\]msw[/\\\\]src[/\\\\](.+)/\n\nconst BUILD_FRAME =\n  /(node_modules)?[/\\\\]lib[/\\\\](core|browser|node|iife)[/\\\\]|^[^/\\\\]*$/\n\n/**\n * Return the stack trace frame of a function's invocation.\n */\nexport function getCallFrame(error: Error) {\n  // In <IE11, new Error may return an undefined stack\n  const stack = error.stack\n\n  if (!stack) {\n    return\n  }\n\n  const frames: string[] = stack.split('\\n').slice(1)\n\n  // Get the first frame that doesn't reference the library's internal trace.\n  // Assume that frame is the invocation frame.\n  const declarationFrame = frames.find((frame) => {\n    return !(SOURCE_FRAME.test(frame) || BUILD_FRAME.test(frame))\n  })\n\n  if (!declarationFrame) {\n    return\n  }\n\n  // Extract file reference from the stack frame.\n  const declarationPath = declarationFrame\n    .replace(/\\s*at [^()]*\\(([^)]+)\\)/, '$1')\n    .replace(/^@/, '')\n  return declarationPath\n}\n","import { format } from 'outvariant'\n\nconst LIBRARY_PREFIX = '[MSW]'\n\n/**\n * Formats a given message by appending the library's prefix string.\n */\nfunction formatMessage(message: string, ...positionals: any[]): string {\n  const interpolatedMessage = format(message, ...positionals)\n  return `${LIBRARY_PREFIX} ${interpolatedMessage}`\n}\n\n/**\n * Prints a library-specific warning.\n */\nfunction warn(message: string, ...positionals: any[]): void {\n  console.warn(formatMessage(message, ...positionals))\n}\n\n/**\n * Prints a library-specific error.\n */\nfunction error(message: string, ...positionals: any[]): void {\n  console.error(formatMessage(message, ...positionals))\n}\n\nexport const devUtils = {\n  formatMessage,\n  warn,\n  error,\n}\n\n/**\n * Internal error instance.\n * Used to differentiate the library errors that must be forwarded\n * to the user from the unhandled exceptions. Use this if you don't\n * wish for the error to be coerced to a 500 fallback response.\n */\nexport class InternalError extends Error {\n  constructor(message: string) {\n    super(message)\n    this.name = 'InternalError'\n  }\n}\n","/**\n * Reason phrases of the known HTTP status codes.\n * @see https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml\n */\nexport const httpStatusMessages: Record<number, string> = {\n  100: 'Continue',\n  101: 'Switching Protocols',\n  102: 'Processing',\n  103: 'Early Hints',\n  200: 'OK',\n  201: 'Created',\n  202: 'Accepted',\n  203: 'Non-Authoritative Information',\n  204: 'No Content',\n  205: 'Reset Content',\n  206: 'Partial Content',\n  207: 'Multi-Status',\n  208: 'Already Reported',\n  226: 'IM Used',\n  300: 'Multiple Choices',\n  301: 'Moved Permanently',\n  302: 'Found',\n  303: 'See Other',\n  304: 'Not Modified',\n  305: 'Use Proxy',\n  307: 'Temporary Redirect',\n  308: 'Permanent Redirect',\n  400: 'Bad Request',\n  401: 'Unauthorized',\n  402: 'Payment Required',\n  403: 'Forbidden',\n  404: 'Not Found',\n  405: 'Method Not Allowed',\n  406: 'Not Acceptable',\n  407: 'Proxy Authentication Required',\n  408: 'Request Timeout',\n  409: 'Conflict',\n  410: 'Gone',\n  411: 'Length Required',\n  412: 'Precondition Failed',\n  413: 'Payload Too Large',\n  414: 'URI Too Long',\n  415: 'Unsupported Media Type',\n  416: 'Range Not Satisfiable',\n  417: 'Expectation Failed',\n  418: \"I'm a Teapot\",\n  421: 'Misdirected Request',\n  422: 'Unprocessable Entity',\n  423: 'Locked',\n  424: 'Failed Dependency',\n  425: 'Too Early',\n  426: 'Upgrade Required',\n  428: 'Precondition Required',\n  429: 'Too Many Requests',\n  431: 'Request Header Fields Too Large',\n  451: 'Unavailable For Legal Reasons',\n  500: 'Internal Server Error',\n  501: 'Not Implemented',\n  502: 'Bad Gateway',\n  503: 'Service Unavailable',\n  504: 'Gateway Timeout',\n  505: 'HTTP Version Not Supported',\n  506: 'Variant Also Negotiates',\n  507: 'Insufficient Storage',\n  508: 'Loop Detected',\n  509: 'Bandwidth Limit Exceeded',\n  510: 'Not Extended',\n  511: 'Network Authentication Required',\n}\n","import type { HttpResponse, HttpResponseInit } from '#http/http-response'\nimport { httpStatusMessages } from './http-status-messages'\n\nconst kSetCookie = Symbol('kSetCookie')\n\nexport interface HttpResponseDecoratedInit extends HttpResponseInit {\n  status: number\n  statusText: string\n  headers: Headers\n}\n\nexport function normalizeResponseInit(\n  init: HttpResponseInit = {},\n): HttpResponseDecoratedInit {\n  const status = init?.status || 200\n  const statusText = init?.statusText || httpStatusMessages[status] || ''\n  const headers = new Headers(init?.headers)\n\n  return {\n    ...init,\n    headers,\n    status,\n    statusText,\n  }\n}\n\nexport function decorateResponse(\n  response: HttpResponse<any>,\n  init: HttpResponseDecoratedInit,\n): Response {\n  // Allow mocking the response type.\n  if (init.type) {\n    Object.defineProperty(response, 'type', {\n      value: init.type,\n      enumerable: true,\n      writable: false,\n    })\n  }\n\n  const responseCookies = init.headers.getSetCookie()\n\n  if (responseCookies) {\n    // Record the raw \"Set-Cookie\" response header provided\n    // in the HeadersInit. This is later used to store these cookies\n    // in cookie jar and return the right cookies in the \"cookies\"\n    // response resolver argument.\n    Object.defineProperty(response, kSetCookie, {\n      value: responseCookies,\n      enumerable: false,\n      writable: false,\n    })\n  }\n\n  return response\n}\n\nexport function getRawSetCookie(response: Response): Array<string> {\n  return Reflect.get(response, kSetCookie) || []\n}\n\n/**\n * Copy the given response own properties, like internal symbols,\n * onto another response. Used for faithful internal copying of responses.\n */\nexport function copyResponseOwnProperties(\n  source: Response,\n  target: Response,\n): void {\n  for (const propertyName of Reflect.ownKeys(source)) {\n    const descriptor = Object.getOwnPropertyDescriptor(source, propertyName)\n    const existingDescriptor = Object.getOwnPropertyDescriptor(\n      target,\n      propertyName,\n    )\n\n    if (descriptor && existingDescriptor == null) {\n      Object.defineProperty(target, propertyName, descriptor)\n    }\n  }\n}\n","interface GetTimestampOptions {\n  milliseconds?: boolean\n}\n\n/**\n * Returns a timestamp string in a \"HH:MM:SS\" format.\n */\nexport function getTimestamp(options?: GetTimestampOptions): string {\n  const now = new Date()\n  const timestamp = `${now.getHours().toString().padStart(2, '0')}:${now.getMinutes().toString().padStart(2, '0')}:${now.getSeconds().toString().padStart(2, '0')}`\n\n  if (options?.milliseconds) {\n    return `${timestamp}.${now.getMilliseconds().toString().padStart(3, '0')}`\n  }\n\n  return timestamp\n}\n","/**\n * Determines if the given URL string is an absolute URL.\n */\nexport function isAbsoluteUrl(url: string): boolean {\n  return /^([a-z][a-z\\d+\\-.]*:)?\\/\\//i.test(url)\n}\n","import { isAbsoluteUrl } from './is-absolute-url'\n\n/**\n * Returns an absolute URL based on the given path.\n */\nexport function getAbsoluteUrl(path: string, baseUrl?: string): string {\n  // already absolute URL\n  if (isAbsoluteUrl(path)) {\n    return path\n  }\n\n  // Ignore path with pattern start with *\n  if (path.startsWith('*')) {\n    return path\n  }\n\n  // Resolve a relative request URL against a given custom \"baseUrl\"\n  // or the document baseURI (in the case of browser/browser-like environments).\n  const origin = baseUrl || (typeof location !== 'undefined' && location.href)\n\n  return origin\n    ? // Encode and decode the path to preserve escaped characters.\n      decodeURI(new URL(encodeURI(path), origin).href)\n    : path\n}\n","import type { Path } from './match-request-url'\nimport { getCleanUrlString } from '#utils/get-clean-url-string'\nimport { getAbsoluteUrl } from '../url/get-absolute-url'\n\n/**\n * Normalizes a given request handler path:\n * - Preserves RegExp.\n * - Removes query parameters and hashes.\n * - Rebases relative URLs against the \"baseUrl\" or the current location.\n * - Preserves relative URLs in Node.js, unless specified otherwise.\n * - Preserves optional path parameters.\n */\nexport function normalizePath<ThisPath extends Path>(\n  path: ThisPath,\n  baseUrl?: string,\n): ThisPath {\n  // RegExp paths do not need normalization.\n  if (path instanceof RegExp) {\n    return path\n  }\n\n  const maybeAbsoluteUrl = getAbsoluteUrl(path, baseUrl)\n\n  return getCleanUrlString(maybeAbsoluteUrl) as ThisPath\n}\n","import { matchPattern } from '@msw/url'\nimport { getCleanUrl } from '@mswjs/interceptors'\nimport { normalizePath } from './normalize-path'\n\nexport type Path = string | RegExp\nexport type PathParams<KeyType extends keyof any = string> = {\n  [ParamName in KeyType]?: string | ReadonlyArray<string>\n}\n\nexport interface Match {\n  matches: boolean\n  params?: PathParams\n}\n\nexport function isPath(value: unknown): value is Path {\n  return typeof value === 'string' || value instanceof RegExp\n}\n\n/**\n * Match the given URL against a path pattern.\n */\nexport function matchRequestUrl(\n  url: URL,\n  pattern: Path,\n  baseUrl?: string,\n): Match {\n  const cleanUrl = getCleanUrl(url)\n\n  if (pattern instanceof RegExp) {\n    const match = pattern.flags.includes('g')\n      ? [...cleanUrl.matchAll(pattern)].flat()\n      : cleanUrl.match(pattern)\n\n    return {\n      matches: match != null && match.length > 0,\n      params: Object.fromEntries(\n        (match ?? []).slice(1).map((value, index) => [index, value]),\n      ),\n    }\n  }\n\n  // Resolve potentially realive patterns against the baseUrl.\n  const normalizedPath = normalizePath(pattern, baseUrl)\n  return matchPattern(normalizedPath, cleanUrl)\n}\n","/**\n * Returns a relative URL if the given request URL is relative\n * to the current origin. Otherwise returns an absolute URL.\n */\nexport function toPublicUrl(url: string | URL): string {\n  const urlInstance = url instanceof URL ? url : new URL(url)\n\n  if (\n    typeof location !== 'undefined' &&\n    urlInstance.origin === location.origin\n  ) {\n    return urlInstance.pathname\n  }\n\n  return urlInstance.origin + urlInstance.pathname\n}\n","/**\n * Parses a given value into a JSON.\n * Does not throw an exception on an invalid JSON string.\n */\nexport function jsonParse<ValueType extends Record<string, any>>(\n  value: any,\n): ValueType | undefined {\n  try {\n    return JSON.parse(value)\n  } catch {\n    return undefined\n  }\n}\n","import { isNodeProcess } from 'is-node-process'\nimport { invariant } from 'outvariant'\nimport {\n  Cookie,\n  CookieJar,\n  MemoryCookieStore,\n  type SerializedCookie,\n  type MemoryCookieStoreIndex,\n} from 'tough-cookie'\nimport { jsonParse } from './internal/json-parse'\n\nclass CookieStore {\n  #storageKey = '__msw-cookie-store__'\n  #jar: CookieJar\n  #memoryStore: MemoryCookieStore\n\n  constructor() {\n    invariant(\n      typeof localStorage !== 'undefined',\n      'Failed to create a CookieStore: `localStorage` is not available in this environment. This is likely an issue with your environment, which has been detected as browser (or browser-like) environment and must implement global browser APIs correctly.',\n    )\n\n    this.#memoryStore = new MemoryCookieStore()\n    this.#memoryStore.idx = this.getCookieStoreIndex()\n    this.#jar = new CookieJar(this.#memoryStore)\n  }\n\n  public getCookies(url: string): Array<Cookie> {\n    return this.#jar.getCookiesSync(url)\n  }\n\n  public async setCookie(cookieName: string, url: string): Promise<void> {\n    await this.#jar.setCookie(cookieName, url)\n    this.persist()\n  }\n\n  private getCookieStoreIndex(): MemoryCookieStoreIndex {\n    if (\n      typeof localStorage === 'undefined' ||\n      typeof localStorage.getItem !== 'function'\n    ) {\n      return {}\n    }\n\n    const cookiesString = localStorage.getItem(this.#storageKey)\n    if (cookiesString == null) {\n      return {}\n    }\n\n    const rawCookies = jsonParse<Array<Record<string, unknown>>>(cookiesString)\n    if (rawCookies == null) {\n      return {}\n    }\n\n    const cookies: MemoryCookieStoreIndex = {}\n\n    for (const rawCookie of rawCookies) {\n      const cookie = Cookie.fromJSON(rawCookie)\n\n      if (cookie != null && cookie.domain != null && cookie.path != null) {\n        cookies[cookie.domain] ||= {}\n        cookies[cookie.domain][cookie.path] ||= {}\n        cookies[cookie.domain][cookie.path][cookie.key] = cookie\n      }\n    }\n\n    return cookies\n  }\n\n  private persist(): void {\n    if (\n      typeof localStorage === 'undefined' ||\n      typeof localStorage.setItem !== 'function'\n    ) {\n      return\n    }\n\n    const data: Array<SerializedCookie> = []\n    const { idx } = this.#memoryStore\n\n    for (const domain in idx) {\n      for (const path in idx[domain]) {\n        for (const key in idx[domain][path]) {\n          data.push(idx[domain][path][key].toJSON())\n        }\n      }\n    }\n\n    try {\n      localStorage.setItem(this.#storageKey, JSON.stringify(data))\n    } catch {\n      // Persisting cookies is best-effort. If the storage quota is exceeded,\n      // keep the cookies in memory so the request handling continues.\n      return\n    }\n  }\n}\n\n// Node.js has no implicit cookie jar. Leave cookie management to the client.\nexport const cookieStore = isNodeProcess() ? null : new CookieStore()\n"],"mappings":"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"}

package/lib/_chunks/execute-handlers.js

@@ -0,0 +1,29 @@
+//#region src/core/utils/execute-handlers.ts
+/**
+* Executes the list of request handlers against the given request.
+* Returns the execution result object containing any matching request
+* handler and any mocked response it returned.
+*/
+const executeHandlers = async ({ request, requestId, handlers, resolutionContext }) => {
+	let matchingHandler = null;
+	let result = null;
+	for (const handler of handlers) {
+		result = await handler.run({
+			request,
+			requestId,
+			resolutionContext
+		});
+		if (result !== null) matchingHandler = handler;
+		if (result?.response) break;
+	}
+	if (matchingHandler) return {
+		handler: matchingHandler,
+		parsedResult: result?.parsedResult,
+		response: result?.response
+	};
+	return null;
+};
+//#endregion
+export { executeHandlers as t };
+
+//# sourceMappingURL=execute-handlers.js.map

package/lib/_chunks/execute-handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execute-handlers.js","names":[],"sources":["../../src/core/utils/execute-handlers.ts"],"sourcesContent":["import type { RequestHandler } from '../handlers/request-handler'\nimport type { RequestHandlerExecutionResult } from '../handlers/request-handler'\n\nexport interface HandlersExecutionResult {\n  handler: RequestHandler\n  parsedResult?: any\n  response?: Response\n}\n\nexport interface ResponseResolutionContext {\n  /**\n   * A base url to use when resolving relative urls.\n   * @note This is primarily used by the `@mswjs/http-middleware`\n   * to resolve relative urls in the context of the running server\n   */\n  baseUrl?: string\n  quiet?: boolean\n}\n\n/**\n * Executes the list of request handlers against the given request.\n * Returns the execution result object containing any matching request\n * handler and any mocked response it returned.\n */\nexport const executeHandlers = async <Handlers extends Array<RequestHandler>>({\n  request,\n  requestId,\n  handlers,\n  resolutionContext,\n}: {\n  request: Request\n  requestId: string\n  handlers: Handlers\n  resolutionContext?: ResponseResolutionContext\n}): Promise<HandlersExecutionResult | null> => {\n  let matchingHandler: RequestHandler | null = null\n  let result: RequestHandlerExecutionResult<any> | null = null\n\n  for (const handler of handlers) {\n    result = await handler.run({ request, requestId, resolutionContext })\n\n    // If the handler produces some result for this request,\n    // it automatically becomes matching.\n    if (result !== null) {\n      matchingHandler = handler\n    }\n\n    // Stop the lookup if this handler returns a mocked response.\n    // If it doesn't, it will still be considered the last matching\n    // handler until any of them returns a response. This way we can\n    // distinguish between fallthrough handlers without responses\n    // and the lack of a matching handler.\n    if (result?.response) {\n      break\n    }\n  }\n\n  if (matchingHandler) {\n    return {\n      handler: matchingHandler,\n      parsedResult: result?.parsedResult,\n      response: result?.response,\n    }\n  }\n\n  return null\n}\n"],"mappings":";;;;;;AAwBA,MAAa,kBAAkB,OAA+C,EAC5E,SACA,WACA,UACA,wBAM6C;CAC7C,IAAI,kBAAyC;CAC7C,IAAI,SAAoD;CAExD,KAAK,MAAM,WAAW,UAAU;EAC9B,SAAS,MAAM,QAAQ,IAAI;GAAE;GAAS;GAAW;EAAkB,CAAC;EAIpE,IAAI,WAAW,MACb,kBAAkB;EAQpB,IAAI,QAAQ,UACV;CAEJ;CAEA,IAAI,iBACF,OAAO;EACL,SAAS;EACT,cAAc,QAAQ;EACtB,UAAU,QAAQ;CACpB;CAGF,OAAO;AACT"}