box-node-sdk
Version:
Official SDK for Box Platform APIs
427 lines (426 loc) • 14.7 kB
text/typescript
import { serializeFolderMini } from './folderMini';
import { deserializeFolderMini } from './folderMini';
import { serializeUserMini } from './userMini';
import { deserializeUserMini } from './userMini';
import { serializeDateTime } from '../internal/utils';
import { deserializeDateTime } from '../internal/utils';
import { FolderMini } from './folderMini';
import { UserMini } from './userMini';
import { BoxSdkError } from '../box/errors';
import { DateTime } from '../internal/utils';
import { SerializedData } from '../serialization/json';
import { sdIsEmpty } from '../serialization/json';
import { sdIsBoolean } from '../serialization/json';
import { sdIsNumber } from '../serialization/json';
import { sdIsString } from '../serialization/json';
import { sdIsList } from '../serialization/json';
import { sdIsMap } from '../serialization/json';
export type TrashFolderRestoredTypeField = 'folder';
export interface TrashFolderRestoredPathCollectionField {
/**
* The number of folders in this list. */
readonly totalCount: number;
/**
* The parent folders for this item. */
readonly entries: readonly FolderMini[];
readonly rawData?: SerializedData;
}
export type TrashFolderRestoredItemStatusField =
| 'active'
| 'trashed'
| 'deleted'
| string;
export interface TrashFolderRestored {
/**
* 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?: TrashFolderRestoredTypeField;
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?: TrashFolderRestoredPathCollectionField;
readonly createdBy?: UserMini;
readonly modifiedBy?: UserMini;
/**
* The time at which this folder was put in the
* trash - becomes `null` after restore. */
readonly trashedAt?: string | null;
/**
* The time at which this folder is expected to be purged
* from the trash - becomes `null` after restore. */
readonly purgedAt?: string | 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 file. This will
* be `null` if a folder had been trashed, even though the original shared
* link does become active again. */
readonly sharedLink?: string | null;
/**
* The folder upload email for this folder. This will
* be `null` if a folder has been trashed, even though the original upload
* email does become active again. */
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?: TrashFolderRestoredItemStatusField;
readonly rawData?: SerializedData;
}
export function serializeTrashFolderRestoredTypeField(
val: TrashFolderRestoredTypeField,
): SerializedData {
return val;
}
export function deserializeTrashFolderRestoredTypeField(
val: SerializedData,
): TrashFolderRestoredTypeField {
if (val == 'folder') {
return val;
}
throw new BoxSdkError({
message: "Can't deserialize TrashFolderRestoredTypeField",
});
}
export function serializeTrashFolderRestoredPathCollectionField(
val: TrashFolderRestoredPathCollectionField,
): SerializedData {
return {
['total_count']: val.totalCount,
['entries']: val.entries.map(function (item: FolderMini): SerializedData {
return serializeFolderMini(item);
}) as readonly any[],
};
}
export function deserializeTrashFolderRestoredPathCollectionField(
val: SerializedData,
): TrashFolderRestoredPathCollectionField {
if (!sdIsMap(val)) {
throw new BoxSdkError({
message: 'Expecting a map for "TrashFolderRestoredPathCollectionField"',
});
}
if (val.total_count == void 0) {
throw new BoxSdkError({
message:
'Expecting "total_count" of type "TrashFolderRestoredPathCollectionField" to be defined',
});
}
if (!sdIsNumber(val.total_count)) {
throw new BoxSdkError({
message:
'Expecting number for "total_count" of type "TrashFolderRestoredPathCollectionField"',
});
}
const totalCount: number = val.total_count;
if (val.entries == void 0) {
throw new BoxSdkError({
message:
'Expecting "entries" of type "TrashFolderRestoredPathCollectionField" to be defined',
});
}
if (!sdIsList(val.entries)) {
throw new BoxSdkError({
message:
'Expecting array for "entries" of type "TrashFolderRestoredPathCollectionField"',
});
}
const entries: readonly FolderMini[] = sdIsList(val.entries)
? (val.entries.map(function (itm: SerializedData): FolderMini {
return deserializeFolderMini(itm);
}) as readonly any[])
: [];
return {
totalCount: totalCount,
entries: entries,
} satisfies TrashFolderRestoredPathCollectionField;
}
export function serializeTrashFolderRestoredItemStatusField(
val: TrashFolderRestoredItemStatusField,
): SerializedData {
return val;
}
export function deserializeTrashFolderRestoredItemStatusField(
val: SerializedData,
): TrashFolderRestoredItemStatusField {
if (val == 'active') {
return val;
}
if (val == 'trashed') {
return val;
}
if (val == 'deleted') {
return val;
}
if (sdIsString(val)) {
return val;
}
throw new BoxSdkError({
message: "Can't deserialize TrashFolderRestoredItemStatusField",
});
}
export function serializeTrashFolderRestored(
val: TrashFolderRestored,
): SerializedData {
return {
['id']: val.id,
['etag']: val.etag,
['type']:
val.type == void 0
? val.type
: serializeTrashFolderRestoredTypeField(val.type),
['sequence_id']: val.sequenceId,
['name']: val.name,
['created_at']:
val.createdAt == void 0
? val.createdAt
: serializeDateTime(val.createdAt),
['modified_at']:
val.modifiedAt == void 0
? val.modifiedAt
: serializeDateTime(val.modifiedAt),
['description']: val.description,
['size']: val.size,
['path_collection']:
val.pathCollection == void 0
? val.pathCollection
: serializeTrashFolderRestoredPathCollectionField(val.pathCollection),
['created_by']:
val.createdBy == void 0
? val.createdBy
: serializeUserMini(val.createdBy),
['modified_by']:
val.modifiedBy == void 0
? val.modifiedBy
: serializeUserMini(val.modifiedBy),
['trashed_at']: val.trashedAt,
['purged_at']: val.purgedAt,
['content_created_at']:
val.contentCreatedAt == void 0
? val.contentCreatedAt
: serializeDateTime(val.contentCreatedAt),
['content_modified_at']:
val.contentModifiedAt == void 0
? val.contentModifiedAt
: serializeDateTime(val.contentModifiedAt),
['owned_by']:
val.ownedBy == void 0 ? val.ownedBy : serializeUserMini(val.ownedBy),
['shared_link']: val.sharedLink,
['folder_upload_email']: val.folderUploadEmail,
['parent']:
val.parent == void 0 ? val.parent : serializeFolderMini(val.parent),
['item_status']:
val.itemStatus == void 0
? val.itemStatus
: serializeTrashFolderRestoredItemStatusField(val.itemStatus),
};
}
export function deserializeTrashFolderRestored(
val: SerializedData,
): TrashFolderRestored {
if (!sdIsMap(val)) {
throw new BoxSdkError({
message: 'Expecting a map for "TrashFolderRestored"',
});
}
if (!(val.id == void 0) && !sdIsString(val.id)) {
throw new BoxSdkError({
message: 'Expecting string for "id" of type "TrashFolderRestored"',
});
}
const id: undefined | string = val.id == void 0 ? void 0 : val.id;
if (!(val.etag == void 0) && !sdIsString(val.etag)) {
throw new BoxSdkError({
message: 'Expecting string for "etag" of type "TrashFolderRestored"',
});
}
const etag: undefined | string = val.etag == void 0 ? void 0 : val.etag;
const type: undefined | TrashFolderRestoredTypeField =
val.type == void 0
? void 0
: deserializeTrashFolderRestoredTypeField(val.type);
if (!(val.sequence_id == void 0) && !sdIsString(val.sequence_id)) {
throw new BoxSdkError({
message:
'Expecting string for "sequence_id" of type "TrashFolderRestored"',
});
}
const sequenceId: undefined | string =
val.sequence_id == void 0 ? void 0 : val.sequence_id;
if (!(val.name == void 0) && !sdIsString(val.name)) {
throw new BoxSdkError({
message: 'Expecting string for "name" of type "TrashFolderRestored"',
});
}
const name: undefined | string = val.name == void 0 ? void 0 : val.name;
if (!(val.created_at == void 0) && !sdIsString(val.created_at)) {
throw new BoxSdkError({
message:
'Expecting string for "created_at" of type "TrashFolderRestored"',
});
}
const createdAt: undefined | DateTime =
val.created_at == void 0 ? void 0 : deserializeDateTime(val.created_at);
if (!(val.modified_at == void 0) && !sdIsString(val.modified_at)) {
throw new BoxSdkError({
message:
'Expecting string for "modified_at" of type "TrashFolderRestored"',
});
}
const modifiedAt: undefined | DateTime =
val.modified_at == void 0 ? void 0 : deserializeDateTime(val.modified_at);
if (!(val.description == void 0) && !sdIsString(val.description)) {
throw new BoxSdkError({
message:
'Expecting string for "description" of type "TrashFolderRestored"',
});
}
const description: undefined | string =
val.description == void 0 ? void 0 : val.description;
if (!(val.size == void 0) && !sdIsNumber(val.size)) {
throw new BoxSdkError({
message: 'Expecting number for "size" of type "TrashFolderRestored"',
});
}
const size: undefined | number = val.size == void 0 ? void 0 : val.size;
const pathCollection: undefined | TrashFolderRestoredPathCollectionField =
val.path_collection == void 0
? void 0
: deserializeTrashFolderRestoredPathCollectionField(val.path_collection);
const createdBy: undefined | UserMini =
val.created_by == void 0 ? void 0 : deserializeUserMini(val.created_by);
const modifiedBy: undefined | UserMini =
val.modified_by == void 0 ? void 0 : deserializeUserMini(val.modified_by);
if (!(val.trashed_at == void 0) && !sdIsString(val.trashed_at)) {
throw new BoxSdkError({
message:
'Expecting string for "trashed_at" of type "TrashFolderRestored"',
});
}
const trashedAt: undefined | string =
val.trashed_at == void 0 ? void 0 : val.trashed_at;
if (!(val.purged_at == void 0) && !sdIsString(val.purged_at)) {
throw new BoxSdkError({
message: 'Expecting string for "purged_at" of type "TrashFolderRestored"',
});
}
const purgedAt: undefined | string =
val.purged_at == void 0 ? void 0 : val.purged_at;
if (
!(val.content_created_at == void 0) &&
!sdIsString(val.content_created_at)
) {
throw new BoxSdkError({
message:
'Expecting string for "content_created_at" of type "TrashFolderRestored"',
});
}
const contentCreatedAt: undefined | DateTime =
val.content_created_at == void 0
? void 0
: deserializeDateTime(val.content_created_at);
if (
!(val.content_modified_at == void 0) &&
!sdIsString(val.content_modified_at)
) {
throw new BoxSdkError({
message:
'Expecting string for "content_modified_at" of type "TrashFolderRestored"',
});
}
const contentModifiedAt: undefined | DateTime =
val.content_modified_at == void 0
? void 0
: deserializeDateTime(val.content_modified_at);
const ownedBy: undefined | UserMini =
val.owned_by == void 0 ? void 0 : deserializeUserMini(val.owned_by);
if (!(val.shared_link == void 0) && !sdIsString(val.shared_link)) {
throw new BoxSdkError({
message:
'Expecting string for "shared_link" of type "TrashFolderRestored"',
});
}
const sharedLink: undefined | string =
val.shared_link == void 0 ? void 0 : val.shared_link;
if (
!(val.folder_upload_email == void 0) &&
!sdIsString(val.folder_upload_email)
) {
throw new BoxSdkError({
message:
'Expecting string for "folder_upload_email" of type "TrashFolderRestored"',
});
}
const folderUploadEmail: undefined | string =
val.folder_upload_email == void 0 ? void 0 : val.folder_upload_email;
const parent: undefined | FolderMini =
val.parent == void 0 ? void 0 : deserializeFolderMini(val.parent);
const itemStatus: undefined | TrashFolderRestoredItemStatusField =
val.item_status == void 0
? void 0
: deserializeTrashFolderRestoredItemStatusField(val.item_status);
return {
id: id,
etag: etag,
type: type,
sequenceId: sequenceId,
name: name,
createdAt: createdAt,
modifiedAt: modifiedAt,
description: description,
size: size,
pathCollection: pathCollection,
createdBy: createdBy,
modifiedBy: modifiedBy,
trashedAt: trashedAt,
purgedAt: purgedAt,
contentCreatedAt: contentCreatedAt,
contentModifiedAt: contentModifiedAt,
ownedBy: ownedBy,
sharedLink: sharedLink,
folderUploadEmail: folderUploadEmail,
parent: parent,
itemStatus: itemStatus,
} satisfies TrashFolderRestored;
}