@websublime/vite-plugin-open-api-server 0.24.0-next.2 → 0.24.0-next.3

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -1,7 +1,8 @@
1
1
  import { Plugin, ViteDevServer } from 'vite';
2
- import { Logger, HandlerFn, AnySeedFn } from '@websublime/vite-plugin-open-api-core';
2
+ import { Logger, SpecInfo, OpenApiServer, HandlerFn, AnySeedFn } from '@websublime/vite-plugin-open-api-core';
3
3
  export { HandlerContext, HandlerDefinition, HandlerFn, HandlerReturn, SecurityContext, SeedContext, SeedDefinition, SeedFn, SeedHelper, defineHandlers, defineSeeds } from '@websublime/vite-plugin-open-api-core';
4
4
  import { OpenAPIV3_1 } from '@scalar/openapi-types';
5
+ import { Hono } from 'hono';
5
6
  import { App } from 'vue';
6
7
 
7
8
  /**
@@ -186,16 +187,16 @@ interface OpenApiServerOptions {
186
187
  */
187
188
  interface ResolvedSpecConfig {
188
189
  spec: string;
189
- /** Guaranteed to be set after orchestrator resolution */
190
+ /** Empty string until orchestrator resolution; guaranteed non-empty after `createOrchestrator()` */
190
191
  id: string;
191
- /** Guaranteed to be set after orchestrator resolution */
192
+ /** Empty string until orchestrator resolution; guaranteed non-empty after `createOrchestrator()` */
192
193
  proxyPath: string;
193
194
  /**
194
195
  * How proxyPath was determined — used for banner display.
195
196
  *
196
- * Set during static option resolution. The orchestrator (Task 1.7)
197
- * will pass this to the multi-spec banner so it can show
198
- * "(auto-derived)" vs "(explicit)" next to each proxy path.
197
+ * Written back by the orchestrator after document processing.
198
+ * Used by the startup banner to display `(auto-derived)` vs
199
+ * `(explicit)` next to each proxy path.
199
200
  */
200
201
  proxyPathSource: ProxyPathSource;
201
202
  handlersDir: string;
@@ -219,6 +220,25 @@ interface ResolvedOptions {
219
220
  silent: boolean;
220
221
  logger?: Logger;
221
222
  }
223
+ /**
224
+ * Validate that specs array is non-empty and each entry has a valid spec field.
225
+ *
226
+ * @param specs - Array of spec configurations to validate
227
+ * @throws {ValidationError} SPECS_EMPTY if specs array is missing or empty
228
+ * @throws {ValidationError} SPEC_NOT_FOUND if a spec entry has empty spec field
229
+ */
230
+ declare function validateSpecs(specs: SpecConfig[]): void;
231
+ /**
232
+ * Resolve options with defaults.
233
+ *
234
+ * Note: spec ID and proxyPath resolution requires processing the OpenAPI document
235
+ * first, so they are resolved later in the orchestrator.
236
+ * This function only resolves static defaults.
237
+ *
238
+ * @param options - User-provided options
239
+ * @returns Resolved options with all defaults applied
240
+ */
241
+ declare function resolveOptions(options: OpenApiServerOptions): ResolvedOptions;
222
242
 
223
243
  /**
224
244
  * Vite Plugin Implementation
@@ -394,6 +414,82 @@ declare function validateUniqueProxyPaths(specs: Array<{
394
414
  proxyPath: string;
395
415
  }>): void;
396
416
 
417
+ /**
418
+ * Multi-Spec Orchestrator
419
+ *
420
+ * What: Central orchestrator that creates N spec instances and mounts them on a single Hono app
421
+ * How: Three phases — process specs, validate uniqueness, build main Hono app with dispatch middleware
422
+ * Why: Enables multiple OpenAPI specs to run on a single server with isolated stores and handlers
423
+ *
424
+ * @module orchestrator
425
+ */
426
+
427
+ /**
428
+ * Deterministic color palette for spec identification in DevTools.
429
+ *
430
+ * Colors are assigned by index: spec 0 gets green, spec 1 gets blue, etc.
431
+ * Wraps around for >8 specs.
432
+ */
433
+ declare const SPEC_COLORS: readonly string[];
434
+ /**
435
+ * Resolved spec instance with all runtime data.
436
+ *
437
+ * Created during Phase 1 of orchestration. Each instance owns
438
+ * an isolated core `OpenApiServer` with its own store, registry,
439
+ * handlers, seeds, and timeline.
440
+ */
441
+ interface SpecInstance {
442
+ /** Unique spec identifier (explicit or auto-derived from info.title) */
443
+ id: string;
444
+ /** Spec metadata for DevTools display and WebSocket protocol */
445
+ info: SpecInfo;
446
+ /** Core server instance (isolated Hono app, store, registry, etc.) */
447
+ server: OpenApiServer;
448
+ /** Resolved configuration for this spec */
449
+ config: ResolvedSpecConfig;
450
+ }
451
+ /**
452
+ * Orchestrator result — returned by `createOrchestrator()`.
453
+ *
454
+ * Provides access to the main Hono app (all specs mounted),
455
+ * individual spec instances, aggregated metadata, and lifecycle methods.
456
+ */
457
+ interface OrchestratorResult {
458
+ /** Main Hono app with all specs mounted via X-Spec-Id dispatch */
459
+ app: Hono;
460
+ /** All spec instances (in config order) */
461
+ instances: SpecInstance[];
462
+ /** Spec metadata array for WebSocket `connected` event */
463
+ specsInfo: SpecInfo[];
464
+ /** Start the shared HTTP server on the configured port */
465
+ start(): Promise<void>;
466
+ /** Stop the HTTP server and clean up resources */
467
+ stop(): Promise<void>;
468
+ /** Actual bound port after start() resolves (0 before start or after stop) */
469
+ readonly port: number;
470
+ }
471
+ /**
472
+ * Create the multi-spec orchestrator.
473
+ *
474
+ * Flow:
475
+ * 1. **Phase 1 — Process specs**: For each spec config, load handlers/seeds,
476
+ * create a core `OpenApiServer` instance, derive ID and proxy path.
477
+ * 2. **Phase 2 — Validate uniqueness**: Ensure all spec IDs and proxy paths
478
+ * are unique and non-overlapping.
479
+ * 3. **Phase 3 — Build main app**: Create a single Hono app with CORS,
480
+ * DevTools, Internal API, and X-Spec-Id dispatch middleware.
481
+ *
482
+ * **Note**: This function mutates `options.specs[i]` to write back resolved
483
+ * values (id, proxyPath, proxyPathSource, handlersDir, seedsDir) so that
484
+ * downstream consumers (banner, file watcher, plugin.ts) see the final values.
485
+ *
486
+ * @param options - Resolved plugin options (from `resolveOptions()`)
487
+ * @param vite - Vite dev server instance (for ssrLoadModule)
488
+ * @param cwd - Project root directory
489
+ * @returns Orchestrator result with app, instances, and lifecycle methods
490
+ */
491
+ declare function createOrchestrator(options: ResolvedOptions, vite: ViteDevServer, cwd: string): Promise<OrchestratorResult>;
492
+
397
493
  /**
398
494
  * Handler Loading
399
495
  *
@@ -690,4 +786,4 @@ declare function registerDevTools(app: App, options?: RegisterDevToolsOptions):
690
786
  */
691
787
  declare function getDevToolsUrl(port?: number, host?: string, protocol?: 'http' | 'https'): string;
692
788
 
693
- export { type DeriveProxyPathResult, type FileWatcher, type FileWatcherOptions, type LoadHandlersResult, type LoadSeedsResult, type OpenApiServerOptions, type ProxyPathSource, type RegisterDevToolsOptions, type ResolvedOptions, type ResolvedSpecConfig, type SpecConfig, ValidationError, type ValidationErrorCode, createFileWatcher, debounce, deriveProxyPath, deriveSpecId, getDevToolsUrl, getHandlerFiles, getSeedFiles, loadHandlers, loadSeeds, normalizeProxyPath, openApiServer, registerDevTools, slugify, validateUniqueIds, validateUniqueProxyPaths };
789
+ export { type DeriveProxyPathResult, type FileWatcher, type FileWatcherOptions, type LoadHandlersResult, type LoadSeedsResult, type OpenApiServerOptions, type OrchestratorResult, type ProxyPathSource, type RegisterDevToolsOptions, type ResolvedOptions, type ResolvedSpecConfig, SPEC_COLORS, type SpecConfig, type SpecInstance, ValidationError, type ValidationErrorCode, createFileWatcher, createOrchestrator, debounce, deriveProxyPath, deriveSpecId, getDevToolsUrl, getHandlerFiles, getSeedFiles, loadHandlers, loadSeeds, normalizeProxyPath, openApiServer, registerDevTools, resolveOptions, slugify, validateSpecs, validateUniqueIds, validateUniqueProxyPaths };
package/dist/index.js CHANGED
@@ -2,10 +2,12 @@ import { existsSync } from 'fs';
2
2
  import { createRequire } from 'module';
3
3
  import path2, { dirname, join } from 'path';
4
4
  import { fileURLToPath } from 'url';
5
- import { createOpenApiServer, executeSeeds } from '@websublime/vite-plugin-open-api-core';
5
+ import { createOpenApiServer, executeSeeds, mountInternalApi, mountDevToolsRoutes } from '@websublime/vite-plugin-open-api-core';
6
6
  export { defineHandlers, defineSeeds } from '@websublime/vite-plugin-open-api-core';
7
7
  import pc from 'picocolors';
8
8
  import fg from 'fast-glob';
9
+ import { Hono } from 'hono';
10
+ import { cors } from 'hono/cors';
9
11
 
10
12
  // src/plugin.ts
11
13
  function printBanner(info, options) {
@@ -440,11 +442,11 @@ function resolveOptions(options) {
440
442
  return {
441
443
  specs: options.specs.map((s) => ({
442
444
  spec: s.spec,
443
- // Placeholder — populated by orchestrator after document processing (Task 1.7)
445
+ // Placeholder — populated by orchestrator after document processing
444
446
  id: s.id ?? "",
445
- // Placeholder — populated by orchestrator after document processing (Task 1.7)
447
+ // Placeholder — populated by orchestrator after document processing
446
448
  proxyPath: s.proxyPath ?? "",
447
- // Preliminary — overwritten by deriveProxyPath() during orchestration (Task 1.7)
449
+ // Preliminary — overwritten by deriveProxyPath() during orchestration
448
450
  proxyPathSource: s.proxyPath?.trim() ? "explicit" : "auto",
449
451
  handlersDir: s.handlersDir ?? "",
450
452
  seedsDir: s.seedsDir ?? "",
@@ -882,6 +884,247 @@ function validateUniqueProxyPaths(specs) {
882
884
  }
883
885
  }
884
886
  }
887
+ var SPEC_COLORS = [
888
+ "#4ade80",
889
+ // green
890
+ "#60a5fa",
891
+ // blue
892
+ "#f472b6",
893
+ // pink
894
+ "#facc15",
895
+ // yellow
896
+ "#a78bfa",
897
+ // purple
898
+ "#fb923c",
899
+ // orange
900
+ "#2dd4bf",
901
+ // teal
902
+ "#f87171"
903
+ // red
904
+ ];
905
+ async function processSpec(specConfig, index, options, vite, cwd, logger) {
906
+ const specNamespace = specConfig.id ? slugify(specConfig.id) : `spec-${index}`;
907
+ const handlersDir = specConfig.handlersDir || `./mocks/${specNamespace}/handlers`;
908
+ const seedsDir = specConfig.seedsDir || `./mocks/${specNamespace}/seeds`;
909
+ const handlersResult = await loadHandlers(handlersDir, vite, cwd, logger);
910
+ const seedsResult = await loadSeeds(seedsDir, vite, cwd, logger);
911
+ const server = await createOpenApiServer({
912
+ spec: specConfig.spec,
913
+ port: options.port,
914
+ idFields: specConfig.idFields,
915
+ handlers: handlersResult.handlers,
916
+ seeds: /* @__PURE__ */ new Map(),
917
+ timelineLimit: options.timelineLimit,
918
+ cors: false,
919
+ // CORS handled at main app level
920
+ devtools: false,
921
+ // DevTools mounted at main app level
922
+ logger
923
+ });
924
+ if (seedsResult.seeds.size > 0) {
925
+ await executeSeeds(seedsResult.seeds, server.store, server.document);
926
+ }
927
+ const id = deriveSpecId(specConfig.id, server.document);
928
+ const { proxyPath, proxyPathSource } = deriveProxyPath(specConfig.proxyPath, server.document, id);
929
+ const info = {
930
+ id,
931
+ title: server.document.info?.title ?? id,
932
+ version: server.document.info?.version ?? "unknown",
933
+ proxyPath,
934
+ color: SPEC_COLORS[index % SPEC_COLORS.length],
935
+ endpointCount: server.registry.endpoints.size,
936
+ schemaCount: server.store.getSchemas().length
937
+ };
938
+ return {
939
+ instance: { id, info, server, config: specConfig },
940
+ resolvedConfig: { id, proxyPath, proxyPathSource, handlersDir, seedsDir }
941
+ };
942
+ }
943
+ function buildCorsConfig(options) {
944
+ const isWildcardOrigin = options.corsOrigin === "*" || Array.isArray(options.corsOrigin) && options.corsOrigin.includes("*");
945
+ const effectiveCorsOrigin = Array.isArray(options.corsOrigin) && options.corsOrigin.includes("*") ? "*" : options.corsOrigin;
946
+ return {
947
+ origin: effectiveCorsOrigin,
948
+ allowMethods: ["GET", "POST", "PUT", "PATCH", "DELETE", "OPTIONS", "HEAD"],
949
+ allowHeaders: ["Content-Type", "Authorization", "X-Requested-With", "X-Spec-Id"],
950
+ exposeHeaders: ["Content-Length", "X-Request-Id"],
951
+ maxAge: 86400,
952
+ credentials: !isWildcardOrigin
953
+ };
954
+ }
955
+ function mountDevToolsSpa(mainApp, logger) {
956
+ const pluginDir = dirname(fileURLToPath(import.meta.url));
957
+ const spaDir = join(pluginDir, "devtools-spa");
958
+ const devtoolsSpaDir = existsSync(spaDir) ? spaDir : void 0;
959
+ if (!devtoolsSpaDir) {
960
+ logger.warn?.(
961
+ "[vite-plugin-open-api-server] DevTools SPA not found at",
962
+ spaDir,
963
+ '- serving placeholder. Run "pnpm build" to include the SPA.'
964
+ );
965
+ }
966
+ mountDevToolsRoutes(mainApp, {
967
+ spaDir: devtoolsSpaDir,
968
+ logger
969
+ });
970
+ }
971
+ function createDispatchMiddleware(instanceMap) {
972
+ return async (c, next) => {
973
+ const rawSpecId = c.req.header("x-spec-id");
974
+ if (!rawSpecId) {
975
+ await next();
976
+ return;
977
+ }
978
+ const specId = slugify(rawSpecId.trim());
979
+ if (!specId) {
980
+ await next();
981
+ return;
982
+ }
983
+ const instance = instanceMap.get(specId);
984
+ if (!instance) {
985
+ return c.json({ error: `Unknown spec: ${specId}` }, 404);
986
+ }
987
+ return instance.server.app.fetch(c.req.raw);
988
+ };
989
+ }
990
+ async function createOrchestrator(options, vite, cwd) {
991
+ const logger = options.logger ?? console;
992
+ const instances = [];
993
+ for (let i = 0; i < options.specs.length; i++) {
994
+ const { instance, resolvedConfig } = await processSpec(
995
+ options.specs[i],
996
+ i,
997
+ options,
998
+ vite,
999
+ cwd,
1000
+ logger
1001
+ );
1002
+ const specConfig = options.specs[i];
1003
+ specConfig.id = resolvedConfig.id;
1004
+ specConfig.proxyPath = resolvedConfig.proxyPath;
1005
+ specConfig.proxyPathSource = resolvedConfig.proxyPathSource;
1006
+ specConfig.handlersDir = resolvedConfig.handlersDir;
1007
+ specConfig.seedsDir = resolvedConfig.seedsDir;
1008
+ instances.push(instance);
1009
+ }
1010
+ validateUniqueIds(instances.map((inst) => inst.id));
1011
+ validateUniqueProxyPaths(
1012
+ instances.map((inst) => ({
1013
+ id: inst.id,
1014
+ proxyPath: inst.config.proxyPath
1015
+ }))
1016
+ );
1017
+ const mainApp = new Hono();
1018
+ const corsConfig = buildCorsConfig(options);
1019
+ if (options.cors) {
1020
+ mainApp.use("*", cors(corsConfig));
1021
+ for (const inst of instances) {
1022
+ inst.server.app.use("*", cors(corsConfig));
1023
+ }
1024
+ }
1025
+ if (options.devtools) {
1026
+ mountDevToolsSpa(mainApp, logger);
1027
+ }
1028
+ if (instances.length > 0) {
1029
+ if (instances.length > 1) {
1030
+ logger.warn?.(
1031
+ "[vite-plugin-open-api-server] Only first spec's internal API mounted on /_api; multi-spec support planned in Epic 3 (Task 3.x)."
1032
+ );
1033
+ }
1034
+ const firstInstance = instances[0];
1035
+ mountInternalApi(mainApp, {
1036
+ store: firstInstance.server.store,
1037
+ registry: firstInstance.server.registry,
1038
+ simulationManager: firstInstance.server.simulationManager,
1039
+ wsHub: firstInstance.server.wsHub,
1040
+ timeline: firstInstance.server.getTimeline(),
1041
+ timelineLimit: options.timelineLimit,
1042
+ clearTimeline: () => firstInstance.server.truncateTimeline(),
1043
+ document: firstInstance.server.document
1044
+ });
1045
+ }
1046
+ const instanceMap = new Map(instances.map((inst) => [inst.id, inst]));
1047
+ mainApp.use("*", createDispatchMiddleware(instanceMap));
1048
+ const specsInfo = instances.map((inst) => inst.info);
1049
+ let serverInstance = null;
1050
+ let boundPort = 0;
1051
+ return {
1052
+ app: mainApp,
1053
+ instances,
1054
+ specsInfo,
1055
+ get port() {
1056
+ return boundPort;
1057
+ },
1058
+ async start() {
1059
+ if (serverInstance) {
1060
+ throw new Error("[vite-plugin-open-api-server] Server already running. Call stop() first.");
1061
+ }
1062
+ let createAdaptorServer;
1063
+ try {
1064
+ const nodeServer = await import('@hono/node-server');
1065
+ createAdaptorServer = nodeServer.createAdaptorServer;
1066
+ } catch {
1067
+ throw new Error(
1068
+ "@hono/node-server is required. Install with: npm install @hono/node-server"
1069
+ );
1070
+ }
1071
+ const server = createAdaptorServer({ fetch: mainApp.fetch });
1072
+ await new Promise((resolve, reject) => {
1073
+ const onListening = () => {
1074
+ server.removeListener("error", onError);
1075
+ const addr = server.address();
1076
+ const actualPort = typeof addr === "object" && addr ? addr.port : options.port;
1077
+ logger.info(
1078
+ `[vite-plugin-open-api-server] Server started on http://localhost:${actualPort}`
1079
+ );
1080
+ boundPort = actualPort;
1081
+ serverInstance = server;
1082
+ resolve();
1083
+ };
1084
+ const onError = (err) => {
1085
+ server.removeListener("listening", onListening);
1086
+ server.close(() => {
1087
+ });
1088
+ serverInstance = null;
1089
+ boundPort = 0;
1090
+ if (err.code === "EADDRINUSE") {
1091
+ reject(
1092
+ new Error(`[vite-plugin-open-api-server] Port ${options.port} is already in use.`)
1093
+ );
1094
+ } else {
1095
+ reject(new Error(`[vite-plugin-open-api-server] Server error: ${err.message}`));
1096
+ }
1097
+ };
1098
+ server.once("listening", onListening);
1099
+ server.once("error", onError);
1100
+ server.listen(options.port);
1101
+ });
1102
+ },
1103
+ async stop() {
1104
+ const server = serverInstance;
1105
+ if (server) {
1106
+ try {
1107
+ await new Promise((resolve, reject) => {
1108
+ server.close((err) => {
1109
+ if (err) {
1110
+ reject(err);
1111
+ } else {
1112
+ resolve();
1113
+ }
1114
+ });
1115
+ });
1116
+ logger.info("[vite-plugin-open-api-server] Server stopped");
1117
+ } catch (err) {
1118
+ logger.error?.("[vite-plugin-open-api-server] Error closing server:", err);
1119
+ throw err;
1120
+ } finally {
1121
+ serverInstance = null;
1122
+ boundPort = 0;
1123
+ }
1124
+ }
1125
+ }
1126
+ };
1127
+ }
885
1128
 
886
1129
  // src/devtools.ts
887
1130
  async function registerDevTools(app, options = {}) {
@@ -919,6 +1162,6 @@ function getDevToolsUrl(port = 3e3, host, protocol) {
919
1162
  return `${actualProtocol}://${actualHost}:${port}/_devtools/`;
920
1163
  }
921
1164
 
922
- export { ValidationError, createFileWatcher, debounce, deriveProxyPath, deriveSpecId, getDevToolsUrl, getHandlerFiles, getSeedFiles, loadHandlers, loadSeeds, normalizeProxyPath, openApiServer, registerDevTools, slugify, validateUniqueIds, validateUniqueProxyPaths };
1165
+ export { SPEC_COLORS, ValidationError, createFileWatcher, createOrchestrator, debounce, deriveProxyPath, deriveSpecId, getDevToolsUrl, getHandlerFiles, getSeedFiles, loadHandlers, loadSeeds, normalizeProxyPath, openApiServer, registerDevTools, resolveOptions, slugify, validateSpecs, validateUniqueIds, validateUniqueProxyPaths };
923
1166
  //# sourceMappingURL=index.js.map
924
1167
  //# sourceMappingURL=index.js.map
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/banner.ts","../src/utils.ts","../src/handlers.ts","../src/hot-reload.ts","../src/seeds.ts","../src/types.ts","../src/plugin.ts","../src/spec-id.ts","../src/proxy-path.ts","../src/devtools.ts"],"names":["path","fg","require","vite","id"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Startup Banner\n *\n * What: Prints a colorful startup banner with server information\n * How: Uses picocolors for ANSI color output\n * Why: Provides clear feedback about server status and configuration\n *\n * @module banner\n */\n\nimport type { EndpointRegistry } from '@websublime/vite-plugin-open-api-core';\nimport pc from 'picocolors';\nimport type { ResolvedOptions } from './types.js';\n\n/**\n * Banner configuration\n */\nexport interface BannerInfo {\n /** Server port */\n port: number;\n /** Proxy path in Vite */\n proxyPath: string;\n /** OpenAPI spec title */\n title: string;\n /** OpenAPI spec version */\n version: string;\n /** Number of endpoints */\n endpointCount: number;\n /** Number of loaded handlers */\n handlerCount: number;\n /** Number of loaded seeds */\n seedCount: number;\n /** DevTools enabled */\n devtools: boolean;\n}\n\n/**\n * Print the startup banner\n *\n * @param info - Banner information\n * @param options - Resolved plugin options\n */\nexport function printBanner(info: BannerInfo, options: ResolvedOptions): void {\n if (options.silent) {\n return;\n }\n\n const logger = options.logger ?? console;\n const log = (msg: string) => logger.info(msg);\n\n // Box drawing characters\n const BOX = {\n topLeft: '╭',\n topRight: '╮',\n bottomLeft: '╰',\n bottomRight: '╯',\n horizontal: '─',\n vertical: '│',\n };\n\n const width = 56;\n const horizontalLine = BOX.horizontal.repeat(width - 2);\n\n log('');\n log(pc.cyan(`${BOX.topLeft}${horizontalLine}${BOX.topRight}`));\n log(\n pc.cyan(BOX.vertical) + centerText('🚀 OpenAPI Mock Server', width - 2) + pc.cyan(BOX.vertical),\n );\n log(pc.cyan(`${BOX.bottomLeft}${horizontalLine}${BOX.bottomRight}`));\n log('');\n\n // API Info\n log(\n ` ${pc.bold(pc.white('API:'))} ${pc.green(info.title)} ${pc.dim(`v${info.version}`)}`,\n );\n log(` ${pc.bold(pc.white('Server:'))} ${pc.cyan(`http://localhost:${info.port}`)}`);\n log(\n ` ${pc.bold(pc.white('Proxy:'))} ${pc.yellow(info.proxyPath)} ${pc.dim('→')} ${pc.dim(`localhost:${info.port}`)}`,\n );\n log('');\n\n // Stats\n const stats = [\n { label: 'Endpoints', value: info.endpointCount, color: pc.blue },\n { label: 'Handlers', value: info.handlerCount, color: pc.green },\n { label: 'Seeds', value: info.seedCount, color: pc.magenta },\n ];\n\n const statsLine = stats\n .map((s) => `${pc.dim(`${s.label}:`)} ${s.color(String(s.value))}`)\n .join(pc.dim(' │ '));\n log(` ${statsLine}`);\n log('');\n\n // DevTools\n if (info.devtools) {\n log(\n ` ${pc.bold(pc.white('DevTools:'))} ${pc.cyan(`http://localhost:${info.port}/_devtools`)}`,\n );\n log(` ${pc.bold(pc.white('API Info:'))} ${pc.cyan(`http://localhost:${info.port}/_api`)}`);\n log('');\n }\n\n // Footer\n log(pc.dim(' Press Ctrl+C to stop the server'));\n log('');\n}\n\n/**\n * Center text within a given width\n *\n * @param text - Text to center\n * @param width - Total width\n * @returns Centered text with padding\n */\n// biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape codes require control characters\nconst ANSI_ESCAPE_REGEX = /\\x1b\\[[0-9;]*m/g;\n\nfunction centerText(text: string, width: number): string {\n // Account for ANSI codes - get visible length\n const visibleLength = text.replace(ANSI_ESCAPE_REGEX, '').length;\n const padding = Math.max(0, width - visibleLength);\n const leftPad = Math.floor(padding / 2);\n const rightPad = padding - leftPad;\n return ' '.repeat(leftPad) + text + ' '.repeat(rightPad);\n}\n\n/**\n * Extract banner info from server registry and document\n *\n * Note: This is the v0.x single-spec banner. It will be redesigned for\n * multi-spec display in Task 1.7 (vite-qq9.7). Currently only shows the\n * first spec's information.\n *\n * @param registry - Endpoint registry\n * @param document - OpenAPI document\n * @param handlerCount - Number of loaded handlers\n * @param seedCount - Number of loaded seed schemas\n * @param options - Resolved options (must contain at least one spec)\n * @returns Banner info\n */\nexport function extractBannerInfo(\n registry: EndpointRegistry,\n document: { info: { title: string; version: string } },\n handlerCount: number,\n seedCount: number,\n options: ResolvedOptions,\n): BannerInfo {\n return {\n port: options.port,\n proxyPath: options.specs[0]?.proxyPath || '(pending resolution)',\n title: document.info.title,\n version: document.info.version,\n endpointCount: registry.endpoints.size,\n handlerCount,\n seedCount,\n devtools: options.devtools,\n };\n}\n\n/**\n * Print a hot reload notification\n *\n * @param type - Type of reload ('handlers' | 'seeds')\n * @param count - Number of reloaded items\n * @param options - Resolved options\n */\nexport function printReloadNotification(\n type: 'handlers' | 'seeds',\n count: number,\n options: ResolvedOptions,\n): void {\n if (options.silent) {\n return;\n }\n\n const logger = options.logger ?? console;\n const icon = type === 'handlers' ? '🔄' : '🌱';\n const label = type === 'handlers' ? 'Handlers' : 'Seeds';\n const color = type === 'handlers' ? pc.green : pc.magenta;\n\n logger.info(` ${icon} ${color(label)} reloaded: ${pc.bold(String(count))} ${type}`);\n}\n\n/**\n * Print an error message\n *\n * @param message - Error message\n * @param error - Optional error object\n * @param options - Resolved options\n */\nexport function printError(message: string, error: unknown, options: ResolvedOptions): void {\n const logger = options.logger ?? console;\n logger.error(`${pc.red('✖')} ${pc.bold(pc.red('Error:'))} ${message}`);\n if (error instanceof Error) {\n logger.error(pc.dim(` ${error.message}`));\n }\n}\n\n/**\n * Print a warning message\n *\n * @param message - Warning message\n * @param options - Resolved options\n */\nexport function printWarning(message: string, options: ResolvedOptions): void {\n if (options.silent) {\n return;\n }\n\n const logger = options.logger ?? console;\n logger.warn(`${pc.yellow('⚠')} ${pc.yellow('Warning:')} ${message}`);\n}\n","/**\n * Filesystem Utilities\n *\n * What: Shared utility functions for filesystem operations\n * How: Uses Node.js fs/promises module with error handling\n * Why: Provides reusable utilities for handler and seed loading\n *\n * @module utils\n */\n\n/**\n * Check if a directory exists\n *\n * @param dirPath - Path to check\n * @returns Promise resolving to true if directory exists\n */\nexport async function directoryExists(dirPath: string): Promise<boolean> {\n try {\n const fs = await import('node:fs/promises');\n const stats = await fs.stat(dirPath);\n return stats.isDirectory();\n } catch {\n return false;\n }\n}\n","/**\n * Handler Loading\n *\n * What: Loads handler files from a directory using glob patterns\n * How: Uses Vite's ssrLoadModule to transform and load TypeScript files\n * Why: Enables users to define custom handlers for operationIds in TypeScript\n *\n * @module handlers\n */\n\nimport path from 'node:path';\nimport type { HandlerDefinition, HandlerFn, Logger } from '@websublime/vite-plugin-open-api-core';\nimport fg from 'fast-glob';\nimport type { ViteDevServer } from 'vite';\nimport { directoryExists } from './utils.js';\n\n/**\n * Result of loading handlers\n */\nexport interface LoadHandlersResult {\n /** Map of operationId to handler function */\n handlers: Map<string, HandlerFn>;\n /** Number of handler files loaded */\n fileCount: number;\n /** List of loaded file paths (relative) */\n files: string[];\n}\n\n/**\n * Load handlers from a directory\n *\n * Searches for handler files matching the pattern `*.handlers.{ts,js,mjs}`\n * in the specified directory. Each file should export an object with\n * operationId keys and handler functions as values.\n *\n * Uses Vite's ssrLoadModule to transform TypeScript files on-the-fly.\n *\n * @example\n * ```typescript\n * // mocks/handlers/pets.handlers.ts\n * import { defineHandlers } from '@websublime/vite-plugin-open-api-core';\n *\n * export default defineHandlers({\n * getPetById: async ({ req, store }) => {\n * const pet = store.get('Pet', req.params.petId);\n * return pet ?? { status: 404, data: { message: 'Pet not found' } };\n * },\n * });\n * ```\n *\n * @param handlersDir - Directory to search for handler files\n * @param viteServer - Vite dev server instance for ssrLoadModule\n * @param cwd - Current working directory (defaults to process.cwd())\n * @param logger - Optional logger for warnings/errors\n * @returns Promise resolving to loaded handlers\n */\nexport async function loadHandlers(\n handlersDir: string,\n viteServer: ViteDevServer,\n cwd: string = process.cwd(),\n logger: Logger = console,\n): Promise<LoadHandlersResult> {\n const handlers = new Map<string, HandlerFn>();\n const absoluteDir = path.resolve(cwd, handlersDir);\n\n // Check if directory exists\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return {\n handlers,\n fileCount: 0,\n files: [],\n };\n }\n\n // Find handler files (supports TypeScript via Vite's transform)\n const pattern = '**/*.handlers.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: false,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n // Load each file using Vite's ssrLoadModule\n for (const file of files) {\n const absolutePath = path.join(absoluteDir, file);\n const fileHandlers = await loadHandlerFile(absolutePath, viteServer, logger);\n\n // Merge handlers\n for (const [operationId, handler] of Object.entries(fileHandlers)) {\n if (handlers.has(operationId)) {\n logger.warn(\n `[vite-plugin-open-api-server] Duplicate handler for operationId \"${operationId}\" in ${file}. Using last definition.`,\n );\n }\n handlers.set(operationId, handler);\n }\n }\n\n return {\n handlers,\n fileCount: files.length,\n files,\n };\n}\n\n/**\n * Load a single handler file using Vite's ssrLoadModule\n *\n * @param filePath - Absolute path to the handler file\n * @param viteServer - Vite dev server instance\n * @param logger - Logger for warnings/errors\n * @returns Promise resolving to handler definition object\n */\nasync function loadHandlerFile(\n filePath: string,\n viteServer: ViteDevServer,\n logger: Logger,\n): Promise<HandlerDefinition> {\n try {\n // Invalidate module cache for hot reload\n const moduleNode = viteServer.moduleGraph.getModuleById(filePath);\n if (moduleNode) {\n viteServer.moduleGraph.invalidateModule(moduleNode);\n }\n\n // Use Vite's ssrLoadModule to transform and load the file\n // This handles TypeScript, ESM, and other transforms automatically\n const module = await viteServer.ssrLoadModule(filePath);\n\n // Support both default export and named export\n const handlers = module.default ?? module.handlers ?? module;\n\n // Validate handlers object\n if (!handlers || typeof handlers !== 'object') {\n logger.warn(\n `[vite-plugin-open-api-server] Invalid handler file ${filePath}: expected object export`,\n );\n return {};\n }\n\n // Filter to only handler functions\n const validHandlers: HandlerDefinition = {};\n for (const [key, value] of Object.entries(handlers)) {\n if (typeof value === 'function') {\n validHandlers[key] = value as HandlerFn;\n }\n }\n\n return validHandlers;\n } catch (error) {\n logger.error(\n `[vite-plugin-open-api-server] Failed to load handler file ${filePath}:`,\n error instanceof Error ? error.message : error,\n );\n return {};\n }\n}\n\n/**\n * Get list of handler files in a directory\n *\n * Useful for file watching setup.\n *\n * @param handlersDir - Directory to search\n * @param cwd - Current working directory\n * @returns Promise resolving to list of absolute file paths\n */\nexport async function getHandlerFiles(\n handlersDir: string,\n cwd: string = process.cwd(),\n): Promise<string[]> {\n const absoluteDir = path.resolve(cwd, handlersDir);\n\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return [];\n }\n\n const pattern = '**/*.handlers.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: true,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n return files;\n}\n","/**\n * Hot Reload\n *\n * What: File watcher for hot reloading handlers and seeds\n * How: Uses chokidar to watch for file changes\n * Why: Enables rapid development iteration without server restart\n *\n * @module hot-reload\n *\n * TODO: Full implementation in Task 3.3\n * This module provides placeholder/basic functionality for Task 3.1\n */\n\nimport path from 'node:path';\nimport type { Logger } from '@websublime/vite-plugin-open-api-core';\nimport type { FSWatcher } from 'chokidar';\n\n/**\n * File watcher configuration\n */\nexport interface FileWatcherOptions {\n /** Directory containing handler files */\n handlersDir?: string;\n /** Directory containing seed files */\n seedsDir?: string;\n /** Callback when a handler file changes */\n onHandlerChange?: (filePath: string) => Promise<void> | void;\n /** Callback when a seed file changes */\n onSeedChange?: (filePath: string) => Promise<void> | void;\n /** Current working directory */\n cwd?: string;\n /** Logger for error messages */\n logger?: Logger;\n}\n\n/**\n * File watcher instance\n */\nexport interface FileWatcher {\n /** Close the watcher and release resources */\n close(): Promise<void>;\n /** Check if watcher is active */\n readonly isWatching: boolean;\n /** Promise that resolves when all watchers are ready */\n readonly ready: Promise<void>;\n}\n\n/**\n * Create a file watcher for handlers and seeds\n *\n * Watches for changes to handler and seed files and invokes\n * callbacks when changes are detected. Supports add, change,\n * and unlink events.\n *\n * @example\n * ```typescript\n * const watcher = await createFileWatcher({\n * handlersDir: './mocks/handlers',\n * seedsDir: './mocks/seeds',\n * onHandlerChange: async (file) => {\n * console.log('Handler changed:', file);\n * const handlers = await loadHandlers('./mocks/handlers');\n * server.updateHandlers(handlers.handlers);\n * },\n * onSeedChange: async (file) => {\n * console.log('Seed changed:', file);\n * const seeds = await loadSeeds('./mocks/seeds');\n * // Re-execute seeds...\n * },\n * });\n *\n * // Later, clean up\n * await watcher.close();\n * ```\n *\n * @param options - Watcher configuration\n * @returns Promise resolving to file watcher instance\n */\nexport async function createFileWatcher(options: FileWatcherOptions): Promise<FileWatcher> {\n const {\n handlersDir,\n seedsDir,\n onHandlerChange,\n onSeedChange,\n cwd = process.cwd(),\n logger = console,\n } = options;\n\n // Dynamic import chokidar to avoid bundling issues\n const { watch } = await import('chokidar');\n\n const watchers: FSWatcher[] = [];\n const readyPromises: Promise<void>[] = [];\n let isWatching = true;\n\n // Handler file patterns\n const handlerPattern = '**/*.handlers.{ts,js,mjs}';\n const seedPattern = '**/*.seeds.{ts,js,mjs}';\n\n /**\n * Wrapper to safely invoke async callbacks and log errors\n * Prevents unhandled promise rejections from file watcher events\n */\n const safeInvoke = (\n callback: (filePath: string) => Promise<void> | void,\n filePath: string,\n context: string,\n ): void => {\n Promise.resolve()\n .then(() => callback(filePath))\n .catch((error) => {\n logger.error(\n `[vite-plugin-open-api-server] ${context} callback error for ${filePath}:`,\n error,\n );\n });\n };\n\n // Watch handlers directory\n if (handlersDir && onHandlerChange) {\n const absoluteHandlersDir = path.resolve(cwd, handlersDir);\n const handlerWatcher = watch(handlerPattern, {\n cwd: absoluteHandlersDir,\n ignoreInitial: true,\n ignored: ['**/node_modules/**', '**/dist/**'],\n persistent: true,\n awaitWriteFinish: {\n stabilityThreshold: 100,\n pollInterval: 50,\n },\n });\n\n handlerWatcher.on('add', (file) => {\n const absolutePath = path.join(absoluteHandlersDir, file);\n safeInvoke(onHandlerChange, absolutePath, 'Handler add');\n });\n\n handlerWatcher.on('change', (file) => {\n const absolutePath = path.join(absoluteHandlersDir, file);\n safeInvoke(onHandlerChange, absolutePath, 'Handler change');\n });\n\n handlerWatcher.on('unlink', (file) => {\n const absolutePath = path.join(absoluteHandlersDir, file);\n safeInvoke(onHandlerChange, absolutePath, 'Handler unlink');\n });\n\n handlerWatcher.on('error', (error) => {\n logger.error('[vite-plugin-open-api-server] Handler watcher error:', error);\n });\n\n // Track ready promise for this watcher\n readyPromises.push(\n new Promise<void>((resolve) => {\n handlerWatcher.on('ready', () => resolve());\n }),\n );\n\n watchers.push(handlerWatcher);\n }\n\n // Watch seeds directory\n if (seedsDir && onSeedChange) {\n const absoluteSeedsDir = path.resolve(cwd, seedsDir);\n const seedWatcher = watch(seedPattern, {\n cwd: absoluteSeedsDir,\n ignoreInitial: true,\n ignored: ['**/node_modules/**', '**/dist/**'],\n persistent: true,\n awaitWriteFinish: {\n stabilityThreshold: 100,\n pollInterval: 50,\n },\n });\n\n seedWatcher.on('add', (file) => {\n const absolutePath = path.join(absoluteSeedsDir, file);\n safeInvoke(onSeedChange, absolutePath, 'Seed add');\n });\n\n seedWatcher.on('change', (file) => {\n const absolutePath = path.join(absoluteSeedsDir, file);\n safeInvoke(onSeedChange, absolutePath, 'Seed change');\n });\n\n seedWatcher.on('unlink', (file) => {\n const absolutePath = path.join(absoluteSeedsDir, file);\n safeInvoke(onSeedChange, absolutePath, 'Seed unlink');\n });\n\n seedWatcher.on('error', (error) => {\n logger.error('[vite-plugin-open-api-server] Seed watcher error:', error);\n });\n\n // Track ready promise for this watcher\n readyPromises.push(\n new Promise<void>((resolve) => {\n seedWatcher.on('ready', () => resolve());\n }),\n );\n\n watchers.push(seedWatcher);\n }\n\n // Create combined ready promise\n const readyPromise = Promise.all(readyPromises).then(() => {});\n\n return {\n async close(): Promise<void> {\n isWatching = false;\n await Promise.all(watchers.map((w) => w.close()));\n },\n get isWatching(): boolean {\n return isWatching;\n },\n get ready(): Promise<void> {\n return readyPromise;\n },\n };\n}\n\n/**\n * Debounce a function with async execution guard\n *\n * Useful for preventing multiple rapid reloads when\n * multiple files change at once (e.g., during save all).\n *\n * This implementation prevents overlapping async executions:\n * - If the function is already running, the call is queued\n * - When the running function completes, it executes with the latest args\n * - Multiple calls during execution are coalesced into one\n *\n * @param fn - Function to debounce (can be sync or async)\n * @param delay - Debounce delay in milliseconds\n * @returns Debounced function\n */\nexport function debounce<T extends (...args: unknown[]) => unknown>(\n fn: T,\n delay: number,\n): (...args: Parameters<T>) => void {\n let timeoutId: ReturnType<typeof setTimeout> | null = null;\n let isRunning = false;\n let pendingArgs: Parameters<T> | null = null;\n\n const execute = async (...args: Parameters<T>): Promise<void> => {\n if (isRunning) {\n // Queue the latest args for execution after current run completes\n pendingArgs = args;\n return;\n }\n\n isRunning = true;\n try {\n // Wrap in try-catch to handle sync throws, then await for async rejections\n // This prevents both sync errors and async rejections from propagating\n try {\n await fn(...args);\n } catch {\n // Silently catch errors - the caller is responsible for error handling\n // This prevents unhandled rejections from breaking the debounce chain\n }\n } finally {\n isRunning = false;\n\n // If there were calls during execution, run with the latest args\n if (pendingArgs !== null) {\n const nextArgs = pendingArgs;\n pendingArgs = null;\n // Use setTimeout to avoid deep recursion\n setTimeout(() => execute(...nextArgs), 0);\n }\n }\n };\n\n return (...args: Parameters<T>): void => {\n if (timeoutId !== null) {\n clearTimeout(timeoutId);\n }\n timeoutId = setTimeout(() => {\n timeoutId = null;\n execute(...args);\n }, delay);\n };\n}\n","/**\n * Seed Loading\n *\n * What: Loads seed files from a directory using glob patterns\n * How: Uses Vite's ssrLoadModule to transform and load TypeScript files\n * Why: Enables users to define seed data for schemas in TypeScript\n *\n * @module seeds\n */\n\nimport path from 'node:path';\nimport type { AnySeedFn, Logger, SeedDefinition } from '@websublime/vite-plugin-open-api-core';\nimport fg from 'fast-glob';\nimport type { ViteDevServer } from 'vite';\nimport { directoryExists } from './utils.js';\n\n/**\n * Result of loading seeds\n */\nexport interface LoadSeedsResult {\n /** Map of schema name to seed function */\n seeds: Map<string, AnySeedFn>;\n /** Number of seed files loaded */\n fileCount: number;\n /** List of loaded file paths (relative) */\n files: string[];\n}\n\n/**\n * Load seeds from a directory\n *\n * Searches for seed files matching the pattern `*.seeds.{ts,js,mjs}`\n * in the specified directory. Each file should export an object with\n * schema name keys and seed functions as values.\n *\n * Uses Vite's ssrLoadModule to transform TypeScript files on-the-fly.\n *\n * @example\n * ```typescript\n * // mocks/seeds/pets.seeds.ts\n * import { defineSeeds } from '@websublime/vite-plugin-open-api-core';\n *\n * export default defineSeeds({\n * Pet: ({ seed, faker }) => {\n * return seed.count(10, () => ({\n * id: faker.number.int({ min: 1, max: 1000 }),\n * name: faker.animal.dog(),\n * status: faker.helpers.arrayElement(['available', 'pending', 'sold']),\n * }));\n * },\n * });\n * ```\n *\n * @param seedsDir - Directory to search for seed files\n * @param viteServer - Vite dev server instance for ssrLoadModule\n * @param cwd - Current working directory (defaults to process.cwd())\n * @param logger - Optional logger for warnings/errors\n * @returns Promise resolving to loaded seeds\n */\nexport async function loadSeeds(\n seedsDir: string,\n viteServer: ViteDevServer,\n cwd: string = process.cwd(),\n logger: Logger = console,\n): Promise<LoadSeedsResult> {\n const seeds = new Map<string, AnySeedFn>();\n const absoluteDir = path.resolve(cwd, seedsDir);\n\n // Check if directory exists\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return {\n seeds,\n fileCount: 0,\n files: [],\n };\n }\n\n // Find seed files (supports TypeScript via Vite's transform)\n const pattern = '**/*.seeds.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: false,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n // Load each file using Vite's ssrLoadModule\n for (const file of files) {\n const absolutePath = path.join(absoluteDir, file);\n const fileSeeds = await loadSeedFile(absolutePath, viteServer, logger);\n\n // Merge seeds\n for (const [schemaName, seedFn] of Object.entries(fileSeeds)) {\n if (seeds.has(schemaName)) {\n logger.warn(\n `[vite-plugin-open-api-server] Duplicate seed for schema \"${schemaName}\" in ${file}. Using last definition.`,\n );\n }\n seeds.set(schemaName, seedFn);\n }\n }\n\n return {\n seeds,\n fileCount: files.length,\n files,\n };\n}\n\n/**\n * Load a single seed file using Vite's ssrLoadModule\n *\n * @param filePath - Absolute path to the seed file\n * @param viteServer - Vite dev server instance\n * @param logger - Logger for warnings/errors\n * @returns Promise resolving to seed definition object\n */\nasync function loadSeedFile(\n filePath: string,\n viteServer: ViteDevServer,\n logger: Logger,\n): Promise<SeedDefinition> {\n try {\n // Invalidate module cache for hot reload\n const moduleNode = viteServer.moduleGraph.getModuleById(filePath);\n if (moduleNode) {\n viteServer.moduleGraph.invalidateModule(moduleNode);\n }\n\n // Use Vite's ssrLoadModule to transform and load the file\n // This handles TypeScript, ESM, and other transforms automatically\n const module = await viteServer.ssrLoadModule(filePath);\n\n // Support both default export and named export\n const seeds = module.default ?? module.seeds ?? module;\n\n // Validate seeds object\n if (!seeds || typeof seeds !== 'object') {\n logger.warn(\n `[vite-plugin-open-api-server] Invalid seed file ${filePath}: expected object export`,\n );\n return {};\n }\n\n // Filter to only seed functions\n const validSeeds: SeedDefinition = {};\n for (const [key, value] of Object.entries(seeds)) {\n if (typeof value === 'function') {\n validSeeds[key] = value as AnySeedFn;\n }\n }\n\n return validSeeds;\n } catch (error) {\n logger.error(\n `[vite-plugin-open-api-server] Failed to load seed file ${filePath}:`,\n error instanceof Error ? error.message : error,\n );\n return {};\n }\n}\n\n/**\n * Get list of seed files in a directory\n *\n * Useful for file watching setup.\n *\n * @param seedsDir - Directory to search\n * @param cwd - Current working directory\n * @returns Promise resolving to list of absolute file paths\n */\nexport async function getSeedFiles(\n seedsDir: string,\n cwd: string = process.cwd(),\n): Promise<string[]> {\n const absoluteDir = path.resolve(cwd, seedsDir);\n\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return [];\n }\n\n const pattern = '**/*.seeds.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: true,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n return files;\n}\n","/**\n * Vite Plugin Types\n *\n * What: Type definitions for the OpenAPI server Vite plugin\n * How: Defines configuration options, resolved types, and validation errors\n * Why: Provides type safety and documentation for plugin consumers\n *\n * @module types\n */\n\nimport type { Logger } from '@websublime/vite-plugin-open-api-core';\n\n// =============================================================================\n// Validation Error Codes (Appendix B)\n// =============================================================================\n\n/**\n * Error codes for configuration validation errors.\n *\n * Used across Tasks 1.2–1.4 for typed error handling.\n * Matches TECHNICAL-SPECIFICATION-V2.md Appendix B.\n */\nexport type ValidationErrorCode =\n | 'SPEC_ID_MISSING'\n | 'SPEC_ID_DUPLICATE'\n | 'PROXY_PATH_MISSING'\n | 'PROXY_PATH_TOO_BROAD'\n | 'PROXY_PATH_DUPLICATE'\n | 'PROXY_PATH_OVERLAP'\n | 'SPEC_NOT_FOUND'\n | 'SPECS_EMPTY';\n\n/**\n * Typed validation error for configuration issues.\n *\n * Thrown by resolveOptions() and validation functions in spec-id.ts\n * and proxy-path.ts. Consumers can catch and inspect the `code` field\n * for programmatic error handling.\n *\n * @example\n * ```typescript\n * try {\n * resolveOptions({ specs: [] });\n * } catch (error) {\n * if (error instanceof ValidationError && error.code === 'SPECS_EMPTY') {\n * // handle empty specs\n * }\n * }\n * ```\n */\nexport class ValidationError extends Error {\n readonly code: ValidationErrorCode;\n\n constructor(code: ValidationErrorCode, message: string) {\n super(message);\n this.name = 'ValidationError';\n this.code = code;\n }\n}\n\n// =============================================================================\n// Shared Type Aliases\n// =============================================================================\n\n/**\n * How a proxy path was determined.\n *\n * - `'explicit'` — set directly in SpecConfig.proxyPath\n * - `'auto'` — auto-derived from the OpenAPI document's servers[0].url\n *\n * Used by both DeriveProxyPathResult and ResolvedSpecConfig to ensure\n * the two sources of this value stay in sync.\n */\nexport type ProxyPathSource = 'auto' | 'explicit';\n\n// =============================================================================\n// User-Facing Configuration Types\n// =============================================================================\n\n/**\n * Configuration for a single OpenAPI spec instance\n *\n * @example\n * ```typescript\n * const petstore: SpecConfig = {\n * spec: './openapi/petstore.yaml',\n * id: 'petstore',\n * proxyPath: '/api/v3',\n * handlersDir: './mocks/petstore/handlers',\n * seedsDir: './mocks/petstore/seeds',\n * idFields: { Pet: 'petId' },\n * };\n * ```\n */\nexport interface SpecConfig {\n /**\n * Path to OpenAPI spec file (required)\n *\n * Supports: file paths, URLs, YAML, JSON\n *\n * @example './openapi/petstore.yaml'\n * @example 'https://petstore3.swagger.io/api/v3/openapi.json'\n */\n spec: string;\n\n /**\n * Unique identifier for this spec instance\n *\n * Used for routing, DevTools grouping, logging, default directory names.\n * If omitted, auto-derived from spec's info.title (slugified).\n *\n * @example 'petstore'\n */\n id?: string;\n\n /**\n * Base path for request proxy\n *\n * If omitted, auto-derived from spec's servers[0].url.\n * Must be unique across all specs.\n *\n * @example '/api/v3'\n */\n proxyPath?: string;\n\n /**\n * Directory containing handler files for this spec\n * @default './mocks/{specId}/handlers'\n */\n handlersDir?: string;\n\n /**\n * Directory containing seed files for this spec\n * @default './mocks/{specId}/seeds'\n */\n seedsDir?: string;\n\n /**\n * ID field configuration per schema for this spec\n * @default {} (uses 'id' for all schemas)\n */\n idFields?: Record<string, string>;\n}\n\n/**\n * Plugin configuration options\n *\n * @example\n * ```typescript\n * import { openApiServer } from '@websublime/vite-plugin-open-api-server';\n *\n * export default defineConfig({\n * plugins: [\n * openApiServer({\n * specs: [\n * { spec: './openapi/petstore.yaml' },\n * { spec: './openapi/inventory.yaml', id: 'inventory' },\n * ],\n * port: 4000,\n * }),\n * ],\n * });\n * ```\n */\nexport interface OpenApiServerOptions {\n /**\n * Array of OpenAPI spec configurations (required)\n * Each entry runs as an isolated instance.\n */\n specs: SpecConfig[];\n\n /**\n * Server port — all spec instances share this port\n * @default 4000\n */\n port?: number;\n\n /**\n * Enable/disable plugin\n * @default true\n */\n enabled?: boolean;\n\n /**\n * Maximum timeline events per spec\n * @default 500\n */\n timelineLimit?: number;\n\n /**\n * Enable DevTools integration\n * @default true\n */\n devtools?: boolean;\n\n /**\n * Enable CORS\n * @default true\n */\n cors?: boolean;\n\n /**\n * CORS origin configuration\n * @default '*'\n */\n corsOrigin?: string | string[];\n\n /**\n * Custom logger instance\n */\n logger?: Logger;\n\n /**\n * Suppress startup banner\n * @default false\n */\n silent?: boolean;\n}\n\n// =============================================================================\n// Internal Resolved Types\n// =============================================================================\n\n/**\n * Resolved spec config with all defaults applied\n *\n * Exported for advanced use cases (e.g., custom orchestrators or\n * test utilities that need to inspect resolved configuration).\n */\nexport interface ResolvedSpecConfig {\n spec: string;\n /** Guaranteed to be set after orchestrator resolution */\n id: string;\n /** Guaranteed to be set after orchestrator resolution */\n proxyPath: string;\n /**\n * How proxyPath was determined — used for banner display.\n *\n * Set during static option resolution. The orchestrator (Task 1.7)\n * will pass this to the multi-spec banner so it can show\n * \"(auto-derived)\" vs \"(explicit)\" next to each proxy path.\n */\n proxyPathSource: ProxyPathSource;\n handlersDir: string;\n seedsDir: string;\n idFields: Record<string, string>;\n}\n\n/**\n * Resolved options with defaults applied\n *\n * Exported for advanced use cases (e.g., custom orchestrators or\n * test utilities that need to inspect resolved configuration).\n */\nexport interface ResolvedOptions {\n specs: ResolvedSpecConfig[];\n port: number;\n enabled: boolean;\n timelineLimit: number;\n devtools: boolean;\n cors: boolean;\n corsOrigin: string | string[];\n silent: boolean;\n logger?: Logger;\n}\n\n// =============================================================================\n// Option Resolution\n// =============================================================================\n\n/**\n * Resolve options with defaults\n *\n * Note: spec ID and proxyPath resolution requires processing the OpenAPI document\n * first, so they are resolved later in the orchestrator.\n * This function only resolves static defaults.\n *\n * @param options - User-provided options\n * @returns Resolved options with all defaults applied\n * @throws {ValidationError} SPECS_EMPTY if specs array is missing or empty\n * @throws {ValidationError} SPEC_NOT_FOUND if a spec entry has empty spec field\n */\nfunction validateSpecs(specs: SpecConfig[]): void {\n if (!specs || !Array.isArray(specs) || specs.length === 0) {\n throw new ValidationError(\n 'SPECS_EMPTY',\n 'specs is required and must be a non-empty array of SpecConfig',\n );\n }\n\n for (let i = 0; i < specs.length; i++) {\n const spec = specs[i];\n if (!spec.spec || typeof spec.spec !== 'string' || spec.spec.trim() === '') {\n const identifier = spec.id ? ` (id: \"${spec.id}\")` : '';\n throw new ValidationError(\n 'SPEC_NOT_FOUND',\n `specs[${i}]${identifier}: spec field is required and must be a non-empty string (path or URL to OpenAPI spec)`,\n );\n }\n }\n}\n\nexport function resolveOptions(options: OpenApiServerOptions): ResolvedOptions {\n validateSpecs(options.specs);\n\n return {\n specs: options.specs.map((s) => ({\n spec: s.spec,\n // Placeholder — populated by orchestrator after document processing (Task 1.7)\n id: s.id ?? '',\n // Placeholder — populated by orchestrator after document processing (Task 1.7)\n proxyPath: s.proxyPath ?? '',\n // Preliminary — overwritten by deriveProxyPath() during orchestration (Task 1.7)\n proxyPathSource: s.proxyPath?.trim() ? 'explicit' : 'auto',\n handlersDir: s.handlersDir ?? '',\n seedsDir: s.seedsDir ?? '',\n idFields: s.idFields ?? {},\n })),\n port: options.port ?? 4000,\n enabled: options.enabled ?? true,\n timelineLimit: options.timelineLimit ?? 500,\n devtools: options.devtools ?? true,\n cors: options.cors ?? true,\n corsOrigin: options.corsOrigin ?? '*',\n silent: options.silent ?? false,\n logger: options.logger,\n };\n}\n","/**\n * Vite Plugin Implementation\n *\n * What: Main Vite plugin for OpenAPI mock server\n * How: Uses configureServer hook to start mock server and configure proxy\n * Why: Integrates OpenAPI mock server seamlessly into Vite dev workflow\n *\n * @module plugin\n */\n\nimport { existsSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport {\n createOpenApiServer,\n executeSeeds,\n type OpenApiServer,\n} from '@websublime/vite-plugin-open-api-core';\nimport type { Plugin, ViteDevServer } from 'vite';\nimport { extractBannerInfo, printBanner, printError, printReloadNotification } from './banner.js';\nimport { loadHandlers } from './handlers.js';\nimport { createFileWatcher, debounce, type FileWatcher } from './hot-reload.js';\nimport { loadSeeds } from './seeds.js';\nimport { type OpenApiServerOptions, resolveOptions } from './types.js';\n\n/**\n * Create the OpenAPI Server Vite plugin\n *\n * This plugin starts a mock server based on an OpenAPI specification\n * and configures Vite to proxy API requests to it.\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { defineConfig } from 'vite';\n * import vue from '@vitejs/plugin-vue';\n * import { openApiServer } from '@websublime/vite-plugin-open-api-server';\n *\n * export default defineConfig({\n * plugins: [\n * vue(),\n * openApiServer({\n * spec: './openapi/petstore.yaml',\n * port: 4000,\n * proxyPath: '/api',\n * handlersDir: './mocks/handlers',\n * seedsDir: './mocks/seeds',\n * }),\n * ],\n * });\n * ```\n *\n * @param options - Plugin configuration options\n * @returns Vite plugin\n */\n/**\n * Virtual module ID for the DevTools tab registration script.\n *\n * This script is served as a Vite module (not inline HTML) so that bare\n * import specifiers like `@vue/devtools-api` are resolved through Vite's\n * module pipeline. Inline `<script type=\"module\">` blocks in HTML are\n * executed directly by the browser, which cannot resolve bare specifiers.\n */\nconst VIRTUAL_DEVTOOLS_TAB_ID = 'virtual:open-api-devtools-tab';\nconst RESOLVED_VIRTUAL_DEVTOOLS_TAB_ID = `\\0${VIRTUAL_DEVTOOLS_TAB_ID}`;\n\nexport function openApiServer(options: OpenApiServerOptions): Plugin {\n const resolvedOptions = resolveOptions(options);\n\n // Server instance (created in configureServer)\n let server: OpenApiServer | null = null;\n\n // Vite dev server reference (needed for ssrLoadModule)\n let vite: ViteDevServer | null = null;\n\n // File watcher for hot reload\n let fileWatcher: FileWatcher | null = null;\n\n // Current working directory (set in configureServer)\n let cwd: string = process.cwd();\n\n return {\n name: 'vite-plugin-open-api-server',\n\n // Only active in dev mode\n apply: 'serve',\n\n /**\n * Ensure @vue/devtools-api is available for the DevTools tab module\n *\n * The virtual module imports from '@vue/devtools-api', which Vite needs\n * to pre-bundle so it can be resolved at runtime in the browser, even\n * though the host app may not have it as a direct dependency.\n */\n config() {\n if (!resolvedOptions.devtools || !resolvedOptions.enabled) {\n return;\n }\n\n // Only add to optimizeDeps if the package is actually resolvable\n // to avoid Vite warnings when the consumer hasn't installed it\n const require = createRequire(import.meta.url);\n try {\n require.resolve('@vue/devtools-api');\n } catch {\n return;\n }\n\n return {\n optimizeDeps: {\n include: ['@vue/devtools-api'],\n },\n };\n },\n\n /**\n * Resolve the virtual module for DevTools tab registration\n */\n resolveId(id: string) {\n if (id === VIRTUAL_DEVTOOLS_TAB_ID) {\n return RESOLVED_VIRTUAL_DEVTOOLS_TAB_ID;\n }\n },\n\n /**\n * Load the virtual module that registers the custom Vue DevTools tab\n *\n * This code is served as a proper Vite module, allowing bare import\n * specifiers to be resolved through Vite's dependency pre-bundling.\n */\n load(id: string) {\n if (id === RESOLVED_VIRTUAL_DEVTOOLS_TAB_ID) {\n return `\nimport { addCustomTab } from '@vue/devtools-api';\n\ntry {\n // Route through Vite's proxy so it works in all environments\n const iframeSrc = window.location.origin + '/_devtools/';\n\n addCustomTab({\n name: 'vite-plugin-open-api-server',\n title: 'OpenAPI Server',\n icon: 'https://api.iconify.design/carbon:api-1.svg?width=24&height=24&color=%2394a3b8',\n view: {\n type: 'iframe',\n src: iframeSrc,\n },\n category: 'app',\n });\n} catch (e) {\n // @vue/devtools-api not available - expected when the package is not installed\n}\n`;\n }\n },\n\n /**\n * Configure the Vite dev server\n *\n * This hook is called when the dev server is created.\n * We use it to:\n * 1. Start the OpenAPI mock server\n * 2. Configure the Vite proxy to forward API requests\n * 3. Set up file watching for hot reload\n */\n async configureServer(viteServer: ViteDevServer): Promise<void> {\n vite = viteServer;\n cwd = viteServer.config.root;\n\n // Check if plugin is disabled\n if (!resolvedOptions.enabled) {\n return;\n }\n\n try {\n // Load handlers from handlers directory (using Vite's ssrLoadModule for TS support)\n // @ts-expect-error TODO: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const handlersResult = await loadHandlers(resolvedOptions.handlersDir, viteServer, cwd);\n\n // Load seeds from seeds directory (using Vite's ssrLoadModule for TS support)\n // @ts-expect-error TODO: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const seedsResult = await loadSeeds(resolvedOptions.seedsDir, viteServer, cwd);\n\n // Resolve DevTools SPA directory (shipped inside this package's dist/)\n let devtoolsSpaDir: string | undefined;\n if (resolvedOptions.devtools) {\n const pluginDir = dirname(fileURLToPath(import.meta.url));\n const spaDir = join(pluginDir, 'devtools-spa');\n if (existsSync(spaDir)) {\n devtoolsSpaDir = spaDir;\n } else {\n resolvedOptions.logger?.warn?.(\n '[vite-plugin-open-api-server] DevTools SPA not found at',\n spaDir,\n '- serving placeholder. Run \"pnpm build\" to include the SPA.',\n );\n }\n }\n\n // Create the OpenAPI mock server\n // TODO: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n // Using 'as any' because v0.x plugin code references old single-spec shape\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n const opts = resolvedOptions as any;\n server = await createOpenApiServer({\n spec: opts.spec,\n port: opts.port,\n idFields: opts.idFields,\n handlers: handlersResult.handlers,\n // Seeds are populated via executeSeeds, not directly\n seeds: new Map(),\n timelineLimit: opts.timelineLimit,\n devtools: opts.devtools,\n devtoolsSpaDir,\n cors: opts.cors,\n corsOrigin: opts.corsOrigin,\n logger: opts.logger,\n });\n\n // Execute seeds to populate the store\n if (seedsResult.seeds.size > 0) {\n await executeSeeds(seedsResult.seeds, server.store, server.document);\n }\n\n // Start the mock server\n await server.start();\n\n // Configure Vite proxy\n // @ts-expect-error TODO: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n configureProxy(viteServer, resolvedOptions.proxyPath, resolvedOptions.port);\n\n // Print startup banner\n const bannerInfo = extractBannerInfo(\n server.registry,\n {\n info: {\n title: server.document.info?.title ?? 'OpenAPI Server',\n version: server.document.info?.version ?? '1.0.0',\n },\n },\n handlersResult.handlers.size,\n seedsResult.seeds.size,\n resolvedOptions,\n );\n printBanner(bannerInfo, resolvedOptions);\n\n // Set up file watching for hot reload\n await setupFileWatching();\n } catch (error) {\n printError('Failed to start OpenAPI mock server', error, resolvedOptions);\n throw error;\n }\n },\n\n /**\n * Clean up when Vite server closes\n */\n async closeBundle(): Promise<void> {\n await cleanup();\n },\n\n /**\n * Inject Vue DevTools custom tab registration script\n *\n * When devtools is enabled, this injects a script tag that loads the\n * virtual module for custom tab registration. Using a virtual module\n * (instead of an inline script) ensures that bare import specifiers\n * like `@vue/devtools-api` are resolved through Vite's module pipeline.\n */\n transformIndexHtml() {\n if (!resolvedOptions.devtools || !resolvedOptions.enabled) {\n return;\n }\n\n return [\n {\n tag: 'script',\n attrs: { type: 'module', src: `/@id/${VIRTUAL_DEVTOOLS_TAB_ID}` },\n injectTo: 'head' as const,\n },\n ];\n },\n };\n\n /**\n * Configure Vite proxy for API requests\n *\n * @param vite - Vite dev server\n * @param proxyPath - Base path to proxy\n * @param port - Mock server port\n */\n function configureProxy(vite: ViteDevServer, proxyPath: string, port: number): void {\n // Ensure server config exists (create mutable copy if needed)\n const serverConfig = vite.config.server ?? {};\n const proxyConfig = serverConfig.proxy ?? {};\n\n // Escape special regex characters in proxy path and pre-compile regex\n const escapedPath = proxyPath.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n const pathPrefixRegex = new RegExp(`^${escapedPath}`);\n\n // Add proxy configuration for API requests\n proxyConfig[proxyPath] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n // Remove the proxy path prefix when forwarding\n rewrite: (path: string) => path.replace(pathPrefixRegex, ''),\n };\n\n // Proxy internal routes so they work through Vite's dev server port\n proxyConfig['/_devtools'] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n };\n\n proxyConfig['/_api'] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n };\n\n proxyConfig['/_ws'] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n ws: true,\n };\n\n // Update the proxy config (Vite's proxy is mutable)\n if (vite.config.server) {\n vite.config.server.proxy = proxyConfig;\n }\n }\n\n /**\n * Set up file watching for hot reload\n */\n async function setupFileWatching(): Promise<void> {\n if (!server || !vite) return;\n\n // Debounce reload functions to prevent rapid-fire reloads\n const debouncedHandlerReload = debounce(reloadHandlers, 100);\n const debouncedSeedReload = debounce(reloadSeeds, 100);\n\n // TODO: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n const watchOpts = resolvedOptions as any;\n fileWatcher = await createFileWatcher({\n handlersDir: watchOpts.handlersDir,\n seedsDir: watchOpts.seedsDir,\n cwd,\n onHandlerChange: debouncedHandlerReload,\n onSeedChange: debouncedSeedReload,\n });\n }\n\n /**\n * Reload handlers when files change\n */\n async function reloadHandlers(): Promise<void> {\n if (!server || !vite) return;\n\n try {\n // TODO: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const handlersResult = await loadHandlers(\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n (resolvedOptions as any).handlersDir,\n vite,\n cwd,\n );\n server.updateHandlers(handlersResult.handlers);\n\n // Notify via WebSocket\n server.wsHub.broadcast({\n type: 'handlers:updated',\n data: { count: handlersResult.handlers.size },\n });\n\n printReloadNotification('handlers', handlersResult.handlers.size, resolvedOptions);\n } catch (error) {\n printError('Failed to reload handlers', error, resolvedOptions);\n }\n }\n\n /**\n * Reload seeds when files change\n *\n * Note: This operation is not fully atomic - there's a brief window between\n * clearing the store and repopulating it where requests may see empty data.\n * For development tooling, this tradeoff is acceptable.\n */\n async function reloadSeeds(): Promise<void> {\n if (!server || !vite) return;\n\n try {\n // Load seeds first (before clearing) to minimize the window where store is empty\n // TODO: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const seedsResult = await loadSeeds(\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n (resolvedOptions as any).seedsDir,\n vite,\n cwd,\n );\n\n // Only clear and repopulate if we successfully loaded seeds\n // This prevents clearing the store on load errors\n if (seedsResult.seeds.size > 0) {\n // Clear and immediately repopulate - minimizes empty window\n server.store.clearAll();\n await executeSeeds(seedsResult.seeds, server.store, server.document);\n } else {\n // User removed all seed files - clear the store\n server.store.clearAll();\n }\n\n // Notify via WebSocket\n server.wsHub.broadcast({\n type: 'seeds:updated',\n data: { count: seedsResult.seeds.size },\n });\n\n printReloadNotification('seeds', seedsResult.seeds.size, resolvedOptions);\n } catch (error) {\n printError('Failed to reload seeds', error, resolvedOptions);\n }\n }\n\n /**\n * Clean up resources\n */\n async function cleanup(): Promise<void> {\n // Close file watcher\n if (fileWatcher) {\n await fileWatcher.close();\n fileWatcher = null;\n }\n\n // Stop mock server\n if (server) {\n await server.stop();\n server = null;\n }\n\n vite = null;\n }\n}\n","/**\n * Spec ID Derivation\n *\n * What: Functions to derive and validate spec identifiers\n * How: Slugifies explicit IDs or auto-derives from OpenAPI info.title\n * Why: Each spec instance needs a unique, URL-safe identifier for routing,\n * DevTools grouping, logging, and default directory names\n *\n * @module spec-id\n */\n\nimport type { OpenAPIV3_1 } from '@scalar/openapi-types';\n\nimport { ValidationError } from './types.js';\n\n/**\n * Slugify a string for use as a spec identifier\n *\n * Rules:\n * - Lowercase\n * - Replace spaces and special chars with hyphens\n * - Remove consecutive hyphens\n * - Trim leading/trailing hyphens\n *\n * @example\n * slugify(\"Swagger Petstore\") → \"swagger-petstore\"\n * slugify(\"Billing API v2\") → \"billing-api-v2\"\n * slugify(\"café\") → \"cafe\"\n */\nexport function slugify(input: string): string {\n return input\n .normalize('NFD')\n .replace(/\\p{M}/gu, '')\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/-+/g, '-')\n .replace(/^-|-$/g, '');\n}\n\n/**\n * Derive a spec ID from the processed OpenAPI document\n *\n * Priority:\n * 1. Explicit id from config (if non-empty)\n * 2. Slugified info.title from the processed document\n *\n * @param explicitId - ID from SpecConfig.id (may be empty)\n * @param document - Processed OpenAPI document\n * @returns Stable, URL-safe spec identifier\n * @throws {ValidationError} SPEC_ID_MISSING if no ID can be derived (missing title and no explicit id)\n */\nexport function deriveSpecId(explicitId: string, document: OpenAPIV3_1.Document): string {\n if (explicitId.trim()) {\n const id = slugify(explicitId);\n if (!id) {\n throw new ValidationError(\n 'SPEC_ID_MISSING',\n `Cannot derive spec ID: explicit id \"${explicitId}\" produces an empty slug. ` +\n 'Please provide an id containing ASCII letters or numbers.',\n );\n }\n return id;\n }\n\n const title = document.info?.title;\n if (!title || !title.trim()) {\n throw new ValidationError(\n 'SPEC_ID_MISSING',\n 'Cannot derive spec ID: info.title is missing from the OpenAPI document. ' +\n 'Please set an explicit id in the spec configuration.',\n );\n }\n\n const id = slugify(title);\n if (!id) {\n throw new ValidationError(\n 'SPEC_ID_MISSING',\n `Cannot derive spec ID: info.title \"${title}\" produces an empty slug. ` +\n 'Please set an explicit id in the spec configuration.',\n );\n }\n\n return id;\n}\n\n/**\n * Validate spec IDs are unique across all specs\n *\n * Collects all duplicated IDs and reports them in a single error.\n *\n * @param ids - Array of resolved spec IDs\n * @throws {ValidationError} SPEC_ID_DUPLICATE if duplicate IDs found\n */\nexport function validateUniqueIds(ids: string[]): void {\n const seen = new Set<string>();\n const duplicates = new Set<string>();\n for (const id of ids) {\n if (seen.has(id)) {\n duplicates.add(id);\n }\n seen.add(id);\n }\n if (duplicates.size > 0) {\n const list = [...duplicates].join(', ');\n throw new ValidationError(\n 'SPEC_ID_DUPLICATE',\n `Duplicate spec IDs: ${list}. Each spec must have a unique ID. ` +\n 'Set explicit ids in spec configuration to resolve.',\n );\n }\n}\n","/**\n * Proxy Path Auto-Detection\n *\n * What: Functions to derive and validate proxy paths for spec instances\n * How: Extracts path from explicit config or auto-derives from servers[0].url\n * Why: Each spec instance needs a unique, non-overlapping proxy path for\n * Vite proxy configuration and request routing\n *\n * @module proxy-path\n */\n\nimport type { OpenAPIV3_1 } from '@scalar/openapi-types';\n\nimport type { ProxyPathSource } from './types.js';\nimport { ValidationError } from './types.js';\n\n// =============================================================================\n// Result Types\n// =============================================================================\n\n/**\n * Result of proxy path derivation\n *\n * Includes the normalized path and how it was determined,\n * so the startup banner can display \"(auto-derived)\" vs \"(explicit)\".\n */\nexport interface DeriveProxyPathResult {\n /** Normalized proxy path (e.g., \"/api/v3\") */\n proxyPath: string;\n /** How the path was determined */\n proxyPathSource: ProxyPathSource;\n}\n\n// =============================================================================\n// deriveProxyPath()\n// =============================================================================\n\n/**\n * Derive the proxy path from config or OpenAPI document's servers field\n *\n * Priority:\n * 1. Explicit proxyPath from config (if non-empty after trimming)\n * 2. Path portion of servers[0].url\n *\n * Full URLs (e.g., \"https://api.example.com/api/v3\") have their path\n * extracted via the URL constructor. Relative paths (e.g., \"/api/v3\")\n * are used directly.\n *\n * @param explicitPath - proxyPath from SpecConfig (may be empty)\n * @param document - Processed OpenAPI document\n * @param specId - Spec ID for error messages\n * @returns Normalized proxy path with source indication\n * @throws {ValidationError} PROXY_PATH_MISSING if path cannot be derived\n * @throws {ValidationError} PROXY_PATH_TOO_BROAD if path resolves to \"/\" (e.g., \"/\", \".\", \"..\")\n *\n * @example\n * // Explicit path\n * deriveProxyPath('/api/v3', document, 'petstore')\n * // → { proxyPath: '/api/v3', proxyPathSource: 'explicit' }\n *\n * @example\n * // Auto-derived from servers[0].url = \"https://api.example.com/api/v3\"\n * deriveProxyPath('', document, 'petstore')\n * // → { proxyPath: '/api/v3', proxyPathSource: 'auto' }\n */\nexport function deriveProxyPath(\n explicitPath: string,\n document: OpenAPIV3_1.Document,\n specId: string,\n): DeriveProxyPathResult {\n if (explicitPath.trim()) {\n return {\n proxyPath: normalizeProxyPath(explicitPath.trim(), specId),\n proxyPathSource: 'explicit',\n };\n }\n\n const servers = document.servers;\n const serverUrl = servers?.[0]?.url?.trim();\n if (!serverUrl) {\n throw new ValidationError(\n 'PROXY_PATH_MISSING',\n `[${specId}] Cannot derive proxyPath: no servers defined in the OpenAPI document. ` +\n 'Set an explicit proxyPath in the spec configuration.',\n );\n }\n\n let path: string;\n let parsedUrl: URL | undefined;\n\n try {\n parsedUrl = new URL(serverUrl);\n } catch {\n // Not a full URL — treat as relative path\n }\n\n if (parsedUrl) {\n try {\n // Decode percent-encoded characters (e.g., URL constructor encodes\n // OpenAPI template variable braces: /{version} → /%7Bversion%7D)\n path = decodeURIComponent(parsedUrl.pathname);\n } catch {\n // Malformed percent-encoding — fall back to the raw pathname\n path = parsedUrl.pathname;\n }\n } else {\n path = serverUrl;\n }\n\n return {\n proxyPath: normalizeProxyPath(path, specId),\n proxyPathSource: 'auto',\n };\n}\n\n// =============================================================================\n// normalizeProxyPath()\n// =============================================================================\n\n/**\n * Normalize and validate a proxy path\n *\n * Rules:\n * - Strip query strings and fragments\n * - Ensure leading slash\n * - Collapse consecutive slashes\n * - Resolve dot segments (\".\" and \"..\" per RFC 3986 §5.2.4)\n * - Remove trailing slash\n * - Reject \"/\" as too broad (would capture all requests, including dot-segments that resolve to \"/\")\n *\n * @param path - Raw path string to normalize\n * @param specId - Spec ID for error messages\n * @returns Normalized path (e.g., \"/api/v3\")\n * @throws {ValidationError} PROXY_PATH_TOO_BROAD if path resolves to \"/\" (e.g., \"/\", \".\", \"..\")\n *\n * @example\n * normalizeProxyPath('api/v3', 'petstore') → '/api/v3'\n * normalizeProxyPath('/api/v3/', 'petstore') → '/api/v3'\n */\nexport function normalizeProxyPath(path: string, specId: string): string {\n // Trim leading/trailing whitespace (e.g., \" /api/v3 \" → \"/api/v3\")\n path = path.trim();\n\n // Strip query string and fragment (e.g., \"/api/v3?debug=true#section\" → \"/api/v3\")\n const queryIdx = path.indexOf('?');\n const hashIdx = path.indexOf('#');\n const cutIdx = Math.min(\n queryIdx >= 0 ? queryIdx : path.length,\n hashIdx >= 0 ? hashIdx : path.length,\n );\n let normalized = path.slice(0, cutIdx);\n\n // Ensure leading slash\n normalized = normalized.startsWith('/') ? normalized : `/${normalized}`;\n\n // Collapse consecutive slashes (e.g., \"//api//v3\" → \"/api/v3\")\n normalized = normalized.replace(/\\/{2,}/g, '/');\n\n // Resolve dot segments per RFC 3986 §5.2.4 (e.g., \"/api/../v3\" → \"/v3\")\n // HTTP clients canonicalize these, so proxy paths must match the resolved form\n const segments = normalized.split('/');\n const resolved: string[] = [];\n for (const segment of segments) {\n if (segment === '.') {\n continue;\n }\n if (segment === '..') {\n // Don't pop beyond root\n if (resolved.length > 1) {\n resolved.pop();\n }\n continue;\n }\n resolved.push(segment);\n }\n normalized = resolved.join('/') || '/';\n\n // Remove trailing slash (but not if path is just \"/\")\n if (normalized.length > 1 && normalized.endsWith('/')) {\n normalized = normalized.slice(0, -1);\n }\n\n if (normalized === '/') {\n throw new ValidationError(\n 'PROXY_PATH_TOO_BROAD',\n `[${specId}] proxyPath \"/\" is too broad — it would capture all requests. ` +\n 'Set a more specific proxyPath (e.g., \"/api/v1\").',\n );\n }\n\n return normalized;\n}\n\n// =============================================================================\n// validateUniqueProxyPaths()\n// =============================================================================\n\n/**\n * Validate proxy paths are unique and non-overlapping\n *\n * Checks for:\n * 1. Duplicate paths — two specs with the same proxyPath\n * 2. Overlapping paths — one path is a prefix of another (e.g., \"/api\" and \"/api/v1\")\n * which would cause routing ambiguity\n *\n * @remarks\n * Entries with an empty or falsy `proxyPath` are silently skipped. These\n * represent specs whose proxy path has not yet been resolved (e.g., during\n * early option resolution before the OpenAPI document is processed). Callers\n * should expect unresolved entries to be excluded from uniqueness checks\n * rather than triggering false-positive PROXY_PATH_DUPLICATE or\n * PROXY_PATH_OVERLAP errors.\n *\n * @param specs - Array of spec entries with id and proxyPath.\n * Entries with empty/falsy proxyPath are skipped (unresolved).\n * @throws {ValidationError} PROXY_PATH_DUPLICATE if duplicate paths found\n * @throws {ValidationError} PROXY_PATH_OVERLAP if overlapping paths found\n *\n * @example\n * // Throws PROXY_PATH_DUPLICATE\n * validateUniqueProxyPaths([\n * { id: 'petstore', proxyPath: '/api/v3' },\n * { id: 'inventory', proxyPath: '/api/v3' },\n * ]);\n *\n * @example\n * // Throws PROXY_PATH_OVERLAP\n * validateUniqueProxyPaths([\n * { id: 'petstore', proxyPath: '/api' },\n * { id: 'inventory', proxyPath: '/api/v1' },\n * ]);\n */\nexport function validateUniqueProxyPaths(specs: Array<{ id: string; proxyPath: string }>): void {\n const paths = new Map<string, string>();\n\n for (const spec of specs) {\n // Skip entries with empty/whitespace-only proxyPath — they haven't been resolved yet\n const path = spec.proxyPath?.trim();\n if (!path) {\n continue;\n }\n\n if (paths.has(path)) {\n throw new ValidationError(\n 'PROXY_PATH_DUPLICATE',\n `Duplicate proxyPath \"${path}\" used by specs \"${paths.get(path)}\" ` +\n `and \"${spec.id}\". Each spec must have a unique proxyPath.`,\n );\n }\n paths.set(path, spec.id);\n }\n\n const sortedPaths = Array.from(paths.entries()).sort(([a], [b]) => a.length - b.length);\n for (let i = 0; i < sortedPaths.length; i++) {\n for (let j = i + 1; j < sortedPaths.length; j++) {\n const [shorter, shorterId] = sortedPaths[i];\n const [longer, longerId] = sortedPaths[j];\n if (longer.startsWith(`${shorter}/`)) {\n throw new ValidationError(\n 'PROXY_PATH_OVERLAP',\n `Overlapping proxyPaths: \"${shorter}\" (${shorterId}) is a prefix of ` +\n `\"${longer}\" (${longerId}). This would cause routing ambiguity.`,\n );\n }\n }\n }\n}\n","/**\n * Vue DevTools Integration\n *\n * What: Provides a function to register OpenAPI Server in Vue DevTools\n * How: Uses @vue/devtools-api to add a custom tab with iframe to DevTools SPA\n * Why: Enables debugging and inspection of the mock API server within Vue DevTools\n *\n * @module devtools\n */\n\nimport type { App } from 'vue';\n\n/**\n * Options for registering the DevTools plugin\n */\nexport interface RegisterDevToolsOptions {\n /**\n * The port where the OpenAPI server is running\n * @default 3000\n */\n port?: number;\n\n /**\n * The host where the OpenAPI server is running\n * @default 'localhost' (or derived from window.location.hostname if in browser)\n */\n host?: string;\n\n /**\n * The protocol to use for the DevTools URL\n * @default 'http' (or derived from window.location.protocol if in browser)\n */\n protocol?: 'http' | 'https';\n\n /**\n * Enable or disable DevTools registration\n * @default true\n */\n enabled?: boolean;\n\n /**\n * Custom label for the DevTools tab\n * @default 'OpenAPI Server'\n */\n label?: string;\n}\n\n/**\n * Register OpenAPI Server in Vue DevTools\n *\n * This function should be called in your Vue application's main entry point\n * to add a custom tab to Vue DevTools. The tab contains an iframe that loads\n * the OpenAPI Server DevTools SPA.\n *\n * @example\n * ```typescript\n * // In your main.ts or main.js\n * import { createApp } from 'vue';\n * import { registerDevTools } from '@websublime/vite-plugin-open-api-server';\n * import App from './App.vue';\n *\n * const app = createApp(App);\n *\n * // Register OpenAPI Server DevTools\n * if (import.meta.env.DEV) {\n * await registerDevTools(app, { port: 3000 });\n * }\n *\n * app.mount('#app');\n * ```\n *\n * @param app - Vue application instance\n * @param options - Configuration options\n */\nexport async function registerDevTools(\n app: App,\n options: RegisterDevToolsOptions = {},\n): Promise<void> {\n const { enabled = true, label = 'OpenAPI Server', port, host, protocol } = options;\n\n // Validate app parameter\n if (!app || typeof app !== 'object') {\n // biome-ignore lint/suspicious/noConsole: Intentional warning for invalid app instance\n console.warn('[OpenAPI DevTools] Invalid Vue app instance provided');\n return;\n }\n\n // Only register if enabled\n if (!enabled) {\n return;\n }\n\n // Check if running in browser environment\n if (typeof window === 'undefined') {\n return;\n }\n\n // Lazy import to avoid SSR issues\n try {\n const { addCustomTab } = await import('@vue/devtools-api');\n\n // Get the DevTools URL\n const devtoolsUrl = getDevToolsUrl(port, host, protocol);\n\n // Add custom tab with iframe to Vue DevTools\n addCustomTab({\n name: 'vite-plugin-open-api-server',\n title: label,\n icon: 'data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%234f46e5%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z%22/%3E%3Cpolyline points=%223.29 7 12 12 20.71 7%22/%3E%3Cline x1=%2212%22 y1=%2222%22 x2=%2212%22 y2=%2212%22/%3E%3C/svg%3E',\n view: {\n type: 'iframe',\n src: devtoolsUrl,\n },\n category: 'app',\n });\n } catch (error) {\n // Log warning but don't crash the app\n // DevTools integration is optional, so the app should continue working\n // biome-ignore lint/suspicious/noConsole: Intentional warning for registration failure\n console.warn('[OpenAPI DevTools] Failed to register with Vue DevTools:', error);\n }\n}\n\n/**\n * Get the DevTools URL for the given configuration\n *\n * When running in a browser, protocol and host are automatically derived from\n * window.location if not explicitly provided.\n *\n * @param port - Server port (default: 3000)\n * @param host - Server host (default: 'localhost' or window.location.hostname)\n * @param protocol - Protocol to use (default: 'http' or window.location.protocol)\n * @returns DevTools SPA URL\n */\nexport function getDevToolsUrl(port = 3000, host?: string, protocol?: 'http' | 'https'): string {\n // Derive defaults from browser environment if available\n const actualProtocol =\n protocol ||\n (typeof window !== 'undefined'\n ? (window.location.protocol.replace(':', '') as 'http' | 'https')\n : 'http');\n const actualHost =\n host || (typeof window !== 'undefined' ? window.location.hostname : 'localhost');\n\n return `${actualProtocol}://${actualHost}:${port}/_devtools/`;\n}\n"]}
1
+ {"version":3,"sources":["../src/banner.ts","../src/utils.ts","../src/handlers.ts","../src/hot-reload.ts","../src/seeds.ts","../src/types.ts","../src/plugin.ts","../src/spec-id.ts","../src/proxy-path.ts","../src/orchestrator.ts","../src/devtools.ts"],"names":["path","fg","require","vite","id","createOpenApiServer","executeSeeds","dirname","fileURLToPath","join","existsSync"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Startup Banner\n *\n * What: Prints a colorful startup banner with server information\n * How: Uses picocolors for ANSI color output\n * Why: Provides clear feedback about server status and configuration\n *\n * @module banner\n */\n\nimport type { EndpointRegistry } from '@websublime/vite-plugin-open-api-core';\nimport pc from 'picocolors';\nimport type { ResolvedOptions } from './types.js';\n\n/**\n * Banner configuration\n */\nexport interface BannerInfo {\n /** Server port */\n port: number;\n /** Proxy path in Vite */\n proxyPath: string;\n /** OpenAPI spec title */\n title: string;\n /** OpenAPI spec version */\n version: string;\n /** Number of endpoints */\n endpointCount: number;\n /** Number of loaded handlers */\n handlerCount: number;\n /** Number of loaded seeds */\n seedCount: number;\n /** DevTools enabled */\n devtools: boolean;\n}\n\n/**\n * Print the startup banner\n *\n * @param info - Banner information\n * @param options - Resolved plugin options\n */\nexport function printBanner(info: BannerInfo, options: ResolvedOptions): void {\n if (options.silent) {\n return;\n }\n\n const logger = options.logger ?? console;\n const log = (msg: string) => logger.info(msg);\n\n // Box drawing characters\n const BOX = {\n topLeft: '╭',\n topRight: '╮',\n bottomLeft: '╰',\n bottomRight: '╯',\n horizontal: '─',\n vertical: '│',\n };\n\n const width = 56;\n const horizontalLine = BOX.horizontal.repeat(width - 2);\n\n log('');\n log(pc.cyan(`${BOX.topLeft}${horizontalLine}${BOX.topRight}`));\n log(\n pc.cyan(BOX.vertical) + centerText('🚀 OpenAPI Mock Server', width - 2) + pc.cyan(BOX.vertical),\n );\n log(pc.cyan(`${BOX.bottomLeft}${horizontalLine}${BOX.bottomRight}`));\n log('');\n\n // API Info\n log(\n ` ${pc.bold(pc.white('API:'))} ${pc.green(info.title)} ${pc.dim(`v${info.version}`)}`,\n );\n log(` ${pc.bold(pc.white('Server:'))} ${pc.cyan(`http://localhost:${info.port}`)}`);\n log(\n ` ${pc.bold(pc.white('Proxy:'))} ${pc.yellow(info.proxyPath)} ${pc.dim('→')} ${pc.dim(`localhost:${info.port}`)}`,\n );\n log('');\n\n // Stats\n const stats = [\n { label: 'Endpoints', value: info.endpointCount, color: pc.blue },\n { label: 'Handlers', value: info.handlerCount, color: pc.green },\n { label: 'Seeds', value: info.seedCount, color: pc.magenta },\n ];\n\n const statsLine = stats\n .map((s) => `${pc.dim(`${s.label}:`)} ${s.color(String(s.value))}`)\n .join(pc.dim(' │ '));\n log(` ${statsLine}`);\n log('');\n\n // DevTools\n if (info.devtools) {\n log(\n ` ${pc.bold(pc.white('DevTools:'))} ${pc.cyan(`http://localhost:${info.port}/_devtools`)}`,\n );\n log(` ${pc.bold(pc.white('API Info:'))} ${pc.cyan(`http://localhost:${info.port}/_api`)}`);\n log('');\n }\n\n // Footer\n log(pc.dim(' Press Ctrl+C to stop the server'));\n log('');\n}\n\n/**\n * Center text within a given width\n *\n * @param text - Text to center\n * @param width - Total width\n * @returns Centered text with padding\n */\n// biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape codes require control characters\nconst ANSI_ESCAPE_REGEX = /\\x1b\\[[0-9;]*m/g;\n\nfunction centerText(text: string, width: number): string {\n // Account for ANSI codes - get visible length\n const visibleLength = text.replace(ANSI_ESCAPE_REGEX, '').length;\n const padding = Math.max(0, width - visibleLength);\n const leftPad = Math.floor(padding / 2);\n const rightPad = padding - leftPad;\n return ' '.repeat(leftPad) + text + ' '.repeat(rightPad);\n}\n\n/**\n * Extract banner info from server registry and document\n *\n * Note: This is the v0.x single-spec banner. It will be redesigned for\n * multi-spec display in Task 1.7 (vite-qq9.7). Currently only shows the\n * first spec's information.\n *\n * @param registry - Endpoint registry\n * @param document - OpenAPI document\n * @param handlerCount - Number of loaded handlers\n * @param seedCount - Number of loaded seed schemas\n * @param options - Resolved options (must contain at least one spec)\n * @returns Banner info\n */\nexport function extractBannerInfo(\n registry: EndpointRegistry,\n document: { info: { title: string; version: string } },\n handlerCount: number,\n seedCount: number,\n options: ResolvedOptions,\n): BannerInfo {\n return {\n port: options.port,\n proxyPath: options.specs[0]?.proxyPath || '(pending resolution)',\n title: document.info.title,\n version: document.info.version,\n endpointCount: registry.endpoints.size,\n handlerCount,\n seedCount,\n devtools: options.devtools,\n };\n}\n\n/**\n * Print a hot reload notification\n *\n * @param type - Type of reload ('handlers' | 'seeds')\n * @param count - Number of reloaded items\n * @param options - Resolved options\n */\nexport function printReloadNotification(\n type: 'handlers' | 'seeds',\n count: number,\n options: ResolvedOptions,\n): void {\n if (options.silent) {\n return;\n }\n\n const logger = options.logger ?? console;\n const icon = type === 'handlers' ? '🔄' : '🌱';\n const label = type === 'handlers' ? 'Handlers' : 'Seeds';\n const color = type === 'handlers' ? pc.green : pc.magenta;\n\n logger.info(` ${icon} ${color(label)} reloaded: ${pc.bold(String(count))} ${type}`);\n}\n\n/**\n * Print an error message\n *\n * @param message - Error message\n * @param error - Optional error object\n * @param options - Resolved options\n */\nexport function printError(message: string, error: unknown, options: ResolvedOptions): void {\n const logger = options.logger ?? console;\n logger.error(`${pc.red('✖')} ${pc.bold(pc.red('Error:'))} ${message}`);\n if (error instanceof Error) {\n logger.error(pc.dim(` ${error.message}`));\n }\n}\n\n/**\n * Print a warning message\n *\n * @param message - Warning message\n * @param options - Resolved options\n */\nexport function printWarning(message: string, options: ResolvedOptions): void {\n if (options.silent) {\n return;\n }\n\n const logger = options.logger ?? console;\n logger.warn(`${pc.yellow('⚠')} ${pc.yellow('Warning:')} ${message}`);\n}\n","/**\n * Filesystem Utilities\n *\n * What: Shared utility functions for filesystem operations\n * How: Uses Node.js fs/promises module with error handling\n * Why: Provides reusable utilities for handler and seed loading\n *\n * @module utils\n */\n\n/**\n * Check if a directory exists\n *\n * @param dirPath - Path to check\n * @returns Promise resolving to true if directory exists\n */\nexport async function directoryExists(dirPath: string): Promise<boolean> {\n try {\n const fs = await import('node:fs/promises');\n const stats = await fs.stat(dirPath);\n return stats.isDirectory();\n } catch {\n return false;\n }\n}\n","/**\n * Handler Loading\n *\n * What: Loads handler files from a directory using glob patterns\n * How: Uses Vite's ssrLoadModule to transform and load TypeScript files\n * Why: Enables users to define custom handlers for operationIds in TypeScript\n *\n * @module handlers\n */\n\nimport path from 'node:path';\nimport type { HandlerDefinition, HandlerFn, Logger } from '@websublime/vite-plugin-open-api-core';\nimport fg from 'fast-glob';\nimport type { ViteDevServer } from 'vite';\nimport { directoryExists } from './utils.js';\n\n/**\n * Result of loading handlers\n */\nexport interface LoadHandlersResult {\n /** Map of operationId to handler function */\n handlers: Map<string, HandlerFn>;\n /** Number of handler files loaded */\n fileCount: number;\n /** List of loaded file paths (relative) */\n files: string[];\n}\n\n/**\n * Load handlers from a directory\n *\n * Searches for handler files matching the pattern `*.handlers.{ts,js,mjs}`\n * in the specified directory. Each file should export an object with\n * operationId keys and handler functions as values.\n *\n * Uses Vite's ssrLoadModule to transform TypeScript files on-the-fly.\n *\n * @example\n * ```typescript\n * // mocks/handlers/pets.handlers.ts\n * import { defineHandlers } from '@websublime/vite-plugin-open-api-core';\n *\n * export default defineHandlers({\n * getPetById: async ({ req, store }) => {\n * const pet = store.get('Pet', req.params.petId);\n * return pet ?? { status: 404, data: { message: 'Pet not found' } };\n * },\n * });\n * ```\n *\n * @param handlersDir - Directory to search for handler files\n * @param viteServer - Vite dev server instance for ssrLoadModule\n * @param cwd - Current working directory (defaults to process.cwd())\n * @param logger - Optional logger for warnings/errors\n * @returns Promise resolving to loaded handlers\n */\nexport async function loadHandlers(\n handlersDir: string,\n viteServer: ViteDevServer,\n cwd: string = process.cwd(),\n logger: Logger = console,\n): Promise<LoadHandlersResult> {\n const handlers = new Map<string, HandlerFn>();\n const absoluteDir = path.resolve(cwd, handlersDir);\n\n // Check if directory exists\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return {\n handlers,\n fileCount: 0,\n files: [],\n };\n }\n\n // Find handler files (supports TypeScript via Vite's transform)\n const pattern = '**/*.handlers.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: false,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n // Load each file using Vite's ssrLoadModule\n for (const file of files) {\n const absolutePath = path.join(absoluteDir, file);\n const fileHandlers = await loadHandlerFile(absolutePath, viteServer, logger);\n\n // Merge handlers\n for (const [operationId, handler] of Object.entries(fileHandlers)) {\n if (handlers.has(operationId)) {\n logger.warn(\n `[vite-plugin-open-api-server] Duplicate handler for operationId \"${operationId}\" in ${file}. Using last definition.`,\n );\n }\n handlers.set(operationId, handler);\n }\n }\n\n return {\n handlers,\n fileCount: files.length,\n files,\n };\n}\n\n/**\n * Load a single handler file using Vite's ssrLoadModule\n *\n * @param filePath - Absolute path to the handler file\n * @param viteServer - Vite dev server instance\n * @param logger - Logger for warnings/errors\n * @returns Promise resolving to handler definition object\n */\nasync function loadHandlerFile(\n filePath: string,\n viteServer: ViteDevServer,\n logger: Logger,\n): Promise<HandlerDefinition> {\n try {\n // Invalidate module cache for hot reload\n const moduleNode = viteServer.moduleGraph.getModuleById(filePath);\n if (moduleNode) {\n viteServer.moduleGraph.invalidateModule(moduleNode);\n }\n\n // Use Vite's ssrLoadModule to transform and load the file\n // This handles TypeScript, ESM, and other transforms automatically\n const module = await viteServer.ssrLoadModule(filePath);\n\n // Support both default export and named export\n const handlers = module.default ?? module.handlers ?? module;\n\n // Validate handlers object\n if (!handlers || typeof handlers !== 'object') {\n logger.warn(\n `[vite-plugin-open-api-server] Invalid handler file ${filePath}: expected object export`,\n );\n return {};\n }\n\n // Filter to only handler functions\n const validHandlers: HandlerDefinition = {};\n for (const [key, value] of Object.entries(handlers)) {\n if (typeof value === 'function') {\n validHandlers[key] = value as HandlerFn;\n }\n }\n\n return validHandlers;\n } catch (error) {\n logger.error(\n `[vite-plugin-open-api-server] Failed to load handler file ${filePath}:`,\n error instanceof Error ? error.message : error,\n );\n return {};\n }\n}\n\n/**\n * Get list of handler files in a directory\n *\n * Useful for file watching setup.\n *\n * @param handlersDir - Directory to search\n * @param cwd - Current working directory\n * @returns Promise resolving to list of absolute file paths\n */\nexport async function getHandlerFiles(\n handlersDir: string,\n cwd: string = process.cwd(),\n): Promise<string[]> {\n const absoluteDir = path.resolve(cwd, handlersDir);\n\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return [];\n }\n\n const pattern = '**/*.handlers.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: true,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n return files;\n}\n","/**\n * Hot Reload\n *\n * What: File watcher for hot reloading handlers and seeds\n * How: Uses chokidar to watch for file changes\n * Why: Enables rapid development iteration without server restart\n *\n * @module hot-reload\n *\n * TODO: Full implementation in Task 3.3\n * This module provides placeholder/basic functionality for Task 3.1\n */\n\nimport path from 'node:path';\nimport type { Logger } from '@websublime/vite-plugin-open-api-core';\nimport type { FSWatcher } from 'chokidar';\n\n/**\n * File watcher configuration\n */\nexport interface FileWatcherOptions {\n /** Directory containing handler files */\n handlersDir?: string;\n /** Directory containing seed files */\n seedsDir?: string;\n /** Callback when a handler file changes */\n onHandlerChange?: (filePath: string) => Promise<void> | void;\n /** Callback when a seed file changes */\n onSeedChange?: (filePath: string) => Promise<void> | void;\n /** Current working directory */\n cwd?: string;\n /** Logger for error messages */\n logger?: Logger;\n}\n\n/**\n * File watcher instance\n */\nexport interface FileWatcher {\n /** Close the watcher and release resources */\n close(): Promise<void>;\n /** Check if watcher is active */\n readonly isWatching: boolean;\n /** Promise that resolves when all watchers are ready */\n readonly ready: Promise<void>;\n}\n\n/**\n * Create a file watcher for handlers and seeds\n *\n * Watches for changes to handler and seed files and invokes\n * callbacks when changes are detected. Supports add, change,\n * and unlink events.\n *\n * @example\n * ```typescript\n * const watcher = await createFileWatcher({\n * handlersDir: './mocks/handlers',\n * seedsDir: './mocks/seeds',\n * onHandlerChange: async (file) => {\n * console.log('Handler changed:', file);\n * const handlers = await loadHandlers('./mocks/handlers');\n * server.updateHandlers(handlers.handlers);\n * },\n * onSeedChange: async (file) => {\n * console.log('Seed changed:', file);\n * const seeds = await loadSeeds('./mocks/seeds');\n * // Re-execute seeds...\n * },\n * });\n *\n * // Later, clean up\n * await watcher.close();\n * ```\n *\n * @param options - Watcher configuration\n * @returns Promise resolving to file watcher instance\n */\nexport async function createFileWatcher(options: FileWatcherOptions): Promise<FileWatcher> {\n const {\n handlersDir,\n seedsDir,\n onHandlerChange,\n onSeedChange,\n cwd = process.cwd(),\n logger = console,\n } = options;\n\n // Dynamic import chokidar to avoid bundling issues\n const { watch } = await import('chokidar');\n\n const watchers: FSWatcher[] = [];\n const readyPromises: Promise<void>[] = [];\n let isWatching = true;\n\n // Handler file patterns\n const handlerPattern = '**/*.handlers.{ts,js,mjs}';\n const seedPattern = '**/*.seeds.{ts,js,mjs}';\n\n /**\n * Wrapper to safely invoke async callbacks and log errors\n * Prevents unhandled promise rejections from file watcher events\n */\n const safeInvoke = (\n callback: (filePath: string) => Promise<void> | void,\n filePath: string,\n context: string,\n ): void => {\n Promise.resolve()\n .then(() => callback(filePath))\n .catch((error) => {\n logger.error(\n `[vite-plugin-open-api-server] ${context} callback error for ${filePath}:`,\n error,\n );\n });\n };\n\n // Watch handlers directory\n if (handlersDir && onHandlerChange) {\n const absoluteHandlersDir = path.resolve(cwd, handlersDir);\n const handlerWatcher = watch(handlerPattern, {\n cwd: absoluteHandlersDir,\n ignoreInitial: true,\n ignored: ['**/node_modules/**', '**/dist/**'],\n persistent: true,\n awaitWriteFinish: {\n stabilityThreshold: 100,\n pollInterval: 50,\n },\n });\n\n handlerWatcher.on('add', (file) => {\n const absolutePath = path.join(absoluteHandlersDir, file);\n safeInvoke(onHandlerChange, absolutePath, 'Handler add');\n });\n\n handlerWatcher.on('change', (file) => {\n const absolutePath = path.join(absoluteHandlersDir, file);\n safeInvoke(onHandlerChange, absolutePath, 'Handler change');\n });\n\n handlerWatcher.on('unlink', (file) => {\n const absolutePath = path.join(absoluteHandlersDir, file);\n safeInvoke(onHandlerChange, absolutePath, 'Handler unlink');\n });\n\n handlerWatcher.on('error', (error) => {\n logger.error('[vite-plugin-open-api-server] Handler watcher error:', error);\n });\n\n // Track ready promise for this watcher\n readyPromises.push(\n new Promise<void>((resolve) => {\n handlerWatcher.on('ready', () => resolve());\n }),\n );\n\n watchers.push(handlerWatcher);\n }\n\n // Watch seeds directory\n if (seedsDir && onSeedChange) {\n const absoluteSeedsDir = path.resolve(cwd, seedsDir);\n const seedWatcher = watch(seedPattern, {\n cwd: absoluteSeedsDir,\n ignoreInitial: true,\n ignored: ['**/node_modules/**', '**/dist/**'],\n persistent: true,\n awaitWriteFinish: {\n stabilityThreshold: 100,\n pollInterval: 50,\n },\n });\n\n seedWatcher.on('add', (file) => {\n const absolutePath = path.join(absoluteSeedsDir, file);\n safeInvoke(onSeedChange, absolutePath, 'Seed add');\n });\n\n seedWatcher.on('change', (file) => {\n const absolutePath = path.join(absoluteSeedsDir, file);\n safeInvoke(onSeedChange, absolutePath, 'Seed change');\n });\n\n seedWatcher.on('unlink', (file) => {\n const absolutePath = path.join(absoluteSeedsDir, file);\n safeInvoke(onSeedChange, absolutePath, 'Seed unlink');\n });\n\n seedWatcher.on('error', (error) => {\n logger.error('[vite-plugin-open-api-server] Seed watcher error:', error);\n });\n\n // Track ready promise for this watcher\n readyPromises.push(\n new Promise<void>((resolve) => {\n seedWatcher.on('ready', () => resolve());\n }),\n );\n\n watchers.push(seedWatcher);\n }\n\n // Create combined ready promise\n const readyPromise = Promise.all(readyPromises).then(() => {});\n\n return {\n async close(): Promise<void> {\n isWatching = false;\n await Promise.all(watchers.map((w) => w.close()));\n },\n get isWatching(): boolean {\n return isWatching;\n },\n get ready(): Promise<void> {\n return readyPromise;\n },\n };\n}\n\n/**\n * Debounce a function with async execution guard\n *\n * Useful for preventing multiple rapid reloads when\n * multiple files change at once (e.g., during save all).\n *\n * This implementation prevents overlapping async executions:\n * - If the function is already running, the call is queued\n * - When the running function completes, it executes with the latest args\n * - Multiple calls during execution are coalesced into one\n *\n * @param fn - Function to debounce (can be sync or async)\n * @param delay - Debounce delay in milliseconds\n * @returns Debounced function\n */\nexport function debounce<T extends (...args: unknown[]) => unknown>(\n fn: T,\n delay: number,\n): (...args: Parameters<T>) => void {\n let timeoutId: ReturnType<typeof setTimeout> | null = null;\n let isRunning = false;\n let pendingArgs: Parameters<T> | null = null;\n\n const execute = async (...args: Parameters<T>): Promise<void> => {\n if (isRunning) {\n // Queue the latest args for execution after current run completes\n pendingArgs = args;\n return;\n }\n\n isRunning = true;\n try {\n // Wrap in try-catch to handle sync throws, then await for async rejections\n // This prevents both sync errors and async rejections from propagating\n try {\n await fn(...args);\n } catch {\n // Silently catch errors - the caller is responsible for error handling\n // This prevents unhandled rejections from breaking the debounce chain\n }\n } finally {\n isRunning = false;\n\n // If there were calls during execution, run with the latest args\n if (pendingArgs !== null) {\n const nextArgs = pendingArgs;\n pendingArgs = null;\n // Use setTimeout to avoid deep recursion\n setTimeout(() => execute(...nextArgs), 0);\n }\n }\n };\n\n return (...args: Parameters<T>): void => {\n if (timeoutId !== null) {\n clearTimeout(timeoutId);\n }\n timeoutId = setTimeout(() => {\n timeoutId = null;\n execute(...args);\n }, delay);\n };\n}\n","/**\n * Seed Loading\n *\n * What: Loads seed files from a directory using glob patterns\n * How: Uses Vite's ssrLoadModule to transform and load TypeScript files\n * Why: Enables users to define seed data for schemas in TypeScript\n *\n * @module seeds\n */\n\nimport path from 'node:path';\nimport type { AnySeedFn, Logger, SeedDefinition } from '@websublime/vite-plugin-open-api-core';\nimport fg from 'fast-glob';\nimport type { ViteDevServer } from 'vite';\nimport { directoryExists } from './utils.js';\n\n/**\n * Result of loading seeds\n */\nexport interface LoadSeedsResult {\n /** Map of schema name to seed function */\n seeds: Map<string, AnySeedFn>;\n /** Number of seed files loaded */\n fileCount: number;\n /** List of loaded file paths (relative) */\n files: string[];\n}\n\n/**\n * Load seeds from a directory\n *\n * Searches for seed files matching the pattern `*.seeds.{ts,js,mjs}`\n * in the specified directory. Each file should export an object with\n * schema name keys and seed functions as values.\n *\n * Uses Vite's ssrLoadModule to transform TypeScript files on-the-fly.\n *\n * @example\n * ```typescript\n * // mocks/seeds/pets.seeds.ts\n * import { defineSeeds } from '@websublime/vite-plugin-open-api-core';\n *\n * export default defineSeeds({\n * Pet: ({ seed, faker }) => {\n * return seed.count(10, () => ({\n * id: faker.number.int({ min: 1, max: 1000 }),\n * name: faker.animal.dog(),\n * status: faker.helpers.arrayElement(['available', 'pending', 'sold']),\n * }));\n * },\n * });\n * ```\n *\n * @param seedsDir - Directory to search for seed files\n * @param viteServer - Vite dev server instance for ssrLoadModule\n * @param cwd - Current working directory (defaults to process.cwd())\n * @param logger - Optional logger for warnings/errors\n * @returns Promise resolving to loaded seeds\n */\nexport async function loadSeeds(\n seedsDir: string,\n viteServer: ViteDevServer,\n cwd: string = process.cwd(),\n logger: Logger = console,\n): Promise<LoadSeedsResult> {\n const seeds = new Map<string, AnySeedFn>();\n const absoluteDir = path.resolve(cwd, seedsDir);\n\n // Check if directory exists\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return {\n seeds,\n fileCount: 0,\n files: [],\n };\n }\n\n // Find seed files (supports TypeScript via Vite's transform)\n const pattern = '**/*.seeds.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: false,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n // Load each file using Vite's ssrLoadModule\n for (const file of files) {\n const absolutePath = path.join(absoluteDir, file);\n const fileSeeds = await loadSeedFile(absolutePath, viteServer, logger);\n\n // Merge seeds\n for (const [schemaName, seedFn] of Object.entries(fileSeeds)) {\n if (seeds.has(schemaName)) {\n logger.warn(\n `[vite-plugin-open-api-server] Duplicate seed for schema \"${schemaName}\" in ${file}. Using last definition.`,\n );\n }\n seeds.set(schemaName, seedFn);\n }\n }\n\n return {\n seeds,\n fileCount: files.length,\n files,\n };\n}\n\n/**\n * Load a single seed file using Vite's ssrLoadModule\n *\n * @param filePath - Absolute path to the seed file\n * @param viteServer - Vite dev server instance\n * @param logger - Logger for warnings/errors\n * @returns Promise resolving to seed definition object\n */\nasync function loadSeedFile(\n filePath: string,\n viteServer: ViteDevServer,\n logger: Logger,\n): Promise<SeedDefinition> {\n try {\n // Invalidate module cache for hot reload\n const moduleNode = viteServer.moduleGraph.getModuleById(filePath);\n if (moduleNode) {\n viteServer.moduleGraph.invalidateModule(moduleNode);\n }\n\n // Use Vite's ssrLoadModule to transform and load the file\n // This handles TypeScript, ESM, and other transforms automatically\n const module = await viteServer.ssrLoadModule(filePath);\n\n // Support both default export and named export\n const seeds = module.default ?? module.seeds ?? module;\n\n // Validate seeds object\n if (!seeds || typeof seeds !== 'object') {\n logger.warn(\n `[vite-plugin-open-api-server] Invalid seed file ${filePath}: expected object export`,\n );\n return {};\n }\n\n // Filter to only seed functions\n const validSeeds: SeedDefinition = {};\n for (const [key, value] of Object.entries(seeds)) {\n if (typeof value === 'function') {\n validSeeds[key] = value as AnySeedFn;\n }\n }\n\n return validSeeds;\n } catch (error) {\n logger.error(\n `[vite-plugin-open-api-server] Failed to load seed file ${filePath}:`,\n error instanceof Error ? error.message : error,\n );\n return {};\n }\n}\n\n/**\n * Get list of seed files in a directory\n *\n * Useful for file watching setup.\n *\n * @param seedsDir - Directory to search\n * @param cwd - Current working directory\n * @returns Promise resolving to list of absolute file paths\n */\nexport async function getSeedFiles(\n seedsDir: string,\n cwd: string = process.cwd(),\n): Promise<string[]> {\n const absoluteDir = path.resolve(cwd, seedsDir);\n\n const dirExists = await directoryExists(absoluteDir);\n if (!dirExists) {\n return [];\n }\n\n const pattern = '**/*.seeds.{ts,js,mjs}';\n const files = await fg(pattern, {\n cwd: absoluteDir,\n absolute: true,\n onlyFiles: true,\n ignore: ['node_modules/**', 'dist/**'],\n });\n\n return files;\n}\n","/**\n * Vite Plugin Types\n *\n * What: Type definitions for the OpenAPI server Vite plugin\n * How: Defines configuration options, resolved types, and validation errors\n * Why: Provides type safety and documentation for plugin consumers\n *\n * @module types\n */\n\nimport type { Logger } from '@websublime/vite-plugin-open-api-core';\n\n// =============================================================================\n// Validation Error Codes (Appendix B)\n// =============================================================================\n\n/**\n * Error codes for configuration validation errors.\n *\n * Used across Tasks 1.2–1.4 for typed error handling.\n * Matches TECHNICAL-SPECIFICATION-V2.md Appendix B.\n */\nexport type ValidationErrorCode =\n | 'SPEC_ID_MISSING'\n | 'SPEC_ID_DUPLICATE'\n | 'PROXY_PATH_MISSING'\n | 'PROXY_PATH_TOO_BROAD'\n | 'PROXY_PATH_DUPLICATE'\n | 'PROXY_PATH_OVERLAP'\n | 'SPEC_NOT_FOUND'\n | 'SPECS_EMPTY';\n\n/**\n * Typed validation error for configuration issues.\n *\n * Thrown by resolveOptions() and validation functions in spec-id.ts\n * and proxy-path.ts. Consumers can catch and inspect the `code` field\n * for programmatic error handling.\n *\n * @example\n * ```typescript\n * try {\n * resolveOptions({ specs: [] });\n * } catch (error) {\n * if (error instanceof ValidationError && error.code === 'SPECS_EMPTY') {\n * // handle empty specs\n * }\n * }\n * ```\n */\nexport class ValidationError extends Error {\n readonly code: ValidationErrorCode;\n\n constructor(code: ValidationErrorCode, message: string) {\n super(message);\n this.name = 'ValidationError';\n this.code = code;\n }\n}\n\n// =============================================================================\n// Shared Type Aliases\n// =============================================================================\n\n/**\n * How a proxy path was determined.\n *\n * - `'explicit'` — set directly in SpecConfig.proxyPath\n * - `'auto'` — auto-derived from the OpenAPI document's servers[0].url\n *\n * Used by both DeriveProxyPathResult and ResolvedSpecConfig to ensure\n * the two sources of this value stay in sync.\n */\nexport type ProxyPathSource = 'auto' | 'explicit';\n\n// =============================================================================\n// User-Facing Configuration Types\n// =============================================================================\n\n/**\n * Configuration for a single OpenAPI spec instance\n *\n * @example\n * ```typescript\n * const petstore: SpecConfig = {\n * spec: './openapi/petstore.yaml',\n * id: 'petstore',\n * proxyPath: '/api/v3',\n * handlersDir: './mocks/petstore/handlers',\n * seedsDir: './mocks/petstore/seeds',\n * idFields: { Pet: 'petId' },\n * };\n * ```\n */\nexport interface SpecConfig {\n /**\n * Path to OpenAPI spec file (required)\n *\n * Supports: file paths, URLs, YAML, JSON\n *\n * @example './openapi/petstore.yaml'\n * @example 'https://petstore3.swagger.io/api/v3/openapi.json'\n */\n spec: string;\n\n /**\n * Unique identifier for this spec instance\n *\n * Used for routing, DevTools grouping, logging, default directory names.\n * If omitted, auto-derived from spec's info.title (slugified).\n *\n * @example 'petstore'\n */\n id?: string;\n\n /**\n * Base path for request proxy\n *\n * If omitted, auto-derived from spec's servers[0].url.\n * Must be unique across all specs.\n *\n * @example '/api/v3'\n */\n proxyPath?: string;\n\n /**\n * Directory containing handler files for this spec\n * @default './mocks/{specId}/handlers'\n */\n handlersDir?: string;\n\n /**\n * Directory containing seed files for this spec\n * @default './mocks/{specId}/seeds'\n */\n seedsDir?: string;\n\n /**\n * ID field configuration per schema for this spec\n * @default {} (uses 'id' for all schemas)\n */\n idFields?: Record<string, string>;\n}\n\n/**\n * Plugin configuration options\n *\n * @example\n * ```typescript\n * import { openApiServer } from '@websublime/vite-plugin-open-api-server';\n *\n * export default defineConfig({\n * plugins: [\n * openApiServer({\n * specs: [\n * { spec: './openapi/petstore.yaml' },\n * { spec: './openapi/inventory.yaml', id: 'inventory' },\n * ],\n * port: 4000,\n * }),\n * ],\n * });\n * ```\n */\nexport interface OpenApiServerOptions {\n /**\n * Array of OpenAPI spec configurations (required)\n * Each entry runs as an isolated instance.\n */\n specs: SpecConfig[];\n\n /**\n * Server port — all spec instances share this port\n * @default 4000\n */\n port?: number;\n\n /**\n * Enable/disable plugin\n * @default true\n */\n enabled?: boolean;\n\n /**\n * Maximum timeline events per spec\n * @default 500\n */\n timelineLimit?: number;\n\n /**\n * Enable DevTools integration\n * @default true\n */\n devtools?: boolean;\n\n /**\n * Enable CORS\n * @default true\n */\n cors?: boolean;\n\n /**\n * CORS origin configuration\n * @default '*'\n */\n corsOrigin?: string | string[];\n\n /**\n * Custom logger instance\n */\n logger?: Logger;\n\n /**\n * Suppress startup banner\n * @default false\n */\n silent?: boolean;\n}\n\n// =============================================================================\n// Internal Resolved Types\n// =============================================================================\n\n/**\n * Resolved spec config with all defaults applied\n *\n * Exported for advanced use cases (e.g., custom orchestrators or\n * test utilities that need to inspect resolved configuration).\n */\nexport interface ResolvedSpecConfig {\n spec: string;\n /** Empty string until orchestrator resolution; guaranteed non-empty after `createOrchestrator()` */\n id: string;\n /** Empty string until orchestrator resolution; guaranteed non-empty after `createOrchestrator()` */\n proxyPath: string;\n /**\n * How proxyPath was determined — used for banner display.\n *\n * Written back by the orchestrator after document processing.\n * Used by the startup banner to display `(auto-derived)` vs\n * `(explicit)` next to each proxy path.\n */\n proxyPathSource: ProxyPathSource;\n handlersDir: string;\n seedsDir: string;\n idFields: Record<string, string>;\n}\n\n/**\n * Resolved options with defaults applied\n *\n * Exported for advanced use cases (e.g., custom orchestrators or\n * test utilities that need to inspect resolved configuration).\n */\nexport interface ResolvedOptions {\n specs: ResolvedSpecConfig[];\n port: number;\n enabled: boolean;\n timelineLimit: number;\n devtools: boolean;\n cors: boolean;\n corsOrigin: string | string[];\n silent: boolean;\n logger?: Logger;\n}\n\n// =============================================================================\n// Option Resolution\n// =============================================================================\n\n/**\n * Validate that specs array is non-empty and each entry has a valid spec field.\n *\n * @param specs - Array of spec configurations to validate\n * @throws {ValidationError} SPECS_EMPTY if specs array is missing or empty\n * @throws {ValidationError} SPEC_NOT_FOUND if a spec entry has empty spec field\n */\nexport function validateSpecs(specs: SpecConfig[]): void {\n if (!specs || !Array.isArray(specs) || specs.length === 0) {\n throw new ValidationError(\n 'SPECS_EMPTY',\n 'specs is required and must be a non-empty array of SpecConfig',\n );\n }\n\n for (let i = 0; i < specs.length; i++) {\n const spec = specs[i];\n if (!spec.spec || typeof spec.spec !== 'string' || spec.spec.trim() === '') {\n const identifier = spec.id ? ` (id: \"${spec.id}\")` : '';\n throw new ValidationError(\n 'SPEC_NOT_FOUND',\n `specs[${i}]${identifier}: spec field is required and must be a non-empty string (path or URL to OpenAPI spec)`,\n );\n }\n }\n}\n\n/**\n * Resolve options with defaults.\n *\n * Note: spec ID and proxyPath resolution requires processing the OpenAPI document\n * first, so they are resolved later in the orchestrator.\n * This function only resolves static defaults.\n *\n * @param options - User-provided options\n * @returns Resolved options with all defaults applied\n */\nexport function resolveOptions(options: OpenApiServerOptions): ResolvedOptions {\n validateSpecs(options.specs);\n\n return {\n specs: options.specs.map((s) => ({\n spec: s.spec,\n // Placeholder — populated by orchestrator after document processing\n id: s.id ?? '',\n // Placeholder — populated by orchestrator after document processing\n proxyPath: s.proxyPath ?? '',\n // Preliminary — overwritten by deriveProxyPath() during orchestration\n proxyPathSource: s.proxyPath?.trim() ? 'explicit' : 'auto',\n handlersDir: s.handlersDir ?? '',\n seedsDir: s.seedsDir ?? '',\n idFields: s.idFields ?? {},\n })),\n port: options.port ?? 4000,\n enabled: options.enabled ?? true,\n timelineLimit: options.timelineLimit ?? 500,\n devtools: options.devtools ?? true,\n cors: options.cors ?? true,\n corsOrigin: options.corsOrigin ?? '*',\n silent: options.silent ?? false,\n logger: options.logger,\n };\n}\n","/**\n * Vite Plugin Implementation\n *\n * What: Main Vite plugin for OpenAPI mock server\n * How: Uses configureServer hook to start mock server and configure proxy\n * Why: Integrates OpenAPI mock server seamlessly into Vite dev workflow\n *\n * @module plugin\n */\n\nimport { existsSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport {\n createOpenApiServer,\n executeSeeds,\n type OpenApiServer,\n} from '@websublime/vite-plugin-open-api-core';\nimport type { Plugin, ViteDevServer } from 'vite';\nimport { extractBannerInfo, printBanner, printError, printReloadNotification } from './banner.js';\nimport { loadHandlers } from './handlers.js';\nimport { createFileWatcher, debounce, type FileWatcher } from './hot-reload.js';\nimport { loadSeeds } from './seeds.js';\nimport { type OpenApiServerOptions, resolveOptions } from './types.js';\n\n/**\n * Create the OpenAPI Server Vite plugin\n *\n * This plugin starts a mock server based on an OpenAPI specification\n * and configures Vite to proxy API requests to it.\n *\n * @example\n * ```typescript\n * // vite.config.ts\n * import { defineConfig } from 'vite';\n * import vue from '@vitejs/plugin-vue';\n * import { openApiServer } from '@websublime/vite-plugin-open-api-server';\n *\n * export default defineConfig({\n * plugins: [\n * vue(),\n * openApiServer({\n * spec: './openapi/petstore.yaml',\n * port: 4000,\n * proxyPath: '/api',\n * handlersDir: './mocks/handlers',\n * seedsDir: './mocks/seeds',\n * }),\n * ],\n * });\n * ```\n *\n * @param options - Plugin configuration options\n * @returns Vite plugin\n */\n/**\n * Virtual module ID for the DevTools tab registration script.\n *\n * This script is served as a Vite module (not inline HTML) so that bare\n * import specifiers like `@vue/devtools-api` are resolved through Vite's\n * module pipeline. Inline `<script type=\"module\">` blocks in HTML are\n * executed directly by the browser, which cannot resolve bare specifiers.\n */\nconst VIRTUAL_DEVTOOLS_TAB_ID = 'virtual:open-api-devtools-tab';\nconst RESOLVED_VIRTUAL_DEVTOOLS_TAB_ID = `\\0${VIRTUAL_DEVTOOLS_TAB_ID}`;\n\nexport function openApiServer(options: OpenApiServerOptions): Plugin {\n const resolvedOptions = resolveOptions(options);\n\n // Server instance (created in configureServer)\n let server: OpenApiServer | null = null;\n\n // Vite dev server reference (needed for ssrLoadModule)\n let vite: ViteDevServer | null = null;\n\n // File watcher for hot reload\n let fileWatcher: FileWatcher | null = null;\n\n // Current working directory (set in configureServer)\n let cwd: string = process.cwd();\n\n return {\n name: 'vite-plugin-open-api-server',\n\n // Only active in dev mode\n apply: 'serve',\n\n /**\n * Ensure @vue/devtools-api is available for the DevTools tab module\n *\n * The virtual module imports from '@vue/devtools-api', which Vite needs\n * to pre-bundle so it can be resolved at runtime in the browser, even\n * though the host app may not have it as a direct dependency.\n */\n config() {\n if (!resolvedOptions.devtools || !resolvedOptions.enabled) {\n return;\n }\n\n // Only add to optimizeDeps if the package is actually resolvable\n // to avoid Vite warnings when the consumer hasn't installed it\n const require = createRequire(import.meta.url);\n try {\n require.resolve('@vue/devtools-api');\n } catch {\n return;\n }\n\n return {\n optimizeDeps: {\n include: ['@vue/devtools-api'],\n },\n };\n },\n\n /**\n * Resolve the virtual module for DevTools tab registration\n */\n resolveId(id: string) {\n if (id === VIRTUAL_DEVTOOLS_TAB_ID) {\n return RESOLVED_VIRTUAL_DEVTOOLS_TAB_ID;\n }\n },\n\n /**\n * Load the virtual module that registers the custom Vue DevTools tab\n *\n * This code is served as a proper Vite module, allowing bare import\n * specifiers to be resolved through Vite's dependency pre-bundling.\n */\n load(id: string) {\n if (id === RESOLVED_VIRTUAL_DEVTOOLS_TAB_ID) {\n return `\nimport { addCustomTab } from '@vue/devtools-api';\n\ntry {\n // Route through Vite's proxy so it works in all environments\n const iframeSrc = window.location.origin + '/_devtools/';\n\n addCustomTab({\n name: 'vite-plugin-open-api-server',\n title: 'OpenAPI Server',\n icon: 'https://api.iconify.design/carbon:api-1.svg?width=24&height=24&color=%2394a3b8',\n view: {\n type: 'iframe',\n src: iframeSrc,\n },\n category: 'app',\n });\n} catch (e) {\n // @vue/devtools-api not available - expected when the package is not installed\n}\n`;\n }\n },\n\n /**\n * Configure the Vite dev server\n *\n * This hook is called when the dev server is created.\n * We use it to:\n * 1. Start the OpenAPI mock server\n * 2. Configure the Vite proxy to forward API requests\n * 3. Set up file watching for hot reload\n */\n async configureServer(viteServer: ViteDevServer): Promise<void> {\n vite = viteServer;\n cwd = viteServer.config.root;\n\n // Check if plugin is disabled\n if (!resolvedOptions.enabled) {\n return;\n }\n\n try {\n // Load handlers from handlers directory (using Vite's ssrLoadModule for TS support)\n // @ts-expect-error NOTE: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const handlersResult = await loadHandlers(resolvedOptions.handlersDir, viteServer, cwd);\n\n // Load seeds from seeds directory (using Vite's ssrLoadModule for TS support)\n // @ts-expect-error NOTE: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const seedsResult = await loadSeeds(resolvedOptions.seedsDir, viteServer, cwd);\n\n // Resolve DevTools SPA directory (shipped inside this package's dist/)\n let devtoolsSpaDir: string | undefined;\n if (resolvedOptions.devtools) {\n const pluginDir = dirname(fileURLToPath(import.meta.url));\n const spaDir = join(pluginDir, 'devtools-spa');\n if (existsSync(spaDir)) {\n devtoolsSpaDir = spaDir;\n } else {\n resolvedOptions.logger?.warn?.(\n '[vite-plugin-open-api-server] DevTools SPA not found at',\n spaDir,\n '- serving placeholder. Run \"pnpm build\" to include the SPA.',\n );\n }\n }\n\n // Create the OpenAPI mock server\n // NOTE: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n // Using 'as any' because v0.x plugin code references old single-spec shape\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n const opts = resolvedOptions as any;\n server = await createOpenApiServer({\n spec: opts.spec,\n port: opts.port,\n idFields: opts.idFields,\n handlers: handlersResult.handlers,\n // Seeds are populated via executeSeeds, not directly\n seeds: new Map(),\n timelineLimit: opts.timelineLimit,\n devtools: opts.devtools,\n devtoolsSpaDir,\n cors: opts.cors,\n corsOrigin: opts.corsOrigin,\n logger: opts.logger,\n });\n\n // Execute seeds to populate the store\n if (seedsResult.seeds.size > 0) {\n await executeSeeds(seedsResult.seeds, server.store, server.document);\n }\n\n // Start the mock server\n await server.start();\n\n // Configure Vite proxy\n // @ts-expect-error NOTE: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n configureProxy(viteServer, resolvedOptions.proxyPath, resolvedOptions.port);\n\n // Print startup banner\n const bannerInfo = extractBannerInfo(\n server.registry,\n {\n info: {\n title: server.document.info?.title ?? 'OpenAPI Server',\n version: server.document.info?.version ?? '1.0.0',\n },\n },\n handlersResult.handlers.size,\n seedsResult.seeds.size,\n resolvedOptions,\n );\n printBanner(bannerInfo, resolvedOptions);\n\n // Set up file watching for hot reload\n await setupFileWatching();\n } catch (error) {\n printError('Failed to start OpenAPI mock server', error, resolvedOptions);\n throw error;\n }\n },\n\n /**\n * Clean up when Vite server closes\n */\n async closeBundle(): Promise<void> {\n await cleanup();\n },\n\n /**\n * Inject Vue DevTools custom tab registration script\n *\n * When devtools is enabled, this injects a script tag that loads the\n * virtual module for custom tab registration. Using a virtual module\n * (instead of an inline script) ensures that bare import specifiers\n * like `@vue/devtools-api` are resolved through Vite's module pipeline.\n */\n transformIndexHtml() {\n if (!resolvedOptions.devtools || !resolvedOptions.enabled) {\n return;\n }\n\n return [\n {\n tag: 'script',\n attrs: { type: 'module', src: `/@id/${VIRTUAL_DEVTOOLS_TAB_ID}` },\n injectTo: 'head' as const,\n },\n ];\n },\n };\n\n /**\n * Configure Vite proxy for API requests\n *\n * @param vite - Vite dev server\n * @param proxyPath - Base path to proxy\n * @param port - Mock server port\n */\n function configureProxy(vite: ViteDevServer, proxyPath: string, port: number): void {\n // Ensure server config exists (create mutable copy if needed)\n const serverConfig = vite.config.server ?? {};\n const proxyConfig = serverConfig.proxy ?? {};\n\n // Escape special regex characters in proxy path and pre-compile regex\n const escapedPath = proxyPath.replace(/[.*+?^${}()|[\\]\\\\]/g, '\\\\$&');\n const pathPrefixRegex = new RegExp(`^${escapedPath}`);\n\n // Add proxy configuration for API requests\n proxyConfig[proxyPath] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n // Remove the proxy path prefix when forwarding\n rewrite: (path: string) => path.replace(pathPrefixRegex, ''),\n };\n\n // Proxy internal routes so they work through Vite's dev server port\n proxyConfig['/_devtools'] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n };\n\n proxyConfig['/_api'] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n };\n\n proxyConfig['/_ws'] = {\n target: `http://localhost:${port}`,\n changeOrigin: true,\n ws: true,\n };\n\n // Update the proxy config (Vite's proxy is mutable)\n if (vite.config.server) {\n vite.config.server.proxy = proxyConfig;\n }\n }\n\n /**\n * Set up file watching for hot reload\n */\n async function setupFileWatching(): Promise<void> {\n if (!server || !vite) return;\n\n // Debounce reload functions to prevent rapid-fire reloads\n const debouncedHandlerReload = debounce(reloadHandlers, 100);\n const debouncedSeedReload = debounce(reloadSeeds, 100);\n\n // NOTE: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n const watchOpts = resolvedOptions as any;\n fileWatcher = await createFileWatcher({\n handlersDir: watchOpts.handlersDir,\n seedsDir: watchOpts.seedsDir,\n cwd,\n onHandlerChange: debouncedHandlerReload,\n onSeedChange: debouncedSeedReload,\n });\n }\n\n /**\n * Reload handlers when files change\n */\n async function reloadHandlers(): Promise<void> {\n if (!server || !vite) return;\n\n try {\n // NOTE: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const handlersResult = await loadHandlers(\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n (resolvedOptions as any).handlersDir,\n vite,\n cwd,\n );\n server.updateHandlers(handlersResult.handlers);\n\n // Notify via WebSocket\n server.wsHub.broadcast({\n type: 'handlers:updated',\n data: { count: handlersResult.handlers.size },\n });\n\n printReloadNotification('handlers', handlersResult.handlers.size, resolvedOptions);\n } catch (error) {\n printError('Failed to reload handlers', error, resolvedOptions);\n }\n }\n\n /**\n * Reload seeds when files change\n *\n * Note: This operation is not fully atomic - there's a brief window between\n * clearing the store and repopulating it where requests may see empty data.\n * For development tooling, this tradeoff is acceptable.\n */\n async function reloadSeeds(): Promise<void> {\n if (!server || !vite) return;\n\n try {\n // Load seeds first (before clearing) to minimize the window where store is empty\n // NOTE: plugin.ts will be rewritten in Task 1.7 (vite-qq9.7)\n const seedsResult = await loadSeeds(\n // biome-ignore lint/suspicious/noExplicitAny: v0.x compat — plugin.ts rewritten in Task 1.7\n (resolvedOptions as any).seedsDir,\n vite,\n cwd,\n );\n\n // Only clear and repopulate if we successfully loaded seeds\n // This prevents clearing the store on load errors\n if (seedsResult.seeds.size > 0) {\n // Clear and immediately repopulate - minimizes empty window\n server.store.clearAll();\n await executeSeeds(seedsResult.seeds, server.store, server.document);\n } else {\n // User removed all seed files - clear the store\n server.store.clearAll();\n }\n\n // Notify via WebSocket\n server.wsHub.broadcast({\n type: 'seeds:updated',\n data: { count: seedsResult.seeds.size },\n });\n\n printReloadNotification('seeds', seedsResult.seeds.size, resolvedOptions);\n } catch (error) {\n printError('Failed to reload seeds', error, resolvedOptions);\n }\n }\n\n /**\n * Clean up resources\n */\n async function cleanup(): Promise<void> {\n // Close file watcher\n if (fileWatcher) {\n await fileWatcher.close();\n fileWatcher = null;\n }\n\n // Stop mock server\n if (server) {\n await server.stop();\n server = null;\n }\n\n vite = null;\n }\n}\n","/**\n * Spec ID Derivation\n *\n * What: Functions to derive and validate spec identifiers\n * How: Slugifies explicit IDs or auto-derives from OpenAPI info.title\n * Why: Each spec instance needs a unique, URL-safe identifier for routing,\n * DevTools grouping, logging, and default directory names\n *\n * @module spec-id\n */\n\nimport type { OpenAPIV3_1 } from '@scalar/openapi-types';\n\nimport { ValidationError } from './types.js';\n\n/**\n * Slugify a string for use as a spec identifier\n *\n * Rules:\n * - Lowercase\n * - Replace spaces and special chars with hyphens\n * - Remove consecutive hyphens\n * - Trim leading/trailing hyphens\n *\n * @example\n * slugify(\"Swagger Petstore\") → \"swagger-petstore\"\n * slugify(\"Billing API v2\") → \"billing-api-v2\"\n * slugify(\"café\") → \"cafe\"\n */\nexport function slugify(input: string): string {\n return input\n .normalize('NFD')\n .replace(/\\p{M}/gu, '')\n .toLowerCase()\n .replace(/[^a-z0-9]+/g, '-')\n .replace(/-+/g, '-')\n .replace(/^-|-$/g, '');\n}\n\n/**\n * Derive a spec ID from the processed OpenAPI document\n *\n * Priority:\n * 1. Explicit id from config (if non-empty)\n * 2. Slugified info.title from the processed document\n *\n * @param explicitId - ID from SpecConfig.id (may be empty)\n * @param document - Processed OpenAPI document\n * @returns Stable, URL-safe spec identifier\n * @throws {ValidationError} SPEC_ID_MISSING if no ID can be derived (missing title and no explicit id)\n */\nexport function deriveSpecId(explicitId: string, document: OpenAPIV3_1.Document): string {\n if (explicitId.trim()) {\n const id = slugify(explicitId);\n if (!id) {\n throw new ValidationError(\n 'SPEC_ID_MISSING',\n `Cannot derive spec ID: explicit id \"${explicitId}\" produces an empty slug. ` +\n 'Please provide an id containing ASCII letters or numbers.',\n );\n }\n return id;\n }\n\n const title = document.info?.title;\n if (!title || !title.trim()) {\n throw new ValidationError(\n 'SPEC_ID_MISSING',\n 'Cannot derive spec ID: info.title is missing from the OpenAPI document. ' +\n 'Please set an explicit id in the spec configuration.',\n );\n }\n\n const id = slugify(title);\n if (!id) {\n throw new ValidationError(\n 'SPEC_ID_MISSING',\n `Cannot derive spec ID: info.title \"${title}\" produces an empty slug. ` +\n 'Please set an explicit id in the spec configuration.',\n );\n }\n\n return id;\n}\n\n/**\n * Validate spec IDs are unique across all specs\n *\n * Collects all duplicated IDs and reports them in a single error.\n *\n * @param ids - Array of resolved spec IDs\n * @throws {ValidationError} SPEC_ID_DUPLICATE if duplicate IDs found\n */\nexport function validateUniqueIds(ids: string[]): void {\n const seen = new Set<string>();\n const duplicates = new Set<string>();\n for (const id of ids) {\n if (seen.has(id)) {\n duplicates.add(id);\n }\n seen.add(id);\n }\n if (duplicates.size > 0) {\n const list = [...duplicates].join(', ');\n throw new ValidationError(\n 'SPEC_ID_DUPLICATE',\n `Duplicate spec IDs: ${list}. Each spec must have a unique ID. ` +\n 'Set explicit ids in spec configuration to resolve.',\n );\n }\n}\n","/**\n * Proxy Path Auto-Detection\n *\n * What: Functions to derive and validate proxy paths for spec instances\n * How: Extracts path from explicit config or auto-derives from servers[0].url\n * Why: Each spec instance needs a unique, non-overlapping proxy path for\n * Vite proxy configuration and request routing\n *\n * @module proxy-path\n */\n\nimport type { OpenAPIV3_1 } from '@scalar/openapi-types';\n\nimport type { ProxyPathSource } from './types.js';\nimport { ValidationError } from './types.js';\n\n// =============================================================================\n// Result Types\n// =============================================================================\n\n/**\n * Result of proxy path derivation\n *\n * Includes the normalized path and how it was determined,\n * so the startup banner can display \"(auto-derived)\" vs \"(explicit)\".\n */\nexport interface DeriveProxyPathResult {\n /** Normalized proxy path (e.g., \"/api/v3\") */\n proxyPath: string;\n /** How the path was determined */\n proxyPathSource: ProxyPathSource;\n}\n\n// =============================================================================\n// deriveProxyPath()\n// =============================================================================\n\n/**\n * Derive the proxy path from config or OpenAPI document's servers field\n *\n * Priority:\n * 1. Explicit proxyPath from config (if non-empty after trimming)\n * 2. Path portion of servers[0].url\n *\n * Full URLs (e.g., \"https://api.example.com/api/v3\") have their path\n * extracted via the URL constructor. Relative paths (e.g., \"/api/v3\")\n * are used directly.\n *\n * @param explicitPath - proxyPath from SpecConfig (may be empty)\n * @param document - Processed OpenAPI document\n * @param specId - Spec ID for error messages\n * @returns Normalized proxy path with source indication\n * @throws {ValidationError} PROXY_PATH_MISSING if path cannot be derived\n * @throws {ValidationError} PROXY_PATH_TOO_BROAD if path resolves to \"/\" (e.g., \"/\", \".\", \"..\")\n *\n * @example\n * // Explicit path\n * deriveProxyPath('/api/v3', document, 'petstore')\n * // → { proxyPath: '/api/v3', proxyPathSource: 'explicit' }\n *\n * @example\n * // Auto-derived from servers[0].url = \"https://api.example.com/api/v3\"\n * deriveProxyPath('', document, 'petstore')\n * // → { proxyPath: '/api/v3', proxyPathSource: 'auto' }\n */\nexport function deriveProxyPath(\n explicitPath: string,\n document: OpenAPIV3_1.Document,\n specId: string,\n): DeriveProxyPathResult {\n if (explicitPath.trim()) {\n return {\n proxyPath: normalizeProxyPath(explicitPath.trim(), specId),\n proxyPathSource: 'explicit',\n };\n }\n\n const servers = document.servers;\n const serverUrl = servers?.[0]?.url?.trim();\n if (!serverUrl) {\n throw new ValidationError(\n 'PROXY_PATH_MISSING',\n `[${specId}] Cannot derive proxyPath: no servers defined in the OpenAPI document. ` +\n 'Set an explicit proxyPath in the spec configuration.',\n );\n }\n\n let path: string;\n let parsedUrl: URL | undefined;\n\n try {\n parsedUrl = new URL(serverUrl);\n } catch {\n // Not a full URL — treat as relative path\n }\n\n if (parsedUrl) {\n try {\n // Decode percent-encoded characters (e.g., URL constructor encodes\n // OpenAPI template variable braces: /{version} → /%7Bversion%7D)\n path = decodeURIComponent(parsedUrl.pathname);\n } catch {\n // Malformed percent-encoding — fall back to the raw pathname\n path = parsedUrl.pathname;\n }\n } else {\n path = serverUrl;\n }\n\n return {\n proxyPath: normalizeProxyPath(path, specId),\n proxyPathSource: 'auto',\n };\n}\n\n// =============================================================================\n// normalizeProxyPath()\n// =============================================================================\n\n/**\n * Normalize and validate a proxy path\n *\n * Rules:\n * - Strip query strings and fragments\n * - Ensure leading slash\n * - Collapse consecutive slashes\n * - Resolve dot segments (\".\" and \"..\" per RFC 3986 §5.2.4)\n * - Remove trailing slash\n * - Reject \"/\" as too broad (would capture all requests, including dot-segments that resolve to \"/\")\n *\n * @param path - Raw path string to normalize\n * @param specId - Spec ID for error messages\n * @returns Normalized path (e.g., \"/api/v3\")\n * @throws {ValidationError} PROXY_PATH_TOO_BROAD if path resolves to \"/\" (e.g., \"/\", \".\", \"..\")\n *\n * @example\n * normalizeProxyPath('api/v3', 'petstore') → '/api/v3'\n * normalizeProxyPath('/api/v3/', 'petstore') → '/api/v3'\n */\nexport function normalizeProxyPath(path: string, specId: string): string {\n // Trim leading/trailing whitespace (e.g., \" /api/v3 \" → \"/api/v3\")\n path = path.trim();\n\n // Strip query string and fragment (e.g., \"/api/v3?debug=true#section\" → \"/api/v3\")\n const queryIdx = path.indexOf('?');\n const hashIdx = path.indexOf('#');\n const cutIdx = Math.min(\n queryIdx >= 0 ? queryIdx : path.length,\n hashIdx >= 0 ? hashIdx : path.length,\n );\n let normalized = path.slice(0, cutIdx);\n\n // Ensure leading slash\n normalized = normalized.startsWith('/') ? normalized : `/${normalized}`;\n\n // Collapse consecutive slashes (e.g., \"//api//v3\" → \"/api/v3\")\n normalized = normalized.replace(/\\/{2,}/g, '/');\n\n // Resolve dot segments per RFC 3986 §5.2.4 (e.g., \"/api/../v3\" → \"/v3\")\n // HTTP clients canonicalize these, so proxy paths must match the resolved form\n const segments = normalized.split('/');\n const resolved: string[] = [];\n for (const segment of segments) {\n if (segment === '.') {\n continue;\n }\n if (segment === '..') {\n // Don't pop beyond root\n if (resolved.length > 1) {\n resolved.pop();\n }\n continue;\n }\n resolved.push(segment);\n }\n normalized = resolved.join('/') || '/';\n\n // Remove trailing slash (but not if path is just \"/\")\n if (normalized.length > 1 && normalized.endsWith('/')) {\n normalized = normalized.slice(0, -1);\n }\n\n if (normalized === '/') {\n throw new ValidationError(\n 'PROXY_PATH_TOO_BROAD',\n `[${specId}] proxyPath \"/\" is too broad — it would capture all requests. ` +\n 'Set a more specific proxyPath (e.g., \"/api/v1\").',\n );\n }\n\n return normalized;\n}\n\n// =============================================================================\n// validateUniqueProxyPaths()\n// =============================================================================\n\n/**\n * Validate proxy paths are unique and non-overlapping\n *\n * Checks for:\n * 1. Duplicate paths — two specs with the same proxyPath\n * 2. Overlapping paths — one path is a prefix of another (e.g., \"/api\" and \"/api/v1\")\n * which would cause routing ambiguity\n *\n * @remarks\n * Entries with an empty or falsy `proxyPath` are silently skipped. These\n * represent specs whose proxy path has not yet been resolved (e.g., during\n * early option resolution before the OpenAPI document is processed). Callers\n * should expect unresolved entries to be excluded from uniqueness checks\n * rather than triggering false-positive PROXY_PATH_DUPLICATE or\n * PROXY_PATH_OVERLAP errors.\n *\n * @param specs - Array of spec entries with id and proxyPath.\n * Entries with empty/falsy proxyPath are skipped (unresolved).\n * @throws {ValidationError} PROXY_PATH_DUPLICATE if duplicate paths found\n * @throws {ValidationError} PROXY_PATH_OVERLAP if overlapping paths found\n *\n * @example\n * // Throws PROXY_PATH_DUPLICATE\n * validateUniqueProxyPaths([\n * { id: 'petstore', proxyPath: '/api/v3' },\n * { id: 'inventory', proxyPath: '/api/v3' },\n * ]);\n *\n * @example\n * // Throws PROXY_PATH_OVERLAP\n * validateUniqueProxyPaths([\n * { id: 'petstore', proxyPath: '/api' },\n * { id: 'inventory', proxyPath: '/api/v1' },\n * ]);\n */\nexport function validateUniqueProxyPaths(specs: Array<{ id: string; proxyPath: string }>): void {\n const paths = new Map<string, string>();\n\n for (const spec of specs) {\n // Skip entries with empty/whitespace-only proxyPath — they haven't been resolved yet\n const path = spec.proxyPath?.trim();\n if (!path) {\n continue;\n }\n\n if (paths.has(path)) {\n throw new ValidationError(\n 'PROXY_PATH_DUPLICATE',\n `Duplicate proxyPath \"${path}\" used by specs \"${paths.get(path)}\" ` +\n `and \"${spec.id}\". Each spec must have a unique proxyPath.`,\n );\n }\n paths.set(path, spec.id);\n }\n\n const sortedPaths = Array.from(paths.entries()).sort(([a], [b]) => a.length - b.length);\n for (let i = 0; i < sortedPaths.length; i++) {\n for (let j = i + 1; j < sortedPaths.length; j++) {\n const [shorter, shorterId] = sortedPaths[i];\n const [longer, longerId] = sortedPaths[j];\n if (longer.startsWith(`${shorter}/`)) {\n throw new ValidationError(\n 'PROXY_PATH_OVERLAP',\n `Overlapping proxyPaths: \"${shorter}\" (${shorterId}) is a prefix of ` +\n `\"${longer}\" (${longerId}). This would cause routing ambiguity.`,\n );\n }\n }\n }\n}\n","/**\n * Multi-Spec Orchestrator\n *\n * What: Central orchestrator that creates N spec instances and mounts them on a single Hono app\n * How: Three phases — process specs, validate uniqueness, build main Hono app with dispatch middleware\n * Why: Enables multiple OpenAPI specs to run on a single server with isolated stores and handlers\n *\n * @module orchestrator\n */\n\nimport { existsSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport {\n createOpenApiServer,\n executeSeeds,\n type Logger,\n mountDevToolsRoutes,\n mountInternalApi,\n type OpenApiServer,\n type SpecInfo,\n} from '@websublime/vite-plugin-open-api-core';\nimport { type Context, Hono } from 'hono';\nimport { cors } from 'hono/cors';\nimport type { ViteDevServer } from 'vite';\n\nimport { loadHandlers } from './handlers.js';\nimport { deriveProxyPath, validateUniqueProxyPaths } from './proxy-path.js';\nimport { loadSeeds } from './seeds.js';\nimport { deriveSpecId, slugify, validateUniqueIds } from './spec-id.js';\nimport type { ResolvedOptions, ResolvedSpecConfig } from './types.js';\n\n// =============================================================================\n// Constants\n// =============================================================================\n\n/**\n * Deterministic color palette for spec identification in DevTools.\n *\n * Colors are assigned by index: spec 0 gets green, spec 1 gets blue, etc.\n * Wraps around for >8 specs.\n */\nexport const SPEC_COLORS: readonly string[] = [\n '#4ade80', // green\n '#60a5fa', // blue\n '#f472b6', // pink\n '#facc15', // yellow\n '#a78bfa', // purple\n '#fb923c', // orange\n '#2dd4bf', // teal\n '#f87171', // red\n];\n\n// =============================================================================\n// Types\n// =============================================================================\n\n/**\n * Resolved spec instance with all runtime data.\n *\n * Created during Phase 1 of orchestration. Each instance owns\n * an isolated core `OpenApiServer` with its own store, registry,\n * handlers, seeds, and timeline.\n */\nexport interface SpecInstance {\n /** Unique spec identifier (explicit or auto-derived from info.title) */\n id: string;\n\n /** Spec metadata for DevTools display and WebSocket protocol */\n info: SpecInfo;\n\n /** Core server instance (isolated Hono app, store, registry, etc.) */\n server: OpenApiServer;\n\n /** Resolved configuration for this spec */\n config: ResolvedSpecConfig;\n}\n\n/**\n * Orchestrator result — returned by `createOrchestrator()`.\n *\n * Provides access to the main Hono app (all specs mounted),\n * individual spec instances, aggregated metadata, and lifecycle methods.\n */\nexport interface OrchestratorResult {\n /** Main Hono app with all specs mounted via X-Spec-Id dispatch */\n app: Hono;\n\n /** All spec instances (in config order) */\n instances: SpecInstance[];\n\n /** Spec metadata array for WebSocket `connected` event */\n specsInfo: SpecInfo[];\n\n /** Start the shared HTTP server on the configured port */\n start(): Promise<void>;\n\n /** Stop the HTTP server and clean up resources */\n stop(): Promise<void>;\n\n /** Actual bound port after start() resolves (0 before start or after stop) */\n readonly port: number;\n}\n\n// =============================================================================\n// Helpers\n// =============================================================================\n\n/**\n * Resolved values produced by `processSpec` for a single spec.\n *\n * Returned instead of mutating the input `ResolvedSpecConfig` so that\n * the caller (`createOrchestrator`) decides how to propagate the values.\n */\ninterface ProcessedSpec {\n instance: SpecInstance;\n resolvedConfig: {\n id: string;\n proxyPath: string;\n proxyPathSource: 'auto' | 'explicit';\n handlersDir: string;\n seedsDir: string;\n };\n}\n\n/**\n * Process a single spec configuration into a resolved SpecInstance.\n *\n * Loads handlers and seeds, creates the core OpenApiServer, derives the\n * spec ID and proxy path, and builds the SpecInfo metadata.\n *\n * Does **not** mutate `specConfig`. Returns resolved values separately\n * so the caller can assign them back.\n */\nasync function processSpec(\n specConfig: ResolvedSpecConfig,\n index: number,\n options: ResolvedOptions,\n vite: ViteDevServer,\n cwd: string,\n logger: Logger,\n): Promise<ProcessedSpec> {\n // Derive a filesystem-safe namespace for fallback directories.\n // Uses slugified ID to match the final resolved spec ID (e.g., \"My API\" → \"my-api\").\n const specNamespace = specConfig.id ? slugify(specConfig.id) : `spec-${index}`;\n\n // Resolve handlers directory (fallback uses spec namespace)\n const handlersDir = specConfig.handlersDir || `./mocks/${specNamespace}/handlers`;\n\n // Resolve seeds directory (same namespace pattern)\n const seedsDir = specConfig.seedsDir || `./mocks/${specNamespace}/seeds`;\n\n // Load handlers via Vite's ssrLoadModule\n const handlersResult = await loadHandlers(handlersDir, vite, cwd, logger);\n\n // Load seeds via Vite's ssrLoadModule\n const seedsResult = await loadSeeds(seedsDir, vite, cwd, logger);\n\n // Create core server instance (processes the OpenAPI document internally)\n // NOTE: Pass empty Map for seeds — createOpenApiServer.seeds expects\n // Map<string, unknown[]> (static data), while loadSeeds() returns\n // Map<string, AnySeedFn> (functions). Seeds are executed separately\n // via executeSeeds() after server creation.\n const server = await createOpenApiServer({\n spec: specConfig.spec,\n port: options.port,\n idFields: specConfig.idFields,\n handlers: handlersResult.handlers,\n seeds: new Map(),\n timelineLimit: options.timelineLimit,\n cors: false, // CORS handled at main app level\n devtools: false, // DevTools mounted at main app level\n logger,\n });\n\n // Execute seed functions to populate the store\n if (seedsResult.seeds.size > 0) {\n await executeSeeds(seedsResult.seeds, server.store, server.document);\n }\n\n // Derive spec ID (now that document is processed and info.title is available)\n const id = deriveSpecId(specConfig.id, server.document);\n\n // Derive proxy path (from explicit config or servers[0].url)\n const { proxyPath, proxyPathSource } = deriveProxyPath(specConfig.proxyPath, server.document, id);\n\n // Build SpecInfo metadata for DevTools and WebSocket protocol\n const info: SpecInfo = {\n id,\n title: server.document.info?.title ?? id,\n version: server.document.info?.version ?? 'unknown',\n proxyPath,\n color: SPEC_COLORS[index % SPEC_COLORS.length],\n endpointCount: server.registry.endpoints.size,\n schemaCount: server.store.getSchemas().length,\n };\n\n return {\n instance: { id, info, server, config: specConfig },\n resolvedConfig: { id, proxyPath, proxyPathSource, handlersDir, seedsDir },\n };\n}\n\n// =============================================================================\n// Phase 3 Helpers (extracted for cognitive complexity)\n// =============================================================================\n\n/** CORS configuration used by both mainApp and sub-instance middleware */\ninterface CorsConfig {\n origin: string | string[];\n allowMethods: string[];\n allowHeaders: string[];\n exposeHeaders: string[];\n maxAge: number;\n credentials: boolean;\n}\n\n/**\n * Build the CORS configuration from resolved options.\n *\n * Normalizes `['*']` to `'*'` (Hono's array branch uses `.includes(origin)`\n * which never matches browser-sent origins against the literal `'*'`).\n */\nfunction buildCorsConfig(options: ResolvedOptions): CorsConfig {\n const isWildcardOrigin =\n options.corsOrigin === '*' ||\n (Array.isArray(options.corsOrigin) && options.corsOrigin.includes('*'));\n\n const effectiveCorsOrigin =\n Array.isArray(options.corsOrigin) && options.corsOrigin.includes('*')\n ? '*'\n : options.corsOrigin;\n\n return {\n origin: effectiveCorsOrigin,\n allowMethods: ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'OPTIONS', 'HEAD'],\n allowHeaders: ['Content-Type', 'Authorization', 'X-Requested-With', 'X-Spec-Id'],\n exposeHeaders: ['Content-Length', 'X-Request-Id'],\n maxAge: 86400,\n credentials: !isWildcardOrigin,\n };\n}\n\n/**\n * Mount the DevTools SPA on the main Hono app.\n *\n * Resolves the SPA directory relative to this file's location.\n * Logs a warning if the built SPA is not found.\n */\nfunction mountDevToolsSpa(mainApp: Hono, logger: Logger): void {\n const pluginDir = dirname(fileURLToPath(import.meta.url));\n const spaDir = join(pluginDir, 'devtools-spa');\n const devtoolsSpaDir = existsSync(spaDir) ? spaDir : undefined;\n\n if (!devtoolsSpaDir) {\n logger.warn?.(\n '[vite-plugin-open-api-server] DevTools SPA not found at',\n spaDir,\n '- serving placeholder. Run \"pnpm build\" to include the SPA.',\n );\n }\n\n mountDevToolsRoutes(mainApp, {\n spaDir: devtoolsSpaDir,\n logger,\n });\n}\n\n/**\n * Create the X-Spec-Id dispatch middleware.\n *\n * Uses slugify() to normalize the incoming header so it matches the\n * instanceMap keys produced by deriveSpecId().\n */\nfunction createDispatchMiddleware(instanceMap: Map<string, SpecInstance>) {\n return async (c: Context, next: () => Promise<void>) => {\n const rawSpecId = c.req.header('x-spec-id');\n if (!rawSpecId) {\n await next();\n return;\n }\n\n const specId = slugify(rawSpecId.trim());\n if (!specId) {\n await next();\n return;\n }\n\n const instance = instanceMap.get(specId);\n if (!instance) {\n return c.json({ error: `Unknown spec: ${specId}` }, 404);\n }\n\n return instance.server.app.fetch(c.req.raw);\n };\n}\n\n// =============================================================================\n// Orchestrator Factory\n// =============================================================================\n\n/**\n * Create the multi-spec orchestrator.\n *\n * Flow:\n * 1. **Phase 1 — Process specs**: For each spec config, load handlers/seeds,\n * create a core `OpenApiServer` instance, derive ID and proxy path.\n * 2. **Phase 2 — Validate uniqueness**: Ensure all spec IDs and proxy paths\n * are unique and non-overlapping.\n * 3. **Phase 3 — Build main app**: Create a single Hono app with CORS,\n * DevTools, Internal API, and X-Spec-Id dispatch middleware.\n *\n * **Note**: This function mutates `options.specs[i]` to write back resolved\n * values (id, proxyPath, proxyPathSource, handlersDir, seedsDir) so that\n * downstream consumers (banner, file watcher, plugin.ts) see the final values.\n *\n * @param options - Resolved plugin options (from `resolveOptions()`)\n * @param vite - Vite dev server instance (for ssrLoadModule)\n * @param cwd - Project root directory\n * @returns Orchestrator result with app, instances, and lifecycle methods\n */\nexport async function createOrchestrator(\n options: ResolvedOptions,\n vite: ViteDevServer,\n cwd: string,\n): Promise<OrchestratorResult> {\n const logger = options.logger ?? console;\n\n // ========================================================================\n // Phase 1: Process each spec — load handlers/seeds, create core instances\n // ========================================================================\n\n const instances: SpecInstance[] = [];\n for (let i = 0; i < options.specs.length; i++) {\n const { instance, resolvedConfig } = await processSpec(\n options.specs[i],\n i,\n options,\n vite,\n cwd,\n logger,\n );\n\n // Write resolved values back to options.specs[i]. Since processSpec\n // received this same object reference as specConfig, and the instance\n // was created with `config: specConfig`, these mutations are visible\n // through both options.specs[i] and instance.config (shared object).\n const specConfig = options.specs[i];\n specConfig.id = resolvedConfig.id;\n specConfig.proxyPath = resolvedConfig.proxyPath;\n specConfig.proxyPathSource = resolvedConfig.proxyPathSource;\n specConfig.handlersDir = resolvedConfig.handlersDir;\n specConfig.seedsDir = resolvedConfig.seedsDir;\n\n instances.push(instance);\n }\n\n // ========================================================================\n // Phase 2: Validate uniqueness of IDs and proxy paths\n // ========================================================================\n\n validateUniqueIds(instances.map((inst) => inst.id));\n validateUniqueProxyPaths(\n instances.map((inst) => ({\n id: inst.id,\n proxyPath: inst.config.proxyPath,\n })),\n );\n\n // ========================================================================\n // Phase 3: Build main Hono app\n // ========================================================================\n\n const mainApp = new Hono();\n\n // --- CORS ---\n const corsConfig = buildCorsConfig(options);\n if (options.cors) {\n // mainApp CORS covers shared services (/_devtools, /_api).\n mainApp.use('*', cors(corsConfig));\n // Sub-instance CORS covers dispatched requests (app.fetch() bypasses mainApp middleware).\n for (const inst of instances) {\n inst.server.app.use('*', cors(corsConfig));\n }\n }\n\n // --- DevTools SPA (single SPA for all specs, spec-aware via WebSocket) ---\n if (options.devtools) {\n mountDevToolsSpa(mainApp, logger);\n }\n\n // --- Internal API — first spec only (multi-spec: Epic 3, Task 3.x) ---\n if (instances.length > 0) {\n if (instances.length > 1) {\n logger.warn?.(\n \"[vite-plugin-open-api-server] Only first spec's internal API mounted on /_api; multi-spec support planned in Epic 3 (Task 3.x).\",\n );\n }\n const firstInstance = instances[0];\n mountInternalApi(mainApp, {\n store: firstInstance.server.store,\n registry: firstInstance.server.registry,\n simulationManager: firstInstance.server.simulationManager,\n wsHub: firstInstance.server.wsHub,\n timeline: firstInstance.server.getTimeline(),\n timelineLimit: options.timelineLimit,\n clearTimeline: () => firstInstance.server.truncateTimeline(),\n document: firstInstance.server.document,\n });\n }\n\n // --- X-Spec-Id dispatch middleware ---\n const instanceMap = new Map(instances.map((inst) => [inst.id, inst]));\n mainApp.use('*', createDispatchMiddleware(instanceMap));\n\n // ========================================================================\n // Spec metadata\n // ========================================================================\n\n const specsInfo = instances.map((inst) => inst.info);\n\n // ========================================================================\n // Lifecycle\n // ========================================================================\n\n /** Minimal interface for the Node.js HTTP server returned by @hono/node-server */\n type NodeServer = import('node:http').Server;\n\n let serverInstance: NodeServer | null = null;\n let boundPort = 0;\n\n return {\n app: mainApp,\n instances,\n specsInfo,\n\n get port(): number {\n return boundPort;\n },\n\n async start(): Promise<void> {\n // Guard against double-start — prevents leaking the first server\n if (serverInstance) {\n throw new Error('[vite-plugin-open-api-server] Server already running. Call stop() first.');\n }\n\n // Dynamic import — only one HTTP server for all specs.\n // Use createAdaptorServer() to separate server creation from listen(),\n // ensuring event listeners are attached before listen() is called.\n let createAdaptorServer: typeof import('@hono/node-server').createAdaptorServer;\n try {\n const nodeServer = await import('@hono/node-server');\n createAdaptorServer = nodeServer.createAdaptorServer;\n } catch {\n throw new Error(\n '@hono/node-server is required. Install with: npm install @hono/node-server',\n );\n }\n\n const server = createAdaptorServer({ fetch: mainApp.fetch }) as NodeServer;\n\n // Wait for the server to be listening before resolving.\n // Attach listeners BEFORE calling listen() to avoid a race condition\n // where the 'listening' event fires before the handler is registered.\n await new Promise<void>((resolve, reject) => {\n const onListening = () => {\n server.removeListener('error', onError);\n // Read the actual bound port from the server (handles port 0 / ephemeral)\n const addr = server.address();\n const actualPort = typeof addr === 'object' && addr ? addr.port : options.port;\n logger.info(\n `[vite-plugin-open-api-server] Server started on http://localhost:${actualPort}`,\n );\n boundPort = actualPort;\n serverInstance = server;\n resolve();\n };\n\n const onError = (err: NodeJS.ErrnoException) => {\n server.removeListener('listening', onListening);\n // Close and null the server to prevent leaks on error\n server.close(() => {});\n serverInstance = null;\n boundPort = 0;\n if (err.code === 'EADDRINUSE') {\n reject(\n new Error(`[vite-plugin-open-api-server] Port ${options.port} is already in use.`),\n );\n } else {\n reject(new Error(`[vite-plugin-open-api-server] Server error: ${err.message}`));\n }\n };\n\n server.once('listening', onListening);\n server.once('error', onError);\n server.listen(options.port);\n });\n },\n\n async stop(): Promise<void> {\n const server = serverInstance;\n if (server) {\n try {\n await new Promise<void>((resolve, reject) => {\n server.close((err?: Error) => {\n if (err) {\n reject(err);\n } else {\n resolve();\n }\n });\n });\n logger.info('[vite-plugin-open-api-server] Server stopped');\n } catch (err) {\n logger.error?.('[vite-plugin-open-api-server] Error closing server:', err);\n throw err;\n } finally {\n serverInstance = null;\n boundPort = 0;\n }\n }\n },\n };\n}\n","/**\n * Vue DevTools Integration\n *\n * What: Provides a function to register OpenAPI Server in Vue DevTools\n * How: Uses @vue/devtools-api to add a custom tab with iframe to DevTools SPA\n * Why: Enables debugging and inspection of the mock API server within Vue DevTools\n *\n * @module devtools\n */\n\nimport type { App } from 'vue';\n\n/**\n * Options for registering the DevTools plugin\n */\nexport interface RegisterDevToolsOptions {\n /**\n * The port where the OpenAPI server is running\n * @default 3000\n */\n port?: number;\n\n /**\n * The host where the OpenAPI server is running\n * @default 'localhost' (or derived from window.location.hostname if in browser)\n */\n host?: string;\n\n /**\n * The protocol to use for the DevTools URL\n * @default 'http' (or derived from window.location.protocol if in browser)\n */\n protocol?: 'http' | 'https';\n\n /**\n * Enable or disable DevTools registration\n * @default true\n */\n enabled?: boolean;\n\n /**\n * Custom label for the DevTools tab\n * @default 'OpenAPI Server'\n */\n label?: string;\n}\n\n/**\n * Register OpenAPI Server in Vue DevTools\n *\n * This function should be called in your Vue application's main entry point\n * to add a custom tab to Vue DevTools. The tab contains an iframe that loads\n * the OpenAPI Server DevTools SPA.\n *\n * @example\n * ```typescript\n * // In your main.ts or main.js\n * import { createApp } from 'vue';\n * import { registerDevTools } from '@websublime/vite-plugin-open-api-server';\n * import App from './App.vue';\n *\n * const app = createApp(App);\n *\n * // Register OpenAPI Server DevTools\n * if (import.meta.env.DEV) {\n * await registerDevTools(app, { port: 3000 });\n * }\n *\n * app.mount('#app');\n * ```\n *\n * @param app - Vue application instance\n * @param options - Configuration options\n */\nexport async function registerDevTools(\n app: App,\n options: RegisterDevToolsOptions = {},\n): Promise<void> {\n const { enabled = true, label = 'OpenAPI Server', port, host, protocol } = options;\n\n // Validate app parameter\n if (!app || typeof app !== 'object') {\n // biome-ignore lint/suspicious/noConsole: Intentional warning for invalid app instance\n console.warn('[OpenAPI DevTools] Invalid Vue app instance provided');\n return;\n }\n\n // Only register if enabled\n if (!enabled) {\n return;\n }\n\n // Check if running in browser environment\n if (typeof window === 'undefined') {\n return;\n }\n\n // Lazy import to avoid SSR issues\n try {\n const { addCustomTab } = await import('@vue/devtools-api');\n\n // Get the DevTools URL\n const devtoolsUrl = getDevToolsUrl(port, host, protocol);\n\n // Add custom tab with iframe to Vue DevTools\n addCustomTab({\n name: 'vite-plugin-open-api-server',\n title: label,\n icon: 'data:image/svg+xml,%3Csvg xmlns=%22http://www.w3.org/2000/svg%22 viewBox=%220 0 24 24%22 fill=%22none%22 stroke=%22%234f46e5%22 stroke-width=%222%22 stroke-linecap=%22round%22 stroke-linejoin=%22round%22%3E%3Cpath d=%22M21 16V8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16z%22/%3E%3Cpolyline points=%223.29 7 12 12 20.71 7%22/%3E%3Cline x1=%2212%22 y1=%2222%22 x2=%2212%22 y2=%2212%22/%3E%3C/svg%3E',\n view: {\n type: 'iframe',\n src: devtoolsUrl,\n },\n category: 'app',\n });\n } catch (error) {\n // Log warning but don't crash the app\n // DevTools integration is optional, so the app should continue working\n // biome-ignore lint/suspicious/noConsole: Intentional warning for registration failure\n console.warn('[OpenAPI DevTools] Failed to register with Vue DevTools:', error);\n }\n}\n\n/**\n * Get the DevTools URL for the given configuration\n *\n * When running in a browser, protocol and host are automatically derived from\n * window.location if not explicitly provided.\n *\n * @param port - Server port (default: 3000)\n * @param host - Server host (default: 'localhost' or window.location.hostname)\n * @param protocol - Protocol to use (default: 'http' or window.location.protocol)\n * @returns DevTools SPA URL\n */\nexport function getDevToolsUrl(port = 3000, host?: string, protocol?: 'http' | 'https'): string {\n // Derive defaults from browser environment if available\n const actualProtocol =\n protocol ||\n (typeof window !== 'undefined'\n ? (window.location.protocol.replace(':', '') as 'http' | 'https')\n : 'http');\n const actualHost =\n host || (typeof window !== 'undefined' ? window.location.hostname : 'localhost');\n\n return `${actualProtocol}://${actualHost}:${port}/_devtools/`;\n}\n"]}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@websublime/vite-plugin-open-api-server",
3
- "version": "0.24.0-next.2",
3
+ "version": "0.24.0-next.3",
4
4
  "description": "Vite plugin for OpenAPI mock server with DevTools integration",
5
5
  "keywords": [
6
6
  "vite",
@@ -23,41 +23,51 @@
23
23
  "directory": "packages/server"
24
24
  },
25
25
  "dependencies": {
26
- "picocolors": "^1.1.1",
27
- "@vue/devtools-api": "^8.0.6",
28
26
  "fast-glob": "^3.3.3",
29
27
  "chokidar": "^5.0.0",
30
- "@websublime/vite-plugin-open-api-core": "0.14.0-next.3"
28
+ "@vue/devtools-api": "^8.0.6",
29
+ "picocolors": "^1.1.1",
30
+ "@websublime/vite-plugin-open-api-core": "0.14.0-next.4"
31
31
  },
32
32
  "devDependencies": {
33
- "@scalar/openapi-types": "^0.5.3",
33
+ "@hono/node-server": "^1.14.3",
34
34
  "tsup": "^8.5.0",
35
- "vite": "^7.0.0",
35
+ "@types/node": "^20.17.10",
36
+ "hono": "^4.11.4",
36
37
  "typescript": "^5.9.0",
38
+ "@scalar/openapi-types": "^0.5.3",
37
39
  "vue": "^3.5.27",
40
+ "vite": "^7.0.0",
38
41
  "@websublime/vite-plugin-open-api-devtools": "0.8.5"
39
42
  },
40
43
  "peerDependencies": {
44
+ "@hono/node-server": "^1.14.0",
45
+ "hono": "^4.11.4",
41
46
  "vue": "^3.0.0",
42
47
  "vite": "^5.0.0 || ^6.0.0 || ^7.0.0"
43
48
  },
49
+ "peerDependenciesMeta": {
50
+ "vue": {
51
+ "optional": true
52
+ }
53
+ },
44
54
  "engines": {
45
55
  "node": "^20.19.0 || >=22.12.0"
46
56
  },
47
57
  "private": false,
48
58
  "type": "module",
49
59
  "types": "./dist/index.d.ts",
50
- "module": "./dist/index.js",
51
60
  "exports": {
52
61
  ".": {
53
62
  "import": "./dist/index.js",
54
63
  "types": "./dist/index.d.ts"
55
64
  }
56
65
  },
66
+ "module": "./dist/index.js",
57
67
  "scripts": {
58
68
  "copy:devtools-spa": "node scripts/copy-devtools-spa.mjs",
59
69
  "typecheck": "tsc --noEmit",
60
- "dev": "tsup --watch",
61
- "build": "tsup && pnpm run copy:devtools-spa"
70
+ "build": "tsup && pnpm run copy:devtools-spa",
71
+ "dev": "tsup --watch"
62
72
  }
63
73
  }