@prdb/sdk 0.9.0 → 0.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -979,6 +979,12 @@ export declare function createUpdateWantedVideoResponseFromDiscriminatorValue(pa
979
979
  * @returns {UserIdentityResponse}
980
980
  */
981
981
  export declare function createUserIdentityResponseFromDiscriminatorValue(parseNode: ParseNode | undefined): ((instance?: Parsable) => Record<string, (node: ParseNode) => void>);
982
+ /**
983
+ * Creates a new instance of the appropriate class based on discriminator value
984
+ * @param parseNode The parse node to use to read the discriminator value and create the object
985
+ * @returns {VideoCodecCountDto}
986
+ */
987
+ export declare function createVideoCodecCountDtoFromDiscriminatorValue(parseNode: ParseNode | undefined): ((instance?: Parsable) => Record<string, (node: ParseNode) => void>);
982
988
  /**
983
989
  * Creates a new instance of the appropriate class based on discriminator value
984
990
  * @param parseNode The parse node to use to read the discriminator value and create the object
@@ -1069,6 +1075,18 @@ export declare function createVideoImageChangeImageDtoFromDiscriminatorValue(par
1069
1075
  * @returns {VideoImageChangesCursorDto}
1070
1076
  */
1071
1077
  export declare function createVideoImageChangesCursorDtoFromDiscriminatorValue(parseNode: ParseNode | undefined): ((instance?: Parsable) => Record<string, (node: ParseNode) => void>);
1078
+ /**
1079
+ * Creates a new instance of the appropriate class based on discriminator value
1080
+ * @param parseNode The parse node to use to read the discriminator value and create the object
1081
+ * @returns {VideoQualityOverviewDto}
1082
+ */
1083
+ export declare function createVideoQualityOverviewDtoFromDiscriminatorValue(parseNode: ParseNode | undefined): ((instance?: Parsable) => Record<string, (node: ParseNode) => void>);
1084
+ /**
1085
+ * Creates a new instance of the appropriate class based on discriminator value
1086
+ * @param parseNode The parse node to use to read the discriminator value and create the object
1087
+ * @returns {VideoResolutionCountDto}
1088
+ */
1089
+ export declare function createVideoResolutionCountDtoFromDiscriminatorValue(parseNode: ParseNode | undefined): ((instance?: Parsable) => Record<string, (node: ParseNode) => void>);
1072
1090
  /**
1073
1091
  * Creates a new instance of the appropriate class based on discriminator value
1074
1092
  * @param parseNode The parse node to use to read the discriminator value and create the object
@@ -1591,6 +1609,12 @@ export declare function deserializeIntoUpdateWantedVideoResponse(updateWantedVid
1591
1609
  * @returns {Record<string, (node: ParseNode) => void>}
1592
1610
  */
1593
1611
  export declare function deserializeIntoUserIdentityResponse(userIdentityResponse?: Partial<UserIdentityResponse> | undefined): Record<string, (node: ParseNode) => void>;
1612
+ /**
1613
+ * The deserialization information for the current model
1614
+ * @param VideoCodecCountDto The instance to deserialize into.
1615
+ * @returns {Record<string, (node: ParseNode) => void>}
1616
+ */
1617
+ export declare function deserializeIntoVideoCodecCountDto(videoCodecCountDto?: Partial<VideoCodecCountDto> | undefined): Record<string, (node: ParseNode) => void>;
1594
1618
  /**
1595
1619
  * The deserialization information for the current model
1596
1620
  * @param VideoDetailActorDto The instance to deserialize into.
@@ -1681,6 +1705,18 @@ export declare function deserializeIntoVideoImageChangeImageDto(videoImageChange
1681
1705
  * @returns {Record<string, (node: ParseNode) => void>}
1682
1706
  */
1683
1707
  export declare function deserializeIntoVideoImageChangesCursorDto(videoImageChangesCursorDto?: Partial<VideoImageChangesCursorDto> | undefined): Record<string, (node: ParseNode) => void>;
1708
+ /**
1709
+ * The deserialization information for the current model
1710
+ * @param VideoQualityOverviewDto The instance to deserialize into.
1711
+ * @returns {Record<string, (node: ParseNode) => void>}
1712
+ */
1713
+ export declare function deserializeIntoVideoQualityOverviewDto(videoQualityOverviewDto?: Partial<VideoQualityOverviewDto> | undefined): Record<string, (node: ParseNode) => void>;
1714
+ /**
1715
+ * The deserialization information for the current model
1716
+ * @param VideoResolutionCountDto The instance to deserialize into.
1717
+ * @returns {Record<string, (node: ParseNode) => void>}
1718
+ */
1719
+ export declare function deserializeIntoVideoResolutionCountDto(videoResolutionCountDto?: Partial<VideoResolutionCountDto> | undefined): Record<string, (node: ParseNode) => void>;
1684
1720
  /**
1685
1721
  * The deserialization information for the current model
1686
1722
  * @param VideoSummaryActorDto The instance to deserialize into.
@@ -3371,6 +3407,13 @@ export declare function serializeUpdateWantedVideoResponse(writer: Serialization
3371
3407
  * @param writer Serialization writer to use to serialize this model
3372
3408
  */
3373
3409
  export declare function serializeUserIdentityResponse(writer: SerializationWriter, userIdentityResponse?: Partial<UserIdentityResponse> | undefined | null, isSerializingDerivedType?: boolean): void;
3410
+ /**
3411
+ * Serializes information the current object
3412
+ * @param isSerializingDerivedType A boolean indicating whether the serialization is for a derived type.
3413
+ * @param VideoCodecCountDto The instance to serialize from.
3414
+ * @param writer Serialization writer to use to serialize this model
3415
+ */
3416
+ export declare function serializeVideoCodecCountDto(writer: SerializationWriter, videoCodecCountDto?: Partial<VideoCodecCountDto> | undefined | null, isSerializingDerivedType?: boolean): void;
3374
3417
  /**
3375
3418
  * Serializes information the current object
3376
3419
  * @param isSerializingDerivedType A boolean indicating whether the serialization is for a derived type.
@@ -3476,6 +3519,20 @@ export declare function serializeVideoImageChangeImageDto(writer: SerializationW
3476
3519
  * @param writer Serialization writer to use to serialize this model
3477
3520
  */
3478
3521
  export declare function serializeVideoImageChangesCursorDto(writer: SerializationWriter, videoImageChangesCursorDto?: Partial<VideoImageChangesCursorDto> | undefined | null, isSerializingDerivedType?: boolean): void;
3522
+ /**
3523
+ * Serializes information the current object
3524
+ * @param isSerializingDerivedType A boolean indicating whether the serialization is for a derived type.
3525
+ * @param VideoQualityOverviewDto The instance to serialize from.
3526
+ * @param writer Serialization writer to use to serialize this model
3527
+ */
3528
+ export declare function serializeVideoQualityOverviewDto(writer: SerializationWriter, videoQualityOverviewDto?: Partial<VideoQualityOverviewDto> | undefined | null, isSerializingDerivedType?: boolean): void;
3529
+ /**
3530
+ * Serializes information the current object
3531
+ * @param isSerializingDerivedType A boolean indicating whether the serialization is for a derived type.
3532
+ * @param VideoResolutionCountDto The instance to serialize from.
3533
+ * @param writer Serialization writer to use to serialize this model
3534
+ */
3535
+ export declare function serializeVideoResolutionCountDto(writer: SerializationWriter, videoResolutionCountDto?: Partial<VideoResolutionCountDto> | undefined | null, isSerializingDerivedType?: boolean): void;
3479
3536
  /**
3480
3537
  * Serializes information the current object
3481
3538
  * @param isSerializingDerivedType A boolean indicating whether the serialization is for a derived type.
@@ -3594,6 +3651,26 @@ export interface SubmitVideoFilehashesResponse extends AdditionalDataHolder, Par
3594
3651
  * A single hash-to-video assignment.
3595
3652
  */
3596
3653
  export interface SubmitVideoFilehashItem extends AdditionalDataHolder, Parsable {
3654
+ /**
3655
+ * Channel count of the audio stream.
3656
+ */
3657
+ audioChannels?: number | null;
3658
+ /**
3659
+ * Codec of the audio stream, as the probe names it ("aac", "mp3").
3660
+ */
3661
+ audioCodec?: string | null;
3662
+ /**
3663
+ * Overall bit rate of the file in bits per second, across all streams.
3664
+ */
3665
+ bitRate?: number | null;
3666
+ /**
3667
+ * Container of the file as the probe names it. Send it verbatim — it is usually a commaseparated list of the formats the demuxer covers ("mov,mp4,m4a,3gp,3g2,mj2"), not one token.
3668
+ */
3669
+ containerFormat?: string | null;
3670
+ /**
3671
+ * Duration of the file in milliseconds, if the client probed it. Optional, like every fieldbelow it: a client that cannot or will not probe submits without them.
3672
+ */
3673
+ durationMs?: number | null;
3597
3674
  /**
3598
3675
  * File name without directory. Optional — a client may withhold it, and the endpoint works without it.
3599
3676
  */
@@ -3602,6 +3679,14 @@ export interface SubmitVideoFilehashItem extends AdditionalDataHolder, Parsable
3602
3679
  * Size of the file in bytes.
3603
3680
  */
3604
3681
  filesize?: number | null;
3682
+ /**
3683
+ * Average frame rate as the rational the probe reports, verbatim: "24000/1001", not "23.976".Rounding merges rates that are not the same one, and for a variable-rate file the largedenominator is the only sign that the value is an average rather than a rate.
3684
+ */
3685
+ frameRate?: string | null;
3686
+ /**
3687
+ * Height of the video stream in pixels, as stored.
3688
+ */
3689
+ height?: number | null;
3605
3690
  /**
3606
3691
  * OS hash of the file, 16 hexadecimal characters. Required; it is the only aggregation key.
3607
3692
  */
@@ -3618,10 +3703,18 @@ export interface SubmitVideoFilehashItem extends AdditionalDataHolder, Parsable
3618
3703
  * Known values: UserConfirmed (0), ClientDetected (1).
3619
3704
  */
3620
3705
  source?: number | null;
3706
+ /**
3707
+ * Codec of the video stream, as the probe names it ("h264", "hevc", "av1").
3708
+ */
3709
+ videoCodec?: string | null;
3621
3710
  /**
3622
3711
  * The video this file is. Required — a hash observation without an assignment is not accepted.
3623
3712
  */
3624
3713
  videoId?: Guid | null;
3714
+ /**
3715
+ * Width of the video stream in pixels, as stored. Do not reorder it with the height to make the file landscape.
3716
+ */
3717
+ width?: number | null;
3625
3718
  }
3626
3719
  /**
3627
3720
  * What happened to one submitted assignment.
@@ -3759,6 +3852,19 @@ export interface UserIdentityResponse extends AdditionalDataHolder, Parsable {
3759
3852
  */
3760
3853
  userHash?: string | null;
3761
3854
  }
3855
+ /**
3856
+ * One video codec a video is known in, and how many of its files carry it.
3857
+ */
3858
+ export interface VideoCodecCountDto extends AdditionalDataHolder, Parsable {
3859
+ /**
3860
+ * Codec name as the probing client reported it, lower-cased ("h264", "hevc", "av1").
3861
+ */
3862
+ codec?: string | null;
3863
+ /**
3864
+ * How many of the video's files use this codec.
3865
+ */
3866
+ fileCount?: number | null;
3867
+ }
3762
3868
  export interface VideoDetailActorDto extends AdditionalDataHolder, Parsable {
3763
3869
  /**
3764
3870
  * The birthday property
@@ -3813,6 +3919,18 @@ export interface VideoDetailDto extends AdditionalDataHolder, Parsable {
3813
3919
  * The createdAtUtc property
3814
3920
  */
3815
3921
  createdAtUtc?: Date | null;
3922
+ /**
3923
+ * How many files the duration was taken over. The spread cannot be read without it — one overtwo files says far less than one over twenty. Null exactly when `durationMs` is null.
3924
+ */
3925
+ durationFileCount?: number | null;
3926
+ /**
3927
+ * Consensus duration in milliseconds across the files prdb holds for this video, or null whiletoo few independent submitters have reported one. A median, not an average: durations differlegitimately — cuts, with and without an intro, re-encodes with padding — and one shortoutlier would drag an average off the value the real files agree on.
3928
+ */
3929
+ durationMs?: number | null;
3930
+ /**
3931
+ * How far the files disagree about the duration, in milliseconds (median absolute deviation).Zero means every file agrees; a large value means several versions are in circulation, whichis the more useful of the two statements. Null exactly when `durationMs` is null.
3932
+ */
3933
+ durationSpreadMs?: number | null;
3816
3934
  /**
3817
3935
  * The id property
3818
3936
  */
@@ -3825,6 +3943,10 @@ export interface VideoDetailDto extends AdditionalDataHolder, Parsable {
3825
3943
  * The preNames property
3826
3944
  */
3827
3945
  preNames?: VideoDetailPreNameDto[] | null;
3946
+ /**
3947
+ * What technical shapes a video is known to exist in, counted over the files prdb holds for it.
3948
+ */
3949
+ qualityOverview?: VideoQualityOverviewDto | null;
3828
3950
  /**
3829
3951
  * The releaseDate property
3830
3952
  */
@@ -3916,6 +4038,22 @@ export interface VideoFilehashChangeDto extends AdditionalDataHolder, Parsable {
3916
4038
  * Current persisted state of a changed video filehash row, including soft-delete fields.
3917
4039
  */
3918
4040
  export interface VideoFilehashChangeFilehashDto extends AdditionalDataHolder, Parsable {
4041
+ /**
4042
+ * Channel count of the audio stream.
4043
+ */
4044
+ audioChannels?: number | null;
4045
+ /**
4046
+ * Codec of the audio stream, lower-cased ("aac", "mp3").
4047
+ */
4048
+ audioCodec?: string | null;
4049
+ /**
4050
+ * Overall bit rate in bits per second, across all streams.
4051
+ */
4052
+ bitRate?: number | null;
4053
+ /**
4054
+ * Container as the probe names it. Usually a comma separated list of the formats one demuxer covers ("mov,mp4,m4a,3gp,3g2,mj2"), not a single token.
4055
+ */
4056
+ containerFormat?: string | null;
3919
4057
  /**
3920
4058
  * The createdAtUtc property
3921
4059
  */
@@ -3924,6 +4062,10 @@ export interface VideoFilehashChangeFilehashDto extends AdditionalDataHolder, Pa
3924
4062
  * Timestamp when the row was soft-deleted, or null when still active.
3925
4063
  */
3926
4064
  deletedAtUtc?: Date | null;
4065
+ /**
4066
+ * Duration of this file in milliseconds, as the submitting clients probed it, or null when none reported one.
4067
+ */
4068
+ durationMs?: number | null;
3927
4069
  /**
3928
4070
  * Original filename submitted for this filehash record.
3929
4071
  */
@@ -3932,6 +4074,14 @@ export interface VideoFilehashChangeFilehashDto extends AdditionalDataHolder, Pa
3932
4074
  * File size in bytes.
3933
4075
  */
3934
4076
  filesize?: number | null;
4077
+ /**
4078
+ * Average frame rate as a rational, exactly as it was measured: "24000/1001", never a roundeddecimal. Rounding merges rates that are not the same one, and a variable-rate file carries aper-file average whose large denominator is what marks it as variable rather than as a rate.
4079
+ */
4080
+ frameRate?: string | null;
4081
+ /**
4082
+ * Height of the video stream in pixels, as stored.
4083
+ */
4084
+ height?: number | null;
3935
4085
  /**
3936
4086
  * The id property
3937
4087
  */
@@ -3960,10 +4110,18 @@ export interface VideoFilehashChangeFilehashDto extends AdditionalDataHolder, Pa
3960
4110
  * The updatedAtUtc property
3961
4111
  */
3962
4112
  updatedAtUtc?: Date | null;
4113
+ /**
4114
+ * Codec of the video stream, lower-cased ("h264", "hevc", "av1").
4115
+ */
4116
+ videoCodec?: string | null;
3963
4117
  /**
3964
4118
  * The videoId property
3965
4119
  */
3966
4120
  videoId?: Guid | null;
4121
+ /**
4122
+ * Width of the video stream in pixels, as stored. Not necessarily the larger dimension: portrait video is ordinary.
4123
+ */
4124
+ width?: number | null;
3967
4125
  }
3968
4126
  /**
3969
4127
  * Seek cursor for continuing a video filehash change feed.
@@ -3979,10 +4137,30 @@ export interface VideoFilehashChangesCursorDto extends AdditionalDataHolder, Par
3979
4137
  updatedAtUtc?: Date | null;
3980
4138
  }
3981
4139
  export interface VideoFilehashDto extends AdditionalDataHolder, Parsable {
4140
+ /**
4141
+ * Channel count of the audio stream.
4142
+ */
4143
+ audioChannels?: number | null;
4144
+ /**
4145
+ * Codec of the audio stream, lower-cased ("aac", "mp3").
4146
+ */
4147
+ audioCodec?: string | null;
4148
+ /**
4149
+ * Overall bit rate in bits per second, across all streams.
4150
+ */
4151
+ bitRate?: number | null;
4152
+ /**
4153
+ * Container as the probe names it. Usually a comma separated list of the formats one demuxer covers ("mov,mp4,m4a,3gp,3g2,mj2"), not a single token.
4154
+ */
4155
+ containerFormat?: string | null;
3982
4156
  /**
3983
4157
  * The createdAtUtc property
3984
4158
  */
3985
4159
  createdAtUtc?: Date | null;
4160
+ /**
4161
+ * Duration of this file in milliseconds, as the submitting clients probed it, or null when none reported one.
4162
+ */
4163
+ durationMs?: number | null;
3986
4164
  /**
3987
4165
  * Original filename submitted for this filehash record.
3988
4166
  */
@@ -3991,6 +4169,14 @@ export interface VideoFilehashDto extends AdditionalDataHolder, Parsable {
3991
4169
  * File size in bytes.
3992
4170
  */
3993
4171
  filesize?: number | null;
4172
+ /**
4173
+ * Average frame rate as a rational, exactly as it was measured: "24000/1001", never a roundeddecimal. Rounding merges rates that are not the same one, and a variable-rate file carries aper-file average whose large denominator is what marks it as variable rather than as a rate.
4174
+ */
4175
+ frameRate?: string | null;
4176
+ /**
4177
+ * Height of the video stream in pixels, as stored.
4178
+ */
4179
+ height?: number | null;
3994
4180
  /**
3995
4181
  * The id property
3996
4182
  */
@@ -4015,10 +4201,18 @@ export interface VideoFilehashDto extends AdditionalDataHolder, Parsable {
4015
4201
  * The updatedAtUtc property
4016
4202
  */
4017
4203
  updatedAtUtc?: Date | null;
4204
+ /**
4205
+ * Codec of the video stream, lower-cased ("h264", "hevc", "av1").
4206
+ */
4207
+ videoCodec?: string | null;
4018
4208
  /**
4019
4209
  * The videoId property
4020
4210
  */
4021
4211
  videoId?: Guid | null;
4212
+ /**
4213
+ * Width of the video stream in pixels, as stored. Not necessarily the larger dimension: portrait video is ordinary.
4214
+ */
4215
+ width?: number | null;
4022
4216
  }
4023
4217
  export interface VideoFilehashesByVideoIdDto extends AdditionalDataHolder, Parsable {
4024
4218
  /**
@@ -4081,6 +4275,36 @@ export interface VideoImageChangesCursorDto extends AdditionalDataHolder, Parsab
4081
4275
  */
4082
4276
  updatedAtUtc?: Date | null;
4083
4277
  }
4278
+ /**
4279
+ * What technical shapes a video is known to exist in, counted over the files prdb holds for it.
4280
+ */
4281
+ export interface VideoQualityOverviewDto extends AdditionalDataHolder, Parsable {
4282
+ /**
4283
+ * Resolutions the video is known in, most files first. Width and height are as stored, neverreordered — a portrait file has the smaller width, and treating the larger side as "theresolution" is wrong for a substantial share of real libraries.
4284
+ */
4285
+ resolutions?: VideoResolutionCountDto[] | null;
4286
+ /**
4287
+ * Video codecs the video is known in, most files first.
4288
+ */
4289
+ videoCodecs?: VideoCodecCountDto[] | null;
4290
+ }
4291
+ /**
4292
+ * One resolution a video is known in, and how many of its files carry it.
4293
+ */
4294
+ export interface VideoResolutionCountDto extends AdditionalDataHolder, Parsable {
4295
+ /**
4296
+ * How many of the video's files are in this resolution.
4297
+ */
4298
+ fileCount?: number | null;
4299
+ /**
4300
+ * Height in pixels, as stored.
4301
+ */
4302
+ height?: number | null;
4303
+ /**
4304
+ * Width in pixels, as stored.
4305
+ */
4306
+ width?: number | null;
4307
+ }
4084
4308
  /**
4085
4309
  * Minimal actor summary included in a video list item.
4086
4310
  */
@@ -4106,6 +4330,18 @@ export interface VideoSummaryDto extends AdditionalDataHolder, Parsable {
4106
4330
  * Timestamp when the video was created in PRDB.
4107
4331
  */
4108
4332
  createdAtUtc?: Date | null;
4333
+ /**
4334
+ * How many files the duration was taken over, without which the spread cannot be read.
4335
+ */
4336
+ durationFileCount?: number | null;
4337
+ /**
4338
+ * Consensus duration in milliseconds across the files prdb holds for this video, or null whiletoo few independent submitters have reported one. A median over the video's files, so atrailer submitted under the same video does not move it.
4339
+ */
4340
+ durationMs?: number | null;
4341
+ /**
4342
+ * How far those files disagree about the duration, in milliseconds (median absolutedeviation). Zero means they agree; a large value means several versions are in circulation.
4343
+ */
4344
+ durationSpreadMs?: number | null;
4109
4345
  /**
4110
4346
  * Unique identifier of the video.
4111
4347
  */