[skjnldsv]

• Relates to: [RFC] Files Recommendations: Improve algorithm and data sources recommendations#888

Summary

Reading a file isn't opening it. BeforeNodeReadEvent fires for sync clients, previews and downloads, so apps can't tell what a user actually works with.

This adds POST /ocs/v2.php/apps/files/api/v1/opened with a fileId. It dispatches a new NodeOpenedEvent with the node and the user. It's public on purpose, so the viewer, the "Open locally" action and desktop/mobile clients can all report opens. Recommendations will use it for recent and frequent files.

Folders are accepted too. The rate limit (100/min per user) is a guess, happy to adjust.

curl -u alice:alice -X POST -H 'OCS-APIRequest: true' -H 'Content-Type: application/json' \
  -d '{"fileId":52}' https://cloud/ocs/v2.php/apps/files/api/v1/opened
{"ocs":{"meta":{"status":"ok","statuscode":200,"message":"OK"},"data":[]}}

Next

• feat: report the files the viewer opens to the server nextcloud-libraries/nextcloud-viewer#180
• feat(files): report files opened locally as opened #65995

Checklist

• Code is properly formatted
• Sign-off message is added to all commits
• Tests (unit, integration, api and/or acceptance) are included
• Screenshots before/after for front-end changes
• Documentation (manuals or wiki) has been updated or is not required
• Backports requested where applicable (ex: critical bugfixes)
• Labels added where applicable (ex: bug/enhancement, 3. to review, feature component)
• Milestone added for target branch/version (ex: 32.x for stable32)

AI (if applicable)

• The content of this PR was partly or fully generated using AI

👾 This pull request was assisted by Claude Code, commits carry an Assisted-by trailer.

[skjnldsv]

Ready! it's quite straightforward :)

[skjnldsv]

CI failures are unrelated: the PHPUnit ones fail the same way on other PRs today (e.g. https://github.com/nextcloud/server/actions/runs/40871288892), Azure fails on Azurite XML parsing, and Playwright passed on re-run.