@aggiovato/yrest 0.3.0 → 0.4.0

package/dist/cli/index.js

@@ -211,11 +211,92 @@ function createYamlStorage(filePath) {
 var import_fastify = __toESM(require("fastify"));
 var import_cors = __toESM(require("@fastify/cors"));
 
-// src/services/resourceService.ts
+// src/utils/params.ts
 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 firstParam(value) {
+  if (value === void 0) return void 0;
+  return Array.isArray(value) ? value[0] : value;
+}
+
+// src/services/query.service.ts
+var OPERATORS = ["_gte", "_lte", "_ne", "_like", "_start", "_regex"];
+function applyOperator(itemValue, op, filterValue) {
+  const strItem = String(itemValue);
+  const numItem = Number(itemValue);
+  const numFilter = Number(filterValue);
+  const numeric = !isNaN(numItem) && !isNaN(numFilter) && filterValue.trim() !== "";
+  switch (op) {
+    case "_gte":
+      return numeric ? numItem >= numFilter : strItem >= filterValue;
+    case "_lte":
+      return numeric ? numItem <= numFilter : strItem <= filterValue;
+    case "_ne":
+      return strItem !== filterValue;
+    case "_like":
+      return strItem.toLowerCase().includes(filterValue.toLowerCase());
+    case "_start":
+      return strItem.toLowerCase().startsWith(filterValue.toLowerCase());
+    case "_regex": {
+      try {
+        return new RegExp(filterValue, "i").test(strItem);
+      } catch {
+        return false;
+      }
+    }
+  }
+}
+function filterByQuery(items, query) {
+  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
+  if (filters.length === 0) return items;
+  return items.filter(
+    (item) => filters.every(([key, value]) => {
+      const op = OPERATORS.find((o) => key.endsWith(o));
+      if (op) {
+        const field = key.slice(0, -op.length);
+        if (item[field] === void 0) return false;
+        const filterVal = Array.isArray(value) ? value[0] : value;
+        return applyOperator(item[field], op, filterVal);
+      }
+      if (item[key] === void 0) return false;
+      const itemStr = String(item[key]);
+      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
+    })
+  );
+}
+function fullTextSearch(items, term) {
+  const lower = term.toLowerCase();
+  return items.filter(
+    (item) => Object.values(item).some((val) => {
+      if (val === null || val === void 0 || typeof val === "object") return false;
+      return String(val).toLowerCase().includes(lower);
+    })
+  );
+}
+function sortBy(items, field, order) {
+  const direction = order === "desc" ? -1 : 1;
+  return [...items].sort((a, b) => {
+    const av = a[field];
+    const bv = b[field];
+    if (av === void 0) return 1;
+    if (bv === void 0) return -1;
+    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
+    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
+  });
+}
+function projectFields(input, fields) {
+  if (fields.length === 0) return input;
+  const project = (item) => Object.fromEntries(fields.filter((f) => f in item).map((f) => [f, item[f]]));
+  return Array.isArray(input) ? input.map(project) : project(input);
+}
+function paginate(items, page, limit) {
+  const start = (page - 1) * limit;
+  return items.slice(start, start + limit);
+}
+
+// src/services/resource.service.ts
 function findById(items, id) {
   return items.find((i) => String(i["id"]) === id);
 }
@@ -252,36 +333,17 @@ function patchItem(storage, resource, id, body) {
   storage.persist();
   return updated;
 }
-function firstParam(value) {
-  if (value === void 0) return void 0;
-  return Array.isArray(value) ? value[0] : value;
-}
-function filterByQuery(items, query) {
-  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
-  if (filters.length === 0) return items;
-  return items.filter(
-    (item) => filters.every(([key, value]) => {
-      if (item[key] === void 0) return false;
-      const itemStr = String(item[key]);
-      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
-    })
-  );
-}
-function sortBy(items, field, order) {
-  const direction = order === "desc" ? -1 : 1;
-  return [...items].sort((a, b) => {
-    const av = a[field];
-    const bv = b[field];
-    if (av === void 0) return 1;
-    if (bv === void 0) return -1;
-    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
-    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
-  });
-}
-function paginate(items, page, limit) {
-  const start = (page - 1) * limit;
-  return items.slice(start, start + limit);
+function deleteItem(storage, resource, id) {
+  const collection = storage.getCollection(resource) ?? [];
+  const idx = findIndexById(collection, id);
+  if (idx === -1) return void 0;
+  const [deleted] = collection.splice(idx, 1);
+  storage.setCollection(resource, collection);
+  storage.persist();
+  return deleted;
 }
+
+// src/services/expand.service.ts
 function expandItems(input, query, resource, storage) {
   const isArray = Array.isArray(input);
   const items = isArray ? input : [input];
@@ -314,14 +376,35 @@ function expandItems(input, query, resource, storage) {
   });
   return isArray ? expanded : expanded[0];
 }
-function deleteItem(storage, resource, id) {
-  const collection = storage.getCollection(resource) ?? [];
-  const idx = findIndexById(collection, id);
-  if (idx === -1) return void 0;
-  const [deleted] = collection.splice(idx, 1);
-  storage.setCollection(resource, collection);
-  storage.persist();
-  return deleted;
+function embedItems(input, query, resource, storage) {
+  const isArray = Array.isArray(input);
+  const items = isArray ? input : [input];
+  const embedParam = query["_embed"];
+  if (!embedParam) return isArray ? items : input;
+  const keys = (Array.isArray(embedParam) ? embedParam : [embedParam]).flatMap((v) => v.split(",")).map((k) => k.trim()).filter(Boolean);
+  const relations = storage.getRelations();
+  const embeds = /* @__PURE__ */ new Map();
+  for (const embedKey of keys) {
+    outer: for (const [childCollection, fields] of Object.entries(relations)) {
+      for (const [fkField, parentCollection] of Object.entries(fields)) {
+        if (parentCollection === resource && childCollection === embedKey) {
+          embeds.set(embedKey, { childCollection, fkField });
+          break outer;
+        }
+      }
+    }
+  }
+  if (embeds.size === 0) return isArray ? items : input;
+  const result = items.map((item) => {
+    const out = { ...item };
+    for (const [embedKey, { childCollection, fkField }] of embeds) {
+      out[embedKey] = (storage.getCollection(childCollection) ?? []).filter(
+        (child) => String(child[fkField]) === String(item["id"])
+      );
+    }
+    return out;
+  });
+  return isArray ? result : result[0];
 }
 
 // src/router/routes/collection.routes.ts
@@ -329,9 +412,12 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
   server.get(base, (req, reply) => {
     const collection = storage.getCollection(resource) ?? [];
     const filtered = filterByQuery(collection, req.query);
+    const searchTerm = firstParam(req.query["_q"]);
+    const searched = searchTerm ? fullTextSearch(filtered, searchTerm) : filtered;
+    const fields = (firstParam(req.query["_fields"]) ?? "").split(",").map((f) => f.trim()).filter(Boolean);
     const sortField = firstParam(req.query["_sort"]);
     const sortOrder = firstParam(req.query["_order"]) === "desc" ? "desc" : "asc";
-    const sorted = sortField ? sortBy(filtered, sortField, sortOrder) : filtered;
+    const sorted = sortField ? sortBy(searched, sortField, sortOrder) : searched;
     if (options.pageable.enabled) {
       const defaultLimit = options.pageable.limit;
       const page = Math.max(1, parseInt(firstParam(req.query["_page"]) ?? "1", 10) || 1);
@@ -341,7 +427,15 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       );
       const totalItems = sorted.length;
       const totalPages = Math.ceil(totalItems / limit) || 1;
-      const data = expandItems(paginate(sorted, page, limit), req.query, resource, storage);
+      const data = projectFields(
+        embedItems(
+          expandItems(paginate(sorted, page, limit), req.query, resource, storage),
+          req.query,
+          resource,
+          storage
+        ),
+        fields
+      );
       const pagination = {
         page,
         limit,
@@ -365,7 +459,10 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       reply.header("X-Total-Count", String(sorted.length));
       result = paginate(sorted, page, limit);
     }
-    return expandItems(result, req.query, resource, storage);
+    return projectFields(
+      embedItems(expandItems(result, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.post(base, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -381,7 +478,11 @@ var registerItemRoutes = (server, storage, resource, base) => {
   server.get(`${base}/:id`, (req, reply) => {
     const item = findById(storage.getCollection(resource) ?? [], req.params.id);
     if (!item) return reply.status(404).send({ error: "Not found" });
-    return expandItems(item, req.query, resource, storage);
+    const fields = (req.query["_fields"] ?? "").split(",").map((f) => f.trim()).filter(Boolean);
+    return projectFields(
+      embedItems(expandItems(item, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.put(`${base}/:id`, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -555,6 +656,22 @@ curl ${host}${base}/${parent}/1/${child}`);
     examples.push(`# Pageable envelope
 curl "${host}${base}/${firstCol}?_page=2"`);
   }
+  const firstParentRel = Object.entries(relations).find(
+    ([, fields]) => Object.values(fields).includes(firstCol ?? "")
+  );
+  if (firstCol) {
+    examples.push(
+      `# Project fields with ?_fields
+curl "${host}${base}/${firstCol}?_fields=id,name"`
+    );
+  }
+  if (firstParentRel && firstCol) {
+    const [childName] = firstParentRel;
+    examples.push(
+      `# Embed child collection with ?_embed
+curl "${host}${base}/${firstCol}/1?_embed=${childName}"`
+    );
+  }
   if (options.snapshot) {
     examples.push(
       `# Snapshot endpoints
@@ -766,9 +883,17 @@ function generateAboutHtml(storage, options) {
         <thead><tr><th>Param</th><th>Example</th><th>Description</th></tr></thead>
         <tbody>
           <tr><td><code>?field=value</code></td><td><code>?name=Ana&amp;role=admin</code></td><td>Filter by any field. Multiple params are ANDed.</td></tr>
+          <tr><td><code>?field_gte / _lte</code></td><td><code>?price_gte=10&amp;price_lte=50</code></td><td>Numeric or lexicographic range. Works with any comparable field.</td></tr>
+          <tr><td><code>?field_ne</code></td><td><code>?status_ne=inactive</code></td><td>Exclude items where the field equals the value.</td></tr>
+          <tr><td><code>?field_like</code></td><td><code>?name_like=ana</code></td><td>Case-insensitive substring match.</td></tr>
+          <tr><td><code>?field_start</code></td><td><code>?name_start=A</code></td><td>Case-insensitive prefix match.</td></tr>
+          <tr><td><code>?field_regex</code></td><td><code>?email_regex=gmail</code></td><td>Case-insensitive regular expression match.</td></tr>
+          <tr><td><code>?_q</code></td><td><code>?_q=ana</code></td><td>Full-text search across all scalar fields (case-insensitive substring).</td></tr>
           <tr><td><code>?_sort &amp; ?_order</code></td><td><code>?_sort=name&amp;_order=desc</code></td><td>Sort by field. <code>_order</code>: <code>asc</code> (default) or <code>desc</code>.</td></tr>
           <tr><td><code>?_page &amp; ?_limit</code></td><td><code>?_page=2&amp;_limit=10</code></td><td>${paginationDesc}</td></tr>
           <tr><td><code>?_expand</code></td><td><code>?_expand=user</code></td><td>Embed a related parent object inline. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_embed</code></td><td><code>?_embed=posts</code></td><td>Embed child collections into each parent item. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_fields</code></td><td><code>?_fields=id,name</code></td><td>Return only the specified fields. Applied last \u2014 can include embedded/expanded keys.</td></tr>
         </tbody>
       </table>
     </div>

package/dist/cli/index.mjs

@@ -184,11 +184,92 @@ function createYamlStorage(filePath) {
 import Fastify from "fastify";
 import cors from "@fastify/cors";
 
-// src/services/resourceService.ts
+// src/utils/params.ts
 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 firstParam(value) {
+  if (value === void 0) return void 0;
+  return Array.isArray(value) ? value[0] : value;
+}
+
+// src/services/query.service.ts
+var OPERATORS = ["_gte", "_lte", "_ne", "_like", "_start", "_regex"];
+function applyOperator(itemValue, op, filterValue) {
+  const strItem = String(itemValue);
+  const numItem = Number(itemValue);
+  const numFilter = Number(filterValue);
+  const numeric = !isNaN(numItem) && !isNaN(numFilter) && filterValue.trim() !== "";
+  switch (op) {
+    case "_gte":
+      return numeric ? numItem >= numFilter : strItem >= filterValue;
+    case "_lte":
+      return numeric ? numItem <= numFilter : strItem <= filterValue;
+    case "_ne":
+      return strItem !== filterValue;
+    case "_like":
+      return strItem.toLowerCase().includes(filterValue.toLowerCase());
+    case "_start":
+      return strItem.toLowerCase().startsWith(filterValue.toLowerCase());
+    case "_regex": {
+      try {
+        return new RegExp(filterValue, "i").test(strItem);
+      } catch {
+        return false;
+      }
+    }
+  }
+}
+function filterByQuery(items, query) {
+  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
+  if (filters.length === 0) return items;
+  return items.filter(
+    (item) => filters.every(([key, value]) => {
+      const op = OPERATORS.find((o) => key.endsWith(o));
+      if (op) {
+        const field = key.slice(0, -op.length);
+        if (item[field] === void 0) return false;
+        const filterVal = Array.isArray(value) ? value[0] : value;
+        return applyOperator(item[field], op, filterVal);
+      }
+      if (item[key] === void 0) return false;
+      const itemStr = String(item[key]);
+      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
+    })
+  );
+}
+function fullTextSearch(items, term) {
+  const lower = term.toLowerCase();
+  return items.filter(
+    (item) => Object.values(item).some((val) => {
+      if (val === null || val === void 0 || typeof val === "object") return false;
+      return String(val).toLowerCase().includes(lower);
+    })
+  );
+}
+function sortBy(items, field, order) {
+  const direction = order === "desc" ? -1 : 1;
+  return [...items].sort((a, b) => {
+    const av = a[field];
+    const bv = b[field];
+    if (av === void 0) return 1;
+    if (bv === void 0) return -1;
+    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
+    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
+  });
+}
+function projectFields(input, fields) {
+  if (fields.length === 0) return input;
+  const project = (item) => Object.fromEntries(fields.filter((f) => f in item).map((f) => [f, item[f]]));
+  return Array.isArray(input) ? input.map(project) : project(input);
+}
+function paginate(items, page, limit) {
+  const start = (page - 1) * limit;
+  return items.slice(start, start + limit);
+}
+
+// src/services/resource.service.ts
 function findById(items, id) {
   return items.find((i) => String(i["id"]) === id);
 }
@@ -225,36 +306,17 @@ function patchItem(storage, resource, id, body) {
   storage.persist();
   return updated;
 }
-function firstParam(value) {
-  if (value === void 0) return void 0;
-  return Array.isArray(value) ? value[0] : value;
-}
-function filterByQuery(items, query) {
-  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
-  if (filters.length === 0) return items;
-  return items.filter(
-    (item) => filters.every(([key, value]) => {
-      if (item[key] === void 0) return false;
-      const itemStr = String(item[key]);
-      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
-    })
-  );
-}
-function sortBy(items, field, order) {
-  const direction = order === "desc" ? -1 : 1;
-  return [...items].sort((a, b) => {
-    const av = a[field];
-    const bv = b[field];
-    if (av === void 0) return 1;
-    if (bv === void 0) return -1;
-    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
-    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
-  });
-}
-function paginate(items, page, limit) {
-  const start = (page - 1) * limit;
-  return items.slice(start, start + limit);
+function deleteItem(storage, resource, id) {
+  const collection = storage.getCollection(resource) ?? [];
+  const idx = findIndexById(collection, id);
+  if (idx === -1) return void 0;
+  const [deleted] = collection.splice(idx, 1);
+  storage.setCollection(resource, collection);
+  storage.persist();
+  return deleted;
 }
+
+// src/services/expand.service.ts
 function expandItems(input, query, resource, storage) {
   const isArray = Array.isArray(input);
   const items = isArray ? input : [input];
@@ -287,14 +349,35 @@ function expandItems(input, query, resource, storage) {
   });
   return isArray ? expanded : expanded[0];
 }
-function deleteItem(storage, resource, id) {
-  const collection = storage.getCollection(resource) ?? [];
-  const idx = findIndexById(collection, id);
-  if (idx === -1) return void 0;
-  const [deleted] = collection.splice(idx, 1);
-  storage.setCollection(resource, collection);
-  storage.persist();
-  return deleted;
+function embedItems(input, query, resource, storage) {
+  const isArray = Array.isArray(input);
+  const items = isArray ? input : [input];
+  const embedParam = query["_embed"];
+  if (!embedParam) return isArray ? items : input;
+  const keys = (Array.isArray(embedParam) ? embedParam : [embedParam]).flatMap((v) => v.split(",")).map((k) => k.trim()).filter(Boolean);
+  const relations = storage.getRelations();
+  const embeds = /* @__PURE__ */ new Map();
+  for (const embedKey of keys) {
+    outer: for (const [childCollection, fields] of Object.entries(relations)) {
+      for (const [fkField, parentCollection] of Object.entries(fields)) {
+        if (parentCollection === resource && childCollection === embedKey) {
+          embeds.set(embedKey, { childCollection, fkField });
+          break outer;
+        }
+      }
+    }
+  }
+  if (embeds.size === 0) return isArray ? items : input;
+  const result = items.map((item) => {
+    const out = { ...item };
+    for (const [embedKey, { childCollection, fkField }] of embeds) {
+      out[embedKey] = (storage.getCollection(childCollection) ?? []).filter(
+        (child) => String(child[fkField]) === String(item["id"])
+      );
+    }
+    return out;
+  });
+  return isArray ? result : result[0];
 }
 
 // src/router/routes/collection.routes.ts
@@ -302,9 +385,12 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
   server.get(base, (req, reply) => {
     const collection = storage.getCollection(resource) ?? [];
     const filtered = filterByQuery(collection, req.query);
+    const searchTerm = firstParam(req.query["_q"]);
+    const searched = searchTerm ? fullTextSearch(filtered, searchTerm) : filtered;
+    const fields = (firstParam(req.query["_fields"]) ?? "").split(",").map((f) => f.trim()).filter(Boolean);
     const sortField = firstParam(req.query["_sort"]);
     const sortOrder = firstParam(req.query["_order"]) === "desc" ? "desc" : "asc";
-    const sorted = sortField ? sortBy(filtered, sortField, sortOrder) : filtered;
+    const sorted = sortField ? sortBy(searched, sortField, sortOrder) : searched;
     if (options.pageable.enabled) {
       const defaultLimit = options.pageable.limit;
       const page = Math.max(1, parseInt(firstParam(req.query["_page"]) ?? "1", 10) || 1);
@@ -314,7 +400,15 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       );
       const totalItems = sorted.length;
       const totalPages = Math.ceil(totalItems / limit) || 1;
-      const data = expandItems(paginate(sorted, page, limit), req.query, resource, storage);
+      const data = projectFields(
+        embedItems(
+          expandItems(paginate(sorted, page, limit), req.query, resource, storage),
+          req.query,
+          resource,
+          storage
+        ),
+        fields
+      );
       const pagination = {
         page,
         limit,
@@ -338,7 +432,10 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       reply.header("X-Total-Count", String(sorted.length));
       result = paginate(sorted, page, limit);
     }
-    return expandItems(result, req.query, resource, storage);
+    return projectFields(
+      embedItems(expandItems(result, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.post(base, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -354,7 +451,11 @@ var registerItemRoutes = (server, storage, resource, base) => {
   server.get(`${base}/:id`, (req, reply) => {
     const item = findById(storage.getCollection(resource) ?? [], req.params.id);
     if (!item) return reply.status(404).send({ error: "Not found" });
-    return expandItems(item, req.query, resource, storage);
+    const fields = (req.query["_fields"] ?? "").split(",").map((f) => f.trim()).filter(Boolean);
+    return projectFields(
+      embedItems(expandItems(item, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.put(`${base}/:id`, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -528,6 +629,22 @@ curl ${host}${base}/${parent}/1/${child}`);
     examples.push(`# Pageable envelope
 curl "${host}${base}/${firstCol}?_page=2"`);
   }
+  const firstParentRel = Object.entries(relations).find(
+    ([, fields]) => Object.values(fields).includes(firstCol ?? "")
+  );
+  if (firstCol) {
+    examples.push(
+      `# Project fields with ?_fields
+curl "${host}${base}/${firstCol}?_fields=id,name"`
+    );
+  }
+  if (firstParentRel && firstCol) {
+    const [childName] = firstParentRel;
+    examples.push(
+      `# Embed child collection with ?_embed
+curl "${host}${base}/${firstCol}/1?_embed=${childName}"`
+    );
+  }
   if (options.snapshot) {
     examples.push(
       `# Snapshot endpoints
@@ -739,9 +856,17 @@ function generateAboutHtml(storage, options) {
         <thead><tr><th>Param</th><th>Example</th><th>Description</th></tr></thead>
         <tbody>
           <tr><td><code>?field=value</code></td><td><code>?name=Ana&amp;role=admin</code></td><td>Filter by any field. Multiple params are ANDed.</td></tr>
+          <tr><td><code>?field_gte / _lte</code></td><td><code>?price_gte=10&amp;price_lte=50</code></td><td>Numeric or lexicographic range. Works with any comparable field.</td></tr>
+          <tr><td><code>?field_ne</code></td><td><code>?status_ne=inactive</code></td><td>Exclude items where the field equals the value.</td></tr>
+          <tr><td><code>?field_like</code></td><td><code>?name_like=ana</code></td><td>Case-insensitive substring match.</td></tr>
+          <tr><td><code>?field_start</code></td><td><code>?name_start=A</code></td><td>Case-insensitive prefix match.</td></tr>
+          <tr><td><code>?field_regex</code></td><td><code>?email_regex=gmail</code></td><td>Case-insensitive regular expression match.</td></tr>
+          <tr><td><code>?_q</code></td><td><code>?_q=ana</code></td><td>Full-text search across all scalar fields (case-insensitive substring).</td></tr>
           <tr><td><code>?_sort &amp; ?_order</code></td><td><code>?_sort=name&amp;_order=desc</code></td><td>Sort by field. <code>_order</code>: <code>asc</code> (default) or <code>desc</code>.</td></tr>
           <tr><td><code>?_page &amp; ?_limit</code></td><td><code>?_page=2&amp;_limit=10</code></td><td>${paginationDesc}</td></tr>
           <tr><td><code>?_expand</code></td><td><code>?_expand=user</code></td><td>Embed a related parent object inline. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_embed</code></td><td><code>?_embed=posts</code></td><td>Embed child collections into each parent item. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_fields</code></td><td><code>?_fields=id,name</code></td><td>Return only the specified fields. Applied last \u2014 can include embedded/expanded keys.</td></tr>
         </tbody>
       </table>
     </div>

package/dist/index.js

@@ -113,11 +113,92 @@ function createYamlStorage(filePath) {
 var import_fastify = __toESM(require("fastify"));
 var import_cors = __toESM(require("@fastify/cors"));
 
-// src/services/resourceService.ts
+// src/utils/params.ts
 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 firstParam(value) {
+  if (value === void 0) return void 0;
+  return Array.isArray(value) ? value[0] : value;
+}
+
+// src/services/query.service.ts
+var OPERATORS = ["_gte", "_lte", "_ne", "_like", "_start", "_regex"];
+function applyOperator(itemValue, op, filterValue) {
+  const strItem = String(itemValue);
+  const numItem = Number(itemValue);
+  const numFilter = Number(filterValue);
+  const numeric = !isNaN(numItem) && !isNaN(numFilter) && filterValue.trim() !== "";
+  switch (op) {
+    case "_gte":
+      return numeric ? numItem >= numFilter : strItem >= filterValue;
+    case "_lte":
+      return numeric ? numItem <= numFilter : strItem <= filterValue;
+    case "_ne":
+      return strItem !== filterValue;
+    case "_like":
+      return strItem.toLowerCase().includes(filterValue.toLowerCase());
+    case "_start":
+      return strItem.toLowerCase().startsWith(filterValue.toLowerCase());
+    case "_regex": {
+      try {
+        return new RegExp(filterValue, "i").test(strItem);
+      } catch {
+        return false;
+      }
+    }
+  }
+}
+function filterByQuery(items, query) {
+  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
+  if (filters.length === 0) return items;
+  return items.filter(
+    (item) => filters.every(([key, value]) => {
+      const op = OPERATORS.find((o) => key.endsWith(o));
+      if (op) {
+        const field = key.slice(0, -op.length);
+        if (item[field] === void 0) return false;
+        const filterVal = Array.isArray(value) ? value[0] : value;
+        return applyOperator(item[field], op, filterVal);
+      }
+      if (item[key] === void 0) return false;
+      const itemStr = String(item[key]);
+      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
+    })
+  );
+}
+function fullTextSearch(items, term) {
+  const lower = term.toLowerCase();
+  return items.filter(
+    (item) => Object.values(item).some((val) => {
+      if (val === null || val === void 0 || typeof val === "object") return false;
+      return String(val).toLowerCase().includes(lower);
+    })
+  );
+}
+function sortBy(items, field, order) {
+  const direction = order === "desc" ? -1 : 1;
+  return [...items].sort((a, b) => {
+    const av = a[field];
+    const bv = b[field];
+    if (av === void 0) return 1;
+    if (bv === void 0) return -1;
+    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
+    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
+  });
+}
+function projectFields(input, fields) {
+  if (fields.length === 0) return input;
+  const project = (item) => Object.fromEntries(fields.filter((f) => f in item).map((f) => [f, item[f]]));
+  return Array.isArray(input) ? input.map(project) : project(input);
+}
+function paginate(items, page, limit) {
+  const start = (page - 1) * limit;
+  return items.slice(start, start + limit);
+}
+
+// src/services/resource.service.ts
 function findById(items, id) {
   return items.find((i) => String(i["id"]) === id);
 }
@@ -154,36 +235,17 @@ function patchItem(storage, resource, id, body) {
   storage.persist();
   return updated;
 }
-function firstParam(value) {
-  if (value === void 0) return void 0;
-  return Array.isArray(value) ? value[0] : value;
-}
-function filterByQuery(items, query) {
-  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
-  if (filters.length === 0) return items;
-  return items.filter(
-    (item) => filters.every(([key, value]) => {
-      if (item[key] === void 0) return false;
-      const itemStr = String(item[key]);
-      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
-    })
-  );
-}
-function sortBy(items, field, order) {
-  const direction = order === "desc" ? -1 : 1;
-  return [...items].sort((a, b) => {
-    const av = a[field];
-    const bv = b[field];
-    if (av === void 0) return 1;
-    if (bv === void 0) return -1;
-    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
-    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
-  });
-}
-function paginate(items, page, limit) {
-  const start = (page - 1) * limit;
-  return items.slice(start, start + limit);
+function deleteItem(storage, resource, id) {
+  const collection = storage.getCollection(resource) ?? [];
+  const idx = findIndexById(collection, id);
+  if (idx === -1) return void 0;
+  const [deleted] = collection.splice(idx, 1);
+  storage.setCollection(resource, collection);
+  storage.persist();
+  return deleted;
 }
+
+// src/services/expand.service.ts
 function expandItems(input, query, resource, storage) {
   const isArray = Array.isArray(input);
   const items = isArray ? input : [input];
@@ -216,14 +278,35 @@ function expandItems(input, query, resource, storage) {
   });
   return isArray ? expanded : expanded[0];
 }
-function deleteItem(storage, resource, id) {
-  const collection = storage.getCollection(resource) ?? [];
-  const idx = findIndexById(collection, id);
-  if (idx === -1) return void 0;
-  const [deleted] = collection.splice(idx, 1);
-  storage.setCollection(resource, collection);
-  storage.persist();
-  return deleted;
+function embedItems(input, query, resource, storage) {
+  const isArray = Array.isArray(input);
+  const items = isArray ? input : [input];
+  const embedParam = query["_embed"];
+  if (!embedParam) return isArray ? items : input;
+  const keys = (Array.isArray(embedParam) ? embedParam : [embedParam]).flatMap((v) => v.split(",")).map((k) => k.trim()).filter(Boolean);
+  const relations = storage.getRelations();
+  const embeds = /* @__PURE__ */ new Map();
+  for (const embedKey of keys) {
+    outer: for (const [childCollection, fields] of Object.entries(relations)) {
+      for (const [fkField, parentCollection] of Object.entries(fields)) {
+        if (parentCollection === resource && childCollection === embedKey) {
+          embeds.set(embedKey, { childCollection, fkField });
+          break outer;
+        }
+      }
+    }
+  }
+  if (embeds.size === 0) return isArray ? items : input;
+  const result = items.map((item) => {
+    const out = { ...item };
+    for (const [embedKey, { childCollection, fkField }] of embeds) {
+      out[embedKey] = (storage.getCollection(childCollection) ?? []).filter(
+        (child) => String(child[fkField]) === String(item["id"])
+      );
+    }
+    return out;
+  });
+  return isArray ? result : result[0];
 }
 
 // src/router/routes/collection.routes.ts
@@ -231,9 +314,12 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
   server.get(base, (req, reply) => {
     const collection = storage.getCollection(resource) ?? [];
     const filtered = filterByQuery(collection, req.query);
+    const searchTerm = firstParam(req.query["_q"]);
+    const searched = searchTerm ? fullTextSearch(filtered, searchTerm) : filtered;
+    const fields = (firstParam(req.query["_fields"]) ?? "").split(",").map((f) => f.trim()).filter(Boolean);
     const sortField = firstParam(req.query["_sort"]);
     const sortOrder = firstParam(req.query["_order"]) === "desc" ? "desc" : "asc";
-    const sorted = sortField ? sortBy(filtered, sortField, sortOrder) : filtered;
+    const sorted = sortField ? sortBy(searched, sortField, sortOrder) : searched;
     if (options.pageable.enabled) {
       const defaultLimit = options.pageable.limit;
       const page = Math.max(1, parseInt(firstParam(req.query["_page"]) ?? "1", 10) || 1);
@@ -243,7 +329,15 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       );
       const totalItems = sorted.length;
       const totalPages = Math.ceil(totalItems / limit) || 1;
-      const data = expandItems(paginate(sorted, page, limit), req.query, resource, storage);
+      const data = projectFields(
+        embedItems(
+          expandItems(paginate(sorted, page, limit), req.query, resource, storage),
+          req.query,
+          resource,
+          storage
+        ),
+        fields
+      );
       const pagination = {
         page,
         limit,
@@ -267,7 +361,10 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       reply.header("X-Total-Count", String(sorted.length));
       result = paginate(sorted, page, limit);
     }
-    return expandItems(result, req.query, resource, storage);
+    return projectFields(
+      embedItems(expandItems(result, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.post(base, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -283,7 +380,11 @@ var registerItemRoutes = (server, storage, resource, base) => {
   server.get(`${base}/:id`, (req, reply) => {
     const item = findById(storage.getCollection(resource) ?? [], req.params.id);
     if (!item) return reply.status(404).send({ error: "Not found" });
-    return expandItems(item, req.query, resource, storage);
+    const fields = (req.query["_fields"] ?? "").split(",").map((f) => f.trim()).filter(Boolean);
+    return projectFields(
+      embedItems(expandItems(item, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.put(`${base}/:id`, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -457,6 +558,22 @@ curl ${host}${base}/${parent}/1/${child}`);
     examples.push(`# Pageable envelope
 curl "${host}${base}/${firstCol}?_page=2"`);
   }
+  const firstParentRel = Object.entries(relations).find(
+    ([, fields]) => Object.values(fields).includes(firstCol ?? "")
+  );
+  if (firstCol) {
+    examples.push(
+      `# Project fields with ?_fields
+curl "${host}${base}/${firstCol}?_fields=id,name"`
+    );
+  }
+  if (firstParentRel && firstCol) {
+    const [childName] = firstParentRel;
+    examples.push(
+      `# Embed child collection with ?_embed
+curl "${host}${base}/${firstCol}/1?_embed=${childName}"`
+    );
+  }
   if (options.snapshot) {
     examples.push(
       `# Snapshot endpoints
@@ -668,9 +785,17 @@ function generateAboutHtml(storage, options) {
         <thead><tr><th>Param</th><th>Example</th><th>Description</th></tr></thead>
         <tbody>
           <tr><td><code>?field=value</code></td><td><code>?name=Ana&amp;role=admin</code></td><td>Filter by any field. Multiple params are ANDed.</td></tr>
+          <tr><td><code>?field_gte / _lte</code></td><td><code>?price_gte=10&amp;price_lte=50</code></td><td>Numeric or lexicographic range. Works with any comparable field.</td></tr>
+          <tr><td><code>?field_ne</code></td><td><code>?status_ne=inactive</code></td><td>Exclude items where the field equals the value.</td></tr>
+          <tr><td><code>?field_like</code></td><td><code>?name_like=ana</code></td><td>Case-insensitive substring match.</td></tr>
+          <tr><td><code>?field_start</code></td><td><code>?name_start=A</code></td><td>Case-insensitive prefix match.</td></tr>
+          <tr><td><code>?field_regex</code></td><td><code>?email_regex=gmail</code></td><td>Case-insensitive regular expression match.</td></tr>
+          <tr><td><code>?_q</code></td><td><code>?_q=ana</code></td><td>Full-text search across all scalar fields (case-insensitive substring).</td></tr>
           <tr><td><code>?_sort &amp; ?_order</code></td><td><code>?_sort=name&amp;_order=desc</code></td><td>Sort by field. <code>_order</code>: <code>asc</code> (default) or <code>desc</code>.</td></tr>
           <tr><td><code>?_page &amp; ?_limit</code></td><td><code>?_page=2&amp;_limit=10</code></td><td>${paginationDesc}</td></tr>
           <tr><td><code>?_expand</code></td><td><code>?_expand=user</code></td><td>Embed a related parent object inline. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_embed</code></td><td><code>?_embed=posts</code></td><td>Embed child collections into each parent item. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_fields</code></td><td><code>?_fields=id,name</code></td><td>Return only the specified fields. Applied last \u2014 can include embedded/expanded keys.</td></tr>
         </tbody>
       </table>
     </div>

package/dist/index.mjs

@@ -75,11 +75,92 @@ function createYamlStorage(filePath) {
 import Fastify from "fastify";
 import cors from "@fastify/cors";
 
-// src/services/resourceService.ts
+// src/utils/params.ts
 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 firstParam(value) {
+  if (value === void 0) return void 0;
+  return Array.isArray(value) ? value[0] : value;
+}
+
+// src/services/query.service.ts
+var OPERATORS = ["_gte", "_lte", "_ne", "_like", "_start", "_regex"];
+function applyOperator(itemValue, op, filterValue) {
+  const strItem = String(itemValue);
+  const numItem = Number(itemValue);
+  const numFilter = Number(filterValue);
+  const numeric = !isNaN(numItem) && !isNaN(numFilter) && filterValue.trim() !== "";
+  switch (op) {
+    case "_gte":
+      return numeric ? numItem >= numFilter : strItem >= filterValue;
+    case "_lte":
+      return numeric ? numItem <= numFilter : strItem <= filterValue;
+    case "_ne":
+      return strItem !== filterValue;
+    case "_like":
+      return strItem.toLowerCase().includes(filterValue.toLowerCase());
+    case "_start":
+      return strItem.toLowerCase().startsWith(filterValue.toLowerCase());
+    case "_regex": {
+      try {
+        return new RegExp(filterValue, "i").test(strItem);
+      } catch {
+        return false;
+      }
+    }
+  }
+}
+function filterByQuery(items, query) {
+  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
+  if (filters.length === 0) return items;
+  return items.filter(
+    (item) => filters.every(([key, value]) => {
+      const op = OPERATORS.find((o) => key.endsWith(o));
+      if (op) {
+        const field = key.slice(0, -op.length);
+        if (item[field] === void 0) return false;
+        const filterVal = Array.isArray(value) ? value[0] : value;
+        return applyOperator(item[field], op, filterVal);
+      }
+      if (item[key] === void 0) return false;
+      const itemStr = String(item[key]);
+      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
+    })
+  );
+}
+function fullTextSearch(items, term) {
+  const lower = term.toLowerCase();
+  return items.filter(
+    (item) => Object.values(item).some((val) => {
+      if (val === null || val === void 0 || typeof val === "object") return false;
+      return String(val).toLowerCase().includes(lower);
+    })
+  );
+}
+function sortBy(items, field, order) {
+  const direction = order === "desc" ? -1 : 1;
+  return [...items].sort((a, b) => {
+    const av = a[field];
+    const bv = b[field];
+    if (av === void 0) return 1;
+    if (bv === void 0) return -1;
+    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
+    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
+  });
+}
+function projectFields(input, fields) {
+  if (fields.length === 0) return input;
+  const project = (item) => Object.fromEntries(fields.filter((f) => f in item).map((f) => [f, item[f]]));
+  return Array.isArray(input) ? input.map(project) : project(input);
+}
+function paginate(items, page, limit) {
+  const start = (page - 1) * limit;
+  return items.slice(start, start + limit);
+}
+
+// src/services/resource.service.ts
 function findById(items, id) {
   return items.find((i) => String(i["id"]) === id);
 }
@@ -116,36 +197,17 @@ function patchItem(storage, resource, id, body) {
   storage.persist();
   return updated;
 }
-function firstParam(value) {
-  if (value === void 0) return void 0;
-  return Array.isArray(value) ? value[0] : value;
-}
-function filterByQuery(items, query) {
-  const filters = Object.entries(query).filter(([key]) => !key.startsWith("_"));
-  if (filters.length === 0) return items;
-  return items.filter(
-    (item) => filters.every(([key, value]) => {
-      if (item[key] === void 0) return false;
-      const itemStr = String(item[key]);
-      return Array.isArray(value) ? value.includes(itemStr) : itemStr === value;
-    })
-  );
-}
-function sortBy(items, field, order) {
-  const direction = order === "desc" ? -1 : 1;
-  return [...items].sort((a, b) => {
-    const av = a[field];
-    const bv = b[field];
-    if (av === void 0) return 1;
-    if (bv === void 0) return -1;
-    if (typeof av === "number" && typeof bv === "number") return (av - bv) * direction;
-    return String(av).localeCompare(String(bv), void 0, { sensitivity: "base" }) * direction;
-  });
-}
-function paginate(items, page, limit) {
-  const start = (page - 1) * limit;
-  return items.slice(start, start + limit);
+function deleteItem(storage, resource, id) {
+  const collection = storage.getCollection(resource) ?? [];
+  const idx = findIndexById(collection, id);
+  if (idx === -1) return void 0;
+  const [deleted] = collection.splice(idx, 1);
+  storage.setCollection(resource, collection);
+  storage.persist();
+  return deleted;
 }
+
+// src/services/expand.service.ts
 function expandItems(input, query, resource, storage) {
   const isArray = Array.isArray(input);
   const items = isArray ? input : [input];
@@ -178,14 +240,35 @@ function expandItems(input, query, resource, storage) {
   });
   return isArray ? expanded : expanded[0];
 }
-function deleteItem(storage, resource, id) {
-  const collection = storage.getCollection(resource) ?? [];
-  const idx = findIndexById(collection, id);
-  if (idx === -1) return void 0;
-  const [deleted] = collection.splice(idx, 1);
-  storage.setCollection(resource, collection);
-  storage.persist();
-  return deleted;
+function embedItems(input, query, resource, storage) {
+  const isArray = Array.isArray(input);
+  const items = isArray ? input : [input];
+  const embedParam = query["_embed"];
+  if (!embedParam) return isArray ? items : input;
+  const keys = (Array.isArray(embedParam) ? embedParam : [embedParam]).flatMap((v) => v.split(",")).map((k) => k.trim()).filter(Boolean);
+  const relations = storage.getRelations();
+  const embeds = /* @__PURE__ */ new Map();
+  for (const embedKey of keys) {
+    outer: for (const [childCollection, fields] of Object.entries(relations)) {
+      for (const [fkField, parentCollection] of Object.entries(fields)) {
+        if (parentCollection === resource && childCollection === embedKey) {
+          embeds.set(embedKey, { childCollection, fkField });
+          break outer;
+        }
+      }
+    }
+  }
+  if (embeds.size === 0) return isArray ? items : input;
+  const result = items.map((item) => {
+    const out = { ...item };
+    for (const [embedKey, { childCollection, fkField }] of embeds) {
+      out[embedKey] = (storage.getCollection(childCollection) ?? []).filter(
+        (child) => String(child[fkField]) === String(item["id"])
+      );
+    }
+    return out;
+  });
+  return isArray ? result : result[0];
 }
 
 // src/router/routes/collection.routes.ts
@@ -193,9 +276,12 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
   server.get(base, (req, reply) => {
     const collection = storage.getCollection(resource) ?? [];
     const filtered = filterByQuery(collection, req.query);
+    const searchTerm = firstParam(req.query["_q"]);
+    const searched = searchTerm ? fullTextSearch(filtered, searchTerm) : filtered;
+    const fields = (firstParam(req.query["_fields"]) ?? "").split(",").map((f) => f.trim()).filter(Boolean);
     const sortField = firstParam(req.query["_sort"]);
     const sortOrder = firstParam(req.query["_order"]) === "desc" ? "desc" : "asc";
-    const sorted = sortField ? sortBy(filtered, sortField, sortOrder) : filtered;
+    const sorted = sortField ? sortBy(searched, sortField, sortOrder) : searched;
     if (options.pageable.enabled) {
       const defaultLimit = options.pageable.limit;
       const page = Math.max(1, parseInt(firstParam(req.query["_page"]) ?? "1", 10) || 1);
@@ -205,7 +291,15 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       );
       const totalItems = sorted.length;
       const totalPages = Math.ceil(totalItems / limit) || 1;
-      const data = expandItems(paginate(sorted, page, limit), req.query, resource, storage);
+      const data = projectFields(
+        embedItems(
+          expandItems(paginate(sorted, page, limit), req.query, resource, storage),
+          req.query,
+          resource,
+          storage
+        ),
+        fields
+      );
       const pagination = {
         page,
         limit,
@@ -229,7 +323,10 @@ var registerCollectionRoutes = (server, storage, resource, base, options) => {
       reply.header("X-Total-Count", String(sorted.length));
       result = paginate(sorted, page, limit);
     }
-    return expandItems(result, req.query, resource, storage);
+    return projectFields(
+      embedItems(expandItems(result, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.post(base, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -245,7 +342,11 @@ var registerItemRoutes = (server, storage, resource, base) => {
   server.get(`${base}/:id`, (req, reply) => {
     const item = findById(storage.getCollection(resource) ?? [], req.params.id);
     if (!item) return reply.status(404).send({ error: "Not found" });
-    return expandItems(item, req.query, resource, storage);
+    const fields = (req.query["_fields"] ?? "").split(",").map((f) => f.trim()).filter(Boolean);
+    return projectFields(
+      embedItems(expandItems(item, req.query, resource, storage), req.query, resource, storage),
+      fields
+    );
   });
   server.put(`${base}/:id`, (req, reply) => {
     if (!req.body || typeof req.body !== "object" || Array.isArray(req.body)) {
@@ -419,6 +520,22 @@ curl ${host}${base}/${parent}/1/${child}`);
     examples.push(`# Pageable envelope
 curl "${host}${base}/${firstCol}?_page=2"`);
   }
+  const firstParentRel = Object.entries(relations).find(
+    ([, fields]) => Object.values(fields).includes(firstCol ?? "")
+  );
+  if (firstCol) {
+    examples.push(
+      `# Project fields with ?_fields
+curl "${host}${base}/${firstCol}?_fields=id,name"`
+    );
+  }
+  if (firstParentRel && firstCol) {
+    const [childName] = firstParentRel;
+    examples.push(
+      `# Embed child collection with ?_embed
+curl "${host}${base}/${firstCol}/1?_embed=${childName}"`
+    );
+  }
   if (options.snapshot) {
     examples.push(
       `# Snapshot endpoints
@@ -630,9 +747,17 @@ function generateAboutHtml(storage, options) {
         <thead><tr><th>Param</th><th>Example</th><th>Description</th></tr></thead>
         <tbody>
           <tr><td><code>?field=value</code></td><td><code>?name=Ana&amp;role=admin</code></td><td>Filter by any field. Multiple params are ANDed.</td></tr>
+          <tr><td><code>?field_gte / _lte</code></td><td><code>?price_gte=10&amp;price_lte=50</code></td><td>Numeric or lexicographic range. Works with any comparable field.</td></tr>
+          <tr><td><code>?field_ne</code></td><td><code>?status_ne=inactive</code></td><td>Exclude items where the field equals the value.</td></tr>
+          <tr><td><code>?field_like</code></td><td><code>?name_like=ana</code></td><td>Case-insensitive substring match.</td></tr>
+          <tr><td><code>?field_start</code></td><td><code>?name_start=A</code></td><td>Case-insensitive prefix match.</td></tr>
+          <tr><td><code>?field_regex</code></td><td><code>?email_regex=gmail</code></td><td>Case-insensitive regular expression match.</td></tr>
+          <tr><td><code>?_q</code></td><td><code>?_q=ana</code></td><td>Full-text search across all scalar fields (case-insensitive substring).</td></tr>
           <tr><td><code>?_sort &amp; ?_order</code></td><td><code>?_sort=name&amp;_order=desc</code></td><td>Sort by field. <code>_order</code>: <code>asc</code> (default) or <code>desc</code>.</td></tr>
           <tr><td><code>?_page &amp; ?_limit</code></td><td><code>?_page=2&amp;_limit=10</code></td><td>${paginationDesc}</td></tr>
           <tr><td><code>?_expand</code></td><td><code>?_expand=user</code></td><td>Embed a related parent object inline. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_embed</code></td><td><code>?_embed=posts</code></td><td>Embed child collections into each parent item. Requires <code>_rel</code> in the YAML file.</td></tr>
+          <tr><td><code>?_fields</code></td><td><code>?_fields=id,name</code></td><td>Return only the specified fields. Applied last \u2014 can include embedded/expanded keys.</td></tr>
         </tbody>
       </table>
     </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aggiovato/yrest",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Zero-config REST API mock server powered by a YAML file",
   "keywords": [
     "yaml",