Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
266 commits
Select commit Hold shift + click to select a range
514d2ff
test(admin): add frontend component tests and fix the bugs they found
xiaodoudou Oct 1, 2026
c2f2d60
docs: refactor the docs to one source of truth per topic, checked aga…
xiaodoudou Oct 1, 2026
4b30452
fix: fix every bug from the documentation review and test every compo…
xiaodoudou Oct 1, 2026
86f256a
feat(logs): colorize the console logs, also on the System log page
xiaodoudou Oct 1, 2026
02721a4
feat(security)!: turn every protection on by default, and rewrite the…
xiaodoudou Oct 1, 2026
41c3a31
ci: remove the CI warnings and fix the two bugs they hid
xiaodoudou Oct 1, 2026
e5e9034
feat(storage): add LevelDB and SQLite stores beside the JSON file, Mo…
xiaodoudou Oct 1, 2026
48ec8d4
chore(release): 3.0.0, under the GNU GPL version 3 only
xiaodoudou Oct 1, 2026
0cc4e60
fix(fields): set autocomplete to nope so Brave stops offering an emai…
xiaodoudou Oct 1, 2026
9714051
feat(admin): flat redesign of the object and list editor
xiaodoudou Oct 1, 2026
8507fc0
feat(admin): remove the Cms Config page and list Syslog in the CMS menu
xiaodoudou Oct 1, 2026
55e2485
fix(logs): keep a very long log from filling the disk, the memory or …
xiaodoudou Oct 1, 2026
7924dc8
feat(admin): softer login page that follows the system theme
xiaodoudou Oct 1, 2026
19a4eb9
fix(admin): show live network traffic in the System card, not the tot…
xiaodoudou Oct 1, 2026
cd91849
fix(admin): keep Tab inside the omnibar switcher
xiaodoudou Oct 1, 2026
96557bb
fix(admin): remove the colour fade on record rows and match the syste…
xiaodoudou Oct 1, 2026
9067b28
fix(admin): add or remove a record with a click on its row when choos…
xiaodoudou Oct 1, 2026
dc0f6dc
feat(admin): follow the user's theme, language and tab title, and dro…
xiaodoudou Oct 1, 2026
71c0041
feat: rebrand node-cms as Embed CMS with a new logo
xiaodoudou Oct 1, 2026
a042c21
docs: review the docs against the code and the changes since 3.0.0
xiaodoudou Oct 1, 2026
bfafd78
build: load rollup-plugin-visualizer 7 only for ANALYZE=1 npm run build
xiaodoudou Oct 1, 2026
d83aece
build(deps): chai 6
xiaodoudou Oct 1, 2026
8667ad0
build(deps): vue-virtual-scroller 3
xiaodoudou Oct 1, 2026
77e346b
build(deps): @vuepic/vue-datepicker 14 and date-fns 4 as a direct dep…
xiaodoudou Oct 1, 2026
ec6882b
fix(auth): make the no-login mode work and sign what it writes
xiaodoudou Oct 1, 2026
c7b6f69
chore(release): 3.0.1, the first version on npm
xiaodoudou Oct 1, 2026
ee4d969
ci(release): run the tests, publish to npm and create the GitHub rele…
xiaodoudou Oct 1, 2026
0fcd24d
build(deps): fetch vue3-shortkey as a tarball, as a dev dependency
xiaodoudou Oct 1, 2026
b164123
chore(release): 3.0.2
xiaodoudou Oct 1, 2026
d757513
build: update to Vuetify 4 and extend the build tooling
xiaodoudou Oct 2, 2026
c311f03
feat(server): add the sqlite store, the record author and the rights …
xiaodoudou Oct 2, 2026
18d7ad1
feat(admin): add Vuetify 4, SCSS design tokens, the plugin UI kit and…
xiaodoudou Oct 2, 2026
f5accb6
test: add frontend, OSS and driver contract tests, and checks for the…
xiaodoudou Oct 2, 2026
d47455d
test(bench): benchmark the whole CMS on all five storage engines
xiaodoudou Oct 2, 2026
b8590e3
docs: reorganise the docs by purpose
xiaodoudou Oct 2, 2026
5026df6
docs: update the screenshots
xiaodoudou Oct 2, 2026
b92f856
chore(release): 3.0.3
xiaodoudou Oct 2, 2026
4c4caa2
feat(admin): deeper indigo primary, edge-to-edge menus and a lock on …
xiaodoudou Oct 3, 2026
142ace2
feat(groups): make the Plugins field a drop-down of the plugin pages
xiaodoudou Oct 3, 2026
05aab0a
feat(resources): add layout examples to the catalogue, tiles in a gri…
xiaodoudou Oct 3, 2026
9294372
feat(admin): put the Jump to menu on every form, with the blocks and …
xiaodoudou Oct 3, 2026
fd886aa
feat(sync): choose the resources to sync in the Sync settings
xiaodoudou Oct 3, 2026
2cf771c
feat(sync): push or pull all resources from the admin, code, command …
xiaodoudou Oct 3, 2026
293beb0
feat(sync): sync the relations and files inside paragraph blocks
xiaodoudou Oct 3, 2026
45d29b6
feat(sync): follow record ids written in texts and JSON to the same r…
xiaodoudou Oct 3, 2026
498176b
fix(attachments): build the field path pattern without the double esc…
xiaodoudou Oct 3, 2026
46a0262
feat(api): resolve relations named after a resource, inside paragraph…
xiaodoudou Oct 3, 2026
5b798f4
perf(rest): compile the attachment field patterns once per request
xiaodoudou Oct 3, 2026
00471b1
feat(api): add bulk() to run many writes with one wait for the disk
xiaodoudou Oct 3, 2026
502d57e
perf(sync): find the records of each side by unique key and wait for …
xiaodoudou Oct 3, 2026
1662a02
refactor(import): use the logger instead of console.log
xiaodoudou Oct 3, 2026
52bd362
perf: check unique values against an index in memory
xiaodoudou Oct 3, 2026
b7c0d26
refactor(driver): use a Node EventEmitter for the context and pipelin…
xiaodoudou Oct 3, 2026
f6809eb
style: enforce prefer-const and eqeqeq on the backend
xiaodoudou Oct 3, 2026
73dc9ed
test: let the two tests that load the whole package wait as long as a…
xiaodoudou Oct 3, 2026
a98ff6e
fix(fields): hand a dropped file to the file field of its paragraph b…
xiaodoudou Oct 3, 2026
44195d7
refactor(admin): drop $forceUpdate, declare component events, enforce…
xiaodoudou Oct 3, 2026
da5f02f
docs: add a changelog from 3.0.0 and the release steps that keep it
xiaodoudou Oct 3, 2026
eeeb9cc
refactor(admin): replace vue3-shortkey with our own v-shortkey directive
xiaodoudou Oct 3, 2026
e43fb91
docs(backend): add a typed doc comment to every function and rename m…
xiaodoudou Oct 3, 2026
4d221fc
docs(admin): add a typed doc comment to every function and rename mis…
xiaodoudou Oct 3, 2026
6ee45ed
fix(admin): list the Replicator page from disableReplication in /admi…
xiaodoudou Oct 4, 2026
49888ff
fix(admin): resend a saved image or file with its order when it moves
xiaodoudou Oct 4, 2026
409fb09
fix(fields): make the label before a field a real label pointing at i…
xiaodoudou Oct 4, 2026
ed150b2
feat(fields): add a Today button to date fields
xiaodoudou Oct 4, 2026
d885c7e
fix(admin): drag with a mouse at once and keep lists from sharing a d…
xiaodoudou Oct 4, 2026
7817f4f
fix(admin): select no text while dragging, show a grab cursor and lea…
xiaodoudou Oct 4, 2026
8095e01
feat(admin): start a drag from a grip icon on blocks, images and files
xiaodoudou Oct 4, 2026
7f3f165
fix(admin): show the grip beside the file name and only with two item…
xiaodoudou Oct 4, 2026
25cc125
fix(admin): make the upload area a field like the others
xiaodoudou Oct 4, 2026
300225f
fix(admin): keep the forms of moved, dragged or removed blocks
xiaodoudou Oct 4, 2026
ba57bdd
feat(api): cut an image by a crop recipe kept with it
xiaodoudou Oct 4, 2026
68bcb04
feat(fields): add the cropimage field with a crop tool
xiaodoudou Oct 4, 2026
2c76450
fix(fields): open the small picture of an unsaved crop without fetchi…
xiaodoudou Oct 4, 2026
e736e96
docs(fields): say what the crop image form shows and what a click does
xiaodoudou Oct 4, 2026
15a88f6
feat(api): add the image map of a picture
xiaodoudou Oct 4, 2026
e6448a8
feat(api): let an image map area hold a typed value
xiaodoudou Oct 4, 2026
43dd295
feat(fields): add the imagemap field
xiaodoudou Oct 4, 2026
31b7dcd
fix(fields): fill the stage of the image map with the picture
xiaodoudou Oct 4, 2026
ef0057a
docs(fields): add screenshots of the crop image and image map fields
xiaodoudou Oct 4, 2026
6b04b24
feat(fields): add the rating field
xiaodoudou Oct 4, 2026
e4a8cf6
feat(fields): add the duration field
xiaodoudou Oct 4, 2026
cee2575
fix(fields): do not show the required message of a duration before it…
xiaodoudou Oct 4, 2026
fe103a7
feat(fields): add the money field
xiaodoudou Oct 4, 2026
9460c7a
feat(fields): add the phone field
xiaodoudou Oct 4, 2026
896d6cc
feat(fields): type a duration in one box the way people write it
xiaodoudou Oct 4, 2026
e36acdc
feat(fields): keep the template in the duration box while typing
xiaodoudou Oct 4, 2026
d208b7b
feat(fields): list the records of several resources in one select wit…
xiaodoudou Oct 4, 2026
89b5a10
feat(fields): add input masks, a template that stays in the box while…
xiaodoudou Oct 4, 2026
1c4d568
docs(fields): add screenshots of the rating, duration, money, phone a…
xiaodoudou Oct 4, 2026
b915a83
test(fields): test the escapes of a mask template
xiaodoudou Oct 4, 2026
8745d4f
test(admin): print a handful of lines instead of about 3900 Vue warnings
xiaodoudou Oct 4, 2026
f204bef
fix(admin): write ID copied in the toast after copying a record id
xiaodoudou Oct 4, 2026
60c14b0
fix(admin): change the theme at once and keep it on the server in the…
xiaodoudou Oct 4, 2026
9c5a3d6
test(admin): catch the console errors the tests expect so a run print…
xiaodoudou Oct 4, 2026
f5c8a90
feat(logs): show the real console output of the CMS on the log page o…
xiaodoudou Oct 4, 2026
288f061
feat(fields): add the markdown field
xiaodoudou Oct 4, 2026
948234c
feat(fields): add the daterange field
xiaodoudou Oct 4, 2026
342b4cd
feat(fields): add the geopoint field
xiaodoudou Oct 5, 2026
785b165
fix(fields): label the longitude box of the geopoint field
xiaodoudou Oct 5, 2026
0653f8c
feat(fields): add the radio and segmented fields
xiaodoudou Oct 5, 2026
6f8066f
test(admin): run a failing frontend test again, twice, before it coun…
xiaodoudou Oct 5, 2026
02401b3
fix(fields): give the geopoint map search box a real label
xiaodoudou Oct 5, 2026
e765c00
fix(admin): open the calendars of date fields over the page on a phone
xiaodoudou Oct 5, 2026
f2866b4
fix(admin): make every button 44px on touch screens
xiaodoudou Oct 5, 2026
bdd292d
fix(admin): give the record editor more room on a phone
xiaodoudou Oct 5, 2026
0d0825f
fix(admin): stack form layout lines in a narrow editor
xiaodoudou Oct 5, 2026
7a41110
feat(i18n): name ninety languages and show a language by its code whe…
xiaodoudou Oct 5, 2026
2bafd16
feat(i18n): put the translation files of a project over the words of …
xiaodoudou Oct 5, 2026
6f2c7e7
fix(admin): put the block type and the Add button on one line on a phone
xiaodoudou Oct 5, 2026
5c38cfd
fix(admin): make image and file previews take the whole line in a nar…
xiaodoudou Oct 5, 2026
a3c6539
fix(admin): use the phone layout for a phone on its side
xiaodoudou Oct 5, 2026
2f3557d
fix(admin): start a drag by touch as soon as the finger moves 3px fro…
xiaodoudou Oct 5, 2026
0400f56
fix(admin): centre the title and grip in the block bar on a touch screen
xiaodoudou Oct 5, 2026
7b1d62a
fix(admin): hide the breadcrumb on a phone with a class instead of a …
xiaodoudou Oct 5, 2026
91cbe88
fix(admin): round all corners of a block folded to its bar
xiaodoudou Oct 5, 2026
bdd76ba
perf(admin): hide folded blocks with content-visibility while a block…
xiaodoudou Oct 5, 2026
3c09cd4
feat(admin): show the language of a record as one button on a phone
xiaodoudou Oct 5, 2026
3b3d398
fix(admin): keep the editor bar of a new record on one line on a phone
xiaodoudou Oct 5, 2026
9c0bd2a
fix(admin): mobile review, round two
xiaodoudou Oct 5, 2026
0099c37
fix(admin): show on the language button how many other languages need…
xiaodoudou Oct 5, 2026
5ea49f9
fix(admin): centre the pills of the editor bar on one line
xiaodoudou Oct 5, 2026
04f5f5d
fix(fields): warn once about a slug without options.valueFrom
xiaodoudou Oct 5, 2026
d49d2da
fix(resources): give the Slug of the Languages resource a source and …
xiaodoudou Oct 5, 2026
ea32b7d
feat(fields): groups that close, start closed and have a layout of th…
xiaodoudou Oct 5, 2026
3e58711
fix(admin): align the Jump to field search box with the rows
xiaodoudou Oct 5, 2026
c559721
fix(admin): make the Jump to field search box the first line of the menu
xiaodoudou Oct 5, 2026
488e894
fix(admin): move the magnifier of the Jump to field search box off th…
xiaodoudou Oct 5, 2026
3a20b63
fix(admin): make the Jump to field search box 44px tall on a touch sc…
xiaodoudou Oct 5, 2026
d478a4a
docs: say the Jump to field search box is 44px tall on a touch screen
xiaodoudou Oct 5, 2026
4a140d9
fix(admin): show only the list in Jump to field on a phone or a touch…
xiaodoudou Oct 5, 2026
711a91f
feat: add the PageHelper for the pages of a public site
xiaodoudou Oct 6, 2026
63032dc
feat: add the ContentLoader and the cms-load command
xiaodoudou Oct 6, 2026
dfcf366
docs(examples): add the magazine, a second example site built with no…
xiaodoudou Oct 6, 2026
f0c9ed9
chore: give main one commit per release and keep the work on dev
xiaodoudou Oct 6, 2026
8a26239
chore: merge the releases up to 3.0.3 from main
xiaodoudou Oct 6, 2026
92a9c2a
docs: say which page to read for each question in the docs map
xiaodoudou Oct 6, 2026
9a13665
chore(release): 3.0.4
xiaodoudou Oct 6, 2026
1752df5
chore: merge release 3.0.4 from main
xiaodoudou Oct 6, 2026
2b0bd33
fix(security): files-only group cannot write records, CSRF check igno…
xiaodoudou Oct 6, 2026
3bd1aec
feat(examples): add the docs platform, an advanced example with a CMS…
xiaodoudou Oct 6, 2026
09b9dbe
test(examples): hold every example to the same bar
xiaodoudou Oct 6, 2026
8dd0ef9
feat(examples): add Boardwalk, a Vue 3 task board over the REST API
xiaodoudou Oct 6, 2026
f9f9f01
fix: exit with 0 when the CMS is stopped by a signal
xiaodoudou Oct 7, 2026
16a2296
feat(examples): add the Docker example with every secret in a .env
xiaodoudou Oct 6, 2026
910c20e
docs: shorten the sentences and lists, and the changelog
xiaodoudou Oct 7, 2026
acbd7cb
build: enforce Conventional Commits with a commit-msg hook
xiaodoudou Oct 7, 2026
5f2b295
ci: check the commit messages and the title of a pull request into main
xiaodoudou Oct 7, 2026
d948c28
docs: ask for Conventional Commits in CONTRIBUTING
xiaodoudou Oct 7, 2026
9ebfa3e
chore(release): 3.0.5
xiaodoudou Oct 7, 2026
5303c7c
chore: merge release 3.0.5 from main
xiaodoudou Oct 7, 2026
59653d3
chore(deps): update dependencies within their ranges
xiaodoudou Oct 8, 2026
417d4a5
chore(deps): upgrade helmet to 8
xiaodoudou Oct 8, 2026
729782e
feat: add cms-backup and cms-restore
xiaodoudou Oct 8, 2026
2156b10
feat: add agent skills and the cms-skills command
xiaodoudou Oct 8, 2026
d2deb9c
chore(deps): upgrade body-parser to 2
xiaodoudou Oct 8, 2026
dee6b3b
chore(deps): upgrade express to 5
xiaodoudou Oct 8, 2026
fa14901
chore(deps): upgrade commander to 15
xiaodoudou Oct 8, 2026
d124929
chore(deps): upgrade p-all to 5
xiaodoudou Oct 8, 2026
077e8e6
chore(deps): upgrade mongodb to 7
xiaodoudou Oct 8, 2026
615b732
chore(deps): upgrade knip to 6
xiaodoudou Oct 8, 2026
7dea441
chore(deps): upgrade vite to 8
xiaodoudou Oct 8, 2026
6b164a7
chore(deps): upgrade vue-router to 5
xiaodoudou Oct 8, 2026
380e6db
ci: open dependabot pull requests against dev
xiaodoudou Oct 8, 2026
324006d
Merge pull request #14 from xiaodoudou/deps/in-range
xiaodoudou Oct 8, 2026
6d0237d
Merge pull request #15 from xiaodoudou/deps/helmet-8
xiaodoudou Oct 8, 2026
602c349
Merge pull request #16 from xiaodoudou/deps/body-parser-2
xiaodoudou Oct 8, 2026
547bbcb
Merge pull request #17 from xiaodoudou/deps/express-5
xiaodoudou Oct 8, 2026
acbc5de
Merge pull request #18 from xiaodoudou/deps/commander-15
xiaodoudou Oct 8, 2026
5029b31
Merge pull request #19 from xiaodoudou/deps/p-all-5
xiaodoudou Oct 8, 2026
760eceb
Merge pull request #20 from xiaodoudou/deps/mongodb-7
xiaodoudou Oct 8, 2026
5acd71d
Merge pull request #21 from xiaodoudou/deps/knip-6
xiaodoudou Oct 8, 2026
5a6378b
Merge pull request #22 from xiaodoudou/deps/vite-8
xiaodoudou Oct 8, 2026
f00fdd6
Merge pull request #23 from xiaodoudou/deps/vue-router-5
xiaodoudou Oct 8, 2026
3f44ebc
Merge pull request #13 from xiaodoudou/feat/backup-and-agent-skills
xiaodoudou Oct 8, 2026
f31ee90
Merge pull request #24 from xiaodoudou/ci/dependabot-target-dev
xiaodoudou Oct 8, 2026
121b330
fix(admin): give the rich text toolbar the tint of the Markdown toolbar
xiaodoudou Oct 8, 2026
e5609ae
feat(admin): let a mask force upper or lower case
xiaodoudou Oct 8, 2026
e5efe6a
Merge pull request #25 from xiaodoudou/fix/wysiwyg-toolbar-background
xiaodoudou Oct 8, 2026
4a8209c
Merge pull request #26 from xiaodoudou/feat/mask-letter-case
xiaodoudou Oct 8, 2026
df7116e
docs(fields): retake the mask screenshots with the forced capitals
xiaodoudou Oct 8, 2026
5dda477
Merge pull request #27 from xiaodoudou/docs/mask-case-screenshots
xiaodoudou Oct 8, 2026
9443134
test(examples): stop the csrf token test from failing one time in 64
xiaodoudou Oct 8, 2026
41fa2c1
Merge pull request #28 from xiaodoudou/fix/flaky-csrf-test
xiaodoudou Oct 8, 2026
1468a65
chore(release): 3.0.6
xiaodoudou Oct 8, 2026
e09c79d
chore: merge release 3.0.6 from main
xiaodoudou Oct 8, 2026
b9ebac6
chore(deps-dev): bump jsdom from 29.1.1 to 30.1.2
dependabot[bot] Oct 8, 2026
01a1815
test(sync): stop the burst test from failing on a busy machine
xiaodoudou Oct 8, 2026
b6cf76c
Merge pull request #31 from xiaodoudou/fix/flaky-sync-burst-test
xiaodoudou Oct 8, 2026
a54f8b1
Merge pull request #30 from xiaodoudou/dependabot/npm_and_yarn/dev/js…
xiaodoudou Oct 8, 2026
eeaf65a
build(deps): drop del-cli, the last source of audit warnings
xiaodoudou Oct 9, 2026
f9558fe
refactor: move the dev clean-up of src/plugins to a script
xiaodoudou Oct 9, 2026
09e0e7c
build(deps): read a stream into a buffer with stream/consumers, drop …
xiaodoudou Oct 9, 2026
82a0c4b
build(deps): ask yes or no with readline, drop prompt
xiaodoudou Oct 9, 2026
83d4184
fix(security): keep the session files in a folder only the server can…
xiaodoudou Oct 9, 2026
40969de
fix(security): leave the sessions out of a cms-backup files copy
xiaodoudou Oct 9, 2026
f8a024d
Merge pull request #32 from xiaodoudou/fix/drop-del-cli
xiaodoudou Oct 9, 2026
e029770
Merge remote-tracking branch 'origin/dev' into build/drop-abandoned-deps
xiaodoudou Oct 9, 2026
2aeef30
Merge pull request #33 from xiaodoudou/build/drop-abandoned-deps
xiaodoudou Oct 9, 2026
5833f2c
Merge pull request #34 from xiaodoudou/fix/private-session-files
xiaodoudou Oct 9, 2026
59a1c70
chore(release): 3.0.7
xiaodoudou Oct 9, 2026
1de10f2
chore: merge release 3.0.7 from main
xiaodoudou Oct 9, 2026
c3507d8
chore(knip): clean up what knip 6 reports
xiaodoudou Oct 9, 2026
a35b9f5
Merge pull request #36 from xiaodoudou/build/knip-6-cleanup
xiaodoudou Oct 9, 2026
b7e2fc2
fix(dev): keep the page host in the Vite proxy
xiaodoudou Oct 9, 2026
2db3e77
fix(fields): keep the title of a block with no summary next to the grip
xiaodoudou Oct 9, 2026
b062711
feat(admin): nest menu groups to any depth
xiaodoudou Oct 9, 2026
87b935b
docs: add a page on resource files
xiaodoudou Oct 9, 2026
f840937
Merge pull request #37 from xiaodoudou/feat/nested-menu-groups
xiaodoudou Oct 11, 2026
6baa973
chore(release): 3.1.0
xiaodoudou Oct 11, 2026
7a3460f
chore: merge release 3.1.0 from main
xiaodoudou Oct 11, 2026
ec41308
build: support Node 24 and run CI on it
xiaodoudou Oct 11, 2026
7a702de
fix(import): do not ask again once the input has ended
xiaodoudou Oct 11, 2026
ce7cae6
build: move the Docker example and the release jobs to Node 24
xiaodoudou Oct 11, 2026
197740d
docs: note the confirm fix that Node 24 found in the changelog
xiaodoudou Oct 11, 2026
30fc225
docs: fix a line break in the changelog entry
xiaodoudou Oct 11, 2026
9aa9b93
build: require Node 24 and drop Node 22
xiaodoudou Oct 11, 2026
4d55c62
Merge pull request #39 from xiaodoudou/ci/node-24
xiaodoudou Oct 11, 2026
48025d1
chore(release): 3.1.1
xiaodoudou Oct 11, 2026
35c12aa
chore: merge release 3.1.1 from main
xiaodoudou Oct 11, 2026
8e9f370
feat(admin): put the Replicator page in the CMS menu and draw it with…
xiaodoudou Oct 11, 2026
0df69f4
feat(fields): add the token field, a random value made once
xiaodoudou Oct 11, 2026
7f9e8da
feat(replication)!: replicate over a websocket on the HTTP port, not …
xiaodoudou Oct 11, 2026
2c137b0
docs(replication): describe the types and directions as the code appl…
xiaodoudou Oct 11, 2026
d4b1150
fix(replication): keep the resources of the CMS out of the global pee…
xiaodoudou Oct 11, 2026
1e99c4b
feat(fields): type, paste or generate a token, and use it for the Syn…
xiaodoudou Oct 11, 2026
4db1f64
fix(fields): show the Copy button of a token field only when there is…
xiaodoudou Oct 11, 2026
225248c
Merge branch 'feat/replicator-page' into feat/live-replication
xiaodoudou Oct 11, 2026
ed32430
feat(replication)!: replicate live, each node pulling from the peers …
xiaodoudou Oct 11, 2026
7302297
feat(admin): make the Replicator page easier to read
xiaodoudou Oct 11, 2026
7cf9c57
feat(admin): show the direction of each resource at a glance on the R…
xiaodoudou Oct 11, 2026
74222e2
style(admin): give the table of the Replicator page a darker head
xiaodoudou Oct 11, 2026
ae7704f
style(admin): one box on the Replicator page, with a light head
xiaodoudou Oct 11, 2026
df2607d
style(admin): drop the count of the resources that do not replicate f…
xiaodoudou Oct 11, 2026
f56cbfe
fix(replicator): say why a link to a name with several addresses fail…
xiaodoudou Oct 11, 2026
5b10d7c
docs(fields): add screenshots of the token field
xiaodoudou Oct 11, 2026
d67fb10
docs(replication): show the Replicator page, and describe live replic…
xiaodoudou Oct 11, 2026
79f9cde
docs(replication): say how the admin shows a record made on another node
xiaodoudou Oct 11, 2026
dadcb7e
feat(admin): say in the editor that a record of another node is read-…
xiaodoudou Oct 11, 2026
3892b7a
docs(replication): mention the read-only pill of the editor
xiaodoudou Oct 11, 2026
b2e1c55
docs(changelog): note the read-only pill of a record made on another …
xiaodoudou Oct 11, 2026
afc1751
Merge pull request #41 from xiaodoudou/feat/token-field
xiaodoudou Oct 11, 2026
1e719b8
fix(replication): send a change written as a live link connects, not …
xiaodoudou Oct 11, 2026
ec2fa50
fix(replication): stop a link in its handshake at once, and reconnect…
xiaodoudou Oct 11, 2026
6b7fdd1
test(replication): wait for the connection of each test of the fake p…
xiaodoudou Oct 11, 2026
969e677
docs(replication): explain the record id and what a foreign record is
xiaodoudou Oct 11, 2026
60dd4dc
Merge remote-tracking branch 'origin/dev' into feat/live-replication
xiaodoudou Oct 11, 2026
72b82d2
Merge pull request #42 from xiaodoudou/feat/live-replication
xiaodoudou Oct 12, 2026
b4fb1a8
docs(replication): name the upgrade section after the versions it upg…
xiaodoudou Oct 12, 2026
c8dfd2a
chore(release): 3.2.0
xiaodoudou Oct 12, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 16 additions & 1 deletion CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,20 @@ What changed in each version of Embed CMS, from 3.0.0 on, newest first. The vers

## [Unreleased]

## [3.2.0] - 2026-10-12

### Added

- **A token field.** `input: 'token'` holds a key or a secret that two systems share. Type it, paste it, or make a random one with the **Generate** button, and copy it with **Copy**. `options.length` (random bytes), `options.prefix` and `options.format` (`base64url` or `hex`) shape what Generate makes, and `options.autoGenerate` gives a new record a token by itself, in the admin and over the API. See [token](docs/reference/fields/token.md).
- **The Token under This CMS in the Sync settings is a token field.** It has a Generate and a Copy button, so the secret no longer has to be invented by hand.

### Changed

- **Replication is live, and needs no port of its own.** A node keeps a link open to each peer it receives a resource from: the peer sends what the node lacks, then each change as it is written, and the link connects again by itself after an outage. Records go over a websocket on the HTTP port of the CMS, at `/_replicator` next to the REST API, so they travel over `wss://` when the CMS is served over HTTPS; files still go over the REST API. A node a peer connects to only sends, so a connecting peer can no longer write anything. With MongoDB or PostgreSQL, a node pulls again every `replication.pollInterval` (30 seconds). **To upgrade:** remove `netPort`, give each peer the `url` of its REST API, set `replication.secret` on every node, and list on each node the peers it receives from. `settleDelay` and `POST /replicator/sync/:resource/:id` are gone. See [REPLICATION.md](docs/operations/REPLICATION.md#moving-from-31-or-earlier).
- **The resources of the CMS stay out of the global peers list.** `_users`, `_groups`, `_settings`, `_sync` and `_xlsx` now replicate only when `replication.peersByResource` names them. Every node makes its own `admins` group and `localAdmin` on its first start, and a node that fetched another node's `admins` group could no longer update it, so its admin login stopped working. See [REPLICATION.md](docs/operations/REPLICATION.md#users-groups-and-settings).
- **The Replicator page shows the replication, live, and starts nothing.** For each resource that replicates, it shows the peers this node pulls it from, the state of each link (live, reconnecting with the error and the next try) and its last change, and the peers that pull it from here. The Sync all and Sync a record buttons are gone. The page moved from the System menu to the CMS menu, and is drawn with the plugin kit.
- **A record made on another node says so in the editor.** Its form showed "All changes saved" above fields that can't be edited. It now reads "Read-only, made on" and the `mid` of the node to edit it on. See [REPLICATION.md](docs/operations/REPLICATION.md#records-of-another-node).

## [3.1.1] - 2026-10-11

### Changed
Expand Down Expand Up @@ -230,7 +244,8 @@ The release that turned node-cms into a project that stands on its own: the firs
- The bugs the component tests found: a new record opens a blank editor again, a refused request is not logged as a server error, record names and labels after the mustache 4 update, a record whose id overlaps the machine id can be changed and removed, and `remove` and `update` throw instead of failing silently.
- A delete goes to the replication peers right away again, `cms-import` prints no empty progress bars into logs, the xlsx import answers `400` without a file.

[Unreleased]: https://github.com/xiaodoudou/embed-cms/compare/v3.0.5...HEAD
[Unreleased]: https://github.com/xiaodoudou/embed-cms/compare/v3.2.0...HEAD
[3.2.0]: https://github.com/xiaodoudou/embed-cms/compare/v3.1.1...v3.2.0
[3.1.1]: https://github.com/xiaodoudou/embed-cms/compare/v3.1.0...v3.1.1
[3.1.0]: https://github.com/xiaodoudou/embed-cms/compare/v3.0.7...v3.1.0
[3.0.7]: https://github.com/xiaodoudou/embed-cms/compare/v3.0.6...v3.0.7
Expand Down
18 changes: 9 additions & 9 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -63,7 +63,7 @@ Each protection is one setting in the `security` block of `cms.json`. All of the
| `limits.json` | `"100kb"` | Size of a JSON request body, on every route (REST, sync, import, the admin): it is the only JSON limit. A larger body answers `413` with a JSON message naming this setting. 100kb is what every route accepted before the option existed |
| `limits.upload` | `{ fileSize: "256mb", files: 20, fields: 200, fieldSize: "1mb", parts: 260 }` | Limits of multipart uploads; a value given here replaces the matching default |
| `restrictRemoteUrls` | `true` | `importFromRemote` only fetches attachments from the remote it imports from (and `allowedHosts` of its `remote` block) |
| `strictReplication` | `true` | The replication port needs `replication.secret`, peers may only ask for resources this node has, changes from a peer are validated |
| `strictReplication` | `true` | Peers may only ask for resources this node has, and each record a node pulls from a peer is validated before it is stored. The replication websocket always needs `replication.secret` |
| `wsAuth` | `true` | The record update websocket needs a login and a same-origin (or listed) page |
| `wsMaxPayload` | `16384` | Largest message a websocket client may send |
| `authCacheTtl` | `60000` | Milliseconds a verified password stays verified in memory (Basic authentication runs the hash once per minute, not per request); `0` turns it off |
Expand All @@ -75,13 +75,13 @@ Each protection is one setting in the `security` block of `cms.json`. All of the
| `trustProxy` | not set | Passed to Express `trust proxy`: `req.ip`, `req.secure` and the login lockout follow the proxy chain. Set it to the number of proxies in front of the CMS; without it the address of the TCP peer is used |
| `imageConcurrency` | number of cores | Image operations (resize, crop, smart crop) that run at once; the others wait. `0` means no limit. At most 100 may wait, the next request gets 503 |
| `attachmentCleanupGrace` | `300000` | Milliseconds a file must have been idle before `cleanAttachment` may remove it as an orphan |
| `replication.secret` | not set | Shared secret of the replication port. Both sides prove they know it with an HMAC-SHA256 challenge before any resource is named |
| `replication.strictTypes` | `false` | Read the type (`normal`, `upstream`, `downstream`) of a resource from its options, so the direction rules of `replication.peers` apply. Off, every resource counts as `normal`, as in earlier releases |
| `replication.settleDelay` | `2000` | Milliseconds `replicate()` waits for a peer to flush before it syncs attachments |
| `replication.secret` | not set | Shared secret of the replication websocket (`/_replicator` on the HTTP port). Both sides prove they know it with an HMAC-SHA256 challenge before any resource is named; without it the node doesn't listen for peers |
| `replication.strictTypes` | `false` | Read the type (`normal`, `upstream`, `downstream`) of a resource from its options, so the `direction` of each peer is checked against it. Off, every peer is used for every resource |
| `replication.pollInterval` | `30000` | Milliseconds between two pulls from a peer whose store can't keep a link open (MongoDB, PostgreSQL) |
| `replication.maxRecordBytes` | `4194304` | Largest record accepted from a peer with `strictReplication` |
| `importFromRemote.remote.restrictUrls` / `.allowedHosts` | `false` / `[]` | Per remote, in addition to `restrictRemoteUrls` |

`replication.strictTypes` is worth a word. The replication manager reads the type of a resource from its options. Off, every resource counts as `normal` and the `direction` of a peer never matters. With the option on, a `downstream` resource (`_users`, `_groups`, `_settings` and the resources you declared so) is only synced with peers whose `direction` is `upstream` or `normal`, and an `upstream` resource with peers of direction `downstream` or `normal`. A peer without `direction` then stops syncing typed resources. Give every peer a direction before turning it on.
`replication.strictTypes` is worth a word. A node pulls each resource from the peers it lists, except a resource of type `upstream`, which it only sends. Off, a node opens a link to every peer it lists. With the option on, it opens links only to peers whose `direction` is `upstream` or `normal`, the peers it takes from; a peer without `direction` then gets no link. Give every peer a direction before turning it on. A peer that connects to a node can pull from it but never writes to it, with or without the option. [REPLICATION.md](docs/operations/REPLICATION.md#directions) explains the types and the directions.

### Always on

Expand Down Expand Up @@ -157,7 +157,7 @@ The values that depend on your setup:
- `trustProxy` is the number of reverse proxies in front of the CMS; change `1` to the real number.
- `allowedOrigins` takes the origin of the admin app when it is served from another host than the API.
- `limits.json` is `"100kb"`, the size of the largest JSON body (a record, an import); raise it when a record is bigger.
- `replication.strictTypes` is on, so every peer needs a `direction`, or it stops syncing `_users`, `_groups` and `_settings`.
- `replication.strictTypes` is on, so every peer needs a `direction`, or it syncs `normal` resources only.
- `localAdmin` is off. A `localAdmin` record that already exists stays, and every boot logs an error while it has its default password: change that password or delete the account.
- `safeAttachments` and `strictUploads` are on. Turning `safeAttachments` off displays HTML and SVG attachments inline, with the privileges of the site for whoever opens them. Turning `strictUploads` off removes the file name sanitising, the content-based type and the upload limits.

Expand All @@ -176,7 +176,7 @@ Run with `NODE_ENV=production`, then check:
3. Password hashes. Leave `passwordHash` on `scrypt`. If nodes replicate `_users`, upgrade every node first: a node that runs an earlier release cannot verify an scrypt hash.
4. Proxy. Behind a reverse proxy, set `trustProxy` to the number of proxies, forward `X-Forwarded-Proto`, and serve the admin app over https (cookies get `Secure`, HSTS is sent).
5. CSRF and origins. If the admin app is served from another origin than the API, list it in `allowedOrigins`.
6. Replication. Set the same `replication.secret` on every node, firewall the replication port to the peers, and set a `direction` on every peer before turning on `replication.strictTypes`.
6. Replication. Set the same `replication.secret` on every node, serve the CMS over HTTPS so peers replicate over `wss://`, and set a `direction` on every peer before turning on `replication.strictTypes`.
7. Uploads. Tune `limits.upload` to what your editors need. Do not add `text/html` or `image/svg+xml` to `inlineTypes` unless you trust everyone who can upload.
8. Configuration. `cms.json` is not editable from the admin: nothing on the web can read or rewrite the secrets.
9. Logs. `/api/_syslog` shows the log to every user who can log in: keep secrets out of log lines (the backend does not write passwords or tokens) and give the `plugins` right of the group only to administrators. The log page and the log file are bounded by `syslog.maxLineLength`, `syslog.maxFileSize` and `syslog.maxClientBuffer`.
Expand All @@ -185,7 +185,7 @@ Run with `NODE_ENV=production`, then check:
## Not covered

- The frontend (`src/`) was not changed by this work. Its own protections (DOMPurify) are separate.
- Transport encryption of the replication port: the shared secret authenticates the peers, it does not encrypt what they exchange. Run the replication port on a private network or through a tunnel.
- Transport encryption of the replication: the shared secret authenticates the peers, it does not encrypt what they exchange. Serve the CMS over HTTPS (peers then use `wss://`), or keep the nodes on a private network or a tunnel.
- MongoDB and PostgreSQL servers are configured by their operators; the CMS only guarantees the queries it sends.
- Regular expressions are checked, not sandboxed: a pattern that passes the check can still be slow on a very long text field. If that matters to you, keep `limits.json` small and consider a regular expression engine with a linear time guarantee in front of the query filter.

Expand All @@ -206,7 +206,7 @@ Options added, with defaults (see the tables above):

- `strongSecrets`, `generateSecrets`, `localAdmin`, `passwordHash`, `hideCredentials`, `genericLockout`, `csrf`, `allowedOrigins`, `cookies`, `strictSessions`, `redactConfig`, `strictAdmin`, `headers`, `contentSecurityPolicy`, `sseCors`, `safeRegex`, `uniformErrors`, `safeAttachments`, `inlineTypes`, `strictUploads`, `restrictRemoteUrls`, `strictReplication`, `wsAuth`, `wsMaxPayload`, `authCacheTtl`, `limits.json`, `limits.upload`
- top level: `trustProxy`, `imageConcurrency`, `attachmentCleanupGrace`; `blockRetry: false` turns the lockout off
- `replication.secret`, `replication.strictTypes`, `replication.settleDelay`, `replication.maxRecordBytes`
- `replication.secret`, `replication.strictTypes`, `replication.pollInterval`, `replication.maxRecordBytes`
- `importFromRemote.remote.restrictUrls`, `importFromRemote.remote.allowedHosts`

Files written by the backend: `<data>/.secrets.json` (only with `generateSecrets`), `<data>/.revoked-tokens.json`, `<data>/<resource>/json/db.json.corrupt-<time>` (only when a store file could not be read).
Expand Down
2 changes: 1 addition & 1 deletion docs/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ For what changed in each version, and what is on `main` but not released yet, se
## Reference (`reference/`)

- [Resource files](reference/RESOURCES.md): every key of a file in `resources/`, nested menu groups, and how records are named.
- [Field types](reference/FIELDS.md): the 24 input types, the options they share, localisation, and what is checked where. Each type has its own page in [`fields/`](reference/fields/), with every variation and a screenshot.
- [Field types](reference/FIELDS.md): the 36 input types, the options they share, localisation, and what is checked where. Each type has its own page in [`fields/`](reference/fields/), with every variation and a screenshot.
- [Field catalogue](../resources/README.md): the example resources in `resources/`, one per family of fields, ready to copy from.
- [Form layout](reference/FORM_LAYOUT.md): fields side by side on a line of the record form.
- [Dynamic layout](reference/DYNAMIC_LAYOUT.md): paragraph blocks side by side in the editor.
Expand Down
2 changes: 1 addition & 1 deletion docs/contributing/ARCHITECTURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -119,7 +119,7 @@ The record goes back up the same way, as JSON. The REST plugin folds the attachm

Meanwhile the broadcast of step 4 reaches `UpdatesManager` (`lib/UpdatesManager.js`), which sends `{ action, data: { resource, _id, _updatedBy } }` over a websocket to every open admin. Another editor looking at the same list sees it refresh. Resources whose name starts with `_` are not broadcast.

If the resource has peers and a replication type, the replicator (`lib/plugins/replicator`) now syncs the change to the other nodes: records over its TCP protocol, files over HTTP. See [REPLICATION.md](../operations/REPLICATION.md).
The write also reaches the peers that pull the resource from this node: each keeps a live link open (`lib/plugins/replicator`), and the change goes out on it as soon as it is stored. Records travel over a websocket on the HTTP port, files over HTTP. See [REPLICATION.md](../operations/REPLICATION.md).

## Where things live

Expand Down
4 changes: 2 additions & 2 deletions docs/contributing/TESTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -67,14 +67,14 @@ Setting `LOG_LEVEL` does the same (`LOG_LEVEL=debug` shows even the refused requ
| `test/helpers/` | What the backend tests share: `app.js` boots a CMS, `cmsInstance.js` holds the shared options, `engines.js` the storage engines of the contract suite, `quiet.js` the log level |
| `test/fixtures/` | Data the tests read: the `resources/` of the shared CMS, `contractResources/` for the contract suite, `ossResources/` for the OSS tests, `man.jpg` and the `smartCrop/` reference pictures |
| `test/bench/` | The benchmarks (`npm run bench:stores`, `bench.js`, `compare.js`) and their own `resources/` |
| `test/security/` | One regression test per finding of the backend security audit: `auth` (passwords, sessions, login limits, revocation), `http` (headers, CSRF, CORS, errors), `uploads`, `query`, `rest`, `importFromRemote` (SSRF), `replication` (handshake, peer validation), `websocket` |
| `test/security/` | One regression test per finding of the backend security audit: `auth` (passwords, sessions, login limits, revocation), `http` (headers, CSRF, CORS, errors), `uploads`, `query`, `rest`, `importFromRemote` (SSRF), `replication` (handshake, a node that only sends, the records a node pulls checked one by one), `websocket` |
| `test/unit/authentication*` | Passwords, login, retry blocking, group permissions, JWT handling |
| `test/unit/driver*`, `resource*`, `locking*` | CRUD, hooks, unique keys, concurrency, attachments, import maps |
| `test/unit/localEngines*` | The three local engines behind one interface (ranges, paging, scan, count, hooks, reopen), the choice in `cms.json`, and the migration between them |
| `test/unit/stores*`, `jsondown*`, `queryNeedles*`, `paging*`, `importMap*` | `JsonStore`, `FileStore` (including path traversal), the JSON file engine (ordering, ranges, atomic and sliced flush, corrupt files), the text prefilter of queries, paging, the indexed import map |
| `test/unit/drivers.contract.test.js` | The [driver contract suite](#driver-contract-suite) |
| `test/unit/authentication.cache*`, `hardening*`, `security.utils*` | The verified-password cache, ids, and the small security utilities (passwords, redaction, safe regular expressions, file types) |
| `test/unit/replicator.attachments*`, `sync*` | Attachment download between peers, the low-level store sync |
| `test/unit/replication.live*`, `replicator.attachments*`, `sync*` | Live links between two nodes (a change crosses as it is written, a link that drops connects again, files follow the records), attachment download between peers, the low-level store sync |
| `test/unit/rest.attachments*`, `ossHelper*`, `admin*`, `updates*`, `syslog.system*` | REST attachment routes, attachments kept in Alibaba Cloud OSS (the client stood in for), admin plugin, websocket updates, log and system streams |
| `test/unit/xlsx*`, `sync*`, `import*`, `importFromRemote*`, `replicator*` | The plugins, each checked through its real routes |
| `test/unit/pageHelper*` | The [PageHelper](../reference/PAGE_HELPER.md): the templates read and checked at the start, each way a kept page can be old (a template, a record, the age, a damaged file), the memory and the folder, errors and 404 pages, many requests at once. `pageHelper.edge.test.js` stands a small CMS in for the real one, so that each failure is made on purpose |
Expand Down
2 changes: 1 addition & 1 deletion docs/extending/PLUGINS.md
Original file line number Diff line number Diff line change
Expand Up @@ -357,6 +357,6 @@ A page can also have an `allowed` list: `allowed: ['admins']` limits it to those
| `anonymousRead` | `lib/plugins/anonymousRead/index.js` | The smallest: one bootstrap function. |
| `xlsx`, `import`, `importFromRemote` | `lib/plugins/xlsx`, `import`, `importFromRemote` | Routes with uploads, a resource for settings. |
| `sync` | `lib/plugins/sync/index.js` | Routes, a settings resource, hooks, and an admin page (`src/components/pages/SyncResource.vue`). |
| `replicator` | `lib/plugins/replicator/` | A TCP protocol next to the HTTP routes, and the **Replicator** page. |
| `replicator` | `lib/plugins/replicator/` | A websocket at `/_replicator` on the HTTP port, the HTTP routes, and the **Replicator** page. |

The built-in server plugins are switched on by the options in [CONFIG.md](../reference/CONFIG.md#features-you-can-switch). Yours are installed in code with `cms.use`: they don't need an option, and the CMS doesn't look for plugin files by itself.
Binary file added docs/img/replicator.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading