adorn-api 1.0.12 → 1.0.14

package/dist/runtime/upload.d.ts

@@ -1,7 +1,44 @@
+/**
+ * Represents an uploaded file in the request.
+ *
+ * @remarks
+ * This interface describes the structure of a file uploaded via multipart/form-data
+ * requests. It provides metadata about the file as well as access to its contents
+ * through a readable stream.
+ *
+ * @example
+ * ```typescript
+ * async function handleUpload(file: UploadFile) {
+ *   console.log(`Received file: ${file.filename}`);
+ *   console.log(`Type: ${file.mimeType}`);
+ *   console.log(`Size: ${file.size} bytes`);
+ *
+ *   // Process the file stream
+ *   for await (const chunk of file.stream) {
+ *     // Handle chunk...
+ *   }
+ * }
+ * ```
+ *
+ * @public
+ */
 export interface UploadFile {
+    /**
+     * The original filename as sent by the client.
+     */
     filename: string;
+    /**
+     * The MIME type of the file (e.g., "image/png", "application/pdf").
+     */
     mimeType: string;
+    /**
+     * The file size in bytes, if available.
+     */
     size?: number;
+    /**
+     * A Node.js readable stream to read the file contents.
+     * Use this to pipe, transform, or buffer the file data.
+     */
     stream: NodeJS.ReadableStream;
 }
 //# sourceMappingURL=upload.d.ts.map

package/dist/runtime/upload.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/runtime/upload.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;CAC/B"}
+{"version":3,"file":"upload.d.ts","sourceRoot":"","sources":["../../src/runtime/upload.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;;OAGG;IACH,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;CAC/B"}

package/dist/runtime/validation/ajv.d.ts

@@ -1,20 +1,120 @@
 import Ajv from "ajv";
+/**
+ * Runtime validation module using AJV.
+ *
+ * @remarks
+ * This module provides validation utilities using the AJV JSON schema validator.
+ * It includes interfaces for validation results, errors, and helper functions
+ * for creating validators and formatting error messages.
+ *
+ * @package
+ */
+/**
+ * Represents a single validation error with details.
+ *
+ * @public
+ */
 export interface ValidationError {
+    /**
+     * The JSON path to the invalid property.
+     */
     path: string;
+    /**
+     * Human-readable error message.
+     */
     message: string;
+    /**
+     * The AJV keyword that failed validation.
+     */
     keyword: string;
+    /**
+     * Additional parameters from the validation error.
+     */
     params: Record<string, unknown>;
 }
+/**
+ * Result of a validation operation.
+ *
+ * @public
+ */
 export interface ValidationResult {
+    /**
+     * Whether the data passed validation.
+     */
     valid: boolean;
+    /**
+     * Array of validation errors if validation failed, null otherwise.
+     */
     errors: ValidationError[] | null;
 }
+/**
+ * Error thrown when request validation fails.
+ *
+ * @public
+ */
 export declare class ValidationErrorResponse extends Error {
+    /**
+     * HTTP status code for validation errors.
+     */
     statusCode: number;
+    /**
+     * Detailed validation errors.
+     */
     errors: ValidationError[];
+    /**
+     * Creates a new ValidationErrorResponse.
+     *
+     * @param statusCode - HTTP status code (typically 400)
+     * @param errors - Array of validation errors
+     */
     constructor(statusCode: number, errors: ValidationError[]);
 }
+/**
+ * Creates a configured AJV validator instance.
+ *
+ * @remarks
+ * This function creates an AJV validator with adorn-api's default configuration,
+ * including support for custom formats like "br-phone" for Brazilian phone numbers.
+ *
+ * @returns A configured AJV validator instance
+ *
+ * @example
+ * ```typescript
+ * const validator = createValidator();
+ * const validate = validator.compile(mySchema);
+ * const result = validate(myData);
+ * ```
+ *
+ * @public
+ */
 export declare function createValidator(): Ajv.Ajv;
+/**
+ * Validates data against a JSON schema.
+ *
+ * @remarks
+ * This function compiles the schema and validates the data, returning a
+ * structured result with formatted error messages.
+ *
+ * @param ajv - The AJV validator instance
+ * @param data - The data to validate
+ * @param schema - The JSON schema to validate against
+ * @param dataPath - Base path for error messages (default: "#")
+ * @returns ValidationResult with validity and any errors
+ *
+ * @public
+ */
 export declare function validateData(ajv: ReturnType<typeof createValidator>, data: unknown, schema: Record<string, unknown>, dataPath?: string): ValidationResult;
+/**
+ * Formats validation errors into a structured API response.
+ *
+ * @remarks
+ * This function converts validation errors into a format suitable for API
+ * responses, grouping errors by their path.
+ *
+ * @param errors - Array of validation errors
+ * @returns Formatted error response object
+ *
+ * @public
+ */
 export declare function formatValidationErrors(errors: ValidationError[]): Record<string, unknown>;
 //# sourceMappingURL=ajv.d.ts.map

package/dist/runtime/validation/ajv.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ajv.d.ts","sourceRoot":"","sources":["../../../src/runtime/validation/ajv.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAItB,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CAClC;AAED,qBAAa,uBAAwB,SAAQ,KAAK;IAEvC,UAAU,EAAE,MAAM;IAClB,MAAM,EAAE,eAAe,EAAE;gBADzB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,EAAE;CAKnC;AAED,wBAAgB,eAAe,YAa9B;AAED,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EACvC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,GAAE,MAAY,GACrB,gBAAgB,CAgBlB;AAgBD,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezF"}
+{"version":3,"file":"ajv.d.ts","sourceRoot":"","sources":["../../../src/runtime/validation/ajv.ts"],"names":[],"mappings":"AAAA,OAAO,GAAG,MAAM,KAAK,CAAC;AAItB;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,MAAM,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;CAClC;AAED;;;;GAIG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;IAChD;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,EAAE,eAAe,EAAE,CAAC;IAE1B;;;;;OAKG;gBACS,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,EAAE;CAM1D;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,YAa9B;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,GAAG,EAAE,UAAU,CAAC,OAAO,eAAe,CAAC,EACvC,IAAI,EAAE,OAAO,EACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,GAAE,MAAY,GACrB,gBAAgB,CAgBlB;AAqBD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAezF"}

package/dist/runtime/validation/index.d.ts

@@ -1,2 +1,11 @@
+/**
+ * Re-exports all validation utilities.
+ *
+ * @remarks
+ * This module re-exports the validation functionality provided by the AJV-based
+ * validation system, including validation results, errors, and helper functions.
+ *
+ * @package
+ */
 export * from "./ajv.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/runtime/validation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/validation/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,cAAc,UAAU,CAAC"}

package/dist/scripts/adorn-example.cjs

@@ -24,10 +24,148 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 
 // scripts/adorn-example.ts
-var import_child_process = require("child_process");
+var import_child_process2 = require("child_process");
 var import_path = require("path");
 var import_fs = require("fs");
 var import_node_process = __toESM(require("process"), 1);
+var readline = __toESM(require("readline"), 1);
+
+// 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;
+}
+
+// scripts/adorn-example.ts
 function findRepoRoot(startDir) {
   let current = startDir;
   while (true) {
@@ -59,12 +197,12 @@ function isWindows() {
 }
 function runCommand(command, cwd) {
   const shell = isWindows() ? "cmd.exe" : "/bin/bash";
-  (0, import_child_process.execSync)(command, { cwd, stdio: "inherit", shell });
+  (0, import_child_process2.execSync)(command, { cwd, stdio: "inherit", shell });
 }
 function spawnCommand(args, cwd) {
   return new Promise((resolve, reject) => {
     const cmd = isWindows() ? "npm.cmd" : "npm";
-    const child = (0, import_child_process.spawn)(cmd, args, {
+    const child = (0, import_child_process2.spawn)(cmd, args, {
       cwd,
       stdio: "inherit",
       shell: isWindows()
@@ -98,10 +236,86 @@ ${getExamples().map((e) => `  - ${e}`).join("\n")}
 Options:
   -h, --help     Show this help message
   -l, --list     List all available examples
+  -f, --force    Force kill process on port without prompting
+  -p, --port     Specify port (default: 3000, env: ADORN_EXAMPLE_PORT)
 
 From the adorn-api project root, you can also use:
   npm run example <example-name>
-`);
+  `);
+}
+async function promptWithTimeout(question, timeout = 1e4) {
+  const rl = readline.createInterface({
+    input: import_node_process.default.stdin,
+    output: import_node_process.default.stdout
+  });
+  let timeoutId = null;
+  const timeoutPromise = new Promise((resolve) => {
+    timeoutId = setTimeout(() => {
+      rl.close();
+      console.log("\n\u23F0 Timed out waiting for input");
+      resolve(null);
+    }, timeout);
+  });
+  const inputPromise = new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      if (timeoutId) clearTimeout(timeoutId);
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+  return Promise.race([inputPromise, timeoutPromise]);
+}
+async function ensurePortAvailable(targetPort, force) {
+  console.log(`
+\u{1F50D} Checking port ${targetPort}...`);
+  if (await isPortAvailable(targetPort)) {
+    console.log(`\u2713 Port ${targetPort} is available`);
+    return;
+  }
+  console.log(`\u274C Port ${targetPort} is already in use.`);
+  const processInfo = await findProcessOnPort(targetPort);
+  if (!processInfo) {
+    console.error("   Could not determine process using this port");
+    console.error("   Please stop it manually or use a different port (ADORN_EXAMPLE_PORT env var)");
+    import_node_process.default.exit(1);
+  }
+  const { pid, command } = processInfo;
+  console.log(`   Process PID: ${pid}`);
+  if (command) {
+    console.log(`   Command: ${command}`);
+  }
+  if (force) {
+    console.log(`
+   Force flag enabled, killing process ${pid}...`);
+  } else {
+    const answer = await promptWithTimeout("   Kill existing process? (y/n): ", 1e4);
+    if (answer === null) {
+      console.log("\n\u274C Aborted. Please stop the process manually or use a different port");
+      import_node_process.default.exit(1);
+    }
+    if (answer.toLowerCase() !== "y" && answer.toLowerCase() !== "yes") {
+      console.log("\n\u274C Aborted. Please stop the process manually or use a different port");
+      console.log("   You can also use the --force flag to auto-kill");
+      import_node_process.default.exit(1);
+    }
+  }
+  console.log(`   Terminating process ${pid}...`);
+  if (await killProcess(pid)) {
+    console.log("   \u2713 Process killed successfully");
+    console.log(`   Waiting for port ${targetPort} to be released...`);
+    const released = await waitForPort(targetPort, "0.0.0.0", 3e3);
+    if (!released) {
+      console.error(`
+\u274C Port ${targetPort} still in use after killing process`);
+      import_node_process.default.exit(1);
+    }
+    console.log(`   \u2713 Port ${targetPort} is now available`);
+  } else {
+    console.error(`
+\u274C Failed to kill process ${pid}`);
+    console.error("   You may need to kill it manually or choose a different port");
+    import_node_process.default.exit(1);
+  }
 }
 async function main() {
   const args = import_node_process.default.argv.slice(2);
@@ -114,7 +328,24 @@ async function main() {
     getExamples().forEach((ex) => console.log(`  - ${ex}`));
     import_node_process.default.exit(0);
   }
-  const example = args[0] || "basic";
+  const forceFlag = args.includes("-f") || args.includes("--force");
+  const portIndex = args.indexOf("-p") !== -1 ? args.indexOf("-p") : args.indexOf("--port");
+  let targetPort = Number(import_node_process.default.env.ADORN_EXAMPLE_PORT || 3e3);
+  if (portIndex !== -1 && args[portIndex + 1]) {
+    const portArg = Number(args[portIndex + 1]);
+    if (!isNaN(portArg) && portArg > 0 && portArg <= 65535) {
+      targetPort = portArg;
+    } else {
+      console.error(`
+\u274C Invalid port number: ${args[portIndex + 1]}`);
+      console.error("   Port must be between 1 and 65535");
+      import_node_process.default.exit(1);
+    }
+  }
+  const filteredArgs = args.filter(
+    (arg) => !["-f", "--force", "-p", "--port"].includes(arg) && (portIndex === -1 || arg !== args[portIndex + 1])
+  );
+  const example = filteredArgs[0] || "basic";
   const examplePath = (0, import_path.join)(repoRoot, "examples", example);
   if (!(0, import_fs.existsSync)(examplePath)) {
     console.error(`
@@ -137,7 +368,8 @@ async function main() {
     }
     console.log("\u{1F4E6} Building artifacts...");
     runCommand("npm run build", examplePath);
-    console.log("\u{1F310} Starting server...\n");
+    await ensurePortAvailable(targetPort, forceFlag);
+    console.log("\n\u{1F310} Starting server...\n");
     console.log("Press Ctrl+C to stop\n");
     child = await spawnCommand(["run", "dev"], examplePath);
     import_node_process.default.on("SIGINT", () => {

package/dist/scripts/adorn-example.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../scripts/adorn-example.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Adorn-API Example Runner\n * \n * Usage:\n *   npx adorn-example <example-name>\n *   npx adorn-example blog-platform\n *   npx adorn-example task-manager\n * \n * Or from the adorn-api project root:\n *   npm run example <example-name>\n */\n\nimport { execSync, spawn, ChildProcess } from \"child_process\";\nimport { dirname, join } from \"path\";\nimport { existsSync, readdirSync, statSync } from \"fs\";\nimport process from \"node:process\";\n\nfunction findRepoRoot(startDir: string): string | null {\n  let current = startDir;\n  while (true) {\n    const examplesDir = join(current, \"examples\");\n    const packageJson = join(current, \"package.json\");\n    if (existsSync(examplesDir) && existsSync(packageJson)) {\n      return current;\n    }\n    const parent = dirname(current);\n    if (parent === current) {\n      return null;\n    }\n    current = parent;\n  }\n}\n\nfunction resolveRepoRoot(): string {\n  const candidates = [process.env.INIT_CWD, process.cwd()].filter(\n    (dir): dir is string => Boolean(dir),\n  );\n\n  for (const candidate of candidates) {\n    const root = findRepoRoot(candidate);\n    if (root) return root;\n  }\n\n  return process.cwd();\n}\n\nconst repoRoot = resolveRepoRoot();\n\nfunction isWindows(): boolean {\n  return process.platform === \"win32\";\n}\n\nfunction runCommand(command: string, cwd: string): void {\n  const shell = isWindows() ? \"cmd.exe\" : \"/bin/bash\";\n  execSync(command, { cwd, stdio: \"inherit\", shell });\n}\n\nfunction spawnCommand(args: string[], cwd: string): Promise<ChildProcess> {\n  return new Promise((resolve, reject) => {\n    const cmd = isWindows() ? \"npm.cmd\" : \"npm\";\n    const child = spawn(cmd, args, {\n      cwd,\n      stdio: \"inherit\",\n      shell: isWindows(),\n    });\n\n    child.on(\"error\", reject);\n    resolve(child);\n  });\n}\n\nfunction getExamples(): string[] {\n  const examplesDir = join(repoRoot, \"examples\");\n  if (!existsSync(examplesDir)) return [];\n  return readdirSync(examplesDir).filter(name => {\n    const path = join(examplesDir, name);\n    return statSync(path).isDirectory();\n  });\n}\n\nfunction printHelp(): void {\n  console.log(`\nUsage: npx adorn-example <example-name>\n\nRun an adorn-api example with automatic dependency installation.\n\nExamples:\n  npx adorn-example blog-platform\n  npx adorn-example task-manager\n  npx adorn-example basic\n\nAvailable examples:\n${getExamples().map(e => `  - ${e}`).join(\"\\n\")}\n\nOptions:\n  -h, --help     Show this help message\n  -l, --list     List all available examples\n\nFrom the adorn-api project root, you can also use:\n  npm run example <example-name>\n`);\n}\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2);\n  \n  if (args.includes(\"-h\") || args.includes(\"--help\")) {\n    printHelp();\n    process.exit(0);\n  }\n\n  if (args.includes(\"-l\") || args.includes(\"--list\")) {\n    console.log(\"Available examples:\");\n    getExamples().forEach(ex => console.log(`  - ${ex}`));\n    process.exit(0);\n  }\n\n  const example = args[0] || \"basic\";\n  const examplePath = join(repoRoot, \"examples\", example);\n\n  if (!existsSync(examplePath)) {\n    console.error(`\\n❌ Example \"${example}\" not found.\\n`);\n    console.log(\"Available examples:\");\n    getExamples().forEach(ex => console.log(`  - ${ex}`));\n    process.exit(1);\n  }\n\n  console.log(`\\n🚀 Running \"${example}\" example...\\n`);\n\n  let child: ChildProcess | null = null;\n\n  try {\n    const nodeModulesPath = join(examplePath, \"node_modules\");\n    const nodeModulesExists = existsSync(nodeModulesPath);\n\n    if (!nodeModulesExists) {\n      console.log(\"📦 Installing dependencies...\");\n      runCommand(\"npm install\", examplePath);\n    }\n\n    console.log(\"📦 Building artifacts...\");\n    runCommand(\"npm run build\", examplePath);\n\n    console.log(\"🌐 Starting server...\\n\");\n    console.log(\"Press Ctrl+C to stop\\n\");\n\n    child = await spawnCommand([\"run\", \"dev\"], examplePath);\n\n    process.on(\"SIGINT\", () => {\n      if (child) child.kill(\"SIGINT\");\n    });\n\n    process.on(\"SIGTERM\", () => {\n      if (child) child.kill(\"SIGTERM\");\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      if (!child) {\n        reject(new Error(\"Child process not started\"));\n        return;\n      }\n      child.on(\"exit\", (code) => {\n        if (code === 0 || code === null) {\n          resolve();\n        } else {\n          reject(new Error(`Process exited with code ${code}`));\n        }\n      });\n      child.on(\"error\", reject);\n    });\n  } catch (err: any) {\n    if (err.code !== \"SIGINT\" && err.code !== \"SIGTERM\") {\n      console.error(`\\n❌ Error: ${err.message}`);\n      process.exit(1);\n    }\n  }\n}\n\nmain();\n"],"mappings":"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","names":["process"]}
+{"version":3,"sources":["../../scripts/adorn-example.ts","../../src/utils/port.ts"],"sourcesContent":["#!/usr/bin/env node\n\n/**\n * Adorn-API Example Runner\n * \n * Usage:\n *   npx adorn-example <example-name>\n *   npx adorn-example blog-platform\n *   npx adorn-example task-manager\n * \n * Or from the adorn-api project root:\n *   npm run example <example-name>\n */\n\nimport { execSync, spawn, ChildProcess } from \"child_process\";\nimport { dirname, join } from \"path\";\nimport { existsSync, readdirSync, statSync } from \"fs\";\nimport process from \"node:process\";\nimport * as readline from \"readline\";\nimport { isPortAvailable, findProcessOnPort, killProcess, waitForPort } from \"../src/utils/port\";\n\nfunction findRepoRoot(startDir: string): string | null {\n  let current = startDir;\n  while (true) {\n    const examplesDir = join(current, \"examples\");\n    const packageJson = join(current, \"package.json\");\n    if (existsSync(examplesDir) && existsSync(packageJson)) {\n      return current;\n    }\n    const parent = dirname(current);\n    if (parent === current) {\n      return null;\n    }\n    current = parent;\n  }\n}\n\nfunction resolveRepoRoot(): string {\n  const candidates = [process.env.INIT_CWD, process.cwd()].filter(\n    (dir): dir is string => Boolean(dir),\n  );\n\n  for (const candidate of candidates) {\n    const root = findRepoRoot(candidate);\n    if (root) return root;\n  }\n\n  return process.cwd();\n}\n\nconst repoRoot = resolveRepoRoot();\n\nfunction isWindows(): boolean {\n  return process.platform === \"win32\";\n}\n\nfunction runCommand(command: string, cwd: string): void {\n  const shell = isWindows() ? \"cmd.exe\" : \"/bin/bash\";\n  execSync(command, { cwd, stdio: \"inherit\", shell });\n}\n\nfunction spawnCommand(args: string[], cwd: string): Promise<ChildProcess> {\n  return new Promise((resolve, reject) => {\n    const cmd = isWindows() ? \"npm.cmd\" : \"npm\";\n    const child = spawn(cmd, args, {\n      cwd,\n      stdio: \"inherit\",\n      shell: isWindows(),\n    });\n\n    child.on(\"error\", reject);\n    resolve(child);\n  });\n}\n\nfunction getExamples(): string[] {\n  const examplesDir = join(repoRoot, \"examples\");\n  if (!existsSync(examplesDir)) return [];\n  return readdirSync(examplesDir).filter(name => {\n    const path = join(examplesDir, name);\n    return statSync(path).isDirectory();\n  });\n}\n\nfunction printHelp(): void {\n  console.log(`\nUsage: npx adorn-example <example-name>\n\nRun an adorn-api example with automatic dependency installation.\n\nExamples:\n  npx adorn-example blog-platform\n  npx adorn-example task-manager\n  npx adorn-example basic\n\nAvailable examples:\n${getExamples().map(e => `  - ${e}`).join(\"\\n\")}\n\nOptions:\n  -h, --help     Show this help message\n  -l, --list     List all available examples\n  -f, --force    Force kill process on port without prompting\n  -p, --port     Specify port (default: 3000, env: ADORN_EXAMPLE_PORT)\n\nFrom the adorn-api project root, you can also use:\n  npm run example <example-name>\n  `);\n}\n\nasync function promptWithTimeout(question: string, timeout: number = 10000): Promise<string | null> {\n  const rl = readline.createInterface({\n    input: process.stdin,\n    output: process.stdout,\n  });\n\n  let timeoutId: NodeJS.Timeout | null = null;\n\n  const timeoutPromise = new Promise<string | null>((resolve) => {\n    timeoutId = setTimeout(() => {\n      rl.close();\n      console.log(\"\\n⏰ Timed out waiting for input\");\n      resolve(null);\n    }, timeout);\n  });\n\n  const inputPromise = new Promise<string>((resolve) => {\n    rl.question(question, (answer) => {\n      if (timeoutId) clearTimeout(timeoutId);\n      rl.close();\n      resolve(answer.trim());\n    });\n  });\n\n  return Promise.race([inputPromise, timeoutPromise]);\n}\n\nasync function ensurePortAvailable(targetPort: number, force: boolean): Promise<void> {\n  console.log(`\\n🔍 Checking port ${targetPort}...`);\n\n  if (await isPortAvailable(targetPort)) {\n    console.log(`✓ Port ${targetPort} is available`);\n    return;\n  }\n\n  console.log(`❌ Port ${targetPort} is already in use.`);\n\n  const processInfo = await findProcessOnPort(targetPort);\n  \n  if (!processInfo) {\n    console.error(\"   Could not determine process using this port\");\n    console.error(\"   Please stop it manually or use a different port (ADORN_EXAMPLE_PORT env var)\");\n    process.exit(1);\n  }\n\n  const { pid, command } = processInfo;\n  console.log(`   Process PID: ${pid}`);\n  if (command) {\n    console.log(`   Command: ${command}`);\n  }\n\n  if (force) {\n    console.log(`\\n   Force flag enabled, killing process ${pid}...`);\n  } else {\n    const answer = await promptWithTimeout(\"   Kill existing process? (y/n): \", 10000);\n\n    if (answer === null) {\n      console.log(\"\\n❌ Aborted. Please stop the process manually or use a different port\");\n      process.exit(1);\n    }\n\n    if (answer.toLowerCase() !== \"y\" && answer.toLowerCase() !== \"yes\") {\n      console.log(\"\\n❌ Aborted. Please stop the process manually or use a different port\");\n      console.log(\"   You can also use the --force flag to auto-kill\");\n      process.exit(1);\n    }\n  }\n\n  console.log(`   Terminating process ${pid}...`);\n  if (await killProcess(pid)) {\n    console.log(\"   ✓ Process killed successfully\");\n\n    console.log(`   Waiting for port ${targetPort} to be released...`);\n    const released = await waitForPort(targetPort, \"0.0.0.0\", 3000);\n\n    if (!released) {\n      console.error(`\\n❌ Port ${targetPort} still in use after killing process`);\n      process.exit(1);\n    }\n    \n    console.log(`   ✓ Port ${targetPort} is now available`);\n  } else {\n    console.error(`\\n❌ Failed to kill process ${pid}`);\n    console.error(\"   You may need to kill it manually or choose a different port\");\n    process.exit(1);\n  }\n}\n\nasync function main(): Promise<void> {\n  const args = process.argv.slice(2);\n  \n  if (args.includes(\"-h\") || args.includes(\"--help\")) {\n    printHelp();\n    process.exit(0);\n  }\n\n  if (args.includes(\"-l\") || args.includes(\"--list\")) {\n    console.log(\"Available examples:\");\n    getExamples().forEach(ex => console.log(`  - ${ex}`));\n    process.exit(0);\n  }\n\n  const forceFlag = args.includes(\"-f\") || args.includes(\"--force\");\n  const portIndex = args.indexOf(\"-p\") !== -1 ? args.indexOf(\"-p\") : args.indexOf(\"--port\");\n  let targetPort = Number(process.env.ADORN_EXAMPLE_PORT || 3000);\n  \n  if (portIndex !== -1 && args[portIndex + 1]) {\n    const portArg = Number(args[portIndex + 1]);\n    if (!isNaN(portArg) && portArg > 0 && portArg <= 65535) {\n      targetPort = portArg;\n    } else {\n      console.error(`\\n❌ Invalid port number: ${args[portIndex + 1]}`);\n      console.error(\"   Port must be between 1 and 65535\");\n      process.exit(1);\n    }\n  }\n\n  const filteredArgs = args.filter(arg => \n    ![\"-f\", \"--force\", \"-p\", \"--port\"].includes(arg) &&\n    (portIndex === -1 || arg !== args[portIndex + 1])\n  );\n\n  const example = filteredArgs[0] || \"basic\";\n  const examplePath = join(repoRoot, \"examples\", example);\n\n  if (!existsSync(examplePath)) {\n    console.error(`\\n❌ Example \"${example}\" not found.\\n`);\n    console.log(\"Available examples:\");\n    getExamples().forEach(ex => console.log(`  - ${ex}`));\n    process.exit(1);\n  }\n\n  console.log(`\\n🚀 Running \"${example}\" example...\\n`);\n\n  let child: ChildProcess | null = null;\n\n  try {\n    const nodeModulesPath = join(examplePath, \"node_modules\");\n    const nodeModulesExists = existsSync(nodeModulesPath);\n\n    if (!nodeModulesExists) {\n      console.log(\"📦 Installing dependencies...\");\n      runCommand(\"npm install\", examplePath);\n    }\n\n    console.log(\"📦 Building artifacts...\");\n    runCommand(\"npm run build\", examplePath);\n\n    await ensurePortAvailable(targetPort, forceFlag);\n\n    console.log(\"\\n🌐 Starting server...\\n\");\n    console.log(\"Press Ctrl+C to stop\\n\");\n\n    child = await spawnCommand([\"run\", \"dev\"], examplePath);\n\n    process.on(\"SIGINT\", () => {\n      if (child) child.kill(\"SIGINT\");\n    });\n\n    process.on(\"SIGTERM\", () => {\n      if (child) child.kill(\"SIGTERM\");\n    });\n\n    await new Promise<void>((resolve, reject) => {\n      if (!child) {\n        reject(new Error(\"Child process not started\"));\n        return;\n      }\n      child.on(\"exit\", (code) => {\n        if (code === 0 || code === null) {\n          resolve();\n        } else {\n          reject(new Error(`Process exited with code ${code}`));\n        }\n      });\n      child.on(\"error\", reject);\n    });\n  } catch (err: any) {\n    if (err.code !== \"SIGINT\" && err.code !== \"SIGTERM\") {\n      console.error(`\\n❌ Error: ${err.message}`);\n      process.exit(1);\n    }\n  }\n}\n\nmain();\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":["import_child_process","process"]}

package/dist/utils/port.d.ts

@@ -0,0 +1,9 @@
+export interface ProcessInfo {
+    pid: number;
+    command?: string;
+}
+export declare function isPortAvailable(port: number, host?: string): Promise<boolean>;
+export declare function findProcessOnPort(port: number): Promise<ProcessInfo | null>;
+export declare function killProcess(pid: number): Promise<boolean>;
+export declare function waitForPort(port: number, host?: string, timeout?: number): Promise<boolean>;
+//# sourceMappingURL=port.d.ts.map

package/dist/utils/port.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port.d.ts","sourceRoot":"","sources":["../../src/utils/port.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoB9F;AAED,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAwCjF;AA0BD,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAiD/D;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAkB,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC,CAWlH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adorn-api",
-  "version": "1.0.12",
+  "version": "1.0.14",
   "description": "Stage-3 decorator-first OpenAPI + routing toolkit",
   "license": "MIT",
   "type": "module",
@@ -77,10 +77,13 @@
     }
   },
   "devDependencies": {
+    "@eslint/js": "^9.39.2",
     "@types/express": "^4.17.0",
     "@types/node": "^20.0.0",
     "@types/supertest": "^6.0.0",
     "@types/swagger-ui-express": "^4.1.6",
+    "@typescript-eslint/eslint-plugin": "^8.52.0",
+    "@typescript-eslint/parser": "^8.52.0",
     "eslint": "^9.39.2",
     "express": "^5.2.1",
     "rimraf": "^6.0.0",