adorn-api 1.0.12 → 1.0.14

package/dist/index.cjs

@@ -72,10 +72,14 @@ __export(index_exports, {
   ValidationErrorResponse: () => ValidationErrorResponse,
   clearArtifactCache: () => clearArtifactCache,
   createValidator: () => createValidator,
+  findProcessOnPort: () => findProcessOnPort,
   formatValidationErrors: () => formatValidationErrors,
   getArtifactCacheStats: () => getArtifactCacheStats,
+  isPortAvailable: () => isPortAvailable,
+  killProcess: () => killProcess,
   loadArtifacts: () => loadArtifacts,
-  readAdornBucket: () => readAdornBucket
+  readAdornBucket: () => readAdornBucket,
+  waitForPort: () => waitForPort
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -368,11 +372,25 @@ function Union(mode) {
 var import_ajv = __toESM(require("ajv"), 1);
 var import_ajv_formats = __toESM(require("ajv-formats"), 1);
 var ValidationErrorResponse = class extends Error {
+  /**
+   * HTTP status code for validation errors.
+   */
+  statusCode;
+  /**
+   * Detailed validation errors.
+   */
+  errors;
+  /**
+   * Creates a new ValidationErrorResponse.
+   * 
+   * @param statusCode - HTTP status code (typically 400)
+   * @param errors - Array of validation errors
+   */
   constructor(statusCode, errors) {
     super("Validation failed");
+    this.name = "ValidationErrorResponse";
     this.statusCode = statusCode;
     this.errors = errors;
-    this.name = "ValidationErrorResponse";
   }
 };
 function createValidator() {
@@ -453,7 +471,7 @@ async function getMtime(filePath) {
 async function loadArtifacts(options) {
   const { outDir } = options;
   const cacheKey = import_node_path.default.resolve(outDir);
-  let entry = artifactCache.get(cacheKey);
+  const entry = artifactCache.get(cacheKey);
   const openapiPath = import_node_path.default.join(outDir, "openapi.json");
   const manifestPath = import_node_path.default.join(outDir, "manifest.json");
   const validatorsPath = import_node_path.default.join(outDir, "validators.mjs");
@@ -515,6 +533,141 @@ function getArtifactCacheStats() {
     keys: Array.from(artifactCache.keys())
   };
 }
+
+// src/utils/port.ts
+var import_net = require("net");
+var import_child_process = require("child_process");
+var import_util = require("util");
+var execAsync = (0, import_util.promisify)(import_child_process.exec);
+async function isPortAvailable(port, host = "0.0.0.0") {
+  return new Promise((resolve) => {
+    const server = (0, import_net.createServer)();
+    server.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        resolve(false);
+      } else {
+        resolve(false);
+      }
+    });
+    server.once("listening", () => {
+      server.close(() => {
+        resolve(true);
+      });
+    });
+    server.listen(port, host);
+  });
+}
+async function findProcessOnPort(port) {
+  try {
+    const platform = process.platform;
+    if (platform === "win32") {
+      const { stdout } = await execAsync(`netstat -ano | findstr :${port}`);
+      for (const line of stdout.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.includes("PID")) continue;
+        const parts = trimmed.split(/\s+/);
+        if (parts.length >= 5) {
+          const address = parts[1];
+          const pid = parseInt(parts[parts.length - 1], 10);
+          if (address.includes(`:${port}`) && !isNaN(pid)) {
+            const command = await getProcessNameOnWindows(pid);
+            return { pid, command };
+          }
+        }
+      }
+    } else {
+      const { stdout } = await execAsync(`lsof -ti:${port}`);
+      const pids = stdout.trim().split("\n").filter(Boolean).map(Number);
+      if (pids.length > 0) {
+        const pid = pids[0];
+        const command = await getProcessNameOnUnix(pid);
+        return { pid, command };
+      }
+    }
+    return null;
+  } catch (error) {
+    if (error.message.includes("matches found")) {
+      return null;
+    }
+    return null;
+  }
+}
+async function getProcessNameOnWindows(pid) {
+  try {
+    const { stdout } = await execAsync(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`);
+    const line = stdout.trim().split("\n")[0];
+    if (line) {
+      const parts = line.split('","');
+      if (parts.length >= 2) {
+        return parts[0].replace(/"/g, "");
+      }
+    }
+  } catch {
+    return void 0;
+  }
+}
+async function getProcessNameOnUnix(pid) {
+  try {
+    const { stdout } = await execAsync(`ps -p ${pid} -o comm=`);
+    return stdout.trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function killProcess(pid) {
+  try {
+    process.kill(pid, "SIGTERM");
+    await new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error("Process did not terminate gracefully"));
+      }, 5e3);
+      const check = () => {
+        try {
+          process.kill(pid, 0);
+          setTimeout(check, 500);
+        } catch {
+          clearInterval(interval);
+          clearTimeout(timeout);
+          resolve();
+        }
+      };
+      const interval = setInterval(check, 500);
+    });
+    return true;
+  } catch {
+    try {
+      process.kill(pid, "SIGKILL");
+      await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+          reject(new Error("Process did not terminate"));
+        }, 3e3);
+        setTimeout(() => {
+          try {
+            process.kill(pid, 0);
+            clearTimeout(timeout);
+            reject(new Error("Process still running"));
+          } catch {
+            clearTimeout(timeout);
+            resolve();
+          }
+        }, 1e3);
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+async function waitForPort(port, host = "0.0.0.0", timeout = 5e3) {
+  const start = Date.now();
+  while (Date.now() - start < timeout) {
+    if (await isPortAvailable(port, host)) {
+      return true;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 200));
+  }
+  return false;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ADORN_META,
@@ -559,9 +712,13 @@ function getArtifactCacheStats() {
   ValidationErrorResponse,
   clearArtifactCache,
   createValidator,
+  findProcessOnPort,
   formatValidationErrors,
   getArtifactCacheStats,
+  isPortAvailable,
+  killProcess,
   loadArtifacts,
-  readAdornBucket
+  readAdornBucket,
+  waitForPort
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/runtime/polyfill.ts","../src/runtime/metadata/key.ts","../src/runtime/metadata/bucket.ts","../src/decorators/Controller.ts","../src/decorators/methods.ts","../src/decorators/Use.ts","../src/decorators/Auth.ts","../src/decorators/Public.ts","../src/runtime/metadata/read.ts","../src/schema/decorators.ts","../src/runtime/validation/ajv.ts","../src/http.ts","../src/compiler/cache/loadArtifacts.ts"],"sourcesContent":["import \"./runtime/polyfill.js\";\n\nexport { Controller, Get, Post, Put, Patch, Delete, Use, Auth, Public } from \"./decorators/index.js\";\nexport { readAdornBucket } from \"./runtime/metadata/read.js\";\nexport type { HttpMethod, RouteOperation, AdornBucket, AuthMeta, ExpressMw } from \"./runtime/metadata/types.js\";\nexport type { AuthSchemeRuntime, AuthResult } from \"./runtime/auth/runtime.js\";\nexport * from \"./schema/index.js\";\nexport { createValidator, formatValidationErrors, ValidationErrorResponse } from \"./runtime/validation/index.js\";\nexport { PartType, File, PartType as PartType2, Consumes, Produces } from \"./http.js\";\nexport type { Query, Body, Headers, Cookies, PaginationParams, PaginatedResponse, HttpMetadata, FilePartOptions } from \"./http.js\";\nexport type { UploadFile } from \"./runtime/upload.js\";\nexport { loadArtifacts, clearArtifactCache, getArtifactCacheStats } from \"./compiler/cache/loadArtifacts.js\";\n","// Polyfill Symbol.metadata for environments that don't support it\n// Must run before any decorated classes are imported\n(Symbol as any).metadata ??= Symbol(\"Symbol.metadata\");\n\n// Export a symbol to prevent tree-shaking\nexport const ADORN_POLYFILL = Symbol(\"adorn-polyfill\");\n","export const ADORN_META = Symbol.for(\"adorn-api/meta\");\n","import { ADORN_META } from \"./key.js\";\nimport type { AdornBucket } from \"./types.js\";\n\nexport function getBucket(metadata: DecoratorMetadata): AdornBucket {\n  if (!metadata) {\n    throw new Error(\"Decorator context.metadata is undefined. Ensure Symbol.metadata polyfill runs before decorators.\");\n  }\n  let bucket = metadata[ADORN_META] as AdornBucket | undefined;\n  if (!bucket) {\n    bucket = { ops: [], controllerUse: [] };\n    metadata[ADORN_META] = bucket;\n  }\n  if (!bucket.controllerUse) {\n    bucket.controllerUse = [];\n  }\n  return bucket;\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\n\nexport function Controller(basePath: string) {\n  return function <T extends new (...args: any[]) => any>(\n    target: T,\n    context: ClassDecoratorContext<T>\n  ): T | void {\n    const bucket = getBucket(context.metadata);\n    bucket.basePath = basePath;\n  };\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { HttpMethod } from \"../runtime/metadata/types.js\";\n\nfunction createMethodDecorator(httpMethod: HttpMethod, path: string) {\n  return function <T extends (...args: any[]) => any>(\n    target: T,\n    context: ClassMethodDecoratorContext<any, T>\n  ): T | void {\n    if (context.private || context.static) {\n      return;\n    }\n\n    const methodName = String(context.name);\n    const bucket = getBucket(context.metadata);\n\n    let op = bucket.ops.find(op => op.methodName === methodName);\n    if (!op) {\n      op = {\n        httpMethod,\n        path,\n        methodName,\n      };\n      bucket.ops.push(op);\n    } else {\n      op.httpMethod = httpMethod;\n      op.path = path;\n    }\n  };\n}\n\nexport const Get = (path: string) => createMethodDecorator(\"GET\", path);\nexport const Post = (path: string) => createMethodDecorator(\"POST\", path);\nexport const Put = (path: string) => createMethodDecorator(\"PUT\", path);\nexport const Patch = (path: string) => createMethodDecorator(\"PATCH\", path);\nexport const Delete = (path: string) => createMethodDecorator(\"DELETE\", path);\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { ExpressMw, HttpMethod } from \"../runtime/metadata/types.js\";\n\ntype UseTarget = string | ExpressMw;\n\nexport function Use(...middleware: UseTarget[]) {\n  return function (\n    target: any,\n    context: ClassDecoratorContext | ClassMethodDecoratorContext\n  ) {\n    if (context.kind === \"class\") {\n      const bucket = getBucket(context.metadata);\n      if (!bucket.controllerUse) {\n        bucket.controllerUse = [];\n      }\n      bucket.controllerUse.push(...middleware);\n    } else if (context.kind === \"method\") {\n      const methodName = String(context.name);\n      const bucket = getBucket(context.metadata);\n      let op = bucket.ops.find(op => op.methodName === methodName);\n      if (!op) {\n        op = {\n          httpMethod: \"GET\" as HttpMethod,\n          path: \"/\",\n          methodName,\n        };\n        bucket.ops.push(op);\n      }\n      if (!op.use) {\n        op.use = [];\n      }\n      op.use.push(...middleware);\n    } else {\n      throw new Error(\"@Use decorator can only be applied to classes or methods\");\n    }\n  };\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { AuthMeta, HttpMethod } from \"../runtime/metadata/types.js\";\n\nexport function Auth(scheme: string, options?: { scopes?: string[]; optional?: boolean }) {\n  return function (\n    target: any,\n    context: ClassMethodDecoratorContext\n  ) {\n    if (context.kind !== \"method\") {\n      throw new Error(\"@Auth decorator can only be applied to methods\");\n    }\n\n    const methodName = String(context.name);\n    const bucket = getBucket(context.metadata);\n    let op = bucket.ops.find(op => op.methodName === methodName);\n    if (!op) {\n      op = {\n        httpMethod: \"GET\" as HttpMethod,\n        path: \"/\",\n        methodName,\n      };\n      bucket.ops.push(op);\n    }\n\n    op.auth = {\n      scheme,\n      scopes: options?.scopes,\n      optional: options?.optional ?? false,\n    };\n  };\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { HttpMethod } from \"../runtime/metadata/types.js\";\n\nexport function Public() {\n  return function (\n    target: any,\n    context: ClassMethodDecoratorContext\n  ) {\n    if (context.kind !== \"method\") {\n      throw new Error(\"@Public decorator can only be applied to methods\");\n    }\n\n    const methodName = String(context.name);\n    const bucket = getBucket(context.metadata);\n    let op = bucket.ops.find(op => op.methodName === methodName);\n    if (!op) {\n      op = {\n        httpMethod: \"GET\" as HttpMethod,\n        path: \"/\",\n        methodName,\n      };\n      bucket.ops.push(op);\n    }\n\n    op.auth = \"public\";\n  };\n}\n","import { ADORN_META } from \"./key.js\";\nimport type { AdornBucket } from \"./types.js\";\n\nexport function readAdornBucket(ctor: Function): AdornBucket | null {\n  const metaSym = (Symbol as any).metadata as symbol | undefined;\n  if (!metaSym) {\n    return null;\n  }\n\n  const classMetadata = (ctor as any)[metaSym] as DecoratorMetadata | undefined;\n  if (!classMetadata) {\n    return null;\n  }\n\n  const bucket = classMetadata[ADORN_META] as AdornBucket | undefined;\n  return bucket ?? null;\n}\n","const ADORN_META = Symbol.for(\"adorn-api.metadata\");\n\ninterface SchemaFrag {\n  [key: string]: unknown;\n}\n\ninterface SchemaMetadata {\n  schema: {\n    props: Record<string, SchemaFrag[]>;\n  };\n}\n\nfunction getOrCreateMetadata(metadata: Record<PropertyKey, unknown>): SchemaMetadata {\n  const meta = (metadata[ADORN_META] ??= {}) as SchemaMetadata;\n  meta.schema ??= { props: {} };\n  return meta;\n}\n\nfunction pushSchemaFrag(\n  target: Object,\n  propertyKey: string | symbol,\n  metadata: Record<PropertyKey, unknown>,\n  frag: SchemaFrag\n): void {\n  const meta = getOrCreateMetadata(metadata);\n  const props = meta.schema.props;\n  (props[propertyKey as string] ??= []).push(frag);\n}\n\ntype PropertyDecorator = (target: Object, propertyKey: string | symbol, descriptor?: PropertyDescriptor) => void;\n\nexport function Schema(frag: SchemaFrag): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, frag);\n  };\n}\n\nexport function Min(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minimum: n });\n  };\n}\n\nexport function Max(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maximum: n });\n  };\n}\n\nexport function ExclusiveMin(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { exclusiveMinimum: n });\n  };\n}\n\nexport function ExclusiveMax(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { exclusiveMaximum: n });\n  };\n}\n\nexport function MinLength(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minLength: n });\n  };\n}\n\nexport function MaxLength(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maxLength: n });\n  };\n}\n\nexport function Pattern(re: RegExp | string): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { pattern: typeof re === \"string\" ? re : re.source });\n  };\n}\n\nexport function Format(fmt: string): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { format: fmt });\n  };\n}\n\nexport function MinItems(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minItems: n });\n  };\n}\n\nexport function MaxItems(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maxItems: n });\n  };\n}\n\nexport function MinProperties(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minProperties: n });\n  };\n}\n\nexport function MaxProperties(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maxProperties: n });\n  };\n}\n\nexport function MultipleOf(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { multipleOf: n });\n  };\n}\n\nexport function Example(value: unknown): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { example: value });\n  };\n}\n\nexport function Examples(values: unknown[]): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { examples: values });\n  };\n}\n\nexport function Description(desc: string): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { description: desc });\n  };\n}\n\nexport function Enum<T extends string | number>(vals: T[]): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { enum: vals });\n  };\n}\n\nexport function Const<T>(val: T): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { const: val });\n  };\n}\n\nexport function Default<T>(val: T): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { default: val });\n  };\n}\n\nexport function AdditionalProperties(value: boolean | Record<string, unknown>): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { additionalProperties: value });\n  };\n}\n\nexport function Closed(): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { additionalProperties: false });\n  };\n}\n\nexport function ClosedUnevaluated(): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { unevaluatedProperties: false });\n  };\n}\n\nexport function Union(mode: \"anyOf\" | \"oneOf\" | \"allOf\"): ClassDecorator {\n  return function (target: Function): void {\n    (target as any)[ADORN_META] = (target as any)[ADORN_META] ?? {};\n    const meta = (target as any)[ADORN_META] as SchemaMetadata;\n    meta.schema = meta.schema ?? { props: {} };\n    (meta.schema as any).unionMode = mode;\n  };\n}\n\nexport { ADORN_META };\nexport type { SchemaFrag, SchemaMetadata };\n","import Ajv from \"ajv\";\nimport addFormats from \"ajv-formats\";\nimport type { ErrorObject } from \"ajv\";\n\nexport interface ValidationError {\n  path: string;\n  message: string;\n  keyword: string;\n  params: Record<string, unknown>;\n}\n\nexport interface ValidationResult {\n  valid: boolean;\n  errors: ValidationError[] | null;\n}\n\nexport class ValidationErrorResponse extends Error {\n  constructor(\n    public statusCode: number,\n    public errors: ValidationError[]\n  ) {\n    super(\"Validation failed\");\n    this.name = \"ValidationErrorResponse\";\n  }\n}\n\nexport function createValidator() {\n  const ajv = new Ajv.default({\n    allErrors: true,\n    coerceTypes: false,\n    strict: false,\n    validateFormats: true,\n  });\n\n  addFormats.default(ajv);\n\n  ajv.addFormat(\"br-phone\", /^\\(\\d{2}\\)\\s\\d{5}-\\d{4}$/);\n\n  return ajv;\n}\n\nexport function validateData(\n  ajv: ReturnType<typeof createValidator>,\n  data: unknown,\n  schema: Record<string, unknown>,\n  dataPath: string = \"#\"\n): ValidationResult {\n  const validate = ajv.compile(schema);\n  const valid = validate(data);\n\n  if (valid) {\n    return { valid: true, errors: null };\n  }\n\n  const errors: ValidationError[] = (validate.errors || []).map((err: ErrorObject) => ({\n    path: formatErrorPath(dataPath, err),\n    message: err.message || \"Invalid value\",\n    keyword: err.keyword,\n    params: err.params as Record<string, unknown>,\n  }));\n\n  return { valid: false, errors };\n}\n\nfunction formatErrorPath(basePath: string, err: ErrorObject): string {\n  const instancePath = err.instancePath;\n\n  if (!instancePath || instancePath === \"\") {\n    return basePath;\n  }\n\n  if (basePath === \"#\" || basePath.endsWith(\"/\")) {\n    return `${basePath}${instancePath.slice(1)}`;\n  }\n\n  return `${basePath}${instancePath}`;\n}\n\nexport function formatValidationErrors(errors: ValidationError[]): Record<string, unknown> {\n  const formatted: Record<string, string[]> = {};\n\n  for (const error of errors) {\n    const path = error.path || \"body\";\n    if (!formatted[path]) {\n      formatted[path] = [];\n    }\n    formatted[path].push(error.message);\n  }\n\n  return {\n    error: \"Validation failed\",\n    details: formatted,\n  };\n}\n","import \"./runtime/polyfill.js\";\n\nconst ADORN_META = Symbol.for(\"adorn-api.metadata\");\n\ninterface HttpMetadata {\n  consumes?: string[];\n  produces?: string[];\n  fileParts?: Record<string, FilePartOptions>;\n  cookies?: Record<string, boolean>;\n}\n\ninterface FilePartOptions {\n  contentType?: string;\n  headers?: Record<string, string>;\n}\n\ntype DecoratorMetadata = Record<PropertyKey, unknown> & { [ADORN_META]?: HttpMetadata };\n\nfunction getMetadata(target: Object | DecoratorMetadata): HttpMetadata {\n  const host = target as DecoratorMetadata;\n  const metadata = host[ADORN_META] ?? {};\n  host[ADORN_META] = metadata;\n  return metadata;\n}\n\nexport type PartType = FilePartOptions;\n\nexport function PartType(contentTypeOrOptions: string | FilePartOptions): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    const metadata = getMetadata(target);\n    const options: FilePartOptions = typeof contentTypeOrOptions === \"string\"\n      ? { contentType: contentTypeOrOptions }\n      : contentTypeOrOptions;\n    metadata.fileParts ??= {};\n    metadata.fileParts[propertyKey.toString()] = options;\n  };\n}\n\nexport function File(): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    const metadata = getMetadata(target);\n    metadata.fileParts ??= {};\n    metadata.fileParts[propertyKey.toString()] = metadata.fileParts[propertyKey.toString()] ?? {};\n  };\n}\n\nexport function Consumes(...contentTypes: string[]): ClassDecorator {\n  return function (target: Function): void {\n    const metadata = getMetadata(target.prototype);\n    metadata.consumes = contentTypes;\n  };\n}\n\nexport function Produces(...contentTypes: string[]): ClassDecorator {\n  return function (target: Function): void {\n    const metadata = getMetadata(target.prototype);\n    metadata.produces = contentTypes;\n  };\n}\n\nexport type Query<T = any> = T;\nexport type Body<T = any> = T;\nexport type Headers<T = any> = T;\nexport type Cookies<T = any> = T;\n\nexport interface PaginationParams {\n  page: number;\n  pageSize: number;\n}\n\nexport type PaginatedResponse<T> = {\n  items: T[];\n  totalItems: number;\n  page: number;\n  pageSize: number;\n};\n\nexport { ADORN_META };\nexport type { HttpMetadata, FilePartOptions };\n","import fs from \"node:fs\";\nimport path from \"node:path\";\nimport { stat } from \"node:fs/promises\";\n\ninterface OpenApi {\n  openapi: string;\n  components?: {\n    schemas?: Record<string, unknown>;\n  };\n  paths?: Record<string, unknown>;\n  info?: Record<string, unknown>;\n  security?: Array<Record<string, string[]>>;\n}\n\ninterface Manifest {\n  manifestVersion: number;\n  generatedAt: string;\n  generator: {\n    name: string;\n    version: string;\n    typescript: string;\n  };\n  schemas: {\n    kind: string;\n    file: string;\n    componentsSchemasPointer: string;\n  };\n  validation: {\n    mode: \"none\" | \"ajv-runtime\" | \"precompiled\";\n    precompiledModule: string | null;\n  };\n  controllers: Array<{\n    controllerId: string;\n    basePath: string;\n    operations: Array<{\n      operationId: string;\n      http: {\n        method: string;\n        path: string;\n      };\n      handler: {\n        methodName: string;\n      };\n      args: {\n        body: {\n          index: number;\n          required: boolean;\n          contentType: string;\n          schemaRef: string;\n        } | null;\n        path: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n        query: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n        headers: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n        cookies: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n      };\n      responses: Array<{\n        status: number;\n        contentType: string;\n        schemaRef: string;\n        isArray?: boolean;\n      }>;\n    }>;\n  }>;\n}\n\ninterface ValidatorModule {\n  validators: Record<string, {\n    body?: (data: unknown) => boolean;\n    response: Record<string, (data: unknown) => boolean>;\n  }>;\n  validateBody: (operationId: string, data: unknown) => { ok: boolean; errors: unknown[] | null };\n  validateResponse: (operationId: string, status: number, contentType: string, data: unknown) => { ok: boolean; errors: unknown[] | null };\n}\n\ninterface ArtifactCacheEntry {\n  openapi: OpenApi | null;\n  manifest: Manifest | null;\n  validators: ValidatorModule | null;\n  mtimes: {\n    openapi: number | null;\n    manifest: number | null;\n    validators: number | null;\n  };\n}\n\nconst artifactCache = new Map<string, ArtifactCacheEntry>();\n\nasync function getMtime(filePath: string): Promise<number | null> {\n  try {\n    const stats = await stat(filePath);\n    return stats.mtimeMs;\n  } catch {\n    return null;\n  }\n}\n\nexport interface LoadArtifactsOptions {\n  outDir: string;\n}\n\nexport interface LoadedArtifacts {\n  openapi: OpenApi;\n  manifest: Manifest;\n  validators: ValidatorModule | null;\n}\n\nexport async function loadArtifacts(options: LoadArtifactsOptions): Promise<LoadedArtifacts> {\n  const { outDir } = options;\n  const cacheKey = path.resolve(outDir);\n\n  let entry = artifactCache.get(cacheKey);\n\n  const openapiPath = path.join(outDir, \"openapi.json\");\n  const manifestPath = path.join(outDir, \"manifest.json\");\n  const validatorsPath = path.join(outDir, \"validators.mjs\");\n\n  const openapiMtime = await getMtime(openapiPath);\n  const manifestMtime = await getMtime(manifestPath);\n  const validatorsMtime = await getMtime(validatorsPath);\n\n  if (entry) {\n    const mtimesMatch = \n      entry.mtimes.openapi === openapiMtime &&\n      entry.mtimes.manifest === manifestMtime &&\n      entry.mtimes.validators === validatorsMtime;\n\n    if (mtimesMatch) {\n      if (entry.openapi && entry.manifest) {\n        return {\n          openapi: entry.openapi,\n          manifest: entry.manifest,\n          validators: entry.validators,\n        };\n      }\n    }\n  }\n\n  const openapiContent = fs.readFileSync(openapiPath, \"utf-8\");\n  const manifestContent = fs.readFileSync(manifestPath, \"utf-8\");\n\n  const openapi = JSON.parse(openapiContent) as OpenApi;\n  const manifest = JSON.parse(manifestContent) as Manifest;\n\n  let validators: ValidatorModule | null = null;\n\n  if (manifest.validation.mode === \"precompiled\" && manifest.validation.precompiledModule) {\n    try {\n      const validatorsModule = await import(path.join(outDir, manifest.validation.precompiledModule));\n      validators = validatorsModule as ValidatorModule;\n    } catch (err) {\n      console.warn(`Failed to load precompiled validators: ${err}`);\n    }\n  }\n\n  artifactCache.set(cacheKey, {\n    openapi,\n    manifest,\n    validators,\n    mtimes: {\n      openapi: openapiMtime,\n      manifest: manifestMtime,\n      validators: validatorsMtime,\n    },\n  });\n\n  return {\n    openapi,\n    manifest,\n    validators,\n  };\n}\n\nexport function clearArtifactCache(outDir?: string): void {\n  if (outDir) {\n    const cacheKey = path.resolve(outDir);\n    artifactCache.delete(cacheKey);\n  } else {\n    artifactCache.clear();\n  }\n}\n\nexport function getArtifactCacheStats(): { size: number; keys: string[] } {\n  return {\n    size: artifactCache.size,\n    keys: Array.from(artifactCache.keys()),\n  };\n}\n"],"mappings":"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","names":["ADORN_META","path","op","op","op","op","ADORN_META","Ajv","addFormats","path","ADORN_META","path","fs"]}
+{"version":3,"sources":["../src/index.ts","../src/runtime/polyfill.ts","../src/runtime/metadata/key.ts","../src/runtime/metadata/bucket.ts","../src/decorators/Controller.ts","../src/decorators/methods.ts","../src/decorators/Use.ts","../src/decorators/Auth.ts","../src/decorators/Public.ts","../src/runtime/metadata/read.ts","../src/schema/decorators.ts","../src/runtime/validation/ajv.ts","../src/http.ts","../src/compiler/cache/loadArtifacts.ts","../src/utils/port.ts"],"sourcesContent":["import \"./runtime/polyfill.js\";\n\nexport { Controller, Get, Post, Put, Patch, Delete, Use, Auth, Public } from \"./decorators/index.js\";\nexport { readAdornBucket } from \"./runtime/metadata/read.js\";\nexport type { HttpMethod, RouteOperation, AdornBucket, AuthMeta, ExpressMw } from \"./runtime/metadata/types.js\";\nexport type { AuthSchemeRuntime, AuthResult } from \"./runtime/auth/runtime.js\";\nexport * from \"./schema/index.js\";\nexport { createValidator, formatValidationErrors, ValidationErrorResponse } from \"./runtime/validation/index.js\";\nexport { PartType, File, PartType as PartType2, Consumes, Produces } from \"./http.js\";\nexport type { Query, Body, Headers, Cookies, PaginationParams, PaginatedResponse, HttpMetadata, FilePartOptions } from \"./http.js\";\nexport type { UploadFile } from \"./runtime/upload.js\";\nexport { loadArtifacts, clearArtifactCache, getArtifactCacheStats } from \"./compiler/cache/loadArtifacts.js\";\nexport { isPortAvailable, findProcessOnPort, killProcess, waitForPort } from \"./utils/port.js\";\nexport type { ProcessInfo } from \"./utils/port.js\";\n","/**\n * Polyfill for Symbol.metadata in environments that don't natively support it.\n * This polyfill must run before any decorated classes are imported to ensure\n * the metadata API is available for decorator metadata storage.\n * \n * @remarks\n * This module provides a global polyfill for the `Symbol.metadata` well-known symbol.\n * Some JavaScript environments (like older browsers or non-standard runtimes) may not\n * natively support this symbol, which is required by the adorn-api decorator system.\n * \n * @example\n * ```typescript\n * // Import this first before any decorated classes\n * import \"adorn-api/runtime/polyfill\";\n * \n * // Now decorators can safely use Symbol.metadata\n * @Controller()\n * class MyController { }\n * ```\n * \n * @package\n */\n(Symbol as any).metadata ??= Symbol(\"Symbol.metadata\");\n\n/**\n * Export symbol to prevent tree-shaking of the polyfill module.\n * This ensures the polyfill code is retained in production builds.\n * \n * @internal\n */\nexport const ADORN_POLYFILL = Symbol(\"adorn-polyfill\");\n","/**\n * Symbol key used to store Adorn metadata in class decorator metadata.\n * \n * @remarks\n * This Symbol.for() call creates a global symbol that is used as the key\n * for storing Adorn-specific metadata in the decorator metadata store.\n * Using Symbol.for() ensures the same symbol is used across different\n * module loads.\n * \n * @internal\n */\nexport const ADORN_META = Symbol.for(\"adorn-api/meta\");\n","import { ADORN_META } from \"./key.js\";\nimport type { AdornBucket } from \"./types.js\";\n\n/**\n * Retrieves the AdornBucket from decorator metadata, creating it if necessary.\n * \n * @remarks\n * This function safely accesses the AdornBucket stored in decorator metadata.\n * If the bucket doesn't exist, it creates a new one with default values.\n * The bucket is stored under the ADORN_META symbol key.\n * \n * @param metadata - The decorator context metadata object\n * @returns The AdornBucket for the decorated class\n * @throws Error if metadata is undefined (polyfill not loaded)\n * \n * @internal\n */\nexport function getBucket(metadata: DecoratorMetadata): AdornBucket {\n  if (!metadata) {\n    throw new Error(\"Decorator context.metadata is undefined. Ensure Symbol.metadata polyfill runs before decorators.\");\n  }\n  let bucket = metadata[ADORN_META] as AdornBucket | undefined;\n  if (!bucket) {\n    bucket = { ops: [], controllerUse: [] };\n    metadata[ADORN_META] = bucket;\n  }\n  if (!bucket.controllerUse) {\n    bucket.controllerUse = [];\n  }\n  return bucket;\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\n\n/**\n * Decorator to mark a class as a controller with a base path.\n * All methods in the controller will be relative to this base path.\n * \n * @param basePath - The base path for all routes in this controller\n * \n * @example\n * ```ts\n * @Controller(\"/users\")\n * export class UsersController {\n *   @Get(\"/:id\")\n *   getUser() { }\n * }\n * ```\n */\nexport function Controller(basePath: string) {\n  return function <T extends new (...args: any[]) => any>(\n    target: T,\n    context: ClassDecoratorContext<T>\n  ): T | void {\n    const bucket = getBucket(context.metadata);\n    bucket.basePath = basePath;\n  };\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { HttpMethod } from \"../runtime/metadata/types.js\";\n\nfunction createMethodDecorator(httpMethod: HttpMethod, path: string) {\n  return function <T extends (...args: any[]) => any>(\n    target: T,\n    context: ClassMethodDecoratorContext<any, T>\n  ): T | void {\n    if (context.private || context.static) {\n      return;\n    }\n\n    const methodName = String(context.name);\n    const bucket = getBucket(context.metadata);\n\n    let op = bucket.ops.find(op => op.methodName === methodName);\n    if (!op) {\n      op = {\n        httpMethod,\n        path,\n        methodName,\n      };\n      bucket.ops.push(op);\n    } else {\n      op.httpMethod = httpMethod;\n      op.path = path;\n    }\n  };\n}\n\n/**\n * Creates a method decorator for HTTP GET requests.\n * @param path - The route path for this endpoint\n */\nexport const Get = (path: string) => createMethodDecorator(\"GET\", path);\n\n/**\n * Creates a method decorator for HTTP POST requests.\n * @param path - The route path for this endpoint\n */\nexport const Post = (path: string) => createMethodDecorator(\"POST\", path);\n\n/**\n * Creates a method decorator for HTTP PUT requests.\n * @param path - The route path for this endpoint\n */\nexport const Put = (path: string) => createMethodDecorator(\"PUT\", path);\n\n/**\n * Creates a method decorator for HTTP PATCH requests.\n * @param path - The route path for this endpoint\n */\nexport const Patch = (path: string) => createMethodDecorator(\"PATCH\", path);\n\n/**\n * Creates a method decorator for HTTP DELETE requests.\n * @param path - The route path for this endpoint\n */\nexport const Delete = (path: string) => createMethodDecorator(\"DELETE\", path);\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { ExpressMw, HttpMethod } from \"../runtime/metadata/types.js\";\n\ntype UseTarget = string | ExpressMw;\n\n/**\n * Decorator to apply middleware to a controller class or individual methods.\n * \n * @param middleware - One or more middleware functions or paths (for path-specific middleware)\n * \n * @example\n * ```ts\n * // Apply to entire controller\n * @Use(cors(), helmet())\n * @Controller(\"/api\")\n * class ApiController { }\n * \n * // Apply to specific method\n * @Use(express.json())\n * @Post(\"/upload\")\n * uploadFile() { }\n * ```\n */\nexport function Use(...middleware: UseTarget[]) {\n  return function (\n    target: any,\n    context: ClassDecoratorContext | ClassMethodDecoratorContext\n  ) {\n    if (context.kind === \"class\") {\n      const bucket = getBucket(context.metadata);\n      if (!bucket.controllerUse) {\n        bucket.controllerUse = [];\n      }\n      bucket.controllerUse.push(...middleware);\n    } else if (context.kind === \"method\") {\n      const methodName = String(context.name);\n      const bucket = getBucket(context.metadata);\n      let op = bucket.ops.find(op => op.methodName === methodName);\n      if (!op) {\n        op = {\n          httpMethod: \"GET\" as HttpMethod,\n          path: \"/\",\n          methodName,\n        };\n        bucket.ops.push(op);\n      }\n      if (!op.use) {\n        op.use = [];\n      }\n      op.use.push(...middleware);\n    } else {\n      throw new Error(\"@Use decorator can only be applied to classes or methods\");\n    }\n  };\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { HttpMethod } from \"../runtime/metadata/types.js\";\n\n/**\n * Decorator to mark a method as requiring authentication.\n * \n * @param scheme - The authentication scheme to use (e.g., \"Bearer\", \"Basic\")\n * @param options - Optional authentication configuration\n * @param options.scopes - Required permission scopes for this endpoint\n * @param options.optional - If true, authentication is optional (useful for mixed auth endpoints)\n * \n * @example\n * ```ts\n * @Auth(\"Bearer\", { scopes: [\"admin\"] })\n * @Delete(\"/users/:id\")\n * deleteUser() {\n *   // Implementation\n * }\n * ```\n */\nexport function Auth(scheme: string, options?: { scopes?: string[]; optional?: boolean }) {\n  return function (\n    target: any,\n    context: ClassMethodDecoratorContext\n  ) {\n    if (context.kind !== \"method\") {\n      throw new Error(\"@Auth decorator can only be applied to methods\");\n    }\n\n    const methodName = String(context.name);\n    const bucket = getBucket(context.metadata);\n    let op = bucket.ops.find(op => op.methodName === methodName);\n    if (!op) {\n      op = {\n        httpMethod: \"GET\" as HttpMethod,\n        path: \"/\",\n        methodName,\n      };\n      bucket.ops.push(op);\n    }\n\n    op.auth = {\n      scheme,\n      scopes: options?.scopes,\n      optional: options?.optional ?? false,\n    };\n  };\n}\n","import { getBucket } from \"../runtime/metadata/bucket.js\";\nimport type { HttpMethod } from \"../runtime/metadata/types.js\";\n\n/**\n * Decorator to mark a method as public (no authentication required).\n * Use this to explicitly allow unauthenticated access to specific endpoints.\n * \n * @example\n * ```ts\n * @Public()\n * @Get(\"/health\")\n * healthCheck() {\n *   return { status: \"ok\" };\n * }\n * ```\n */\nexport function Public() {\n  return function (\n    target: any,\n    context: ClassMethodDecoratorContext\n  ) {\n    if (context.kind !== \"method\") {\n      throw new Error(\"@Public decorator can only be applied to methods\");\n    }\n\n    const methodName = String(context.name);\n    const bucket = getBucket(context.metadata);\n    let op = bucket.ops.find(op => op.methodName === methodName);\n    if (!op) {\n      op = {\n        httpMethod: \"GET\" as HttpMethod,\n        path: \"/\",\n        methodName,\n      };\n      bucket.ops.push(op);\n    }\n\n    op.auth = \"public\";\n  };\n}\n","import { ADORN_META } from \"./key.js\";\nimport type { AdornBucket } from \"./types.js\";\n\n/**\n * Reads the AdornBucket metadata from a class constructor.\n * \n * @remarks\n * This function retrieves the AdornBucket stored on a class via the\n * Symbol.metadata mechanism. It safely handles cases where metadata\n * is not available (e.g., polyfill not loaded or class not decorated).\n * \n * @param ctor - The class constructor to read metadata from\n * @returns The AdornBucket if found, or null if not available\n * \n * @example\n * ```typescript\n * @Controller()\n * class MyController { }\n * \n * const bucket = readAdornBucket(MyController);\n * if (bucket) {\n *   console.log(bucket.ops);\n * }\n * ```\n * \n * @internal\n */\nexport function readAdornBucket(ctor: Function): AdornBucket | null {\n  const metaSym = (Symbol as any).metadata as symbol | undefined;\n  if (!metaSym) {\n    return null;\n  }\n\n  const classMetadata = (ctor as any)[metaSym] as DecoratorMetadata | undefined;\n  if (!classMetadata) {\n    return null;\n  }\n\n  const bucket = classMetadata[ADORN_META] as AdornBucket | undefined;\n  return bucket ?? null;\n}\n","const ADORN_META = Symbol.for(\"adorn-api.metadata\");\n\ninterface SchemaFrag {\n  [key: string]: unknown;\n}\n\ninterface SchemaMetadata {\n  schema: {\n    props: Record<string, SchemaFrag[]>;\n  };\n}\n\nfunction getOrCreateMetadata(metadata: Record<PropertyKey, unknown>): SchemaMetadata {\n  const meta = (metadata[ADORN_META] ??= {}) as SchemaMetadata;\n  meta.schema ??= { props: {} };\n  return meta;\n}\n\nfunction pushSchemaFrag(\n  target: Object,\n  propertyKey: string | symbol,\n  metadata: Record<PropertyKey, unknown>,\n  frag: SchemaFrag\n): void {\n  const meta = getOrCreateMetadata(metadata);\n  const props = meta.schema.props;\n  (props[propertyKey as string] ??= []).push(frag);\n}\n\ntype PropertyDecorator = (target: Object, propertyKey: string | symbol, descriptor?: PropertyDescriptor) => void;\n\nexport function Schema(frag: SchemaFrag): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, frag);\n  };\n}\n\nexport function Min(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minimum: n });\n  };\n}\n\nexport function Max(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maximum: n });\n  };\n}\n\nexport function ExclusiveMin(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { exclusiveMinimum: n });\n  };\n}\n\nexport function ExclusiveMax(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { exclusiveMaximum: n });\n  };\n}\n\nexport function MinLength(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minLength: n });\n  };\n}\n\nexport function MaxLength(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maxLength: n });\n  };\n}\n\nexport function Pattern(re: RegExp | string): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { pattern: typeof re === \"string\" ? re : re.source });\n  };\n}\n\nexport function Format(fmt: string): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { format: fmt });\n  };\n}\n\nexport function MinItems(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minItems: n });\n  };\n}\n\nexport function MaxItems(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maxItems: n });\n  };\n}\n\nexport function MinProperties(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { minProperties: n });\n  };\n}\n\nexport function MaxProperties(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { maxProperties: n });\n  };\n}\n\nexport function MultipleOf(n: number): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { multipleOf: n });\n  };\n}\n\nexport function Example(value: unknown): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { example: value });\n  };\n}\n\nexport function Examples(values: unknown[]): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { examples: values });\n  };\n}\n\nexport function Description(desc: string): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { description: desc });\n  };\n}\n\nexport function Enum<T extends string | number>(vals: T[]): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { enum: vals });\n  };\n}\n\nexport function Const<T>(val: T): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { const: val });\n  };\n}\n\nexport function Default<T>(val: T): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { default: val });\n  };\n}\n\nexport function AdditionalProperties(value: boolean | Record<string, unknown>): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { additionalProperties: value });\n  };\n}\n\nexport function Closed(): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { additionalProperties: false });\n  };\n}\n\nexport function ClosedUnevaluated(): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    pushSchemaFrag(target, propertyKey, {}, { unevaluatedProperties: false });\n  };\n}\n\nexport function Union(mode: \"anyOf\" | \"oneOf\" | \"allOf\"): ClassDecorator {\n  return function (target: Function): void {\n    (target as any)[ADORN_META] = (target as any)[ADORN_META] ?? {};\n    const meta = (target as any)[ADORN_META] as SchemaMetadata;\n    meta.schema = meta.schema ?? { props: {} };\n    (meta.schema as any).unionMode = mode;\n  };\n}\n\nexport { ADORN_META };\nexport type { SchemaFrag, SchemaMetadata };\n","import Ajv from \"ajv\";\nimport addFormats from \"ajv-formats\";\nimport type { ErrorObject } from \"ajv\";\n\n/**\n * Runtime validation module using AJV.\n * \n * @remarks\n * This module provides validation utilities using the AJV JSON schema validator.\n * It includes interfaces for validation results, errors, and helper functions\n * for creating validators and formatting error messages.\n * \n * @package\n */\n\n/**\n * Represents a single validation error with details.\n * \n * @public\n */\nexport interface ValidationError {\n  /**\n   * The JSON path to the invalid property.\n   */\n  path: string;\n  \n  /**\n   * Human-readable error message.\n   */\n  message: string;\n  \n  /**\n   * The AJV keyword that failed validation.\n   */\n  keyword: string;\n  \n  /**\n   * Additional parameters from the validation error.\n   */\n  params: Record<string, unknown>;\n}\n\n/**\n * Result of a validation operation.\n * \n * @public\n */\nexport interface ValidationResult {\n  /**\n   * Whether the data passed validation.\n   */\n  valid: boolean;\n  \n  /**\n   * Array of validation errors if validation failed, null otherwise.\n   */\n  errors: ValidationError[] | null;\n}\n\n/**\n * Error thrown when request validation fails.\n * \n * @public\n */\nexport class ValidationErrorResponse extends Error {\n  /**\n   * HTTP status code for validation errors.\n   */\n  statusCode: number;\n  \n  /**\n   * Detailed validation errors.\n   */\n  errors: ValidationError[];\n\n  /**\n   * Creates a new ValidationErrorResponse.\n   * \n   * @param statusCode - HTTP status code (typically 400)\n   * @param errors - Array of validation errors\n   */\n  constructor(statusCode: number, errors: ValidationError[]) {\n    super(\"Validation failed\");\n    this.name = \"ValidationErrorResponse\";\n    this.statusCode = statusCode;\n    this.errors = errors;\n  }\n}\n\n/**\n * Creates a configured AJV validator instance.\n * \n * @remarks\n * This function creates an AJV validator with adorn-api's default configuration,\n * including support for custom formats like \"br-phone\" for Brazilian phone numbers.\n * \n * @returns A configured AJV validator instance\n * \n * @example\n * ```typescript\n * const validator = createValidator();\n * const validate = validator.compile(mySchema);\n * const result = validate(myData);\n * ```\n * \n * @public\n */\nexport function createValidator() {\n  const ajv = new Ajv.default({\n    allErrors: true,\n    coerceTypes: false,\n    strict: false,\n    validateFormats: true,\n  });\n\n  addFormats.default(ajv);\n\n  ajv.addFormat(\"br-phone\", /^\\(\\d{2}\\)\\s\\d{5}-\\d{4}$/);\n\n  return ajv;\n}\n\n/**\n * Validates data against a JSON schema.\n * \n * @remarks\n * This function compiles the schema and validates the data, returning a\n * structured result with formatted error messages.\n * \n * @param ajv - The AJV validator instance\n * @param data - The data to validate\n * @param schema - The JSON schema to validate against\n * @param dataPath - Base path for error messages (default: \"#\")\n * @returns ValidationResult with validity and any errors\n * \n * @public\n */\nexport function validateData(\n  ajv: ReturnType<typeof createValidator>,\n  data: unknown,\n  schema: Record<string, unknown>,\n  dataPath: string = \"#\"\n): ValidationResult {\n  const validate = ajv.compile(schema);\n  const valid = validate(data);\n\n  if (valid) {\n    return { valid: true, errors: null };\n  }\n\n  const errors: ValidationError[] = (validate.errors || []).map((err: ErrorObject) => ({\n    path: formatErrorPath(dataPath, err),\n    message: err.message || \"Invalid value\",\n    keyword: err.keyword,\n    params: err.params as Record<string, unknown>,\n  }));\n\n  return { valid: false, errors };\n}\n\n/**\n * Formats an error path for display.\n * \n * @internal\n */\nfunction formatErrorPath(basePath: string, err: ErrorObject): string {\n  const instancePath = err.instancePath;\n\n  if (!instancePath || instancePath === \"\") {\n    return basePath;\n  }\n\n  if (basePath === \"#\" || basePath.endsWith(\"/\")) {\n    return `${basePath}${instancePath.slice(1)}`;\n  }\n\n  return `${basePath}${instancePath}`;\n}\n\n/**\n * Formats validation errors into a structured API response.\n * \n * @remarks\n * This function converts validation errors into a format suitable for API\n * responses, grouping errors by their path.\n * \n * @param errors - Array of validation errors\n * @returns Formatted error response object\n * \n * @public\n */\nexport function formatValidationErrors(errors: ValidationError[]): Record<string, unknown> {\n  const formatted: Record<string, string[]> = {};\n\n  for (const error of errors) {\n    const path = error.path || \"body\";\n    if (!formatted[path]) {\n      formatted[path] = [];\n    }\n    formatted[path].push(error.message);\n  }\n\n  return {\n    error: \"Validation failed\",\n    details: formatted,\n  };\n}\n","import \"./runtime/polyfill.js\";\n\nconst ADORN_META = Symbol.for(\"adorn-api.metadata\");\n\ninterface HttpMetadata {\n  consumes?: string[];\n  produces?: string[];\n  fileParts?: Record<string, FilePartOptions>;\n  cookies?: Record<string, boolean>;\n}\n\ninterface FilePartOptions {\n  contentType?: string;\n  headers?: Record<string, string>;\n}\n\ntype DecoratorMetadata = Record<PropertyKey, unknown> & { [ADORN_META]?: HttpMetadata };\n\nfunction getMetadata(target: Object | DecoratorMetadata): HttpMetadata {\n  const host = target as DecoratorMetadata;\n  const metadata = host[ADORN_META] ?? {};\n  host[ADORN_META] = metadata;\n  return metadata;\n}\n\nexport function PartType(contentTypeOrOptions: string | FilePartOptions): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    const metadata = getMetadata(target);\n    const options: FilePartOptions = typeof contentTypeOrOptions === \"string\"\n      ? { contentType: contentTypeOrOptions }\n      : contentTypeOrOptions;\n    metadata.fileParts ??= {};\n    metadata.fileParts[propertyKey.toString()] = options;\n  };\n}\n\nexport function File(): PropertyDecorator {\n  return function (target: Object, propertyKey: string | symbol): void {\n    const metadata = getMetadata(target);\n    metadata.fileParts ??= {};\n    metadata.fileParts[propertyKey.toString()] = metadata.fileParts[propertyKey.toString()] ?? {};\n  };\n}\n\nexport function Consumes(...contentTypes: string[]): ClassDecorator {\n  return function (target: Function): void {\n    const metadata = getMetadata(target.prototype);\n    metadata.consumes = contentTypes;\n  };\n}\n\nexport function Produces(...contentTypes: string[]): ClassDecorator {\n  return function (target: Function): void {\n    const metadata = getMetadata(target.prototype);\n    metadata.produces = contentTypes;\n  };\n}\n\nexport type Query<T = any> = T;\nexport type Body<T = any> = T;\nexport type Headers<T = any> = T;\nexport type Cookies<T = any> = T;\n\nexport interface PaginationParams {\n  page: number;\n  pageSize: number;\n}\n\nexport type PaginatedResponse<T> = {\n  items: T[];\n  totalItems: number;\n  page: number;\n  pageSize: number;\n};\n\nexport { ADORN_META };\nexport type { HttpMetadata, FilePartOptions, PartType as PartType2 };\n","/**\n * Cache management module for compiled artifacts.\n * Loads OpenAPI specs, manifests, and validators from the output directory.\n */\nimport fs from \"node:fs\";\nimport path from \"node:path\";\nimport { stat } from \"node:fs/promises\";\n\n/**\n * OpenAPI specification interface as loaded from openapi.json\n */\ninterface OpenApi {\n  openapi: string;\n  components?: {\n    schemas?: Record<string, unknown>;\n  };\n  paths?: Record<string, unknown>;\n  info?: Record<string, unknown>;\n  security?: Array<Record<string, string[]>>;\n}\n\n/**\n * Manifest interface describing the compiled API structure.\n * Contains metadata about the generation process and all controllers/operations.\n */\ninterface Manifest {\n  manifestVersion: number;\n  generatedAt: string;\n  generator: {\n    name: string;\n    version: string;\n    typescript: string;\n  };\n  schemas: {\n    kind: string;\n    file: string;\n    componentsSchemasPointer: string;\n  };\n  validation: {\n    mode: \"none\" | \"ajv-runtime\" | \"precompiled\";\n    precompiledModule: string | null;\n  };\n  controllers: Array<{\n    controllerId: string;\n    basePath: string;\n    operations: Array<{\n      operationId: string;\n      http: {\n        method: string;\n        path: string;\n      };\n      handler: {\n        methodName: string;\n      };\n      args: {\n        body: {\n          index: number;\n          required: boolean;\n          contentType: string;\n          schemaRef: string;\n        } | null;\n        path: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n        query: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n        headers: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n        cookies: Array<{\n          name: string;\n          index: number;\n          required: boolean;\n          schemaRef: string;\n          schemaType?: string | string[];\n        }>;\n      };\n      responses: Array<{\n        status: number;\n        contentType: string;\n        schemaRef: string;\n        isArray?: boolean;\n      }>;\n    }>;\n  }>;\n}\n\n/**\n * Validator module interface for precompiled validation logic.\n */\ninterface ValidatorModule {\n  validators: Record<string, {\n    body?: (data: unknown) => boolean;\n    response: Record<string, (data: unknown) => boolean>;\n  }>;\n  validateBody: (operationId: string, data: unknown) => { ok: boolean; errors: unknown[] | null };\n  validateResponse: (operationId: string, status: number, contentType: string, data: unknown) => { ok: boolean; errors: unknown[] | null };\n}\n\n/**\n * Internal cache entry for tracking loaded artifacts and their modification times.\n */\ninterface ArtifactCacheEntry {\n  openapi: OpenApi | null;\n  manifest: Manifest | null;\n  validators: ValidatorModule | null;\n  mtimes: {\n    openapi: number | null;\n    manifest: number | null;\n    validators: number | null;\n  };\n}\n\nconst artifactCache = new Map<string, ArtifactCacheEntry>();\n\nasync function getMtime(filePath: string): Promise<number | null> {\n  try {\n    const stats = await stat(filePath);\n    return stats.mtimeMs;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Options for loading artifacts from the output directory.\n */\nexport interface LoadArtifactsOptions {\n  outDir: string;\n}\n\n/**\n * Result of loading artifacts from the output directory.\n */\nexport interface LoadedArtifacts {\n  openapi: OpenApi;\n  manifest: Manifest;\n  validators: ValidatorModule | null;\n}\n\n/**\n * Loads OpenAPI spec, manifest, and validators from the output directory.\n * Results are cached in memory to avoid repeated file I/O.\n * \n * @param options - Object containing the output directory path\n * @returns Promise resolving to loaded artifacts including OpenAPI spec, manifest, and validators\n */\nexport async function loadArtifacts(options: LoadArtifactsOptions): Promise<LoadedArtifacts> {\n  const { outDir } = options;\n  const cacheKey = path.resolve(outDir);\n\n  const entry = artifactCache.get(cacheKey);\n\n  const openapiPath = path.join(outDir, \"openapi.json\");\n  const manifestPath = path.join(outDir, \"manifest.json\");\n  const validatorsPath = path.join(outDir, \"validators.mjs\");\n\n  const openapiMtime = await getMtime(openapiPath);\n  const manifestMtime = await getMtime(manifestPath);\n  const validatorsMtime = await getMtime(validatorsPath);\n\n  if (entry) {\n    const mtimesMatch = \n      entry.mtimes.openapi === openapiMtime &&\n      entry.mtimes.manifest === manifestMtime &&\n      entry.mtimes.validators === validatorsMtime;\n\n    if (mtimesMatch) {\n      if (entry.openapi && entry.manifest) {\n        return {\n          openapi: entry.openapi,\n          manifest: entry.manifest,\n          validators: entry.validators,\n        };\n      }\n    }\n  }\n\n  const openapiContent = fs.readFileSync(openapiPath, \"utf-8\");\n  const manifestContent = fs.readFileSync(manifestPath, \"utf-8\");\n\n  const openapi = JSON.parse(openapiContent) as OpenApi;\n  const manifest = JSON.parse(manifestContent) as Manifest;\n\n  let validators: ValidatorModule | null = null;\n\n  if (manifest.validation.mode === \"precompiled\" && manifest.validation.precompiledModule) {\n    try {\n      const validatorsModule = await import(path.join(outDir, manifest.validation.precompiledModule));\n      validators = validatorsModule as ValidatorModule;\n    } catch (err) {\n      console.warn(`Failed to load precompiled validators: ${err}`);\n    }\n  }\n\n  artifactCache.set(cacheKey, {\n    openapi,\n    manifest,\n    validators,\n    mtimes: {\n      openapi: openapiMtime,\n      manifest: manifestMtime,\n      validators: validatorsMtime,\n    },\n  });\n\n  return {\n    openapi,\n    manifest,\n    validators,\n  };\n}\n\n/**\n * Clears the in-memory artifact cache.\n * If an output directory is specified, only that entry is removed.\n * Otherwise, the entire cache is cleared.\n * \n * @param outDir - Optional specific output directory to clear from cache\n */\nexport function clearArtifactCache(outDir?: string): void {\n  if (outDir) {\n    const cacheKey = path.resolve(outDir);\n    artifactCache.delete(cacheKey);\n  } else {\n    artifactCache.clear();\n  }\n}\n\n/**\n * Returns statistics about the current artifact cache state.\n * Useful for debugging and monitoring cache behavior.\n * \n * @returns Object containing cache size and array of cached keys\n */\nexport function getArtifactCacheStats(): { size: number; keys: string[] } {\n  return {\n    size: artifactCache.size,\n    keys: Array.from(artifactCache.keys()),\n  };\n}\n","import { createServer, Server } from \"net\";\nimport { exec } from \"child_process\";\nimport { promisify } from \"util\";\n\nconst execAsync = promisify(exec);\n\nexport interface ProcessInfo {\n  pid: number;\n  command?: string;\n}\n\nexport async function isPortAvailable(port: number, host: string = \"0.0.0.0\"): Promise<boolean> {\n  return new Promise<boolean>((resolve) => {\n    const server: Server = createServer();\n\n    server.on(\"error\", (err: any) => {\n      if (err.code === \"EADDRINUSE\") {\n        resolve(false);\n      } else {\n        resolve(false);\n      }\n    });\n\n    server.once(\"listening\", () => {\n      server.close(() => {\n        resolve(true);\n      });\n    });\n\n    server.listen(port, host);\n  });\n}\n\nexport async function findProcessOnPort(port: number): Promise<ProcessInfo | null> {\n  try {\n    const platform = process.platform;\n\n    if (platform === \"win32\") {\n      const { stdout } = await execAsync(`netstat -ano | findstr :${port}`);\n      \n      for (const line of stdout.split(\"\\n\")) {\n        const trimmed = line.trim();\n        if (!trimmed || trimmed.includes(\"PID\")) continue;\n        \n        const parts = trimmed.split(/\\s+/);\n        if (parts.length >= 5) {\n          const address = parts[1];\n          const pid = parseInt(parts[parts.length - 1], 10);\n          \n          if (address.includes(`:${port}`) && !isNaN(pid)) {\n            const command = await getProcessNameOnWindows(pid);\n            return { pid, command };\n          }\n        }\n      }\n    } else {\n      const { stdout } = await execAsync(`lsof -ti:${port}`);\n      const pids = stdout.trim().split(\"\\n\").filter(Boolean).map(Number);\n      \n      if (pids.length > 0) {\n        const pid = pids[0];\n        const command = await getProcessNameOnUnix(pid);\n        return { pid, command };\n      }\n    }\n\n    return null;\n  } catch (error: any) {\n    if (error.message.includes(\"matches found\")) {\n      return null;\n    }\n    return null;\n  }\n}\n\nasync function getProcessNameOnWindows(pid: number): Promise<string | undefined> {\n  try {\n    const { stdout } = await execAsync(`tasklist /FI \"PID eq ${pid}\" /FO CSV /NH`);\n    const line = stdout.trim().split(\"\\n\")[0];\n    if (line) {\n      const parts = line.split('\",\"');\n      if (parts.length >= 2) {\n        return parts[0].replace(/\"/g, \"\");\n      }\n    }\n  } catch {\n    return undefined;\n  }\n}\n\nasync function getProcessNameOnUnix(pid: number): Promise<string | undefined> {\n  try {\n    const { stdout } = await execAsync(`ps -p ${pid} -o comm=`);\n    return stdout.trim() || undefined;\n  } catch {\n    return undefined;\n  }\n}\n\nexport async function killProcess(pid: number): Promise<boolean> {\n  try {\n    process.kill(pid, \"SIGTERM\");\n    \n    await new Promise<void>((resolve, reject) => {\n      const timeout = setTimeout(() => {\n        reject(new Error(\"Process did not terminate gracefully\"));\n      }, 5000);\n      \n      const check = () => {\n        try {\n          process.kill(pid, 0);\n          setTimeout(check, 500);\n        } catch {\n          clearInterval(interval);\n          clearTimeout(timeout);\n          resolve();\n        }\n      };\n      \n      const interval = setInterval(check, 500);\n    });\n    \n    return true;\n  } catch {\n    try {\n      process.kill(pid, \"SIGKILL\");\n      await new Promise<void>((resolve, reject) => {\n        const timeout = setTimeout(() => {\n          reject(new Error(\"Process did not terminate\"));\n        }, 3000);\n        \n        setTimeout(() => {\n          try {\n            process.kill(pid, 0);\n            clearTimeout(timeout);\n            reject(new Error(\"Process still running\"));\n          } catch {\n            clearTimeout(timeout);\n            resolve();\n          }\n        }, 1000);\n      });\n      \n      return true;\n    } catch {\n      return false;\n    }\n  }\n}\n\nexport async function waitForPort(port: number, host: string = \"0.0.0.0\", timeout: number = 5000): Promise<boolean> {\n  const start = Date.now();\n  \n  while (Date.now() - start < timeout) {\n    if (await isPortAvailable(port, host)) {\n      return true;\n    }\n    await new Promise(resolve => setTimeout(resolve, 200));\n  }\n  \n  return false;\n}\n"],"mappings":"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","names":["ADORN_META","path","op","op","op","op","ADORN_META","Ajv","addFormats","path","ADORN_META","path","fs"]}

package/dist/index.d.ts

@@ -9,4 +9,6 @@ export { PartType, File, PartType as PartType2, Consumes, Produces } from "./htt
 export type { Query, Body, Headers, Cookies, PaginationParams, PaginatedResponse, HttpMetadata, FilePartOptions } from "./http.js";
 export type { UploadFile } from "./runtime/upload.js";
 export { loadArtifacts, clearArtifactCache, getArtifactCacheStats } from "./compiler/cache/loadArtifacts.js";
+export { isPortAvailable, findProcessOnPort, killProcess, waitForPort } from "./utils/port.js";
+export type { ProcessInfo } from "./utils/port.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAChH,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC/E,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACjH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACtF,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACnI,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,uBAAuB,CAAC;AAE/B,OAAO,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACrG,OAAO,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAC7D,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAChH,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC/E,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACjH,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACtF,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACnI,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC/F,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -287,11 +287,25 @@ function Union(mode) {
 import Ajv from "ajv";
 import addFormats from "ajv-formats";
 var ValidationErrorResponse = class extends Error {
+  /**
+   * HTTP status code for validation errors.
+   */
+  statusCode;
+  /**
+   * Detailed validation errors.
+   */
+  errors;
+  /**
+   * Creates a new ValidationErrorResponse.
+   * 
+   * @param statusCode - HTTP status code (typically 400)
+   * @param errors - Array of validation errors
+   */
   constructor(statusCode, errors) {
     super("Validation failed");
+    this.name = "ValidationErrorResponse";
     this.statusCode = statusCode;
     this.errors = errors;
-    this.name = "ValidationErrorResponse";
   }
 };
 function createValidator() {
@@ -372,7 +386,7 @@ async function getMtime(filePath) {
 async function loadArtifacts(options) {
   const { outDir } = options;
   const cacheKey = path.resolve(outDir);
-  let entry = artifactCache.get(cacheKey);
+  const entry = artifactCache.get(cacheKey);
   const openapiPath = path.join(outDir, "openapi.json");
   const manifestPath = path.join(outDir, "manifest.json");
   const validatorsPath = path.join(outDir, "validators.mjs");
@@ -434,6 +448,141 @@ function getArtifactCacheStats() {
     keys: Array.from(artifactCache.keys())
   };
 }
+
+// src/utils/port.ts
+import { createServer } from "net";
+import { exec } from "child_process";
+import { promisify } from "util";
+var execAsync = promisify(exec);
+async function isPortAvailable(port, host = "0.0.0.0") {
+  return new Promise((resolve) => {
+    const server = createServer();
+    server.on("error", (err) => {
+      if (err.code === "EADDRINUSE") {
+        resolve(false);
+      } else {
+        resolve(false);
+      }
+    });
+    server.once("listening", () => {
+      server.close(() => {
+        resolve(true);
+      });
+    });
+    server.listen(port, host);
+  });
+}
+async function findProcessOnPort(port) {
+  try {
+    const platform = process.platform;
+    if (platform === "win32") {
+      const { stdout } = await execAsync(`netstat -ano | findstr :${port}`);
+      for (const line of stdout.split("\n")) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.includes("PID")) continue;
+        const parts = trimmed.split(/\s+/);
+        if (parts.length >= 5) {
+          const address = parts[1];
+          const pid = parseInt(parts[parts.length - 1], 10);
+          if (address.includes(`:${port}`) && !isNaN(pid)) {
+            const command = await getProcessNameOnWindows(pid);
+            return { pid, command };
+          }
+        }
+      }
+    } else {
+      const { stdout } = await execAsync(`lsof -ti:${port}`);
+      const pids = stdout.trim().split("\n").filter(Boolean).map(Number);
+      if (pids.length > 0) {
+        const pid = pids[0];
+        const command = await getProcessNameOnUnix(pid);
+        return { pid, command };
+      }
+    }
+    return null;
+  } catch (error) {
+    if (error.message.includes("matches found")) {
+      return null;
+    }
+    return null;
+  }
+}
+async function getProcessNameOnWindows(pid) {
+  try {
+    const { stdout } = await execAsync(`tasklist /FI "PID eq ${pid}" /FO CSV /NH`);
+    const line = stdout.trim().split("\n")[0];
+    if (line) {
+      const parts = line.split('","');
+      if (parts.length >= 2) {
+        return parts[0].replace(/"/g, "");
+      }
+    }
+  } catch {
+    return void 0;
+  }
+}
+async function getProcessNameOnUnix(pid) {
+  try {
+    const { stdout } = await execAsync(`ps -p ${pid} -o comm=`);
+    return stdout.trim() || void 0;
+  } catch {
+    return void 0;
+  }
+}
+async function killProcess(pid) {
+  try {
+    process.kill(pid, "SIGTERM");
+    await new Promise((resolve, reject) => {
+      const timeout = setTimeout(() => {
+        reject(new Error("Process did not terminate gracefully"));
+      }, 5e3);
+      const check = () => {
+        try {
+          process.kill(pid, 0);
+          setTimeout(check, 500);
+        } catch {
+          clearInterval(interval);
+          clearTimeout(timeout);
+          resolve();
+        }
+      };
+      const interval = setInterval(check, 500);
+    });
+    return true;
+  } catch {
+    try {
+      process.kill(pid, "SIGKILL");
+      await new Promise((resolve, reject) => {
+        const timeout = setTimeout(() => {
+          reject(new Error("Process did not terminate"));
+        }, 3e3);
+        setTimeout(() => {
+          try {
+            process.kill(pid, 0);
+            clearTimeout(timeout);
+            reject(new Error("Process still running"));
+          } catch {
+            clearTimeout(timeout);
+            resolve();
+          }
+        }, 1e3);
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+async function waitForPort(port, host = "0.0.0.0", timeout = 5e3) {
+  const start = Date.now();
+  while (Date.now() - start < timeout) {
+    if (await isPortAvailable(port, host)) {
+      return true;
+    }
+    await new Promise((resolve) => setTimeout(resolve, 200));
+  }
+  return false;
+}
 export {
   ADORN_META2 as ADORN_META,
   AdditionalProperties,
@@ -477,9 +626,13 @@ export {
   ValidationErrorResponse,
   clearArtifactCache,
   createValidator,
+  findProcessOnPort,
   formatValidationErrors,
   getArtifactCacheStats,
+  isPortAvailable,
+  killProcess,
   loadArtifacts,
-  readAdornBucket
+  readAdornBucket,
+  waitForPort
 };
 //# sourceMappingURL=index.js.map