@page-component-object/msw 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Vega
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/apiMatchers-DVLvnm4q.d.ts

@@ -0,0 +1,45 @@
+import * as _semantic_matchers_core from '@semantic-matchers/core';
+import { MockFn } from '@page-component-object/core';
+import { PathParams, HttpHandler } from 'msw';
+import { SetupServer } from 'msw/node';
+
+type JsonBodyType = Record<string, unknown> | unknown[];
+type DefaultBodyType = JsonBodyType | string | null | void;
+type HttpHandlerInfo = {
+    request: Request;
+    params: PathParams;
+    cookies: Record<string, string>;
+};
+type FlexibleRestHandler<TRequest extends DefaultBodyType = DefaultBodyType, TResponse extends DefaultBodyType = DefaultBodyType> = (info: HttpHandlerInfo & {
+    body?: TRequest;
+}) => Response | TResponse | Promise<Response> | Promise<TResponse>;
+type FlexibleRequest<TRequest extends DefaultBodyType = DefaultBodyType, TResponse extends DefaultBodyType = DefaultBodyType> = FlexibleRestHandler<TRequest, TResponse> | Promise<Response | TResponse> | Response | TResponse;
+type ResponseTrigger<TRequest extends DefaultBodyType = DefaultBodyType, TResponse extends DefaultBodyType = DefaultBodyType> = (value: FlexibleRequest<TRequest, TResponse>) => Promise<void>;
+declare class ApiTestObject {
+    static server: SetupServer | null;
+    static handlers: HttpHandler[];
+    static apiBaseUrl: string;
+    private static restHandlersByKey;
+    private static restHandlerKey;
+    private replaceRestHandler;
+    registerHandler(handler: HttpHandler): void;
+    registerRestHandler<TRequest extends DefaultBodyType = DefaultBodyType, TResponse extends DefaultBodyType = DefaultBodyType>(method: 'get' | 'post' | 'put' | 'delete' | 'patch', path: string, handler: FlexibleRequest<TRequest, TResponse>): MockFn;
+    registerTriggeredRestHandler<TRequest extends DefaultBodyType = DefaultBodyType, TResponse extends DefaultBodyType = DefaultBodyType>(method: 'get' | 'post' | 'put' | 'delete' | 'patch', path: string): readonly [MockFn<(_: HttpHandlerInfo & {
+        body?: TRequest;
+    }) => Promise<void>>, ResponseTrigger<TRequest, TResponse>];
+    static setupServer(): void;
+    static startServer(): void;
+    static stopServer(): void;
+    static resetHandlers(): void;
+    static clear(): void;
+}
+declare function resolveApiUrl(path: string): string;
+
+/** Global matcher for MSW API spies registered via `ApiTestObject`. */
+declare const toHaveBeenLastCalledWithUrl: _semantic_matchers_core.SemanticMatcherFn<MockFn<(...args: never[]) => unknown>, [string | RegExp]>;
+/** Register with `semanticExpect.extendGlobal(apiMockGlobalMatchers)` in Jest/Vitest setup. */
+declare const apiMockGlobalMatchers: {
+    toHaveBeenLastCalledWithUrl: _semantic_matchers_core.SemanticMatcherFn<MockFn<(...args: never[]) => unknown>, [string | RegExp]>;
+};
+
+export { ApiTestObject as A, type FlexibleRequest as F, type HttpHandlerInfo as H, type ResponseTrigger as R, type FlexibleRestHandler as a, apiMockGlobalMatchers as b, resolveApiUrl as r, toHaveBeenLastCalledWithUrl as t };

package/dist/apiMatchers.d.ts

@@ -0,0 +1,5 @@
+import '@semantic-matchers/core';
+import '@page-component-object/core';
+export { H as HttpHandlerInfo, b as apiMockGlobalMatchers, t as toHaveBeenLastCalledWithUrl } from './apiMatchers-DVLvnm4q.js';
+import 'msw';
+import 'msw/node';

package/dist/apiMatchers.js

@@ -0,0 +1,9 @@
+import {
+  apiMockGlobalMatchers,
+  toHaveBeenLastCalledWithUrl
+} from "./chunk-FOADFUEL.js";
+export {
+  apiMockGlobalMatchers,
+  toHaveBeenLastCalledWithUrl
+};
+//# sourceMappingURL=apiMatchers.js.map

package/dist/apiMatchers.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-FOADFUEL.js

@@ -0,0 +1,46 @@
+// src/apiMatchers.ts
+import { defineMatcher } from "@semantic-matchers/core";
+function isMockFn(value) {
+  return typeof value === "function" && typeof value.mock === "object" && Array.isArray(value.mock.calls);
+}
+var toHaveBeenLastCalledWithUrl = defineMatcher(
+  function toHaveBeenLastCalledWithUrl2(received, expected) {
+    if (!isMockFn(received)) {
+      return {
+        pass: false,
+        message: () => "Expected an API mock function registered via ApiTestObject."
+      };
+    }
+    if (received.mock.calls.length === 0) {
+      return {
+        pass: false,
+        message: () => "Expected mock function to have been called, but it was not called."
+      };
+    }
+    const lastCall = received.mock.calls[received.mock.calls.length - 1];
+    const info = lastCall[0];
+    const actualUrl = info.request.url;
+    const host = this.host ?? {};
+    const equals = host.equals ?? Object.is;
+    const pass = expected instanceof RegExp ? expected.test(actualUrl) : equals(actualUrl, expected);
+    return {
+      pass,
+      message: () => `Expected request URL to match:
+  ${String(expected)}
+
+Received:
+  ${actualUrl}`,
+      actual: actualUrl,
+      expected
+    };
+  }
+);
+var apiMockGlobalMatchers = {
+  toHaveBeenLastCalledWithUrl
+};
+
+export {
+  toHaveBeenLastCalledWithUrl,
+  apiMockGlobalMatchers
+};
+//# sourceMappingURL=chunk-FOADFUEL.js.map

package/dist/chunk-FOADFUEL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/apiMatchers.ts"],"sourcesContent":["import { defineMatcher } from '@semantic-matchers/core';\n\nimport type { MockFn } from '@page-component-object/core';\n\nimport type { HttpHandlerInfo } from './ApiTestObject';\n\nfunction isMockFn(value: unknown): value is MockFn {\n  return (\n    typeof value === 'function' &&\n    typeof (value as MockFn).mock === 'object' &&\n    Array.isArray((value as MockFn).mock.calls)\n  );\n}\n\n/** Global matcher for MSW API spies registered via `ApiTestObject`. */\nexport const toHaveBeenLastCalledWithUrl = defineMatcher<MockFn, [string | RegExp]>(\n  function toHaveBeenLastCalledWithUrl(received, expected) {\n    if (!isMockFn(received)) {\n      return {\n        pass: false,\n        message: () => 'Expected an API mock function registered via ApiTestObject.',\n      };\n    }\n\n    if (received.mock.calls.length === 0) {\n      return {\n        pass: false,\n        message: () => 'Expected mock function to have been called, but it was not called.',\n      };\n    }\n\n    const lastCall = received.mock.calls[received.mock.calls.length - 1];\n    const info = lastCall[0] as HttpHandlerInfo;\n    const actualUrl = info.request.url;\n\n    const host = (this.host ?? {}) as { equals?: (a: unknown, b: unknown) => boolean };\n    const equals = host.equals ?? Object.is;\n    const pass =\n      expected instanceof RegExp ? expected.test(actualUrl) : equals(actualUrl, expected);\n\n    return {\n      pass,\n      message: () =>\n        `Expected request URL to match:\\n  ${String(expected)}\\n\\nReceived:\\n  ${actualUrl}`,\n      actual: actualUrl,\n      expected,\n    };\n  },\n);\n\n/** Register with `semanticExpect.extendGlobal(apiMockGlobalMatchers)` in Jest/Vitest setup. */\nexport const apiMockGlobalMatchers = {\n  toHaveBeenLastCalledWithUrl,\n};\n\nexport type { HttpHandlerInfo } from './ApiTestObject';\n"],"mappings":";AAAA,SAAS,qBAAqB;AAM9B,SAAS,SAAS,OAAiC;AACjD,SACE,OAAO,UAAU,cACjB,OAAQ,MAAiB,SAAS,YAClC,MAAM,QAAS,MAAiB,KAAK,KAAK;AAE9C;AAGO,IAAM,8BAA8B;AAAA,EACzC,SAASA,6BAA4B,UAAU,UAAU;AACvD,QAAI,CAAC,SAAS,QAAQ,GAAG;AACvB,aAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS,MAAM;AAAA,MACjB;AAAA,IACF;AAEA,QAAI,SAAS,KAAK,MAAM,WAAW,GAAG;AACpC,aAAO;AAAA,QACL,MAAM;AAAA,QACN,SAAS,MAAM;AAAA,MACjB;AAAA,IACF;AAEA,UAAM,WAAW,SAAS,KAAK,MAAM,SAAS,KAAK,MAAM,SAAS,CAAC;AACnE,UAAM,OAAO,SAAS,CAAC;AACvB,UAAM,YAAY,KAAK,QAAQ;AAE/B,UAAM,OAAQ,KAAK,QAAQ,CAAC;AAC5B,UAAM,SAAS,KAAK,UAAU,OAAO;AACrC,UAAM,OACJ,oBAAoB,SAAS,SAAS,KAAK,SAAS,IAAI,OAAO,WAAW,QAAQ;AAEpF,WAAO;AAAA,MACL;AAAA,MACA,SAAS,MACP;AAAA,IAAqC,OAAO,QAAQ,CAAC;AAAA;AAAA;AAAA,IAAoB,SAAS;AAAA,MACpF,QAAQ;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAGO,IAAM,wBAAwB;AAAA,EACnC;AACF;","names":["toHaveBeenLastCalledWithUrl"]}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+export { A as ApiTestObject, F as FlexibleRequest, a as FlexibleRestHandler, H as HttpHandlerInfo, R as ResponseTrigger, b as apiMockGlobalMatchers, r as resolveApiUrl, t as toHaveBeenLastCalledWithUrl } from './apiMatchers-DVLvnm4q.js';
+import { HttpHandler } from 'msw';
+export { HttpHandler } from 'msw';
+import '@semantic-matchers/core';
+import '@page-component-object/core';
+import 'msw/node';
+
+type MockDataSource = {
+    setupMockData(): unknown;
+};
+type MockSession<T extends MockDataSource> = {
+    handlers: HttpHandler[];
+    instance: T;
+    mocks: ReturnType<T['setupMockData']>;
+};
+/** Copy of handlers registered since last reset — safe to pass to Storybook or node MSW. */
+declare function snapshotHandlers(): HttpHandler[];
+/**
+ * Register mocks in an isolated session without starting the node MSW server.
+ * Returns the same handler instances (and embedded spies) for Vitest/Jest and Storybook.
+ *
+ * `configure` runs after `setupMockData()` so stories can override view fields or
+ * register additional handlers before handlers are snapshotted.
+ */
+declare function createMockSession<T extends MockDataSource>(factory: () => T, configure?: (instance: T, mocks: ReturnType<T['setupMockData']>) => void): MockSession<T>;
+declare function buildMswParameters(handlers: HttpHandler[]): {
+    msw: {
+        handlers: HttpHandler[];
+    };
+};
+
+export { type MockDataSource, type MockSession, buildMswParameters, createMockSession, snapshotHandlers };

package/dist/index.js

@@ -0,0 +1,157 @@
+import {
+  apiMockGlobalMatchers,
+  toHaveBeenLastCalledWithUrl
+} from "./chunk-FOADFUEL.js";
+
+// src/ApiTestObject.ts
+import { http, HttpResponse } from "msw";
+import { setupServer } from "msw/node";
+import { getRuntime } from "@page-component-object/core";
+async function flexibleRequestToResult(request, info) {
+  const result = typeof request === "function" ? await request(info) : request;
+  if (result instanceof Response) {
+    return result;
+  }
+  if (typeof result === "object" && result !== null) {
+    return HttpResponse.json(result);
+  }
+  return new HttpResponse(String(result));
+}
+async function safeParseBody(request) {
+  try {
+    const cloned = request.clone();
+    const ct = cloned.headers.get("content-type") ?? "";
+    if (ct.includes("application/json")) {
+      return await cloned.json();
+    }
+    const text = await cloned.text();
+    if (!text) return void 0;
+    try {
+      return JSON.parse(text);
+    } catch {
+      return text;
+    }
+  } catch {
+    return void 0;
+  }
+}
+function flexRequestToHttpHandler(requestHandler) {
+  const { spyFactory } = getRuntime();
+  const mocked = spyFactory.fn(
+    async (enriched) => {
+      return flexibleRequestToResult(requestHandler, enriched);
+    }
+  );
+  const mswResolver = async (info) => {
+    const body = await safeParseBody(info.request);
+    const enriched = { ...info, body };
+    return mocked(enriched);
+  };
+  return { mswResolver, mocked };
+}
+var ApiTestObject = class _ApiTestObject {
+  static server = null;
+  static handlers = [];
+  static apiBaseUrl = "";
+  static restHandlersByKey = /* @__PURE__ */ new Map();
+  static restHandlerKey(method, path) {
+    return `${method.toUpperCase()}:${path}`;
+  }
+  replaceRestHandler(method, path, httpHandler) {
+    const key = _ApiTestObject.restHandlerKey(method, path);
+    const previous = _ApiTestObject.restHandlersByKey.get(key);
+    if (previous) {
+      _ApiTestObject.handlers = _ApiTestObject.handlers.filter((handler) => handler !== previous);
+    }
+    _ApiTestObject.restHandlersByKey.set(key, httpHandler);
+  }
+  registerHandler(handler) {
+    _ApiTestObject.handlers.push(handler);
+  }
+  registerRestHandler(method, path, handler) {
+    const { mswResolver, mocked } = flexRequestToHttpHandler(handler);
+    const httpHandler = http[method](path, mswResolver);
+    this.replaceRestHandler(method, path, httpHandler);
+    this.registerHandler(httpHandler);
+    _ApiTestObject.server?.use(httpHandler);
+    return mocked;
+  }
+  registerTriggeredRestHandler(method, path) {
+    const { spyFactory } = getRuntime();
+    let trigger = null;
+    const mockedHandler = spyFactory.fn(async (_) => {
+    });
+    const httpHandler = http[method](path, async (info) => {
+      const body = await safeParseBody(info.request);
+      const enriched = { ...info, body };
+      await mockedHandler(enriched);
+      return new Promise((resolve) => {
+        trigger = async (value) => {
+          resolve(await flexibleRequestToResult(value, enriched));
+        };
+      });
+    });
+    this.replaceRestHandler(method, path, httpHandler);
+    this.registerHandler(httpHandler);
+    _ApiTestObject.server?.use(httpHandler);
+    const triggerShell = async (value) => {
+      if (!trigger) throw new Error("Handler has never been called");
+      await trigger(value);
+    };
+    return [mockedHandler, triggerShell];
+  }
+  static setupServer() {
+    const refreshTokenHandler = http.post(
+      "*/refresh-token",
+      () => HttpResponse.json({ message: "Refresh token endpoint not mocked in test" }, { status: 500 })
+    );
+    this.server = setupServer(refreshTokenHandler, ..._ApiTestObject.handlers.reverse());
+  }
+  static startServer() {
+    this.server?.listen({ onUnhandledRequest: "warn" });
+  }
+  static stopServer() {
+    this.server?.close();
+    this.server = null;
+  }
+  static resetHandlers() {
+    this.handlers = [];
+    this.restHandlersByKey.clear();
+  }
+  static clear() {
+    this.stopServer();
+    this.resetHandlers();
+  }
+};
+function resolveApiUrl(path) {
+  const base = ApiTestObject.apiBaseUrl.replace(/\/$/, "");
+  const normalized = path.startsWith("/") ? path : `/${path}`;
+  return `${base}${normalized}`;
+}
+
+// src/mockSession.ts
+function snapshotHandlers() {
+  return [...ApiTestObject.handlers];
+}
+function createMockSession(factory, configure) {
+  ApiTestObject.resetHandlers();
+  const instance = factory();
+  const mocks = instance.setupMockData();
+  configure?.(instance, mocks);
+  const handlers = snapshotHandlers();
+  ApiTestObject.resetHandlers();
+  return { handlers, instance, mocks };
+}
+function buildMswParameters(handlers) {
+  return { msw: { handlers } };
+}
+export {
+  ApiTestObject,
+  apiMockGlobalMatchers,
+  buildMswParameters,
+  createMockSession,
+  resolveApiUrl,
+  snapshotHandlers,
+  toHaveBeenLastCalledWithUrl
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/ApiTestObject.ts","../src/mockSession.ts"],"sourcesContent":["import { http, HttpResponse, type HttpHandler, type PathParams } from 'msw';\nimport { setupServer, type SetupServer } from 'msw/node';\n\nimport { getRuntime, type MockFn } from '@page-component-object/core';\n\ntype JsonBodyType = Record<string, unknown> | unknown[];\ntype DefaultBodyType = JsonBodyType | string | null | void;\n\nexport type HttpHandlerInfo = {\n  request: Request;\n  params: PathParams;\n  cookies: Record<string, string>;\n};\n\nexport type FlexibleRestHandler<\n  TRequest extends DefaultBodyType = DefaultBodyType,\n  TResponse extends DefaultBodyType = DefaultBodyType,\n> = (\n  info: HttpHandlerInfo & { body?: TRequest },\n) => Response | TResponse | Promise<Response> | Promise<TResponse>;\n\nexport type FlexibleRequest<\n  TRequest extends DefaultBodyType = DefaultBodyType,\n  TResponse extends DefaultBodyType = DefaultBodyType,\n> =\n  | FlexibleRestHandler<TRequest, TResponse>\n  | Promise<Response | TResponse>\n  | Response\n  | TResponse;\n\nexport type ResponseTrigger<\n  TRequest extends DefaultBodyType = DefaultBodyType,\n  TResponse extends DefaultBodyType = DefaultBodyType,\n> = (value: FlexibleRequest<TRequest, TResponse>) => Promise<void>;\n\nasync function flexibleRequestToResult<\n  TRequest extends DefaultBodyType,\n  TResponse extends DefaultBodyType,\n>(\n  request: FlexibleRequest<TRequest, TResponse>,\n  info: HttpHandlerInfo & { body?: TRequest },\n): Promise<Response> {\n  const result = typeof request === 'function' ? await request(info) : request;\n\n  if (result instanceof Response) {\n    return result;\n  }\n\n  if (typeof result === 'object' && result !== null) {\n    return HttpResponse.json(result);\n  }\n\n  return new HttpResponse(String(result));\n}\n\nasync function safeParseBody<T>(request: Request): Promise<T | undefined> {\n  try {\n    const cloned = request.clone();\n    const ct = cloned.headers.get('content-type') ?? '';\n    if (ct.includes('application/json')) {\n      return (await cloned.json()) as T;\n    }\n    const text = await cloned.text();\n    if (!text) return undefined;\n    try {\n      return JSON.parse(text) as T;\n    } catch {\n      return text as unknown as T;\n    }\n  } catch {\n    return undefined;\n  }\n}\n\nfunction flexRequestToHttpHandler<\n  TRequest extends DefaultBodyType = DefaultBodyType,\n  TResponse extends DefaultBodyType = DefaultBodyType,\n>(requestHandler: FlexibleRequest<TRequest, TResponse>) {\n  const { spyFactory } = getRuntime();\n  const mocked = spyFactory.fn(\n    async (enriched: HttpHandlerInfo & { body?: TRequest }): Promise<Response> => {\n      return flexibleRequestToResult(requestHandler, enriched);\n    },\n  );\n\n  const mswResolver = async (info: HttpHandlerInfo): Promise<Response> => {\n    const body = await safeParseBody<TRequest>(info.request);\n    const enriched = { ...info, body } as HttpHandlerInfo & { body?: TRequest };\n    return mocked(enriched);\n  };\n\n  return { mswResolver, mocked };\n}\n\nexport interface ApiMockConfig {\n  apiBaseUrl?: string;\n}\n\nexport default class ApiTestObject {\n  static server: SetupServer | null = null;\n  static handlers: HttpHandler[] = [];\n  static apiBaseUrl = '';\n  private static restHandlersByKey = new Map<string, HttpHandler>();\n\n  private static restHandlerKey(method: string, path: string): string {\n    return `${method.toUpperCase()}:${path}`;\n  }\n\n  private replaceRestHandler(method: string, path: string, httpHandler: HttpHandler): void {\n    const key = ApiTestObject.restHandlerKey(method, path);\n    const previous = ApiTestObject.restHandlersByKey.get(key);\n    if (previous) {\n      ApiTestObject.handlers = ApiTestObject.handlers.filter((handler) => handler !== previous);\n    }\n    ApiTestObject.restHandlersByKey.set(key, httpHandler);\n  }\n\n  registerHandler(handler: HttpHandler): void {\n    ApiTestObject.handlers.push(handler);\n  }\n\n  registerRestHandler<\n    TRequest extends DefaultBodyType = DefaultBodyType,\n    TResponse extends DefaultBodyType = DefaultBodyType,\n  >(\n    method: 'get' | 'post' | 'put' | 'delete' | 'patch',\n    path: string,\n    handler: FlexibleRequest<TRequest, TResponse>,\n  ): MockFn {\n    const { mswResolver, mocked } = flexRequestToHttpHandler<TRequest, TResponse>(handler);\n    const httpHandler = http[method](path, mswResolver);\n    this.replaceRestHandler(method, path, httpHandler);\n    this.registerHandler(httpHandler);\n    ApiTestObject.server?.use(httpHandler);\n    return mocked;\n  }\n\n  registerTriggeredRestHandler<\n    TRequest extends DefaultBodyType = DefaultBodyType,\n    TResponse extends DefaultBodyType = DefaultBodyType,\n  >(method: 'get' | 'post' | 'put' | 'delete' | 'patch', path: string) {\n    const { spyFactory } = getRuntime();\n    let trigger: ResponseTrigger<TRequest, TResponse> | null = null;\n    const mockedHandler = spyFactory.fn(async (_: HttpHandlerInfo & { body?: TRequest }) => {});\n\n    const httpHandler = http[method](path, async (info: HttpHandlerInfo): Promise<Response> => {\n      const body = await safeParseBody<TRequest>(info.request);\n      const enriched = { ...info, body } as HttpHandlerInfo & { body?: TRequest };\n      await mockedHandler(enriched);\n\n      return new Promise<Response>((resolve) => {\n        trigger = async (value: FlexibleRequest<TRequest, TResponse>) => {\n          resolve(await flexibleRequestToResult(value, enriched));\n        };\n      });\n    });\n\n    this.replaceRestHandler(method, path, httpHandler);\n    this.registerHandler(httpHandler);\n    ApiTestObject.server?.use(httpHandler);\n\n    const triggerShell: ResponseTrigger<TRequest, TResponse> = async (value) => {\n      if (!trigger) throw new Error('Handler has never been called');\n      await trigger(value);\n    };\n\n    return [mockedHandler, triggerShell] as const;\n  }\n\n  static setupServer(): void {\n    const refreshTokenHandler = http.post('*/refresh-token', () =>\n      HttpResponse.json({ message: 'Refresh token endpoint not mocked in test' }, { status: 500 }),\n    );\n    this.server = setupServer(refreshTokenHandler, ...ApiTestObject.handlers.reverse());\n  }\n\n  static startServer(): void {\n    this.server?.listen({ onUnhandledRequest: 'warn' });\n  }\n\n  static stopServer(): void {\n    this.server?.close();\n    this.server = null;\n  }\n\n  static resetHandlers(): void {\n    this.handlers = [];\n    this.restHandlersByKey.clear();\n  }\n\n  static clear(): void {\n    this.stopServer();\n    this.resetHandlers();\n  }\n}\n\nexport function resolveApiUrl(path: string): string {\n  const base = ApiTestObject.apiBaseUrl.replace(/\\/$/, '');\n  const normalized = path.startsWith('/') ? path : `/${path}`;\n  return `${base}${normalized}`;\n}\n","import type { HttpHandler } from 'msw';\r\n\r\nimport ApiTestObject from './ApiTestObject';\r\n\r\nexport type MockDataSource = {\r\n  setupMockData(): unknown;\r\n};\r\n\r\nexport type MockSession<T extends MockDataSource> = {\r\n  handlers: HttpHandler[];\r\n  instance: T;\r\n  mocks: ReturnType<T['setupMockData']>;\r\n};\r\n\r\n/** Copy of handlers registered since last reset — safe to pass to Storybook or node MSW. */\r\nexport function snapshotHandlers(): HttpHandler[] {\r\n  return [...ApiTestObject.handlers];\r\n}\r\n\r\n/**\r\n * Register mocks in an isolated session without starting the node MSW server.\r\n * Returns the same handler instances (and embedded spies) for Vitest/Jest and Storybook.\r\n *\r\n * `configure` runs after `setupMockData()` so stories can override view fields or\r\n * register additional handlers before handlers are snapshotted.\r\n */\r\nexport function createMockSession<T extends MockDataSource>(\r\n  factory: () => T,\r\n  configure?: (instance: T, mocks: ReturnType<T['setupMockData']>) => void,\r\n): MockSession<T> {\r\n  ApiTestObject.resetHandlers();\r\n  const instance = factory();\r\n  const mocks = instance.setupMockData() as ReturnType<T['setupMockData']>;\r\n  configure?.(instance, mocks);\r\n  const handlers = snapshotHandlers();\r\n  ApiTestObject.resetHandlers();\r\n  return { handlers, instance, mocks };\r\n}\r\n\r\nexport function buildMswParameters(handlers: HttpHandler[]): { msw: { handlers: HttpHandler[] } } {\r\n  return { msw: { handlers } };\r\n}\r\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@page-component-object/msw",
+  "version": "0.1.0",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./matchers": {
+      "types": "./dist/apiMatchers.d.ts",
+      "import": "./dist/apiMatchers.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@semantic-matchers/core": "^0.1.1",
+    "@page-component-object/core": "0.1.0"
+  },
+  "peerDependencies": {
+    "msw": "^2.0.0"
+  },
+  "devDependencies": {
+    "msw": "^2.7.0",
+    "rimraf": "^6.0.1",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/dvegap95/page-component-test-object.git",
+    "directory": "packages/msw"
+  },
+  "homepage": "https://github.com/dvegap95/page-component-test-object#readme",
+  "bugs": {
+    "url": "https://github.com/dvegap95/page-component-test-object/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "clean": "rimraf dist"
+  }
+}