@qkix/strapi-plugin-rewind 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 qkix
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,182 @@
+# Rewind
+
+Document version history for Strapi 5. Every save is snapshotted, and any
+snapshot can be put back.
+
+<img src="https://raw.githubusercontent.com/qkix/strapi-plugins/main/packages/strapi-plugin-rewind/docs/edit-view.png" alt="The history panel beside a document in the Strapi edit view" width="900" />
+
+The panel sits in the edit view, next to the document it belongs to. Each entry
+is a point you can go back to: what the document said, when, and who saved it.
+
+## What this is, and what it is not
+
+Strapi sells a feature called **Content History** on its Growth and Enterprise
+plans. Rewind is **not that feature**, is not a drop-in replacement for it, and
+does not unlock it.
+
+It is the poor cousin. If you pay for Growth, use Strapi's — it is deeper, it is
+supported by the people who wrote the CMS, and it will stay in step with Strapi
+in a way a third-party plugin cannot promise. Rewind exists for everyone on
+Community Edition, who today has nothing at all: no way to see what a document
+said last Tuesday, and no way to get it back after someone pastes over it.
+
+A few things it does that the paid feature does not, mostly because they were
+cheap to add once the plumbing existed:
+
+- **Restoring keeps fields that were added after the version was taken.**
+  Strapi's restore sets them to `null`, which quietly loses whatever was in
+  them.
+- **Discarding a draft is recorded before the draft is gone**, so the work you
+  threw away is still recoverable. A snapshot taken afterwards can only ever
+  contain the published copy you already had.
+- **A save that changed nothing does not create a version.** Strapi writes a row
+  either way.
+- **The schema snapshot descends into nested components.** Strapi's stops one
+  level down and carries an open TODO about it.
+- **Writes from outside the Content Manager can be versioned** (opt-in), where
+  Strapi only ever records admin-panel edits.
+
+And a good deal it does _not_ do — see [Limits](#limits).
+
+### On not touching the paywall
+
+Rewind never reads or writes `strapi.ee`, never inspects a licence, and never
+enables a gated feature. It is an independent implementation writing to its own
+table, and it works the same whether or not you have a Strapi licence. Strapi's
+history code is MIT-licensed and was read while working out what the problem
+actually is — the way you would read any open-source implementation before
+writing your own — but the code here is written for this plugin.
+
+## Install
+
+```bash
+npm install @qkix/strapi-plugin-rewind
+```
+
+```ts
+// config/plugins.ts
+export default {
+  rewind: {
+    enabled: true,
+    config: {
+      // Nothing is tracked until you say so.
+      contentTypes: ['api::article.article'],
+    },
+  },
+};
+```
+
+That empty default is deliberate. A plugin that starts writing a database row on
+every save the moment it is installed is a plugin that gets uninstalled after
+the first disk alert.
+
+## What gets recorded
+
+Six actions on a tracked content type: `create`, `update`, `clone`, `publish`,
+`unpublish` and `discardDraft`. Each version stores the document's content, its
+relations, and a snapshot of the schema at the time — the last of which is what
+lets a restore tell "this field was empty" apart from "this field did not exist
+yet".
+
+Publishing records **one** version, not two, even though the Content Manager
+saves the draft and publishes it as two separate operations.
+
+A save that is rolled back records nothing.
+
+<img src="https://raw.githubusercontent.com/qkix/strapi-plugins/main/packages/strapi-plugin-rewind/docs/panel.png" alt="History entries labelled Replaced by restore, Draft discarded and Edited" width="320" />
+
+The badge says what happened to the document. **Replaced by restore** marks the
+state a restore was about to overwrite — the undo point for that restore.
+
+## Restoring
+
+<img src="https://raw.githubusercontent.com/qkix/strapi-plugins/main/packages/strapi-plugin-rewind/docs/restore.png" alt="The restore confirmation dialog" width="400" />
+
+Restore writes to the **draft only**. The document moves to _Modified_, and
+publishing stays something a person decides to do.
+
+Before anything is written, the state being replaced is itself recorded, so a
+restore can always be undone.
+
+The panel shows a preview before asking you to confirm, because the interesting
+part of a restore is what it will _not_ do:
+
+- fields not present in that version keep their current values
+- fields no longer in the model are skipped
+- links to documents or media that have since been deleted are dropped, and
+  reported
+- **fields that are not translated per locale change in every locale at once** —
+  restoring the Polish version of a document rewrites a shared field for every
+  other language too. This is not a choice the plugin makes; a non-localised
+  field physically has one value. The dialog names those fields and counts the
+  locales before you commit.
+
+## Seeing what changed
+
+Every entry in the panel has a **What changed** link, comparing that version
+with the one saved immediately before it.
+
+<img src="https://raw.githubusercontent.com/qkix/strapi-plugins/main/packages/strapi-plugin-rewind/docs/changes.png" alt="A word-level diff: 'put back' struck through and replaced by 'restored in one click', and 'ten' by 'twelve'" width="760" />
+
+Scalars are shown as a plain before and after. Prose — including rich text
+stored as JSON — is compared word by word, with the unchanged stretches
+collapsed, so a one-word edit in a long article reads as one word rather than
+as the whole article with something green in it somewhere. Relations are
+reported as linked and unlinked.
+
+Where a field's stored value changed but its readable text did not — a mark
+applied, blocks reordered — it says so, rather than showing an empty diff.
+
+### Rendering a field type properly
+
+Pulling the words out of a rich-text field tells an editor _that_ a paragraph
+changed, and nothing about a block moving or an image being swapped. Only the
+package that owns the format can show that, so the mapping is a registry:
+
+```ts
+import { registerDiffRenderer } from '@qkix/strapi-plugin-rewind/strapi-admin';
+
+registerDiffRenderer('plugin::better-blocks.better-blocks', BlocksDiff);
+```
+
+Keyed by a custom field's uid, or by an attribute `type`. A uid wins over a
+type, since every custom field stores itself as `json`.
+
+## Configuration
+
+| Option           | Default | Meaning                                                                                                         |
+| ---------------- | ------- | --------------------------------------------------------------------------------------------------------------- |
+| `contentTypes`   | `[]`    | Which content types to version. Empty means none.                                                               |
+| `trackApiWrites` | `false` | Also version writes from outside the Content Manager (REST, GraphQL, programmatic). `userId` is null for those. |
+
+## Limits
+
+Worth knowing before you install it, not after:
+
+- **Polymorphic relations are skipped**, and reported as unsupported in the
+  restore preview rather than silently mangled.
+- **Only the Document Service is visible.** Writes made through
+  `strapi.db.query()` or the legacy entity service bypass the middleware
+  entirely and cannot be captured at any setting.
+- **Nothing pins a version from the panel yet.** The column is there and prune
+  honours it, but there is no button; pin by setting `pinned` on the row.
+- **Deleted relation targets lose their names.** A version stores which document
+  a relation pointed at, not what it was called, so a link to something since
+  deleted shows as missing rather than as "the article it used to be".
+- **Media is referenced, never copied.** Delete the file and the version knows
+  the file is gone; it cannot bring it back.
+
+## Keeping your history when the plugin is off
+
+Strapi's schema sync drops tables belonging to content types it no longer sees.
+Disable this plugin for a single boot and the history would go with it — so on
+boot Rewind adds its table to Strapi's `persisted_tables` list, which is the
+same mechanism Strapi uses to protect its own. Nothing to configure.
+
+## Requirements
+
+Strapi 5, Node 20 or 22.
+
+## License
+
+MIT.

package/dist/_chunks/en-BHfx2OWt.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e={"plugin.name":"Rewind","panel.title":"History"};exports.default=e;

package/dist/_chunks/en-DCctmu-a.mjs

@@ -0,0 +1,7 @@
+const e = {
+  "plugin.name": "Rewind",
+  "panel.title": "History"
+};
+export {
+  e as default
+};

package/dist/admin/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}});const e=require("react/jsx-runtime"),q=require("react"),E=require("@strapi/admin/strapi-admin"),t=require("@strapi/design-system");function H(n){if(n&&n.__esModule)return n;const r=Object.create(null,{[Symbol.toStringTag]:{value:"Module"}});if(n){for(const i in n)if(i!=="default"){const a=Object.getOwnPropertyDescriptor(n,i);Object.defineProperty(r,i,a.get?a:{enumerable:!0,get:()=>n[i]})}}return r.default=n,Object.freeze(r)}const l=H(q),G=(n,r,i)=>{const a=n[r];return a?typeof a=="function"?a():Promise.resolve(a):new Promise((j,d)=>{(typeof queueMicrotask=="function"?queueMicrotask:setTimeout)(d.bind(null,new Error("Unknown variable dynamic import: "+r+(r.split("/").length!==i?". Note that variables only represent file names one level deep.":""))))})},D=new Map,W=(n,r)=>{D.set(n,r)},b=n=>D.get(n),z=({spans:n})=>e.jsx(t.Typography,{variant:"omega",tag:"p",children:n.map((r,i)=>r.op==="equal"?e.jsx(t.Typography,{variant:"omega",textColor:"neutral600",children:r.value},i):e.jsx(t.Typography,{variant:"omega",textColor:r.op==="added"?"success600":"danger600",style:r.op==="removed"?{textDecoration:"line-through"}:{fontWeight:600},children:r.value},i))}),S=n=>n==null||n===""?"(empty)":typeof n=="object"?JSON.stringify(n):String(n),U=({change:n})=>{const r=(n.customField?b(n.customField):void 0)??b(n.type);return r?e.jsx(r,{change:n}):n.spans?e.jsx(z,{spans:n.spans}):n.linked||n.unlinked?e.jsxs(t.Flex,{direction:"column",alignItems:"flex-start",gap:1,children:[n.linked?.length?e.jsxs(t.Typography,{variant:"pi",textColor:"success600",children:["+ ",n.linked.length," linked"]}):null,n.unlinked?.length?e.jsxs(t.Typography,{variant:"pi",textColor:"danger600",children:["− ",n.unlinked.length," unlinked"]}):null]}):n.before!==void 0||n.after!==void 0?e.jsxs(t.Flex,{gap:2,alignItems:"center",wrap:"wrap",children:[e.jsx(t.Typography,{variant:"omega",textColor:"danger600",style:{textDecoration:"line-through"},children:S(n.before)}),e.jsx(t.Typography,{variant:"omega",textColor:"neutral500",children:"→"}),e.jsx(t.Typography,{variant:"omega",textColor:"success600",children:S(n.after)})]}):e.jsx(t.Typography,{variant:"pi",textColor:"neutral600",children:"Formatting or structure changed; the text is the same."})},K=({diff:n,loading:r,onClose:i})=>e.jsx(t.Modal.Root,{open:!0,onOpenChange:i,children:e.jsxs(t.Modal.Content,{children:[e.jsx(t.Modal.Header,{children:e.jsx(t.Modal.Title,{children:"What changed"})}),e.jsx(t.Modal.Body,{children:r?e.jsx(t.Flex,{justifyContent:"center",padding:4,children:e.jsx(t.Loader,{small:!0,children:"Comparing"})}):n?e.jsxs(t.Flex,{direction:"column",alignItems:"stretch",gap:4,children:[e.jsx(t.Typography,{variant:"pi",textColor:"neutral600",children:n.from?"Compared with the version saved just before it.":"This is the earliest version of the document, so everything in it is new."}),n.identical?e.jsx(t.Typography,{textColor:"neutral600",children:"Nothing changed between these two versions."}):n.changes.map(a=>e.jsxs(t.Box,{children:[e.jsx(t.Typography,{variant:"sigma",textColor:"neutral600",children:a.field}),e.jsx(t.Box,{paddingTop:1,children:e.jsx(U,{change:a})})]},a.field))]}):e.jsx(t.Typography,{textColor:"danger600",children:"Could not compare these versions."})}),e.jsx(t.Modal.Footer,{children:e.jsx(t.Button,{variant:"tertiary",onClick:i,children:"Close"})})]})}),u="rewind",V={create:"Created",update:"Edited",clone:"Cloned",publish:"Published",unpublish:"Unpublished",discardDraft:"Draft discarded",restore:"Replaced by restore"},k=new Set(["publish","unpublish","discardDraft","restore"]),J=10,Z=n=>{const r=new Date(n),i=Math.round((Date.now()-r.getTime())/6e4);return i<1?"just now":i<60?`${i} min ago`:i<60*24?`${Math.round(i/60)} h ago`:r.toLocaleString()},Q=({model:n,documentId:r,updatedAt:i})=>{const{get:a,post:j}=E.useFetchClient(),[d,R]=l.useState([]),[F,I]=l.useState(0),[B,L]=l.useState(1),[f,m]=l.useState(!0),[h,p]=l.useState(null),[o,g]=l.useState(null),[v,C]=l.useState(!1),[M,w]=l.useState(!1),[P,x]=l.useState(null),[O,T]=l.useState(!1),y=l.useCallback(async s=>{m(!0),p(null);try{const{data:c}=await a(`/${u}/versions`,{params:{contentType:n,documentId:r,page:s,pageSize:J}});R(A=>s===1?c.data:[...A,...c.data]),I(c.meta.total),L(s)}catch{p("Could not load the history for this document.")}finally{m(!1)}},[a,n,r]);l.useEffect(()=>{y(1)},[y,i]);const _=async s=>{w(!0),T(!0),x(null);try{const{data:c}=await a(`/${u}/versions/${s.id}/diff`);x(c.data)}catch{x(null)}finally{T(!1)}},N=async s=>{try{const{data:c}=await a(`/${u}/versions/${s.id}/preview`);g({version:s,preview:c.data})}catch{p("Could not work out what restoring this version would change.")}},$=async()=>{if(o){C(!0);try{await j(`/${u}/versions/${o.version.id}/restore`,{}),window.location.reload()}catch{p("The restore failed. Nothing was changed."),C(!1),g(null)}}};return f&&d.length===0?e.jsx(t.Flex,{justifyContent:"center",padding:4,children:e.jsx(t.Loader,{small:!0,children:"Loading history"})}):h&&d.length===0?e.jsx(t.Typography,{variant:"pi",textColor:"danger600",children:h}):d.length===0?e.jsx(t.Typography,{variant:"pi",textColor:"neutral600",children:"No versions yet. The next time this document is saved, a version will appear here."}):e.jsxs(t.Flex,{direction:"column",alignItems:"stretch",gap:2,width:"100%",children:[d.map(s=>e.jsxs(t.Box,{paddingBottom:2,children:[e.jsxs(t.Flex,{justifyContent:"space-between",alignItems:"center",gap:2,children:[e.jsxs(t.Flex,{direction:"column",alignItems:"flex-start",gap:1,grow:1,minWidth:0,children:[e.jsxs(t.Flex,{gap:2,alignItems:"center",children:[e.jsx(t.Badge,{backgroundColor:k.has(s.origin)?"primary100":"neutral150",textColor:k.has(s.origin)?"primary600":"neutral600",children:V[s.origin]??s.origin}),s.locale?e.jsx(t.Typography,{variant:"pi",textColor:"neutral500",children:s.locale}):null]}),s.label?e.jsx(t.Box,{width:"100%",children:e.jsx(t.Typography,{variant:"omega",textColor:"neutral800",ellipsis:!0,children:s.label})}):null,e.jsxs(t.Typography,{variant:"pi",textColor:"neutral600",children:[Z(s.createdAt),s.user?` · ${s.user.name}`:""]}),e.jsx(t.TextButton,{onClick:()=>_(s),children:"What changed"})]}),e.jsx(t.Box,{shrink:0,children:e.jsx(t.Button,{size:"S",variant:"tertiary",onClick:()=>N(s),children:"Restore"})})]}),e.jsx(t.Box,{paddingTop:2,children:e.jsx(t.Divider,{})})]},s.id)),d.length<F?e.jsx(t.Button,{size:"S",variant:"tertiary",loading:f,onClick:()=>y(B+1),children:"Show older versions"}):null,h?e.jsx(t.Typography,{variant:"pi",textColor:"danger600",children:h}):null,M?e.jsx(K,{diff:P,loading:O,onClose:()=>w(!1)}):null,e.jsx(t.Dialog.Root,{open:o!==null,onOpenChange:()=>g(null),children:e.jsxs(t.Dialog.Content,{children:[e.jsx(t.Dialog.Header,{children:"Restore this version?"}),e.jsx(t.Dialog.Body,{children:e.jsxs(t.Flex,{direction:"column",alignItems:"flex-start",gap:2,children:[e.jsx(t.Typography,{children:"The current draft is saved as a version first, so this can be undone. The published version is not touched."}),o?.preview.crossLocaleFields.length?e.jsxs(t.Typography,{textColor:"danger600",children:[o.preview.crossLocaleFields.join(", ")," ",o.preview.crossLocaleFields.length===1?"is":"are"," not translated per locale, so restoring"," ",o.preview.crossLocaleFields.length===1?"it":"them"," changes"," ",o.preview.affectedLocales.length," locales at once:"," ",o.preview.affectedLocales.join(", "),"."]}):null,o?.preview.fieldsKeptAsIs.length?e.jsxs(t.Typography,{variant:"pi",textColor:"neutral600",children:["Added since this version and left untouched:"," ",o.preview.fieldsKeptAsIs.join(", "),"."]}):null,o?.preview.fieldsDropped.length?e.jsxs(t.Typography,{variant:"pi",textColor:"neutral600",children:["No longer in the model and skipped: ",o.preview.fieldsDropped.join(", "),"."]}):null,o?.preview.brokenRelations.length||o?.preview.missingMedia.length?e.jsxs(t.Typography,{variant:"pi",textColor:"warning600",children:[(o.preview.brokenRelations.length??0)+(o.preview.missingMedia.length??0)," ","linked item(s) no longer exist and will be left out."]}):null]})}),e.jsxs(t.Dialog.Footer,{children:[e.jsx(t.Dialog.Cancel,{children:e.jsx(t.Button,{variant:"tertiary",disabled:v,children:"Cancel"})}),e.jsx(t.Button,{onClick:$,loading:v,children:"Restore"})]})]})})]})},X=({model:n,documentId:r,document:i})=>r?{title:"History",content:e.jsx(Q,{model:n,documentId:r,updatedAt:i?.updatedAt})}:null,Y={register(n){n.registerPlugin({id:u,name:u,isReady:!0})},bootstrap(n){n.getPlugin("content-manager").apis.addEditViewSidePanel([X])},async registerTrads({locales:n}){return Promise.all(n.map(async r=>{try{const{default:i}=await G(Object.assign({"./translations/en.json":()=>Promise.resolve().then(()=>require("../_chunks/en-BHfx2OWt.js"))}),`./translations/${r}.json`,3);return{data:i,locale:r}}catch{return{data:{},locale:r}}}))}};exports.PLUGIN_ID=u;exports.default=Y;exports.registerDiffRenderer=W;

package/dist/admin/index.mjs

@@ -0,0 +1,254 @@
+import { jsx as t, jsxs as o } from "react/jsx-runtime";
+import * as d from "react";
+import { useFetchClient as K } from "@strapi/admin/strapi-admin";
+import { Modal as g, Flex as c, Loader as $, Typography as r, Box as f, Button as v, Badge as V, TextButton as J, Divider as Z, Dialog as p } from "@strapi/design-system";
+const Q = (e, n, a) => {
+  const s = e[n];
+  return s ? typeof s == "function" ? s() : Promise.resolve(s) : new Promise((k, u) => {
+    (typeof queueMicrotask == "function" ? queueMicrotask : setTimeout)(
+      u.bind(
+        null,
+        new Error(
+          "Unknown variable dynamic import: " + n + (n.split("/").length !== a ? ". Note that variables only represent file names one level deep." : "")
+        )
+      )
+    );
+  });
+}, N = /* @__PURE__ */ new Map(), de = (e, n) => {
+  N.set(e, n);
+}, L = (e) => N.get(e), X = ({ spans: e }) => /* @__PURE__ */ t(r, { variant: "omega", tag: "p", children: e.map((n, a) => n.op === "equal" ? /* @__PURE__ */ t(r, { variant: "omega", textColor: "neutral600", children: n.value }, a) : /* @__PURE__ */ t(
+  r,
+  {
+    variant: "omega",
+    textColor: n.op === "added" ? "success600" : "danger600",
+    style: n.op === "removed" ? { textDecoration: "line-through" } : { fontWeight: 600 },
+    children: n.value
+  },
+  a
+)) }), F = (e) => e == null || e === "" ? "(empty)" : typeof e == "object" ? JSON.stringify(e) : String(e), Y = ({ change: e }) => {
+  const n = (e.customField ? L(e.customField) : void 0) ?? L(e.type);
+  return n ? /* @__PURE__ */ t(n, { change: e }) : e.spans ? /* @__PURE__ */ t(X, { spans: e.spans }) : e.linked || e.unlinked ? /* @__PURE__ */ o(c, { direction: "column", alignItems: "flex-start", gap: 1, children: [
+    e.linked?.length ? /* @__PURE__ */ o(r, { variant: "pi", textColor: "success600", children: [
+      "+ ",
+      e.linked.length,
+      " linked"
+    ] }) : null,
+    e.unlinked?.length ? /* @__PURE__ */ o(r, { variant: "pi", textColor: "danger600", children: [
+      "− ",
+      e.unlinked.length,
+      " unlinked"
+    ] }) : null
+  ] }) : e.before !== void 0 || e.after !== void 0 ? /* @__PURE__ */ o(c, { gap: 2, alignItems: "center", wrap: "wrap", children: [
+    /* @__PURE__ */ t(
+      r,
+      {
+        variant: "omega",
+        textColor: "danger600",
+        style: { textDecoration: "line-through" },
+        children: F(e.before)
+      }
+    ),
+    /* @__PURE__ */ t(r, { variant: "omega", textColor: "neutral500", children: "→" }),
+    /* @__PURE__ */ t(r, { variant: "omega", textColor: "success600", children: F(e.after) })
+  ] }) : /* @__PURE__ */ t(r, { variant: "pi", textColor: "neutral600", children: "Formatting or structure changed; the text is the same." });
+}, ee = ({
+  diff: e,
+  loading: n,
+  onClose: a
+}) => /* @__PURE__ */ t(g.Root, { open: !0, onOpenChange: a, children: /* @__PURE__ */ o(g.Content, { children: [
+  /* @__PURE__ */ t(g.Header, { children: /* @__PURE__ */ t(g.Title, { children: "What changed" }) }),
+  /* @__PURE__ */ t(g.Body, { children: n ? /* @__PURE__ */ t(c, { justifyContent: "center", padding: 4, children: /* @__PURE__ */ t($, { small: !0, children: "Comparing" }) }) : e ? /* @__PURE__ */ o(c, { direction: "column", alignItems: "stretch", gap: 4, children: [
+    /* @__PURE__ */ t(r, { variant: "pi", textColor: "neutral600", children: e.from ? "Compared with the version saved just before it." : "This is the earliest version of the document, so everything in it is new." }),
+    e.identical ? /* @__PURE__ */ t(r, { textColor: "neutral600", children: "Nothing changed between these two versions." }) : e.changes.map((s) => /* @__PURE__ */ o(f, { children: [
+      /* @__PURE__ */ t(r, { variant: "sigma", textColor: "neutral600", children: s.field }),
+      /* @__PURE__ */ t(f, { paddingTop: 1, children: /* @__PURE__ */ t(Y, { change: s }) })
+    ] }, s.field))
+  ] }) : /* @__PURE__ */ t(r, { textColor: "danger600", children: "Could not compare these versions." }) }),
+  /* @__PURE__ */ t(g.Footer, { children: /* @__PURE__ */ t(v, { variant: "tertiary", onClick: a, children: "Close" }) })
+] }) }), m = "rewind", te = {
+  create: "Created",
+  update: "Edited",
+  clone: "Cloned",
+  publish: "Published",
+  unpublish: "Unpublished",
+  discardDraft: "Draft discarded",
+  restore: "Replaced by restore"
+}, P = /* @__PURE__ */ new Set(["publish", "unpublish", "discardDraft", "restore"]), ne = 10, re = (e) => {
+  const n = new Date(e), a = Math.round((Date.now() - n.getTime()) / 6e4);
+  return a < 1 ? "just now" : a < 60 ? `${a} min ago` : a < 60 * 24 ? `${Math.round(a / 60)} h ago` : n.toLocaleString();
+}, ie = ({
+  model: e,
+  documentId: n,
+  /**
+   * Changes whenever the Content Manager re-reads the document, which is what
+   * it does after a save. Used purely as a refresh signal: without it the panel
+   * fetches once on mount and then quietly goes stale, so the version you just
+   * created by saving does not show up until the page is reloaded.
+   */
+  updatedAt: a
+}) => {
+  const { get: s, post: k } = K(), [u, A] = d.useState([]), [O, B] = d.useState(0), [E, M] = d.useState(1), [S, R] = d.useState(!0), [C, w] = d.useState(null), [l, y] = d.useState(null), [T, D] = d.useState(!1), [_, I] = d.useState(!1), [H, x] = d.useState(null), [W, j] = d.useState(!1), b = d.useCallback(
+    async (i) => {
+      R(!0), w(null);
+      try {
+        const { data: h } = await s(`/${m}/versions`, {
+          params: {
+            contentType: e,
+            documentId: n,
+            page: i,
+            pageSize: ne
+          }
+        });
+        A((U) => i === 1 ? h.data : [...U, ...h.data]), B(h.meta.total), M(i);
+      } catch {
+        w("Could not load the history for this document.");
+      } finally {
+        R(!1);
+      }
+    },
+    [s, e, n]
+  );
+  d.useEffect(() => {
+    b(1);
+  }, [b, a]);
+  const G = async (i) => {
+    I(!0), j(!0), x(null);
+    try {
+      const { data: h } = await s(
+        `/${m}/versions/${i.id}/diff`
+      );
+      x(h.data);
+    } catch {
+      x(null);
+    } finally {
+      j(!1);
+    }
+  }, q = async (i) => {
+    try {
+      const { data: h } = await s(
+        `/${m}/versions/${i.id}/preview`
+      );
+      y({ version: i, preview: h.data });
+    } catch {
+      w("Could not work out what restoring this version would change.");
+    }
+  }, z = async () => {
+    if (l) {
+      D(!0);
+      try {
+        await k(`/${m}/versions/${l.version.id}/restore`, {}), window.location.reload();
+      } catch {
+        w("The restore failed. Nothing was changed."), D(!1), y(null);
+      }
+    }
+  };
+  return S && u.length === 0 ? /* @__PURE__ */ t(c, { justifyContent: "center", padding: 4, children: /* @__PURE__ */ t($, { small: !0, children: "Loading history" }) }) : C && u.length === 0 ? /* @__PURE__ */ t(r, { variant: "pi", textColor: "danger600", children: C }) : u.length === 0 ? /* @__PURE__ */ t(r, { variant: "pi", textColor: "neutral600", children: "No versions yet. The next time this document is saved, a version will appear here." }) : /* @__PURE__ */ o(c, { direction: "column", alignItems: "stretch", gap: 2, width: "100%", children: [
+    u.map((i) => /* @__PURE__ */ o(f, { paddingBottom: 2, children: [
+      /* @__PURE__ */ o(c, { justifyContent: "space-between", alignItems: "center", gap: 2, children: [
+        /* @__PURE__ */ o(c, { direction: "column", alignItems: "flex-start", gap: 1, grow: 1, minWidth: 0, children: [
+          /* @__PURE__ */ o(c, { gap: 2, alignItems: "center", children: [
+            /* @__PURE__ */ t(
+              V,
+              {
+                backgroundColor: P.has(i.origin) ? "primary100" : "neutral150",
+                textColor: P.has(i.origin) ? "primary600" : "neutral600",
+                children: te[i.origin] ?? i.origin
+              }
+            ),
+            i.locale ? /* @__PURE__ */ t(r, { variant: "pi", textColor: "neutral500", children: i.locale }) : null
+          ] }),
+          i.label ? /* @__PURE__ */ t(f, { width: "100%", children: /* @__PURE__ */ t(r, { variant: "omega", textColor: "neutral800", ellipsis: !0, children: i.label }) }) : null,
+          /* @__PURE__ */ o(r, { variant: "pi", textColor: "neutral600", children: [
+            re(i.createdAt),
+            i.user ? ` · ${i.user.name}` : ""
+          ] }),
+          /* @__PURE__ */ t(J, { onClick: () => G(i), children: "What changed" })
+        ] }),
+        /* @__PURE__ */ t(f, { shrink: 0, children: /* @__PURE__ */ t(v, { size: "S", variant: "tertiary", onClick: () => q(i), children: "Restore" }) })
+      ] }),
+      /* @__PURE__ */ t(f, { paddingTop: 2, children: /* @__PURE__ */ t(Z, {}) })
+    ] }, i.id)),
+    u.length < O ? /* @__PURE__ */ t(v, { size: "S", variant: "tertiary", loading: S, onClick: () => b(E + 1), children: "Show older versions" }) : null,
+    C ? /* @__PURE__ */ t(r, { variant: "pi", textColor: "danger600", children: C }) : null,
+    _ ? /* @__PURE__ */ t(
+      ee,
+      {
+        diff: H,
+        loading: W,
+        onClose: () => I(!1)
+      }
+    ) : null,
+    /* @__PURE__ */ t(p.Root, { open: l !== null, onOpenChange: () => y(null), children: /* @__PURE__ */ o(p.Content, { children: [
+      /* @__PURE__ */ t(p.Header, { children: "Restore this version?" }),
+      /* @__PURE__ */ t(p.Body, { children: /* @__PURE__ */ o(c, { direction: "column", alignItems: "flex-start", gap: 2, children: [
+        /* @__PURE__ */ t(r, { children: "The current draft is saved as a version first, so this can be undone. The published version is not touched." }),
+        l?.preview.crossLocaleFields.length ? /* @__PURE__ */ o(r, { textColor: "danger600", children: [
+          l.preview.crossLocaleFields.join(", "),
+          " ",
+          l.preview.crossLocaleFields.length === 1 ? "is" : "are",
+          " not translated per locale, so restoring",
+          " ",
+          l.preview.crossLocaleFields.length === 1 ? "it" : "them",
+          " changes",
+          " ",
+          l.preview.affectedLocales.length,
+          " locales at once:",
+          " ",
+          l.preview.affectedLocales.join(", "),
+          "."
+        ] }) : null,
+        l?.preview.fieldsKeptAsIs.length ? /* @__PURE__ */ o(r, { variant: "pi", textColor: "neutral600", children: [
+          "Added since this version and left untouched:",
+          " ",
+          l.preview.fieldsKeptAsIs.join(", "),
+          "."
+        ] }) : null,
+        l?.preview.fieldsDropped.length ? /* @__PURE__ */ o(r, { variant: "pi", textColor: "neutral600", children: [
+          "No longer in the model and skipped: ",
+          l.preview.fieldsDropped.join(", "),
+          "."
+        ] }) : null,
+        l?.preview.brokenRelations.length || l?.preview.missingMedia.length ? /* @__PURE__ */ o(r, { variant: "pi", textColor: "warning600", children: [
+          (l.preview.brokenRelations.length ?? 0) + (l.preview.missingMedia.length ?? 0),
+          " ",
+          "linked item(s) no longer exist and will be left out."
+        ] }) : null
+      ] }) }),
+      /* @__PURE__ */ o(p.Footer, { children: [
+        /* @__PURE__ */ t(p.Cancel, { children: /* @__PURE__ */ t(v, { variant: "tertiary", disabled: T, children: "Cancel" }) }),
+        /* @__PURE__ */ t(v, { onClick: z, loading: T, children: "Restore" })
+      ] })
+    ] }) })
+  ] });
+}, oe = ({
+  model: e,
+  documentId: n,
+  document: a
+}) => n ? {
+  title: "History",
+  content: /* @__PURE__ */ t(ie, { model: e, documentId: n, updatedAt: a?.updatedAt })
+} : null, ce = {
+  register(e) {
+    e.registerPlugin({ id: m, name: m, isReady: !0 });
+  },
+  bootstrap(e) {
+    e.getPlugin("content-manager").apis.addEditViewSidePanel([oe]);
+  },
+  async registerTrads({ locales: e }) {
+    return Promise.all(
+      e.map(async (n) => {
+        try {
+          const { default: a } = await Q(/* @__PURE__ */ Object.assign({ "./translations/en.json": () => import("../_chunks/en-DCctmu-a.mjs") }), `./translations/${n}.json`, 3);
+          return { data: a, locale: n };
+        } catch {
+          return { data: {}, locale: n };
+        }
+      })
+    );
+  }
+};
+export {
+  m as PLUGIN_ID,
+  ce as default,
+  de as registerDiffRenderer
+};

package/dist/admin/src/components/ChangesDialog.d.ts

@@ -0,0 +1,21 @@
+import * as React from 'react';
+import { type FieldChange } from '../diffRegistry';
+export interface VersionDiff {
+    from: {
+        id: number;
+        label: string | null;
+        origin: string;
+    } | null;
+    to: {
+        id: number;
+        label: string | null;
+        origin: string;
+    };
+    changes: FieldChange[];
+    identical: boolean;
+}
+export declare const ChangesDialog: ({ diff, loading, onClose, }: {
+    diff: VersionDiff | null;
+    loading: boolean;
+    onClose: () => void;
+}) => React.JSX.Element;

package/dist/admin/src/components/HistoryPanel.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+/**
+ * The panel itself.
+ *
+ * Returning null while there is no `documentId` keeps it out of the way on the
+ * create screen, where there is nothing to have a history of yet.
+ */
+export declare const HistoryPanel: ({ model, documentId, document, }: {
+    model: string;
+    documentId?: string;
+    document?: {
+        updatedAt?: string;
+    };
+}) => {
+    title: string;
+    content: React.JSX.Element;
+} | null;

package/dist/admin/src/diffRegistry.d.ts

@@ -0,0 +1,45 @@
+import type * as React from 'react';
+export type DiffOp = 'equal' | 'added' | 'removed';
+export interface DiffSpan {
+    op: DiffOp;
+    value: string;
+}
+export interface FieldChange {
+    field: string;
+    type: string;
+    /** Set when the attribute is a custom field; more specific than `type`. */
+    customField?: string;
+    kind: 'added' | 'removed' | 'changed';
+    before?: unknown;
+    after?: unknown;
+    spans?: DiffSpan[];
+    linked?: {
+        documentId?: string;
+        id?: number;
+        targetUid: string;
+    }[];
+    unlinked?: {
+        documentId?: string;
+        id?: number;
+        targetUid: string;
+    }[];
+}
+export type DiffRenderer = React.ComponentType<{
+    change: FieldChange;
+}>;
+/**
+ * Lets another package render the diff for its own field type.
+ *
+ * Rewind compares a rich-text field by pulling the readable words out of the
+ * JSON, which tells an editor *that* a paragraph changed but nothing about
+ * blocks moving, an image being swapped, or a table gaining a row. The package
+ * that owns the field format is the only one that can show that properly, so
+ * the type-to-component mapping is a registry rather than a switch:
+ *
+ *   import { registerDiffRenderer } from '@qkix/strapi-plugin-rewind/strapi-admin';
+ *   registerDiffRenderer('plugin::better-blocks.better-blocks', BlocksDiff);
+ *
+ * Keyed by the attribute's `type`, or by a custom field's uid.
+ */
+export declare const registerDiffRenderer: (type: string, renderer: DiffRenderer) => void;
+export declare const getDiffRenderer: (type: string) => DiffRenderer | undefined;

package/dist/admin/src/index.d.ts

@@ -0,0 +1,18 @@
+declare const _default: {
+    register(app: any): void;
+    bootstrap(app: any): void;
+    registerTrads({ locales }: {
+        locales: string[];
+    }): Promise<{
+        data: any;
+        locale: string;
+    }[]>;
+};
+export default _default;
+export { PLUGIN_ID } from './pluginId';
+/**
+ * The hook a package owning a field format uses to render its own diff — see
+ * diffRegistry for why this is a registry and not a switch.
+ */
+export { registerDiffRenderer } from './diffRegistry';
+export type { DiffRenderer, FieldChange, DiffSpan } from './diffRegistry';

package/dist/admin/src/pluginId.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Stored in nothing user-facing yet, but the same rule applies as to any plugin
+ * id: it appears in route paths and permission names, so changing it later
+ * breaks installs rather than merely renaming a thing.
+ */
+export declare const PLUGIN_ID = "rewind";