@unofficialbox/box-open-sdk 0.3.1 → 0.4.1

package/dist/types/models/schemas/sign_requests.d.ts

@@ -0,0 +1,136 @@
+import type { FileBase, FileMini, FolderMini, SignRequestCreateSignerRole, SignRequestSignerInputContentType, SignRequestSignerInputValidation } from '../schemas.js';
+export interface SignRequest {
+    is_document_preparation_needed?: boolean;
+    redirect_url?: string | null;
+    declined_redirect_url?: string | null;
+    are_text_signatures_enabled?: boolean;
+    email_subject?: string | null;
+    email_message?: string | null;
+    are_reminders_enabled?: boolean;
+    name?: string;
+    prefill_tags?: Array<SignRequestPrefillTag>;
+    days_valid?: number | null;
+    external_id?: string | null;
+    template_id?: string | null;
+    external_system_name?: string | null;
+    request_flow?: string | null;
+    type?: SignRequestType;
+    source_files?: Array<FileBase>;
+    signers?: Array<SignRequestSigner>;
+    signature_color?: string | null;
+    id?: string;
+    prepare_url?: string | null;
+    signing_log?: FileMini;
+    status?: SignRequestStatus;
+    sign_files?: SignRequestSignFiles;
+    auto_expire_at?: string | null;
+    parent_folder?: FolderMini;
+    collaborator_level?: string | null;
+    short_id?: string;
+    created_at?: string;
+    finished_at?: string | null;
+    error_code?: string | null;
+    sender_email?: string | null;
+    sender_id?: number | null;
+}
+export interface SignRequestCancelRequest {
+    reason?: string;
+}
+export interface SignRequestCreateRequest {
+    is_document_preparation_needed?: boolean;
+    redirect_url?: string | null;
+    declined_redirect_url?: string | null;
+    are_text_signatures_enabled?: boolean;
+    email_subject?: string | null;
+    email_message?: string | null;
+    are_reminders_enabled?: boolean;
+    name?: string;
+    prefill_tags?: Array<SignRequestPrefillTag>;
+    days_valid?: number | null;
+    external_id?: string | null;
+    template_id?: string | null;
+    external_system_name?: string | null;
+    request_flow?: string | null;
+    source_files?: Array<FileBase> | null;
+    signature_color?: SignRequestCreateRequestSignatureColor | null;
+    signers: Array<SignRequestCreateSigner>;
+    parent_folder?: FolderMini;
+}
+export interface SignRequestCreateSigner {
+    email?: string | null;
+    role?: SignRequestCreateSignerRole;
+    is_in_person?: boolean;
+    order?: number;
+    embed_url_external_user_id?: string | null;
+    redirect_url?: string | null;
+    declined_redirect_url?: string | null;
+    login_required?: boolean | null;
+    verification_phone_number?: string | null;
+    password?: string | null;
+    signer_group_id?: string | null;
+    suppress_notifications?: boolean | null;
+    language?: string | null;
+}
+export interface SignRequestPrefillTag {
+    document_tag_id?: string | null;
+    text_value?: string | null;
+    checkbox_value?: boolean | null;
+    date_value?: string | null;
+}
+export interface SignRequests {
+    limit?: number;
+    next_marker?: string | null;
+    entries?: Array<SignRequest>;
+}
+export interface SignRequestSigner {
+    email: string | null;
+    role?: SignRequestCreateSignerRole;
+    is_in_person?: boolean;
+    order?: number;
+    embed_url_external_user_id?: string | null;
+    redirect_url?: string | null;
+    declined_redirect_url?: string | null;
+    login_required?: boolean | null;
+    verification_phone_number?: string | null;
+    password?: string | null;
+    signer_group_id?: string | null;
+    suppress_notifications?: boolean | null;
+    language?: string | null;
+    has_viewed_document?: boolean;
+    signer_decision?: SignRequestSignerSignerDecision | null;
+    inputs?: Array<SignRequestSignerInput>;
+    embed_url?: string | null;
+    iframeable_embed_url?: string | null;
+    attachments?: Array<SignRequestSignerAttachment> | null;
+}
+export interface SignRequestSignerAttachment {
+    id?: string | null;
+    name?: string | null;
+}
+export interface SignRequestSignerInput {
+    document_tag_id?: string | null;
+    text_value?: string | null;
+    checkbox_value?: boolean | null;
+    date_value?: string | null;
+    type?: SignRequestSignerInputType;
+    content_type?: SignRequestSignerInputContentType;
+    page_index: number;
+    read_only?: boolean;
+    validation?: SignRequestSignerInputValidation | null;
+    reason?: string | null;
+    is_validated?: boolean | null;
+}
+export type SignRequestType = "sign-request" | (string & {});
+export type SignRequestStatus = "converting" | "created" | "sent" | "viewed" | "signed" | "cancelled" | "declined" | "error" | "error_converting" | "error_sending" | "expired" | "finalizing" | "error_finalizing" | (string & {});
+export interface SignRequestSignFiles {
+    files?: Array<FileMini>;
+    is_ready_for_download?: boolean;
+}
+export type SignRequestCreateRequestSignatureColor = "blue" | "black" | "red" | (string & {});
+export type SignerDecisionType = "signed" | "declined" | (string & {});
+export interface SignRequestSignerSignerDecision {
+    type?: SignerDecisionType;
+    finalized_at?: string;
+    additional_info?: string | null;
+}
+export type SignRequestSignerInputType = "signature" | "date" | "text" | "checkbox" | "radio" | "dropdown" | (string & {});

package/dist/types/models/schemas/sign_templates.d.ts

@@ -0,0 +1,90 @@
+import type { FileMini, FolderMini, SignRequestCreateSignerRole, SignRequestSignerInputContentType, SignRequestSignerInputEmailValidationValidationType, SignRequestSignerInputValidation } from '../schemas.js';
+export interface SignTemplate {
+    type?: SignTemplateType;
+    id?: string;
+    name?: string | null;
+    email_subject?: string | null;
+    email_message?: string | null;
+    days_valid?: number | null;
+    parent_folder?: FolderMini;
+    source_files?: Array<FileMini>;
+    are_fields_locked?: boolean;
+    are_options_locked?: boolean;
+    are_recipients_locked?: boolean;
+    are_email_settings_locked?: boolean;
+    are_files_locked?: boolean;
+    signers?: Array<TemplateSigner>;
+    additional_info?: SignTemplateAdditionalInfo;
+    ready_sign_link?: SignTemplateReadySignLink | null;
+    custom_branding?: SignTemplateCustomBranding | null;
+    request_flow?: string | null;
+}
+export interface SignTemplates {
+    limit?: number;
+    next_marker?: string | null;
+    prev_marker?: string | null;
+    entries?: Array<SignTemplate>;
+}
+export interface TemplateSigner {
+    inputs?: Array<TemplateSignerInput>;
+    email?: string | null;
+    role?: SignRequestCreateSignerRole;
+    is_in_person?: boolean;
+    order?: number;
+    signer_group_id?: string | null;
+    label?: string | null;
+    public_id?: string;
+    is_password_required?: boolean | null;
+    is_phone_number_required?: boolean | null;
+    login_required?: boolean | null;
+}
+export interface TemplateSignerInput {
+    document_tag_id?: string | null;
+    text_value?: string | null;
+    checkbox_value?: boolean | null;
+    date_value?: string | null;
+    type?: TemplateSignerInputType;
+    content_type?: SignRequestSignerInputContentType;
+    is_required?: boolean;
+    page_index: number;
+    document_id?: string | null;
+    dropdown_choices?: Array<string> | null;
+    group_id?: string | null;
+    coordinates?: TemplateSignerInputCoordinates;
+    dimensions?: TemplateSignerInputDimensions;
+    label?: string | null;
+    read_only?: boolean;
+    validation?: SignRequestSignerInputValidation | null;
+}
+export type SignTemplateType = "sign-template" | (string & {});
+export type AdditionalInfoNonEditable = "email_subject" | "email_message" | "name" | "days_valid" | "signers" | "source_files" | (string & {});
+export interface AdditionalInfoRequired {
+    signers?: Array<Array<SignRequestSignerInputEmailValidationValidationType>>;
+}
+export interface SignTemplateAdditionalInfo {
+    non_editable?: Array<AdditionalInfoNonEditable>;
+    required?: AdditionalInfoRequired;
+}
+export interface SignTemplateReadySignLink {
+    url?: string;
+    name?: string | null;
+    instructions?: string | null;
+    folder_id?: string | null;
+    is_notification_disabled?: boolean;
+    is_active?: boolean;
+}
+export interface SignTemplateCustomBranding {
+    company_name?: string | null;
+    logo_uri?: string | null;
+    branding_color?: string | null;
+    email_footer_text?: string | null;
+}
+export type TemplateSignerInputType = "signature" | "date" | "text" | "checkbox" | "attachment" | "radio" | "dropdown" | (string & {});
+export interface TemplateSignerInputCoordinates {
+    x?: number;
+    y?: number;
+}
+export interface TemplateSignerInputDimensions {
+    width?: number;
+    height?: number;
+}

package/dist/types/models/schemas/skills.d.ts

@@ -0,0 +1,120 @@
+import type { FileVersionType, PutOp, PutSkillInvocationIdFile } from '../schemas.js';
+export interface KeywordSkillCard {
+    created_at?: string;
+    type: KeywordSkillCardType;
+    skill_card_type: KeywordSkillCardSkillCardType;
+    skill_card_title?: KeywordSkillCardSkillCardTitle;
+    skill: KeywordSkillCardSkill;
+    invocation: KeywordSkillCardInvocation;
+    entries: Array<KeywordSkillCardEntries>;
+}
+export type SkillCard = unknown;
+export interface SkillCardsMetadata {
+    $canEdit?: boolean;
+    $id?: string;
+    $parent?: string;
+    $scope?: string;
+    $template?: string;
+    $type?: string;
+    $typeVersion?: number;
+    $version?: number;
+    cards?: Array<SkillCard>;
+}
+export interface StatusSkillCard {
+    created_at?: string;
+    type: KeywordSkillCardType;
+    skill_card_type: StatusSkillCardSkillCardType;
+    skill_card_title?: KeywordSkillCardSkillCardTitle;
+    status: StatusSkillCardStatus;
+    skill: KeywordSkillCardSkill;
+    invocation: KeywordSkillCardInvocation;
+}
+export interface TimelineSkillCard {
+    created_at?: string;
+    type: KeywordSkillCardType;
+    skill_card_type: TimelineSkillCardSkillCardType;
+    skill_card_title?: KeywordSkillCardSkillCardTitle;
+    skill: KeywordSkillCardSkill;
+    invocation: KeywordSkillCardInvocation;
+    duration?: number;
+    entries: Array<TimelineSkillCardEntries>;
+}
+export interface TranscriptSkillCard {
+    created_at?: string;
+    type: KeywordSkillCardType;
+    skill_card_type: TranscriptSkillCardSkillCardType;
+    skill_card_title?: KeywordSkillCardSkillCardTitle;
+    skill: KeywordSkillCardSkill;
+    invocation: KeywordSkillCardInvocation;
+    duration?: number;
+    entries: Array<TranscriptSkillCardEntries>;
+}
+export type KeywordSkillCardType = "skill_card" | (string & {});
+export type KeywordSkillCardSkillCardType = "keyword" | (string & {});
+export interface KeywordSkillCardSkillCardTitle {
+    code?: string;
+    message: string;
+}
+export type SkillType = "service" | (string & {});
+export interface KeywordSkillCardSkill {
+    type: SkillType;
+    id: string;
+}
+export type InvocationType = "skill_invocation" | (string & {});
+export interface KeywordSkillCardInvocation {
+    type: InvocationType;
+    id: string;
+}
+export interface KeywordSkillCardEntries {
+    text?: string;
+}
+export type StatusSkillCardSkillCardType = "status" | (string & {});
+export type StatusCode = "invoked" | "processing" | "success" | "transient_failure" | "permanent_failure" | (string & {});
+export interface StatusSkillCardStatus {
+    code: StatusCode;
+    message?: string;
+}
+export type TimelineSkillCardSkillCardType = "timeline" | (string & {});
+export interface EntriesAppears {
+    start?: number;
+    end?: number;
+}
+export interface TimelineSkillCardEntries {
+    text?: string;
+    appears?: Array<EntriesAppears>;
+    image_url?: string;
+}
+export type TranscriptSkillCardSkillCardType = "transcript" | (string & {});
+export interface TranscriptSkillCardEntriesAppears {
+    start?: number;
+}
+export interface TranscriptSkillCardEntries {
+    text?: string;
+    appears?: Array<TranscriptSkillCardEntriesAppears>;
+}
+export interface UpdateSkillRequest {
+    op?: PutOp;
+    path?: string;
+    value?: SkillCard;
+}
+export interface CreateSkillRequest {
+    cards: Array<SkillCard>;
+}
+export interface PutSkillInvocationIdMetadata {
+    cards?: Array<SkillCard>;
+}
+export interface PutSkillInvocationIdFileVersion {
+    type?: FileVersionType;
+    id?: string;
+}
+export interface PutSkillInvocationIdUsage {
+    unit?: string;
+    value?: number;
+}
+export interface UpdateSkillInvocationRequest {
+    status: StatusCode;
+    metadata: PutSkillInvocationIdMetadata;
+    file: PutSkillInvocationIdFile;
+    file_version?: PutSkillInvocationIdFileVersion;
+    usage?: PutSkillInvocationIdUsage;
+}

package/dist/types/models/schemas/storage_policies.d.ts

@@ -0,0 +1,12 @@
+import type { StoragePolicyType } from '../schemas.js';
+export interface StoragePolicies {
+    limit?: number;
+    next_marker?: string | null;
+    prev_marker?: string | null;
+    entries?: Array<StoragePolicy>;
+}
+export interface StoragePolicy {
+    id: string;
+    type: StoragePolicyType;
+    name?: string;
+}

package/dist/types/models/schemas/storage_policy_assignments.d.ts

@@ -0,0 +1,34 @@
+import type { CommentItem, StoragePolicyType } from '../schemas.js';
+export interface StoragePolicyMini {
+    id: string;
+    type: StoragePolicyType;
+}
+export interface StoragePolicyAssignment {
+    id: string;
+    type: StoragePolicyAssignmentType;
+    storage_policy?: StoragePolicyMini;
+    assigned_to?: CommentItem;
+}
+export interface StoragePolicyAssignments {
+    limit?: number;
+    next_marker?: string | null;
+    prev_marker?: string | null;
+    entries?: Array<StoragePolicyAssignment>;
+}
+export type StoragePolicyAssignmentType = "storage_policy_assignment" | (string & {});
+export type GetResolvedForType = "user" | "enterprise" | (string & {});
+export interface PostStoragePolicy {
+    type: StoragePolicyType;
+    id: string;
+}
+export interface PostAssignedTo {
+    type: GetResolvedForType;
+    id: string;
+}
+export interface CreateStoragePolicyAssignmentRequest {
+    storage_policy: PostStoragePolicy;
+    assigned_to: PostAssignedTo;
+}
+export interface UpdateStoragePolicyAssignmentRequest {
+    storage_policy: PostStoragePolicy;
+}

package/dist/types/models/schemas/task_assignments.d.ts

@@ -0,0 +1,17 @@
+import type { TaskAssignmentResolutionState, TaskType } from '../schemas.js';
+export interface PostTask {
+    id: string;
+    type: TaskType;
+}
+export interface PostAssignTo {
+    id?: string;
+    login?: string;
+}
+export interface CreateTaskAssignmentRequest {
+    task: PostTask;
+    assign_to: PostAssignTo;
+}
+export interface UpdateTaskAssignmentRequest {
+    message?: string;
+    resolution_state?: TaskAssignmentResolutionState;
+}

package/dist/types/models/schemas/tasks.d.ts

@@ -0,0 +1,37 @@
+import type { AiCitationType, FileMini, TaskAssignments, TaskType, UserMini } from '../schemas.js';
+export interface Task {
+    id?: string;
+    type?: TaskType;
+    item?: FileMini;
+    due_at?: string;
+    action?: TaskAction;
+    message?: string;
+    task_assignment_collection?: TaskAssignments;
+    is_completed?: boolean;
+    created_by?: UserMini;
+    created_at?: string;
+    completion_rule?: TaskCompletionRule;
+}
+export interface Tasks {
+    total_count?: number;
+    entries?: Array<Task>;
+}
+export type TaskAction = "review" | "complete" | (string & {});
+export type TaskCompletionRule = "all_assignees" | "any_assignee" | (string & {});
+export interface CreateTaskRequestItem {
+    id?: string;
+    type?: AiCitationType;
+}
+export interface CreateTaskRequest {
+    item: CreateTaskRequestItem;
+    action?: TaskAction;
+    message?: string;
+    due_at?: string;
+    completion_rule?: TaskCompletionRule;
+}
+export interface UpdateTaskRequest {
+    action?: TaskAction;
+    message?: string;
+    due_at?: string;
+    completion_rule?: TaskCompletionRule;
+}

package/dist/types/models/schemas/terms_of_service_user_statuses.d.ts

@@ -0,0 +1,27 @@
+import type { CollaboratorVariableVariableValue, TermsOfServiceBase, TermsOfServiceType, UserMini } from '../schemas.js';
+export interface TermsOfServiceUserStatus {
+    id: string;
+    type: TermsOfServiceUserStatusType;
+    tos?: TermsOfServiceBase;
+    user?: UserMini;
+    is_accepted?: boolean;
+    created_at?: string;
+    modified_at?: string;
+}
+export interface TermsOfServiceUserStatuses {
+    total_count?: number;
+    entries?: Array<TermsOfServiceUserStatus>;
+}
+export type TermsOfServiceUserStatusType = "terms_of_service_user_status" | (string & {});
+export interface PostTos {
+    type: TermsOfServiceType;
+    id: string;
+}
+export interface CreateTermsOfServiceUserStatusRequest {
+    tos: PostTos;
+    user: CollaboratorVariableVariableValue;
+    is_accepted: boolean;
+}
+export interface UpdateTermsOfServiceUserStatusRequest {
+    is_accepted: boolean;
+}

package/dist/types/models/schemas/terms_of_services.d.ts

@@ -0,0 +1,27 @@
+import type { CollaborationAllowlistEntryEnterprise, TermsOfServiceType } from '../schemas.js';
+export interface TermsOfService {
+    id: string;
+    type: TermsOfServiceType;
+    status?: TermsOfServiceStatus;
+    enterprise?: CollaborationAllowlistEntryEnterprise;
+    tos_type?: TermsOfServiceTosType;
+    text?: string;
+    created_at?: string;
+    modified_at?: string;
+}
+export interface TermsOfServices {
+    total_count?: number;
+    entries?: Array<TermsOfService>;
+}
+export type TermsOfServiceStatus = "enabled" | "disabled" | (string & {});
+export type TermsOfServiceTosType = "managed" | "external" | (string & {});
+export type GetTosType = "external" | "managed" | (string & {});
+export interface CreateTermsOfServiceRequest {
+    status: TermsOfServiceStatus;
+    tos_type?: GetTosType;
+    text: string;
+}
+export interface UpdateTermsOfServiceRequest {
+    status: TermsOfServiceStatus;
+    text: string;
+}

package/dist/types/models/schemas/transfer.d.ts

@@ -0,0 +1,4 @@
+import type { AttributesParent } from '../schemas.js';
+export interface TransferFoldersRequest {
+    owned_by: AttributesParent;
+}

package/dist/types/models/schemas/trashed_files.d.ts

@@ -0,0 +1,49 @@
+import type { AiCitationType, FileItemStatus, FilePathCollection, FileVersionMini, FolderMini, TrashFilePathCollection, UserMini } from '../schemas.js';
+export interface TrashFile {
+    id: string;
+    etag?: string | null;
+    type: AiCitationType;
+    sequence_id: string;
+    name?: string;
+    sha1: string;
+    file_version?: FileVersionMini;
+    description: string;
+    size: number;
+    path_collection: TrashFilePathCollection;
+    created_at: string;
+    modified_at: string;
+    trashed_at?: string | null;
+    purged_at?: string | null;
+    content_created_at?: string | null;
+    content_modified_at?: string | null;
+    created_by?: UserMini;
+    modified_by: UserMini;
+    owned_by: UserMini;
+    shared_link?: string | null;
+    parent?: FolderMini | null;
+    item_status: FileItemStatus;
+}
+export interface TrashFileRestored {
+    id: string;
+    etag?: string | null;
+    type: AiCitationType;
+    sequence_id: string;
+    name?: string;
+    sha1: string;
+    file_version?: FileVersionMini;
+    description: string;
+    size: number;
+    path_collection: FilePathCollection;
+    created_at: string;
+    modified_at: string;
+    trashed_at?: string | null;
+    purged_at?: string | null;
+    content_created_at?: string | null;
+    content_modified_at?: string | null;
+    created_by?: UserMini;
+    modified_by: UserMini;
+    owned_by: UserMini;
+    shared_link?: string | null;
+    parent?: FolderMini | null;
+    item_status: FileItemStatus;
+}

package/dist/types/models/schemas/trashed_folders.d.ts

@@ -0,0 +1,47 @@
+import type { FileItemStatus, FilePathCollection, FolderMini, FolderType, TrashFilePathCollection, UserMini } from '../schemas.js';
+export interface TrashFolder {
+    id: string;
+    etag?: string | null;
+    type: FolderType;
+    sequence_id?: string;
+    name: string;
+    created_at?: string | null;
+    modified_at?: string | null;
+    description: string;
+    size: number;
+    path_collection: TrashFilePathCollection;
+    created_by: UserMini;
+    modified_by: UserMini;
+    trashed_at?: string | null;
+    purged_at?: string | null;
+    content_created_at?: string | null;
+    content_modified_at?: string | null;
+    owned_by: UserMini;
+    shared_link?: string | null;
+    folder_upload_email?: string | null;
+    parent?: FolderMini | null;
+    item_status: FileItemStatus;
+}
+export interface TrashFolderRestored {
+    id?: string;
+    etag?: string | null;
+    type?: FolderType;
+    sequence_id?: string;
+    name?: string;
+    created_at?: string | null;
+    modified_at?: string | null;
+    description?: string;
+    size?: number;
+    path_collection?: FilePathCollection;
+    created_by?: UserMini;
+    modified_by?: UserMini;
+    trashed_at?: string | null;
+    purged_at?: string | null;
+    content_created_at?: string | null;
+    content_modified_at?: string | null;
+    owned_by?: UserMini;
+    shared_link?: string | null;
+    folder_upload_email?: string | null;
+    parent?: FolderMini | null;
+    item_status?: FileItemStatus;
+}

package/dist/types/models/schemas/trashed_items.d.ts

@@ -0,0 +1 @@
+export type GetFolderTrashItemsSort = "name" | "date" | "size" | (string & {});

package/dist/types/models/schemas/trashed_web_links.d.ts

@@ -0,0 +1,41 @@
+import type { FileItemStatus, FilePathCollection, FolderMini, TrashFilePathCollection, TrashWebLinkType, UserMini } from '../schemas.js';
+export interface TrashWebLink {
+    type?: TrashWebLinkType;
+    id?: string;
+    sequence_id?: string;
+    etag?: string;
+    name?: string;
+    url?: string;
+    parent?: FolderMini;
+    description?: string;
+    path_collection?: TrashFilePathCollection;
+    created_at?: string;
+    modified_at?: string;
+    trashed_at?: string | null;
+    purged_at?: string | null;
+    created_by?: UserMini;
+    modified_by?: UserMini;
+    owned_by?: UserMini;
+    shared_link?: string | null;
+    item_status?: FileItemStatus;
+}
+export interface TrashWebLinkRestored {
+    type?: TrashWebLinkType;
+    id?: string;
+    sequence_id: string;
+    etag?: string;
+    name?: string;
+    url?: string;
+    parent?: FolderMini;
+    description?: string;
+    path_collection: FilePathCollection;
+    created_at?: string;
+    modified_at?: string;
+    trashed_at?: string | null;
+    purged_at?: string | null;
+    created_by?: UserMini;
+    modified_by?: UserMini;
+    owned_by?: UserMini;
+    shared_link?: string | null;
+    item_status?: FileItemStatus;
+}

package/dist/types/models/schemas/uploads.d.ts

@@ -0,0 +1,28 @@
+import type { AttributesParent, PostFileIdParent } from '../schemas.js';
+export interface UploadUrl {
+    upload_url?: string;
+    upload_token?: string;
+}
+export interface PostFileIdContentAttributes {
+    name: string;
+    content_modified_at?: string;
+}
+export interface CreateFileIdContentRequest {
+    attributes: PostFileIdContentAttributes;
+    file: Blob;
+}
+export interface PostFileContentAttributes {
+    name: string;
+    parent: AttributesParent;
+    content_created_at?: string;
+    content_modified_at?: string;
+}
+export interface CreateFileContentRequest {
+    attributes: PostFileContentAttributes;
+    file: Blob;
+}
+export interface OptionFileContentRequest {
+    name?: string;
+    size?: number;
+    parent?: PostFileIdParent;
+}