UNPKG

box-node-sdk

Version:

Official SDK for Box Platform APIs

204 lines (203 loc) 8.74 kB
import { UserMini } from './userMini'; import { FolderMini } from './folderMini'; import { DateTime } from '../internal/utils'; import { SerializedData } from '../serialization/json'; export type TrashFolderTypeField = 'folder'; export type TrashFolderPathCollectionEntriesTypeField = 'folder'; export interface TrashFolderPathCollectionEntriesField { /** * The value will always be `folder`. */ readonly type?: TrashFolderPathCollectionEntriesTypeField; /** * The unique identifier that represent a folder. */ readonly id?: string; /** * This field is null for the Trash folder. */ readonly sequenceId?: string | null; /** * This field is null for the Trash folder. */ readonly etag?: string | null; /** * The name of the Trash folder. */ readonly name?: string; readonly rawData?: SerializedData; } export interface TrashFolderPathCollectionField { /** * The number of folders in this list. */ readonly totalCount: number; /** * Array of folders for this item's path collection. */ readonly entries: readonly TrashFolderPathCollectionEntriesField[]; readonly rawData?: SerializedData; } export type TrashFolderItemStatusField = 'active' | 'trashed' | 'deleted' | string; export declare class TrashFolder { /** * The unique identifier that represent a folder. * * The ID for any folder can be determined * by visiting a folder in the web application * and copying the ID from the URL. For example, * for the URL `https://*.app.box.com/folders/123` * the `folder_id` is `123`. */ readonly id: string; /** * The HTTP `etag` of this folder. This can be used within some API * endpoints in the `If-Match` and `If-None-Match` headers to only * perform changes on the folder if (no) changes have happened. */ readonly etag?: string | null; /** * The value will always be `folder`. */ readonly type: TrashFolderTypeField; readonly sequenceId?: string; /** * The name of the folder. */ readonly name: string; /** * The date and time when the folder was created. This value may * be `null` for some folders such as the root folder or the trash * folder. */ readonly createdAt?: DateTime | null; /** * The date and time when the folder was last updated. This value may * be `null` for some folders such as the root folder or the trash * folder. */ readonly modifiedAt?: DateTime | null; readonly description: string; /** * The folder size in bytes. * * Be careful parsing this integer as its * value can get very large. */ readonly size: number; readonly pathCollection: TrashFolderPathCollectionField; readonly createdBy: UserMini; readonly modifiedBy: UserMini; /** * The time at which this folder was put in the trash. */ readonly trashedAt?: DateTime | null; /** * The time at which this folder is expected to be purged * from the trash. */ readonly purgedAt?: DateTime | null; /** * The date and time at which this folder was originally * created. */ readonly contentCreatedAt?: DateTime | null; /** * The date and time at which this folder was last updated. */ readonly contentModifiedAt?: DateTime | null; readonly ownedBy: UserMini; /** * The shared link for this folder. This will * be `null` if a folder has been trashed, since the link will no longer * be active. */ readonly sharedLink?: string | null; /** * The folder upload email for this folder. This will * be `null` if a folder has been trashed, since the upload will no longer * work. */ readonly folderUploadEmail?: string | null; readonly parent?: FolderMini; /** * Defines if this item has been deleted or not. * * * `active` when the item has is not in the trash * * `trashed` when the item has been moved to the trash but not deleted * * `deleted` when the item has been permanently deleted. */ readonly itemStatus: TrashFolderItemStatusField; readonly rawData?: SerializedData; constructor(fields: Omit<TrashFolder, 'type'> & Partial<Pick<TrashFolder, 'type'>>); } export interface TrashFolderInput { /** * The unique identifier that represent a folder. * * The ID for any folder can be determined * by visiting a folder in the web application * and copying the ID from the URL. For example, * for the URL `https://*.app.box.com/folders/123` * the `folder_id` is `123`. */ readonly id: string; /** * The HTTP `etag` of this folder. This can be used within some API * endpoints in the `If-Match` and `If-None-Match` headers to only * perform changes on the folder if (no) changes have happened. */ readonly etag?: string | null; /** * The value will always be `folder`. */ readonly type?: TrashFolderTypeField; readonly sequenceId?: string; /** * The name of the folder. */ readonly name: string; /** * The date and time when the folder was created. This value may * be `null` for some folders such as the root folder or the trash * folder. */ readonly createdAt?: DateTime | null; /** * The date and time when the folder was last updated. This value may * be `null` for some folders such as the root folder or the trash * folder. */ readonly modifiedAt?: DateTime | null; readonly description: string; /** * The folder size in bytes. * * Be careful parsing this integer as its * value can get very large. */ readonly size: number; readonly pathCollection: TrashFolderPathCollectionField; readonly createdBy: UserMini; readonly modifiedBy: UserMini; /** * The time at which this folder was put in the trash. */ readonly trashedAt?: DateTime | null; /** * The time at which this folder is expected to be purged * from the trash. */ readonly purgedAt?: DateTime | null; /** * The date and time at which this folder was originally * created. */ readonly contentCreatedAt?: DateTime | null; /** * The date and time at which this folder was last updated. */ readonly contentModifiedAt?: DateTime | null; readonly ownedBy: UserMini; /** * The shared link for this folder. This will * be `null` if a folder has been trashed, since the link will no longer * be active. */ readonly sharedLink?: string | null; /** * The folder upload email for this folder. This will * be `null` if a folder has been trashed, since the upload will no longer * work. */ readonly folderUploadEmail?: string | null; readonly parent?: FolderMini; /** * Defines if this item has been deleted or not. * * * `active` when the item has is not in the trash * * `trashed` when the item has been moved to the trash but not deleted * * `deleted` when the item has been permanently deleted. */ readonly itemStatus: TrashFolderItemStatusField; readonly rawData?: SerializedData; } export declare function serializeTrashFolderTypeField(val: TrashFolderTypeField): SerializedData; export declare function deserializeTrashFolderTypeField(val: SerializedData): TrashFolderTypeField; export declare function serializeTrashFolderPathCollectionEntriesTypeField(val: TrashFolderPathCollectionEntriesTypeField): SerializedData; export declare function deserializeTrashFolderPathCollectionEntriesTypeField(val: SerializedData): TrashFolderPathCollectionEntriesTypeField; export declare function serializeTrashFolderPathCollectionEntriesField(val: TrashFolderPathCollectionEntriesField): SerializedData; export declare function deserializeTrashFolderPathCollectionEntriesField(val: SerializedData): TrashFolderPathCollectionEntriesField; export declare function serializeTrashFolderPathCollectionField(val: TrashFolderPathCollectionField): SerializedData; export declare function deserializeTrashFolderPathCollectionField(val: SerializedData): TrashFolderPathCollectionField; export declare function serializeTrashFolderItemStatusField(val: TrashFolderItemStatusField): SerializedData; export declare function deserializeTrashFolderItemStatusField(val: SerializedData): TrashFolderItemStatusField; export declare function serializeTrashFolder(val: TrashFolder): SerializedData; export declare function deserializeTrashFolder(val: SerializedData): TrashFolder; export declare function serializeTrashFolderInput(val: TrashFolderInput): SerializedData; export declare function deserializeTrashFolderInput(val: SerializedData): TrashFolderInput;