@regulaforensics/face-sdk 6.3.3-beta

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

@@ -0,0 +1,11 @@
+import { MatchFacesImage } from './match_faces_image'
+import { MatchFacesDetectionFace } from './match_faces_detection_face'
+
+export class ComparedFace {
+    get imageIndex(): number
+    get image(): MatchFacesImage
+    get faceIndex(): number | null
+    get face(): MatchFacesDetectionFace | null
+
+    private constructor()
+}

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

@@ -0,0 +1,12 @@
+import { ComparedFace } from './compared_face'
+import { MatchFacesException } from './match_faces_exception'
+
+export class ComparedFacesPair {
+    get first(): ComparedFace
+    get second(): ComparedFace
+    get similarity(): number
+    get score(): number
+    get error(): MatchFacesException | null
+
+    private constructor()
+}

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

@@ -0,0 +1,8 @@
+import { ComparedFacesPair } from './compared_faces_pair'
+
+export class ComparedFacesSplit {
+    get matchedFaces(): Array<ComparedFacesPair>
+    get unmatchedFaces(): Array<ComparedFacesPair>
+
+    private constructor()
+}

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

@@ -0,0 +1,6 @@
+export class MatchFacesBackendException {
+    get code(): number
+    get message(): string
+
+    private constructor()
+}

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

@@ -0,0 +1,14 @@
+export class MatchFacesConfig {
+    processingMode: ProcessingMode
+
+    constructor(
+        params?: {
+            processingMode?: ProcessingMode
+        }
+    )
+}
+
+export enum ProcessingMode {
+    ONLINE,
+    OFFLINE,
+}

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

@@ -0,0 +1,12 @@
+import { MatchFacesImage } from './match_faces_image'
+import { MatchFacesDetectionFace } from './match_faces_detection_face'
+import { MatchFacesException } from './match_faces_exception'
+
+export class MatchFacesDetection {
+    get imageIndex(): number
+    get image(): MatchFacesImage
+    get faces(): Array<MatchFacesDetectionFace>
+    get error(): MatchFacesException | null
+
+    private constructor()
+}

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

@@ -0,0 +1,13 @@
+import { Point } from '../image_params/point'
+import { Rect } from '../image_params/rect'
+
+export class MatchFacesDetectionFace {
+    get faceIndex(): number
+    get landmarks(): Array<Point>
+    get faceRect(): Rect
+    get rotationAngle(): number | null
+    get originalRect(): Rect | null
+    get crop(): string | null
+
+    private constructor()
+}

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

@@ -0,0 +1,21 @@
+import { MatchFacesBackendException } from './match_faces_backend_exception'
+
+export class MatchFacesException {
+    get code(): MatchFacesErrorCode
+    get message(): string
+    get underlyingError(): MatchFacesBackendException | null
+
+    private constructor()
+}
+
+export enum MatchFacesErrorCode {
+    IMAGE_EMPTY,
+    FACE_NOT_DETECTED,
+    LANDMARKS_NOT_DETECTED,
+    FACE_ALIGNER_FAILED,
+    DESCRIPTOR_EXTRACTOR_ERROR,
+    IMAGES_COUNT_LIMIT_EXCEEDED,
+    API_CALL_FAILED,
+    PROCESSING_FAILED,
+    NO_LICENSE
+}

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

@@ -0,0 +1,16 @@
+import { ImageType } from '../face_capture/face_capture_image'
+
+export class MatchFacesImage {
+    get image(): string
+    get imageType(): ImageType
+    get detectAll(): boolean
+    get identifier(): string
+
+    constructor(
+        image: string,
+        imageType: ImageType,
+        params?: {
+            detectAll?: boolean
+        }
+    )
+}

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

@@ -0,0 +1,18 @@
+import { MatchFacesImage } from './match_faces_image'
+import { OutputImageParams } from '../image_params/output_image_params'
+
+export class MatchFacesRequest {
+    get images(): Array<MatchFacesImage>
+    get outputImageParams(): OutputImageParams | null
+    get tag(): string | null
+    get metadata(): Record<string, any> | null
+
+    constructor(
+        images: Array<MatchFacesImage>,
+        params?: {
+            outputImageParams?: OutputImageParams
+            tag?: string
+            metadata?: Record<string, any>
+        }
+    )
+}

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

@@ -0,0 +1,12 @@
+import { ComparedFacesPair } from './compared_faces_pair'
+import { MatchFacesDetection } from './match_faces_detection'
+import { MatchFacesException } from './match_faces_exception'
+
+export class MatchFacesResponse {
+    get results(): Array<ComparedFacesPair>
+    get detections(): Array<MatchFacesDetection>
+    get tag(): string | null
+    get error(): MatchFacesException | null
+
+    private constructor()
+}

package/www/types/person_database/edit_group_persons_request.d.ts

@@ -0,0 +1,8 @@
+export class EditGroupPersonsRequest {
+    constructor(
+        params: {
+            personIdsToAdd?: string[],
+            personIdsToRemove?: string[],
+        }
+    )
+}

package/www/types/person_database/image_upload.d.ts

@@ -0,0 +1,6 @@
+export class ImageUpload {
+    static withImageData(imageData: string): ImageUpload
+    static withImageUrl(imageUrl: string): ImageUpload
+
+    private constructor()
+}

package/www/types/person_database/pageable_item_list.d.ts

@@ -0,0 +1,7 @@
+export class PageableItemList<T> {
+    get items(): T[] | null
+    get page(): number
+    get totalPages(): number
+
+    private constructor()
+}

package/www/types/person_database/person.d.ts

@@ -0,0 +1,10 @@
+export class Person {
+    name: string
+    get updatedAt(): Date
+    get groups(): string[]
+    get id(): string
+    metadata: any
+    get createdAt(): Date
+
+    private constructor()
+}

package/www/types/person_database/person_database.d.ts

@@ -0,0 +1,92 @@
+import { Person } from './person'
+import { PersonImage } from './person_image'
+import { ImageUpload } from './image_upload'
+import { PageableItemList } from './pageable_item_list'
+import { PersonGroup } from './person_group'
+import { EditGroupPersonsRequest } from './edit_group_persons_request'
+import { SearchPersonRequest } from './search_person_request'
+import { SearchPerson } from './search_person'
+
+export class PersonDatabase {
+    createPerson(
+        name: string,
+        params?: {
+            groupIds?: string[],
+            metadata?: any,
+        }
+    ): Promise<[Person | null, string | null]>
+
+    updatePerson(person: Person): Promise<[boolean, string | null]>
+
+    deletePerson(personId: string): Promise<[boolean, string | null]>
+
+    getPerson(personId: string): Promise<[Person | null, string | null]>
+
+    addPersonImage(
+        personId: string,
+        image: ImageUpload
+    ): Promise<[PersonImage | null, string | null]>
+
+    deletePersonImage(
+        personId: string,
+        imageId: string
+    ): Promise<[boolean, string | null]>
+
+    getPersonImage(
+        personId: string,
+        imageId: string
+    ): Promise<[PersonImage | null, string | null]>
+
+    getPersonImages(personId: string): Promise<[PageableItemList<PersonImage>, string | null]>
+
+    getPersonImagesForPage(
+        personId: string,
+        page: number,
+        size: number
+    ): Promise<[PageableItemList<PersonImage>, string | null]>
+
+    createGroup(
+        name: string,
+        params?: {
+            metadata?: any,
+        }
+    ): Promise<[PersonGroup | null, string | null]>
+
+    updateGroup(group: PersonGroup): Promise<[boolean, string | null]>
+
+    editPersonsInGroup(
+        groupId: string,
+        request: EditGroupPersonsRequest
+    ): Promise<[boolean, string | null]>
+
+    deleteGroup(groupId: string): Promise<[boolean, string | null]>
+
+    getGroup(groupId: string): Promise<[PersonGroup | null, string | null]>
+
+    getGroups(): Promise<[PageableItemList<PersonGroup>, string | null]>
+
+    getGroupsForPage(
+        page: number,
+        size: number
+    ): Promise<[PageableItemList<PersonGroup>, string | null]>
+
+    getPersonGroups(personId: string): Promise<[PageableItemList<PersonGroup>, string | null]>
+
+    getPersonGroupsForPage(
+        personId: string,
+        page: number,
+        size: number
+    ): Promise<[PageableItemList<PersonGroup>, string | null]>
+
+    getPersonsInGroup(groupId: string): Promise<[PageableItemList<Person>, string | null]>
+
+    getPersonsInGroupForPage(
+        groupId: string,
+        page: number,
+        size: number
+    ): Promise<[PageableItemList<Person>, string | null]>
+
+    searchPerson(request: SearchPersonRequest): Promise<[SearchPerson[] | null, string | null]>
+
+    private constructor()
+}

package/www/types/person_database/person_group.d.ts

@@ -0,0 +1,8 @@
+export class PersonGroup {
+    name: string
+    get id(): string
+    metadata: any
+    get createdAt(): Date
+
+    private constructor()
+}

package/www/types/person_database/person_image.d.ts

@@ -0,0 +1,10 @@
+export class PersonImage {
+    get path(): string
+    get url(): string
+    get contentType(): string | null
+    get id(): string
+    get metadata(): any
+    get createdAt(): Date
+
+    private constructor()
+}

package/www/types/person_database/search_person.d.ts

@@ -0,0 +1,15 @@
+import { SearchPersonImage } from './search_person_image'
+import { SearchPersonDetection } from './search_person_detection'
+
+export class SearchPerson {
+    get images(): SearchPersonImage[]
+    get detection(): SearchPersonDetection | null
+    name: string
+    get updatedAt(): Date
+    get groups(): string[]
+    get id(): string
+    metadata: any
+    get createdAt(): Date
+
+    private constructor()
+}

package/www/types/person_database/search_person_detection.d.ts

@@ -0,0 +1,11 @@
+import { Point } from '../image_params/point'
+import { Rect } from '../image_params/rect'
+
+export class SearchPersonDetection {
+    get landmarks(): Point[]
+    get rect(): Rect
+    get crop(): string | null
+    get rotationAngle(): number | null
+
+    private constructor()
+}

package/www/types/person_database/search_person_image.d.ts

@@ -0,0 +1,12 @@
+export class SearchPersonImage {
+    get similarity(): number
+    get distance(): number
+    get path(): string
+    get url(): string
+    get contentType(): string | null
+    get id(): string
+    get metadata(): any
+    get createdAt(): Date
+
+    private constructor()
+}

package/www/types/person_database/search_person_request.d.ts

@@ -0,0 +1,15 @@
+import { ImageUpload } from './image_upload'
+import { OutputImageParams } from '../image_params/output_image_params'
+
+export class SearchPersonRequest {
+    constructor(
+        image: ImageUpload,
+        params?: {
+            groupIdsForSearch?: string[],
+            threshold?: number,
+            limit?: number,
+            detectAll?: boolean,
+            outputImageParams?: OutputImageParams
+        }
+    )
+}