@regulaforensics/face-sdk 6.3.93-beta → 6.3.95-beta

package/www/types/image_quality/image_quality_group.d.ts

@@ -1,154 +1,417 @@
 import { ImageQualityCharacteristic } from './image_quality_characteristic'
 import { ImageQualityRange } from './image_quality_range'
 
+/**
+ * Image Quality characteristic group
+ */
 export class ImageQualityGroup {
+    /**
+     * The Image characteristics group includes width, height, width to height proportions,
+     * the image RGB channels number, and padding ratio.
+     */
     static get image(): _Image
+    /**
+     * The Head size and position group includes the position of the "middle point"
+     * relative to the width and height of the image, the head width to the image
+     * width and height ratio, inter-eye distance, yaw, pitch, roll.
+     */
     static get headSizeAndPosition(): _HeadSizeAndPosition
+    /**
+     * The Face image quality group includes blur and noise levels, unnatural skin tone,
+     * and face dynamic range checks.
+     */
     static get faceImage(): _FaceImage
+    /**
+     * The Eyes characteristics group checks eyes closure, occlusion, hair coverage,
+     * red eye effect, and whether a person is looking directly at the camera.
+     */
     static get eyes(): _Eyes
+    /**
+     * The Shadows and lightning characteristics group checks whether a photo
+     * is too dark or overexposed, if there are glares or shadows on the face.
+     */
     static get shadowsAndLightning(): _ShadowsAndLightning
+    /**
+     * The Pose and expression characteristics group checks the shoulders pose,
+     * face expression, whether there is an open mouth or smile.
+     */
     static get poseAndExpression(): _PoseAndExpression
+    /**
+     * The Head occlusion group includes checks of glasses, face occlusion, and head coverage.
+     */
     static get headOcclusion(): _HeadOcclusion
+    /**
+     * The Background characteristics group checks the background uniformity,
+     * shadows on background, and other faces presence on the picture.
+     */
     static get background(): _Background
 }
 
 export class _Image {
+    /**
+     * The image width, pixels.
+     * Doesn't have recommended value. 
+     */
     imageWidth(range: ImageQualityRange): ImageQualityCharacteristic
 
+    /**
+     * The image height, pixels.
+     * Doesn't have recommended value.
+     */
     imageHeight(range: ImageQualityRange): ImageQualityCharacteristic
 
+    /**
+     * The image width to height proportion.
+     * Doesn't have recommended value.
+     */
     imageWidthToHeight(range: ImageQualityRange): ImageQualityCharacteristic
 
+    /**
+     * The image RGB channels number.
+     * Doesn't have recommended value.
+     * 
+     * @param channelsNumber - 3 is for RGB images.
+     */
     imageChannelsNumber(channelsNumber: number): ImageQualityCharacteristic
 
+    /**
+     * The percentage of the area of the image that was "padded" during alignment.
+     * The characteristic is needed to determine if the head goes beyond the image.
+     * The range is from 0 to 1 where 0 is 0% of the image is "padded".
+     * Doesn't have recommended value. 
+     */
     paddingRatio(range: ImageQualityRange): ImageQualityCharacteristic
 
+    /**
+     * Whether the face in the image is a photo, not a drawing, sculpture, cartoon, etc.
+     * If the returned value is out of the recommended range, the image is not a photo.
+     * The range is from 0 to 1 where 0 means the image is a photo.
+     */
     artFace(): ImageQualityCharacteristic
 
+    /**
+     * All Group characteristics with default (recommended) values.
+     * Doesn't include characteristics without default values.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()
 }
 
 export class _HeadSizeAndPosition {
+    /**
+     * The position of the "middle point" (the middle of the line connecting the eye centers)
+     * relative to the width of the image.
+     * The range is from 0 to 1 where range [0.5, 0.5] is for "middle point" strictly in the center .
+     */
     faceMidPointHorizontalPosition(): ImageQualityCharacteristic
 
+    /**
+     * The position of the "middle point" (the middle of the line connecting the eye centers)
+     * relative to the height of the image.
+     * The range is from 0 to 1 where range [0.5, 0.5] is for "middle point" strictly in the center .
+     */
     faceMidPointVerticalPosition(): ImageQualityCharacteristic
 
+    /**
+     * The head width to the image width ratio.
+     * The range is from 0 to 1.
+     */
     headWidthRatio(): ImageQualityCharacteristic
 
+    /**
+     * The head height to the image height ratio.
+     * The range is from 0 to 1.
+     */
     headHeightRatio(): ImageQualityCharacteristic
 
+    /**
+     * Inter-eye distance — the length of the line connecting the eye centers of the left and right eye, pixels.
+     */
     eyesDistance(): ImageQualityCharacteristic
 
+    /**
+     * The yaw of the head, degrees.
+     * The range is from -90 to 90. Range value [0, 0] for strictly stright head position.
+     */
     yaw(): ImageQualityCharacteristic
 
+    /**
+     * The pitch of the head, degrees.
+     * The range is from -90 to 90. Range value [0, 0] for strictly stright head position.
+     */
     pitch(): ImageQualityCharacteristic
 
+    /**
+     * The roll of the head, degrees.
+     * The range is from -90 to 90. Range value [0, 0] for strictly stright head position.
+     */
     roll(): ImageQualityCharacteristic
 
+    /**
+     * All Group characteristics with default (recommended) values.
+     * Doesn't include characteristics without default values.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()
 }
 
 export class _FaceImage {
+    /**
+     * The blur level.
+     * The range is from 0 to 1 where 0 is the absence of blur effect
+     */
     blurLevel(): ImageQualityCharacteristic
 
+    /**
+     * The noise level.
+     * The range is from 0 to 1 where 0 is minimal noise level.
+     */
     noiseLevel(): ImageQualityCharacteristic
 
+    /**
+     * The true-colour representation of the skin colour.
+     * The range is from 0 to 1.
+     */
     unnaturalSkinTone(): ImageQualityCharacteristic
 
+    /**
+     * The range of tonal difference between the lightest light and darkest dark of an image, bits.
+     */
     faceDynamicRange(): ImageQualityCharacteristic
 
+    /**
+     * All Group characteristics with default (recommended) values.
+     * Doesn't include characteristics without default values.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()
 }
 
 export class _Eyes {
+    /**
+     * Whether the right eye is closed.
+     * The range is from 0 to 1 where 1 is the eye is fully closed.
+     */
     eyeRightClosed(): ImageQualityCharacteristic
 
+    /**
+     * Whether the left eye is closed.
+     * The range is from 0 to 1 where 1 is the eye is fully closed.
+     */
     eyeLeftClosed(): ImageQualityCharacteristic
 
+    /**
+     * Whether the right eye is occluded.
+     * The range is from 0 to 1 where 1 is the eye is fully occluded.
+     */
     eyeRightOccluded(): ImageQualityCharacteristic
 
+    /**
+     *  Whether the left eye is occluded.
+     * The range is from 0 to 1 where 1 is the eye is fully occluded.
+     */
     eyeLeftOccluded(): ImageQualityCharacteristic
 
+    /**
+     * Whether there is the red-eye effect.
+     * The range is from 0 to 1 where 0 is the absence of  red-eye effect.
+     */
     eyesRed(): ImageQualityCharacteristic
 
+    /**
+     * Whether the right eye is covered with hair.
+     * The range is from 0 to 1 where 1 is 100% of the eye is covered by hair.
+     */
     eyeRightCoveredWithHair(): ImageQualityCharacteristic
 
+    /**
+     * Whether the left eye is covered with hair.
+     * The range is from 0 to 1 where 1 is 100% of the eye is covered by hair.
+     */
     eyeLeftCoveredWithHair(): ImageQualityCharacteristic
 
+    /**
+     * Whether the person is not looking directly at the camera.
+     * The range is from 0 to 1 where 0 is for absolutely direct look.
+     */
     offGaze(): ImageQualityCharacteristic
 
+    /**
+     * All Group characteristics with default (recommended) values.
+     * Doesn't include characteristics without default values.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()
 }
 
 export class _ShadowsAndLightning {
+    /**
+     * Whether the photo is too dark.
+     * The range is from 0 to 1.
+     */
     tooDark(): ImageQualityCharacteristic
 
+    /**
+     * Whether the photo is overexposed.
+     * The range is from 0 to 1.
+     */
     tooLight(): ImageQualityCharacteristic
 
+    /**
+     * Whether there is glare on the face.
+     * The range is from 0 to 1 where 0 is the absence of glare.
+     */
     faceGlare(): ImageQualityCharacteristic
 
+    /**
+     * Whether there are shadows on the face.
+     * The range is from 0 to 1 where 0 is the absence of shadows on the face.
+     */
     shadowsOnFace(): ImageQualityCharacteristic
 
+    /**
+     * All Group characteristics with default (recommended) values.
+     * Doesn't include characteristics without default values.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()
 }
 
 export class _PoseAndExpression {
+    /**
+     * Checks the symmetry of the shoulders.
+     * The range is from 0 to 1 where 1 is for absolutely symmetrical shoulders.
+     */
     shouldersPose(): ImageQualityCharacteristic
 
+    /**
+     * Checks the presence of any emotional facial expression.
+     * The range is from 0 to 1 where 0 is for absolutely non-emotional expression.
+     */
     expressionLevel(): ImageQualityCharacteristic
 
+    /**
+     * Whether the mouth is open.
+     * The range is from 0 to 1 where 0 is closed mouth.
+     */
     mouthOpen(): ImageQualityCharacteristic
 
+    /**
+     * Whether the person smiles.
+     * The range is from 0 to 1 where 0 is smile absence.
+     */
     smile(): ImageQualityCharacteristic
 
+    /**
+     * All Group characteristics with default (recommended) values.
+     * Doesn't include characteristics without default values.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()
 }
 
 export class _HeadOcclusion {
+    /**
+     * Whether the person wears dark glasses.
+     * The range is from 0 to 1 where 0 is dark glasses absence.
+     */
     darkGlasses(): ImageQualityCharacteristic
 
+    /**
+     * Whether there are reflections on glasses.
+     * The range is from 0 to 1 where 0 is reflections absence.
+     * In the current release, always succeeds. Will be developed in the coming releases.
+     */
     reflectionOnGlasses(): ImageQualityCharacteristic
 
+    /**
+     * Whether the glasses frames do not obscure eye details and the irises of both eyes are visible.
+     * The range is from 0 to 20 where 0 the absence of frames (glasses).
+     */
     framesTooHeavy(): ImageQualityCharacteristic
 
+    /**
+     * Whether the face is visible and not occluded.
+     * The range is from 0 to 1 where 0 is face occlusion absence.
+     */
     faceOccluded(): ImageQualityCharacteristic
 
+    /**
+     * Whether there is any head coverage other than religious headwear.
+     * The range is from 0 to 1.
+     */
     headCovering(): ImageQualityCharacteristic
 
+    /**
+     * Whether the forehead is covered.
+     * The range is from 0 to 1.
+     */
     foreheadCovering(): ImageQualityCharacteristic
 
+    /**
+     * Whether the makeup is too strong.
+     * In the current release, always succeeds. Will be developed in the coming releases.
+     * The range is from 0 to 1.
+     */
     strongMakeup(): ImageQualityCharacteristic
 
+    /**
+     * Whether the person is wearing headphones.
+     * The range is from 0 to 1 where 0 is headphones absence.
+     */
     headphones(): ImageQualityCharacteristic
 
+    /**
+     * Whether the person is wearing a medical mask.
+     * The range is from 0 to 1 where 0 is medical mask absence.
+     */
     medicalMask(): ImageQualityCharacteristic
 
+    /**
+     * All Group characteristics with default (recommended) values.
+     * Doesn't include characteristics without default values.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()
 }
 
 export class _Background {
+    /**
+     * Checks uniformity of the portrait background.
+     * The range is from 0 to 1 where 1 is absolute background uniformity.
+     */
     backgroundUniformity(): ImageQualityCharacteristic
 
+    /**
+     * Whether there are shadows on the portrait background.
+     * The range is from 0 to 1 where 1 is the absence of shadows on the portrait background.
+     */
     shadowsOnBackground(): ImageQualityCharacteristic
 
+    /** 
+     * The number of faces on the photo.
+     * The range is from 0 to 1 where 1 is full background color match.
+     */
     otherFaces(): ImageQualityCharacteristic
 
+    /**
+     * Whether the background color matches default background color.
+     * Default color is white (RGB(255,255,255) or hex #FFFFFF)
+     * The range is from 0 to 1 where 1 is full background color match.
+     */
     backgroundColorMatch(params?: { color?: number }): ImageQualityCharacteristic
 
+    /**
+     * Whether the background color matches the required color.
+     * The range is from 0 to 1 where 1 is full background color match.
+     */
     allRecommended(): Array<ImageQualityCharacteristic>
 
     private constructor()

package/www/types/init/face_sdk_version.d.ts

@@ -1,6 +1,15 @@
 export class FaceSDKVersion {
+    /**
+     * Version of the API module.
+     */
     get api(): string | null
+    /**
+     * Version of the CORE module.
+     */
     get core(): string | null
+    /**
+     * CORE module variant.
+     */
     get coreMode(): string | null
 
     private constructor()

package/www/types/init/init_config.d.ts

@@ -1,4 +1,13 @@
+/**
+ * A configuration file for FaceSDK initialization.
+ * Allows to initialize using license binary.
+ * Also controls initialization time properties such as licenseUpdate.
+ */
 export class InitConfig {
+    /**
+     * @param license - The license binary file.
+     * @param params.licenseUpdate - Enables automatic license update check during {@link FaceSDK} initialization.
+     */
     constructor(
         license: string,
         params?: {

package/www/types/liveness/liveness_config.d.ts

@@ -1,21 +1,87 @@
 import { CameraPosition } from '../customization/camera_position'
 import { ScreenOrientation } from '../customization/screen_orientation'
 
+/**
+ * Configuration for the Liveness processing.
+ * The configuration provides convenient properties to change the behavior and the appearance of the Liveness UI module.
+ */
 export class LivenessConfig {
+    /**
+     * Defines, whether the logo is visible on the bottom of Liveness UI screens. Defaults to `true`.
+     */
     copyright: boolean
+
+    /**
+     * Defines, whether the camera's toolbar switch camera button is available on the Liveness UI. Defaults to `false`.
+     * When set to `true` the CameraToolbarView will contain a button to change current `cameraPosition`.
+     * Only for livenessType = {@link LivenessType.PASSIVE}.
+     */
     cameraSwitchEnabled: boolean
+
     closeButtonEnabled: boolean
+
+    /**
+     * Defines, whether the camera's toolbar torch button is available on the Liveness UI. Defaults to `true`.
+     * When set to `false` the CameraToolbarView won't contain a button to toggle camera's flashlight.
+     * Only for livenessType = {@link LivenessType.PASSIVE}.
+     */
     torchButtonEnabled: boolean
+
+    /**
+     * Enables vibration during Liveness processing. Defaults to `true`.
+     */
     vibrateOnSteps: boolean
+
+    /**
+     * Android only.
+     */
     cameraPositionAndroid?: number
+
+    /**
+     * IOS only.
+     */
     cameraPositionIOS: CameraPosition
+
+    /**
+     * Android only.
+     */
     screenOrientation?: Array<ScreenOrientation>
+
+    /**
+     * Defines whether the liveness request sends a location of a device. Defaults to `true`.
+     * When set to `true` the liveness request to web service will contain the `location`
+     * object within the json `metadata` object.
+     * The location is used only when permissions are granted and the location is available.
+     */
     locationTrackingEnabled: boolean
+
+    /**
+     * The number of attempts to pass the Liveness before completing with error. Defaults to `0`.
+     * When set to `0`  the Liveness will always ask to retry on error.
+     */
     attemptsCount: number
+
+    /**
+     * Defines whether the liveness recording video of processing.
+     * Defaults to {@link RecordingProcess.ASYNCHRONOUS_UPLOAD}.
+     */
     recordingProcess: RecordingProcess
+
+    /**
+     * Defines whether the liveness processing type. Defaults to {@link LivenessType.ACTIVE}.
+     */
     livenessType: LivenessType
+
+    /**
+     * Defines tag that can be used in Liveness processing. Defaults to `null`.
+     */
     tag?: string
+
+    /**
+     * Defines which steps of the user interface can be omitted. See {@link LivenessSkipStep} enum for details.
+     */
     skipStep: Array<LivenessSkipStep>
+
     metadata?: Record<string, any>
 
     constructor(

package/www/types/liveness/liveness_notification.d.ts

@@ -7,6 +7,9 @@ export class LivenessNotification {
     private constructor()
 }
 
+/**
+ * Liveness process statuses.
+ */
 export enum LivenessProcessStatus {
     START,
     PREPARING,

package/www/types/liveness/liveness_response.d.ts

@@ -1,18 +1,42 @@
 
 import { LivenessException } from './liveness_exception'
 
+/**
+ * The response from the Liveness module.
+ */
 export class LivenessResponse {
+    /**
+     * The input image used to determine the liveness.
+     */
     get image(): string | null
+
+    /**
+     * The status of the Liveness processing.
+     */
     get liveness(): LivenessStatus
+
     get tag(): string | null
     get transactionId(): string | null
     get estimatedAge(): number | null
+
+    /**
+     * The error describes a failed liveness check and contains {@link LivenessErrorCode} codes.
+     */
     get error(): LivenessException | null
 
     private constructor()
 }
 
+/**
+ * The status of the Liveness processing.
+ */
 export enum LivenessStatus {
+    /**
+     * The liveness check is passed successfully.
+     */
     PASSED,
+    /**
+     * The liveness check result is unknown.
+     */
     UNKNOWN,
 }

package/www/types/match_faces/compared_face.d.ts

@@ -1,10 +1,28 @@
 import { MatchFacesImage } from './match_faces_image'
 import { MatchFacesDetectionFace } from './match_faces_detection_face'
 
+/**
+ * Represents a reference information of the compared face.
+ */
 export class ComparedFace {
+    /**
+     * The index to the input image in the input array provided to the request.
+     */
     get imageIndex(): number
+
+    /**
+     * The input image used for comparison operation.
+     */
     get image(): MatchFacesImage
+
+    /**
+     * The index to the array of `faces` in the `detection` results.
+     */
     get faceIndex(): number | null
+
+    /**
+     * The face detection result.
+     */
     get face(): MatchFacesDetectionFace | null
 
     private constructor()

package/www/types/match_faces/compared_faces_pair.d.ts

@@ -1,11 +1,35 @@
 import { ComparedFace } from './compared_face'
 import { MatchFacesException } from './match_faces_exception'
 
+/**
+ * Represents a result of the {@link ComparedFace} attempt to compare input images.
+ */
 export class ComparedFacesPair {
+    /**
+     * The first face in the comparison pair.
+     */
     get first(): ComparedFace
+
+    /**
+     * The second face in the comparison pair.
+     */
     get second(): ComparedFace
+
+    /**
+     * Similarity of the faces pair. Floating point value from 0 to 1.
+     */
     get similarity(): number
+
+    /**
+     * The raw value returned by the service without applying any thresholds or comparison rules.
+     * The value shows the degree of similarity of compared faces, the lower - the more similar, and vice versa less similar.
+     * The `score` is used in conjunction with the input image `imageType` to evaluate `similarity`.
+     */
     get score(): number
+
+    /**
+     * The error describes a failed pair comparison and contains {@link MatchFacesErrorCode} codes.
+     */
     get error(): MatchFacesException | null
 
     private constructor()

package/www/types/match_faces/match_faces_detection.d.ts

@@ -2,10 +2,28 @@ import { MatchFacesImage } from './match_faces_image'
 import { MatchFacesDetectionFace } from './match_faces_detection_face'
 import { MatchFacesException } from './match_faces_exception'
 
+/**
+ * Represents detection results on an input image as a part of {@link MatchFacesResponse}.
+ */
 export class MatchFacesDetection {
+    /**
+     * The index to the input image in the input array provided to the request.
+     */
     get imageIndex(): number
+
+    /**
+     * The input image used for comparison operation.
+     */
     get image(): MatchFacesImage
+
+    /**
+     * The array of faces detected on the image.
+     */
     get faces(): Array<MatchFacesDetectionFace>
+
+    /**
+     * The error describes a failed face detection and contains {@link MatchFacesErrorCode} codes.
+     */
     get error(): MatchFacesException | null
 
     private constructor()