@yrest/cli 0.5.3 → 0.7.0

package/dist/index.js

@@ -5,6 +5,9 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -27,20 +30,12 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
-// src/index.ts
-var src_exports = {};
-__export(src_exports, {
-  createServer: () => createServer,
-  createYamlStorage: () => createYamlStorage,
-  serverOptionsSchema: () => serverOptionsSchema
+// node_modules/tsup/assets/cjs_shims.js
+var init_cjs_shims = __esm({
+  "node_modules/tsup/assets/cjs_shims.js"() {
+    "use strict";
+  }
 });
-module.exports = __toCommonJS(src_exports);
-
-// src/storage/yamlStorage.ts
-var import_node_fs = require("fs");
-var import_node_path = require("path");
-var import_node_crypto = require("crypto");
-var import_yaml = require("yaml");
 
 // src/utils/deepCopy.ts
 function deepCopyData(source) {
@@ -48,11 +43,21 @@ function deepCopyData(source) {
     Object.entries(source).map(([k, v]) => [k, v.map((item) => ({ ...item }))])
   );
 }
+var init_deepCopy = __esm({
+  "src/utils/deepCopy.ts"() {
+    "use strict";
+    init_cjs_shims();
+  }
+});
 
-// src/storage/yamlStorage.ts
-function createYamlStorage(filePath) {
+// src/storage/yrestStorage.ts
+var yrestStorage_exports = {};
+__export(yrestStorage_exports, {
+  createYrestStorage: () => createYrestStorage
+});
+function createYrestStorage(filePath) {
   const absPath = (0, import_node_path.resolve)(filePath);
-  const raw = (0, import_yaml.parse)((0, import_node_fs.readFileSync)(absPath, "utf8")) ?? {};
+  const raw = (0, import_yaml2.parse)((0, import_node_fs2.readFileSync)(absPath, "utf8")) ?? {};
   const relations = raw["_rel"] ?? {};
   const routes = Array.isArray(raw["_routes"]) ? raw["_routes"] : [];
   const data = Object.fromEntries(
@@ -84,12 +89,12 @@ function createYamlStorage(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_crypto.randomUUID)()}.tmp`);
-      (0, import_node_fs.writeFileSync)(tmp, (0, import_yaml.stringify)(payload), "utf8");
-      (0, import_node_fs.renameSync)(tmp, absPath);
+      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);
     },
     reload() {
-      const fresh = (0, import_yaml.parse)((0, import_node_fs.readFileSync)(absPath, "utf8")) ?? {};
+      const fresh = (0, import_yaml2.parse)((0, import_node_fs2.readFileSync)(absPath, "utf8")) ?? {};
       const freshRelations = fresh["_rel"] ?? {};
       const freshData = Object.fromEntries(
         Object.entries(fresh).filter(([key]) => key !== "_rel" && key !== "_routes")
@@ -119,13 +124,123 @@ function createYamlStorage(filePath) {
     }
   };
 }
+var import_node_fs2, import_node_path, 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_crypto2 = require("crypto");
+    import_yaml2 = require("yaml");
+    init_deepCopy();
+  }
+});
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  createServer: () => createServer,
+  createYrestServer: () => createYrestServer,
+  createYrestServerFromStorage: () => createYrestServerFromStorage,
+  createYrestStorage: () => createYrestStorage,
+  yrest: () => yrest,
+  yrestOptionsSchema: () => yrestOptionsSchema
+});
+module.exports = __toCommonJS(src_exports);
+init_cjs_shims();
+
+// src/api/yrest.ts
+init_cjs_shims();
+var import_yaml = require("yaml");
+function yrest(strings, ...values) {
+  const raw = strings.reduce(
+    (acc, str, i) => acc + str + (values[i] !== void 0 ? stringifyInterpolation(values[i]) : ""),
+    ""
+  );
+  const dedented = dedent(raw);
+  let parsed;
+  try {
+    parsed = (0, import_yaml.parse)(dedented);
+  } catch (e) {
+    throw new Error(`[yrest] Invalid YAML: ${e instanceof Error ? e.message : String(e)}`, {
+      cause: e
+    });
+  }
+  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+    throw new Error("[yrest] Template must resolve to a YAML object with collection keys.");
+  }
+  return parsed;
+}
+function stringifyInterpolation(value) {
+  if (value === null || value === void 0) return String(value);
+  if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  const type = Array.isArray(value) ? "array" : typeof value;
+  throw new Error(
+    `[yrest] Cannot interpolate a value of type "${type}". Only string, number, and boolean are supported.`
+  );
+}
+function dedent(str) {
+  const lines = str.split("\n");
+  const minIndent = lines.filter((line) => line.trim().length > 0).reduce((min, line) => {
+    const match = line.match(/^(\s*)/);
+    return Math.min(min, match ? match[1].length : 0);
+  }, Infinity);
+  const indent = minIndent === Infinity ? 0 : minIndent;
+  return lines.map((line) => line.slice(indent)).join("\n").trim();
+}
+
+// src/api/yrestServer.ts
+init_cjs_shims();
+var import_node_path2 = require("path");
+
+// src/utils/handlers.ts
+init_cjs_shims();
+var import_node_fs = require("fs");
+async function loadHandlers(filePath) {
+  if (!(0, import_node_fs.existsSync)(filePath)) return /* @__PURE__ */ new Map();
+  try {
+    const mod = await import(filePath);
+    const map = /* @__PURE__ */ new Map();
+    for (const [name, value] of Object.entries(mod)) {
+      if (typeof value === "function") map.set(name, value);
+    }
+    return map;
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(`  \x1B[31m[handlers] failed to load ${filePath} \u2014 ${msg}\x1B[0m`);
+    return /* @__PURE__ */ new Map();
+  }
+}
+
+// src/api/yrestServer.ts
+init_deepCopy();
+
+// src/server/index.ts
+init_cjs_shims();
 
 // src/server/createServer.ts
+init_cjs_shims();
 var import_fastify = __toESM(require("fastify"));
 var import_cors = __toESM(require("@fastify/cors"));
 
+// src/router/resource.router.ts
+init_cjs_shims();
+
+// src/router/routes/index.ts
+init_cjs_shims();
+
+// src/router/routes/about.routes.ts
+init_cjs_shims();
+
+// src/router/templates/about.template.ts
+init_cjs_shims();
+
 // src/utils/interpolate.ts
-var import_node_crypto2 = require("crypto");
+init_cjs_shims();
+var import_node_crypto = require("crypto");
 function getPath(obj, path) {
   return path.split(".").reduce((acc, key) => {
     if (acc != null && typeof acc === "object") return acc[key];
@@ -134,7 +249,7 @@ function getPath(obj, path) {
 }
 function resolveVar(path, ctx) {
   if (path === "now") return (/* @__PURE__ */ new Date()).toISOString();
-  if (path === "uuid") return (0, import_node_crypto2.randomUUID)();
+  if (path === "uuid") return (0, import_node_crypto.randomUUID)();
   if (path === "body") return ctx.body;
   if (path.startsWith("body.")) return getPath(ctx.body, path.slice(5));
   if (path.startsWith("params.")) return ctx.params[path.slice(7)] ?? "";
@@ -370,16 +485,33 @@ function generateAboutHtml(storage, options, handlers = /* @__PURE__ */ new Map(
     <table><tbody>
       ${customRoutes.map((r) => {
     const fullPath = `${base}${r.path}`;
+    const tags = [];
+    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) {
       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>
@@ -531,7 +663,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>
+      <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>
@@ -583,7 +715,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>
@@ -609,7 +741,11 @@ var AboutRouteCommand = class {
   }
 };
 
+// src/router/routes/collection.routes.ts
+init_cjs_shims();
+
 // src/utils/params.ts
+init_cjs_shims();
 function nextId(items) {
   const ids = items.map((i) => i["id"]).filter((id) => typeof id === "number");
   return ids.length > 0 ? Math.max(...ids) + 1 : 1;
@@ -620,6 +756,7 @@ function firstParam(value) {
 }
 
 // src/services/query.service.ts
+init_cjs_shims();
 var OPERATORS = ["_gte", "_lte", "_ne", "_like", "_start", "_regex"];
 function applyOperator(itemValue, op, filterValue) {
   const strItem = String(itemValue);
@@ -695,6 +832,7 @@ function paginate(items, page, limit) {
 }
 
 // src/services/resource.service.ts
+init_cjs_shims();
 function findById(items, id) {
   return items.find((i) => String(i["id"]) === id);
 }
@@ -742,6 +880,7 @@ function deleteItem(storage, resource, id) {
 }
 
 // src/services/expand.service.ts
+init_cjs_shims();
 function expandItems(input, query, resource, storage) {
   const isArray = Array.isArray(input);
   const items = isArray ? input : [input];
@@ -889,6 +1028,66 @@ 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;
@@ -913,6 +1112,9 @@ var CustomRouteCommand = class {
         method,
         url,
         handler: async (req, reply) => {
+          if (route.delay && route.delay > 0) {
+            await new Promise((resolve3) => setTimeout(resolve3, route.delay));
+          }
           for (const [key, value] of Object.entries(headers)) {
             reply.header(key, value);
           }
@@ -922,13 +1124,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);
@@ -940,12 +1142,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);
         }
@@ -955,6 +1169,7 @@ var CustomRouteCommand = class {
 };
 
 // src/router/routes/item.routes.ts
+init_cjs_shims();
 var ItemRouteCommand = class {
   constructor(storage, resource, base) {
     this.storage = storage;
@@ -1004,6 +1219,7 @@ var ItemRouteCommand = class {
 };
 
 // src/router/routes/nested.routes.ts
+init_cjs_shims();
 var NestedRouteCommand = class {
   constructor(storage, relations, base) {
     this.storage = storage;
@@ -1043,6 +1259,7 @@ var NestedRouteCommand = class {
 };
 
 // src/router/routes/snapshot.routes.ts
+init_cjs_shims();
 var SnapshotRouteCommand = class {
   constructor(storage) {
     this.storage = storage;
@@ -1132,9 +1349,119 @@ async function createServer(storage, options, handlers = /* @__PURE__ */ new Map
   return server;
 }
 
+// src/server/yrestServer.ts
+init_cjs_shims();
+function createYrestServerFromStorage(storage, options, handlers = /* @__PURE__ */ new Map()) {
+  let _port = 0;
+  let _started = false;
+  let _fastify = null;
+  return {
+    async start() {
+      if (_started) return;
+      _fastify = await createServer(storage, options, handlers);
+      await _fastify.listen({ port: options.port, host: options.host });
+      const address = _fastify.addresses()[0];
+      _port = typeof address === "object" && "port" in address ? address.port : options.port;
+      _started = true;
+    },
+    async stop() {
+      if (!_started || !_fastify) return;
+      await _fastify.close();
+      _started = false;
+    },
+    get port() {
+      return _port;
+    },
+    get url() {
+      return `http://${options.host}:${_port}${options.base}`;
+    }
+  };
+}
+
+// src/api/yrestServer.ts
+function createYrestServer(options) {
+  const resolvedOptions = buildOptions(options);
+  let _inner = null;
+  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();
+      _inner = createYrestServerFromStorage(storage, resolvedOptions, handlers);
+      await _inner.start();
+    },
+    async stop() {
+      await _inner?.stop();
+    },
+    get port() {
+      return _inner?.port ?? 0;
+    },
+    get url() {
+      return _inner?.url ?? "";
+    }
+  };
+}
+function buildOptions(opts) {
+  const pageable = opts.pageable;
+  return {
+    file: "file" in opts && opts.file ? opts.file : "",
+    port: opts.port ?? 3070,
+    host: opts.host ?? "localhost",
+    base: opts.base ? opts.base.startsWith("/") ? opts.base : `/${opts.base}` : "",
+    watch: false,
+    snapshot: opts.snapshot ?? false,
+    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 }
+  };
+}
+function createInMemoryStorage(data) {
+  const raw = data;
+  const relations = raw["_rel"] ?? {};
+  const routes = Array.isArray(raw["_routes"]) ? raw["_routes"] : [];
+  const collections = Object.fromEntries(
+    Object.entries(raw).filter(([k]) => k !== "_rel" && k !== "_routes")
+  );
+  let snapshot = {
+    data: deepCopyData(collections),
+    relations: { ...relations },
+    savedAt: /* @__PURE__ */ new Date()
+  };
+  return {
+    getData: () => collections,
+    getRelations: () => relations,
+    getRoutes: () => routes,
+    getCollection: (name) => collections[name],
+    setCollection: (name, items) => {
+      collections[name] = items;
+    },
+    persist: () => {
+    },
+    reload: () => {
+    },
+    getSnapshot: () => snapshot,
+    saveSnapshot: () => {
+      snapshot = {
+        data: deepCopyData(collections),
+        relations: { ...relations },
+        savedAt: /* @__PURE__ */ new Date()
+      };
+    },
+    resetToSnapshot: () => {
+      const snap = deepCopyData(snapshot.data);
+      for (const key of Object.keys(collections)) delete collections[key];
+      Object.assign(collections, snap);
+    }
+  };
+}
+
+// src/index.ts
+init_yrestStorage();
+
 // src/config/loadOptions.ts
+init_cjs_shims();
 var import_zod = require("zod");
-var serverOptionsSchema = import_zod.z.object({
+var yrestOptionsSchema = import_zod.z.object({
   /** Path to the YAML database file. Must be a non-empty string. */
   file: import_zod.z.string().min(1),
   /** TCP port the server listens on. Accepts string input and coerces to number. */
@@ -1174,6 +1501,9 @@ var serverOptionsSchema = import_zod.z.object({
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createServer,
-  createYamlStorage,
-  serverOptionsSchema
+  createYrestServer,
+  createYrestServerFromStorage,
+  createYrestStorage,
+  yrest,
+  yrestOptionsSchema
 });