@vidispine/vdt-js 22.4.0-pre.9 → 23.1.0-pre.1

package/dist/index.d.ts

@@ -13,7 +13,7 @@ declare const parseKeyValuePairTypes: (keyValuePairTypes: KeyValuePairType[]) =>
 };
 
 /**
- * Object with all name of roles in VidiCore
+ * Const object with VidiCore role names
  *
  * @category Auth
  */
@@ -127,36 +127,37 @@ declare const ROLE_NAMES: {
     readonly USER: "_user";
     readonly VXA: "_vxa";
     readonly VXA_READ: "_vxa_read";
-};
+};
+type RoleNameTypes = keyof typeof ROLE_NAMES;
 
-declare type InputValueTypes = string | boolean | number | Date;
+type InputValueTypes = string | boolean | number | Date;
 /** Possible input values for the field value */
-declare type InputValue = InputValueTypes | InputValueTypes[];
+type InputValue = InputValueTypes | InputValueTypes[];
 /** Input value object for the field value */
-declare type InputValueObject = {
+type InputValueObject = {
     value: string | InputValue;
 } & Omit<MetadataValueType, 'value'>;
-declare type InputFieldValue = InputValueObject | InputValue | InputValueObject[] | InputValue[];
+type InputFieldValue = InputValueObject | InputValue | InputValueObject[] | InputValue[];
 /** Input object to create field of */
-declare type InputFieldObject = {
+type InputFieldObject = {
     value: InputFieldValue;
 } & MetadataFieldValueType;
 /** Input to create a field of */
-declare type InputField = InputFieldValue | InputFieldObject;
+type InputField = InputFieldValue | InputFieldObject;
 /** Input to create one or multiple groups and/or fields of */
-declare type InputGroupsOrFields = InputGroup | InputGroup[] | InputField | InputField[];
+type InputGroupsOrFields = InputGroup | InputGroup[] | InputField | InputField[];
 /** Input object to create group of */
-declare type InputGroup = {
+type InputGroup = {
     [groupOrFieldName: string]: InputGroupsOrFields;
 } & Partial<MetadataGroupValueType>;
 /** Input to create a timespan of */
-declare type InputTimespan = {
+type InputTimespan = {
     start?: string | number;
     end?: string | number;
     base?: string;
     [groupOrFieldName: string]: InputGroupsOrFields;
 };
-declare type CreateMetadataTypeInput = InputTimespan | InputTimespan[];
+type CreateMetadataTypeInput = InputTimespan | InputTimespan[];
 /**
  * Create a VidiCore metadata object from a more dense/simplified structure
  *
@@ -167,44 +168,44 @@ declare type CreateMetadataTypeInput = InputTimespan | InputTimespan[];
  */
 declare const createMetadataType: (input: CreateMetadataTypeInput) => MetadataType;
 
-declare type ParsedValueAttributes = Partial<Omit<MetadataValueType, 'value'>>;
-declare type ParsedValue<TOptions> = TOptions extends {
+type ParsedValueAttributes = Partial<Omit<MetadataValueType, 'value'>>;
+type ParsedValue<TOptions> = TOptions extends {
     includeValueAttributes?: false;
 } ? string : {
     value: string;
 } & ParsedValueAttributes;
-declare type ParseValueOptions = {
+type ParseValueOptions = {
     includeValueAttributes?: boolean | (keyof ParsedValueAttributes)[];
 };
 
-declare type ParsedValueList<TOptions> = TOptions extends {
+type ParsedValueList<TOptions> = TOptions extends {
     joinValue?: string;
     includeValueAttributes?: false;
 } ? string : TOptions extends {
     arrayOnSingleValue?: true;
 } ? ParsedValue<TOptions>[] : ParsedValue<TOptions> | ParsedValue<TOptions>[];
-declare type ParseValueListOptions = {
+type ParseValueListOptions = {
     joinValue?: string;
     arrayOnSingleValue?: boolean;
 } & ParseValueOptions;
 
-declare type ParsedFieldAttributes = Partial<Omit<MetadataFieldValueType, 'value'>>;
-declare type ParsedFieldObject<TOptions> = {
+type ParsedFieldAttributes = Partial<Omit<MetadataFieldValueType, 'value'>>;
+type ParsedFieldObject<TOptions> = {
     value: ParsedValueList<TOptions>;
 } & ParsedFieldAttributes;
-declare type ParsedField<TOptions> = TOptions extends {
+type ParsedField<TOptions> = TOptions extends {
     includeFieldAttributes?: false;
 } ? ParsedValueList<TOptions> : ParsedFieldObject<TOptions>;
-declare type ParseFieldOptions = {
+type ParseFieldOptions = {
     includeFieldAttributes?: boolean | (keyof ParsedFieldAttributes)[];
 } & ParseValueListOptions;
 
-declare type ParseFieldListOptions = {
+type ParseFieldListOptions = {
     fieldAsList?: boolean;
     arrayOnSingleField?: boolean;
     overrideField?: boolean;
 } & ParseFieldOptions;
-declare type ParsedFieldList<TOptions> = TOptions extends {
+type ParsedFieldList<TOptions> = TOptions extends {
     fieldAsList?: true;
 } ? ParsedField<TOptions>[] : TOptions extends {
     arrayOnSingle?: true;
@@ -227,13 +228,12 @@ declare type ParsedFieldList<TOptions> = TOptions extends {
  * Parse a metadata field list according to selected options
  *
  * @remarks
- * Duplicate fields (same field name in the same field list) are usually not the data model we'd advise using.
- * Since VidiCore supports multiple values in one fields, it's typically advised to store them as such.
- * But, given duplicated fields when parsing it will:
- * - with default options, merge duplicated field values to one field value array
- * - with `fieldAsList` enabled, separate fields in the list/array (as usual, even if not duplicate)
- * - with `includeFieldAttributes` enabled, return an array of field objects
- * - with `overrideField` enabled - Override so it returns the latest "duplicated" field it parses
+ * When parsing duplicate fields (same field name in the same field list) it will:
+ * - with default options: combine field values to one array within the same field name key
+ * - with `joinValue` enabled: join values within each field (returns array with string for each field value)
+ * - with `fieldAsList` enabled: separate fields in the list/array (as usual, even if not duplicate)
+ * - with `includeFieldAttributes` enabled: return an array of field objects
+ * - with `overrideField` enabled: return the latest duplicated field it parses
  *
  * @param fieldList Field list to parse
  * @param [options=defaultOptions] Options for how to parse the field list
@@ -243,14 +243,14 @@ declare type ParsedFieldList<TOptions> = TOptions extends {
  */
 declare const parseFieldList: <TOptions extends ParseFieldListOptions = ParseFieldListOptions>(fieldList: MetadataFieldValueType[], options?: TOptions) => ParsedFieldList<TOptions>;
 
-declare type ParsedGroupAttributes = Omit<MetadataGroupValueType, 'field' | 'group'>;
-declare type ParseGroupOptions = {
+type ParsedGroupAttributes = Omit<MetadataGroupValueType, 'field' | 'group'>;
+type ParseGroupOptions = {
     includeGroupAttributes?: boolean | (keyof ParsedGroupAttributes)[];
     groupAsList?: boolean;
     arrayOnSingleGroup?: boolean;
     overrideGroup?: boolean;
 } & ParseFieldListOptions;
-declare type ParsedGroup<TOptions> = ((TOptions extends {
+type ParsedGroup<TOptions> = ((TOptions extends {
     groupAsList?: true;
 } ? {
     group?: ParsedGroupList<TOptions>;
@@ -263,8 +263,8 @@ declare type ParsedGroup<TOptions> = ((TOptions extends {
 } : {
     [name: string]: ParsedFieldList<TOptions>;
 })) & ParsedGroupAttributes;
-declare type ParseGroupListOptions = ParseGroupOptions;
-declare type ParsedGroupList<TOptions> = TOptions extends {
+type ParseGroupListOptions = ParseGroupOptions;
+type ParsedGroupList<TOptions> = TOptions extends {
     groupAsList?: true;
 } ? ParsedGroup<TOptions>[] : TOptions extends {
     arrayOnSingle?: true;
@@ -287,10 +287,10 @@ declare type ParsedGroupList<TOptions> = TOptions extends {
  * Parse a metadata group list according to selected options
  *
  * @remarks
- * Parsing duplicate groups (with identical name) in the same group list will return:
- * - with default options, an array of group objects
- * - with `groupAsList` enabled, separate group objects in the list/array (as usual, even if not duplicate)
- * - with `overrideGroup` enabled, return the latest duplicated group it parses
+ * Parsing duplicate groups (same group name in the same group list) it will:
+ * - with default options: combine group objects to one array within the same group name key
+ * - with `groupAsList` enabled: return separate group objects in a list/array (as usual, even if not duplicate)
+ * - with `overrideGroup` enabled: return the latest duplicated group it parses
  *
  * @param groupList Group list to parse
  * @param options options for how to parse list
@@ -300,7 +300,7 @@ declare type ParsedGroupList<TOptions> = TOptions extends {
  */
 declare const parseGroupList: <TOptions extends ParseGroupOptions = ParseGroupOptions>(groupList: MetadataGroupValueType[], options?: TOptions) => ParsedGroupList<TOptions>;
 
-declare type ParsedTimespanAttributes = Omit<MetadataType['timespan'][number], 'field' | 'group'>;
+type ParsedTimespanAttributes = Omit<MetadataType['timespan'][number], 'field' | 'group'>;
 /**
  * __includeTimespanAttributes__:
  * Include attributes on timespan
@@ -314,12 +314,12 @@ declare type ParsedTimespanAttributes = Omit<MetadataType['timespan'][number], '
  *
  * @defaultValue `{ includeTimespanAttributes: false, arrayOnSingle: true, flat: false }`
  */
-declare type ParseTimespanOptions = {
+type ParseTimespanOptions = {
     includeTimespanAttributes?: boolean | (keyof ParsedTimespanAttributes)[];
     arrayOnSingle?: boolean;
     flat?: boolean;
 } & ParseGroupListOptions;
-declare type ParsedTimespan<TOptions> = ((TOptions extends {
+type ParsedTimespan<TOptions> = ((TOptions extends {
     groupAsList?: true;
 } ? {
     group?: ParsedGroupList<TOptions>;
@@ -349,7 +349,7 @@ declare type ParsedTimespan<TOptions> = ((TOptions extends {
  */
 declare const parseTimespan: <TOptions extends ParseTimespanOptions = ParseTimespanOptions>(timespan: MetadataType['timespan'][number], options?: TOptions) => ParsedTimespan<TOptions>;
 
-declare type ParsedTimespanList<TOptions> = TOptions extends {
+type ParsedTimespanList<TOptions> = TOptions extends {
     timespanAsList?: true;
 } ? ParsedTimespan<TOptions>[] : TOptions extends {
     flat?: true;
@@ -359,7 +359,7 @@ declare type ParsedTimespanList<TOptions> = TOptions extends {
 } ? ParsedTimespan<TOptions> : {
     [timespanKey: string]: ParsedTimespan<TOptions>[];
 };
-declare type ParseTimespanListOptions = {
+type ParseTimespanListOptions = {
     timespanAsList?: boolean;
     joinTimespan?: string;
     sortTimespan?: boolean;
@@ -380,10 +380,10 @@ declare type ParseTimespanListOptions = {
  */
 declare const parseTimespanList: <TOptions extends ParseTimespanListOptions = ParseTimespanListOptions>(timespanList: MetadataType['timespan'], options?: TOptions) => ParsedTimespanList<TOptions>;
 
-declare type ParsedMetadataAttributes = Partial<Omit<MetadataType, 'timespan' | 'revision'> & {
+type ParsedMetadataAttributes = Partial<Omit<MetadataType, 'timespan' | 'revision'> & {
     revision?: string[];
 }>;
-declare type ParsedMetadataType<TOptions> = (TOptions extends {
+type ParsedMetadataType<TOptions> = (TOptions extends {
     timespanAsList?: true;
 } ? {
     timespan: ParsedTimespanList<TOptions>;
@@ -394,7 +394,7 @@ declare type ParsedMetadataType<TOptions> = (TOptions extends {
 }) & (TOptions extends {
     includeMetadataAttributes?: true | string[];
 } ? ParsedMetadataAttributes : {});
-declare type ParseMetadataTypeOptions = {
+type ParseMetadataTypeOptions = {
     includeMetadataAttributes?: boolean | (keyof ParsedMetadataAttributes)[];
     flat?: boolean;
 } & ParseTimespanListOptions;
@@ -430,7 +430,7 @@ declare const parseSimpleMetadataType: (simpleMetadataType: SimpleMetadataType)
     [key: string]: string;
 };
 
-declare type MetadataTypeToWebVttOptions = {
+type MetadataTypeToWebVttOptions = {
     subtitleGroup?: string;
     subtitleField?: string;
 };
@@ -446,17 +446,19 @@ declare type MetadataTypeToWebVttOptions = {
 declare const metadataTypeToWebVtt: (metadataType: MetadataType, options?: MetadataTypeToWebVttOptions) => string;
 
 /**
- * Array with all available metadata group attributes
+ * Array with all available VidiCore system/default field group names
  *
  * @category Metadata
  */
-declare const GROUP_ATTRIBUTE_KEYS: (keyof MetadataGroupValueType)[];
+declare const SYSTEM_FIELDGROUPS: readonly ["stl_subtitle", "stl_tti", "stl_gsi", "mrk_marker", "pho_validation", "pho_resource", "pho_error", "facedetect_rect", "facedetect_face", "originalTrackFilename", "stl_gsiHeader"];
+
 /**
- * Array with all available metadata group attributes
+ * Array with all available VidiCore system/default field names (including transient)
  *
  * @category Metadata
  */
-declare const FIELD_ATTRIBUTE_KEYS: (keyof MetadataFieldValueType)[];
+declare const SYSTEM_FIELDS: readonly ["title", "user", "shapeTag", "representativeThumbnail", "representativeThumbnailNoAuth", "representativeItems", "itemId", "collectionId", "mediaType", "mimeType", "created", "startTimeCode", "startSeconds", "fieldValidationError", "schemaValidationError", "originalFilename", "originalUri", "originalAudioCodec", "originalVideoCodec", "originalHeight", "originalWidth", "originalFormat", "durationSeconds", "durationTimeCode", "solr-index", "__user", "__collection", "__collection_size", "__ancestor_collection", "__ancestor_collection_size", "__shape", "__shape_size", "__shape_last_added", "__placeholder_shape_size", "__version", "__version_count", "__storage", "__storage_size", "__shapetag_{tag}_hash_{hash}", "__storage_{tag}", "__storage_{tag}_size", "__storagegroup", "__storagegroup_size", "__sequence", "__sequence_size", "__metadata_last_modified", "__external_id", "__deletion_lock_id", "__deletion_lock_expiry", "__child_collection", "__child_collection_size", "__parent_collection", "__parent_collection_size", "__items_size", "stl_text", "stl_justification", "stl_xrelative", "stl_yrelative", "stl_vertical", "stl_verticalbase", "stl_horizontalbase", "stl_sizerelative", "stl_color", "stl_outline", "stl_outlinecolor", "stl_outlinesize", "stl_font", "stl_service", "stl_tti", "stl_gsi", "cct", "tcd", "tcf", "oet", "cd", "mnc", "cpn", "dfc", "tcp", "tcs", "tet", "tnb", "tnd", "en", "co", "tng", "rd", "mnr", "dsc", "opt", "lc", "tpt", "tn", "slr", "tns", "rn", "pub", "dsn", "ecd", "mrk_zerolength", "mrk_text", "mrk_color", "pho_resource_name", "pho_error_level", "pho_error_code", "pho_error_description", "facedetect_rect_width", "facedetect_rect_height", "facedetect_rect_y", "facedetect_rect_x", "facedetect_pid", "facedetect_rect", "trackId", "eidr_actor", "eidr_alternateId", "eidr_countryOfOrigin", "eidr_director", "eidr_id", "eidr_referentType", "eidr_releaseDate", "eidr_resourceName", "eidr_status", "eidr_sync", "ttml_div", "ttml_root", "vxa_collection_id", "vxaId", "vxaLocalPath", "tco", "cs", "ebn", "tf", "cf", "sgn", "tci", "jc", "vp", "sn"];
+
 /**
  * Array with all available metadata field value attributes
  *
@@ -465,20 +467,21 @@ declare const FIELD_ATTRIBUTE_KEYS: (keyof MetadataFieldValueType)[];
 declare const FIELD_VALUE_ATTRIBUTE_KEYS: (keyof MetadataValueType)[];
 
 /**
- * Array with all available VidiCore system/default field group names
+ * Array with all available metadata field attributes
  *
  * @category Metadata
  */
-declare const SYSTEM_FIELDGROUPS: readonly ["stl_subtitle", "stl_tti", "stl_gsi", "mrk_marker", "pho_validation", "pho_resource", "pho_error", "facedetect_rect", "facedetect_face", "originalTrackFilename", "stl_gsiHeader"];
+declare const FIELD_ATTRIBUTE_KEYS: (keyof MetadataFieldValueType)[];
+
 /**
- * Array with all available VidiCore system/default field group names
+ * Array with all available metadata group attributes
  *
  * @category Metadata
  */
-declare const SYSTEM_FIELDS: readonly ["title", "user", "shapeTag", "representativeThumbnail", "representativeThumbnailNoAuth", "representativeItems", "itemId", "collectionId", "mediaType", "mimeType", "created", "startTimeCode", "startSeconds", "fieldValidationError", "schemaValidationError", "originalFilename", "originalUri", "originalAudioCodec", "originalVideoCodec", "originalHeight", "originalWidth", "originalFormat", "durationSeconds", "durationTimeCode", "solr-index", "__user", "__collection", "__collection_size", "__ancestor_collection", "__ancestor_collection_size", "__shape", "__shape_size", "__shape_last_added", "__placeholder_shape_size", "__version", "__version_count", "__storage", "__storage_size", "__shapetag_{tag}_hash_{hash}", "__storage_{tag}", "__storage_{tag}_size", "__storagegroup", "__storagegroup_size", "__sequence", "__sequence_size", "__metadata_last_modified", "__external_id", "__deletion_lock_id", "__deletion_lock_expiry", "__child_collection", "__child_collection_size", "__parent_collection", "__parent_collection_size", "__items_size", "stl_text", "stl_justification", "stl_xrelative", "stl_yrelative", "stl_vertical", "stl_verticalbase", "stl_horizontalbase", "stl_sizerelative", "stl_color", "stl_outline", "stl_outlinecolor", "stl_outlinesize", "stl_font", "stl_service", "stl_tti", "stl_gsi", "cct", "tcd", "tcf", "oet", "cd", "mnc", "cpn", "dfc", "tcp", "tcs", "tet", "tnb", "tnd", "en", "co", "tng", "rd", "mnr", "dsc", "opt", "lc", "tpt", "tn", "slr", "tns", "rn", "pub", "dsn", "ecd", "mrk_zerolength", "mrk_text", "mrk_color", "pho_resource_name", "pho_error_level", "pho_error_code", "pho_error_description", "facedetect_rect_width", "facedetect_rect_height", "facedetect_rect_y", "facedetect_rect_x", "facedetect_pid", "facedetect_rect", "trackId", "eidr_actor", "eidr_alternateId", "eidr_countryOfOrigin", "eidr_director", "eidr_id", "eidr_referentType", "eidr_releaseDate", "eidr_resourceName", "eidr_status", "eidr_sync", "ttml_div", "ttml_root", "vxa_collection_id", "vxaId", "vxaLocalPath", "tco", "cs", "ebn", "tf", "cf", "sgn", "tci", "jc", "vp", "sn"];
+declare const GROUP_ATTRIBUTE_KEYS: (keyof MetadataGroupValueType)[];
 
-declare type CreateFacetTypeFieldList = string[];
-declare type CreateFacetTypeOptions = {
+type CreateFacetTypeFieldList = string[];
+type CreateFacetTypeOptions = {
     count: boolean;
 };
 /**
@@ -497,11 +500,11 @@ declare const createFacetType: (fieldList?: CreateFacetTypeFieldList, options?:
     exclude: CreateFacetTypeFieldList;
 }[];
 
-declare type ParsedFacetTypeCount = {
+type ParsedFacetTypeCount = {
     [fieldValue: string]: number;
 };
 /** Parsed facet type */
-declare type ParsedFacetType = {
+type ParsedFacetType = {
     [fieldName: string]: ParsedFacetTypeCount;
 };
 /**
@@ -514,12 +517,12 @@ declare type ParsedFacetType = {
  */
 declare const parseFacetType: (facetType?: FacetType[]) => ParsedFacetType;
 
-declare type ParseHighlightTimespanOptions = {
+type ParseHighlightTimespanOptions = {
     arrayOnSingle?: boolean;
     timespanAsList?: boolean;
     joinValue?: string;
 };
-declare type ParsedHighlightTimespan = {
+type ParsedHighlightTimespan = {
     start?: string;
     end?: string;
     [key: string]: string | string[];
@@ -534,7 +537,7 @@ declare type ParsedHighlightTimespan = {
  */
 declare const parseHighlightTimespan: (timespan: SearchResultEntryTimespanType, options: ParseHighlightTimespanOptions) => ParsedHighlightTimespan;
 
-declare type ParseHighlightTimespanListOptions = {
+type ParseHighlightTimespanListOptions = {
     timespanAsList?: boolean;
     joinTimespan?: string;
     flat?: boolean;
@@ -551,28 +554,42 @@ declare type ParseHighlightTimespanListOptions = {
  */
 declare const parseHighlightTimespanList: (highlightTimespanList?: SearchResultEntryTimespanType[], options?: ParseHighlightTimespanListOptions) => ParsedHighlightTimespan | ParsedHighlightTimespan[];
 
+/**
+ * Parse Vidicore "NOW" constants to a date object
+ *
+ * Format: `NOW[+/-][number][HOUR/DAY/MONTH/YEAR(s)]` (e.g. "NOW-2HOURS")
+ *
+ * @remarks
+ * Returns an approximate date since it's created client side
+ *
+ * @param value A "NOW" constant
+ * @returns A date from the NOW constant
+ *
+ * @category Search
+ */
 declare const parseNowDate: (value?: string) => Date;
 
-declare type ParsedBaseMediaInfoType = {
+type ParsedBaseMediaInfoType = {
     Bit_rate_mode?: string;
     Source?: string;
 } & {
     [key: string]: string;
 };
-declare type ParsedAudioMediaInfoType = ParsedBaseMediaInfoType;
-declare type ParsedBinaryMediaInfoType = ParsedBaseMediaInfoType;
-declare type ParsedVideoMediaInfoType = ParsedBaseMediaInfoType & {
+type ParsedAudioMediaInfoType = ParsedBaseMediaInfoType;
+type ParsedBinaryMediaInfoType = ParsedBaseMediaInfoType;
+type ParsedVideoMediaInfoType = ParsedBaseMediaInfoType & {
     Format_Settings_GOP?: string;
     intra_dc_precision?: string;
 };
 
-declare type ParsedAudioComponentType = {
+type ParsedAudioComponentType = {
     audioFormat?: string;
     audioCodec?: string;
     audioSamplerate?: string;
     audioSamplerateSamples?: number;
     audioBitDepth?: string;
     audioBitrate?: string;
+    audioBitrateKbps?: number;
     audioBitRateMode?: string;
     audioChannels?: number;
     audioMetadata?: {
@@ -589,7 +606,7 @@ declare type ParsedAudioComponentType = {
  */
 declare const parseAudioComponent: (audioComponentType: AudioComponentType) => ParsedAudioComponentType;
 
-declare type ParsedBinaryComponentType = {
+type ParsedBinaryComponentType = {
     binaryMetadata?: {
         [key: string]: string;
     };
@@ -604,7 +621,7 @@ declare type ParsedBinaryComponentType = {
  */
 declare const parseBinaryComponent: (binaryComponentType?: BinaryComponentType) => ParsedBinaryComponentType;
 
-declare type ParsedFileType = {
+type ParsedFileType = {
     uri?: string;
     hash?: string;
     fileSize?: string;
@@ -616,6 +633,9 @@ declare type ParsedFileType = {
 /**
  * Parses a VidiCore file object
  *
+ * @remarks
+ * File sizes are parsed with JEDEC standard (base 2)
+ *
  * @param fileType VidiCore file object
  * @returns A parsed file object
  *
@@ -626,7 +646,7 @@ declare const parseFileType: (fileType: FileType) => ParsedFileType;
 /**
  * Parsed container component
  */
-declare type ParsedContainerComponentType = {
+type ParsedContainerComponentType = {
     containerFormat?: string;
     videoFormat?: string;
     audioFormat?: string;
@@ -650,7 +670,7 @@ declare type ParsedContainerComponentType = {
  */
 declare const parseContainerComponent: (containerComponentType?: ContainerComponentType) => ParsedContainerComponentType;
 
-declare type TimeBaseInput = {
+type TimeBaseInput = {
     numerator?: number | string;
     denominator?: number | string;
 };
@@ -680,6 +700,7 @@ declare class TimeBase {
      *
      * @remarks
      * Default format: denominator(:numerator if > 1)
+     *
      * `constant` has precedence over `fraction` if both are true (e.g. NTSC > 30000:1001)
      *
      * @param options For how to display it as text
@@ -699,6 +720,7 @@ declare class TimeBase {
      * - `number` gives that amount of decimal places
      *
      * Default format: rate with two decimals if needed (i.e. decimals are > 0)
+     *
      * Option precedence (when all true): `constant` > `rounded` > `fixed`
      *
      * @param options For how to display it as rate
@@ -755,11 +777,11 @@ declare const formatTimeBaseText: (timeBaseText?: string | number) => TimeBase;
  */
 declare const formatTimeBaseType: (timeBase: TimeBaseInput) => TimeBase;
 
-declare type TimeCodeInput = {
+type TimeCodeInput = {
     samples?: number | string;
     timeBase?: string | TimeBaseInput | TimeBase;
 };
-declare type TimeCodeInputOptions = {
+type TimeCodeInputOptions = {
     dropFrame?: boolean;
     frameSeparator?: string;
 };
@@ -823,6 +845,7 @@ declare class TimeCode {
      *
      * @remarks
      * Default format: samples@denominator(:numerator if > 1)
+     *
      * `constant` has precedence over `fraction` if both are true
      *
      * @param options Options for how to format text
@@ -912,13 +935,15 @@ declare class TimeCode {
     };
 }
 
-declare type FormatTimeCodeSecondsOptions = {
+type FormatTimeCodeSecondsOptions = {
     timeBase?: number | string | TimeBaseInput;
     useGCD?: boolean;
 } & TimeCodeInputOptions;
 /**
  * Format seconds to TimeCode object
- * Input time base is always 1:1 since it expects seconds as input
+ *
+ * @remarks
+ * Input time base is always considered as 1:1 since it expects seconds as input
  *
  * Note: Max 15 digits accuracy (double precision float64), e.g.
  * - 10^6 seconds can have 10^9 decimals (nanosecond) precision
@@ -933,7 +958,7 @@ declare type FormatTimeCodeSecondsOptions = {
  */
 declare const formatTimeCodeSeconds: (seconds: string | number, options?: FormatTimeCodeSecondsOptions) => TimeCode;
 
-declare type FormatTimeCodeSmpteOptions = {
+type FormatTimeCodeSmpteOptions = {
     timeBase?: number | string | TimeBaseInput;
     exceedingMode?: 'add' | 'ignore' | 'error';
     dropFrame?: boolean;
@@ -955,7 +980,7 @@ declare type FormatTimeCodeSmpteOptions = {
  */
 declare const formatTimeCodeSmpte: (smpte: string, options?: FormatTimeCodeSmpteOptions) => TimeCode;
 
-declare type FormatTimeCodeTextOptions = {
+type FormatTimeCodeTextOptions = {
     timeBase?: number | string | TimeBaseInput;
 } & TimeCodeInputOptions;
 /**
@@ -967,7 +992,7 @@ declare type FormatTimeCodeTextOptions = {
  */
 declare const formatTimeCodeText: (timeCodeText?: number | string, options?: FormatTimeCodeTextOptions) => TimeCode;
 
-declare type CreateTimeCodeOptions = TimeCodeInputOptions | FormatTimeCodeSmpteOptions | FormatTimeCodeSecondsOptions | FormatTimeCodeTextOptions;
+type CreateTimeCodeOptions = TimeCodeInputOptions | FormatTimeCodeSmpteOptions | FormatTimeCodeSecondsOptions | FormatTimeCodeTextOptions;
 /**
  * Create a TimeCode instance from smpte, seconds/samples, timeCode object or string
  *
@@ -990,7 +1015,7 @@ declare const createTimeCode: (timeCode: TimeCodeInput | string | number, option
  */
 declare const formatTimeCodeType: (timeCode: TimeCodeInput, options?: TimeCodeInputOptions) => TimeCode;
 
-declare type ParsedVideoComponentType = {
+type ParsedVideoComponentType = {
     videoFormat?: string;
     dimension?: string;
     frameRate?: string | number;
@@ -1001,6 +1026,7 @@ declare type ParsedVideoComponentType = {
     videoCodec?: string;
     smpte?: string;
     videoBitrate?: string;
+    videoBitrateMbps?: number;
     fieldOrder?: string;
     colorSpace?: string;
     chromaSubsampling?: string;
@@ -1020,7 +1046,7 @@ declare type ParsedVideoComponentType = {
  */
 declare const parseVideoComponent: (videoComponentType?: VideoComponentType) => ParsedVideoComponentType;
 
-declare type ParsedShapeType = {
+type ParsedShapeType = {
     uri?: string;
     tag?: string;
     mimeType?: string;
@@ -1041,14 +1067,33 @@ declare type ParsedShapeType = {
  */
 declare const parseShapeType: (shapeType?: ShapeType) => ParsedShapeType;
 
+/**
+ * Const object with document types
+ *
+ * @category Shape
+ */
 declare const DOCUMENT_TYPES: {
     readonly PDF: "PDF";
     readonly TEXT: "TEXT";
     readonly MSWORD: "MSWORD";
     readonly JSON: "JSON";
     readonly XML: "XML";
-};
-declare type DocumentType = keyof typeof DOCUMENT_TYPES;
+};
+
+/**
+ * Const object with media types
+ *
+ * @category Shape
+ */
+declare const SHAPE_MEDIA_TYPES: {
+    readonly IMAGE: "IMAGE";
+    readonly AUDIO: "AUDIO";
+    readonly VIDEO: "VIDEO";
+    readonly DOCUMENT: "DOCUMENT";
+    readonly BINARY: "BINARY";
+};
+
+type DocumentType = keyof typeof DOCUMENT_TYPES;
 /**
  * Return a const for the document type of a shape (looks at mimeType)
  *
@@ -1059,14 +1104,14 @@ declare type DocumentType = keyof typeof DOCUMENT_TYPES;
  */
 declare const getShapeDocumentType: (shape?: ShapeType) => DocumentType;
 
-declare type FilteredShapeListObject = {
+type FilteredShapeListObject = {
     src: string;
     type: string;
     shape: ShapeType;
     parsedShape: ParsedShapeType;
     [key: string]: string | ParsedShapeType | ShapeType;
 };
-declare type FilterShapeSourceOption = {
+type FilterShapeSourceOption = {
     sortPriority?: Function;
     allowedMimeTypes?: string[];
     allowedMethods?: string[];
@@ -1086,14 +1131,7 @@ declare type FilterShapeSourceOption = {
  */
 declare const filterShapeSource: (itemType: ItemType, options: FilterShapeSourceOption) => FilteredShapeListObject[];
 
-declare const SHAPE_MEDIA_TYPES: {
-    readonly IMAGE: "IMAGE";
-    readonly AUDIO: "AUDIO";
-    readonly VIDEO: "VIDEO";
-    readonly DOCUMENT: "DOCUMENT";
-    readonly BINARY: "BINARY";
-};
-declare type ShapeMediaType = keyof typeof SHAPE_MEDIA_TYPES;
+type ShapeMediaType = keyof typeof SHAPE_MEDIA_TYPES;
 /**
  * Returns a const for which media type a shape has
  *
@@ -1104,6 +1142,38 @@ declare type ShapeMediaType = keyof typeof SHAPE_MEDIA_TYPES;
  */
 declare const getShapeMediaType: (shape: ShapeType) => ShapeMediaType;
 
+/**
+ * Const object with all file states in VidiCore
+ * (see https://apidoc.vidispine.com/latest/storage/storage.html#file-states for more info)
+ *
+ * @category File
+ */
+declare const FILE_STATES: {
+    /** Just created, not used. */
+    readonly NONE: "NONE";
+    /** Discovered or created, not yet marked as finished. */
+    readonly OPEN: "OPEN";
+    /** File does no longer grow. */
+    readonly CLOSED: "CLOSED";
+    /** The current state is not known. */
+    readonly UNKNOWN: "UNKNOWN";
+    /** File is missing from the file system/storage. */
+    readonly MISSING: "MISSING";
+    /** File has been missing for a longer period. Candidate for restoration from archive. */
+    readonly LOST: "LOST";
+    /** File will appear on file system/storage, transfer subsystem or transcoder will create it. */
+    readonly TO_APPEAR: "TO_APPEAR";
+    /** The file is no longer in use, and will be deleted at the next clean-up sweep. */
+    readonly TO_BE_DELETED: "TO_BE_DELETED";
+    /** File is in use by transfer subsystem or transcoder. */
+    readonly BEING_READ: "BEING_READ";
+    /** File is archived. */
+    readonly ARCHIVED: "ARCHIVED";
+    /** File will be synchronized by multi-site agent. */
+    readonly AWAITING_SYNC: "AWAITING_SYNC";
+};
+type FileStateTypes = keyof typeof FILE_STATES;
+
 /**
  * Find the thumbnail uri in a VidiCore item object that's nearest a timeCode
  *
@@ -1121,7 +1191,7 @@ declare const findNearestThumbnail: (itemType: ItemType, timeCode: TimeCode | Ti
 /**
  * TODO
  */
-declare type ParsedMediaConvertTranscodePreset = {
+type ParsedMediaConvertTranscodePreset = {
     description?: string;
     containerFormat?: any;
     videoFormat?: string;
@@ -1148,10 +1218,7 @@ declare type ParsedMediaConvertTranscodePreset = {
  */
 declare const parseMediaConvertPreset: (mediaconvert: TranscodePresetType['mediaconvert']) => ParsedMediaConvertTranscodePreset;
 
-/**
- * TODO
- */
-declare type ParsedTranscodePreset = {
+type ParsedTranscodePreset = {
     description?: string;
     containerFormat?: any;
     videoFormat?: string;
@@ -1170,13 +1237,13 @@ declare type ParsedTranscodePreset = {
     audioChannels?: number;
 };
 /**
- * TODO
+ * Parse a VidiCore transcode preset
  *
- * @param transcodePresetType
- * @returns
+ * @param transcodePresetType a VidiCore transcode preset
+ * @returns A parsed transcode preset
  *
  * @category Transcode
  */
 declare const parseTranscodePreset: (transcodePresetType: TranscodePresetType) => ParsedTranscodePreset;
 
-export { CreateFacetTypeFieldList, CreateFacetTypeOptions, CreateMetadataTypeInput, CreateTimeCodeOptions, DocumentType, FIELD_ATTRIBUTE_KEYS, FIELD_VALUE_ATTRIBUTE_KEYS, FilterShapeSourceOption, FilteredShapeListObject, FormatTimeCodeSecondsOptions, FormatTimeCodeSmpteOptions, FormatTimeCodeTextOptions, GROUP_ATTRIBUTE_KEYS, InputField, InputFieldObject, InputFieldValue, InputGroup, InputGroupsOrFields, InputTimespan, InputValue, InputValueObject, InputValueTypes, MetadataTypeToWebVttOptions, ParseFieldListOptions, ParseFieldOptions, ParseGroupListOptions, ParseGroupOptions, ParseHighlightTimespanListOptions, ParseHighlightTimespanOptions, ParseMetadataTypeOptions, ParseTimespanListOptions, ParseTimespanOptions, ParseValueListOptions, ParseValueOptions, ParsedAudioComponentType, ParsedAudioMediaInfoType, ParsedBaseMediaInfoType, ParsedBinaryComponentType, ParsedBinaryMediaInfoType, ParsedContainerComponentType, ParsedFacetType, ParsedFacetTypeCount, ParsedField, ParsedFieldAttributes, ParsedFieldList, ParsedFieldObject, ParsedFileType, ParsedGroup, ParsedGroupAttributes, ParsedGroupList, ParsedHighlightTimespan, ParsedMediaConvertTranscodePreset, ParsedMetadataAttributes, ParsedMetadataType, ParsedShapeType, ParsedTimespan, ParsedTimespanAttributes, ParsedTimespanList, ParsedTranscodePreset, ParsedValue, ParsedValueAttributes, ParsedValueList, ParsedVideoComponentType, ParsedVideoMediaInfoType, ROLE_NAMES, SYSTEM_FIELDGROUPS, SYSTEM_FIELDS, ShapeMediaType, TimeBase, TimeBaseInput, TimeCode, TimeCodeInput, TimeCodeInputOptions, createFacetType, createMetadataType, createTimeBase, createTimeCode, filterShapeSource, findNearestThumbnail, formatTimeBaseText, formatTimeBaseType, formatTimeCodeSeconds, formatTimeCodeSmpte, formatTimeCodeText, formatTimeCodeType, getShapeDocumentType, getShapeMediaType, metadataTypeToWebVtt, parseAudioComponent, parseBinaryComponent, parseContainerComponent, parseFacetType, parseFieldList, parseFileType, parseGroupList, parseHighlightTimespan, parseHighlightTimespanList, parseKeyValuePairTypes as parseKeyValuePairType, parseMediaConvertPreset, parseMetadataType, parseNowDate, parseShapeType, parseSimpleMetadataType, parseTimespan, parseTimespanList, parseTranscodePreset, parseVideoComponent };
+export { CreateFacetTypeFieldList, CreateFacetTypeOptions, CreateMetadataTypeInput, CreateTimeCodeOptions, DOCUMENT_TYPES, DocumentType, FIELD_ATTRIBUTE_KEYS, FIELD_VALUE_ATTRIBUTE_KEYS, FILE_STATES, FileStateTypes, FilterShapeSourceOption, FilteredShapeListObject, FormatTimeCodeSecondsOptions, FormatTimeCodeSmpteOptions, FormatTimeCodeTextOptions, GROUP_ATTRIBUTE_KEYS, InputField, InputFieldObject, InputFieldValue, InputGroup, InputGroupsOrFields, InputTimespan, InputValue, InputValueObject, InputValueTypes, MetadataTypeToWebVttOptions, ParseFieldListOptions, ParseFieldOptions, ParseGroupListOptions, ParseGroupOptions, ParseHighlightTimespanListOptions, ParseHighlightTimespanOptions, ParseMetadataTypeOptions, ParseTimespanListOptions, ParseTimespanOptions, ParseValueListOptions, ParseValueOptions, ParsedAudioComponentType, ParsedAudioMediaInfoType, ParsedBaseMediaInfoType, ParsedBinaryComponentType, ParsedBinaryMediaInfoType, ParsedContainerComponentType, ParsedFacetType, ParsedFacetTypeCount, ParsedField, ParsedFieldAttributes, ParsedFieldList, ParsedFieldObject, ParsedFileType, ParsedGroup, ParsedGroupAttributes, ParsedGroupList, ParsedHighlightTimespan, ParsedMediaConvertTranscodePreset, ParsedMetadataAttributes, ParsedMetadataType, ParsedShapeType, ParsedTimespan, ParsedTimespanAttributes, ParsedTimespanList, ParsedTranscodePreset, ParsedValue, ParsedValueAttributes, ParsedValueList, ParsedVideoComponentType, ParsedVideoMediaInfoType, ROLE_NAMES, RoleNameTypes, SHAPE_MEDIA_TYPES, SYSTEM_FIELDGROUPS, SYSTEM_FIELDS, ShapeMediaType, TimeBase, TimeBaseInput, TimeCode, TimeCodeInput, TimeCodeInputOptions, createFacetType, createMetadataType, createTimeBase, createTimeCode, filterShapeSource, findNearestThumbnail, formatTimeBaseText, formatTimeBaseType, formatTimeCodeSeconds, formatTimeCodeSmpte, formatTimeCodeText, formatTimeCodeType, getShapeDocumentType, getShapeMediaType, metadataTypeToWebVtt, parseAudioComponent, parseBinaryComponent, parseContainerComponent, parseFacetType, parseFieldList, parseFileType, parseGroupList, parseHighlightTimespan, parseHighlightTimespanList, parseKeyValuePairTypes as parseKeyValuePairType, parseMediaConvertPreset, parseMetadataType, parseNowDate, parseShapeType, parseSimpleMetadataType, parseTimespan, parseTimespanList, parseTranscodePreset, parseVideoComponent };