aboutsummaryrefslogtreecommitdiffstats
path: root/apps/files_sharing/src/models/Share.ts
diff options
context:
space:
mode:
Diffstat (limited to 'apps/files_sharing/src/models/Share.ts')
-rw-r--r--apps/files_sharing/src/models/Share.ts468
1 files changed, 468 insertions, 0 deletions
diff --git a/apps/files_sharing/src/models/Share.ts b/apps/files_sharing/src/models/Share.ts
new file mode 100644
index 00000000000..dab409853d0
--- /dev/null
+++ b/apps/files_sharing/src/models/Share.ts
@@ -0,0 +1,468 @@
+/**
+ * SPDX-FileCopyrightText: 2019 Nextcloud GmbH and Nextcloud contributors
+ * SPDX-License-Identifier: AGPL-3.0-or-later
+ */
+
+import type { ShareType } from '@nextcloud/sharing'
+import type { ShareAttribute } from '../sharing'
+import { isFileRequest } from '../services/SharingService'
+
+export default class Share {
+
+ _share
+
+ /**
+ * Create the share object
+ *
+ * @param {object} ocsData ocs request response
+ */
+ constructor(ocsData) {
+ if (ocsData.ocs && ocsData.ocs.data && ocsData.ocs.data[0]) {
+ ocsData = ocsData.ocs.data[0]
+ }
+
+ // convert int into boolean
+ ocsData.hide_download = !!ocsData.hide_download
+ ocsData.mail_send = !!ocsData.mail_send
+
+ if (ocsData.attributes && typeof ocsData.attributes === 'string') {
+ try {
+ ocsData.attributes = JSON.parse(ocsData.attributes)
+ } catch (e) {
+ console.warn('Could not parse share attributes returned by server', ocsData.attributes)
+ }
+ }
+ ocsData.attributes = ocsData.attributes ?? []
+
+ // store state
+ this._share = ocsData
+ }
+
+ /**
+ * Get the share state
+ * ! used for reactivity purpose
+ * Do not remove. It allow vuejs to
+ * inject its watchers into the #share
+ * state and make the whole class reactive
+ *
+ * @return {object} the share raw state
+ */
+ get state() {
+ return this._share
+ }
+
+ /**
+ * get the share id
+ */
+ get id(): number {
+ return this._share.id
+ }
+
+ /**
+ * Get the share type
+ */
+ get type(): ShareType {
+ return this._share.share_type
+ }
+
+ /**
+ * Get the share permissions
+ * See window.OC.PERMISSION_* variables
+ */
+ get permissions(): number {
+ return this._share.permissions
+ }
+
+ /**
+ * Get the share attributes
+ */
+ get attributes(): Array<ShareAttribute> {
+ return this._share.attributes
+ }
+
+ /**
+ * Set the share permissions
+ * See window.OC.PERMISSION_* variables
+ */
+ set permissions(permissions: number) {
+ this._share.permissions = permissions
+ }
+
+ // SHARE OWNER --------------------------------------------------
+ /**
+ * Get the share owner uid
+ */
+ get owner(): string {
+ return this._share.uid_owner
+ }
+
+ /**
+ * Get the share owner's display name
+ */
+ get ownerDisplayName(): string {
+ return this._share.displayname_owner
+ }
+
+ // SHARED WITH --------------------------------------------------
+ /**
+ * Get the share with entity uid
+ */
+ get shareWith(): string {
+ return this._share.share_with
+ }
+
+ /**
+ * Get the share with entity display name
+ * fallback to its uid if none
+ */
+ get shareWithDisplayName(): string {
+ return this._share.share_with_displayname
+ || this._share.share_with
+ }
+
+ /**
+ * Unique display name in case of multiple
+ * duplicates results with the same name.
+ */
+ get shareWithDisplayNameUnique(): string {
+ return this._share.share_with_displayname_unique
+ || this._share.share_with
+ }
+
+ /**
+ * Get the share with entity link
+ */
+ get shareWithLink(): string {
+ return this._share.share_with_link
+ }
+
+ /**
+ * Get the share with avatar if any
+ */
+ get shareWithAvatar(): string {
+ return this._share.share_with_avatar
+ }
+
+ // SHARED FILE OR FOLDER OWNER ----------------------------------
+ /**
+ * Get the shared item owner uid
+ */
+ get uidFileOwner(): string {
+ return this._share.uid_file_owner
+ }
+
+ /**
+ * Get the shared item display name
+ * fallback to its uid if none
+ */
+ get displaynameFileOwner(): string {
+ return this._share.displayname_file_owner
+ || this._share.uid_file_owner
+ }
+
+ // TIME DATA ----------------------------------------------------
+ /**
+ * Get the share creation timestamp
+ */
+ get createdTime(): number {
+ return this._share.stime
+ }
+
+ /**
+ * Get the expiration date
+ * @return {string} date with YYYY-MM-DD format
+ */
+ get expireDate(): string {
+ return this._share.expiration
+ }
+
+ /**
+ * Set the expiration date
+ * @param {string} date the share expiration date with YYYY-MM-DD format
+ */
+ set expireDate(date: string) {
+ this._share.expiration = date
+ }
+
+ // EXTRA DATA ---------------------------------------------------
+ /**
+ * Get the public share token
+ */
+ get token(): string {
+ return this._share.token
+ }
+
+ /**
+ * Get the share note if any
+ */
+ get note(): string {
+ return this._share.note
+ }
+
+ /**
+ * Set the share note if any
+ */
+ set note(note: string) {
+ this._share.note = note
+ }
+
+ /**
+ * Get the share label if any
+ * Should only exist on link shares
+ */
+ get label(): string {
+ return this._share.label ?? ''
+ }
+
+ /**
+ * Set the share label if any
+ * Should only be set on link shares
+ */
+ set label(label: string) {
+ this._share.label = label
+ }
+
+ /**
+ * Have a mail been sent
+ */
+ get mailSend(): boolean {
+ return this._share.mail_send === true
+ }
+
+ /**
+ * Hide the download button on public page
+ */
+ get hideDownload(): boolean {
+ return this._share.hide_download === true
+ }
+
+ /**
+ * Hide the download button on public page
+ */
+ set hideDownload(state: boolean) {
+ this._share.hide_download = state === true
+ }
+
+ /**
+ * Password protection of the share
+ */
+ get password():string {
+ return this._share.password
+ }
+
+ /**
+ * Password protection of the share
+ */
+ set password(password: string) {
+ this._share.password = password
+ }
+
+ /**
+ * Password expiration time
+ * @return {string} date with YYYY-MM-DD format
+ */
+ get passwordExpirationTime(): string {
+ return this._share.password_expiration_time
+ }
+
+ /**
+ * Password expiration time
+ * @param {string} passwordExpirationTime date with YYYY-MM-DD format
+ */
+ set passwordExpirationTime(passwordExpirationTime: string) {
+ this._share.password_expiration_time = passwordExpirationTime
+ }
+
+ /**
+ * Password protection by Talk of the share
+ */
+ get sendPasswordByTalk(): boolean {
+ return this._share.send_password_by_talk
+ }
+
+ /**
+ * Password protection by Talk of the share
+ *
+ * @param {boolean} sendPasswordByTalk whether to send the password by Talk or not
+ */
+ set sendPasswordByTalk(sendPasswordByTalk: boolean) {
+ this._share.send_password_by_talk = sendPasswordByTalk
+ }
+
+ // SHARED ITEM DATA ---------------------------------------------
+ /**
+ * Get the shared item absolute full path
+ */
+ get path(): string {
+ return this._share.path
+ }
+
+ /**
+ * Return the item type: file or folder
+ * @return {string} 'folder' | 'file'
+ */
+ get itemType(): string {
+ return this._share.item_type
+ }
+
+ /**
+ * Get the shared item mimetype
+ */
+ get mimetype(): string {
+ return this._share.mimetype
+ }
+
+ /**
+ * Get the shared item id
+ */
+ get fileSource(): number {
+ return this._share.file_source
+ }
+
+ /**
+ * Get the target path on the receiving end
+ * e.g the file /xxx/aaa will be shared in
+ * the receiving root as /aaa, the fileTarget is /aaa
+ */
+ get fileTarget(): string {
+ return this._share.file_target
+ }
+
+ /**
+ * Get the parent folder id if any
+ */
+ get fileParent(): number {
+ return this._share.file_parent
+ }
+
+ // PERMISSIONS Shortcuts
+
+ /**
+ * Does this share have READ permissions
+ */
+ get hasReadPermission(): boolean {
+ return !!((this.permissions & window.OC.PERMISSION_READ))
+ }
+
+ /**
+ * Does this share have CREATE permissions
+ */
+ get hasCreatePermission(): boolean {
+ return !!((this.permissions & window.OC.PERMISSION_CREATE))
+ }
+
+ /**
+ * Does this share have DELETE permissions
+ */
+ get hasDeletePermission(): boolean {
+ return !!((this.permissions & window.OC.PERMISSION_DELETE))
+ }
+
+ /**
+ * Does this share have UPDATE permissions
+ */
+ get hasUpdatePermission(): boolean {
+ return !!((this.permissions & window.OC.PERMISSION_UPDATE))
+ }
+
+ /**
+ * Does this share have SHARE permissions
+ */
+ get hasSharePermission(): boolean {
+ return !!((this.permissions & window.OC.PERMISSION_SHARE))
+ }
+
+ /**
+ * Does this share have download permissions
+ */
+ get hasDownloadPermission(): boolean {
+ const hasDisabledDownload = (attribute) => {
+ return attribute.scope === 'permissions' && attribute.key === 'download' && attribute.value === false
+ }
+ return this.attributes.some(hasDisabledDownload)
+ }
+
+ /**
+ * Is this mail share a file request ?
+ */
+ get isFileRequest(): boolean {
+ return isFileRequest(JSON.stringify(this.attributes))
+ }
+
+ set hasDownloadPermission(enabled) {
+ this.setAttribute('permissions', 'download', !!enabled)
+ }
+
+ setAttribute(scope, key, value) {
+ const attrUpdate = {
+ scope,
+ key,
+ value,
+ }
+
+ // try and replace existing
+ for (const i in this._share.attributes) {
+ const attr = this._share.attributes[i]
+ if (attr.scope === attrUpdate.scope && attr.key === attrUpdate.key) {
+ this._share.attributes.splice(i, 1, attrUpdate)
+ return
+ }
+ }
+
+ this._share.attributes.push(attrUpdate)
+ }
+
+ // PERMISSIONS Shortcuts for the CURRENT USER
+ // ! the permissions above are the share settings,
+ // ! meaning the permissions for the recipient
+ /**
+ * Can the current user EDIT this share ?
+ */
+ get canEdit(): boolean {
+ return this._share.can_edit === true
+ }
+
+ /**
+ * Can the current user DELETE this share ?
+ */
+ get canDelete(): boolean {
+ return this._share.can_delete === true
+ }
+
+ /**
+ * Top level accessible shared folder fileid for the current user
+ */
+ get viaFileid(): string {
+ return this._share.via_fileid
+ }
+
+ /**
+ * Top level accessible shared folder path for the current user
+ */
+ get viaPath(): string {
+ return this._share.via_path
+ }
+
+ // TODO: SORT THOSE PROPERTIES
+
+ get parent() {
+ return this._share.parent
+ }
+
+ get storageId(): string {
+ return this._share.storage_id
+ }
+
+ get storage(): number {
+ return this._share.storage
+ }
+
+ get itemSource(): number {
+ return this._share.item_source
+ }
+
+ get status() {
+ return this._share.status
+ }
+
+}