vite-plugin-automock 1.1.6 → 1.2.0

package/README.md

@@ -34,7 +34,7 @@ import { automock } from 'vite-plugin-automock'
 export default defineConfig({
   plugins: [
     automock({
-      proxyBaseUrl: 'https://api.example.com', // Required: your API server URL
+      proxyBaseUrl: 'https://api.example.com', // Required for proxy/capture
     })
   ]
 })
@@ -52,14 +52,14 @@ That's it! The plugin will:
 
 | Option | Type | Required | Default | Description |
 | ------ | ---- | -------- | ------- | ----------- |
-| `proxyBaseUrl` | `string` | Yes | - | Base URL of your API server |
+| `proxyBaseUrl` | `string` | No | - | Base URL of your API server. Required only when `proxy` or `capture` is used |
 | `mockDir` | `string` | No | `'mock'` | Directory to store mock files |
 | `apiPrefix` | `string` | No | `'/api'` | API path prefix to intercept |
 | `pathRewrite` | `(path: string) => string` | No | `(path) => path` | Function to rewrite request paths |
 | `enabled` | `boolean` | No | `true` | Global switch. When `false`, all requests pass through without mock handling |
 | `proxy` | `boolean` | No | `true` | Whether to proxy unmatched requests to `proxyBaseUrl` |
 | `capture` | `boolean` | No | `true` | Whether to auto-capture proxy responses and save as mock files |
-| `productionMock` | `boolean \| 'auto'` | No | `false` | Enable mock in production mode |
+| `productionMock` | `boolean \| 'auto'` | No | `false` | Enable client-side mock bundle support |
 | `inspector` | `boolean \| InspectorOptions` | No | `false` | Enable visual mock inspector UI |
 
 ### Bundle Options
@@ -71,6 +71,8 @@ These options are available when using the `automock()` function (which includes
 | `bundleMockData` | `boolean` | `true` | Whether to bundle mock data for production |
 | `bundleOutputPath` | `string` | `'public/mock-data.json'` | Output path for the mock bundle file |
 
+For a complete explanation of option interactions, see [Configuration Guide](docs/CONFIGURATION_CN.md).
+
 ### Inspector Options
 
 When `inspector` is an object:
@@ -114,22 +116,9 @@ export default defineConfig({
 })
 ```
 
-## Fine-grained Control
-
-The `enabled`, `proxy`, and `capture` options provide independent control over the plugin's behavior:
-
-### Record-only Mode
+## Behavior Modes
 
-Proxy to the backend and capture responses, but don't intercept requests with existing mocks:
-
-```typescript
-automock({
-  proxyBaseUrl: 'https://api.example.com',
-  enabled: false,  // Don't intercept
-  proxy: true,     // Proxy to backend
-  capture: true,   // Save responses as mock files
-})
-```
+The `enabled`, `proxy`, and `capture` options control different parts of the development middleware. `enabled=false` is a global bypass: the plugin will not read mocks, proxy, or capture.
 
 ### Mock-only Mode
 
@@ -144,16 +133,13 @@ automock({
 })
 ```
 
-### Pure Proxy Mode
+### Pass-through Mode
 
-Bypass all mock handling, just proxy to backend:
+Bypass all automock handling and let later Vite middleware, including `server.proxy`, handle the request:
 
 ```typescript
 automock({
-  proxyBaseUrl: 'https://api.example.com',
-  enabled: false,  // Don't intercept
-  proxy: true,     // Proxy to backend
-  capture: false,  // Don't save mocks
+  enabled: false,
 })
 ```
 
@@ -265,7 +251,7 @@ automock({
 
 3. Initialize the client interceptor in your app (see [Client API Reference](#client-api-reference)).
 
-4. The `productionMock: 'auto'` option automatically enables mock based on the environment.
+4. The `productionMock: 'auto'` option enables mock outside `production` mode and disables it in `production` mode.
 
 ## Mock Inspector
 

package/dist/{chunk-DJWYFFPU.mjs → chunk-2KRAWI7J.mjs}

@@ -4,6 +4,24 @@ var MockInterceptor = class {
   constructor(options) {
     this.options = options;
   }
+  normalizeUrlPath(url, baseURL) {
+    if (!url) return "";
+    try {
+      const isAbsoluteUrl = /^[a-z][a-z\d+\-.]*:\/\//i.test(url);
+      const browserOrigin = typeof window !== "undefined" && window.location?.origin ? window.location.origin : "http://localhost";
+      if (isAbsoluteUrl) {
+        return new URL(url).pathname;
+      }
+      if (baseURL) {
+        const normalizedBase = baseURL.endsWith("/") ? baseURL : `${baseURL}/`;
+        const normalizedUrl = url.replace(/^\/+/, "");
+        return new URL(normalizedUrl, normalizedBase).pathname;
+      }
+      return new URL(url, browserOrigin).pathname;
+    } catch {
+      return url.split(/[?#]/)[0] || "";
+    }
+  }
   /**
    * Check if mock is enabled
    */
@@ -22,14 +40,19 @@ var MockInterceptor = class {
    * - "GET /api/v1/asset/xxx" (HTTP method + URL)
    * - "/api/v1/asset/xxx/get.js" (File path format from automock plugin)
    */
-  findMock(url, method) {
+  findMock(url, method, baseURL) {
     const methodUpper = method.toUpperCase();
     const methodLower = method.toLowerCase();
+    const normalizedPath = this.normalizeUrlPath(url, baseURL);
     const httpMethodKey = `${methodUpper} ${url}`;
     if (this.options.mockData[httpMethodKey]) {
       return this.options.mockData[httpMethodKey];
     }
-    const filePathKey = `${url}/${methodLower}.js`;
+    const normalizedHttpMethodKey = `${methodUpper} ${normalizedPath}`;
+    if (this.options.mockData[normalizedHttpMethodKey]) {
+      return this.options.mockData[normalizedHttpMethodKey];
+    }
+    const filePathKey = `${normalizedPath}/${methodLower}.js`;
     if (this.options.mockData[filePathKey]) {
       return this.options.mockData[filePathKey];
     }
@@ -38,21 +61,21 @@ var MockInterceptor = class {
   /**
    * Determine if request should be mocked
    */
-  shouldMock(url, method) {
+  shouldMock(url, method, baseURL) {
     if (!this.isEnabled()) {
       return false;
     }
-    const mock = this.findMock(url, method);
+    const mock = this.findMock(url, method, baseURL);
     return mock !== null && mock.enable;
   }
   /**
    * Get mock data for request
    */
-  getMock(url, method) {
-    if (!this.shouldMock(url, method)) {
+  getMock(url, method, baseURL) {
+    if (!this.shouldMock(url, method, baseURL)) {
       return null;
     }
-    return this.findMock(url, method);
+    return this.findMock(url, method, baseURL);
   }
   /**
    * Setup axios interceptor
@@ -62,9 +85,10 @@ var MockInterceptor = class {
       async (config) => {
         const url = config.url || "";
         const method = config.method?.toUpperCase() || "GET";
-        const mock = this.getMock(url, method);
+        const normalizedUrl = this.normalizeUrlPath(url, config.baseURL);
+        const mock = this.getMock(url, method, config.baseURL);
         if (mock) {
-          this.options.onMockHit?.(url, method, mock);
+          this.options.onMockHit?.(normalizedUrl, method, mock);
           config.adapter = async () => {
             const { data, delay = 0, status = 200 } = mock;
             if (delay > 0) {
@@ -80,7 +104,7 @@ var MockInterceptor = class {
           };
         } else {
           const reason = !this.isEnabled() ? "Mock disabled globally" : "No matching mock found or mock disabled";
-          this.options.onBypass?.(url, method, reason);
+          this.options.onBypass?.(normalizedUrl, method, reason);
         }
         return config;
       },
@@ -160,4 +184,4 @@ export {
   registerHttpInstance,
   initMockInterceptorForPureHttp
 };
-//# sourceMappingURL=chunk-DJWYFFPU.mjs.map
+//# sourceMappingURL=chunk-2KRAWI7J.mjs.map

package/dist/chunk-2KRAWI7J.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client/interceptor.ts"],"sourcesContent":["import type {\n  AxiosInstance,\n  AxiosResponse,\n  InternalAxiosRequestConfig,\n} from \"axios\";\n\ndeclare const __AUTOMOCK_ENABLED__: boolean;\n\nexport type MockBundleData = {\n  enable: boolean;\n  data: unknown;\n  delay?: number;\n  status?: number;\n  isBinary?: boolean;\n};\n\nexport type MockInterceptorOptions = {\n  mockData: Record<string, MockBundleData>;\n  enabled?: boolean | (() => boolean);\n  onMockHit?: (url: string, method: string, mock: MockBundleData) => void;\n  onBypass?: (url: string, method: string, reason: string) => void;\n};\n\ntype MockEnabledState = boolean | undefined;\n\ndeclare global {\n  interface Window {\n    __MOCK_ENABLED__?: MockEnabledState;\n  }\n}\n\nclass MockInterceptor {\n  private options: MockInterceptorOptions;\n\n  constructor(options: MockInterceptorOptions) {\n    this.options = options;\n  }\n\n  private normalizeUrlPath(url: string, baseURL?: string): string {\n    if (!url) return \"\";\n\n    try {\n      const isAbsoluteUrl = /^[a-z][a-z\\d+\\-.]*:\\/\\//i.test(url);\n      const browserOrigin =\n        typeof window !== \"undefined\" && window.location?.origin\n          ? window.location.origin\n          : \"http://localhost\";\n\n      if (isAbsoluteUrl) {\n        return new URL(url).pathname;\n      }\n\n      if (baseURL) {\n        const normalizedBase = baseURL.endsWith(\"/\") ? baseURL : `${baseURL}/`;\n        const normalizedUrl = url.replace(/^\\/+/, \"\");\n        return new URL(normalizedUrl, normalizedBase).pathname;\n      }\n\n      return new URL(url, browserOrigin).pathname;\n    } catch {\n      return url.split(/[?#]/)[0] || \"\";\n    }\n  }\n\n  /**\n   * Check if mock is enabled\n   */\n  isEnabled(): boolean {\n    // Check runtime flag first\n    if (window.__MOCK_ENABLED__ !== undefined) {\n      return window.__MOCK_ENABLED__;\n    }\n    // Check environment variable\n    if (typeof this.options.enabled === \"function\") {\n      return this.options.enabled();\n    }\n    return this.options.enabled ?? false;\n  }\n\n  /**\n   * Find matching mock data for the request\n   * Supports both formats:\n   * - \"GET /api/v1/asset/xxx\" (HTTP method + URL)\n   * - \"/api/v1/asset/xxx/get.js\" (File path format from automock plugin)\n   */\n  private findMock(url: string, method: string, baseURL?: string): MockBundleData | null {\n    const methodUpper = method.toUpperCase();\n    const methodLower = method.toLowerCase();\n    const normalizedPath = this.normalizeUrlPath(url, baseURL);\n\n    // Try HTTP method + URL format first (for compatibility)\n    const httpMethodKey = `${methodUpper} ${url}`;\n    if (this.options.mockData[httpMethodKey]) {\n      return this.options.mockData[httpMethodKey];\n    }\n\n    const normalizedHttpMethodKey = `${methodUpper} ${normalizedPath}`;\n    if (this.options.mockData[normalizedHttpMethodKey]) {\n      return this.options.mockData[normalizedHttpMethodKey];\n    }\n\n    // Try file path format from automock plugin: /api/v1/asset/xxx/get.js\n    const filePathKey = `${normalizedPath}/${methodLower}.js`;\n    if (this.options.mockData[filePathKey]) {\n      return this.options.mockData[filePathKey];\n    }\n\n    return null;\n  }\n\n  /**\n   * Determine if request should be mocked\n   */\n  shouldMock(url: string, method: string, baseURL?: string): boolean {\n    if (!this.isEnabled()) {\n      return false;\n    }\n\n    const mock = this.findMock(url, method, baseURL);\n    return mock !== null && mock.enable;\n  }\n\n  /**\n   * Get mock data for request\n   */\n  getMock(url: string, method: string, baseURL?: string): MockBundleData | null {\n    if (!this.shouldMock(url, method, baseURL)) {\n      return null;\n    }\n    return this.findMock(url, method, baseURL);\n  }\n\n  /**\n   * Setup axios interceptor\n   */\n  setupAxios(axiosInstance: AxiosInstance): void {\n    axiosInstance.interceptors.request.use(\n      async (config: InternalAxiosRequestConfig) => {\n        const url = config.url || \"\";\n        const method = config.method?.toUpperCase() || \"GET\";\n        const normalizedUrl = this.normalizeUrlPath(url, config.baseURL);\n\n        const mock = this.getMock(url, method, config.baseURL);\n\n        if (mock) {\n          // Trigger mock hit callback\n          this.options.onMockHit?.(normalizedUrl, method, mock);\n\n          // Set adapter to return mock data\n          (config as InternalAxiosRequestConfig & { adapter: () => Promise<AxiosResponse> }).adapter = async () => {\n            const { data, delay = 0, status = 200 } = mock;\n\n            // Simulate delay\n            if (delay > 0) {\n              await new Promise((resolve) => setTimeout(resolve, delay));\n            }\n\n            return {\n              data,\n              status,\n              statusText: \"OK\",\n              headers: {},\n              config,\n            };\n          };\n        } else {\n          // Trigger bypass callback\n          const reason = !this.isEnabled()\n            ? \"Mock disabled globally\"\n            : \"No matching mock found or mock disabled\";\n          this.options.onBypass?.(normalizedUrl, method, reason);\n        }\n\n        return config;\n      },\n      (error: unknown) => Promise.reject(error),\n    );\n  }\n}\n\n/**\n * Create mock interceptor instance\n */\nexport function createMockInterceptor(\n  options: MockInterceptorOptions,\n): MockInterceptor {\n  return new MockInterceptor(options);\n}\n\n/**\n * Load mock data from bundled JSON file\n */\nexport async function loadMockData(): Promise<Record<string, MockBundleData>> {\n  try {\n    // In production, mock-data.json is generated by automock plugin\n    // Use absolute path to load it from dist directory\n    const response = await fetch(\"/mock-data.json\");\n    if (!response.ok) {\n      console.warn(\n        \"[MockInterceptor] Failed to load mock-data.json:\",\n        response.statusText,\n      );\n      return {};\n    }\n    const data = (await response.json()) as Record<string, MockBundleData>;\n    return data;\n  } catch (error) {\n    console.warn(\"[MockInterceptor] Failed to load mock-data.json:\", error);\n    return {};\n  }\n}\n\nasync function createInterceptorFromBundle(): Promise<MockInterceptor> {\n  const mockData = await loadMockData();\n  const isEnabled = typeof __AUTOMOCK_ENABLED__ !== \"undefined\" && __AUTOMOCK_ENABLED__;\n\n  return new MockInterceptor({\n    mockData,\n    enabled: isEnabled,\n    onMockHit: (url: string, method: string) => {\n      console.log(`[MOCK HIT] ${method} ${url}`);\n    },\n    onBypass: (url: string, method: string, reason: string) => {\n      console.log(`[MOCK BYPASS] ${method} ${url} - ${reason}`);\n    },\n  });\n}\n\nexport async function initMockInterceptor(\n  axiosInstance?: AxiosInstance,\n): Promise<void> {\n  if (!axiosInstance) {\n    throw new Error(\n      \"[MockInterceptor] axiosInstance is required. Please provide an axios instance.\",\n    );\n  }\n\n  const interceptor = await createInterceptorFromBundle();\n  interceptor.setupAxios(axiosInstance);\n}\n\nexport function setMockEnabled(enabled: boolean): void {\n  window.__MOCK_ENABLED__ = enabled;\n}\n\nexport function isMockEnabled(): boolean {\n  return !!window.__MOCK_ENABLED__;\n}\n\ntype HttpInstance = {\n  constructor: { axiosInstance: AxiosInstance };\n};\n\nlet httpInstanceRef: HttpInstance | undefined;\n\nexport function registerHttpInstance(http: HttpInstance): void {\n  httpInstanceRef = http;\n}\n\nexport async function initMockInterceptorForPureHttp(): Promise<void> {\n  if (!httpInstanceRef) {\n    throw new Error(\n      \"[MockInterceptor] http instance not registered. Call registerHttpInstance(http) first.\",\n    );\n  }\n\n  const interceptor = await createInterceptorFromBundle();\n  interceptor.setupAxios(httpInstanceRef.constructor.axiosInstance);\n}\n"],"mappings":"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","names":[]}

package/dist/client/index.d.mts

@@ -22,6 +22,7 @@ declare global {
 declare class MockInterceptor {
     private options;
     constructor(options: MockInterceptorOptions);
+    private normalizeUrlPath;
     /**
      * Check if mock is enabled
      */
@@ -36,11 +37,11 @@ declare class MockInterceptor {
     /**
      * Determine if request should be mocked
      */
-    shouldMock(url: string, method: string): boolean;
+    shouldMock(url: string, method: string, baseURL?: string): boolean;
     /**
      * Get mock data for request
      */
-    getMock(url: string, method: string): MockBundleData | null;
+    getMock(url: string, method: string, baseURL?: string): MockBundleData | null;
     /**
      * Setup axios interceptor
      */

package/dist/client/index.d.ts

@@ -22,6 +22,7 @@ declare global {
 declare class MockInterceptor {
     private options;
     constructor(options: MockInterceptorOptions);
+    private normalizeUrlPath;
     /**
      * Check if mock is enabled
      */
@@ -36,11 +37,11 @@ declare class MockInterceptor {
     /**
      * Determine if request should be mocked
      */
-    shouldMock(url: string, method: string): boolean;
+    shouldMock(url: string, method: string, baseURL?: string): boolean;
     /**
      * Get mock data for request
      */
-    getMock(url: string, method: string): MockBundleData | null;
+    getMock(url: string, method: string, baseURL?: string): MockBundleData | null;
     /**
      * Setup axios interceptor
      */

package/dist/client/index.js

@@ -36,6 +36,24 @@ var MockInterceptor = class {
   constructor(options) {
     this.options = options;
   }
+  normalizeUrlPath(url, baseURL) {
+    if (!url) return "";
+    try {
+      const isAbsoluteUrl = /^[a-z][a-z\d+\-.]*:\/\//i.test(url);
+      const browserOrigin = typeof window !== "undefined" && window.location?.origin ? window.location.origin : "http://localhost";
+      if (isAbsoluteUrl) {
+        return new URL(url).pathname;
+      }
+      if (baseURL) {
+        const normalizedBase = baseURL.endsWith("/") ? baseURL : `${baseURL}/`;
+        const normalizedUrl = url.replace(/^\/+/, "");
+        return new URL(normalizedUrl, normalizedBase).pathname;
+      }
+      return new URL(url, browserOrigin).pathname;
+    } catch {
+      return url.split(/[?#]/)[0] || "";
+    }
+  }
   /**
    * Check if mock is enabled
    */
@@ -54,14 +72,19 @@ var MockInterceptor = class {
    * - "GET /api/v1/asset/xxx" (HTTP method + URL)
    * - "/api/v1/asset/xxx/get.js" (File path format from automock plugin)
    */
-  findMock(url, method) {
+  findMock(url, method, baseURL) {
     const methodUpper = method.toUpperCase();
     const methodLower = method.toLowerCase();
+    const normalizedPath = this.normalizeUrlPath(url, baseURL);
     const httpMethodKey = `${methodUpper} ${url}`;
     if (this.options.mockData[httpMethodKey]) {
       return this.options.mockData[httpMethodKey];
     }
-    const filePathKey = `${url}/${methodLower}.js`;
+    const normalizedHttpMethodKey = `${methodUpper} ${normalizedPath}`;
+    if (this.options.mockData[normalizedHttpMethodKey]) {
+      return this.options.mockData[normalizedHttpMethodKey];
+    }
+    const filePathKey = `${normalizedPath}/${methodLower}.js`;
     if (this.options.mockData[filePathKey]) {
       return this.options.mockData[filePathKey];
     }
@@ -70,21 +93,21 @@ var MockInterceptor = class {
   /**
    * Determine if request should be mocked
    */
-  shouldMock(url, method) {
+  shouldMock(url, method, baseURL) {
     if (!this.isEnabled()) {
       return false;
     }
-    const mock = this.findMock(url, method);
+    const mock = this.findMock(url, method, baseURL);
     return mock !== null && mock.enable;
   }
   /**
    * Get mock data for request
    */
-  getMock(url, method) {
-    if (!this.shouldMock(url, method)) {
+  getMock(url, method, baseURL) {
+    if (!this.shouldMock(url, method, baseURL)) {
       return null;
     }
-    return this.findMock(url, method);
+    return this.findMock(url, method, baseURL);
   }
   /**
    * Setup axios interceptor
@@ -94,9 +117,10 @@ var MockInterceptor = class {
       async (config) => {
         const url = config.url || "";
         const method = config.method?.toUpperCase() || "GET";
-        const mock = this.getMock(url, method);
+        const normalizedUrl = this.normalizeUrlPath(url, config.baseURL);
+        const mock = this.getMock(url, method, config.baseURL);
         if (mock) {
-          this.options.onMockHit?.(url, method, mock);
+          this.options.onMockHit?.(normalizedUrl, method, mock);
           config.adapter = async () => {
             const { data, delay = 0, status = 200 } = mock;
             if (delay > 0) {
@@ -112,7 +136,7 @@ var MockInterceptor = class {
           };
         } else {
           const reason = !this.isEnabled() ? "Mock disabled globally" : "No matching mock found or mock disabled";
-          this.options.onBypass?.(url, method, reason);
+          this.options.onBypass?.(normalizedUrl, method, reason);
         }
         return config;
       },

package/dist/client/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/client/index.ts","../../src/client/interceptor.ts"],"sourcesContent":["export {\n  createMockInterceptor,\n  initMockInterceptor,\n  initMockInterceptorForPureHttp,\n  setMockEnabled,\n  isMockEnabled,\n  loadMockData,\n  registerHttpInstance\n} from './interceptor'\n\nexport type { MockInterceptorOptions, MockBundleData } from './interceptor'\n","import type {\n  AxiosInstance,\n  AxiosResponse,\n  InternalAxiosRequestConfig,\n} from \"axios\";\n\ndeclare const __AUTOMOCK_ENABLED__: boolean;\n\nexport type MockBundleData = {\n  enable: boolean;\n  data: unknown;\n  delay?: number;\n  status?: number;\n  isBinary?: boolean;\n};\n\nexport type MockInterceptorOptions = {\n  mockData: Record<string, MockBundleData>;\n  enabled?: boolean | (() => boolean);\n  onMockHit?: (url: string, method: string, mock: MockBundleData) => void;\n  onBypass?: (url: string, method: string, reason: string) => void;\n};\n\ntype MockEnabledState = boolean | undefined;\n\ndeclare global {\n  interface Window {\n    __MOCK_ENABLED__?: MockEnabledState;\n  }\n}\n\nclass MockInterceptor {\n  private options: MockInterceptorOptions;\n\n  constructor(options: MockInterceptorOptions) {\n    this.options = options;\n  }\n\n  /**\n   * Check if mock is enabled\n   */\n  isEnabled(): boolean {\n    // Check runtime flag first\n    if (window.__MOCK_ENABLED__ !== undefined) {\n      return window.__MOCK_ENABLED__;\n    }\n    // Check environment variable\n    if (typeof this.options.enabled === \"function\") {\n      return this.options.enabled();\n    }\n    return this.options.enabled ?? false;\n  }\n\n  /**\n   * Find matching mock data for the request\n   * Supports both formats:\n   * - \"GET /api/v1/asset/xxx\" (HTTP method + URL)\n   * - \"/api/v1/asset/xxx/get.js\" (File path format from automock plugin)\n   */\n  private findMock(url: string, method: string): MockBundleData | null {\n    const methodUpper = method.toUpperCase();\n    const methodLower = method.toLowerCase();\n\n    // Try HTTP method + URL format first (for compatibility)\n    const httpMethodKey = `${methodUpper} ${url}`;\n    if (this.options.mockData[httpMethodKey]) {\n      return this.options.mockData[httpMethodKey];\n    }\n\n    // Try file path format from automock plugin: /api/v1/asset/xxx/get.js\n    const filePathKey = `${url}/${methodLower}.js`;\n    if (this.options.mockData[filePathKey]) {\n      return this.options.mockData[filePathKey];\n    }\n\n    return null;\n  }\n\n  /**\n   * Determine if request should be mocked\n   */\n  shouldMock(url: string, method: string): boolean {\n    if (!this.isEnabled()) {\n      return false;\n    }\n\n    const mock = this.findMock(url, method);\n    return mock !== null && mock.enable;\n  }\n\n  /**\n   * Get mock data for request\n   */\n  getMock(url: string, method: string): MockBundleData | null {\n    if (!this.shouldMock(url, method)) {\n      return null;\n    }\n    return this.findMock(url, method);\n  }\n\n  /**\n   * Setup axios interceptor\n   */\n  setupAxios(axiosInstance: AxiosInstance): void {\n    axiosInstance.interceptors.request.use(\n      async (config: InternalAxiosRequestConfig) => {\n        const url = config.url || \"\";\n        const method = config.method?.toUpperCase() || \"GET\";\n\n        const mock = this.getMock(url, method);\n\n        if (mock) {\n          // Trigger mock hit callback\n          this.options.onMockHit?.(url, method, mock);\n\n          // Set adapter to return mock data\n          (config as InternalAxiosRequestConfig & { adapter: () => Promise<AxiosResponse> }).adapter = async () => {\n            const { data, delay = 0, status = 200 } = mock;\n\n            // Simulate delay\n            if (delay > 0) {\n              await new Promise((resolve) => setTimeout(resolve, delay));\n            }\n\n            return {\n              data,\n              status,\n              statusText: \"OK\",\n              headers: {},\n              config,\n            };\n          };\n        } else {\n          // Trigger bypass callback\n          const reason = !this.isEnabled()\n            ? \"Mock disabled globally\"\n            : \"No matching mock found or mock disabled\";\n          this.options.onBypass?.(url, method, reason);\n        }\n\n        return config;\n      },\n      (error: unknown) => Promise.reject(error),\n    );\n  }\n}\n\n/**\n * Create mock interceptor instance\n */\nexport function createMockInterceptor(\n  options: MockInterceptorOptions,\n): MockInterceptor {\n  return new MockInterceptor(options);\n}\n\n/**\n * Load mock data from bundled JSON file\n */\nexport async function loadMockData(): Promise<Record<string, MockBundleData>> {\n  try {\n    // In production, mock-data.json is generated by automock plugin\n    // Use absolute path to load it from dist directory\n    const response = await fetch(\"/mock-data.json\");\n    if (!response.ok) {\n      console.warn(\n        \"[MockInterceptor] Failed to load mock-data.json:\",\n        response.statusText,\n      );\n      return {};\n    }\n    const data = (await response.json()) as Record<string, MockBundleData>;\n    return data;\n  } catch (error) {\n    console.warn(\"[MockInterceptor] Failed to load mock-data.json:\", error);\n    return {};\n  }\n}\n\nasync function createInterceptorFromBundle(): Promise<MockInterceptor> {\n  const mockData = await loadMockData();\n  const isEnabled = typeof __AUTOMOCK_ENABLED__ !== \"undefined\" && __AUTOMOCK_ENABLED__;\n\n  return new MockInterceptor({\n    mockData,\n    enabled: isEnabled,\n    onMockHit: (url: string, method: string) => {\n      console.log(`[MOCK HIT] ${method} ${url}`);\n    },\n    onBypass: (url: string, method: string, reason: string) => {\n      console.log(`[MOCK BYPASS] ${method} ${url} - ${reason}`);\n    },\n  });\n}\n\nexport async function initMockInterceptor(\n  axiosInstance?: AxiosInstance,\n): Promise<void> {\n  if (!axiosInstance) {\n    throw new Error(\n      \"[MockInterceptor] axiosInstance is required. Please provide an axios instance.\",\n    );\n  }\n\n  const interceptor = await createInterceptorFromBundle();\n  interceptor.setupAxios(axiosInstance);\n}\n\nexport function setMockEnabled(enabled: boolean): void {\n  window.__MOCK_ENABLED__ = enabled;\n}\n\nexport function isMockEnabled(): boolean {\n  return !!window.__MOCK_ENABLED__;\n}\n\ntype HttpInstance = {\n  constructor: { axiosInstance: AxiosInstance };\n};\n\nlet httpInstanceRef: HttpInstance | undefined;\n\nexport function registerHttpInstance(http: HttpInstance): void {\n  httpInstanceRef = http;\n}\n\nexport async function initMockInterceptorForPureHttp(): Promise<void> {\n  if (!httpInstanceRef) {\n    throw new Error(\n      \"[MockInterceptor] http instance not registered. Call registerHttpInstance(http) first.\",\n    );\n  }\n\n  const interceptor = await createInterceptorFromBundle();\n  interceptor.setupAxios(httpInstanceRef.constructor.axiosInstance);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;AC+BA,IAAM,kBAAN,MAAsB;AAAA,EACZ;AAAA,EAER,YAAY,SAAiC;AAC3C,SAAK,UAAU;AAAA,EACjB;AAAA;AAAA;AAAA;AAAA,EAKA,YAAqB;AAEnB,QAAI,OAAO,qBAAqB,QAAW;AACzC,aAAO,OAAO;AAAA,IAChB;AAEA,QAAI,OAAO,KAAK,QAAQ,YAAY,YAAY;AAC9C,aAAO,KAAK,QAAQ,QAAQ;AAAA,IAC9B;AACA,WAAO,KAAK,QAAQ,WAAW;AAAA,EACjC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQQ,SAAS,KAAa,QAAuC;AACnE,UAAM,cAAc,OAAO,YAAY;AACvC,UAAM,cAAc,OAAO,YAAY;AAGvC,UAAM,gBAAgB,GAAG,WAAW,IAAI,GAAG;AAC3C,QAAI,KAAK,QAAQ,SAAS,aAAa,GAAG;AACxC,aAAO,KAAK,QAAQ,SAAS,aAAa;AAAA,IAC5C;AAGA,UAAM,cAAc,GAAG,GAAG,IAAI,WAAW;AACzC,QAAI,KAAK,QAAQ,SAAS,WAAW,GAAG;AACtC,aAAO,KAAK,QAAQ,SAAS,WAAW;AAAA,IAC1C;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,KAAa,QAAyB;AAC/C,QAAI,CAAC,KAAK,UAAU,GAAG;AACrB,aAAO;AAAA,IACT;AAEA,UAAM,OAAO,KAAK,SAAS,KAAK,MAAM;AACtC,WAAO,SAAS,QAAQ,KAAK;AAAA,EAC/B;AAAA;AAAA;AAAA;AAAA,EAKA,QAAQ,KAAa,QAAuC;AAC1D,QAAI,CAAC,KAAK,WAAW,KAAK,MAAM,GAAG;AACjC,aAAO;AAAA,IACT;AACA,WAAO,KAAK,SAAS,KAAK,MAAM;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,WAAW,eAAoC;AAC7C,kBAAc,aAAa,QAAQ;AAAA,MACjC,OAAO,WAAuC;AAC5C,cAAM,MAAM,OAAO,OAAO;AAC1B,cAAM,SAAS,OAAO,QAAQ,YAAY,KAAK;AAE/C,cAAM,OAAO,KAAK,QAAQ,KAAK,MAAM;AAErC,YAAI,MAAM;AAER,eAAK,QAAQ,YAAY,KAAK,QAAQ,IAAI;AAG1C,UAAC,OAAkF,UAAU,YAAY;AACvG,kBAAM,EAAE,MAAM,QAAQ,GAAG,SAAS,IAAI,IAAI;AAG1C,gBAAI,QAAQ,GAAG;AACb,oBAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,KAAK,CAAC;AAAA,YAC3D;AAEA,mBAAO;AAAA,cACL;AAAA,cACA;AAAA,cACA,YAAY;AAAA,cACZ,SAAS,CAAC;AAAA,cACV;AAAA,YACF;AAAA,UACF;AAAA,QACF,OAAO;AAEL,gBAAM,SAAS,CAAC,KAAK,UAAU,IAC3B,2BACA;AACJ,eAAK,QAAQ,WAAW,KAAK,QAAQ,MAAM;AAAA,QAC7C;AAEA,eAAO;AAAA,MACT;AAAA,MACA,CAAC,UAAmB,QAAQ,OAAO,KAAK;AAAA,IAC1C;AAAA,EACF;AACF;AAKO,SAAS,sBACd,SACiB;AACjB,SAAO,IAAI,gBAAgB,OAAO;AACpC;AAKA,eAAsB,eAAwD;AAC5E,MAAI;AAGF,UAAM,WAAW,MAAM,MAAM,iBAAiB;AAC9C,QAAI,CAAC,SAAS,IAAI;AAChB,cAAQ;AAAA,QACN;AAAA,QACA,SAAS;AAAA,MACX;AACA,aAAO,CAAC;AAAA,IACV;AACA,UAAM,OAAQ,MAAM,SAAS,KAAK;AAClC,WAAO;AAAA,EACT,SAAS,OAAO;AACd,YAAQ,KAAK,oDAAoD,KAAK;AACtE,WAAO,CAAC;AAAA,EACV;AACF;AAEA,eAAe,8BAAwD;AACrE,QAAM,WAAW,MAAM,aAAa;AACpC,QAAM,YAAY,OAAO,yBAAyB,eAAe;AAEjE,SAAO,IAAI,gBAAgB;AAAA,IACzB;AAAA,IACA,SAAS;AAAA,IACT,WAAW,CAAC,KAAa,WAAmB;AAC1C,cAAQ,IAAI,cAAc,MAAM,IAAI,GAAG,EAAE;AAAA,IAC3C;AAAA,IACA,UAAU,CAAC,KAAa,QAAgB,WAAmB;AACzD,cAAQ,IAAI,iBAAiB,MAAM,IAAI,GAAG,MAAM,MAAM,EAAE;AAAA,IAC1D;AAAA,EACF,CAAC;AACH;AAEA,eAAsB,oBACpB,eACe;AACf,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAAc,MAAM,4BAA4B;AACtD,cAAY,WAAW,aAAa;AACtC;AAEO,SAAS,eAAe,SAAwB;AACrD,SAAO,mBAAmB;AAC5B;AAEO,SAAS,gBAAyB;AACvC,SAAO,CAAC,CAAC,OAAO;AAClB;AAMA,IAAI;AAEG,SAAS,qBAAqB,MAA0B;AAC7D,oBAAkB;AACpB;AAEA,eAAsB,iCAAgD;AACpE,MAAI,CAAC,iBAAiB;AACpB,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AAEA,QAAM,cAAc,MAAM,4BAA4B;AACtD,cAAY,WAAW,gBAAgB,YAAY,aAAa;AAClE;","names":[]}
+{"version":3,"sources":["../../src/client/index.ts","../../src/client/interceptor.ts"],"sourcesContent":["export {\n  createMockInterceptor,\n  initMockInterceptor,\n  initMockInterceptorForPureHttp,\n  setMockEnabled,\n  isMockEnabled,\n  loadMockData,\n  registerHttpInstance\n} from './interceptor'\n\nexport type { MockInterceptorOptions, MockBundleData } from './interceptor'\n","import type {\n  AxiosInstance,\n  AxiosResponse,\n  InternalAxiosRequestConfig,\n} from \"axios\";\n\ndeclare const __AUTOMOCK_ENABLED__: boolean;\n\nexport type MockBundleData = {\n  enable: boolean;\n  data: unknown;\n  delay?: number;\n  status?: number;\n  isBinary?: boolean;\n};\n\nexport type MockInterceptorOptions = {\n  mockData: Record<string, MockBundleData>;\n  enabled?: boolean | (() => boolean);\n  onMockHit?: (url: string, method: string, mock: MockBundleData) => void;\n  onBypass?: (url: string, method: string, reason: string) => void;\n};\n\ntype MockEnabledState = boolean | undefined;\n\ndeclare global {\n  interface Window {\n    __MOCK_ENABLED__?: MockEnabledState;\n  }\n}\n\nclass MockInterceptor {\n  private options: MockInterceptorOptions;\n\n  constructor(options: MockInterceptorOptions) {\n    this.options = options;\n  }\n\n  private normalizeUrlPath(url: string, baseURL?: string): string {\n    if (!url) return \"\";\n\n    try {\n      const isAbsoluteUrl = /^[a-z][a-z\\d+\\-.]*:\\/\\//i.test(url);\n      const browserOrigin =\n        typeof window !== \"undefined\" && window.location?.origin\n          ? window.location.origin\n          : \"http://localhost\";\n\n      if (isAbsoluteUrl) {\n        return new URL(url).pathname;\n      }\n\n      if (baseURL) {\n        const normalizedBase = baseURL.endsWith(\"/\") ? baseURL : `${baseURL}/`;\n        const normalizedUrl = url.replace(/^\\/+/, \"\");\n        return new URL(normalizedUrl, normalizedBase).pathname;\n      }\n\n      return new URL(url, browserOrigin).pathname;\n    } catch {\n      return url.split(/[?#]/)[0] || \"\";\n    }\n  }\n\n  /**\n   * Check if mock is enabled\n   */\n  isEnabled(): boolean {\n    // Check runtime flag first\n    if (window.__MOCK_ENABLED__ !== undefined) {\n      return window.__MOCK_ENABLED__;\n    }\n    // Check environment variable\n    if (typeof this.options.enabled === \"function\") {\n      return this.options.enabled();\n    }\n    return this.options.enabled ?? false;\n  }\n\n  /**\n   * Find matching mock data for the request\n   * Supports both formats:\n   * - \"GET /api/v1/asset/xxx\" (HTTP method + URL)\n   * - \"/api/v1/asset/xxx/get.js\" (File path format from automock plugin)\n   */\n  private findMock(url: string, method: string, baseURL?: string): MockBundleData | null {\n    const methodUpper = method.toUpperCase();\n    const methodLower = method.toLowerCase();\n    const normalizedPath = this.normalizeUrlPath(url, baseURL);\n\n    // Try HTTP method + URL format first (for compatibility)\n    const httpMethodKey = `${methodUpper} ${url}`;\n    if (this.options.mockData[httpMethodKey]) {\n      return this.options.mockData[httpMethodKey];\n    }\n\n    const normalizedHttpMethodKey = `${methodUpper} ${normalizedPath}`;\n    if (this.options.mockData[normalizedHttpMethodKey]) {\n      return this.options.mockData[normalizedHttpMethodKey];\n    }\n\n    // Try file path format from automock plugin: /api/v1/asset/xxx/get.js\n    const filePathKey = `${normalizedPath}/${methodLower}.js`;\n    if (this.options.mockData[filePathKey]) {\n      return this.options.mockData[filePathKey];\n    }\n\n    return null;\n  }\n\n  /**\n   * Determine if request should be mocked\n   */\n  shouldMock(url: string, method: string, baseURL?: string): boolean {\n    if (!this.isEnabled()) {\n      return false;\n    }\n\n    const mock = this.findMock(url, method, baseURL);\n    return mock !== null && mock.enable;\n  }\n\n  /**\n   * Get mock data for request\n   */\n  getMock(url: string, method: string, baseURL?: string): MockBundleData | null {\n    if (!this.shouldMock(url, method, baseURL)) {\n      return null;\n    }\n    return this.findMock(url, method, baseURL);\n  }\n\n  /**\n   * Setup axios interceptor\n   */\n  setupAxios(axiosInstance: AxiosInstance): void {\n    axiosInstance.interceptors.request.use(\n      async (config: InternalAxiosRequestConfig) => {\n        const url = config.url || \"\";\n        const method = config.method?.toUpperCase() || \"GET\";\n        const normalizedUrl = this.normalizeUrlPath(url, config.baseURL);\n\n        const mock = this.getMock(url, method, config.baseURL);\n\n        if (mock) {\n          // Trigger mock hit callback\n          this.options.onMockHit?.(normalizedUrl, method, mock);\n\n          // Set adapter to return mock data\n          (config as InternalAxiosRequestConfig & { adapter: () => Promise<AxiosResponse> }).adapter = async () => {\n            const { data, delay = 0, status = 200 } = mock;\n\n            // Simulate delay\n            if (delay > 0) {\n              await new Promise((resolve) => setTimeout(resolve, delay));\n            }\n\n            return {\n              data,\n              status,\n              statusText: \"OK\",\n              headers: {},\n              config,\n            };\n          };\n        } else {\n          // Trigger bypass callback\n          const reason = !this.isEnabled()\n            ? \"Mock disabled globally\"\n            : \"No matching mock found or mock disabled\";\n          this.options.onBypass?.(normalizedUrl, method, reason);\n        }\n\n        return config;\n      },\n      (error: unknown) => Promise.reject(error),\n    );\n  }\n}\n\n/**\n * Create mock interceptor instance\n */\nexport function createMockInterceptor(\n  options: MockInterceptorOptions,\n): MockInterceptor {\n  return new MockInterceptor(options);\n}\n\n/**\n * Load mock data from bundled JSON file\n */\nexport async function loadMockData(): Promise<Record<string, MockBundleData>> {\n  try {\n    // In production, mock-data.json is generated by automock plugin\n    // Use absolute path to load it from dist directory\n    const response = await fetch(\"/mock-data.json\");\n    if (!response.ok) {\n      console.warn(\n        \"[MockInterceptor] Failed to load mock-data.json:\",\n        response.statusText,\n      );\n      return {};\n    }\n    const data = (await response.json()) as Record<string, MockBundleData>;\n    return data;\n  } catch (error) {\n    console.warn(\"[MockInterceptor] Failed to load mock-data.json:\", error);\n    return {};\n  }\n}\n\nasync function createInterceptorFromBundle(): Promise<MockInterceptor> {\n  const mockData = await loadMockData();\n  const isEnabled = typeof __AUTOMOCK_ENABLED__ !== \"undefined\" && __AUTOMOCK_ENABLED__;\n\n  return new MockInterceptor({\n    mockData,\n    enabled: isEnabled,\n    onMockHit: (url: string, method: string) => {\n      console.log(`[MOCK HIT] ${method} ${url}`);\n    },\n    onBypass: (url: string, method: string, reason: string) => {\n      console.log(`[MOCK BYPASS] ${method} ${url} - ${reason}`);\n    },\n  });\n}\n\nexport async function initMockInterceptor(\n  axiosInstance?: AxiosInstance,\n): Promise<void> {\n  if (!axiosInstance) {\n    throw new Error(\n      \"[MockInterceptor] axiosInstance is required. Please provide an axios instance.\",\n    );\n  }\n\n  const interceptor = await createInterceptorFromBundle();\n  interceptor.setupAxios(axiosInstance);\n}\n\nexport function setMockEnabled(enabled: boolean): void {\n  window.__MOCK_ENABLED__ = enabled;\n}\n\nexport function isMockEnabled(): boolean {\n  return !!window.__MOCK_ENABLED__;\n}\n\ntype HttpInstance = {\n  constructor: { axiosInstance: AxiosInstance };\n};\n\nlet httpInstanceRef: HttpInstance | undefined;\n\nexport function registerHttpInstance(http: HttpInstance): void {\n  httpInstanceRef = http;\n}\n\nexport async function initMockInterceptorForPureHttp(): Promise<void> {\n  if (!httpInstanceRef) {\n    throw new Error(\n      \"[MockInterceptor] http instance not registered. Call registerHttpInstance(http) first.\",\n    );\n  }\n\n  const interceptor = await createInterceptorFromBundle();\n  interceptor.setupAxios(httpInstanceRef.constructor.axiosInstance);\n}\n"],"mappings":"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","names":[]}

package/dist/client/index.mjs

@@ -6,7 +6,7 @@ import {
   loadMockData,
   registerHttpInstance,
   setMockEnabled
-} from "../chunk-DJWYFFPU.mjs";
+} from "../chunk-2KRAWI7J.mjs";
 export {
   createMockInterceptor,
   initMockInterceptor,

package/dist/index.d.mts

@@ -7,17 +7,22 @@ interface InspectorOptions {
     enableToggle?: boolean;
 }
 interface AutomockPluginOptions {
+    /** Directory for mock files, default "mock". */
     mockDir?: string;
+    /** API path prefix handled by automock, default "/api". */
     apiPrefix?: string;
+    /** Rewrite request path before proxying to proxyBaseUrl. */
     pathRewrite?: (path: string) => string;
+    /** Real backend base URL. Required only when automock proxy/capture is used. */
     proxyBaseUrl?: string;
     inspector?: boolean | InspectorOptions;
+    /** Client-side production mock switch. Default false; "auto" enables outside production mode. */
     productionMock?: boolean | 'auto';
-    /** Global switch, default true. When false, middleware passes through all requests. */
+    /** Global switch, default true. When false, middleware passes through all requests without proxy/capture. */
     enabled?: boolean;
     /** Whether to proxy unmatched requests to proxyBaseUrl, default true. */
     proxy?: boolean;
-    /** Whether to capture and save new mock files from proxy responses, default true. */
+    /** Whether to capture and save JSON proxy responses as mock files, default true. */
     capture?: boolean;
 }
 

package/dist/index.d.ts

@@ -7,17 +7,22 @@ interface InspectorOptions {
     enableToggle?: boolean;
 }
 interface AutomockPluginOptions {
+    /** Directory for mock files, default "mock". */
     mockDir?: string;
+    /** API path prefix handled by automock, default "/api". */
     apiPrefix?: string;
+    /** Rewrite request path before proxying to proxyBaseUrl. */
     pathRewrite?: (path: string) => string;
+    /** Real backend base URL. Required only when automock proxy/capture is used. */
     proxyBaseUrl?: string;
     inspector?: boolean | InspectorOptions;
+    /** Client-side production mock switch. Default false; "auto" enables outside production mode. */
     productionMock?: boolean | 'auto';
-    /** Global switch, default true. When false, middleware passes through all requests. */
+    /** Global switch, default true. When false, middleware passes through all requests without proxy/capture. */
     enabled?: boolean;
     /** Whether to proxy unmatched requests to proxyBaseUrl, default true. */
     proxy?: boolean;
-    /** Whether to capture and save new mock files from proxy responses, default true. */
+    /** Whether to capture and save JSON proxy responses as mock files, default true. */
     capture?: boolean;
 }