@yrest/cli 0.6.0 → 0.8.0

package/dist/index.js

@@ -31,9 +31,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // node_modules/tsup/assets/cjs_shims.js
+var getImportMetaUrl, importMetaUrl;
 var init_cjs_shims = __esm({
   "node_modules/tsup/assets/cjs_shims.js"() {
     "use strict";
+    getImportMetaUrl = () => typeof document === "undefined" ? new URL(`file:${__filename}`).href : document.currentScript && document.currentScript.tagName.toUpperCase() === "SCRIPT" ? document.currentScript.src : new URL("main.js", document.baseURI).href;
+    importMetaUrl = /* @__PURE__ */ getImportMetaUrl();
   }
 });
 
@@ -56,8 +59,8 @@ __export(yrestStorage_exports, {
   createYrestStorage: () => createYrestStorage
 });
 function createYrestStorage(filePath) {
-  const absPath = (0, import_node_path.resolve)(filePath);
-  const raw = (0, import_yaml2.parse)((0, import_node_fs2.readFileSync)(absPath, "utf8")) ?? {};
+  const absPath = (0, import_node_path2.resolve)(filePath);
+  const raw = (0, import_yaml2.parse)((0, import_node_fs3.readFileSync)(absPath, "utf8")) ?? {};
   const relations = raw["_rel"] ?? {};
   const routes = Array.isArray(raw["_routes"]) ? raw["_routes"] : [];
   const data = Object.fromEntries(
@@ -89,12 +92,12 @@ function createYrestStorage(filePath) {
       if (Object.keys(relations).length > 0) payload._rel = relations;
       if (routes.length > 0) payload._routes = routes;
       Object.assign(payload, data);
-      const tmp = (0, import_node_path.resolve)((0, import_node_path.dirname)(absPath), `.yrest-${(0, import_node_crypto2.randomUUID)()}.tmp`);
-      (0, import_node_fs2.writeFileSync)(tmp, (0, import_yaml2.stringify)(payload), "utf8");
-      (0, import_node_fs2.renameSync)(tmp, absPath);
+      const tmp = (0, import_node_path2.resolve)((0, import_node_path2.dirname)(absPath), `.yrest-${(0, import_node_crypto2.randomUUID)()}.tmp`);
+      (0, import_node_fs3.writeFileSync)(tmp, (0, import_yaml2.stringify)(payload), "utf8");
+      (0, import_node_fs3.renameSync)(tmp, absPath);
     },
     reload() {
-      const fresh = (0, import_yaml2.parse)((0, import_node_fs2.readFileSync)(absPath, "utf8")) ?? {};
+      const fresh = (0, import_yaml2.parse)((0, import_node_fs3.readFileSync)(absPath, "utf8")) ?? {};
       const freshRelations = fresh["_rel"] ?? {};
       const freshData = Object.fromEntries(
         Object.entries(fresh).filter(([key]) => key !== "_rel" && key !== "_routes")
@@ -124,13 +127,13 @@ function createYrestStorage(filePath) {
     }
   };
 }
-var import_node_fs2, import_node_path, import_node_crypto2, import_yaml2;
+var import_node_fs3, import_node_path2, import_node_crypto2, import_yaml2;
 var init_yrestStorage = __esm({
   "src/storage/yrestStorage.ts"() {
     "use strict";
     init_cjs_shims();
-    import_node_fs2 = require("fs");
-    import_node_path = require("path");
+    import_node_fs3 = require("fs");
+    import_node_path2 = require("path");
     import_node_crypto2 = require("crypto");
     import_yaml2 = require("yaml");
     init_deepCopy();
@@ -194,7 +197,7 @@ function dedent(str) {
 
 // src/api/yrestServer.ts
 init_cjs_shims();
-var import_node_path2 = require("path");
+var import_node_path3 = require("path");
 
 // src/utils/handlers.ts
 init_cjs_shims();
@@ -237,6 +240,9 @@ init_cjs_shims();
 
 // src/router/templates/about.template.ts
 init_cjs_shims();
+var import_node_fs2 = require("fs");
+var import_node_path = require("path");
+var import_node_url = require("url");
 
 // src/utils/interpolate.ts
 init_cjs_shims();
@@ -286,6 +292,15 @@ function hasTemplates(value) {
 }
 
 // src/router/templates/about.template.ts
+var _dir = (0, import_node_path.dirname)((0, import_node_url.fileURLToPath)(importMetaUrl));
+var LOGO_SRC = (() => {
+  try {
+    const buf = (0, import_node_fs2.readFileSync)((0, import_node_path.join)(_dir, "../../assets/logo-color.png"));
+    return `data:image/png;base64,${buf.toString("base64")}`;
+  } catch {
+    return "";
+  }
+})();
 var METHOD_COLOR = {
   GET: "#3fb950",
   POST: "#58a6ff",
@@ -444,6 +459,8 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
     modes.push(badge(`pageable \xB7 limit ${options.pageable.limit}`, "#34d399", "#34d39918"));
   if (options.snapshot) modes.push(badge("snapshot", "#c084fc", "#c084fc18"));
   if (handlers.size > 0) modes.push(badge(`handlers \xB7 ${handlers.size}`, "#f0883e", "#f0883e18"));
+  if (options.idStrategy !== "increment")
+    modes.push(badge(`id \xB7 ${options.idStrategy}`, "#a371f7", "#a371f718"));
   const accordions = collections.map((col, i) => resourceAccordion(col, base, i === 0)).join("");
   const nestedRows = [];
   for (const [child, fields] of Object.entries(relations)) {
@@ -485,16 +502,38 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
     <table><tbody>
       ${customRoutes.map((r) => {
     const fullPath = `${base}${r.path}`;
+    const tags = [];
+    if (r.error) {
+      tags.push(`<span style="color:#f85149;font-size:11px">error\xB7${r.error}</span>`);
+    }
+    if (r.delay && r.delay > 0) {
+      tags.push(`<span style="color:#fb923c;font-size:11px">delay\xB7${r.delay}ms</span>`);
+    }
+    if (r.scenarios?.length) {
+      const hasOr = r.scenarios.some((s) => Array.isArray(s.when));
+      tags.push(
+        `<span style="color:#a371f7;font-size:11px">scenarios\xB7${r.scenarios.length}${hasOr ? " (OR)" : ""}</span>`
+      );
+    }
+    if (r.otherwise) {
+      tags.push(`<span style="color:var(--text-muted);font-size:11px">otherwise</span>`);
+    }
     let desc;
-    if (r.handler) {
+    if (r.error) {
+      desc = `Error injection \u2014 <code>${r.error}</code>`;
+    } else if (r.handler) {
       const found = handlers.has(r.handler);
       desc = found ? `Handler \u2014 <code>${r.handler}()</code>` : `Handler \u2014 <code>${r.handler}()</code> <span style="color:#f85149">(not loaded)</span>`;
+    } else if (r.scenarios?.length) {
+      const hasTemplateInScenarios = r.scenarios.some((s) => s.response.body != null && hasTemplates(s.response.body)) || r.otherwise?.body != null && hasTemplates(r.otherwise.body);
+      desc = hasTemplateInScenarios ? `Scenarios \u2014 <code>{{\u2026}}</code>` : `Scenarios`;
     } else if (r.response?.body != null && hasTemplates(r.response.body)) {
-      desc = `Dynamic body \u2014 <code>{{\u2026}}</code>`;
+      desc = `Dynamic \u2014 <code>{{\u2026}}</code>`;
     } else {
       const status = r.response?.status ?? 200;
-      desc = `Static \u2014 <code>${status}</code>${r.response?.headers ? ` + custom headers` : ""}`;
+      desc = `Static \u2014 <code>${status}</code>${r.response?.headers ? ` + headers` : ""}`;
     }
+    if (tags.length) desc += `&ensp;${tags.join("&ensp;")}`;
     return endpointRow(r.method?.toUpperCase() ?? "GET", fullPath, desc);
   }).join("")}
     </tbody></table>
@@ -646,7 +685,7 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
 
   <div class="banner">
     <div class="banner-inner">
-      <h1><span class="y">y</span><span class="rest">rest</span></h1>
+      ${LOGO_SRC ? `<img src="${LOGO_SRC}" alt="yRest" height="68" style="display:block;margin-bottom:0px" />` : `<h1><span class="y">y</span><span class="rest">Rest</span></h1>`}
       <p>Zero-config REST API mock server</p>
       <div class="banner-meta">
         <span>URL <strong>${host}</strong></span>
@@ -698,7 +737,7 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
     ${collections.length ? `<h2>Examples</h2><div class="card">${examplesBlock(collections, relations, base, host, options, customRoutes[0])}</div>` : ""}
 
     <footer>
-      Powered by <a href="https://github.com/aggiovato/yaml-rest" target="_blank">@aggiovato/yrest</a> &nbsp;\xB7&nbsp; <a href="/_about">/_about</a>
+      Powered by <a href="https://github.com/aggiovato/yRest" target="_blank">@yrest/cli</a> &nbsp;\xB7&nbsp; <a href="/_about">/_about</a>
     </footer>
 
   </div>
@@ -733,6 +772,10 @@ function nextId(items) {
   const ids = items.map((i) => i["id"]).filter((id) => typeof id === "number");
   return ids.length > 0 ? Math.max(...ids) + 1 : 1;
 }
+function generateId(items, strategy) {
+  if (strategy === "uuid") return crypto.randomUUID();
+  return nextId(items);
+}
 function firstParam(value) {
   if (value === void 0) return void 0;
   return Array.isArray(value) ? value[0] : value;
@@ -822,10 +865,10 @@ function findById(items, id) {
 function findIndexById(items, id) {
   return items.findIndex((i) => String(i["id"]) === id);
 }
-function createItem(storage, resource, body) {
+function createItem(storage, resource, body, idStrategy = "increment") {
   const collection = storage.getCollection(resource) ?? [];
   const item = {
-    id: body["id"] !== void 0 ? body["id"] : nextId(collection),
+    id: body["id"] !== void 0 ? body["id"] : generateId(collection, idStrategy),
     ...body
   };
   storage.setCollection(resource, [...collection, item]);
@@ -1004,7 +1047,12 @@ var CollectionRouteCommand = class {
       if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
         return reply.status(400).send({ error: "Request body must be a JSON object" });
       }
-      const item = createItem(this.storage, this.resource, req.body);
+      const item = createItem(
+        this.storage,
+        this.resource,
+        req.body,
+        this.options.idStrategy
+      );
       return reply.status(201).send(expandItems(item, req.query, this.resource, this.storage));
     });
   }
@@ -1012,6 +1060,65 @@ var CollectionRouteCommand = class {
 
 // src/router/routes/custom.routes.ts
 init_cjs_shims();
+
+// src/utils/conditions.ts
+init_cjs_shims();
+function resolveRequestPath(dotPath, req) {
+  const [root, ...rest] = dotPath.split(".");
+  let value;
+  switch (root) {
+    case "body":
+      value = req.body;
+      break;
+    case "params":
+      value = req.params;
+      break;
+    case "query":
+      value = req.query;
+      break;
+    case "headers":
+      value = req.headers;
+      break;
+    default:
+      return void 0;
+  }
+  for (const key of rest) {
+    if (value != null && typeof value === "object") {
+      value = value[key];
+    } else {
+      return void 0;
+    }
+  }
+  return value;
+}
+function matchConditionGroup(group, req) {
+  return Object.entries(group).every(([key, expected]) => {
+    const op = OPERATORS.find((o) => key.endsWith(o));
+    if (op) {
+      const path = key.slice(0, -op.length);
+      const value2 = resolveRequestPath(path, req);
+      if (value2 === void 0) return false;
+      return applyOperator(value2, op, String(expected));
+    }
+    const value = resolveRequestPath(key, req);
+    return String(value) === String(expected);
+  });
+}
+function matchWhen(when, req) {
+  if (Array.isArray(when)) {
+    return when.some((group) => matchConditionGroup(group, req));
+  }
+  return matchConditionGroup(when, req);
+}
+function findMatchingScenario(scenarios, req) {
+  return scenarios.find((s) => matchWhen(s.when, req));
+}
+
+// src/router/routes/custom.routes.ts
+function resolveBody(body, ctx) {
+  if (body != null && hasTemplates(body)) return interpolate(body, ctx);
+  return body ?? null;
+}
 var CustomRouteCommand = class {
   constructor(storage, base, handlers = /* @__PURE__ */ new Map()) {
     this.storage = storage;
@@ -1036,6 +1143,13 @@ var CustomRouteCommand = class {
         method,
         url,
         handler: async (req, reply) => {
+          if (route.delay && route.delay > 0) {
+            await new Promise((resolve3) => setTimeout(resolve3, route.delay));
+          }
+          if (route.error) {
+            const body2 = route.errorBody ?? { error: `Forced error ${route.error}` };
+            return reply.status(route.error).send(body2);
+          }
           for (const [key, value] of Object.entries(headers)) {
             reply.header(key, value);
           }
@@ -1045,13 +1159,13 @@ var CustomRouteCommand = class {
               return reply.status(501).send({ error: `Handler "${handlerName}" is not defined in the handlers file` });
             }
             try {
-              const ctx = {
+              const ctx2 = {
                 params: req.params,
                 query: req.query,
                 body: req.body,
                 headers: req.headers
               };
-              const result = await fn(ctx);
+              const result = await fn(ctx2);
               const resStatus = result.status ?? 200;
               for (const [k, v] of Object.entries(result.headers ?? {})) {
                 reply.header(k, v);
@@ -1063,12 +1177,24 @@ var CustomRouteCommand = class {
               return reply.status(500).send({ error: `Handler "${handlerName}" threw an error: ${msg}` });
             }
           }
-          const body = dynamic ? interpolate(rawBody, {
+          const ctx = {
             params: req.params,
             query: req.query,
             body: req.body,
             headers: req.headers
-          }) : rawBody;
+          };
+          if (route.scenarios?.length) {
+            const matched = findMatchingScenario(route.scenarios, ctx);
+            const active = matched?.response ?? route.otherwise;
+            if (active) {
+              const aStatus = active.status ?? 200;
+              const aBody = resolveBody(active.body, ctx);
+              for (const [k, v] of Object.entries(active.headers ?? {})) reply.header(k, v);
+              if (!active.body && aStatus === 204) return reply.status(aStatus).send();
+              return reply.status(aStatus).send(aBody);
+            }
+          }
+          const body = dynamic ? interpolate(rawBody, ctx) : rawBody;
           if (body === null && status === 204) return reply.status(status).send();
           return reply.status(status).send(body);
         }
@@ -1294,7 +1420,7 @@ function createYrestServer(options) {
   return {
     async start() {
       const storage = "data" in options && options.data !== void 0 ? createInMemoryStorage(options.data) : (await Promise.resolve().then(() => (init_yrestStorage(), yrestStorage_exports))).createYrestStorage(resolvedOptions.file);
-      const handlers = resolvedOptions.handlers ? await loadHandlers((0, import_node_path2.resolve)(resolvedOptions.handlers)) : /* @__PURE__ */ new Map();
+      const handlers = resolvedOptions.handlers ? await loadHandlers((0, import_node_path3.resolve)(resolvedOptions.handlers)) : /* @__PURE__ */ new Map();
       _inner = createYrestServerFromStorage(storage, resolvedOptions, handlers);
       await _inner.start();
     },
@@ -1321,7 +1447,8 @@ function buildOptions(opts) {
     readonly: opts.readonly ?? false,
     delay: opts.delay ?? 0,
     handlers: opts.handlers,
-    pageable: typeof pageable === "number" ? { enabled: true, limit: pageable } : pageable ? { enabled: true, limit: 10 } : { enabled: false, limit: 10 }
+    pageable: typeof pageable === "number" ? { enabled: true, limit: pageable } : pageable ? { enabled: true, limit: 10 } : { enabled: false, limit: 10 },
+    idStrategy: "increment"
   };
 }
 function createInMemoryStorage(data) {
@@ -1405,7 +1532,14 @@ var yrestOptionsSchema = import_zod.z.object({
   pageable: import_zod.z.union([import_zod.z.boolean(), import_zod.z.coerce.number().int().positive()]).default(false).transform((v) => ({
     enabled: v !== false,
     limit: v === false || v === true ? 10 : v
-  }))
+  })),
+  /**
+   * Strategy used to generate `id` values for new items when no `id` is provided in the body.
+   *
+   * - `"increment"` (default) — next integer above the current max id in the collection.
+   * - `"uuid"` — a random UUID v4 string (`crypto.randomUUID()`).
+   */
+  idStrategy: import_zod.z.enum(["increment", "uuid"]).default("increment")
 });
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.mjs

@@ -35,13 +35,13 @@ var yrestStorage_exports = {};
 __export(yrestStorage_exports, {
   createYrestStorage: () => createYrestStorage
 });
-import { readFileSync, writeFileSync, renameSync } from "fs";
-import { resolve, dirname } from "path";
+import { readFileSync as readFileSync2, writeFileSync, renameSync } from "fs";
+import { resolve, dirname as dirname2 } from "path";
 import { randomUUID as randomUUID2 } from "crypto";
 import { parse as parse2, stringify } from "yaml";
 function createYrestStorage(filePath) {
   const absPath = resolve(filePath);
-  const raw = parse2(readFileSync(absPath, "utf8")) ?? {};
+  const raw = parse2(readFileSync2(absPath, "utf8")) ?? {};
   const relations = raw["_rel"] ?? {};
   const routes = Array.isArray(raw["_routes"]) ? raw["_routes"] : [];
   const data = Object.fromEntries(
@@ -73,12 +73,12 @@ function createYrestStorage(filePath) {
       if (Object.keys(relations).length > 0) payload._rel = relations;
       if (routes.length > 0) payload._routes = routes;
       Object.assign(payload, data);
-      const tmp = resolve(dirname(absPath), `.yrest-${randomUUID2()}.tmp`);
+      const tmp = resolve(dirname2(absPath), `.yrest-${randomUUID2()}.tmp`);
       writeFileSync(tmp, stringify(payload), "utf8");
       renameSync(tmp, absPath);
     },
     reload() {
-      const fresh = parse2(readFileSync(absPath, "utf8")) ?? {};
+      const fresh = parse2(readFileSync2(absPath, "utf8")) ?? {};
       const freshRelations = fresh["_rel"] ?? {};
       const freshData = Object.fromEntries(
         Object.entries(fresh).filter(([key]) => key !== "_rel" && key !== "_routes")
@@ -206,6 +206,9 @@ init_esm_shims();
 
 // src/router/templates/about.template.ts
 init_esm_shims();
+import { readFileSync } from "fs";
+import { dirname, join } from "path";
+import { fileURLToPath as fileURLToPath2 } from "url";
 
 // src/utils/interpolate.ts
 init_esm_shims();
@@ -255,6 +258,15 @@ function hasTemplates(value) {
 }
 
 // src/router/templates/about.template.ts
+var _dir = dirname(fileURLToPath2(import.meta.url));
+var LOGO_SRC = (() => {
+  try {
+    const buf = readFileSync(join(_dir, "../../assets/logo-color.png"));
+    return `data:image/png;base64,${buf.toString("base64")}`;
+  } catch {
+    return "";
+  }
+})();
 var METHOD_COLOR = {
   GET: "#3fb950",
   POST: "#58a6ff",
@@ -413,6 +425,8 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
     modes.push(badge(`pageable \xB7 limit ${options.pageable.limit}`, "#34d399", "#34d39918"));
   if (options.snapshot) modes.push(badge("snapshot", "#c084fc", "#c084fc18"));
   if (handlers.size > 0) modes.push(badge(`handlers \xB7 ${handlers.size}`, "#f0883e", "#f0883e18"));
+  if (options.idStrategy !== "increment")
+    modes.push(badge(`id \xB7 ${options.idStrategy}`, "#a371f7", "#a371f718"));
   const accordions = collections.map((col, i) => resourceAccordion(col, base, i === 0)).join("");
   const nestedRows = [];
   for (const [child, fields] of Object.entries(relations)) {
@@ -454,16 +468,38 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
     <table><tbody>
       ${customRoutes.map((r) => {
     const fullPath = `${base}${r.path}`;
+    const tags = [];
+    if (r.error) {
+      tags.push(`<span style="color:#f85149;font-size:11px">error\xB7${r.error}</span>`);
+    }
+    if (r.delay && r.delay > 0) {
+      tags.push(`<span style="color:#fb923c;font-size:11px">delay\xB7${r.delay}ms</span>`);
+    }
+    if (r.scenarios?.length) {
+      const hasOr = r.scenarios.some((s) => Array.isArray(s.when));
+      tags.push(
+        `<span style="color:#a371f7;font-size:11px">scenarios\xB7${r.scenarios.length}${hasOr ? " (OR)" : ""}</span>`
+      );
+    }
+    if (r.otherwise) {
+      tags.push(`<span style="color:var(--text-muted);font-size:11px">otherwise</span>`);
+    }
     let desc;
-    if (r.handler) {
+    if (r.error) {
+      desc = `Error injection \u2014 <code>${r.error}</code>`;
+    } else if (r.handler) {
       const found = handlers.has(r.handler);
       desc = found ? `Handler \u2014 <code>${r.handler}()</code>` : `Handler \u2014 <code>${r.handler}()</code> <span style="color:#f85149">(not loaded)</span>`;
+    } else if (r.scenarios?.length) {
+      const hasTemplateInScenarios = r.scenarios.some((s) => s.response.body != null && hasTemplates(s.response.body)) || r.otherwise?.body != null && hasTemplates(r.otherwise.body);
+      desc = hasTemplateInScenarios ? `Scenarios \u2014 <code>{{\u2026}}</code>` : `Scenarios`;
     } else if (r.response?.body != null && hasTemplates(r.response.body)) {
-      desc = `Dynamic body \u2014 <code>{{\u2026}}</code>`;
+      desc = `Dynamic \u2014 <code>{{\u2026}}</code>`;
     } else {
       const status = r.response?.status ?? 200;
-      desc = `Static \u2014 <code>${status}</code>${r.response?.headers ? ` + custom headers` : ""}`;
+      desc = `Static \u2014 <code>${status}</code>${r.response?.headers ? ` + headers` : ""}`;
     }
+    if (tags.length) desc += `&ensp;${tags.join("&ensp;")}`;
     return endpointRow(r.method?.toUpperCase() ?? "GET", fullPath, desc);
   }).join("")}
     </tbody></table>
@@ -615,7 +651,7 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
 
   <div class="banner">
     <div class="banner-inner">
-      <h1><span class="y">y</span><span class="rest">rest</span></h1>
+      ${LOGO_SRC ? `<img src="${LOGO_SRC}" alt="yRest" height="68" style="display:block;margin-bottom:0px" />` : `<h1><span class="y">y</span><span class="rest">Rest</span></h1>`}
       <p>Zero-config REST API mock server</p>
       <div class="banner-meta">
         <span>URL <strong>${host}</strong></span>
@@ -667,7 +703,7 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
     ${collections.length ? `<h2>Examples</h2><div class="card">${examplesBlock(collections, relations, base, host, options, customRoutes[0])}</div>` : ""}
 
     <footer>
-      Powered by <a href="https://github.com/aggiovato/yaml-rest" target="_blank">@aggiovato/yrest</a> &nbsp;\xB7&nbsp; <a href="/_about">/_about</a>
+      Powered by <a href="https://github.com/aggiovato/yRest" target="_blank">@yrest/cli</a> &nbsp;\xB7&nbsp; <a href="/_about">/_about</a>
     </footer>
 
   </div>
@@ -702,6 +738,10 @@ function nextId(items) {
   const ids = items.map((i) => i["id"]).filter((id) => typeof id === "number");
   return ids.length > 0 ? Math.max(...ids) + 1 : 1;
 }
+function generateId(items, strategy) {
+  if (strategy === "uuid") return crypto.randomUUID();
+  return nextId(items);
+}
 function firstParam(value) {
   if (value === void 0) return void 0;
   return Array.isArray(value) ? value[0] : value;
@@ -791,10 +831,10 @@ function findById(items, id) {
 function findIndexById(items, id) {
   return items.findIndex((i) => String(i["id"]) === id);
 }
-function createItem(storage, resource, body) {
+function createItem(storage, resource, body, idStrategy = "increment") {
   const collection = storage.getCollection(resource) ?? [];
   const item = {
-    id: body["id"] !== void 0 ? body["id"] : nextId(collection),
+    id: body["id"] !== void 0 ? body["id"] : generateId(collection, idStrategy),
     ...body
   };
   storage.setCollection(resource, [...collection, item]);
@@ -973,7 +1013,12 @@ var CollectionRouteCommand = class {
       if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
         return reply.status(400).send({ error: "Request body must be a JSON object" });
       }
-      const item = createItem(this.storage, this.resource, req.body);
+      const item = createItem(
+        this.storage,
+        this.resource,
+        req.body,
+        this.options.idStrategy
+      );
       return reply.status(201).send(expandItems(item, req.query, this.resource, this.storage));
     });
   }
@@ -981,6 +1026,65 @@ var CollectionRouteCommand = class {
 
 // src/router/routes/custom.routes.ts
 init_esm_shims();
+
+// src/utils/conditions.ts
+init_esm_shims();
+function resolveRequestPath(dotPath, req) {
+  const [root, ...rest] = dotPath.split(".");
+  let value;
+  switch (root) {
+    case "body":
+      value = req.body;
+      break;
+    case "params":
+      value = req.params;
+      break;
+    case "query":
+      value = req.query;
+      break;
+    case "headers":
+      value = req.headers;
+      break;
+    default:
+      return void 0;
+  }
+  for (const key of rest) {
+    if (value != null && typeof value === "object") {
+      value = value[key];
+    } else {
+      return void 0;
+    }
+  }
+  return value;
+}
+function matchConditionGroup(group, req) {
+  return Object.entries(group).every(([key, expected]) => {
+    const op = OPERATORS.find((o) => key.endsWith(o));
+    if (op) {
+      const path2 = key.slice(0, -op.length);
+      const value2 = resolveRequestPath(path2, req);
+      if (value2 === void 0) return false;
+      return applyOperator(value2, op, String(expected));
+    }
+    const value = resolveRequestPath(key, req);
+    return String(value) === String(expected);
+  });
+}
+function matchWhen(when, req) {
+  if (Array.isArray(when)) {
+    return when.some((group) => matchConditionGroup(group, req));
+  }
+  return matchConditionGroup(when, req);
+}
+function findMatchingScenario(scenarios, req) {
+  return scenarios.find((s) => matchWhen(s.when, req));
+}
+
+// src/router/routes/custom.routes.ts
+function resolveBody(body, ctx) {
+  if (body != null && hasTemplates(body)) return interpolate(body, ctx);
+  return body ?? null;
+}
 var CustomRouteCommand = class {
   constructor(storage, base, handlers = /* @__PURE__ */ new Map()) {
     this.storage = storage;
@@ -1005,6 +1109,13 @@ var CustomRouteCommand = class {
         method,
         url,
         handler: async (req, reply) => {
+          if (route.delay && route.delay > 0) {
+            await new Promise((resolve3) => setTimeout(resolve3, route.delay));
+          }
+          if (route.error) {
+            const body2 = route.errorBody ?? { error: `Forced error ${route.error}` };
+            return reply.status(route.error).send(body2);
+          }
           for (const [key, value] of Object.entries(headers)) {
             reply.header(key, value);
           }
@@ -1014,13 +1125,13 @@ var CustomRouteCommand = class {
               return reply.status(501).send({ error: `Handler "${handlerName}" is not defined in the handlers file` });
             }
             try {
-              const ctx = {
+              const ctx2 = {
                 params: req.params,
                 query: req.query,
                 body: req.body,
                 headers: req.headers
               };
-              const result = await fn(ctx);
+              const result = await fn(ctx2);
               const resStatus = result.status ?? 200;
               for (const [k, v] of Object.entries(result.headers ?? {})) {
                 reply.header(k, v);
@@ -1032,12 +1143,24 @@ var CustomRouteCommand = class {
               return reply.status(500).send({ error: `Handler "${handlerName}" threw an error: ${msg}` });
             }
           }
-          const body = dynamic ? interpolate(rawBody, {
+          const ctx = {
             params: req.params,
             query: req.query,
             body: req.body,
             headers: req.headers
-          }) : rawBody;
+          };
+          if (route.scenarios?.length) {
+            const matched = findMatchingScenario(route.scenarios, ctx);
+            const active = matched?.response ?? route.otherwise;
+            if (active) {
+              const aStatus = active.status ?? 200;
+              const aBody = resolveBody(active.body, ctx);
+              for (const [k, v] of Object.entries(active.headers ?? {})) reply.header(k, v);
+              if (!active.body && aStatus === 204) return reply.status(aStatus).send();
+              return reply.status(aStatus).send(aBody);
+            }
+          }
+          const body = dynamic ? interpolate(rawBody, ctx) : rawBody;
           if (body === null && status === 204) return reply.status(status).send();
           return reply.status(status).send(body);
         }
@@ -1290,7 +1413,8 @@ function buildOptions(opts) {
     readonly: opts.readonly ?? false,
     delay: opts.delay ?? 0,
     handlers: opts.handlers,
-    pageable: typeof pageable === "number" ? { enabled: true, limit: pageable } : pageable ? { enabled: true, limit: 10 } : { enabled: false, limit: 10 }
+    pageable: typeof pageable === "number" ? { enabled: true, limit: pageable } : pageable ? { enabled: true, limit: 10 } : { enabled: false, limit: 10 },
+    idStrategy: "increment"
   };
 }
 function createInMemoryStorage(data) {
@@ -1374,7 +1498,14 @@ var yrestOptionsSchema = z.object({
   pageable: z.union([z.boolean(), z.coerce.number().int().positive()]).default(false).transform((v) => ({
     enabled: v !== false,
     limit: v === false || v === true ? 10 : v
-  }))
+  })),
+  /**
+   * Strategy used to generate `id` values for new items when no `id` is provided in the body.
+   *
+   * - `"increment"` (default) — next integer above the current max id in the collection.
+   * - `"uuid"` — a random UUID v4 string (`crypto.randomUUID()`).
+   */
+  idStrategy: z.enum(["increment", "uuid"]).default("increment")
 });
 export {
   createServer,