discourse-shared-edits/assets/javascripts/discourse/lib/shared-edits/debug.js
Sam 50d9317272
FEATURE: yjs-based collaborative editing with state recovery and cursor sync
Major overhaul of the shared edits plugin to improve reliability, robustness,
and developer experience:

**Backend**
- Extract Revise service for cleaner controller orchestration
- Add StateValidator for base64/Yjs safety, corruption detection, and recovery
- Centralize protocol constants (Ruby + JS) to avoid hardcoded strings
- Add state hash sync verification and vector validation endpoints
- Harden security (guardian checks), error handling, and resource cleanup
- Resize shared edit columns migration; add state_hash column

**Frontend**
- Decompose shared-edit-manager into focused modules: yjs-document,
  markdown-sync, rich-mode-sync, network-manager, encoding-utils
- Add cursor overlay and caret coordinate tracking for selection sharing
- Add ProseMirror extension for rich-mode collaborative editing
- Cache-busted Yjs bundle loading via hashed filenames
- Fix scroll drift during sync

**Testing & Tooling**
- Extensive new specs: state_validator, revision_controller, model, revise service
- New Ember acceptance tests: cursor, lifecycle, sync flows
- Add support scripts: fake_writer (Playwright), state_corruptor, debug_recovery
- Add support/lint wrapper for full CI lint suite
- Update dependencies and rebuild Yjs/y-prosemirror bundles
2026-02-13 11:34:52 +11:00

28 lines
630 B
JavaScript

/**
* Debug logging utilities for SharedEdits.
* Logs are only output in development mode.
*/
import { isDevelopment } from "discourse/lib/environment";
const PREFIX = "[SharedEdits]";
export function debugLog(...args) {
if (isDevelopment()) {
// eslint-disable-next-line no-console
console.log(PREFIX, ...args);
}
}
export function debugWarn(...args) {
if (isDevelopment()) {
// eslint-disable-next-line no-console
console.warn(PREFIX, ...args);
}
}
export function debugError(...args) {
if (isDevelopment()) {
// eslint-disable-next-line no-console
console.error(PREFIX, ...args);
}
}