@easy-cms/core 1.12.0 → 1.13.0

package/dist/{chunk-244WCY6S.js → chunk-MHXQUX74.js}

@@ -4637,7 +4637,7 @@ function read(response, maxBytes, deadline) {
 var keys = (list) => new Set(list.split(/\s+/).filter(Boolean));
 var CONFIG = keys(`secret db serverURL cors cronSecret timeZone webhooks events jobs localization routes admin
   upload auth collections globals endpoints cliCommands onRequest fieldTypes apiKeys email backups
-  audit logs countCacheSeconds maxPage httpCache outbox plugins`);
+  audit logs countCacheSeconds maxPage httpCache outbox search plugins`);
 var ADMIN = keys("path locale brand siteURL nav commands modules pages dashboard switcher");
 var AUTH = keys(`roles rbac tokenExpiration maxLoginAttempts lockWindow trustedOrigins
   resetPasswordExpiration inviteExpiration providers providerSignUp password setupCode members emails`);
@@ -4647,7 +4647,7 @@ var BACKUPS = keys("frequency at keep dir storage sqlite encryptionKey");
 var AUDIT = keys("keepDays values failedLogins scope");
 var LOGS = keys("format requests");
 var COLLECTION = keys(`slug labels fields useAsTitle drafts versions schedule preview access hooks
-  admin httpCache`);
+  admin httpCache search`);
 var GLOBAL = keys(
   "slug label fields drafts versions schedule preview access hooks scope admin httpCache"
 );
@@ -4867,6 +4867,264 @@ function groupOf(group, ids, fallback) {
   return { id: `label:${JSON.stringify(group)}`, label: group };
 }
 
+// src/search.ts
+var SEARCHABLE_TYPES = /* @__PURE__ */ new Set([
+  "text",
+  "textarea",
+  "email",
+  "slug",
+  "select",
+  "richText",
+  "array",
+  "group",
+  "blocks"
+]);
+function fieldAt(fields, path) {
+  const [name, ...rest] = path.split(".");
+  const field = fields.find((f) => f.name === name);
+  if (!field || rest.length === 0) return field;
+  return field.type === "group" ? fieldAt(field.fields, rest.join(".")) : void 0;
+}
+function textOf(field, value) {
+  if (value === null || value === void 0) return "";
+  switch (field.type) {
+    case "text":
+    case "textarea":
+    case "email":
+    case "slug":
+      return typeof value === "string" ? value : "";
+    case "select":
+      return [value].flat().filter((v) => typeof v === "string").join(" ");
+    case "richText":
+      return richText(value);
+    case "group":
+      return typeof value === "object" ? fieldsText(field.fields, value) : "";
+    case "array":
+    case "blocks":
+      if (!Array.isArray(value) || !hasRows(field)) return "";
+      return value.map((row) => {
+        const fields = rowFields(field, row);
+        return fields && row && typeof row === "object" ? fieldsText(fields, row) : "";
+      }).filter(Boolean).join("\n");
+    default:
+      return "";
+  }
+}
+function fieldsText(fields, data) {
+  return fields.filter((f) => SEARCHABLE_TYPES.has(f.type) && !f.hidden).map((f) => textOf(f, data[f.name])).filter(Boolean).join("\n");
+}
+function richText(node) {
+  if (!node || typeof node !== "object") return "";
+  const { text: text3, content } = node;
+  if (typeof text3 === "string") return text3;
+  if (!Array.isArray(content)) return "";
+  const inline = content.some((child) => typeof child?.text === "string");
+  return content.map(richText).filter(Boolean).join(inline ? "" : "\n");
+}
+function searchText(fields, doc, paths) {
+  const text3 = {};
+  for (const path of paths) {
+    const field = fieldAt(fields, path);
+    let value = doc;
+    for (const name of path.split("."))
+      value = value && typeof value === "object" ? value[name] : void 0;
+    text3[path] = field ? textOf(field, value) : "";
+  }
+  return text3;
+}
+var segmenter = new Intl.Segmenter(void 0, { granularity: "word" });
+function words(text3) {
+  return [...segmenter.segment(text3.normalize("NFC").toLowerCase())].filter((s) => s.isWordLike).map((s) => s.segment);
+}
+function memorySearch() {
+  const entries = /* @__PURE__ */ new Map();
+  const key = (collection2, id, locale) => JSON.stringify([collection2, id, locale]);
+  return {
+    name: "memory",
+    apiVersion: 1,
+    ephemeral: true,
+    async index(list) {
+      for (const e of list) {
+        const fields = Object.values(e.text).map(words);
+        entries.set(key(e.collection, e.id, e.locale), {
+          collection: e.collection,
+          id: e.id,
+          locale: e.locale,
+          fields,
+          joined: fields.map((list2) => list2.join(""))
+        });
+      }
+    },
+    async remove(documents) {
+      const gone = new Set(documents.map((d) => JSON.stringify([d.collection, d.id])));
+      for (const [k, e] of entries)
+        if (gone.has(JSON.stringify([e.collection, e.id]))) entries.delete(k);
+    },
+    async clear(collection2) {
+      for (const [k, e] of entries) if (e.collection === collection2) entries.delete(k);
+    },
+    async search(q) {
+      const terms = [...new Set(words(q.query))];
+      if (terms.length === 0) return { hits: [], total: 0 };
+      const collections = new Set(q.collections);
+      const scored = [];
+      for (const e of entries.values()) {
+        if (!collections.has(e.collection) || q.locale !== null && e.locale !== q.locale) continue;
+        let score = 0;
+        for (const term of terms) {
+          let best = 0;
+          e.fields.forEach((list, i) => {
+            const weight = e.fields.length - i;
+            for (const w of list)
+              if (w === term) best = Math.max(best, weight * 4);
+              else if (w.startsWith(term)) best = Math.max(best, weight * 2);
+            if (best === 0 && e.joined[i]?.includes(term)) best = weight;
+          });
+          if (best === 0) {
+            score = 0;
+            break;
+          }
+          score += best;
+        }
+        if (score > 0) scored.push({ e, score });
+      }
+      scored.sort((a, b) => b.score - a.score);
+      return {
+        hits: scored.slice(q.offset, q.offset + q.limit).map(({ e }) => ({ collection: e.collection, id: e.id })),
+        total: scored.length
+      };
+    },
+    describe: () => [
+      { key: "index", value: "memory" },
+      { key: "entries", value: String(entries.size) }
+    ]
+  };
+}
+var SearchIndex = class {
+  constructor(adapter, collections, locales, logger, read2, pages2) {
+    this.adapter = adapter;
+    this.collections = collections;
+    this.locales = locales;
+    this.logger = logger;
+    this.read = read2;
+    this.pages = pages2;
+  }
+  adapter;
+  collections;
+  locales;
+  logger;
+  read;
+  pages;
+  /** Indexing started by saves, which searches wait for. */
+  pending = /* @__PURE__ */ new Set();
+  /** The first build of an `ephemeral` index. */
+  building;
+  /** The collection's `search`, or `undefined` when it isn't searchable. */
+  configOf(collection2) {
+    const config = this.collections.find((c) => c.slug === collection2);
+    return config?.search ? config : void 0;
+  }
+  /** Slugs of the searchable collections. */
+  get searchable() {
+    return this.collections.filter((c) => c.search).map((c) => c.slug);
+  }
+  /** Builds an `ephemeral` index in the background; searches wait for it. */
+  start() {
+    if (!this.adapter.ephemeral || this.searchable.length === 0) return;
+    this.building = this.reindex().then(
+      () => void 0,
+      (error) => this.logger.error(`Search: building the index failed: ${error.message}`, {
+        error
+      })
+    );
+  }
+  /**
+   * Indexes a document as it now is, or removes it when it isn't published (or is gone). Reading
+   * it again, rather than taking what a save had, makes running it twice or late harmless.
+   */
+  async sync(collection2, id) {
+    const config = this.configOf(collection2);
+    if (!config) return;
+    const entries = [];
+    for (const locale of this.locales) {
+      const doc = await this.read(collection2, String(id), locale);
+      if (!doc) {
+        await this.adapter.remove([{ collection: collection2, id: String(id) }]);
+        return;
+      }
+      entries.push(this.entry(config, doc, locale));
+    }
+    await this.adapter.index(entries);
+  }
+  /** `sync` after a save, in the background: failures are logged. */
+  syncLater(collection2, id) {
+    const run = this.sync(collection2, id).catch(
+      (error) => this.logger.error(
+        `Search: indexing ${collection2} ${String(id)} failed: ${error.message}; run \`easy-cms search:reindex\` to repair the index`,
+        { error }
+      )
+    ).finally(() => this.pending.delete(run));
+    this.pending.add(run);
+  }
+  /** Waits for indexing started so far. */
+  async flush() {
+    await this.building;
+    while (this.pending.size > 0) await Promise.all(this.pending);
+  }
+  /** Builds the index again from the database: every collection, or one. */
+  async reindex(collection2) {
+    const slugs = collection2 === void 0 ? this.searchable : [collection2];
+    for (const slug2 of slugs)
+      if (!this.configOf(slug2))
+        throw new QueryError(`"${slug2}" is not searchable: it has no \`search\` in the config`);
+    await this.adapter.setup?.(
+      slugs.map((slug2) => ({ slug: slug2, fields: this.configOf(slug2)?.search.fields ?? [] }))
+    );
+    const done = [];
+    for (const slug2 of slugs) {
+      const config = this.configOf(slug2);
+      await this.adapter.clear(slug2);
+      const ids = /* @__PURE__ */ new Set();
+      for (const locale of this.locales)
+        for await (const docs of this.pages(slug2, locale)) {
+          for (const doc of docs) ids.add(String(doc.id));
+          await this.adapter.index(docs.map((doc) => this.entry(config, doc, locale)));
+        }
+      done.push({ collection: slug2, documents: ids.size });
+    }
+    return done;
+  }
+  /** Hits for a query, as documents the reader may read, best match first. */
+  async search(query, readHits) {
+    await this.flush();
+    const found = await this.adapter.search(query);
+    const byCollection = /* @__PURE__ */ new Map();
+    for (const hit of found.hits)
+      byCollection.set(hit.collection, [...byCollection.get(hit.collection) ?? [], hit.id]);
+    const docs = /* @__PURE__ */ new Map();
+    await Promise.all(
+      [...byCollection].map(async ([collection2, ids]) => {
+        for (const doc of await readHits(collection2, ids))
+          docs.set(JSON.stringify([collection2, String(doc.id)]), doc);
+      })
+    );
+    const hits = [];
+    for (const hit of found.hits) {
+      const doc = docs.get(JSON.stringify([hit.collection, hit.id]));
+      if (doc) hits.push({ collection: hit.collection, doc });
+    }
+    return { hits, total: found.total };
+  }
+  entry(config, doc, locale) {
+    return {
+      collection: config.slug,
+      id: String(doc.id),
+      locale,
+      text: searchText(config.fields, doc, config.search.fields)
+    };
+  }
+};
+
 // src/webhooks.ts
 import { createHmac as createHmac5, randomUUID as randomUUID2 } from "crypto";
 var WEBHOOK_EVENTS = [
@@ -5124,6 +5382,7 @@ function validateConfig(config) {
   validateLogs(config, add);
   validateCountCache(config, add);
   validateOutbox(config, add);
+  validateSearch(config, add);
   validateMaxPage(config, add);
   validateHttpCache(config, add);
   validateAuth(config, add);
@@ -5777,6 +6036,49 @@ function validateOutbox(config, add) {
   if (config.outbox !== void 0 && typeof config.outbox !== "boolean")
     add("outbox", "must be true or false");
 }
+function validateSearch(config, add) {
+  const adapter = config.search;
+  if (adapter !== void 0) {
+    const a = adapter;
+    if (typeof a !== "object" || a === null || !["index", "remove", "clear", "search"].every((m) => typeof a[m] === "function"))
+      add("search", "must be a search adapter", "e.g. search: memorySearch()");
+    for (const c of config.collections ?? [])
+      if (c?.slug === "search")
+        add(
+          "collections.search.slug",
+          '"search" is the search route when `search` is set',
+          "choose another slug"
+        );
+  }
+  for (const c of config.collections ?? []) {
+    const search = c?.search;
+    if (search === void 0) continue;
+    const path = `collections.${c.slug}.search`;
+    if (adapter === void 0) {
+      add(path, "needs a search adapter in the config", "e.g. search: memorySearch()");
+      continue;
+    }
+    const fields = search?.fields;
+    if (!Array.isArray(fields) || fields.length === 0) {
+      add(
+        `${path}.fields`,
+        "must list the fields to index",
+        "e.g. search: { fields: ['title', 'body'] }"
+      );
+      continue;
+    }
+    for (const name of fields) {
+      const field = typeof name === "string" ? fieldAt(c.fields ?? [], name) : void 0;
+      if (!field) add(`${path}.fields`, `has no field "${String(name)}"`);
+      else if (!SEARCHABLE_TYPES.has(field.type) || field.hidden)
+        add(
+          `${path}.fields`,
+          `can't index "${name}" (${field.hidden ? "hidden" : field.type})`,
+          "text, textarea, email, slug, select, rich text, array, group and blocks fields hold text"
+        );
+    }
+  }
+}
 function validateCountCache(config, add) {
   const seconds = config.countCacheSeconds;
   if (seconds !== void 0 && !(typeof seconds === "number" && Number.isFinite(seconds) && seconds >= 0))
@@ -6519,6 +6821,7 @@ function validateAdapterVersions(config, add) {
     ["upload.privateStorage", config.upload?.privateStorage],
     ["backups.storage", config.backups?.storage],
     ["email", config.email],
+    ["search", config.search],
     ...(config.auth?.providers ?? []).map(
       (p, i) => [`auth.providers[${i}]`, p]
     )
@@ -6738,6 +7041,11 @@ async function createEasyCMS(config, options = {}) {
     ]);
   }
   const cms = new EasyCMS(resolved3, db, logger, storage, cwd);
+  if (resolved3.search?.ephemeral && process.env.NODE_ENV === "production")
+    logger.warn(
+      `Search: the "${resolved3.search.name ?? "custom"}" index lives in this process's memory: it is built again at each start, and each instance has its own. Use a search engine adapter for large sites or several instances.`
+    );
+  if (options.scheduler !== false) cms.startSearch();
   const scheduling = [...resolved3.collections, ...resolved3.globals].some((c) => c.schedule) || (resolved3.webhooks?.length ?? 0) > 0 || resolved3.email !== void 0 || resolved3.jobs.length > 0 || resolved3.outbox === true;
   if (scheduling && options.scheduler !== false) cms.startScheduler();
   if (process.env.NODE_ENV === "production" && !resolved3.auth.setupCode && await cms.auth.hasUsers().catch(() => true) === false)
@@ -6780,6 +7088,8 @@ var EasyCMS = class {
   mailer;
   /** With `outbox: true`: runs after hooks and events from rows saves write. */
   outbox;
+  /** With `search`: keeps the index in step with published documents. */
+  searchIndex;
   /** @internal */
   constructor(config, db, logger = consoleLogger, storage = diskStorage({ dir: config.upload.dir }), cwd = process.cwd(), privateStorage) {
     this.config = config;
@@ -6808,6 +7118,18 @@ var EasyCMS = class {
       config.collections.some((c) => c.slug === EMAIL_DELIVERIES) ? this.emailQueue() : void 0
     );
     this.outbox = config.collections.some((c) => c.slug === OUTBOX) ? new Outbox(db, logger, (entry, done, mark) => this.runOutbox(entry, done, mark)) : void 0;
+    this.searchIndex = config.search ? new SearchIndex(
+      config.search,
+      config.collections,
+      config.localization ? config.localization.locales : [null],
+      logger,
+      (collection2, id, locale) => this.findById(collection2, id, {
+        draft: false,
+        depth: 0,
+        ...locale ? { locale } : {}
+      }),
+      (collection2, locale) => this.publishedPages(collection2, locale)
+    ) : void 0;
     this.auth = new Auth(this);
   }
   /**
@@ -8118,6 +8440,81 @@ var EasyCMS = class {
   flushOutbox() {
     return this.outbox?.flush() ?? Promise.resolve();
   }
+  /**
+   * Searches the collections that have `search` with the config's `search` adapter: published
+   * documents, best match first, read with the access options given (pass `overrideAccess: false`
+   * and `user` to apply access rules). `total` counts matches before access rules, so a page can
+   * hold fewer documents than `limit`.
+   */
+  async search(query, options = {}) {
+    const index = this.searchIndex;
+    if (!index) throw new QueryError("Search needs a `search` adapter in the config");
+    const limit = options.limit ?? 10;
+    const page = options.page ?? 1;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 100)
+      throw new QueryError("limit must be an integer from 1 to 100");
+    if (!Number.isInteger(page) || page < 1) throw new QueryError("page must be an integer from 1");
+    const collections = options.collections ?? index.searchable;
+    for (const slug2 of collections)
+      if (!index.configOf(slug2)) throw new QueryError(`"${slug2}" is not searchable`);
+    const localization = this.config.localization;
+    const asked = options.locale && options.locale !== ALL_LOCALES ? options.locale : void 0;
+    if (asked !== void 0 && localization && !localization.locales.includes(asked))
+      throw new QueryError(`Unknown locale "${asked}"`);
+    const locale = localization ? asked ?? localization.defaultLocale ?? null : null;
+    const text3 = query.trim().slice(0, 200);
+    const empty = { hits: [], total: 0, page, limit, hasNextPage: false };
+    if (!text3 || collections.length === 0) return empty;
+    const { collections: _, limit: __, page: ___, ...read2 } = options;
+    const { hits, total } = await index.search(
+      { query: text3, collections, locale, limit, offset: (page - 1) * limit },
+      async (collection2, ids) => (await this.find(collection2, {
+        ...read2,
+        ...locale ? { locale } : {},
+        where: { id: { in: ids.map((id) => parseId(id) ?? id) } },
+        limit: ids.length,
+        draft: false
+      })).docs
+    );
+    return { hits, total, page, limit, hasNextPage: page * limit < total };
+  }
+  /**
+   * Builds the search index again from the database, for every searchable collection or one:
+   * after adding `search` to a collection, changing its fields, or to repair the index
+   * (`easy-cms search:reindex`).
+   */
+  async reindexSearch(collection2) {
+    if (!this.searchIndex) throw new QueryError("Search needs a `search` adapter in the config");
+    return this.searchIndex.reindex(collection2);
+  }
+  /** @internal Builds an in-memory search index (`ephemeral`) when the CMS starts. */
+  startSearch() {
+    this.searchIndex?.start();
+  }
+  /** Published documents of a collection in a locale, a page at a time, for the search index. */
+  async *publishedPages(collection2, locale) {
+    const options = {
+      draft: false,
+      depth: 0,
+      limit: 100,
+      sort: "id",
+      ...locale ? { locale } : {}
+    };
+    if (this.db.findAfter) {
+      let cursor = "";
+      for (; ; ) {
+        const found = await this.find(collection2, { ...options, cursor });
+        yield found.docs;
+        if (!found.nextCursor) return;
+        cursor = found.nextCursor;
+      }
+    }
+    for (let page = 1; ; page++) {
+      const found = await this.find(collection2, { ...options, page, count: false });
+      yield found.docs;
+      if (!found.hasNextPage) return;
+    }
+  }
   /** @internal Puts a failed outbox entry back in line (Settings → Jobs). */
   retryOutbox(id) {
     return this.outbox?.retry(id) ?? Promise.resolve(false);
@@ -8126,6 +8523,7 @@ var EasyCMS = class {
     if (this.schedulerTimer) clearInterval(this.schedulerTimer);
     await this.running;
     await this.outbox?.flush();
+    await this.searchIndex?.flush();
     await this.webhooks.flush();
     await this.mailer.flush();
     await this.db.destroy();
@@ -8984,6 +9382,10 @@ var EasyCMS = class {
     if (config.drafts && doc.status !== "published" && before !== "published") return;
     return this.isGlobal(config) ? cacheTags.global(config.slug) : cacheTags.document(config.slug, doc.id);
   }
+  /** Whether a change may change what the search index holds: a save of the document itself. */
+  searches(config, event) {
+    return event !== "draft" && !this.isGlobal(config) && !!this.searchIndex?.configOf(config.slug);
+  }
   isGlobal(config) {
     return !this.config.collections.includes(config);
   }
@@ -9014,6 +9416,7 @@ var EasyCMS = class {
   emitChange(config, event, doc, before) {
     for (const change of this.changeEvents(config, event, doc, before))
       this.webhooks.emit(change.event, change.target, change.body);
+    if (this.searches(config, event)) this.searchIndex?.syncLater(config.slug, doc.id);
     const purge = this.config.httpCache?.purge;
     const tags = this.purgeTags(config, event, doc, before);
     if (!purge || !tags) return;
@@ -9030,7 +9433,7 @@ var EasyCMS = class {
     const hooks = event === "delete" ? config.hooks?.afterDelete : config.hooks?.afterChange;
     const isGlobal = this.isGlobal(config);
     const effects = (isGlobal || !INTERNAL_COLLECTIONS.has(config.slug)) && ((this.config.webhooks?.length ?? 0) > 0 || this.config.httpCache?.purge !== void 0);
-    if (!hooks?.length && !effects) return void 0;
+    if (!hooks?.length && !effects && !this.searches(config, event)) return void 0;
     return this.outbox.row({
       event,
       target: config.slug,
@@ -9066,6 +9469,10 @@ var EasyCMS = class {
         await this.webhooks.emitSaved(change.event, change.target, change.body);
       if (changes.length > 0 && (this.config.webhooks?.length ?? 0) > 0) await mark("webhooks");
     }
+    if (!done.has("search") && this.searchIndex && this.searches(config, event)) {
+      await this.searchIndex.sync(config.slug, parseId(entry.docId ?? void 0));
+      await mark("search");
+    }
     const purge = this.config.httpCache?.purge;
     const tags = this.purgeTags(config, event, doc, entry.before);
     if (purge && tags) await purge(tags);
@@ -10344,7 +10751,7 @@ async function readAdminModule(cms, index) {
 }
 
 // src/version.ts
-var VERSION = true ? "1.12.0" : "0.0.0-dev";
+var VERSION = true ? "1.13.0" : "0.0.0-dev";
 
 // src/rest/handler.ts
 import { randomUUID as randomUUID4 } from "crypto";
@@ -11010,9 +11417,17 @@ async function adminSearch(cms, who, q, perCollection = 5) {
       const conditions = [];
       if (title) conditions.push({ [title]: { like: query } });
       if (/^\d+$/.test(query)) conditions.push({ id: { equals: Number(query) } });
-      if (conditions.length === 0 || !await readable(cms, c, who)) return [];
+      const indexed = cms.config.search !== void 0 && c.search !== void 0;
+      if (conditions.length === 0 && !indexed || !await readable(cms, c, who)) return [];
       try {
-        const found = await cms.find(c.slug, {
+        const ranked = indexed ? (await cms.search(query, {
+          ...who,
+          overrideAccess: false,
+          depth: 0,
+          limit: perCollection,
+          collections: [c.slug]
+        })).hits.map((hit) => hit.doc) : [];
+        const found = conditions.length === 0 ? { docs: [] } : await cms.find(c.slug, {
           ...who,
           overrideAccess: false,
           draft: true,
@@ -11021,7 +11436,9 @@ async function adminSearch(cms, who, q, perCollection = 5) {
           where: conditions.length === 1 ? conditions[0] : { or: conditions },
           sort: "-updatedAt"
         });
-        return found.docs.map((doc) => {
+        const seen = /* @__PURE__ */ new Set();
+        const docs = [...ranked, ...found.docs].filter((doc) => !seen.has(doc.id) && seen.add(doc.id)).slice(0, perCollection);
+        return docs.map((doc) => {
           const d = doc;
           const value = title ? d[title] : void 0;
           return {
@@ -11110,6 +11527,7 @@ async function adminStatus(cms) {
       database: config.db.name,
       storage: config.upload.storage?.name ?? "local",
       email: config.email ? config.email.name ?? "custom" : null,
+      search: config.search ? config.search.name ?? "custom" : null,
       plugins: config.installedPlugins.map((p) => ({ ...p })),
       fieldTypes: config.fieldTypes.map((t) => t.name)
     },
@@ -11118,7 +11536,7 @@ async function adminStatus(cms) {
 }
 
 // src/rest/filter-options.ts
-function fieldAt(fields, path) {
+function fieldAt2(fields, path) {
   let current = fields;
   let found;
   for (const part of path.split(".")) {
@@ -11137,7 +11555,7 @@ async function pickerFilter(cms, url, target, user, context = {}) {
   const dot = spec.indexOf(".");
   const slug2 = dot > 0 ? spec.slice(0, dot) : "";
   const owner = forCollection !== null ? cms.config.collections.find((c) => c.slug === slug2) : cms.config.globals.find((g) => g.slug === slug2);
-  const field = owner ? fieldAt(owner.fields, spec.slice(dot + 1)) : void 0;
+  const field = owner ? fieldAt2(owner.fields, spec.slice(dot + 1)) : void 0;
   const to = field?.type === "upload" ? "media" : field?.type === "relationship" ? field.to : null;
   if (!field || field.type !== "relationship" && field.type !== "upload" || to !== target)
     throw new QueryError(`filterFor: no relationship to "${target}" at "${spec}"`);
@@ -12065,6 +12483,19 @@ async function route(cms, ctx, method, path, options) {
     );
     return { status: 201, body: { ...doc, key } };
   }
+  if (first === "search" && second === void 0 && cms.config.search) {
+    if (method !== "GET") throw methodNotAllowed(ctx, "GET");
+    const q = ctx.url.searchParams;
+    const collections = q.get("collections");
+    return {
+      body: await cms.search(q.get("q") ?? "", {
+        ...access,
+        ...parseDepth(ctx.url),
+        ...pageQuery(q, 10),
+        ...collections ? { collections: collections.split(",").filter(Boolean) } : {}
+      })
+    };
+  }
   const collection2 = first;
   if (INTERNAL_COLLECTIONS.has(collection2) || !cms.config.collections.some((c) => c.slug === collection2)) {
     throw new HttpError(`Unknown collection "${collection2}"`, 404);
@@ -12784,6 +13215,7 @@ export {
   Roles,
   checkRenamedOptions,
   BUILTIN_NAV,
+  memorySearch,
   WEBHOOK_EVENTS,
   MIN_SECRET_LENGTH,
   BUILTIN_COLLECTIONS,

package/dist/{config-CHEEPk1d.d.ts → config-B-bT0hIn.d.ts}

@@ -1748,13 +1748,34 @@ interface FindOptions extends ReadOptions {
      */
     readonly cursor?: string;
 }
+interface SearchOptions extends DepthOptions {
+    /** Searchable collections to look in. Default: every collection with `search`. */
+    readonly collections?: readonly string[];
+    /** Default 10, at most 100. */
+    readonly limit?: number;
+    /** 1-based. Default 1. */
+    readonly page?: number;
+}
+/** What `cms.search()` finds: documents, best match first. */
+interface SearchResults {
+    readonly hits: readonly {
+        readonly collection: string;
+        readonly doc: Record<string, unknown>;
+    }[];
+    /** Matches before access rules: a page can hold fewer than `limit`. */
+    readonly total: number;
+    readonly page: number;
+    readonly limit: number;
+    readonly hasNextPage: boolean;
+}
 interface CreateEasyCMSOptions {
     /** Project root. Default `process.cwd()`. */
     readonly cwd?: string;
     /**
      * Run due scheduled jobs and webhook retries every minute in this process. Default: on when
      * a collection or global has `schedule`, or `webhooks`, `email` or `jobs` is set. Turn it off
-     * where a cron calls `runJobs` (or `GET <api>/jobs/run`) instead.
+     * where a cron calls `runJobs` (or `GET <api>/jobs/run`) instead. Off, an in-memory `search`
+     * index (`memorySearch()`) isn't built at start either: call `reindexSearch()`.
      */
     readonly scheduler?: boolean;
     /** Default `verify` when `NODE_ENV=production`, otherwise `push`. */
@@ -1801,6 +1822,8 @@ declare class EasyCMS<C extends Config = Config> {
     private readonly mailer;
     /** With `outbox: true`: runs after hooks and events from rows saves write. */
     private readonly outbox;
+    /** With `search`: keeps the index in step with published documents. */
+    private readonly searchIndex;
     /**
      * The user and context of a request, as the REST API works them out: its session cookie or
      * Bearer token, then `onRequest`. For framework routes and server code that act for a visitor;
@@ -2066,6 +2089,24 @@ declare class EasyCMS<C extends Config = Config> {
      * function returns. What fails stays queued for its retry.
      */
     flushOutbox(): Promise<void>;
+    /**
+     * Searches the collections that have `search` with the config's `search` adapter: published
+     * documents, best match first, read with the access options given (pass `overrideAccess: false`
+     * and `user` to apply access rules). `total` counts matches before access rules, so a page can
+     * hold fewer documents than `limit`.
+     */
+    search(query: string, options?: SearchOptions): Promise<SearchResults>;
+    /**
+     * Builds the search index again from the database, for every searchable collection or one:
+     * after adding `search` to a collection, changing its fields, or to repair the index
+     * (`easy-cms search:reindex`).
+     */
+    reindexSearch(collection?: string): Promise<{
+        collection: string;
+        documents: number;
+    }[]>;
+    /** Published documents of a collection in a locale, a page at a time, for the search index. */
+    private publishedPages;
     destroy(): Promise<void>;
     private schedulerTimer;
     private running;
@@ -2221,6 +2262,8 @@ declare class EasyCMS<C extends Config = Config> {
      * drafts; with drafts, a published document saved, published, unpublished or deleted).
      */
     private purgeTags;
+    /** Whether a change may change what the search index holds: a save of the document itself. */
+    private searches;
     private isGlobal;
     /** The webhook events of a change; `before` is the stored status before it, if any. */
     private changeEvents;
@@ -2602,6 +2645,93 @@ interface FieldTypeDefinition {
 /** Declares a field type; returns it unchanged. */
 declare function defineFieldType(definition: FieldTypeDefinition): FieldTypeDefinition;
 
+/** One document in one locale, as a search engine indexes it: plain text per field. */
+interface SearchEntry {
+    readonly collection: string;
+    readonly id: string;
+    /** `null` without `localization`. */
+    readonly locale: string | null;
+    /** The collection's `search.fields`, in their order (most important first), as plain text. */
+    readonly text: Readonly<Record<string, string>>;
+}
+interface SearchQuery {
+    /** What the person typed. */
+    readonly query: string;
+    /** Searchable collections to look in; never empty. */
+    readonly collections: readonly string[];
+    /** The locale to search; `null` without `localization`. */
+    readonly locale: string | null;
+    readonly limit: number;
+    readonly offset: number;
+}
+interface SearchHits {
+    /** Best match first. */
+    readonly hits: readonly {
+        readonly collection: string;
+        readonly id: string;
+    }[];
+    /** Matches in all, for paging. */
+    readonly total: number;
+}
+/** One setting a search adapter shows to admins (`describe()`). */
+interface SearchSetting {
+    readonly key: string;
+    /** `null`: not set. */
+    readonly value: string | null;
+}
+/**
+ * Indexes published documents for relevance-ranked full-text search (`search` in the config):
+ * `memorySearch()`, or an adapter for a search engine. Easy CMS turns documents into plain text,
+ * calls `index` and `remove` as they change, and reads the hits back with the user's access.
+ */
+interface SearchAdapter {
+    /** E.g. `memory`; shown to admins on the dashboard (System). */
+    readonly name?: string;
+    /**
+     * The adapter interface it is written for (`ADAPTER_API_VERSION`); Easy CMS refuses another.
+     * Leave it out to skip the check.
+     */
+    readonly apiVersion?: number;
+    /**
+     * The index starts empty in each process (it lives in memory): Easy CMS builds it when it
+     * starts, and searches wait until it is built.
+     */
+    readonly ephemeral?: boolean;
+    /** Creates or updates the indexes for these collections; runs before a reindex. */
+    setup?(collections: readonly {
+        slug: string;
+        fields: readonly string[];
+    }[]): Promise<void>;
+    /** Adds or replaces entries (same collection, id and locale). */
+    index(entries: readonly SearchEntry[]): Promise<void>;
+    /** Removes documents, in every locale. */
+    remove(documents: readonly {
+        collection: string;
+        id: string;
+    }[]): Promise<void>;
+    /** Removes every document of a collection, before a reindex. */
+    clear(collection: string): Promise<void>;
+    search(query: SearchQuery): Promise<SearchHits>;
+    /** The settings in use, for admins. Never return secrets. */
+    describe?(): readonly SearchSetting[];
+}
+/** What `search` of a collection says: the fields to index, most important first. */
+interface CollectionSearch {
+    /**
+     * Field names, or paths through groups such as `seo.description`: text, textarea, email, slug,
+     * select and rich text fields, or arrays, groups and blocks (all the text inside them).
+     */
+    readonly fields: readonly string[];
+}
+/**
+ * A search index in memory, for development, tests and small sites with one process: built when
+ * the server starts, and lost when it stops. Words are split with `Intl.Segmenter`, so Thai text
+ * is found by its words. Every word searched must be in the document, at the start of one of its
+ * words or across words; documents whose first fields (`search.fields`) match, and match whole
+ * words, rank first.
+ */
+declare function memorySearch(): SearchAdapter;
+
 declare const WEBHOOK_EVENTS: readonly ["create", "update", "delete", "publish", "unpublish", "draft"];
 /**
  * `create`, `update`, `delete`: the stored document changed. `publish` / `unpublish`: its status
@@ -2842,6 +2972,11 @@ interface CollectionConfig {
      * Overrides the config's `httpCache` for this one; `false` keeps every read `no-store`.
      */
     readonly httpCache?: false | HttpCacheTimes;
+    /**
+     * Relevance-ranked search of this collection's published documents with the config's `search`
+     * adapter: `cms.search()` and `GET <api>/search`. The fields to index, most important first.
+     */
+    readonly search?: CollectionSearch;
     /** Live preview: the page that shows a document, e.g. `({ doc }) => \`/posts/${doc.slug}\``. */
     readonly preview?: PreviewURL;
     readonly access?: CollectionAccess;
@@ -3474,6 +3609,13 @@ interface Config {
      * Default `false`: hooks run in the request, after the save.
      */
     readonly outbox?: boolean;
+    /**
+     * Relevance-ranked search of the collections that have `search`, e.g. `memorySearch()` for
+     * development and small sites, or an adapter for a search engine. Published documents are
+     * indexed as they change; `easy-cms search:reindex` builds the index again. Without it, `like`
+     * (with `index: 'trigram'` on Postgres) still finds text.
+     */
+    readonly search?: SearchAdapter;
     readonly plugins?: readonly Plugin[];
 }
 /** The config after plugins ran, validation passed and defaults were applied. */
@@ -3505,5 +3647,5 @@ interface ResolvedConfig extends Omit<Config, 'cors' | 'localization' | 'routes'
  */
 declare function defineConfig<const TConfig extends Config>(config: TConfig): TConfig;
 
-export { ADAPTER_API_VERSION as A, AuditLog as J, Auth as M, ADMIN_ICONS as a, FIELD_TYPES as aD, ForbiddenError as a_, ConfigError as ac, EasyCMS as av, EasyCMSError as aw, PayloadTooLargeError as bD, QueryError as bJ, ROLE_OPERATIONS as bK, Roles as bV, SchemaError as bY, NotFoundError as bs, PLUGIN_API_VERSION as by, keyAllows as c$, SingleSignOn as c4, createEasyCMS as cA, defineConfig as cB, defineFieldType as cC, definePlugin as cD, diskStorage as cE, hasRows as cF, isAdmin as cG, isHasMany as cH, isSignedIn as cI, isStaff as cJ, isSystemAdmin as cK, jsonLogger as cL, mimeAllowedBy as cM, rowFields as cN, silentLogger as cO, uniqueWithinOf as cP, API_KEYS as cQ, API_KEY_GLOBAL_OPERATIONS as cR, API_KEY_OPERATIONS as cS, DEFAULT_MAX_VERSIONS as cT, DEFAULT_PASSWORD_EMAILS as cU, FIELD_TYPE_BASES as cV, FOLDER_LEVELS as cW, MediaFolders as cX, SSO_COOKIE as cY, codeOfStatus as cZ, isJsonLogger as c_, TooManyRequestsError as cd, UnauthorizedError as cf, ValidationError as cn, WEBHOOK_EVENTS as cr, anyone as cx, consoleEmail as cy, consoleLogger as cz, logFormat as d0 };
-export type { BuiltinMediaCollection as $, ApiKeyOperation as B, ApiKeyPermissions as C, ArrayField as D, EmailSetting as E, AuditChange as F, AuditConfig as G, AuditEntry as H, ID as I, AuditPage as K, AuditVerification as L, AuthConfig as N, AuthProvider as O, PaginatedDocs as P, AuthProviderProfile as Q, AuthProviderRequest as R, AuthUser as S, BackupsConfig as T, BeforeChangeHook as U, BeforeDeleteHook as V, BeforeValidateHook as W, Block as X, BlocksField as Y, BooleanField as Z, BuiltinApiKeysCollection as _, GlobalAccess as a$, BuiltinMediaFoldersCollection as a0, BuiltinUsersCollection as a1, BundleHints as a2, CliCommand as a3, CollectionAccess as a4, CollectionAdmin as a5, CollectionConfig as a6, CollectionDocument as a7, CollectionHooks as a8, CollectionListAdmin as a9, Endpoint as aA, EndpointRequest as aB, ErrorCode as aC, Field as aE, FieldAccess as aF, FieldAccessFn as aG, FieldAdmin as aH, FieldError as aI, FieldRule as aJ, FieldType as aK, FieldTypeBase as aL, FieldTypeDefinition as aM, FieldTypeValidateContext as aN, FieldValidate as aO, FieldValidateContext as aP, FieldValue as aQ, FieldsInput as aR, FieldsValue as aS, FilterOptions as aT, FilterOptionsArgs as aU, FindAfterArgs as aV, FindArgs as aW, FindOptions as aX, FolderLevel as aY, FolderPermissions as aZ, CollectionSlug as aa, Config as ab, ConfigIssue as ad, ContainerAdmin as ae, CreateEasyCMSOptions as af, CreateInput as ag, CreateMigrationResult as ah, CursorDocs as ai, CustomField as aj, CustomFieldTypes as ak, DashboardWidget as al, Database as am, DatabaseAdapter as an, DatabaseInitArgs as ao, DatabaseTransfer as ap, DateField as aq, DepthOptions as ar, DirectUpload as as, DiskStorageOptions as at, DocumentOf as au, EmailAdapter as ax, EmailField as ay, EmailMessage as az, Access as b, SelectOption as b$, GlobalConfig as b0, GlobalDocument as b1, GlobalHooks as b2, GlobalInput as b3, GlobalSlug as b4, GroupField as b5, ImageSize as b6, IncrementOptions as b7, InferCollection as b8, InferGlobal as b9, PasswordEmailArgs as bA, PasswordEmailFn as bB, PasswordLinkOptions as bC, Plugin as bE, PluginInfo as bF, PluginTypes as bG, PreviewTarget as bH, PreviewURL as bI, RawDocument as bL, ReadOptions as bM, RelationshipField as bN, RequestContext as bO, ResolvedConfig as bP, RichTextDocument as bQ, RichTextField as bR, Role as bS, RoleOperation as bT, RolePermissions as bU, RoutesConfig as bW, ScheduledPublish as bX, SchemaMode as bZ, SelectField as b_, JobConfig as ba, JsonField as bb, KeysetPage as bc, Label as bd, LayoutNode as be, LivePreview as bf, LocaleOf as bg, LocalizationConfig as bh, LogDetails as bi, Logger as bj, LoginArgs as bk, LogsConfig as bl, MediaDocument as bm, MediaSize as bn, MembersConfig as bo, MembersSignup as bp, MigrationInfo as bq, NavGroup as br, NumberField as bt, OnRequest as bu, OnRequestArgs as bv, Operation as bw, OutboxRow as bx, PasswordEmail as bz, AccessArgs as c, Session as c0, SidebarPanel as c1, SignupArgs as c2, SignupResult as c3, SlugField as c5, SlugOf as c6, SsoOutcome as c7, SsoProviderRef as c8, StorageAdapter as c9, StoredFile as ca, TextField as cb, TextareaField as cc, TypedPlugin as ce, UncountedDocs as cg, UpdateInput as ch, UpdateOptions as ci, UploadConfig as cj, UploadField as ck, UploadFromURLConfig as cl, UserIdentity as cm, Version as co, VersionSummary as cp, VersionsConfig as cq, WebhookConfig as cs, WebhookEvent as ct, WebhookPayload as cu, Where as cv, WhereOperators as cw, AccessOptions as d, AdminBrand as e, AdminCommand as f, AdminComponent as g, AdminConfig as h, AdminFieldArgs as i, AdminIcon as j, AdminLocale as k, AdminPage as l, AdminRole as m, AdminRoleChange as n, AdminRoleField as o, AdminRoleTarget as p, AdminRoleView as q, AdminRoles as r, AdminSso as s, AdminSwitcher as t, AdminViewAccess as u, AfterChangeHook as v, AfterDeleteHook as w, AfterReadHook as x, ApiKeyContext as y, ApiKeyGlobalOperation as z };
+export { ADAPTER_API_VERSION as A, AuditLog as J, Auth as M, ADMIN_ICONS as a, ForbiddenError as a$, FIELD_TYPES as aE, ConfigError as ad, EasyCMS as aw, EasyCMSError as ax, PayloadTooLargeError as bE, QueryError as bK, ROLE_OPERATIONS as bL, Roles as bW, SchemaError as bZ, NotFoundError as bt, PLUGIN_API_VERSION as bz, API_KEY_OPERATIONS as c$, anyone as cF, consoleEmail as cG, consoleLogger as cH, createEasyCMS as cI, defineConfig as cJ, defineFieldType as cK, definePlugin as cL, diskStorage as cM, hasRows as cN, isAdmin as cO, isHasMany as cP, isSignedIn as cQ, isStaff as cR, isSystemAdmin as cS, jsonLogger as cT, memorySearch as cU, mimeAllowedBy as cV, rowFields as cW, silentLogger as cX, uniqueWithinOf as cY, API_KEYS as cZ, API_KEY_GLOBAL_OPERATIONS as c_, SingleSignOn as cc, TooManyRequestsError as cl, UnauthorizedError as cn, ValidationError as cv, WEBHOOK_EVENTS as cz, DEFAULT_MAX_VERSIONS as d0, DEFAULT_PASSWORD_EMAILS as d1, FIELD_TYPE_BASES as d2, FOLDER_LEVELS as d3, MediaFolders as d4, SSO_COOKIE as d5, codeOfStatus as d6, isJsonLogger as d7, keyAllows as d8, logFormat as d9 };
+export type { BuiltinMediaCollection as $, ApiKeyOperation as B, ApiKeyPermissions as C, ArrayField as D, EmailSetting as E, AuditChange as F, AuditConfig as G, AuditEntry as H, ID as I, AuditPage as K, AuditVerification as L, AuthConfig as N, AuthProvider as O, PaginatedDocs as P, AuthProviderProfile as Q, AuthProviderRequest as R, AuthUser as S, BackupsConfig as T, BeforeChangeHook as U, BeforeDeleteHook as V, BeforeValidateHook as W, Block as X, BlocksField as Y, BooleanField as Z, BuiltinApiKeysCollection as _, BuiltinMediaFoldersCollection as a0, BuiltinUsersCollection as a1, BundleHints as a2, CliCommand as a3, CollectionAccess as a4, CollectionAdmin as a5, CollectionConfig as a6, CollectionDocument as a7, CollectionHooks as a8, CollectionListAdmin as a9, EmailMessage as aA, Endpoint as aB, EndpointRequest as aC, ErrorCode as aD, Field as aF, FieldAccess as aG, FieldAccessFn as aH, FieldAdmin as aI, FieldError as aJ, FieldRule as aK, FieldType as aL, FieldTypeBase as aM, FieldTypeDefinition as aN, FieldTypeValidateContext as aO, FieldValidate as aP, FieldValidateContext as aQ, FieldValue as aR, FieldsInput as aS, FieldsValue as aT, FilterOptions as aU, FilterOptionsArgs as aV, FindAfterArgs as aW, FindArgs as aX, FindOptions as aY, FolderLevel as aZ, FolderPermissions as a_, CollectionSearch as aa, CollectionSlug as ab, Config as ac, ConfigIssue as ae, ContainerAdmin as af, CreateEasyCMSOptions as ag, CreateInput as ah, CreateMigrationResult as ai, CursorDocs as aj, CustomField as ak, CustomFieldTypes as al, DashboardWidget as am, Database as an, DatabaseAdapter as ao, DatabaseInitArgs as ap, DatabaseTransfer as aq, DateField as ar, DepthOptions as as, DirectUpload as at, DiskStorageOptions as au, DocumentOf as av, EmailAdapter as ay, EmailField as az, Access as b, SearchAdapter as b$, GlobalAccess as b0, GlobalConfig as b1, GlobalDocument as b2, GlobalHooks as b3, GlobalInput as b4, GlobalSlug as b5, GroupField as b6, ImageSize as b7, IncrementOptions as b8, InferCollection as b9, PasswordEmail as bA, PasswordEmailArgs as bB, PasswordEmailFn as bC, PasswordLinkOptions as bD, Plugin as bF, PluginInfo as bG, PluginTypes as bH, PreviewTarget as bI, PreviewURL as bJ, RawDocument as bM, ReadOptions as bN, RelationshipField as bO, RequestContext as bP, ResolvedConfig as bQ, RichTextDocument as bR, RichTextField as bS, Role as bT, RoleOperation as bU, RolePermissions as bV, RoutesConfig as bX, ScheduledPublish as bY, SchemaMode as b_, InferGlobal as ba, JobConfig as bb, JsonField as bc, KeysetPage as bd, Label as be, LayoutNode as bf, LivePreview as bg, LocaleOf as bh, LocalizationConfig as bi, LogDetails as bj, Logger as bk, LoginArgs as bl, LogsConfig as bm, MediaDocument as bn, MediaSize as bo, MembersConfig as bp, MembersSignup as bq, MigrationInfo as br, NavGroup as bs, NumberField as bu, OnRequest as bv, OnRequestArgs as bw, Operation as bx, OutboxRow as by, AccessArgs as c, SearchEntry as c0, SearchHits as c1, SearchOptions as c2, SearchQuery as c3, SearchResults as c4, SearchSetting as c5, SelectField as c6, SelectOption as c7, Session as c8, SidebarPanel as c9, WebhookConfig as cA, WebhookEvent as cB, WebhookPayload as cC, Where as cD, WhereOperators as cE, SignupArgs as ca, SignupResult as cb, SlugField as cd, SlugOf as ce, SsoOutcome as cf, SsoProviderRef as cg, StorageAdapter as ch, StoredFile as ci, TextField as cj, TextareaField as ck, TypedPlugin as cm, UncountedDocs as co, UpdateInput as cp, UpdateOptions as cq, UploadConfig as cr, UploadField as cs, UploadFromURLConfig as ct, UserIdentity as cu, Version as cw, VersionSummary as cx, VersionsConfig as cy, AccessOptions as d, AdminBrand as e, AdminCommand as f, AdminComponent as g, AdminConfig as h, AdminFieldArgs as i, AdminIcon as j, AdminLocale as k, AdminPage as l, AdminRole as m, AdminRoleChange as n, AdminRoleField as o, AdminRoleTarget as p, AdminRoleView as q, AdminRoles as r, AdminSso as s, AdminSwitcher as t, AdminViewAccess as u, AfterChangeHook as v, AfterDeleteHook as w, AfterReadHook as x, ApiKeyContext as y, ApiKeyGlobalOperation as z };

package/dist/{handler-adKUq8-U.d.ts → handler-COsNEVx0.d.ts}

@@ -1,4 +1,4 @@
-import { I as ID, ab as Config, av as EasyCMS, bh as LocalizationConfig, aE as Field, aI as FieldError, aT as FilterOptions, af as CreateEasyCMSOptions, bP as ResolvedConfig } from './config-CHEEPk1d.js';
+import { I as ID, ac as Config, aw as EasyCMS, bi as LocalizationConfig, aF as Field, aJ as FieldError, aU as FilterOptions, ag as CreateEasyCMSOptions, bQ as ResolvedConfig } from './config-B-bT0hIn.js';
 
 /** Decrypts a file from `encryptBackup`; throws for another key or a changed file. */
 declare function decryptBackup(data: Uint8Array, encryptionKey: string): Uint8Array;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-import { P as PaginatedDocs, I as ID, E as EmailSetting } from './config-CHEEPk1d.js';
-export { A as ADAPTER_API_VERSION, a as ADMIN_ICONS, b as Access, c as AccessArgs, d as AccessOptions, e as AdminBrand, f as AdminCommand, g as AdminComponent, h as AdminConfig, i as AdminFieldArgs, j as AdminIcon, k as AdminLocale, l as AdminPage, m as AdminRole, n as AdminRoleChange, o as AdminRoleField, p as AdminRoleTarget, q as AdminRoleView, r as AdminRoles, s as AdminSso, t as AdminSwitcher, u as AdminViewAccess, v as AfterChangeHook, w as AfterDeleteHook, x as AfterReadHook, y as ApiKeyContext, z as ApiKeyGlobalOperation, B as ApiKeyOperation, C as ApiKeyPermissions, D as ArrayField, F as AuditChange, G as AuditConfig, H as AuditEntry, J as AuditLog, K as AuditPage, L as AuditVerification, M as Auth, N as AuthConfig, O as AuthProvider, Q as AuthProviderProfile, R as AuthProviderRequest, S as AuthUser, T as BackupsConfig, U as BeforeChangeHook, V as BeforeDeleteHook, W as BeforeValidateHook, X as Block, Y as BlocksField, Z as BooleanField, _ as BuiltinApiKeysCollection, $ as BuiltinMediaCollection, a0 as BuiltinMediaFoldersCollection, a1 as BuiltinUsersCollection, a2 as BundleHints, a3 as CliCommand, a4 as CollectionAccess, a5 as CollectionAdmin, a6 as CollectionConfig, a7 as CollectionDocument, a8 as CollectionHooks, a9 as CollectionListAdmin, aa as CollectionSlug, ab as Config, ac as ConfigError, ad as ConfigIssue, ae as ContainerAdmin, af as CreateEasyCMSOptions, ag as CreateInput, ah as CreateMigrationResult, ai as CursorDocs, aj as CustomField, ak as CustomFieldTypes, al as DashboardWidget, am as Database, an as DatabaseAdapter, ao as DatabaseInitArgs, ap as DatabaseTransfer, aq as DateField, ar as DepthOptions, as as DirectUpload, at as DiskStorageOptions, au as DocumentOf, av as EasyCMS, aw as EasyCMSError, ax as EmailAdapter, ay as EmailField, az as EmailMessage, aA as Endpoint, aB as EndpointRequest, aC as ErrorCode, aD as FIELD_TYPES, aE as Field, aF as FieldAccess, aG as FieldAccessFn, aH as FieldAdmin, aI as FieldError, aJ as FieldRule, aK as FieldType, aL as FieldTypeBase, aM as FieldTypeDefinition, aN as FieldTypeValidateContext, aO as FieldValidate, aP as FieldValidateContext, aQ as FieldValue, aR as FieldsInput, aS as FieldsValue, aT as FilterOptions, aU as FilterOptionsArgs, aV as FindAfterArgs, aW as FindArgs, aX as FindOptions, aY as FolderLevel, aZ as FolderPermissions, a_ as ForbiddenError, a$ as GlobalAccess, b0 as GlobalConfig, b1 as GlobalDocument, b2 as GlobalHooks, b3 as GlobalInput, b4 as GlobalSlug, b5 as GroupField, b6 as ImageSize, b7 as IncrementOptions, b8 as InferCollection, b9 as InferGlobal, ba as JobConfig, bb as JsonField, bc as KeysetPage, bd as Label, be as LayoutNode, bf as LivePreview, bg as LocaleOf, bh as LocalizationConfig, bi as LogDetails, bj as Logger, bk as LoginArgs, bl as LogsConfig, bm as MediaDocument, bn as MediaSize, bo as MembersConfig, bp as MembersSignup, bq as MigrationInfo, br as NavGroup, bs as NotFoundError, bt as NumberField, bu as OnRequest, bv as OnRequestArgs, bw as Operation, bx as OutboxRow, by as PLUGIN_API_VERSION, bz as PasswordEmail, bA as PasswordEmailArgs, bB as PasswordEmailFn, bC as PasswordLinkOptions, bD as PayloadTooLargeError, bE as Plugin, bF as PluginInfo, bG as PluginTypes, bH as PreviewTarget, bI as PreviewURL, bJ as QueryError, bK as ROLE_OPERATIONS, bL as RawDocument, bM as ReadOptions, bN as RelationshipField, bO as RequestContext, bP as ResolvedConfig, bQ as RichTextDocument, bR as RichTextField, bS as Role, bT as RoleOperation, bU as RolePermissions, bV as Roles, bW as RoutesConfig, bX as ScheduledPublish, bY as SchemaError, bZ as SchemaMode, b_ as SelectField, b$ as SelectOption, c0 as Session, c1 as SidebarPanel, c2 as SignupArgs, c3 as SignupResult, c4 as SingleSignOn, c5 as SlugField, c6 as SlugOf, c7 as SsoOutcome, c8 as SsoProviderRef, c9 as StorageAdapter, ca as StoredFile, cb as TextField, cc as TextareaField, cd as TooManyRequestsError, ce as TypedPlugin, cf as UnauthorizedError, cg as UncountedDocs, ch as UpdateInput, ci as UpdateOptions, cj as UploadConfig, ck as UploadField, cl as UploadFromURLConfig, cm as UserIdentity, cn as ValidationError, co as Version, cp as VersionSummary, cq as VersionsConfig, cr as WEBHOOK_EVENTS, cs as WebhookConfig, ct as WebhookEvent, cu as WebhookPayload, cv as Where, cw as WhereOperators, cx as anyone, cy as consoleEmail, cz as consoleLogger, cA as createEasyCMS, cB as defineConfig, cC as defineFieldType, cD as definePlugin, cE as diskStorage, cF as hasRows, cG as isAdmin, cH as isHasMany, cI as isSignedIn, cJ as isStaff, cK as isSystemAdmin, cL as jsonLogger, cM as mimeAllowedBy, cN as rowFields, cO as silentLogger, cP as uniqueWithinOf } from './config-CHEEPk1d.js';
-export { A as ADMIN_API_VERSION, a as AdminCollection, b as AdminComponentRef, c as AdminElementProps, d as AdminField, e as AdminGlobal, f as AdminLayoutNode, g as AdminNavGroup, h as AdminNavItem, i as AdminNavNode, j as AdminPageRef, k as AdminPageRoute, l as AdminSchema, m as AdminWidgetRef, S as SetFieldDetail, w as warnDeprecated } from './plugin-B8xypoWd.js';
-export { A as AdminBackup, a as AdminBackups, b as ApiHandlerOptions, B as BackupState, L as LoadConfigOptions, R as RestHandler, c as RestHandlerOptions, d as createApiHandler, e as createRestHandler, l as loadConfig, r as resolveConfig, s as sharedEasyCMS, f as slugify } from './handler-adKUq8-U.js';
+import { P as PaginatedDocs, I as ID, E as EmailSetting } from './config-B-bT0hIn.js';
+export { A as ADAPTER_API_VERSION, a as ADMIN_ICONS, b as Access, c as AccessArgs, d as AccessOptions, e as AdminBrand, f as AdminCommand, g as AdminComponent, h as AdminConfig, i as AdminFieldArgs, j as AdminIcon, k as AdminLocale, l as AdminPage, m as AdminRole, n as AdminRoleChange, o as AdminRoleField, p as AdminRoleTarget, q as AdminRoleView, r as AdminRoles, s as AdminSso, t as AdminSwitcher, u as AdminViewAccess, v as AfterChangeHook, w as AfterDeleteHook, x as AfterReadHook, y as ApiKeyContext, z as ApiKeyGlobalOperation, B as ApiKeyOperation, C as ApiKeyPermissions, D as ArrayField, F as AuditChange, G as AuditConfig, H as AuditEntry, J as AuditLog, K as AuditPage, L as AuditVerification, M as Auth, N as AuthConfig, O as AuthProvider, Q as AuthProviderProfile, R as AuthProviderRequest, S as AuthUser, T as BackupsConfig, U as BeforeChangeHook, V as BeforeDeleteHook, W as BeforeValidateHook, X as Block, Y as BlocksField, Z as BooleanField, _ as BuiltinApiKeysCollection, $ as BuiltinMediaCollection, a0 as BuiltinMediaFoldersCollection, a1 as BuiltinUsersCollection, a2 as BundleHints, a3 as CliCommand, a4 as CollectionAccess, a5 as CollectionAdmin, a6 as CollectionConfig, a7 as CollectionDocument, a8 as CollectionHooks, a9 as CollectionListAdmin, aa as CollectionSearch, ab as CollectionSlug, ac as Config, ad as ConfigError, ae as ConfigIssue, af as ContainerAdmin, ag as CreateEasyCMSOptions, ah as CreateInput, ai as CreateMigrationResult, aj as CursorDocs, ak as CustomField, al as CustomFieldTypes, am as DashboardWidget, an as Database, ao as DatabaseAdapter, ap as DatabaseInitArgs, aq as DatabaseTransfer, ar as DateField, as as DepthOptions, at as DirectUpload, au as DiskStorageOptions, av as DocumentOf, aw as EasyCMS, ax as EasyCMSError, ay as EmailAdapter, az as EmailField, aA as EmailMessage, aB as Endpoint, aC as EndpointRequest, aD as ErrorCode, aE as FIELD_TYPES, aF as Field, aG as FieldAccess, aH as FieldAccessFn, aI as FieldAdmin, aJ as FieldError, aK as FieldRule, aL as FieldType, aM as FieldTypeBase, aN as FieldTypeDefinition, aO as FieldTypeValidateContext, aP as FieldValidate, aQ as FieldValidateContext, aR as FieldValue, aS as FieldsInput, aT as FieldsValue, aU as FilterOptions, aV as FilterOptionsArgs, aW as FindAfterArgs, aX as FindArgs, aY as FindOptions, aZ as FolderLevel, a_ as FolderPermissions, a$ as ForbiddenError, b0 as GlobalAccess, b1 as GlobalConfig, b2 as GlobalDocument, b3 as GlobalHooks, b4 as GlobalInput, b5 as GlobalSlug, b6 as GroupField, b7 as ImageSize, b8 as IncrementOptions, b9 as InferCollection, ba as InferGlobal, bb as JobConfig, bc as JsonField, bd as KeysetPage, be as Label, bf as LayoutNode, bg as LivePreview, bh as LocaleOf, bi as LocalizationConfig, bj as LogDetails, bk as Logger, bl as LoginArgs, bm as LogsConfig, bn as MediaDocument, bo as MediaSize, bp as MembersConfig, bq as MembersSignup, br as MigrationInfo, bs as NavGroup, bt as NotFoundError, bu as NumberField, bv as OnRequest, bw as OnRequestArgs, bx as Operation, by as OutboxRow, bz as PLUGIN_API_VERSION, bA as PasswordEmail, bB as PasswordEmailArgs, bC as PasswordEmailFn, bD as PasswordLinkOptions, bE as PayloadTooLargeError, bF as Plugin, bG as PluginInfo, bH as PluginTypes, bI as PreviewTarget, bJ as PreviewURL, bK as QueryError, bL as ROLE_OPERATIONS, bM as RawDocument, bN as ReadOptions, bO as RelationshipField, bP as RequestContext, bQ as ResolvedConfig, bR as RichTextDocument, bS as RichTextField, bT as Role, bU as RoleOperation, bV as RolePermissions, bW as Roles, bX as RoutesConfig, bY as ScheduledPublish, bZ as SchemaError, b_ as SchemaMode, b$ as SearchAdapter, c0 as SearchEntry, c1 as SearchHits, c2 as SearchOptions, c3 as SearchQuery, c4 as SearchResults, c5 as SearchSetting, c6 as SelectField, c7 as SelectOption, c8 as Session, c9 as SidebarPanel, ca as SignupArgs, cb as SignupResult, cc as SingleSignOn, cd as SlugField, ce as SlugOf, cf as SsoOutcome, cg as SsoProviderRef, ch as StorageAdapter, ci as StoredFile, cj as TextField, ck as TextareaField, cl as TooManyRequestsError, cm as TypedPlugin, cn as UnauthorizedError, co as UncountedDocs, cp as UpdateInput, cq as UpdateOptions, cr as UploadConfig, cs as UploadField, ct as UploadFromURLConfig, cu as UserIdentity, cv as ValidationError, cw as Version, cx as VersionSummary, cy as VersionsConfig, cz as WEBHOOK_EVENTS, cA as WebhookConfig, cB as WebhookEvent, cC as WebhookPayload, cD as Where, cE as WhereOperators, cF as anyone, cG as consoleEmail, cH as consoleLogger, cI as createEasyCMS, cJ as defineConfig, cK as defineFieldType, cL as definePlugin, cM as diskStorage, cN as hasRows, cO as isAdmin, cP as isHasMany, cQ as isSignedIn, cR as isStaff, cS as isSystemAdmin, cT as jsonLogger, cU as memorySearch, cV as mimeAllowedBy, cW as rowFields, cX as silentLogger, cY as uniqueWithinOf } from './config-B-bT0hIn.js';
+export { A as ADMIN_API_VERSION, a as AdminCollection, b as AdminComponentRef, c as AdminElementProps, d as AdminField, e as AdminGlobal, f as AdminLayoutNode, g as AdminNavGroup, h as AdminNavItem, i as AdminNavNode, j as AdminPageRef, k as AdminPageRoute, l as AdminSchema, m as AdminWidgetRef, S as SetFieldDetail, w as warnDeprecated } from './plugin-CI6r3SK1.js';
+export { A as AdminBackup, a as AdminBackups, b as ApiHandlerOptions, B as BackupState, L as LoadConfigOptions, R as RestHandler, c as RestHandlerOptions, d as createApiHandler, e as createRestHandler, l as loadConfig, r as resolveConfig, s as sharedEasyCMS, f as slugify } from './handler-COsNEVx0.js';
 export { FieldCondition, matchesCondition } from './conditions.js';
 
 type DeliveryKind = 'webhook' | 'email';
@@ -230,6 +230,8 @@ interface AdminStatus {
         storage: string;
         /** The email adapter's name, `custom` when it has none, or `null` without email. */
         email: string | null;
+        /** The search adapter's name, `custom` when it has none, or `null` without `search`. */
+        search: string | null;
         /** The config's plugins, with their name and version when they give them. */
         plugins: {
             name?: string;

package/dist/index.js

@@ -21,11 +21,12 @@ import {
   isSystemAdmin,
   jsonLogger,
   loadConfig,
+  memorySearch,
   resolveConfig,
   sharedEasyCMS,
   silentLogger,
   slugify
-} from "./chunk-244WCY6S.js";
+} from "./chunk-MHXQUX74.js";
 import {
   matchesCondition
 } from "./chunk-U266LV4M.js";
@@ -92,6 +93,7 @@ export {
   jsonLogger,
   loadConfig,
   matchesCondition,
+  memorySearch,
   resolveConfig,
   sharedEasyCMS,
   silentLogger,

package/dist/internal.d.ts

@@ -1,6 +1,6 @@
 import { Config, Database, EasyCMS, NavGroup, CollectionConfig, ID, RawDocument, Field, ResolvedConfig, ConfigIssue } from './index.js';
-export { cQ as API_KEYS, cR as API_KEY_GLOBAL_OPERATIONS, cS as API_KEY_OPERATIONS, cT as DEFAULT_MAX_VERSIONS, cU as DEFAULT_PASSWORD_EMAILS, cV as FIELD_TYPE_BASES, cW as FOLDER_LEVELS, cX as MediaFolders, cY as SSO_COOKIE, cZ as codeOfStatus, cF as hasRows, cH as isHasMany, c_ as isJsonLogger, c$ as keyAllows, d0 as logFormat, cM as mimeAllowedBy, cN as rowFields, cP as uniqueWithinOf } from './config-CHEEPk1d.js';
-export { C as CONFIG_FILE_NAMES, g as CSRF_COOKIE, h as CSRF_HEADER, D as DEFAULT_ADMIN_PATH, i as DEFAULT_API_PATH, j as DEFAULT_MAX_FILE_SIZE, k as DEFAULT_TOKEN_EXPIRATION, m as applyDefaults, n as applyPlugins, o as createRootEndpointHandler, p as decryptBackup, q as fillMissing, t as findConfigFile, u as forwardedClientIp, v as generateSlugs, w as importConfig, x as mergeForUpdate, y as parseId, z as platformClientIp, E as readCookie, F as validateFields, G as writeBackupFile } from './handler-adKUq8-U.js';
+export { cZ as API_KEYS, c_ as API_KEY_GLOBAL_OPERATIONS, c$ as API_KEY_OPERATIONS, d0 as DEFAULT_MAX_VERSIONS, d1 as DEFAULT_PASSWORD_EMAILS, d2 as FIELD_TYPE_BASES, d3 as FOLDER_LEVELS, d4 as MediaFolders, d5 as SSO_COOKIE, d6 as codeOfStatus, cN as hasRows, cP as isHasMany, d7 as isJsonLogger, d8 as keyAllows, d9 as logFormat, cV as mimeAllowedBy, cW as rowFields, cY as uniqueWithinOf } from './config-B-bT0hIn.js';
+export { C as CONFIG_FILE_NAMES, g as CSRF_COOKIE, h as CSRF_HEADER, D as DEFAULT_ADMIN_PATH, i as DEFAULT_API_PATH, j as DEFAULT_MAX_FILE_SIZE, k as DEFAULT_TOKEN_EXPIRATION, m as applyDefaults, n as applyPlugins, o as createRootEndpointHandler, p as decryptBackup, q as fillMissing, t as findConfigFile, u as forwardedClientIp, v as generateSlugs, w as importConfig, x as mergeForUpdate, y as parseId, z as platformClientIp, E as readCookie, F as validateFields, G as writeBackupFile } from './handler-COsNEVx0.js';
 export { conditionIssues } from './conditions.js';
 
 /** The session cookie the REST API sets at login. */

package/dist/internal.js

@@ -56,7 +56,7 @@ import {
   verifyPassword,
   verifyTurnstile,
   writeBackupFile
-} from "./chunk-244WCY6S.js";
+} from "./chunk-MHXQUX74.js";
 import {
   conditionIssues
 } from "./chunk-U266LV4M.js";

package/dist/{plugin-B8xypoWd.d.ts → plugin-CI6r3SK1.d.ts}

@@ -1,4 +1,4 @@
-import { bd as Label, aE as Field, I as ID, k as AdminLocale, t as AdminSwitcher, c8 as SsoProviderRef } from './config-CHEEPk1d.js';
+import { be as Label, aF as Field, I as ID, k as AdminLocale, t as AdminSwitcher, cg as SsoProviderRef } from './config-B-bT0hIn.js';
 import { FieldCondition } from './conditions.js';
 
 /** A Web Component from an admin module, with its `props` (plain JSON). */

package/dist/plugin.d.ts

@@ -1,3 +1,3 @@
-export { a as ADMIN_ICONS, g as AdminComponent, j as AdminIcon, S as AuthUser, a3 as CliCommand, a4 as CollectionAccess, a6 as CollectionConfig, ab as Config, ac as ConfigError, al as DashboardWidget, aw as EasyCMSError, aA as Endpoint, aB as EndpointRequest, aC as ErrorCode, aE as Field, aF as FieldAccess, aI as FieldError, aL as FieldTypeBase, aM as FieldTypeDefinition, aN as FieldTypeValidateContext, a_ as ForbiddenError, b0 as GlobalConfig, I as ID, ba as JobConfig, bd as Label, br as NavGroup, bs as NotFoundError, bu as OnRequest, bv as OnRequestArgs, by as PLUGIN_API_VERSION, bD as PayloadTooLargeError, bE as Plugin, bF as PluginInfo, bG as PluginTypes, bJ as QueryError, bO as RequestContext, cd as TooManyRequestsError, ce as TypedPlugin, cf as UnauthorizedError, cn as ValidationError, cv as Where, cC as defineFieldType, cD as definePlugin } from './config-CHEEPk1d.js';
-export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail, w as warnDeprecated } from './plugin-B8xypoWd.js';
+export { a as ADMIN_ICONS, g as AdminComponent, j as AdminIcon, S as AuthUser, a3 as CliCommand, a4 as CollectionAccess, a6 as CollectionConfig, ac as Config, ad as ConfigError, am as DashboardWidget, ax as EasyCMSError, aB as Endpoint, aC as EndpointRequest, aD as ErrorCode, aF as Field, aG as FieldAccess, aJ as FieldError, aM as FieldTypeBase, aN as FieldTypeDefinition, aO as FieldTypeValidateContext, a$ as ForbiddenError, b1 as GlobalConfig, I as ID, bb as JobConfig, be as Label, bs as NavGroup, bt as NotFoundError, bv as OnRequest, bw as OnRequestArgs, bz as PLUGIN_API_VERSION, bE as PayloadTooLargeError, bF as Plugin, bG as PluginInfo, bH as PluginTypes, bK as QueryError, bP as RequestContext, cl as TooManyRequestsError, cm as TypedPlugin, cn as UnauthorizedError, cv as ValidationError, cD as Where, cK as defineFieldType, cL as definePlugin } from './config-B-bT0hIn.js';
+export { A as ADMIN_API_VERSION, c as AdminElementProps, k as AdminPageRoute, S as SetFieldDetail, w as warnDeprecated } from './plugin-CI6r3SK1.js';
 import './conditions.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@easy-cms/core",
-  "version": "1.12.0",
+  "version": "1.13.0",
   "description": "Embedded, code-first headless CMS for Nuxt and Next.js",
   "license": "MIT",
   "type": "module",