@qkix/strapi-plugin-rewind 0.1.4 → 0.2.0

package/dist/server/index.mjs

@@ -1,6 +1,6 @@
-import { createHash as x } from "node:crypto";
-import { AsyncLocalStorage as J } from "node:async_hooks";
-const Z = ["id", "documentId", "locale"], S = [
+import { createHash as J } from "node:crypto";
+import { AsyncLocalStorage as Z } from "node:async_hooks";
+const Q = ["id", "documentId", "locale"], S = [
   "createdAt",
   "updatedAt",
   "publishedAt",
@@ -10,15 +10,15 @@ const Z = ["id", "documentId", "locale"], S = [
   "strapi_assignee",
   "locale",
   "localizations"
-], I = (e, t) => e.getModel(t), Q = (e) => e?.type === "relation" || e?.type === "media", $ = (e) => e?.type === "relation" && String(e.relation ?? "").toLowerCase().startsWith("morph"), N = (e, t) => Object.entries(I(e, t).attributes).filter(
+], I = (e, t) => e.getModel(t), x = (e) => e?.type === "relation" || e?.type === "media", $ = (e) => e?.type === "relation" && String(e.relation ?? "").toLowerCase().startsWith("morph"), F = (e, t) => Object.entries(I(e, t).attributes).filter(
   ([, n]) => !["relation", "media", "component", "dynamiczone"].includes(n.type)
-).map(([n]) => n), q = (e, t, n = !0) => {
-  const r = I(e, t), o = n ? "select" : "fields";
-  return Object.entries(r.attributes).reduce(
-    (a, [s, i]) => {
-      switch (i.type) {
+).map(([n]) => n), E = (e, t, n = !0) => {
+  const i = I(e, t), o = n ? "select" : "fields";
+  return Object.entries(i.attributes).reduce(
+    (a, [s, r]) => {
+      switch (r.type) {
         case "relation": {
-          if ($(i)) break;
+          if ($(r)) break;
           a[s] = { [o]: ["documentId", "locale", "publishedAt"] };
           break;
         }
@@ -28,17 +28,17 @@ const Z = ["id", "documentId", "locale"], S = [
         }
         case "component": {
           a[s] = {
-            populate: q(e, i.component, n),
-            [o]: N(e, i.component)
+            populate: E(e, r.component, n),
+            [o]: F(e, r.component)
           };
           break;
         }
         case "dynamiczone": {
           a[s] = {
-            on: (i.components ?? []).reduce(
+            on: (r.components ?? []).reduce(
               (c, l) => (c[l] = {
-                populate: q(e, l, n),
-                [o]: N(e, l)
+                populate: E(e, l, n),
+                [o]: F(e, l)
               }, c),
               {}
             )
@@ -51,17 +51,17 @@ const Z = ["id", "documentId", "locale"], S = [
     {}
   );
 }, ee = (e, t) => {
-  const n = {}, r = (a) => {
+  const n = {}, i = (a) => {
     if (n[a]) return;
     const s = I(e, a).attributes;
     n[a] = R(s, S);
-    for (const i of Object.values(s))
-      if (i.type === "component" && r(i.component), i.type === "dynamiczone")
-        for (const c of i.components ?? []) r(c);
+    for (const r of Object.values(s))
+      if (r.type === "component" && i(r.component), r.type === "dynamiczone")
+        for (const c of r.components ?? []) i(c);
   }, o = I(e, t).attributes;
   for (const a of Object.values(o))
-    if (a.type === "component" && r(a.component), a.type === "dynamiczone")
-      for (const s of a.components ?? []) r(s);
+    if (a.type === "component" && i(a.component), a.type === "dynamiczone")
+      for (const s of a.components ?? []) i(s);
   return {
     attributes: R(o, S),
     components: n
@@ -73,77 +73,77 @@ const Z = ["id", "documentId", "locale"], S = [
     targetUid: t
   }
 ), ne = (e, t, n) => {
-  const r = I(e, t).attributes, o = {}, a = {}, s = R(n, [...S, ...Z]);
-  for (const [i, c] of Object.entries(s)) {
-    const l = r[i];
-    if (l && Q(l)) {
+  const i = I(e, t).attributes, o = {}, a = {}, s = R(n, [...S, ...Q]);
+  for (const [r, c] of Object.entries(s)) {
+    const l = i[r];
+    if (l && x(l)) {
       if ($(l)) continue;
       const d = l.type === "media" ? "plugin::upload.file" : l.target;
-      a[i] = te(c, d, l.type === "media");
+      a[r] = te(c, d, l.type === "media");
       continue;
     }
-    o[i] = l ? Y(e, l, c) : c;
+    o[r] = l ? Y(e, l, c) : c;
   }
   return { data: o, relations: a, schemaSnapshot: ee(e, t) };
 }, Y = (e, t, n) => {
   if (n == null) return n;
   if (t.type === "component") {
-    const r = (o) => _(e, t.component, o);
-    return Array.isArray(n) ? n.map((o) => r(o)) : r(n);
+    const i = (o) => _(e, t.component, o);
+    return Array.isArray(n) ? n.map((o) => i(o)) : i(n);
   }
-  return t.type === "dynamiczone" && Array.isArray(n) ? n.map((r) => {
-    const o = r;
+  return t.type === "dynamiczone" && Array.isArray(n) ? n.map((i) => {
+    const o = i;
     return _(e, o.__component, o);
   }) : n;
 }, _ = (e, t, n) => {
   if (!n || !t) return n;
-  const r = I(e, t).attributes, o = {};
+  const i = I(e, t).attributes, o = {};
   for (const [a, s] of Object.entries(n)) {
     if (a === "id") continue;
-    const i = r[a];
-    o[a] = i ? Y(e, i, s) : s;
+    const r = i[a];
+    o[a] = r ? Y(e, r, s) : s;
   }
   return o;
 }, H = (e) => {
-  const t = /* @__PURE__ */ new Map(), n = async (r) => {
-    if (t.has(r)) return t.get(r);
+  const t = /* @__PURE__ */ new Map(), n = async (i) => {
+    if (t.has(i)) return t.get(i);
     let o;
     try {
-      o = (await e.plugin("content-manager").service("content-types").findConfiguration(e.contentTypes[r]))?.settings?.mainField;
+      o = (await e.plugin("content-manager").service("content-types").findConfiguration(e.contentTypes[i]))?.settings?.mainField;
     } catch {
     }
-    return t.set(r, o), o;
+    return t.set(i, o), o;
   };
-  return async (r, o) => {
+  return async (i, o) => {
     if (!o) return null;
-    const s = [await n(r), "title", "name", "label"].filter(Boolean);
-    for (const i of s) {
-      const c = o[i];
+    const s = [await n(i), "title", "name", "label"].filter(Boolean);
+    for (const r of s) {
+      const c = o[r];
       if (typeof c == "string" && c.trim())
         return c.trim().slice(0, 255);
     }
     return null;
   };
-}, v = "plugin::rewind.version", oe = /* @__PURE__ */ new Set(["publish", "unpublish", "discardDraft", "restore"]), se = (e) => x("sha256").update(JSON.stringify(e)).digest("hex"), ie = ({ strapi: e }) => {
-  const t = H(e), n = (i) => !!e.contentTypes[i]?.options?.draftAndPublish, r = (i) => !!(e.getModel(i)?.pluginOptions?.i18n?.localized ?? e.contentTypes[i]?.pluginOptions?.i18n?.localized), o = async (i, c, l) => {
-    const d = r(i) && l.filter(Boolean).length > 0 ? { locale: { $in: l.filter(Boolean) } } : {};
-    return e.db.query(i).findMany({
+}, v = "plugin::rewind.version", oe = /* @__PURE__ */ new Set(["publish", "unpublish", "discardDraft", "restore"]), se = (e) => J("sha256").update(JSON.stringify(e)).digest("hex"), ie = ({ strapi: e }) => {
+  const t = H(e), n = (r) => !!e.contentTypes[r]?.options?.draftAndPublish, i = (r) => !!(e.getModel(r)?.pluginOptions?.i18n?.localized ?? e.contentTypes[r]?.pluginOptions?.i18n?.localized), o = async (r, c, l) => {
+    const d = i(r) && l.filter(Boolean).length > 0 ? { locale: { $in: l.filter(Boolean) } } : {};
+    return e.db.query(r).findMany({
       where: {
         documentId: c,
         ...d,
-        ...n(i) ? { publishedAt: null } : {}
+        ...n(r) ? { publishedAt: null } : {}
       },
-      populate: q(e, i)
+      populate: E(e, r)
     });
-  }, a = async (i, c) => {
+  }, a = async (r, c) => {
     try {
-      const l = e.plugin("content-manager").service("document-metadata"), d = await l.getMetadata(i, c);
+      const l = e.plugin("content-manager").service("document-metadata"), d = await l.getMetadata(r, c);
       return l.getStatus(c, d.availableStatus);
     } catch {
       return "draft";
     }
-  }, s = async (i, c, l) => e.db.query(v).findOne({
-    where: { contentType: i, relatedDocumentId: c, locale: l },
+  }, s = async (r, c, l) => e.db.query(v).findOne({
+    where: { contentType: r, relatedDocumentId: c, locale: l },
     orderBy: { createdAt: "desc" }
   });
   return {
@@ -154,12 +154,12 @@ const Z = ["id", "documentId", "locale"], S = [
      * Called from the transaction's commit hook and never awaited by the write
      * path - a failure here must not be able to reach the editor's save.
      */
-    async captureAll(i, c) {
-      for (const l of i)
+    async captureAll(r, c) {
+      for (const l of r)
         await this.capture(l, c);
     },
-    async capture(i, c) {
-      const { uid: l, relatedDocumentId: d, locale: p, origin: b } = i, m = i.before ?? await o(l, d, [p]);
+    async capture(r, c) {
+      const { uid: l, relatedDocumentId: d, locale: p, origin: b } = r, m = r.before ?? await o(l, d, [p]);
       for (const u of m) {
         const h = u.locale ?? null, { data: f, relations: w, schemaSnapshot: T } = ne(e, l, u), g = se({ data: f, relations: w });
         !oe.has(b) && (await s(l, d, h))?.contentHash === g || await e.db.query(v).create({
@@ -195,13 +195,13 @@ const Z = ["id", "documentId", "locale"], S = [
 }, ae = (e) => {
   const t = /* @__PURE__ */ new Map();
   for (const n of e) {
-    const r = `${n.uid}:${n.relatedDocumentId}:${n.locale ?? ""}`, o = t.get(r);
+    const i = `${n.uid}:${n.relatedDocumentId}:${n.locale ?? ""}`, o = t.get(i);
     if (!o) {
-      t.set(r, n);
+      t.set(i, n);
       continue;
     }
     const a = j.indexOf(n.origin) < j.indexOf(o.origin);
-    t.set(r, {
+    t.set(i, {
       // A winning `publish` still wants the rows an earlier `discardDraft`
       // captured - losing them would lose the only copy of that state.
       ...a ? n : o,
@@ -209,10 +209,10 @@ const Z = ["id", "documentId", "locale"], S = [
     });
   }
   return [...t.values()];
-}, W = new J(), ce = (e) => W.run({ active: !0 }, e), le = () => W.getStore()?.active === !0, de = 200, ue = async (e, t) => {
-  const n = e.db.query(t), r = await n.count({ where: { label: null } });
-  if (r === 0) return 0;
-  e.log.info(`[rewind] labelling ${r} older version(s)…`);
+}, W = new Z(), ce = (e) => W.run({ active: !0 }, e), le = () => W.getStore()?.active === !0, de = 200, ue = async (e, t) => {
+  const n = e.db.query(t), i = await n.count({ where: { label: null } });
+  if (i === 0) return 0;
+  e.log.info(`[rewind] labelling ${i} older version(s)…`);
   const o = H(e);
   let a = 0;
   for (; ; ) {
@@ -222,10 +222,10 @@ const Z = ["id", "documentId", "locale"], S = [
       limit: de
     });
     if (s.length === 0) break;
-    for (const i of s) {
-      const c = await o(i.contentType, i.data);
+    for (const r of s) {
+      const c = await o(r.contentType, r.data);
       await n.update({
-        where: { id: i.id },
+        where: { id: r.id },
         data: { label: c ?? "" }
       }), a += 1;
     }
@@ -251,14 +251,14 @@ const Z = ["id", "documentId", "locale"], S = [
       `[rewind] could not label older versions: ${o instanceof Error ? o.message : String(o)}`
     )
   ), he(e, t);
-  const n = () => e.plugin("rewind").service("snapshot"), r = (o) => {
+  const n = () => e.plugin("rewind").service("snapshot"), i = (o) => {
     if (!pe.includes(o.action)) return !1;
     const a = o.contentType?.uid ?? o.uid ?? "";
     return !(!a.startsWith("api::") || !t.contentTypes.includes(a) || le() || !t.trackApiWrites && !e.requestContext.get()?.request?.url?.startsWith("/content-manager"));
   };
   e.documents.use(async (o, a) => {
-    if (!r(o)) return a();
-    const s = o.contentType?.uid ?? o.uid, i = o.params?.locale ?? null, c = o.action === "discardDraft" && o.params?.documentId ? await n().readRows(s, o.params.documentId, [i]) : null, l = await a(), d = o.action === "create" || o.action === "clone" ? l?.documentId : o.params?.documentId;
+    if (!i(o)) return a();
+    const s = o.contentType?.uid ?? o.uid, r = o.params?.locale ?? null, c = o.action === "discardDraft" && o.params?.documentId ? await n().readRows(s, o.params.documentId, [r]) : null, l = await a(), d = o.action === "create" || o.action === "clone" ? l?.documentId : o.params?.documentId;
     if (!d) return l;
     const p = ge(e);
     return await e.db.transaction(async ({ trx: b, onCommit: m }) => {
@@ -266,7 +266,7 @@ const Z = ["id", "documentId", "locale"], S = [
       u.intents.push({
         uid: s,
         relatedDocumentId: d,
-        locale: i,
+        locale: r,
         origin: o.action,
         before: c
       }), !u.flushRegistered && (u.flushRegistered = !0, m(() => {
@@ -296,12 +296,12 @@ const Z = ["id", "documentId", "locale"], S = [
         const n = e.plugin("rewind").service("lock");
         if (await n.acquire("prune", 30 * 60 * 1e3))
           try {
-            const r = await e.plugin("rewind").service("retention").prune();
-            r.deleted > 0 && e.log.info(
-              `[rewind] thinned ${r.deleted} version(s) across ${r.documents} document(s)`
+            const i = await e.plugin("rewind").service("retention").prune();
+            i.deleted > 0 && e.log.info(
+              `[rewind] thinned ${i.deleted} version(s) across ${i.documents} document(s)`
             );
-          } catch (r) {
-            e.log.error("[rewind] thinning failed", r);
+          } catch (i) {
+            e.log.error("[rewind] thinning failed", i);
           } finally {
             await n.release("prune");
           }
@@ -371,10 +371,10 @@ const Z = ["id", "documentId", "locale"], S = [
       throw new Error(
         '[rewind] config.contentTypes must be an array of content type uids, e.g. ["api::article.article"]'
       );
-    const r = t.filter((o) => !o.startsWith("api::"));
-    if (r.length > 0)
+    const i = t.filter((o) => !o.startsWith("api::"));
+    if (i.length > 0)
       throw new Error(
-        `[rewind] config.contentTypes only supports api:: content types, received: ${r.join(", ")}`
+        `[rewind] config.contentTypes only supports api:: content types, received: ${i.join(", ")}`
       );
   }
 }, be = "collectionType", Te = "rewind_versions", ve = {
@@ -454,18 +454,18 @@ const Z = ["id", "documentId", "locale"], S = [
   userId: {
     type: "integer"
   }
-}, ke = {
+}, Oe = {
   kind: be,
   collectionName: Te,
   info: ve,
   options: De,
   pluginOptions: Ae,
   attributes: Ie
-}, Oe = {
-  version: { schema: ke }
+}, ke = {
+  version: { schema: Oe }
 }, Se = ({ strapi: e }) => {
   e.cron.remove("rewindPrune");
-}, Ee = [
+}, qe = [
   "id",
   "contentType",
   "relatedDocumentId",
@@ -477,24 +477,24 @@ const Z = ["id", "documentId", "locale"], S = [
   "pinned",
   "contentHash",
   "createdAt"
-], qe = ({ strapi: e }) => ({
+], Ee = ({ strapi: e }) => ({
   async find(t) {
-    const { contentType: n, documentId: r, locale: o, page: a = 1, pageSize: s = 10 } = t.query;
-    if (!n || !r)
+    const { contentType: n, documentId: i, locale: o, page: a = 1, pageSize: s = 10 } = t.query;
+    if (!n || !i)
       return t.badRequest("contentType and documentId are required.");
-    const i = {
+    const r = {
       contentType: n,
-      relatedDocumentId: r,
+      relatedDocumentId: i,
       ...o ? { locale: o } : {}
     }, c = Math.min(Number(s) || 10, 100), l = (Math.max(Number(a) || 1, 1) - 1) * c, [d, p] = await Promise.all([
       e.db.query(v).findMany({
-        select: Ee,
-        where: i,
+        select: qe,
+        where: r,
         orderBy: { createdAt: "desc" },
         limit: c,
         offset: l
       }),
-      e.db.query(v).count({ where: i })
+      e.db.query(v).count({ where: r })
     ]);
     t.body = {
       data: await U(e, d),
@@ -512,9 +512,9 @@ const Z = ["id", "documentId", "locale"], S = [
       t.body = {
         data: await e.plugin("rewind").service("diff").between(Number(t.params.id), n ? Number(n) : void 0)
       };
-    } catch (r) {
+    } catch (i) {
       return t.badRequest(
-        r instanceof Error ? r.message : "Could not compare these versions."
+        i instanceof Error ? i.message : "Could not compare these versions."
       );
     }
   },
@@ -527,6 +527,23 @@ const Z = ["id", "documentId", "locale"], S = [
       return t.badRequest(n instanceof Error ? n.message : "Preview failed.");
     }
   },
+  /**
+   * `pinned` is read from the body rather than inferred as a toggle, so that two
+   * editors with the panel open cannot flip the same version past each other:
+   * each request states the state it wants, and the last one wins visibly.
+   */
+  async pin(t) {
+    const { pinned: n } = t.request.body ?? {};
+    if (typeof n != "boolean")
+      return t.badRequest("pinned must be true or false.");
+    try {
+      t.body = {
+        data: await e.plugin("rewind").service("pin").set(Number(t.params.id), n)
+      };
+    } catch (i) {
+      return t.notFound(i instanceof Error ? i.message : "No such version.");
+    }
+  },
   async restore(t) {
     try {
       t.body = {
@@ -539,7 +556,7 @@ const Z = ["id", "documentId", "locale"], S = [
 }), U = async (e, t) => {
   const n = [...new Set(t.map((a) => a.userId).filter(Boolean))];
   if (n.length === 0) return t.map((a) => ({ ...a, user: null }));
-  const r = await e.db.query("admin::user").findMany({ select: ["id", "firstname", "lastname", "email"], where: { id: n } }), o = new Map(r.map((a) => [a.id, a]));
+  const i = await e.db.query("admin::user").findMany({ select: ["id", "firstname", "lastname", "email"], where: { id: n } }), o = new Map(i.map((a) => [a.id, a]));
   return t.map((a) => {
     const s = o.get(a.userId);
     return {
@@ -551,7 +568,7 @@ const Z = ["id", "documentId", "locale"], S = [
     };
   });
 }, Re = {
-  version: qe
+  version: Ee
 }, $e = {
   type: "admin",
   routes: [
@@ -579,6 +596,12 @@ const Z = ["id", "documentId", "locale"], S = [
       handler: "version.preview",
       config: { policies: ["admin::isAuthenticatedAdmin"] }
     },
+    {
+      method: "PUT",
+      path: "/versions/:id/pin",
+      handler: "version.pin",
+      config: { policies: ["admin::isAuthenticatedAdmin"] }
+    },
     {
       method: "POST",
       path: "/versions/:id/restore",
@@ -586,31 +609,31 @@ const Z = ["id", "documentId", "locale"], S = [
       config: { policies: ["admin::isAuthenticatedAdmin"] }
     }
   ]
-}, Fe = {
+}, Ne = {
   admin: $e
-}, B = (e) => e.match(/\S+\s*/g) ?? [], L = 2500, Ne = (e, t) => {
-  const n = B(e), r = B(t);
-  if (n.length > L || r.length > L)
+}, B = (e) => e.match(/\S+\s*/g) ?? [], L = 2500, Fe = (e, t) => {
+  const n = B(e), i = B(t);
+  if (n.length > L || i.length > L)
     return [
       { op: "removed", value: e },
       { op: "added", value: t }
     ];
   const o = Array.from(
     { length: n.length + 1 },
-    () => new Array(r.length + 1).fill(0)
+    () => new Array(i.length + 1).fill(0)
   );
   for (let l = n.length - 1; l >= 0; l -= 1)
-    for (let d = r.length - 1; d >= 0; d -= 1)
-      o[l][d] = n[l] === r[d] ? o[l + 1][d + 1] + 1 : Math.max(o[l + 1][d], o[l][d + 1]);
+    for (let d = i.length - 1; d >= 0; d -= 1)
+      o[l][d] = n[l] === i[d] ? o[l + 1][d + 1] + 1 : Math.max(o[l + 1][d], o[l][d + 1]);
   const a = [], s = (l, d) => {
     const p = a[a.length - 1];
     p && p.op === l ? p.value += d : a.push({ op: l, value: d });
   };
-  let i = 0, c = 0;
-  for (; i < n.length && c < r.length; )
-    n[i] === r[c] ? (s("equal", n[i]), i += 1, c += 1) : o[i + 1][c] >= o[i][c + 1] ? (s("removed", n[i]), i += 1) : (s("added", r[c]), c += 1);
-  for (; i < n.length; ) s("removed", n[i++]);
-  for (; c < r.length; ) s("added", r[c++]);
+  let r = 0, c = 0;
+  for (; r < n.length && c < i.length; )
+    n[r] === i[c] ? (s("equal", n[r]), r += 1, c += 1) : o[r + 1][c] >= o[r][c + 1] ? (s("removed", n[r]), r += 1) : (s("added", i[c]), c += 1);
+  for (; r < n.length; ) s("removed", n[r++]);
+  for (; c < i.length; ) s("added", i[c++]);
   return a;
 }, _e = /* @__PURE__ */ new Set([
   "id",
@@ -620,19 +643,19 @@ const Z = ["id", "documentId", "locale"], S = [
   "level",
   "language",
   "url"
-]), E = (e, t = 0) => t > 12 || e == null ? "" : typeof e == "string" ? e : typeof e == "boolean" ? "" : typeof e == "number" ? String(e) : Array.isArray(e) ? e.map((n) => E(n, t + 1)).filter(Boolean).join(" ") : typeof e == "object" ? Object.entries(e).filter(([n]) => !_e.has(n)).map(([, n]) => E(n, t + 1)).filter(Boolean).join(" ") : "", z = (e) => e.replace(/\s+/g, " ").trim(), je = 6, Ce = (e, t = je) => {
+]), q = (e, t = 0) => t > 12 || e == null ? "" : typeof e == "string" ? e : typeof e == "boolean" ? "" : typeof e == "number" ? String(e) : Array.isArray(e) ? e.map((n) => q(n, t + 1)).filter(Boolean).join(" ") : typeof e == "object" ? Object.entries(e).filter(([n]) => !_e.has(n)).map(([, n]) => q(n, t + 1)).filter(Boolean).join(" ") : "", z = (e) => e.replace(/\s+/g, " ").trim(), je = 6, Ce = (e, t = je) => {
   const n = [];
-  return e.forEach((r, o) => {
-    if (r.op !== "equal") {
-      n.push(r);
+  return e.forEach((i, o) => {
+    if (i.op !== "equal") {
+      n.push(i);
       return;
     }
-    const a = r.value.match(/\S+\s*/g) ?? [];
+    const a = i.value.match(/\S+\s*/g) ?? [];
     if (a.length <= t * 2 + 1) {
-      n.push(r);
+      n.push(i);
       return;
     }
-    const s = o === 0, i = o === e.length - 1, c = s ? [] : a.slice(0, t), l = i ? [] : a.slice(-t);
+    const s = o === 0, r = o === e.length - 1, c = s ? [] : a.slice(0, t), l = r ? [] : a.slice(-t);
     c.length && n.push({ op: "equal", value: c.join("") }), n.push({ op: "equal", value: " … " }), l.length && n.push({ op: "equal", value: l.join("") });
   }), n;
 }, Me = /* @__PURE__ */ new Set([
@@ -650,7 +673,7 @@ const Z = ["id", "documentId", "locale"], S = [
   "uid",
   "email",
   "password"
-]), Ue = (e, t) => e === "text" || e === "richtext" || e === "blocks" || e === "json" || e === "customField" || e === "component" || e === "dynamiczone" || e === "string" && typeof t == "string" && t.length > 80, O = (e) => `${e.targetUid}:${e.documentId ?? e.id}`, Be = ({ strapi: e }) => {
+]), Ue = (e, t) => e === "text" || e === "richtext" || e === "blocks" || e === "json" || e === "customField" || e === "component" || e === "dynamiczone" || e === "string" && typeof t == "string" && t.length > 80, k = (e) => `${e.targetUid}:${e.documentId ?? e.id}`, Be = ({ strapi: e }) => {
   const t = (o) => o && {
     id: o.id,
     label: o.label ?? null,
@@ -660,7 +683,7 @@ const Z = ["id", "documentId", "locale"], S = [
     const a = await e.db.query(v).findOne({ where: { id: o } });
     if (!a) throw new Error(`No version with id ${o}`);
     return a;
-  }, r = async (o) => {
+  }, i = async (o) => {
     const [a] = await e.db.query(v).findMany({
       where: {
         contentType: o.contentType,
@@ -683,7 +706,7 @@ const Z = ["id", "documentId", "locale"], S = [
      * change?", is what `restore.preview()` already answers.
      */
     async between(o, a) {
-      const s = await n(o), i = a ? await n(a) : await r(s), c = e.getModel(s.contentType)?.attributes, l = s.data ?? {}, d = i?.data ?? {}, p = s.relations ?? {}, b = i?.relations ?? {}, m = [];
+      const s = await n(o), r = a ? await n(a) : await i(s), c = e.getModel(s.contentType)?.attributes, l = s.data ?? {}, d = r?.data ?? {}, p = s.relations ?? {}, b = r?.relations ?? {}, m = [];
       for (const u of /* @__PURE__ */ new Set([...Object.keys(d), ...Object.keys(l)])) {
         const h = d[u], f = l[u];
         if (JSON.stringify(h) === JSON.stringify(f)) continue;
@@ -692,7 +715,7 @@ const Z = ["id", "documentId", "locale"], S = [
           m.push({ field: u, type: w, customField: T, kind: g, before: h, after: f });
           continue;
         }
-        const D = z(E(h)), A = z(E(f));
+        const D = z(q(h)), A = z(q(f));
         if (D === A) {
           m.push({ field: u, type: w, customField: T, kind: g, before: void 0, after: void 0 });
           continue;
@@ -705,11 +728,11 @@ const Z = ["id", "documentId", "locale"], S = [
           // Collapsed here rather than in the panel: sending an entire article
           // to highlight one word wastes the payload as well as the reader's
           // attention.
-          spans: Ce(Ne(D, A))
+          spans: Ce(Fe(D, A))
         });
       }
       for (const u of /* @__PURE__ */ new Set([...Object.keys(b), ...Object.keys(p)])) {
-        const h = b[u] ?? [], f = p[u] ?? [], w = new Set(h.map(O)), T = new Set(f.map(O)), g = f.filter((A) => !w.has(O(A))), D = h.filter((A) => !T.has(O(A)));
+        const h = b[u] ?? [], f = p[u] ?? [], w = new Set(h.map(k)), T = new Set(f.map(k)), g = f.filter((A) => !w.has(k(A))), D = h.filter((A) => !T.has(k(A)));
         g.length === 0 && D.length === 0 || m.push({
           field: u,
           type: c?.[u]?.type ?? "relation",
@@ -719,7 +742,7 @@ const Z = ["id", "documentId", "locale"], S = [
         });
       }
       return {
-        from: i ? t(i) : null,
+        from: r ? t(r) : null,
         to: t(s),
         changes: m,
         identical: m.length === 0
@@ -733,52 +756,61 @@ const Z = ["id", "documentId", "locale"], S = [
     key: `lock:${n}`
   });
   return {
-    async acquire(n, r) {
+    async acquire(n, i) {
       const o = await e.store.get(t(n));
       return o && o.expires > Date.now() ? !1 : (await e.store.set({
         ...t(n),
-        value: { expires: Date.now() + r }
+        value: { expires: Date.now() + i }
       }), !0);
     },
     async release(n) {
       await e.store.set({ ...t(n), value: { expires: 0 } });
     }
   };
-}, K = {
+}, ze = ({ strapi: e }) => ({
+  async set(t, n) {
+    if (!Number.isInteger(t))
+      throw new Error("A version id is required.");
+    const i = await e.db.query(v).findOne({ where: { id: t }, select: ["id", "pinned"] });
+    if (!i)
+      throw new Error(`No version with id ${t}`);
+    return !!i.pinned === n ? { id: t, pinned: n } : (await e.db.query(v).update({ where: { id: t }, data: { pinned: n } }), { id: t, pinned: n });
+  }
+}), K = {
   keepAllDays: 7,
   dailyUntilDays: 30,
   maxAgeDays: 365,
   keepAnchors: !0
-}, ze = /* @__PURE__ */ new Set(["publish", "unpublish", "discardDraft", "restore"]), G = 24 * 60 * 60 * 1e3, Pe = (e, t) => (t.getTime() - new Date(e).getTime()) / G, Ye = (e) => e.toISOString().slice(0, 10), He = (e) => {
+}, Pe = /* @__PURE__ */ new Set(["publish", "unpublish", "discardDraft", "restore"]), G = 24 * 60 * 60 * 1e3, Ye = (e, t) => (t.getTime() - new Date(e).getTime()) / G, He = (e) => e.toISOString().slice(0, 10), We = (e) => {
   const t = new Date(Date.UTC(e.getUTCFullYear(), e.getUTCMonth(), e.getUTCDate())), n = t.getUTCDay() || 7;
   t.setUTCDate(t.getUTCDate() + 4 - n);
-  const r = new Date(Date.UTC(t.getUTCFullYear(), 0, 1)), o = Math.ceil(((t.getTime() - r.getTime()) / G + 1) / 7);
+  const i = new Date(Date.UTC(t.getUTCFullYear(), 0, 1)), o = Math.ceil(((t.getTime() - i.getTime()) / G + 1) / 7);
   return `${t.getUTCFullYear()}-W${o}`;
-}, We = (e, t, n = K) => {
-  const r = /* @__PURE__ */ new Map(), o = [], a = [...e].sort(
-    (s, i) => new Date(i.createdAt).getTime() - new Date(s.createdAt).getTime()
+}, Ke = (e, t, n = K) => {
+  const i = /* @__PURE__ */ new Map(), o = [], a = [...e].sort(
+    (s, r) => new Date(r.createdAt).getTime() - new Date(s.createdAt).getTime()
   );
   for (const s of a) {
-    if (s.pinned || n.keepAnchors && ze.has(s.origin)) continue;
-    const i = Pe(s.createdAt, t);
-    if (i <= n.keepAllDays) continue;
-    if (i > n.maxAgeDays) {
+    if (s.pinned || n.keepAnchors && Pe.has(s.origin)) continue;
+    const r = Ye(s.createdAt, t);
+    if (r <= n.keepAllDays) continue;
+    if (r > n.maxAgeDays) {
       o.push(s.id);
       continue;
     }
-    const c = new Date(s.createdAt), l = i <= n.dailyUntilDays ? `d:${Ye(c)}` : `w:${He(c)}`;
-    r.has(l) ? o.push(s.id) : r.set(l, s);
+    const c = new Date(s.createdAt), l = r <= n.dailyUntilDays ? `d:${He(c)}` : `w:${We(c)}`;
+    i.has(l) ? o.push(s.id) : i.set(l, s);
   }
   return o;
-}, P = 500, Ke = ({ strapi: e }) => {
-  const t = () => e.db.query(v), n = async (r) => {
+}, P = 500, Ge = ({ strapi: e }) => {
+  const t = () => e.db.query(v), n = async (i) => {
     const o = await t().findMany({
       select: ["contentType", "relatedDocumentId", "locale"],
-      where: { createdAt: { $lt: r } }
+      where: { createdAt: { $lt: i } }
     }), a = /* @__PURE__ */ new Map();
     for (const s of o) {
-      const i = `${s.contentType}|${s.relatedDocumentId}|${s.locale ?? ""}`;
-      a.has(i) || a.set(i, {
+      const r = `${s.contentType}|${s.relatedDocumentId}|${s.locale ?? ""}`;
+      a.has(r) || a.set(r, {
         contentType: s.contentType,
         relatedDocumentId: s.relatedDocumentId,
         locale: s.locale ?? null
@@ -793,13 +825,13 @@ const Z = ["id", "documentId", "locale"], S = [
      * Returns what it did rather than logging and forgetting, so the cron can
      * report it and a test can assert on it.
      */
-    async prune(r = /* @__PURE__ */ new Date()) {
+    async prune(i = /* @__PURE__ */ new Date()) {
       const o = e.config.get("plugin::rewind"), a = { ...K, ...o?.retention };
       if (o?.retention?.enabled === !1)
         return { scanned: 0, deleted: 0, documents: 0 };
-      const s = new Date(r.getTime() - a.keepAllDays * 24 * 60 * 60 * 1e3), i = await n(s);
+      const s = new Date(i.getTime() - a.keepAllDays * 24 * 60 * 60 * 1e3), r = await n(s);
       let c = 0, l = 0;
-      for (const d of i) {
+      for (const d of r) {
         const p = await t().findMany({
           select: ["id", "createdAt", "origin", "pinned"],
           where: {
@@ -809,22 +841,22 @@ const Z = ["id", "documentId", "locale"], S = [
           }
         });
         c += p.length;
-        const b = We(p, r, a);
+        const b = Ke(p, i, a);
         for (let m = 0; m < b.length; m += P) {
           const u = b.slice(m, m + P);
           await t().deleteMany({ where: { id: { $in: u } } }), l += u.length;
         }
       }
-      return { scanned: c, deleted: l, documents: i.length };
+      return { scanned: c, deleted: l, documents: r.length };
     }
   };
-}, Ge = ({ strapi: e }) => {
+}, Ve = ({ strapi: e }) => {
   const t = (s) => e.getModel(s), n = async (s) => {
-    const i = await e.db.query(v).findOne({ where: { id: s } });
-    if (!i)
+    const r = await e.db.query(v).findOne({ where: { id: s } });
+    if (!r)
       throw new Error(`No version with id ${s}`);
-    return i;
-  }, r = (s) => s?.pluginOptions?.i18n?.localized === !0, o = (s) => e.contentTypes[s]?.pluginOptions?.i18n?.localized === !0, a = async (s) => s.targetUid === "plugin::upload.file" ? !!await e.db.query("plugin::upload.file").findOne({ where: { id: s.id } }) : !!await e.db.query(s.targetUid).findOne({
+    return r;
+  }, i = (s) => s?.pluginOptions?.i18n?.localized === !0, o = (s) => e.contentTypes[s]?.pluginOptions?.i18n?.localized === !0, a = async (s) => s.targetUid === "plugin::upload.file" ? !!await e.db.query("plugin::upload.file").findOne({ where: { id: s.id } }) : !!await e.db.query(s.targetUid).findOne({
     where: {
       documentId: s.documentId,
       ...s.locale ? { locale: s.locale } : {}
@@ -840,11 +872,11 @@ const Z = ["id", "documentId", "locale"], S = [
      * version of a document quietly rewrites a field in every other language.
      */
     async preview(s) {
-      const i = await n(s), c = i.contentType, l = t(c).attributes, d = i.schemaSnapshot?.attributes ?? {}, p = i.data ?? {}, b = i.relations ?? {}, m = Object.keys(l).filter((y) => !S.includes(y)), u = Object.keys(d), h = u.filter((y) => !m.includes(y)), f = m.filter((y) => !u.includes(y)), w = u.filter((y) => m.includes(y)), T = w.filter((y) => $(l[y])), g = w.filter((y) => !T.includes(y)), D = o(c) ? g.filter((y) => !r(l[y])) : [], A = [], F = [];
+      const r = await n(s), c = r.contentType, l = t(c).attributes, d = r.schemaSnapshot?.attributes ?? {}, p = r.data ?? {}, b = r.relations ?? {}, m = Object.keys(l).filter((y) => !S.includes(y)), u = Object.keys(d), h = u.filter((y) => !m.includes(y)), f = m.filter((y) => !u.includes(y)), w = u.filter((y) => m.includes(y)), T = w.filter((y) => $(l[y])), g = w.filter((y) => !T.includes(y)), D = o(c) ? g.filter((y) => !i(l[y])) : [], A = [], N = [];
       for (const [y, X] of Object.entries(b))
         if (g.includes(y))
-          for (const k of X)
-            await a(k) || (k.targetUid === "plugin::upload.file" ? F.push(k) : A.push(k));
+          for (const O of X)
+            await a(O) || (O.targetUid === "plugin::upload.file" ? N.push(O) : A.push(O));
       const V = D.length ? await e.plugin("i18n")?.service("locales").find() : [];
       return {
         fieldsToRestore: g.filter((y) => y in p),
@@ -853,7 +885,7 @@ const Z = ["id", "documentId", "locale"], S = [
         crossLocaleFields: D,
         unsupportedFields: T,
         brokenRelations: A,
-        missingMedia: F,
+        missingMedia: N,
         affectedLocales: V.map((y) => y.code)
       };
     },
@@ -863,7 +895,7 @@ const Z = ["id", "documentId", "locale"], S = [
      * The document lands in "modified" and publishing stays a deliberate act -
      * restoring must never change what the public sees on its own.
      */
-    async apply(s, i) {
+    async apply(s, r) {
       const c = await n(s), l = c.contentType, d = await this.preview(s), p = [];
       await e.plugin("rewind").service("snapshot").capture(
         {
@@ -873,7 +905,7 @@ const Z = ["id", "documentId", "locale"], S = [
           origin: "restore",
           before: null
         },
-        i
+        r
       );
       const b = {}, m = c.data ?? {}, u = c.relations ?? {};
       for (const f of d.fieldsToRestore)
@@ -910,21 +942,22 @@ const Z = ["id", "documentId", "locale"], S = [
       }), { documentId: c.relatedDocumentId, warnings: p };
     }
   };
-}, Ve = {
+}, Xe = {
   snapshot: ie,
-  restore: Ge,
+  restore: Ve,
   diff: Be,
-  retention: Ke,
-  lock: Le
-}, Je = {
+  retention: Ge,
+  lock: Le,
+  pin: ze
+}, Qe = {
   bootstrap: me,
   destroy: Se,
   config: we,
-  contentTypes: Oe,
+  contentTypes: ke,
   controllers: Re,
-  routes: Fe,
-  services: Ve
+  routes: Ne,
+  services: Xe
 };
 export {
-  Je as default
+  Qe as default
 };