Feature: Share links (#3996)

* Implement share links

Basic implementation of share links

Make certain share link fields not editable, automatically grant permissions on migrate

Updated styling, error messages from expired / deleted links

frontend code linting, reversable sharelink migration

testing coverage

Update translation strings

No links message

* Consolidate file response methods

* improvements to share links on mobile devices

* Refactor share links file_version

* Add docs for share links

* Apply suggestions from code review

* When filtering share links, use the timezone aware now()

* Removes extra call to setup directories for usage in testing

* FIx copied badge display on some browsers

* Move copy to ngx-clipboard library

---------

Co-authored-by: Trenton H <797416+stumpylog@users.noreply.github.com>

src-ui/src/app/components/common/share-links-dropdown/share-links-dropdown.component.ts

@@ -0,0 +1,149 @@
+import { Component, Input, OnInit } from '@angular/core'
+import { first } from 'rxjs'
+import {
+  PaperlessShareLink,
+  PaperlessFileVersion,
+} from 'src/app/data/paperless-share-link'
+import { ShareLinkService } from 'src/app/services/rest/share-link.service'
+import { ToastService } from 'src/app/services/toast.service'
+import { environment } from 'src/environments/environment'
+import { ClipboardService } from 'ngx-clipboard'
+
+@Component({
+  selector: 'app-share-links-dropdown',
+  templateUrl: './share-links-dropdown.component.html',
+  styleUrls: ['./share-links-dropdown.component.scss'],
+})
+export class ShareLinksDropdownComponent implements OnInit {
+  EXPIRATION_OPTIONS = [
+    { label: $localize`1 day`, value: 1 },
+    { label: $localize`7 days`, value: 7 },
+    { label: $localize`30 days`, value: 30 },
+    { label: $localize`Never`, value: null },
+  ]
+
+  @Input()
+  title = $localize`Share Links`
+
+  _documentId: number
+
+  @Input()
+  set documentId(id: number) {
+    if (id !== undefined) {
+      this._documentId = id
+      this.refresh()
+    }
+  }
+
+  @Input()
+  disabled: boolean = false
+
+  shareLinks: PaperlessShareLink[]
+
+  loading: boolean = false
+
+  copied: number
+
+  expirationDays: number = 7
+
+  archiveVersion: boolean = true
+
+  constructor(
+    private shareLinkService: ShareLinkService,
+    private toastService: ToastService,
+    private clipboardService: ClipboardService
+  ) {}
+
+  ngOnInit(): void {
+    if (this._documentId !== undefined) this.refresh()
+  }
+
+  refresh() {
+    if (this._documentId === undefined) return
+    this.loading = true
+    this.shareLinkService
+      .getLinksForDocument(this._documentId)
+      .pipe(first())
+      .subscribe({
+        next: (results) => {
+          this.loading = false
+          this.shareLinks = results
+        },
+        error: (e) => {
+          this.toastService.showError(
+            $localize`Error retrieving links`,
+            10000,
+            e
+          )
+        },
+      })
+  }
+
+  getShareUrl(link: PaperlessShareLink): string {
+    return `${environment.apiBaseUrl.replace('api', 'share')}${link.slug}`
+  }
+
+  getDaysRemaining(link: PaperlessShareLink): string {
+    const days: number = Math.ceil(
+      (Date.parse(link.expiration) - Date.now()) / (1000 * 60 * 60 * 24)
+    )
+    return days === 1 ? $localize`1 day` : $localize`${days} days`
+  }
+
+  copy(link: PaperlessShareLink) {
+    this.clipboardService.copy(this.getShareUrl(link))
+    this.copied = link.id
+    setTimeout(() => {
+      this.copied = null
+    }, 3000)
+  }
+
+  canShare(link: PaperlessShareLink): boolean {
+    return (
+      navigator?.canShare && navigator.canShare({ url: this.getShareUrl(link) })
+    )
+  }
+
+  share(link: PaperlessShareLink) {
+    navigator.share({ url: this.getShareUrl(link) })
+  }
+
+  delete(link: PaperlessShareLink) {
+    this.shareLinkService.delete(link).subscribe({
+      next: () => {
+        this.refresh()
+      },
+      error: (e) => {
+        this.toastService.showError($localize`Error deleting link`, 10000, e)
+      },
+    })
+  }
+
+  createLink() {
+    let expiration
+    if (this.expirationDays) {
+      expiration = new Date()
+      expiration.setDate(expiration.getDate() + this.expirationDays)
+    }
+    this.loading = true
+    this.shareLinkService
+      .createLinkForDocument(
+        this._documentId,
+        this.archiveVersion
+          ? PaperlessFileVersion.Archive
+          : PaperlessFileVersion.Original,
+        expiration
+      )
+      .subscribe({
+        next: (result) => {
+          this.loading = false
+          this.copy(result)
+          this.refresh()
+        },
+        error: (e) => {
+          this.loading = false
+          this.toastService.showError($localize`Error creating link`, 10000, e)
+        },
+      })
+  }
+}