@scalar/mock-server 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @scalar/mock-server
 
+## 0.7.0
+
+### Minor Changes
+
+- [#7247](https://github.com/scalar/scalar/pull/7247) [`a4f862c`](https://github.com/scalar/scalar/commit/a4f862c73ee509579c96ab86c703e8af74d8efcf) Thanks [@hanspagel](https://github.com/hanspagel)! - feat: use `document`, not `specification` for the configuration
+
+### Patch Changes
+
+- [#7247](https://github.com/scalar/scalar/pull/7247) [`a4f862c`](https://github.com/scalar/scalar/commit/a4f862c73ee509579c96ab86c703e8af74d8efcf) Thanks [@hanspagel](https://github.com/hanspagel)! - fix: fails on 204 No Content responses
+
+- Updated dependencies [[`fddf294`](https://github.com/scalar/scalar/commit/fddf294b00dd8c9eb5c713c338f2ec6e3f62523d), [`c1ecd0c`](https://github.com/scalar/scalar/commit/c1ecd0c6096f3fbe2e3d8ad3794ea718bb6bce66), [`c1ecd0c`](https://github.com/scalar/scalar/commit/c1ecd0c6096f3fbe2e3d8ad3794ea718bb6bce66), [`2377b76`](https://github.com/scalar/scalar/commit/2377b76d050f8de70037b17a32d0dd1181d3311d)]:
+  - @scalar/helpers@0.1.0
+  - @scalar/openapi-parser@0.23.1
+  - @scalar/oas-utils@0.6.2
+
 ## 0.6.1
 
 ### Patch Changes

package/README.md

@@ -1,187 +1,21 @@
 # Scalar Mock Server
 
-[![Version](https://img.shields.io/npm/v/%40scalar/mock-server)](https://www.npmjs.com/package/@scalar/mock-server)
-[![Downloads](https://img.shields.io/npm/dm/%40scalar/mock-server)](https://www.npmjs.com/package/@scalar/mock-server)
-[![License](https://img.shields.io/npm/l/%40scalar%2Fmock-server)](https://www.npmjs.com/package/@scalar/mock-server)
+[![Version](https://img.shields.io/npm/v/@scalar/mock-server)](https://www.npmjs.com/package/@scalar/mock-server)
+[![Downloads](https://img.shields.io/npm/dm/@scalar/mock-server)](https://www.npmjs.com/package/@scalar/mock-server)
+[![License](https://img.shields.io/npm/l/@scalar/mock-server)](https://www.npmjs.com/package/@scalar/mock-server)
 [![Discord](https://img.shields.io/discord/1135330207960678410?style=flat&color=5865F2)](https://discord.gg/scalar)
 
 A powerful Node.js mock server that automatically generates realistic API responses from your OpenAPI/Swagger documents. It creates fully-functional endpoints with mock data, handles authentication, and respects content types - making it perfect for frontend development, API prototyping, and integration testing.
 
-![](https://raw.githubusercontent.com/scalar/scalar/main/packages/cli/screenshots/mock.png)
-
-## Features
-
-- Perfect for frontend development and testing
-- Creates endpoints automatically from OpenAPI documents
-- Generates realistic mock data based on your schemas
-- Handles authentication and responds with defined HTTP headers
-- Supports Swagger 2.0 and OpenAPI 3.x documents
-- Customizable response handling
-
-## Quickstart
-
-The easiest way to get started is through [our Scalar CLI](https://www.npmjs.com/package/@scalar/cli).
-You can have a mock server up and running in seconds:
+## Usage
 
 ```bash
 npx @scalar/cli document mock openapi.json --watch
 ```
 
-## Installation
-
-For advanced use cases, you can integrate the mock server directly into your Node.js application for full control:
-
-```bash
-npm install @scalar/mock-server
-```
-
-## Usage
-
-```ts
-import { serve } from '@hono/node-server'
-import { createMockServer } from '@scalar/mock-server'
-
-// Your OpenAPI document
-const specification = {
-  openapi: '3.1.1',
-  info: {
-    title: 'Hello World',
-    version: '1.0.0',
-  },
-  paths: {
-    '/foobar': {
-      get: {
-        responses: {
-          '200': {
-            description: 'OK',
-            content: {
-              'application/json': {
-                example: {
-                  foo: 'bar',
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-  },
-}
-
-// Create the mocked routes
-const app = await createMockServer({
-  specification,
-  // Custom logging
-  onRequest({ context, operation }) {
-    console.log(context.req.method, context.req.path)
-  },
-})
-
-// Start the server
-serve(
-  {
-    fetch: app.fetch,
-    port: 3000,
-  },
-  (info) => {
-    console.log(`Listening on http://localhost:${info.port}`)
-  },
-)
-```
-
-### Authentication
-
-You can define security schemes in your OpenAPI document and the mock server will validate the authentication:
-
-```ts
-import { serve } from '@hono/node-server'
-import { createMockServer } from '@scalar/mock-server'
-
-// Your OpenAPI document
-const specification = {
-  openapi: '3.1.1',
-  info: {
-    title: 'Hello World',
-    version: '1.0.0',
-  },
-  paths: {
-    '/secret': {
-      get: {
-        security: [
-          {
-            bearerAuth: [],
-          },
-          {
-            apiKey: [],
-          },
-        ],
-        responses: {
-          '200': {
-            description: 'OK',
-            content: {
-              'application/json': {
-                example: {
-                  foo: 'bar',
-                },
-              },
-            },
-          },
-          '401': {
-            description: 'Unauthorized',
-            content: {
-              'application/json': {
-                example: {
-                  error: 'Unauthorized',
-                },
-              },
-            },
-          },
-        },
-      },
-    },
-  },
-  components: {
-    securitySchemes: {
-      bearerAuth: {
-        type: 'http',
-        scheme: 'bearer',
-        bearerFormat: 'JWT',
-      },
-      apiKey: {
-        type: 'apiKey',
-        in: 'header',
-        name: 'X-API-Key',
-      },
-    },
-  },
-}
-
-// Create the mocked routes
-const app = await createMockServer({
-  specification,
-  // Custom logging
-  onRequest({ context, operation }) {
-    console.log(context.req.method, context.req.path)
-  },
-})
-
-// Start the server
-serve(
-  {
-    fetch: app.fetch,
-    port: 3000,
-  },
-  (info) => {
-    console.log(`Listening on http://localhost:${info.port}`)
-  },
-)
-```
-
-### OpenAPI endpoints
-
-The given OpenAPI document is automatically exposed:
+## Documentation
 
-- `/openapi.json` and `/openapi.yaml`
+[Read the documentation here](https://guides.scalar.com/scalar/scalar-mock-server/getting-started)
 
 ## Community
 

package/dist/create-mock-server.d.ts

@@ -0,0 +1,7 @@
+import { Hono } from 'hono';
+import type { MockServerOptions } from './types.js';
+/**
+ * Create a mock server instance
+ */
+export declare function createMockServer(configuration: MockServerOptions): Promise<Hono>;
+//# sourceMappingURL=create-mock-server.d.ts.map

package/dist/create-mock-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mock-server.d.ts","sourceRoot":"","sources":["../src/create-mock-server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAG3B,OAAO,KAAK,EAAc,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAW5D;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDhF"}

package/dist/create-mock-server.js

@@ -0,0 +1,45 @@
+import { dereference } from "@scalar/openapi-parser";
+import { Hono } from "hono";
+import { cors } from "hono/cors";
+import { getOperations } from "./utils/get-operation.js";
+import { handleAuthentication } from "./utils/handle-authentication.js";
+import { honoRouteFromPath } from "./utils/hono-route-from-path.js";
+import { isAuthenticationRequired } from "./utils/is-authentication-required.js";
+import { logAuthenticationInstructions } from "./utils/log-authentication-instructions.js";
+import { setUpAuthenticationRoutes } from "./utils/set-up-authentication-routes.js";
+import { mockAnyResponse } from "./routes/mock-any-response.js";
+import { respondWithOpenApiDocument } from "./routes/respond-with-openapi-document.js";
+function createMockServer(configuration) {
+  const app = new Hono();
+  const { schema } = dereference(configuration?.document ?? configuration?.specification ?? {});
+  app.use(cors());
+  setUpAuthenticationRoutes(app, schema);
+  logAuthenticationInstructions(
+    schema?.components?.securitySchemes || {}
+  );
+  const paths = schema?.paths ?? {};
+  Object.keys(paths).forEach((path) => {
+    const methods = Object.keys(getOperations(paths[path]));
+    methods.forEach((method) => {
+      const route = honoRouteFromPath(path);
+      const operation = schema?.paths?.[path]?.[method];
+      if (isAuthenticationRequired(operation.security)) {
+        app[method](route, handleAuthentication(schema, operation));
+      }
+      app[method](route, (c) => mockAnyResponse(c, operation, configuration));
+    });
+  });
+  app.get(
+    "/openapi.json",
+    (c) => respondWithOpenApiDocument(c, configuration?.document ?? configuration?.specification, "json")
+  );
+  app.get(
+    "/openapi.yaml",
+    (c) => respondWithOpenApiDocument(c, configuration?.document ?? configuration?.specification, "yaml")
+  );
+  return Promise.resolve(app);
+}
+export {
+  createMockServer
+};
+//# sourceMappingURL=create-mock-server.js.map

package/dist/create-mock-server.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/create-mock-server.ts"],
+  "sourcesContent": ["import { dereference } from '@scalar/openapi-parser'\nimport type { OpenAPI, OpenAPIV3_1 } from '@scalar/openapi-types'\nimport { Hono } from 'hono'\nimport { cors } from 'hono/cors'\n\nimport type { HttpMethod, MockServerOptions } from '@/types'\nimport { getOperations } from '@/utils/get-operation'\nimport { handleAuthentication } from '@/utils/handle-authentication'\nimport { honoRouteFromPath } from '@/utils/hono-route-from-path'\nimport { isAuthenticationRequired } from '@/utils/is-authentication-required'\nimport { logAuthenticationInstructions } from '@/utils/log-authentication-instructions'\nimport { setUpAuthenticationRoutes } from '@/utils/set-up-authentication-routes'\n\nimport { mockAnyResponse } from './routes/mock-any-response'\nimport { respondWithOpenApiDocument } from './routes/respond-with-openapi-document'\n\n/**\n * Create a mock server instance\n */\nexport function createMockServer(configuration: MockServerOptions): Promise<Hono> {\n  const app = new Hono()\n\n  /** Dereferenced OpenAPI document */\n  const { schema } = dereference(configuration?.document ?? configuration?.specification ?? {})\n\n  // CORS headers\n  app.use(cors())\n\n  /** Authentication methods defined in the OpenAPI document */\n  setUpAuthenticationRoutes(app, schema)\n\n  logAuthenticationInstructions(\n    schema?.components?.securitySchemes || ({} as Record<string, OpenAPIV3_1.SecuritySchemeObject>),\n  )\n\n  /** Paths specified in the OpenAPI document */\n  const paths = schema?.paths ?? {}\n\n  Object.keys(paths).forEach((path) => {\n    const methods = Object.keys(getOperations(paths[path])) as HttpMethod[]\n\n    /** Keys for all operations of a specified path */\n    methods.forEach((method) => {\n      const route = honoRouteFromPath(path)\n      const operation = schema?.paths?.[path]?.[method] as OpenAPI.Operation\n\n      // Check if authentication is required for this operation\n      if (isAuthenticationRequired(operation.security)) {\n        app[method](route, handleAuthentication(schema, operation))\n      }\n\n      // Actual route\n      app[method](route, (c) => mockAnyResponse(c, operation, configuration))\n    })\n  })\n\n  // OpenAPI JSON file\n  app.get('/openapi.json', (c) =>\n    respondWithOpenApiDocument(c, configuration?.document ?? configuration?.specification, 'json'),\n  )\n\n  // OpenAPI YAML file\n  app.get('/openapi.yaml', (c) =>\n    respondWithOpenApiDocument(c, configuration?.document ?? configuration?.specification, 'yaml'),\n  )\n\n  /**\n   * No async code, but returning a Promise to allow future async logic to be implemented\n   * @see https://github.com/scalar/scalar/pull/7174#discussion_r2470046281\n   */\n  return Promise.resolve(app)\n}\n"],
+  "mappings": "AAAA,SAAS,mBAAmB;AAE5B,SAAS,YAAY;AACrB,SAAS,YAAY;AAGrB,SAAS,qBAAqB;AAC9B,SAAS,4BAA4B;AACrC,SAAS,yBAAyB;AAClC,SAAS,gCAAgC;AACzC,SAAS,qCAAqC;AAC9C,SAAS,iCAAiC;AAE1C,SAAS,uBAAuB;AAChC,SAAS,kCAAkC;AAKpC,SAAS,iBAAiB,eAAiD;AAChF,QAAM,MAAM,IAAI,KAAK;AAGrB,QAAM,EAAE,OAAO,IAAI,YAAY,eAAe,YAAY,eAAe,iBAAiB,CAAC,CAAC;AAG5F,MAAI,IAAI,KAAK,CAAC;AAGd,4BAA0B,KAAK,MAAM;AAErC;AAAA,IACE,QAAQ,YAAY,mBAAoB,CAAC;AAAA,EAC3C;AAGA,QAAM,QAAQ,QAAQ,SAAS,CAAC;AAEhC,SAAO,KAAK,KAAK,EAAE,QAAQ,CAAC,SAAS;AACnC,UAAM,UAAU,OAAO,KAAK,cAAc,MAAM,IAAI,CAAC,CAAC;AAGtD,YAAQ,QAAQ,CAAC,WAAW;AAC1B,YAAM,QAAQ,kBAAkB,IAAI;AACpC,YAAM,YAAY,QAAQ,QAAQ,IAAI,IAAI,MAAM;AAGhD,UAAI,yBAAyB,UAAU,QAAQ,GAAG;AAChD,YAAI,MAAM,EAAE,OAAO,qBAAqB,QAAQ,SAAS,CAAC;AAAA,MAC5D;AAGA,UAAI,MAAM,EAAE,OAAO,CAAC,MAAM,gBAAgB,GAAG,WAAW,aAAa,CAAC;AAAA,IACxE,CAAC;AAAA,EACH,CAAC;AAGD,MAAI;AAAA,IAAI;AAAA,IAAiB,CAAC,MACxB,2BAA2B,GAAG,eAAe,YAAY,eAAe,eAAe,MAAM;AAAA,EAC/F;AAGA,MAAI;AAAA,IAAI;AAAA,IAAiB,CAAC,MACxB,2BAA2B,GAAG,eAAe,YAAY,eAAe,eAAe,MAAM;AAAA,EAC/F;AAMA,SAAO,QAAQ,QAAQ,GAAG;AAC5B;",
+  "names": []
+}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { createMockServer } from './createMockServer.js';
+export { createMockServer } from './create-mock-server.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -1,4 +1,4 @@
-import { createMockServer } from "./createMockServer.js";
+import { createMockServer } from "./create-mock-server.js";
 export {
   createMockServer
 };

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["export { createMockServer } from './createMockServer'\n"],
+  "sourcesContent": ["export { createMockServer } from './create-mock-server'\n"],
   "mappings": "AAAA,SAAS,wBAAwB;",
   "names": []
 }

package/dist/routes/{mockAnyResponse.d.ts → mock-any-response.d.ts}

@@ -1,10 +1,11 @@
 import type { OpenAPI } from '@scalar/openapi-types';
 import type { Context } from 'hono';
+import type { StatusCode } from 'hono/utils/http-status';
 import type { MockServerOptions } from '../types.js';
 /**
  * Mock any response
  */
 export declare function mockAnyResponse(c: Context, operation: OpenAPI.Operation, options: MockServerOptions): (Response & import("hono").TypedResponse<{
     error: string;
-}, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<any, import("hono/utils/http-status").ContentfulStatusCode, "body">);
-//# sourceMappingURL=mockAnyResponse.d.ts.map
+}, import("hono/utils/http-status").ContentfulStatusCode, "json">) | (Response & import("hono").TypedResponse<null, StatusCode, "body">) | (Response & import("hono").TypedResponse<any, import("hono/utils/http-status").ContentfulStatusCode, "body">);
+//# sourceMappingURL=mock-any-response.d.ts.map

package/dist/routes/mock-any-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-any-response.d.ts","sourceRoot":"","sources":["../../src/routes/mock-any-response.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AAExD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAGhD;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,EAAE,iBAAiB;;yPAqFnG"}

package/dist/routes/{mockAnyResponse.js → mock-any-response.js}

@@ -1,7 +1,7 @@
+import { json2xml } from "@scalar/helpers/file/json2xml";
 import { getExampleFromSchema } from "@scalar/oas-utils/spec-getters";
 import { accepts } from "hono/accepts";
-import { findPreferredResponseKey } from "../utils/findPreferredResponseKey.js";
-import { json2xml } from "@scalar/helpers/file/json2xml";
+import { findPreferredResponseKey } from "../utils/find-preferred-response-key.js";
 function mockAnyResponse(c, operation, options) {
   if (options?.onRequest) {
     options.onRequest({
@@ -15,7 +15,10 @@ function mockAnyResponse(c, operation, options) {
     c.status(500);
     return c.json({ error: "No response defined for this operation." });
   }
-  const supportedContentTypes = Object.keys(preferredResponse?.content ?? {});
+  const statusCode = Number.parseInt(
+    preferredResponseKey === "default" ? "200" : preferredResponseKey ?? "200",
+    10
+  );
   const headers = preferredResponse?.headers ?? {};
   Object.keys(headers).forEach((header) => {
     const value = headers[header].schema ? getExampleFromSchema(headers[header].schema) : null;
@@ -23,6 +26,15 @@ function mockAnyResponse(c, operation, options) {
       c.header(header, value);
     }
   });
+  if (statusCode === 204) {
+    c.status(statusCode);
+    return c.body(null);
+  }
+  const supportedContentTypes = Object.keys(preferredResponse?.content ?? {});
+  if (supportedContentTypes.length === 0) {
+    c.status(statusCode);
+    return c.body(null);
+  }
   const acceptedContentType = accepts(c, {
     header: "Accept",
     supports: supportedContentTypes,
@@ -35,10 +47,6 @@ function mockAnyResponse(c, operation, options) {
     variables: c.req.param(),
     mode: "read"
   }) : null;
-  const statusCode = Number.parseInt(
-    preferredResponseKey === "default" ? "200" : preferredResponseKey ?? "200",
-    10
-  );
   c.status(statusCode);
   return c.body(
     typeof body === "object" ? (
@@ -56,4 +64,4 @@ function mockAnyResponse(c, operation, options) {
 export {
   mockAnyResponse
 };
-//# sourceMappingURL=mockAnyResponse.js.map
+//# sourceMappingURL=mock-any-response.js.map

package/dist/routes/mock-any-response.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/routes/mock-any-response.ts"],
+  "sourcesContent": ["import { json2xml } from '@scalar/helpers/file/json2xml'\nimport { getExampleFromSchema } from '@scalar/oas-utils/spec-getters'\nimport type { OpenAPI } from '@scalar/openapi-types'\nimport type { Context } from 'hono'\nimport { accepts } from 'hono/accepts'\nimport type { StatusCode } from 'hono/utils/http-status'\n\nimport type { MockServerOptions } from '@/types'\nimport { findPreferredResponseKey } from '@/utils/find-preferred-response-key'\n\n/**\n * Mock any response\n */\nexport function mockAnyResponse(c: Context, operation: OpenAPI.Operation, options: MockServerOptions) {\n  // Call onRequest callback\n  if (options?.onRequest) {\n    options.onRequest({\n      context: c,\n      operation,\n    })\n  }\n\n  // Response\n  // default, 200, 201 \u2026\n  const preferredResponseKey = findPreferredResponseKey(Object.keys(operation.responses ?? {}))\n  const preferredResponse = preferredResponseKey ? operation.responses?.[preferredResponseKey] : null\n\n  if (!preferredResponse) {\n    c.status(500)\n\n    return c.json({ error: 'No response defined for this operation.' })\n  }\n\n  // Status code\n  const statusCode = Number.parseInt(\n    preferredResponseKey === 'default' ? '200' : (preferredResponseKey ?? '200'),\n    10,\n  ) as StatusCode\n\n  // Headers\n  const headers = preferredResponse?.headers ?? {}\n  Object.keys(headers).forEach((header) => {\n    const value = headers[header].schema ? getExampleFromSchema(headers[header].schema) : null\n    if (value !== null) {\n      c.header(header, value)\n    }\n  })\n\n  // For 204 No Content responses, we should not set Content-Type and should return null body\n  if (statusCode === 204) {\n    c.status(statusCode)\n    return c.body(null)\n  }\n\n  const supportedContentTypes = Object.keys(preferredResponse?.content ?? {})\n\n  // If no content types are defined, return the status with no body\n  if (supportedContentTypes.length === 0) {\n    c.status(statusCode)\n    return c.body(null)\n  }\n\n  // Content-Type\n  const acceptedContentType = accepts(c, {\n    header: 'Accept',\n    supports: supportedContentTypes,\n    default: supportedContentTypes.includes('application/json')\n      ? 'application/json'\n      : (supportedContentTypes[0] ?? 'text/plain;charset=UTF-8'),\n  })\n\n  c.header('Content-Type', acceptedContentType)\n\n  const acceptedResponse = preferredResponse?.content?.[acceptedContentType]\n\n  // Body\n  const body = acceptedResponse?.example\n    ? acceptedResponse.example\n    : acceptedResponse?.schema\n      ? getExampleFromSchema(acceptedResponse.schema, {\n          emptyString: 'string',\n          variables: c.req.param(),\n          mode: 'read',\n        })\n      : null\n\n  c.status(statusCode)\n\n  return c.body(\n    typeof body === 'object'\n      ? // XML\n        acceptedContentType?.includes('xml')\n        ? json2xml(body)\n        : // JSON\n          JSON.stringify(body, null, 2)\n      : // String\n        body,\n  )\n}\n"],
+  "mappings": "AAAA,SAAS,gBAAgB;AACzB,SAAS,4BAA4B;AAGrC,SAAS,eAAe;AAIxB,SAAS,gCAAgC;AAKlC,SAAS,gBAAgB,GAAY,WAA8B,SAA4B;AAEpG,MAAI,SAAS,WAAW;AACtB,YAAQ,UAAU;AAAA,MAChB,SAAS;AAAA,MACT;AAAA,IACF,CAAC;AAAA,EACH;AAIA,QAAM,uBAAuB,yBAAyB,OAAO,KAAK,UAAU,aAAa,CAAC,CAAC,CAAC;AAC5F,QAAM,oBAAoB,uBAAuB,UAAU,YAAY,oBAAoB,IAAI;AAE/F,MAAI,CAAC,mBAAmB;AACtB,MAAE,OAAO,GAAG;AAEZ,WAAO,EAAE,KAAK,EAAE,OAAO,0CAA0C,CAAC;AAAA,EACpE;AAGA,QAAM,aAAa,OAAO;AAAA,IACxB,yBAAyB,YAAY,QAAS,wBAAwB;AAAA,IACtE;AAAA,EACF;AAGA,QAAM,UAAU,mBAAmB,WAAW,CAAC;AAC/C,SAAO,KAAK,OAAO,EAAE,QAAQ,CAAC,WAAW;AACvC,UAAM,QAAQ,QAAQ,MAAM,EAAE,SAAS,qBAAqB,QAAQ,MAAM,EAAE,MAAM,IAAI;AACtF,QAAI,UAAU,MAAM;AAClB,QAAE,OAAO,QAAQ,KAAK;AAAA,IACxB;AAAA,EACF,CAAC;AAGD,MAAI,eAAe,KAAK;AACtB,MAAE,OAAO,UAAU;AACnB,WAAO,EAAE,KAAK,IAAI;AAAA,EACpB;AAEA,QAAM,wBAAwB,OAAO,KAAK,mBAAmB,WAAW,CAAC,CAAC;AAG1E,MAAI,sBAAsB,WAAW,GAAG;AACtC,MAAE,OAAO,UAAU;AACnB,WAAO,EAAE,KAAK,IAAI;AAAA,EACpB;AAGA,QAAM,sBAAsB,QAAQ,GAAG;AAAA,IACrC,QAAQ;AAAA,IACR,UAAU;AAAA,IACV,SAAS,sBAAsB,SAAS,kBAAkB,IACtD,qBACC,sBAAsB,CAAC,KAAK;AAAA,EACnC,CAAC;AAED,IAAE,OAAO,gBAAgB,mBAAmB;AAE5C,QAAM,mBAAmB,mBAAmB,UAAU,mBAAmB;AAGzE,QAAM,OAAO,kBAAkB,UAC3B,iBAAiB,UACjB,kBAAkB,SAChB,qBAAqB,iBAAiB,QAAQ;AAAA,IAC5C,aAAa;AAAA,IACb,WAAW,EAAE,IAAI,MAAM;AAAA,IACvB,MAAM;AAAA,EACR,CAAC,IACD;AAEN,IAAE,OAAO,UAAU;AAEnB,SAAO,EAAE;AAAA,IACP,OAAO,SAAS;AAAA;AAAA,MAEZ,qBAAqB,SAAS,KAAK,IACjC,SAAS,IAAI;AAAA;AAAA,QAEb,KAAK,UAAU,MAAM,MAAM,CAAC;AAAA;AAAA;AAAA;AAAA,MAE9B;AAAA;AAAA,EACN;AACF;",
+  "names": []
+}

package/dist/routes/{respondWithAuthorizePage.d.ts → respond-with-authorize-page.d.ts}

@@ -3,4 +3,4 @@ import type { Context } from 'hono';
  * Responds with an HTML page that simulates an OAuth 2.0 authorization page.
  */
 export declare function respondWithAuthorizePage(c: Context, title?: string): Response;
-//# sourceMappingURL=respondWithAuthorizePage.d.ts.map
+//# sourceMappingURL=respond-with-authorize-page.d.ts.map

package/dist/routes/respond-with-authorize-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond-with-authorize-page.d.ts","sourceRoot":"","sources":["../../src/routes/respond-with-authorize-page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAKnC;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,SAAK,YA2C9D"}

package/dist/routes/{respondWithAuthorizePage.js → respond-with-authorize-page.js}

@@ -116,4 +116,4 @@ function generateErrorHtml(title, message) {
 export {
   respondWithAuthorizePage
 };
-//# sourceMappingURL=respondWithAuthorizePage.js.map
+//# sourceMappingURL=respond-with-authorize-page.js.map

package/dist/routes/{respondWithAuthorizePage.js.map → respond-with-authorize-page.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/routes/respondWithAuthorizePage.ts"],
+  "sources": ["../../src/routes/respond-with-authorize-page.ts"],
   "sourcesContent": ["import type { Context } from 'hono'\n\n/** Always responds with this code */\nconst EXAMPLE_AUTHORIZATION_CODE = 'super-secret-token'\n\n/**\n * Responds with an HTML page that simulates an OAuth 2.0 authorization page.\n */\nexport function respondWithAuthorizePage(c: Context, title = '') {\n  const redirectUri = c.req.query('redirect_uri')\n  const state = c.req.query('state')\n\n  if (!redirectUri) {\n    return c.html(\n      generateErrorHtml(\n        'Missing redirect_uri parameter',\n        'This parameter is required for the OAuth 2.0 authorization flow to function correctly. Please provide a valid redirect URI in your request.',\n      ),\n      400,\n    )\n  }\n\n  try {\n    // Validate redirect URI against allowed domains\n    const redirectUrl = new URL(redirectUri)\n\n    redirectUrl.searchParams.set('code', EXAMPLE_AUTHORIZATION_CODE)\n\n    if (state) {\n      redirectUrl.searchParams.set('state', state)\n    }\n\n    const deniedUrl = new URL(redirectUri)\n    if (state) {\n      deniedUrl.searchParams.set('state', state)\n    }\n    deniedUrl.searchParams.set('error', 'access_denied')\n    deniedUrl.searchParams.set('error_description', 'User has denied the authorization request')\n\n    const htmlContent = generateAuthorizationHtml(redirectUrl.toString(), deniedUrl.toString(), title)\n\n    return c.html(htmlContent)\n  } catch {\n    return c.html(\n      generateErrorHtml(\n        'Invalid redirect_uri format',\n        'Please provide a valid URL. The redirect_uri parameter must be a properly formatted URL that includes the protocol (e.g., https://) and a valid domain. This is essential for the OAuth 2.0 flow to securely redirect after authorization.',\n      ),\n      400,\n    )\n  }\n}\n\nfunction generateAuthorizationHtml(redirectUrl: string, deniedUrl: string, title = '') {\n  return `\n<!DOCTYPE html>\n<html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n    <title>OAuth 2.0 Authorization</title>\n    <script src=\"https://cdn.tailwindcss.com\"></script>\n  </head>\n  <body class=\"flex justify-center items-center h-screen bg-gray-100\">\n\n    <div class=\"flex flex-col\">\n      <div class=\"mb-5 flex justify-center items-center gap-2\">\n        <img src=\"https://scalar.com/logo-dark.svg\" class=\"w-6 inline-block\" />\n        <div class=\"font-medium truncate max-w-[26ch] text-lg\">\n          ${title}\n        </div>\n      </div>\n      <div class=\"bg-gray-50 rounded-lg p-1 rounded-lg w-[28rem] shadow\">\n        <div class=\"\">\n          <h1 class=\"text font-medium text-gray-800 px-6 pt-2 pb-3 flex gap-3 rounded-t-lg\">\n            OAuth 2.0 Authorization\n          </h1>\n          <div class=\"bg-white rounded\">\n            <div class=\"text-gray-600 text-base px-6 py-5 flex flex-col gap-3\">\n              <p>\n                This application is requesting access to your account. By granting authorization, you allow the application to perform certain actions on your behalf.\n              </p>\n              <p>\n                If you're comfortable with the access being requested, click the button below to grant authorization:\n              </p>\n            </div>\n            <div class=\"px-6 py-4 pt-0 flex justify-between\">\n              <a href=\"${deniedUrl}\" class=\"inline-block px-6 py-2 text-gray-600 rounded border\" aria-label=\"Cancel authorization\">\n                Cancel\n              </a>\n              <a href=\"${redirectUrl}\" class=\"inline-block px-6 py-2 bg-black text-white rounded transition-colors duration-300 hover:bg-gray-800\" aria-label=\"Authorize application\">\n                Authorize\n              </a>\n            </div>\n          </div>\n        </div>\n      </div>\n\n      <p class=\"text-xs text-gray-400 mt-5 text-center\">\n        This authorization page is provided by @scalar/mock-server\n      </p>\n\n    </div>\n  </body>\n</html>\n  `\n}\n\nfunction generateErrorHtml(title: string, message: string) {\n  return `<html>\n  <html lang=\"en\">\n  <head>\n    <meta charset=\"UTF-8\">\n    <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n    <title>OAuth 2.0 Authorization</title>\n    <script src=\"https://cdn.tailwindcss.com\"></script>\n  </head>\n  <body>\n    <div class=\"p-4 m-8 flex flex-col gap-4 text-lg\">\n      <h1 class=\"font-bold\">\n        Error: ${title}\n      </h1>\n      <p>\n        ${message}\n      </p>\n      <p>\n        Example: <code class=\"bg-gray-100 py-1 px-2 rounded text-base\"><a href=\"?redirect_uri=https://example.com/callback\">?redirect_uri=https://example.com/callback</a></code>\n      </p>\n    </div>\n  </body>\n</html>`\n}\n"],
   "mappings": "AAGA,MAAM,6BAA6B;AAK5B,SAAS,yBAAyB,GAAY,QAAQ,IAAI;AAC/D,QAAM,cAAc,EAAE,IAAI,MAAM,cAAc;AAC9C,QAAM,QAAQ,EAAE,IAAI,MAAM,OAAO;AAEjC,MAAI,CAAC,aAAa;AAChB,WAAO,EAAE;AAAA,MACP;AAAA,QACE;AAAA,QACA;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI;AAEF,UAAM,cAAc,IAAI,IAAI,WAAW;AAEvC,gBAAY,aAAa,IAAI,QAAQ,0BAA0B;AAE/D,QAAI,OAAO;AACT,kBAAY,aAAa,IAAI,SAAS,KAAK;AAAA,IAC7C;AAEA,UAAM,YAAY,IAAI,IAAI,WAAW;AACrC,QAAI,OAAO;AACT,gBAAU,aAAa,IAAI,SAAS,KAAK;AAAA,IAC3C;AACA,cAAU,aAAa,IAAI,SAAS,eAAe;AACnD,cAAU,aAAa,IAAI,qBAAqB,2CAA2C;AAE3F,UAAM,cAAc,0BAA0B,YAAY,SAAS,GAAG,UAAU,SAAS,GAAG,KAAK;AAEjG,WAAO,EAAE,KAAK,WAAW;AAAA,EAC3B,QAAQ;AACN,WAAO,EAAE;AAAA,MACP;AAAA,QACE;AAAA,QACA;AAAA,MACF;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;AAEA,SAAS,0BAA0B,aAAqB,WAAmB,QAAQ,IAAI;AACrF,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,YAeG,KAAK;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAkBQ,SAAS;AAAA;AAAA;AAAA,yBAGT,WAAW;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgBpC;AAEA,SAAS,kBAAkB,OAAe,SAAiB;AACzD,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAWQ,KAAK;AAAA;AAAA;AAAA,UAGZ,OAAO;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAQjB;",
   "names": []

package/dist/routes/{respondWithOpenApiDocument.d.ts → respond-with-openapi-document.d.ts}

@@ -19,4 +19,4 @@ export declare function respondWithOpenApiDocument(c: Context, input?: string |
     error: string;
     message: string;
 }, 400, "json">);
-//# sourceMappingURL=respondWithOpenApiDocument.d.ts.map
+//# sourceMappingURL=respond-with-openapi-document.d.ts.map

package/dist/routes/respond-with-openapi-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond-with-openapi-document.d.ts","sourceRoot":"","sources":["../../src/routes/respond-with-openapi-document.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,CAAC,EAAE,OAAO,EACV,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACpC,MAAM,GAAE,MAAM,GAAG,MAAe;;;;;;;;;;;;;;;;iBAwCjC"}

package/dist/routes/{respondWithOpenApiDocument.js → respond-with-openapi-document.js}

@@ -36,4 +36,4 @@ function respondWithOpenApiDocument(c, input, format = "json") {
 export {
   respondWithOpenApiDocument
 };
-//# sourceMappingURL=respondWithOpenApiDocument.js.map
+//# sourceMappingURL=respond-with-openapi-document.js.map

package/dist/routes/{respondWithOpenApiDocument.js.map → respond-with-openapi-document.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/routes/respondWithOpenApiDocument.ts"],
+  "sources": ["../../src/routes/respond-with-openapi-document.ts"],
   "sourcesContent": ["import { normalize, toYaml } from '@scalar/openapi-parser'\nimport type { Context } from 'hono'\n\n/**\n * OpenAPI endpoints\n */\nexport function respondWithOpenApiDocument(\n  c: Context,\n  input?: string | Record<string, any>,\n  format: 'json' | 'yaml' = 'json',\n) {\n  if (!input) {\n    return c.text('Not found', 404)\n  }\n\n  try {\n    const document = normalize(input)\n\n    // JSON\n    if (format === 'json') {\n      return c.json(document)\n    }\n\n    // YAML\n    try {\n      const yamlDocument = toYaml(normalize(document))\n\n      c.header('Content-Type', 'text/yaml')\n      return c.text(yamlDocument, 200, {\n        'Content-Type': 'application/yaml; charset=UTF-8',\n      })\n    } catch (error) {\n      return c.json(\n        {\n          error: 'Failed to convert document to YAML',\n          message: error instanceof Error ? error.message : 'Unknown error occurred',\n        },\n        500,\n      )\n    }\n  } catch (error) {\n    return c.json(\n      {\n        error: 'Failed to parse OpenAPI document',\n        message: error instanceof Error ? error.message : 'Unknown error occurred',\n      },\n      400,\n    )\n  }\n}\n"],
   "mappings": "AAAA,SAAS,WAAW,cAAc;AAM3B,SAAS,2BACd,GACA,OACA,SAA0B,QAC1B;AACA,MAAI,CAAC,OAAO;AACV,WAAO,EAAE,KAAK,aAAa,GAAG;AAAA,EAChC;AAEA,MAAI;AACF,UAAM,WAAW,UAAU,KAAK;AAGhC,QAAI,WAAW,QAAQ;AACrB,aAAO,EAAE,KAAK,QAAQ;AAAA,IACxB;AAGA,QAAI;AACF,YAAM,eAAe,OAAO,UAAU,QAAQ,CAAC;AAE/C,QAAE,OAAO,gBAAgB,WAAW;AACpC,aAAO,EAAE,KAAK,cAAc,KAAK;AAAA,QAC/B,gBAAgB;AAAA,MAClB,CAAC;AAAA,IACH,SAAS,OAAO;AACd,aAAO,EAAE;AAAA,QACP;AAAA,UACE,OAAO;AAAA,UACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,QACpD;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAAA,EACF,SAAS,OAAO;AACd,WAAO,EAAE;AAAA,MACP;AAAA,QACE,OAAO;AAAA,QACP,SAAS,iBAAiB,QAAQ,MAAM,UAAU;AAAA,MACpD;AAAA,MACA;AAAA,IACF;AAAA,EACF;AACF;",
   "names": []

package/dist/routes/{respondWithToken.d.ts → respond-with-token.d.ts}

@@ -12,4 +12,4 @@ export declare function respondWithToken(c: Context): (Response & import("hono")
     refresh_token: string;
     scope: string;
 }, import("hono/utils/http-status").ContentfulStatusCode, "json">);
-//# sourceMappingURL=respondWithToken.d.ts.map
+//# sourceMappingURL=respond-with-token.d.ts.map

package/dist/routes/respond-with-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"respond-with-token.d.ts","sourceRoot":"","sources":["../../src/routes/respond-with-token.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAKnC;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,OAAO;;;;;;;;;mEAmD1C"}

package/dist/routes/{respondWithToken.js → respond-with-token.js}

@@ -43,4 +43,4 @@ function respondWithToken(c) {
 export {
   respondWithToken
 };
-//# sourceMappingURL=respondWithToken.js.map
+//# sourceMappingURL=respond-with-token.js.map

package/dist/routes/{respondWithToken.js.map → respond-with-token.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/routes/respondWithToken.ts"],
+  "sources": ["../../src/routes/respond-with-token.ts"],
   "sourcesContent": ["import type { Context } from 'hono'\n\n/** Always responds with this token */\nconst EXAMPLE_ACCESS_TOKEN = 'super-secret-access-token'\n\n/**\n * Responds with a JSON object simulating an OAuth 2.0 token response.\n */\nexport function respondWithToken(c: Context) {\n  const grantType = c.req.query('grant_type')\n\n  if (!grantType) {\n    return c.json(\n      {\n        error: 'invalid_request',\n        error_description: 'Missing grant_type parameter',\n      },\n      400,\n    )\n  }\n\n  // Validate supported grant types\n  const supportedGrantTypes = ['authorization_code', 'client_credentials', 'refresh_token']\n\n  if (!supportedGrantTypes.includes(grantType)) {\n    return c.json(\n      {\n        error: 'unsupported_grant_type',\n        error_description: `Grant type must be one of: ${supportedGrantTypes.join(', ')}`,\n      },\n      400,\n    )\n  }\n\n  // Validate required parameters for each grant type\n  if (grantType === 'authorization_code' && !c.req.query('code')) {\n    return c.json(\n      {\n        error: 'invalid_request',\n        error_description: 'Missing code parameter',\n      },\n      400,\n    )\n  }\n\n  // Simulate token generation\n  const tokenResponse = {\n    access_token: EXAMPLE_ACCESS_TOKEN,\n    token_type: 'Bearer',\n    expires_in: 3600,\n    refresh_token: 'example-refresh-token',\n    scope: c.req.query('scope') ?? 'read write',\n  }\n\n  // Security headers\n  c.header('Cache-Control', 'no-store')\n  c.header('Pragma', 'no-cache')\n\n  return c.json(tokenResponse)\n}\n"],
   "mappings": "AAGA,MAAM,uBAAuB;AAKtB,SAAS,iBAAiB,GAAY;AAC3C,QAAM,YAAY,EAAE,IAAI,MAAM,YAAY;AAE1C,MAAI,CAAC,WAAW;AACd,WAAO,EAAE;AAAA,MACP;AAAA,QACE,OAAO;AAAA,QACP,mBAAmB;AAAA,MACrB;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAGA,QAAM,sBAAsB,CAAC,sBAAsB,sBAAsB,eAAe;AAExF,MAAI,CAAC,oBAAoB,SAAS,SAAS,GAAG;AAC5C,WAAO,EAAE;AAAA,MACP;AAAA,QACE,OAAO;AAAA,QACP,mBAAmB,8BAA8B,oBAAoB,KAAK,IAAI,CAAC;AAAA,MACjF;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAGA,MAAI,cAAc,wBAAwB,CAAC,EAAE,IAAI,MAAM,MAAM,GAAG;AAC9D,WAAO,EAAE;AAAA,MACP;AAAA,QACE,OAAO;AAAA,QACP,mBAAmB;AAAA,MACrB;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAGA,QAAM,gBAAgB;AAAA,IACpB,cAAc;AAAA,IACd,YAAY;AAAA,IACZ,YAAY;AAAA,IACZ,eAAe;AAAA,IACf,OAAO,EAAE,IAAI,MAAM,OAAO,KAAK;AAAA,EACjC;AAGA,IAAE,OAAO,iBAAiB,UAAU;AACpC,IAAE,OAAO,UAAU,UAAU;AAE7B,SAAO,EAAE,KAAK,aAAa;AAC7B;",
   "names": []

package/dist/types.d.ts

@@ -4,12 +4,25 @@ import type { Context } from 'hono';
 export declare const httpMethods: readonly ["get", "put", "post", "delete", "options", "patch"];
 /** Valid HTTP method */
 export type HttpMethod = (typeof httpMethods)[number];
-export type MockServerOptions = {
+/**
+ * Represents a partial object where at least one of the given properties is required.
+ */
+type RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> & {
+    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>;
+}[Keys];
+type BaseMockServerOptions = {
     /**
-     * The OpenAPI specification to use for mocking.
+     * The OpenAPI document to use for mocking.
      * Can be a string (URL or file path) or an object.
+     *
+     * @deprecated Use `document` instead
      */
-    specification: string | Record<string, any>;
+    specification?: string | Record<string, any>;
+    /**
+     * The OpenAPI document to use for mocking.
+     * Can be a string (URL or file path) or an object.
+     */
+    document?: string | Record<string, any>;
     /**
      * Callback function to be called before each request is processed.
      */
@@ -18,4 +31,6 @@ export type MockServerOptions = {
         operation: OpenAPI.Operation;
     }) => void;
 };
+export type MockServerOptions = RequireAtLeastOne<BaseMockServerOptions, 'specification' | 'document'>;
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,6CAA6C;AAC7C,eAAO,MAAM,WAAW,+DAAgE,CAAA;AAExF,wBAAwB;AACxB,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD,MAAM,MAAM,iBAAiB,GAAG;IAC9B;;;OAGG;IACH,aAAa,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE3C;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAA;KAAE,KAAK,IAAI,CAAA;CAC/E,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAEnC,6CAA6C;AAC7C,eAAO,MAAM,WAAW,+DAAgE,CAAA;AAExF,wBAAwB;AACxB,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD;;GAEG;AACH,KAAK,iBAAiB,CAAC,CAAC,EAAE,IAAI,SAAS,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,CAAC,GACzF;KACG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;CACzE,CAAC,IAAI,CAAC,CAAA;AAET,KAAK,qBAAqB,GAAG;IAC3B;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAE5C;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAEvC;;OAEG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,SAAS,EAAE,OAAO,CAAC,SAAS,CAAA;KAAE,KAAK,IAAI,CAAA;CAC/E,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC,qBAAqB,EAAE,eAAe,GAAG,UAAU,CAAC,CAAA"}

package/dist/types.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/types.ts"],
-  "sourcesContent": ["import type { OpenAPI } from '@scalar/openapi-types'\nimport type { Context } from 'hono'\n\n/** Available HTTP methods for Hono routes */\nexport const httpMethods = ['get', 'put', 'post', 'delete', 'options', 'patch'] as const\n\n/** Valid HTTP method */\nexport type HttpMethod = (typeof httpMethods)[number]\n\nexport type MockServerOptions = {\n  /**\n   * The OpenAPI specification to use for mocking.\n   * Can be a string (URL or file path) or an object.\n   */\n  specification: string | Record<string, any>\n\n  /**\n   * Callback function to be called before each request is processed.\n   */\n  onRequest?: (data: { context: Context; operation: OpenAPI.Operation }) => void\n}\n"],
+  "sourcesContent": ["import type { OpenAPI } from '@scalar/openapi-types'\nimport type { Context } from 'hono'\n\n/** Available HTTP methods for Hono routes */\nexport const httpMethods = ['get', 'put', 'post', 'delete', 'options', 'patch'] as const\n\n/** Valid HTTP method */\nexport type HttpMethod = (typeof httpMethods)[number]\n\n/**\n * Represents a partial object where at least one of the given properties is required.\n */\ntype RequireAtLeastOne<T, Keys extends keyof T = keyof T> = Pick<T, Exclude<keyof T, Keys>> &\n  {\n    [K in Keys]-?: Required<Pick<T, K>> & Partial<Pick<T, Exclude<Keys, K>>>\n  }[Keys]\n\ntype BaseMockServerOptions = {\n  /**\n   * The OpenAPI document to use for mocking.\n   * Can be a string (URL or file path) or an object.\n   *\n   * @deprecated Use `document` instead\n   */\n  specification?: string | Record<string, any>\n\n  /**\n   * The OpenAPI document to use for mocking.\n   * Can be a string (URL or file path) or an object.\n   */\n  document?: string | Record<string, any>\n\n  /**\n   * Callback function to be called before each request is processed.\n   */\n  onRequest?: (data: { context: Context; operation: OpenAPI.Operation }) => void\n}\n\nexport type MockServerOptions = RequireAtLeastOne<BaseMockServerOptions, 'specification' | 'document'>\n"],
   "mappings": "AAIO,MAAM,cAAc,CAAC,OAAO,OAAO,QAAQ,UAAU,WAAW,OAAO;",
   "names": []
 }

package/dist/utils/{createOpenApiDefinition.d.ts → create-openapi-definition.d.ts}

@@ -1,4 +1,4 @@
 import type { OpenAPIV3, OpenAPIV3_1 } from '@scalar/openapi-types';
 /** Helper function create an OpenAPI document with security schemss */
 export declare function createOpenApiDefinition(securitySchemes: Record<string, OpenAPIV3.SecuritySchemeObject | OpenAPIV3_1.SecuritySchemeObject>): OpenAPIV3_1.Document;
-//# sourceMappingURL=createOpenApiDefinition.d.ts.map
+//# sourceMappingURL=create-openapi-definition.d.ts.map

package/dist/utils/create-openapi-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-openapi-definition.d.ts","sourceRoot":"","sources":["../../src/utils/create-openapi-definition.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnE,uEAAuE;AACvE,wBAAgB,uBAAuB,CACrC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,oBAAoB,GAAG,WAAW,CAAC,oBAAoB,CAAC,GACjG,WAAW,CAAC,QAAQ,CAMtB"}

package/dist/utils/{createOpenApiDefinition.js → create-openapi-definition.js}

@@ -8,4 +8,4 @@ function createOpenApiDefinition(securitySchemes) {
 export {
   createOpenApiDefinition
 };
-//# sourceMappingURL=createOpenApiDefinition.js.map
+//# sourceMappingURL=create-openapi-definition.js.map

package/dist/utils/{createOpenApiDefinition.js.map → create-openapi-definition.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/createOpenApiDefinition.ts"],
+  "sources": ["../../src/utils/create-openapi-definition.ts"],
   "sourcesContent": ["import type { OpenAPIV3, OpenAPIV3_1 } from '@scalar/openapi-types'\n\n/** Helper function create an OpenAPI document with security schemss */\nexport function createOpenApiDefinition(\n  securitySchemes: Record<string, OpenAPIV3.SecuritySchemeObject | OpenAPIV3_1.SecuritySchemeObject>,\n): OpenAPIV3_1.Document {\n  return {\n    openapi: '3.1.1',\n    info: { title: 'Test API', version: '1.0.0' },\n    components: { securitySchemes },\n  }\n}\n"],
   "mappings": "AAGO,SAAS,wBACd,iBACsB;AACtB,SAAO;AAAA,IACL,SAAS;AAAA,IACT,MAAM,EAAE,OAAO,YAAY,SAAS,QAAQ;AAAA,IAC5C,YAAY,EAAE,gBAAgB;AAAA,EAChC;AACF;",
   "names": []

package/dist/utils/{findPreferredResponseKey.d.ts → find-preferred-response-key.d.ts}

@@ -2,4 +2,4 @@
  * Find the preferred response key: default, 200, 201 …
  */
 export declare function findPreferredResponseKey(responses?: string[]): string | undefined;
-//# sourceMappingURL=findPreferredResponseKey.d.ts.map
+//# sourceMappingURL=find-preferred-response-key.d.ts.map

package/dist/utils/find-preferred-response-key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find-preferred-response-key.d.ts","sourceRoot":"","sources":["../../src/utils/find-preferred-response-key.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,sBAQ5D"}

package/dist/utils/{findPreferredResponseKey.js → find-preferred-response-key.js}

@@ -8,4 +8,4 @@ function findPreferredResponseKey(responses) {
 export {
   findPreferredResponseKey
 };
-//# sourceMappingURL=findPreferredResponseKey.js.map
+//# sourceMappingURL=find-preferred-response-key.js.map

package/dist/utils/{findPreferredResponseKey.js.map → find-preferred-response-key.js.map}

@@ -1,6 +1,6 @@
 {
   "version": 3,
-  "sources": ["../../src/utils/findPreferredResponseKey.ts"],
+  "sources": ["../../src/utils/find-preferred-response-key.ts"],
   "sourcesContent": ["/**\n * Find the preferred response key: default, 200, 201 \u2026\n */\nexport function findPreferredResponseKey(responses?: string[]) {\n  return (\n    // Regular status codes\n    ['default', '200', '201', '204', '404', '500'].find((key) => responses?.includes(key) ?? false) ??\n    // Lowest status code\n    responses?.sort()[0] ??\n    undefined\n  )\n}\n"],
   "mappings": "AAGO,SAAS,yBAAyB,WAAsB;AAC7D;AAAA;AAAA,IAEE,CAAC,WAAW,OAAO,OAAO,OAAO,OAAO,KAAK,EAAE,KAAK,CAAC,QAAQ,WAAW,SAAS,GAAG,KAAK,KAAK;AAAA,IAE9F,WAAW,KAAK,EAAE,CAAC,KACnB;AAAA;AAEJ;",
   "names": []