$ show owncloud/notes
This repository is the Notes app for ownCloud Server, a distraction-free note-taking plugin that stores notes as plain text files in the user's cloud storage. It provides a web-based editor with markdown support (via mdEdit) and syntax highlighting (via Prism), along with a RESTful API (v0.2) for third-party integration. The backend is PHP 8.3 following ownCloud's app framework: controllers handle HTTP requests, services contain business logic, and a simple entity layer maps files to Note objects. The frontend is an AngularJS 1.8 single-page application using Restangular for API communication, with custom directives for autofocus, debounced saving, and editor integration. Notes are persisted as .txt, .md, .org, or .note files in a per-user 'Notes' folder, with filename collision resolution and directory traversal prevention. The app supports favoriting via ownCloud's tag system and remembers the last viewed note across sessions. The codebase is well-structured with unit tests for both PHP and JavaScript, acceptance tests, and CI/CD pipelines. It has been actively maintained with recent security updates (patched AngularJS, underscore, Prism) and a move to in-repo translations. While the architecture is standard for ownCloud plugins and the frontend uses an older AngularJS version, the implementation is clean, the business logic is robust, and there are a few reusable patterns like the async save queue and a Python duplicate-key checker for translation files.
The LLM identified 3 files worth highlighting for reuse:
Implements a flush-lock queue for batching note save operations. When a note is added, it collects all pending updates, fires PUT requests in parallel via $q.all, and recursively flushes the queue once the batch completes. The isSaving() method exposes the flush-lock state to the UI for showing a saving indicator. This pattern is self-contained (only depends on $q) and can be extracted into any AngularJS project needing debounced, batched persistence.
A reusable AngularJS directive that fires an expression only after a 300ms pause in input (keyboard or paste). It cancels the pending timeout on each new event, effectively debouncing rapid edits. The directive is attribute-restricted and can be applied to any input or textarea, making it a clean, extractable pattern for delayed-change handling.
A standalone Python script that detects duplicate translation keys in both .js and .json catalog files. It uses json.loads with an object_pairs_hook to capture duplicate keys before Python's dict deduplication collapses them, and includes a custom brace-matcher to extract the JSON object from OC.L10N.register() calls in .js files. The script is well-documented, handles edge cases (nested objects, string escapes), and can be reused in any project with similar key-value translation catalogs.