Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
28 commits
Select commit Hold shift + click to select a range
90bab91
wip: try y-indexeddb
max-nextcloud Jun 13, 2025
4a69955
chore(split) useIndexedDbProvider from Editor.vue
max-nextcloud Sep 4, 2025
5aebd61
fix(cron): do not reset document
max-nextcloud Sep 4, 2025
102295c
enh(yjs): store baseVersionEtag alongside doc
max-nextcloud Sep 4, 2025
33d7825
fix(offline): persist dirty state in indexed db
max-nextcloud Oct 14, 2025
fa660a8
chore(test): explore empty changesets
max-nextcloud Oct 22, 2025
d5f7ba9
chore(rename): use privateMethods for emitError and emitDocumentState…
max-nextcloud Oct 26, 2025
02570de
chore(cleanup): _getContent alias for serialize
max-nextcloud Oct 26, 2025
e287688
chore(refactor): handle open data in websocket polyfill
max-nextcloud Oct 26, 2025
1c0b209
fix(sync): only accept sync protocol and return sync step 2
max-nextcloud Oct 26, 2025
6a9ce6f
enh(sync): recover automatically from outdated / renamed doc
max-nextcloud Oct 27, 2025
e69de61
fix(sync): ensure dirty is updated when saving in onDestroy
max-nextcloud Nov 4, 2025
f3dc513
chore(logging): some optional debug logging
max-nextcloud Nov 5, 2025
aca46ce
fix(sync): actually disable browser broadcast
max-nextcloud Nov 5, 2025
1fef36f
chore(test): conflict and sync with autoreload
max-nextcloud Nov 5, 2025
dd26ec5
chore(type) a few more files
max-nextcloud Nov 6, 2025
dc918f2
chore(test): add initial test for indexed db
max-nextcloud Nov 7, 2025
425f6d4
fix(sync): Cleanup sessions even with unsaved changes
max-nextcloud Nov 7, 2025
d184d74
chore(type): EditorFactory and setInitialYjsState
max-nextcloud Nov 10, 2025
fdb6ea8
enh(sync): updateFromContent()
max-nextcloud Nov 10, 2025
a752307
fix(indexedDB): handle conflict with local change
max-nextcloud Jan 7, 2026
2be5632
chore(log): debug log when attempting to open sync service twice
max-nextcloud Jan 7, 2026
790e18c
fix(conflict): handle conflict when opening initial session
max-nextcloud Jan 7, 2026
21c9e7b
fix(conflict): label buttons properly for unsaved local changes
max-nextcloud Jan 7, 2026
83901ac
chore(split): reload handling local change in Editor.js
max-nextcloud Jan 14, 2026
f7e19bb
fix(sync): make bc channel depend on base version etag
max-nextcloud Jan 16, 2026
8bd5f41
fix(offline): save dirty file when opening
max-nextcloud Jan 16, 2026
8c2f302
fix(offline): autosave with disconnects
max-nextcloud Jan 19, 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
51 changes: 21 additions & 30 deletions cypress/e2e/api/SessionApi.spec.js
Original file line number Diff line number Diff line change
Expand Up @@ -73,34 +73,33 @@ describe('The session Api', function () {
cy.closeConnection(connection)
})

// Echoes all message types but queries
Object.entries(messages)
.filter(([key, _value]) => key !== 'query')
.forEach(([type, sample]) => {
it(`echos ${type} messages`, function () {
const steps = [sample]
const version = 0
cy.pushSteps({ connection, steps, version })
.its('version')
.should('eql', 0)
cy.syncSteps(connection)
.its('steps[0].data')
.should('eql', steps)
})
// Echoes updates and responses
;['update', 'response'].forEach((type) => {
it(`echos ${type} messages`, function () {
const steps = [messages[type]]
const version = 0
cy.pushSteps({ connection, steps, version })
.its('version')
.should('eql', 0)
cy.syncSteps(connection).its('steps[0].data').should('eql', steps)
})
})

it('responds to queries', function () {
it('responds to queries with updates and responses', function () {
const version = 0
Object.entries(messages).forEach(([type, sample]) => {
cy.pushSteps({ connection, steps: [sample], version })
})
cy.pushSteps({ connection, steps: [messages.query], version }).then(
(response) => {
cy.wrap(response).its('version').should('eql', 0)
cy.wrap(response).its('steps.length').should('eql', 1)
cy.wrap(response).its('steps.length').should('eql', 2)
cy.wrap(response)
.its('steps[0].data')
.should('eql', [messages.update])
cy.wrap(response)
.its('steps[1].data')
.should('eql', [messages.response])
},
)
})
Expand All @@ -111,7 +110,6 @@ describe('The session Api', function () {
let connection
let fileId
let filePath
let joining

beforeEach(function () {
cy.testName().then((name) => {
Expand Down Expand Up @@ -156,13 +154,10 @@ describe('The session Api', function () {
manualSave: true,
})
cy.openConnection({ fileId, filePath })
.then(({ connection: con, data }) => {
joining = con
return data
})
.its('documentState')
.as('joining')
.its('data.documentState')
.should('eql', documentState)
cy.closeConnection(joining)
cy.get('@joining').its('connection').then(cy.closeConnection)
})

afterEach(function () {
Expand All @@ -175,7 +170,6 @@ describe('The session Api', function () {
let connection
let filePath
let shareToken
let joining

beforeEach(function () {
cy.testName().then((name) => {
Expand Down Expand Up @@ -232,13 +226,10 @@ describe('The session Api', function () {
manualSave: true,
})
cy.openConnection({ filePath: '', token: shareToken })
.then(({ connection: con, data }) => {
joining = con
return data
})
.its('documentState')
.as('joining')
.its('data.documentState')
.should('eql', documentState)
cy.closeConnection(joining)
cy.get('@joining').its('connection').then(cy.closeConnection)
})
})

Expand Down
21 changes: 13 additions & 8 deletions cypress/e2e/api/SyncServiceProvider.spec.js
Original file line number Diff line number Diff line change
Expand Up @@ -43,15 +43,20 @@ describe('Sync service provider', function () {
*/
function createProvider(ydoc) {
const relativePath = '.'
const { connection, openConnection, baseVersionEtag } = provideConnection({
fileId,
relativePath,
})
const { syncService } = provideSyncService(
connection,
openConnection,
baseVersionEtag,
let baseVersionEtag
const setBaseVersionEtag = (val) => {
baseVersionEtag = val
}
const getBaseVersionEtag = () => baseVersionEtag
const { connection, openConnection } = provideConnection(
{
fileId,
relativePath,
},
getBaseVersionEtag,
setBaseVersionEtag,
)
const { syncService } = provideSyncService(connection, openConnection)
const queue = []
syncService.bus.on('opened', () => syncService.startSync())
return createSyncServiceProvider({
Expand Down
21 changes: 8 additions & 13 deletions cypress/e2e/conflict.spec.js
Original file line number Diff line number Diff line change
Expand Up @@ -36,14 +36,9 @@ variants.forEach(function ({ fixture, mime }) {
cy.getContent().should('contain', 'Heading')

cy.uploadFile(fileName, mime, testName + '/' + fileName)
cy.get('#editor-container .document-status', {
timeout: 40000,
}).should('contain', 'session has expired')

// Reload button works
cy.get('#editor-container .document-status button')
.contains('Reload')
.click()
cy.intercept({ method: 'POST', url: '**/session/*/push' }).as('push')
cy.wait('@push', { timeout: 20_000 })
// Autoreload works
getWrapper().should('not.exist')
cy.getContent().should('contain', 'Hello world')
cy.getContent().should('not.contain', 'Heading')
Expand Down Expand Up @@ -78,10 +73,10 @@ variants.forEach(function ({ fixture, mime }) {
cy.openFile(fileName)
cy.intercept({ method: 'POST', url: '**/session/*/push' }).as('push')
cy.wait('@push')
cy.get('[data-cy="resolveThisVersion"]').click()
cy.get('[data-cy="useEditorVersion"]').click()

getWrapper().should('not.exist')
cy.get('[data-cy="resolveThisVersion"]').should('not.exist')
cy.get('[data-cy="useEditorVersion"]').should('not.exist')
cy.getContent().should('contain', 'cruel conflicting')
},
)
Expand All @@ -90,11 +85,11 @@ variants.forEach(function ({ fixture, mime }) {
createConflict(fileName, 'edited-' + fileName, mime)

cy.openFile(fileName)
cy.get('[data-cy="resolveServerVersion"]').click()
cy.get('[data-cy="useReaderVersion"]').click()

getWrapper().should('not.exist')
cy.get('[data-cy="resolveThisVersion"]').should('not.exist')
cy.get('[data-cy="resolveServerVersion"]').should('not.exist')
cy.get('[data-cy="useEditorVersion"]').should('not.exist')
cy.get('[data-cy="useReaderVersion"]').should('not.exist')
cy.getContent().should('contain', 'Hello world')
cy.getContent().should('not.contain', 'cruel conflicting')
})
Expand Down
22 changes: 8 additions & 14 deletions cypress/e2e/sync.spec.js
Original file line number Diff line number Diff line change
Expand Up @@ -108,7 +108,10 @@ describe('Sync', () => {
'contain',
'The document could not be loaded.',
)
cy.intercept('**/apps/text/session/*/create').as('create')
cy.get('#editor-container .document-status').find('button').click()
// let first attempt fail
cy.wait('@create', { timeout: 10000 })
cy.get('#editor-container .document-status', { timeout: 30000 }).should(
'contain',
'The document could not be loaded.',
Expand All @@ -117,13 +120,13 @@ describe('Sync', () => {
cy.intercept('**/apps/text/session/*/*', (req) => {
req.continue()
}).as('alive')
cy.intercept('**/apps/text/session/*/create').as('create')
cy.get('#editor-container .document-status').find('button').click()
// this is the create request... - now with the alive alias
cy.wait('@alive', { timeout: 30000 })
cy.wait('@create', { timeout: 10000 })
.its('request.body')
.should('have.property', 'baseVersionEtag')
.should('not.be.empty')
cy.getContent().should('contain', 'Hello world')
})

it('recovers from a lost and closed connection', () => {
Expand Down Expand Up @@ -176,18 +179,9 @@ describe('Sync', () => {
cy.wait('@save')
cy.uploadTestFile('test.md')

cy.get('#editor-container .document-status', { timeout: 30000 }).should(
'contain',
'Editing session has expired.',
)

// Reload button works
cy.get('#editor-container .document-status button')
.contains('Reload')
.click()

cy.getContent()
cy.get('#editor-container .document-status .notecard').should('not.exist')
cy.getContent().should('not.exist')
cy.getContent().find('h2').should('contain', 'Hello world')
cy.getContent().find('li').should('not.exist') // was overwritten after the save
})

it('passes the doc content from one session to the next', () => {
Expand Down
6 changes: 0 additions & 6 deletions lib/Cron/Cleanup.php
Original file line number Diff line number Diff line change
Expand Up @@ -11,7 +11,6 @@

namespace OCA\Text\Cron;

use OCA\Text\Exception\DocumentHasUnsavedChangesException;
use OCA\Text\Service\AttachmentService;
use OCA\Text\Service\DocumentService;
use OCA\Text\Service\SessionService;
Expand Down Expand Up @@ -42,11 +41,6 @@ protected function run($argument): void {
// Inactive sessions will get removed further down and will trigger a reset next time
continue;
}

try {
$this->documentService->resetDocument($document->getId());
} catch (DocumentHasUnsavedChangesException) {
}
$this->attachmentService->cleanupAttachments($document->getId());
}

Expand Down
4 changes: 2 additions & 2 deletions lib/Listeners/BeforeNodeWrittenListener.php
Original file line number Diff line number Diff line change
Expand Up @@ -40,12 +40,12 @@ public function handle(Event $event): void {
}
// Reset document session to avoid manual conflict resolution if there's no unsaved steps
try {
$this->documentService->resetDocument($node->getId());
$this->documentService->resetDocument($node->getId(), true);
} catch (DocumentHasUnsavedChangesException|NotFoundException $e) {
// Do not throw during event handling in this is expected to happen
// DocumentHasUnsavedChangesException: A document editing session is likely ongoing, someone can resolve the conflict
// NotFoundException: The event was called oin a file that was just created so a NonExistingFile object is used that has no id yet
$this->logger->debug('Reset document skipped in BeforeNodeWrittenEvent', ['exception' => $e]);
$this->logger->warning('Reset document skipped in BeforeNodeWrittenEvent', ['exception' => $e]);
}
}
}
8 changes: 6 additions & 2 deletions lib/Service/DocumentService.php
Original file line number Diff line number Diff line change
Expand Up @@ -208,8 +208,12 @@ public function addStep(Document $document, Session $session, array $steps, int
if ($readOnly && $message->isUpdate()) {
continue;
}
// Only accept sync protocol
if ($message->getYjsMessageType() !== YjsMessage::YJS_MESSAGE_SYNC) {
continue;
}
// Filter out query steps as they would just trigger clients to send their steps again
if ($message->getYjsMessageType() === YjsMessage::YJS_MESSAGE_SYNC && $message->getYjsSyncType() === YjsMessage::YJS_MESSAGE_SYNC_STEP1) {
if ($message->getYjsSyncType() === YjsMessage::YJS_MESSAGE_SYNC_STEP1) {
$stepsIncludeQuery = true;
} else {
$stepsToInsert[] = $step;
Expand Down Expand Up @@ -249,7 +253,7 @@ public function addStep(Document $document, Session $session, array $steps, int
$stepsToReturn = [];
foreach ($allSteps as $step) {
$message = YjsMessage::fromBase64($step->getData());
if ($message->getYjsMessageType() === YjsMessage::YJS_MESSAGE_SYNC && $message->getYjsSyncType() === YjsMessage::YJS_MESSAGE_SYNC_UPDATE) {
if ($message->isUpdate()) {
$stepsToReturn[] = $step;
}
}
Expand Down
21 changes: 21 additions & 0 deletions package-lock.json

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

1 change: 1 addition & 0 deletions package.json
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,7 @@
"vue-click-outside": "^1.1.0",
"vue-material-design-icons": "^5.3.1",
"webdav": "^5.9.0",
"y-indexeddb": "^9.0.12",
"y-prosemirror": "^1.3.7",
"y-protocols": "^1.0.7",
"yjs": "^13.6.29"
Expand Down
65 changes: 65 additions & 0 deletions playwright/e2e/autosave.spec.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,65 @@
/**
* SPDX-FileCopyrightText: 2025 Nextcloud GmbH and Nextcloud contributors
* SPDX-License-Identifier: AGPL-3.0-or-later
*/

import { expect, mergeTests } from '@playwright/test'
import { test as editorTest } from '../support/fixtures/editor'
import { test as offlineTest } from '../support/fixtures/offline'
import { test as uploadFileTest } from '../support/fixtures/upload-file'

const test = mergeTests(editorTest, offlineTest, uploadFileTest)

// As we switch on and off the network
// we cannot run tests in parallel.
test.describe.configure({ mode: 'serial' })

test.beforeEach(async ({ open }) => {
await open()
})

test('saves after 30 seconds', async ({ editor, page }) => {
await page.clock.install()
await expect(editor.el).toBeVisible()
await editor.typeHeading('Hello world')
await expect(editor.saveIndicator).toHaveAccessibleName(/Unsaved changes/)
await page.clock.fastForward(30_000)
await expect(editor.saveIndicator).not.toHaveAccessibleName(/Unsaved changes/)
// TODO: Why does this not work? await expect(await file.getContent()).toBe('## Hello world')
})

test('saves after being disconnected for 20 sec.', async ({
editor,
page,
setOffline,
setOnline,
}) => {
await page.clock.install()
await expect(editor.el).toBeVisible()
await editor.typeHeading('Hello world')
await expect(editor.saveIndicator).toHaveAccessibleName(/Unsaved changes/)
setOffline()
await page.clock.fastForward(20_000)
setOnline()
await page.clock.fastForward(20_000)
await expect(editor.saveIndicator).not.toHaveAccessibleName(/Unsaved changes/)
// TODO: Why does this not work? await expect(await file.getContent()).toBe('## Hello world')
})

test('saves after being disconnected for 2 minutes', async ({
editor,
page,
setOffline,
setOnline,
}) => {
await page.clock.install()
await expect(editor.el).toBeVisible()
await editor.typeHeading('Hello world')
await expect(editor.saveIndicator).toHaveAccessibleName(/Unsaved changes/)
setOffline()
await page.clock.fastForward(120_000)
setOnline()
await page.clock.fastForward(40_000)
await expect(editor.saveIndicator).not.toHaveAccessibleName(/Unsaved changes/)
// TODO: Why does this not work? await expect(await file.getContent()).toBe('## Hello world')
})
Loading
Loading