Merge pull request #13296 from owncloud/feat/share-links-and-passswords

feat: share links and passwords in embed mode

Author: LukasHirt

embed-mode/_index.md

@@ -35,11 +35,14 @@ To maintain uniformity and ease of handling, each event encapsulates the same st
 | Name | Data | Description |
 | --- | --- | --- |
 | **owncloud-embed:select** | Resource[] | Gets emitted when user selects resources or location via the select action |
-| **owncloud-embed:share** | string[] | Gets emitted when user selects resources and shares them via the "Share links" action |
+| **owncloud-embed:share** | string[] | **DEPRECATED**: Gets emitted when user selects resources and shares them via the "Share links" action. Use `owncloud-embed:share-links` instead. |
+| **owncloud-embed:share-links** | Array<{ url: string; password?: string }> | Gets emitted when user selects resources and shares them via the "Share link(s)" or "Share link(s) and password(s)" action. Each object contains the link URL and optionally the password (when shared with password). |
 | **owncloud-embed:cancel** | null | Gets emitted when user attempts to close the embedded instance via "Cancel" action |
 
 ### Example
 
+#### Selecting resources
+
 ```html
 <iframe src="https://my-owncloud-web-instance?embed=true"></iframe>
 
@@ -58,6 +61,28 @@ To maintain uniformity and ease of handling, each event encapsulates the same st
 </script>
 ```
 
+#### Sharing links with password
+
+```html
+<iframe src="https://my-owncloud-web-instance?embed=true"></iframe>
+
+<script>
+  function shareLinksEventHandler(event) {
+    if (event.data?.name !== 'owncloud-embed:share-links') {
+      return
+    }
+
+    const links = event.data.data // Array<{ url: string; password?: string }>
+
+    links.forEach(link => console.log("Link", link.url, "Password", link.password))
+
+    doSomethingWithSharedLinks(links)
+  }
+
+  window.addEventListener('message', shareLinksEventHandler)
+</script>
+```
+
 ## Location picker
 
 By default, the Embed mode allows users to select resources. In certain cases (e.g. uploading a file), this needs to be changed to allow selecting a location. This can be achieved by running the embed mode with additional parameter `embed-target=location`. With this parameter, resource selection is disabled and the selected resources array always includes the current folder as the only item.

releasing/deprecations.md

@@ -18,6 +18,7 @@ The following features are deprecated and **will be removed** in the next major
 
 | Component/Feature | Deprecated | Migration | Reference | Reasoning |
 |---|---|---|---|---|---|
+| `owncloud-embed:share` event | November 12, 2025 | Use `owncloud-embed:share-links` event instead | [PR #13296](https://github.com/owncloud/web/pull/13296) | New event provides structured data with both URL and optional password |
 
 ## Migration History