box-node-sdk/src/schemas/fileVersions.ts

Official SDK for Box Platform APIs

import { serializeFileVersionFull } from './fileVersionFull';
import { deserializeFileVersionFull } from './fileVersionFull';
import { FileVersionFull } from './fileVersionFull';
import { BoxSdkError } from '../box/errors';
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 FileVersionsOrderDirectionField = 'ASC' | 'DESC' | string;
export interface FileVersionsOrderField {
  /**
   * The field to order by. */
  readonly by?: string;
  /**
   * The direction to order by, either ascending or descending. */
  readonly direction?: FileVersionsOrderDirectionField;
  readonly rawData?: SerializedData;
}
export interface FileVersions {
  /**
   * One greater than the offset of the last entry in the entire collection.
   * The total number of entries in the collection may be less than
   * `total_count`.
   *
   * This field is only returned for calls that use offset-based pagination.
   * For marker-based paginated APIs, this field will be omitted. */
  readonly totalCount?: number;
  /**
   * The limit that was used for these entries. This will be the same as the
   * `limit` query parameter unless that value exceeded the maximum value
   * allowed. The maximum value varies by API. */
  readonly limit?: number;
  /**
   * The 0-based offset of the first entry in this set. This will be the same
   * as the `offset` query parameter.
   *
   * This field is only returned for calls that use offset-based pagination.
   * For marker-based paginated APIs, this field will be omitted. */
  readonly offset?: number;
  /**
   * The order by which items are returned.
   *
   * This field is only returned for calls that use offset-based pagination.
   * For marker-based paginated APIs, this field will be omitted. */
  readonly order?: readonly FileVersionsOrderField[];
  /**
   * A list of file versions. */
  readonly entries?: readonly FileVersionFull[];
  readonly rawData?: SerializedData;
}
export function serializeFileVersionsOrderDirectionField(
  val: FileVersionsOrderDirectionField,
): SerializedData {
  return val;
}
export function deserializeFileVersionsOrderDirectionField(
  val: SerializedData,
): FileVersionsOrderDirectionField {
  if (val == 'ASC') {
    return val;
  }
  if (val == 'DESC') {
    return val;
  }
  if (sdIsString(val)) {
    return val;
  }
  throw new BoxSdkError({
    message: "Can't deserialize FileVersionsOrderDirectionField",
  });
}
export function serializeFileVersionsOrderField(
  val: FileVersionsOrderField,
): SerializedData {
  return {
    ['by']: val.by,
    ['direction']:
      val.direction == void 0
        ? val.direction
        : serializeFileVersionsOrderDirectionField(val.direction),
  };
}
export function deserializeFileVersionsOrderField(
  val: SerializedData,
): FileVersionsOrderField {
  if (!sdIsMap(val)) {
    throw new BoxSdkError({
      message: 'Expecting a map for "FileVersionsOrderField"',
    });
  }
  if (!(val.by == void 0) && !sdIsString(val.by)) {
    throw new BoxSdkError({
      message: 'Expecting string for "by" of type "FileVersionsOrderField"',
    });
  }
  const by: undefined | string = val.by == void 0 ? void 0 : val.by;
  const direction: undefined | FileVersionsOrderDirectionField =
    val.direction == void 0
      ? void 0
      : deserializeFileVersionsOrderDirectionField(val.direction);
  return { by: by, direction: direction } satisfies FileVersionsOrderField;
}
export function serializeFileVersions(val: FileVersions): SerializedData {
  return {
    ['total_count']: val.totalCount,
    ['limit']: val.limit,
    ['offset']: val.offset,
    ['order']:
      val.order == void 0
        ? val.order
        : (val.order.map(function (
            item: FileVersionsOrderField,
          ): SerializedData {
            return serializeFileVersionsOrderField(item);
          }) as readonly any[]),
    ['entries']:
      val.entries == void 0
        ? val.entries
        : (val.entries.map(function (item: FileVersionFull): SerializedData {
            return serializeFileVersionFull(item);
          }) as readonly any[]),
  };
}
export function deserializeFileVersions(val: SerializedData): FileVersions {
  if (!sdIsMap(val)) {
    throw new BoxSdkError({ message: 'Expecting a map for "FileVersions"' });
  }
  if (!(val.total_count == void 0) && !sdIsNumber(val.total_count)) {
    throw new BoxSdkError({
      message: 'Expecting number for "total_count" of type "FileVersions"',
    });
  }
  const totalCount: undefined | number =
    val.total_count == void 0 ? void 0 : val.total_count;
  if (!(val.limit == void 0) && !sdIsNumber(val.limit)) {
    throw new BoxSdkError({
      message: 'Expecting number for "limit" of type "FileVersions"',
    });
  }
  const limit: undefined | number = val.limit == void 0 ? void 0 : val.limit;
  if (!(val.offset == void 0) && !sdIsNumber(val.offset)) {
    throw new BoxSdkError({
      message: 'Expecting number for "offset" of type "FileVersions"',
    });
  }
  const offset: undefined | number = val.offset == void 0 ? void 0 : val.offset;
  if (!(val.order == void 0) && !sdIsList(val.order)) {
    throw new BoxSdkError({
      message: 'Expecting array for "order" of type "FileVersions"',
    });
  }
  const order: undefined | readonly FileVersionsOrderField[] =
    val.order == void 0
      ? void 0
      : sdIsList(val.order)
        ? (val.order.map(function (
            itm: SerializedData,
          ): FileVersionsOrderField {
            return deserializeFileVersionsOrderField(itm);
          }) as readonly any[])
        : [];
  if (!(val.entries == void 0) && !sdIsList(val.entries)) {
    throw new BoxSdkError({
      message: 'Expecting array for "entries" of type "FileVersions"',
    });
  }
  const entries: undefined | readonly FileVersionFull[] =
    val.entries == void 0
      ? void 0
      : sdIsList(val.entries)
        ? (val.entries.map(function (itm: SerializedData): FileVersionFull {
            return deserializeFileVersionFull(itm);
          }) as readonly any[])
        : [];
  return {
    totalCount: totalCount,
    limit: limit,
    offset: offset,
    order: order,
    entries: entries,
  } satisfies FileVersions;
}