facecog-liveness-showcase 0.0.1

package/projects/facecog-liveness-verification/src/lib/liveness-verification.module.ts

@@ -0,0 +1,123 @@
+import { NgModule, ModuleWithProviders } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { IonicModule } from '@ionic/angular';
+import { HttpClientModule } from '@angular/common/http';
+
+import { LivenessVerificationComponent } from './components/liveness-verification/liveness-verification.component';
+import { PoseSelectionComponent } from './components/pose-selection/pose-selection.component';
+import { CameraVerificationComponent } from './components/camera-verification/camera-verification.component';
+import { VerificationResultComponent } from './components/verification-result/verification-result.component';
+import { AwsFaceLivenessComponent } from './components/aws-face-liveness/aws-face-liveness.component';
+import { LivenessVerificationConfig } from './interfaces/liveness-verification-config.interface';
+import { DEFAULT_LIVENESS_CONFIG } from './models/constants/default-liveness-config.constant';
+import { LIVENESS_VERIFICATION_CONFIG } from './models/constants/liveness-verification-config.token';
+import { AWS_FACE_LIVENESS_COMPONENT } from './models/constants/aws-face-liveness-component.token';
+import { CAMERA_PROVIDER } from './interfaces/camera-provider.interface';
+import { BACKEND_HTTP_CLIENT } from './interfaces/backend-http-client.interface';
+import { CUSTOM_POSE_REPOSITORY } from './interfaces/custom-pose-repository.interface';
+import { LivenessConfigService } from './services/liveness-config.service';
+import { PoseSelectionService } from './services/pose-selection.service';
+import { CameraService } from './services/camera.service';
+import { VideoRecorderService } from './services/video-recorder.service';
+import { MockBackendService } from './services/backends/mock-backend.service';
+import { BackendHttpService } from './services/backend-http.service';
+import { CustomPosesApiService } from './services/custom-poses-api.service';
+
+@NgModule({
+  imports: [
+    CommonModule,
+    IonicModule,
+    HttpClientModule,
+    LivenessVerificationComponent,
+    PoseSelectionComponent,
+    CameraVerificationComponent,
+    VerificationResultComponent
+  ],
+  exports: [
+    LivenessVerificationComponent,
+    PoseSelectionComponent,
+    CameraVerificationComponent,
+    VerificationResultComponent
+  ]
+})
+export class LivenessVerificationModule {
+  /**
+   * Configure the module with global settings
+   * 
+   * @example
+   * ```typescript
+   * LivenessVerificationModule.forRoot({
+   *   apiUrl: 'https://api.example.com',
+   *   backends: ['amazon', 'facetec'],
+   *   maxRetries: 3
+   * })
+   * ```
+   */
+  static forRoot(config?: Partial<LivenessVerificationConfig>): ModuleWithProviders<LivenessVerificationModule> {
+    return {
+      ngModule: LivenessVerificationModule,
+      providers: [
+        {
+          provide: LIVENESS_VERIFICATION_CONFIG,
+          useValue: { ...DEFAULT_LIVENESS_CONFIG, ...config }
+        },
+        LivenessConfigService,
+        PoseSelectionService,
+        CameraService,
+        VideoRecorderService,
+        MockBackendService
+      ]
+    };
+  }
+}
+
+/**
+ * Provide liveness verification services for standalone components
+ * 
+ * @example
+ * ```typescript
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideLivenessVerification({
+ *       apiUrl: 'https://api.example.com',
+ *       backends: ['mock']
+ *     })
+ *   ]
+ * });
+ * ```
+ */
+export function provideLivenessVerification(config?: Partial<LivenessVerificationConfig>) {
+  return [
+    {
+      provide: LIVENESS_VERIFICATION_CONFIG,
+      useValue: { ...DEFAULT_LIVENESS_CONFIG, ...config }
+    },
+    LivenessConfigService,
+    PoseSelectionService,
+    CameraService,
+    VideoRecorderService,
+    MockBackendService
+  ];
+}
+
+/**
+ * Provide the full liveness flow (showcase-style) with default AWS component and backend/camera providers.
+ * Use this when you want the same UI as the FaceCog showcase with <facecog-liveness-flow>.
+ *
+ * @example
+ * ```typescript
+ * providers: [
+ *   provideLivenessFlow({ apiUrl: environment.facecogApiUrl })
+ * ]
+ * ```
+ * Then in template: <facecog-liveness-flow></facecog-liveness-flow>
+ */
+export function provideLivenessFlow(config?: Partial<LivenessVerificationConfig>) {
+  return [
+    ...provideLivenessVerification(config),
+    { provide: BACKEND_HTTP_CLIENT, useClass: BackendHttpService },
+    { provide: CUSTOM_POSE_REPOSITORY, useClass: CustomPosesApiService },
+    { provide: CAMERA_PROVIDER, useExisting: CameraService },
+    { provide: AWS_FACE_LIVENESS_COMPONENT, useValue: AwsFaceLivenessComponent }
+  ];
+}

package/projects/facecog-liveness-verification/src/lib/models/constants/aws-face-liveness-component.token.ts

@@ -0,0 +1,23 @@
+import { InjectionToken, Type } from '@angular/core';
+
+/**
+ * Optional injection token for the AWS Face Liveness component.
+ * When provided, the LivenessFlowComponent will render it in the aws-liveness step
+ * when useAwsFaceLiveness is true. The component must have:
+ * - @Input() region: string
+ * - @Input() autoStart: boolean
+ * - @Input() showCancelButton?: boolean
+ * - @Output() scanComplete: EventEmitter<AwsFaceLivenessScanResult>
+ * - @Output() scanCancelled: EventEmitter<void>
+ *
+ * @example
+ * ```typescript
+ * import { AwsFaceLivenessComponent } from './aws-face-liveness.component';
+ * import { AWS_FACE_LIVENESS_COMPONENT } from '@naniteninja/liveness-verification';
+ *
+ * providers: [
+ *   { provide: AWS_FACE_LIVENESS_COMPONENT, useValue: AwsFaceLivenessComponent }
+ * ]
+ * ```
+ */
+export const AWS_FACE_LIVENESS_COMPONENT = new InjectionToken<Type<unknown>>('AWS_FACE_LIVENESS_COMPONENT');

package/projects/facecog-liveness-verification/src/lib/models/constants/category-info.constant.ts

@@ -0,0 +1,14 @@
+import { PoseCategory } from '../../types/pose-category.type';
+import { CategoryInfo } from '../../interfaces/category-info.interface';
+
+/**
+ * Category display names and colors
+ */
+export const CATEGORY_INFO: Record<PoseCategory, CategoryInfo> = {
+  face: { name: 'Face Expressions', icon: 'happy-outline', color: 'primary' },
+  head: { name: 'Head Movements', icon: 'sync-outline', color: 'secondary' },
+  hand: { name: 'Hand Gestures', icon: 'hand-left-outline', color: 'tertiary' },
+  gesture: { name: 'Gestures', icon: 'hand-right-outline', color: 'success' },
+  combined: { name: 'Combined', icon: 'body-outline', color: 'warning' }
+};
+

package/projects/facecog-liveness-verification/src/lib/models/constants/default-liveness-config.constant.ts

@@ -0,0 +1,18 @@
+import { LivenessVerificationConfig } from '../../interfaces/liveness-verification-config.interface';
+
+/**
+ * Default configuration for the library
+ */
+export const DEFAULT_LIVENESS_CONFIG: LivenessVerificationConfig = {
+  apiUrl: 'http://localhost:3002',
+  backends: ['mock'],
+  maxRetries: 3,
+  autoCapture: true,
+  enableVideoRecording: true,
+  similarityThreshold: 0.62,
+  videoMaxSizeMB: 10,
+  captureFrameCount: 5,
+  showIntroScreen: true,
+  showPoseSelector: true
+};
+

package/projects/facecog-liveness-verification/src/lib/models/constants/index.ts

@@ -0,0 +1,5 @@
+export { DEFAULT_LIVENESS_CONFIG } from './default-liveness-config.constant';
+export { LIVENESS_VERIFICATION_CONFIG } from './liveness-verification-config.token';
+export { POSE_DEFINITIONS } from './pose-definitions.constant';
+export { CATEGORY_INFO } from './category-info.constant';
+

package/projects/facecog-liveness-verification/src/lib/models/constants/liveness-verification-config.token.ts

@@ -0,0 +1,16 @@
+import { InjectionToken } from '@angular/core';
+import { LivenessVerificationConfig } from '../../interfaces/liveness-verification-config.interface';
+import { DEFAULT_LIVENESS_CONFIG } from './default-liveness-config.constant';
+
+/**
+ * Injection token for library configuration.
+ * Provides DEFAULT_LIVENESS_CONFIG as factory fallback so services that inject
+ * this token with @Optional() never hit NG0203 in dynamic component contexts.
+ */
+export const LIVENESS_VERIFICATION_CONFIG = new InjectionToken<LivenessVerificationConfig>(
+  'LivenessVerificationConfig',
+  {
+    providedIn: 'root',
+    factory: () => DEFAULT_LIVENESS_CONFIG
+  }
+);

package/projects/facecog-liveness-verification/src/lib/models/constants/pose-definitions.constant.ts

@@ -0,0 +1,377 @@
+import { PoseDefinition } from '../../interfaces/pose-definition.interface';
+
+/**
+ * All predefined poses for liveness verification (40 poses)
+ */
+export const POSE_DEFINITIONS: PoseDefinition[] = [
+  // Face Expressions & Movements (1-6)
+  {
+    id: 1,
+    name: 'Face Straight',
+    description: 'Face straight, hold still',
+    category: 'face',
+    imagePath: 'assets/images/poses/face_straight.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 2,
+    name: 'Blink Once',
+    description: 'Blink once, naturally',
+    category: 'face',
+    imagePath: 'assets/images/poses/blink.jpeg',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 3,
+    name: 'Blink Twice',
+    description: 'Blink twice, quickly',
+    category: 'face',
+    imagePath: 'assets/images/poses/blink_twice.jpeg',
+    detectionStrategy: 'face-api',
+    difficulty: 'medium'
+  },
+  {
+    id: 4,
+    name: 'Open Mouth',
+    description: 'Open mouth, then close',
+    category: 'face',
+    imagePath: 'assets/images/poses/open_mouth.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 5,
+    name: 'Smile',
+    description: 'Smile, then return to neutral',
+    category: 'face',
+    imagePath: 'assets/images/poses/smile.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 6,
+    name: 'Raise Eyebrows',
+    description: 'Raise eyebrows ("surprised" look)',
+    category: 'face',
+    imagePath: 'assets/images/poses/raise_eyebrow.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+
+  // Head Movements (7-14)
+  {
+    id: 7,
+    name: 'Turn Left',
+    description: 'Turn head slowly left (profile)',
+    category: 'head',
+    imagePath: 'assets/images/poses/turn_left.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 8,
+    name: 'Turn Right',
+    description: 'Turn head slowly right (profile)',
+    category: 'head',
+    imagePath: 'assets/images/poses/turn_right.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 9,
+    name: 'Look Up',
+    description: 'Look up with just your eyes',
+    category: 'face',
+    imagePath: 'assets/images/poses/look_up.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'medium'
+  },
+  {
+    id: 10,
+    name: 'Look Down',
+    description: 'Look down with just your eyes',
+    category: 'face',
+    imagePath: 'assets/images/poses/look_down.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'medium'
+  },
+  {
+    id: 11,
+    name: 'Tilt Left',
+    description: 'Tilt head slightly left (ear to shoulder)',
+    category: 'head',
+    imagePath: 'assets/images/poses/tilt_left.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 12,
+    name: 'Tilt Right',
+    description: 'Tilt head slightly right (ear to shoulder)',
+    category: 'head',
+    imagePath: 'assets/images/poses/tilt_right.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 13,
+    name: 'Nod',
+    description: 'Nod up and down once or twice',
+    category: 'head',
+    imagePath: 'assets/images/poses/nod.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+  {
+    id: 14,
+    name: 'Shake Head',
+    description: 'Shake head left to right once or twice',
+    category: 'head',
+    imagePath: 'assets/images/poses/shake_head.jpeg',
+    detectionStrategy: 'face-api',
+    difficulty: 'easy'
+  },
+
+  // Eye & Face Tracking (15-20)
+  {
+    id: 15,
+    name: 'Follow Dot',
+    description: 'Follow a moving dot/marker with your eyes',
+    category: 'face',
+    imagePath: 'assets/images/poses/follow_dot.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'hard'
+  },
+  {
+    id: 16,
+    name: 'Wink',
+    description: 'Hold a wink (close one eye)',
+    category: 'face',
+    imagePath: 'assets/images/poses/wink.jpeg',
+    detectionStrategy: 'face-api',
+    difficulty: 'medium'
+  },
+  {
+    id: 17,
+    name: 'Move Closer',
+    description: 'Move your face closer, then back to center',
+    category: 'head',
+    imagePath: 'assets/images/poses/move_closer.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'medium'
+  },
+  {
+    id: 18,
+    name: 'Speak Phrase',
+    description: 'Speak a short random phrase (audio+video)',
+    category: 'face',
+    imagePath: 'assets/images/poses/18-speak-phrase.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'hard'
+  },
+  {
+    id: 19,
+    name: 'Rotate Face',
+    description: 'Slowly rotate face under normal light (passive liveness)',
+    category: 'head',
+    imagePath: 'assets/images/poses/rotate_face.jpeg',
+    detectionStrategy: 'face-api',
+    difficulty: 'medium'
+  },
+  {
+    id: 20,
+    name: 'Center Face',
+    description: 'Keep face centered while the phone moves slightly (parallax)',
+    category: 'head',
+    imagePath: 'assets/images/poses/20-center-face.png',
+    detectionStrategy: 'face-api',
+    difficulty: 'hard'
+  },
+
+  // Basic Hand Gestures (21-29)
+  {
+    id: 21,
+    name: 'Right Palm',
+    description: 'Show your RIGHT hand with palm facing camera (all fingers extended)',
+    category: 'hand',
+    imagePath: 'assets/images/poses/21-right-palm.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'easy'
+  },
+  {
+    id: 22,
+    name: 'Left Palm',
+    description: 'Show your LEFT hand with palm facing camera (all fingers extended)',
+    category: 'hand',
+    imagePath: 'assets/images/poses/22-left-palm.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'easy'
+  },
+  {
+    id: 23,
+    name: 'Wave Right',
+    description: 'Raise RIGHT hand and wave',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/23-wave-right.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'medium'
+  },
+  {
+    id: 24,
+    name: 'Thumbs Up Right',
+    description: 'Show your RIGHT hand with thumbs up gesture (only thumb extended)',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/24-thumbs-up-right.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'easy'
+  },
+  {
+    id: 25,
+    name: 'Thumbs Up Left',
+    description: 'Show your LEFT hand with thumbs up gesture (only thumb extended)',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/25-thumbs-up-left.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'easy'
+  },
+  {
+    id: 26,
+    name: 'OK Sign Right',
+    description: '"OK" sign with right hand',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/26-ok-sign-right.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'medium'
+  },
+  {
+    id: 27,
+    name: 'Peace Sign Left',
+    description: 'Show your LEFT hand with peace/V sign (index and middle fingers extended)',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/27-peace-sign-left.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'easy'
+  },
+  {
+    id: 28,
+    name: 'Three Fingers Right',
+    description: 'Hold up three fingers (right hand)',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/28-three-fingers-right.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'medium'
+  },
+  {
+    id: 29,
+    name: 'Five Fingers Left',
+    description: 'Hold up five fingers (left hand)',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/29-five-fingers-left.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'easy'
+  },
+
+  // Face + Hand Combined Poses (30-40)
+  {
+    id: 30,
+    name: 'Touch Nose Right',
+    description: 'Touch your nose with right index finger',
+    category: 'combined',
+    imagePath: 'assets/images/poses/touch_nose_right.png',
+    detectionStrategy: 'combined',
+    difficulty: 'medium'
+  },
+  {
+    id: 31,
+    name: 'Touch Chin Left',
+    description: 'Touch your chin with left index finger',
+    category: 'combined',
+    imagePath: 'assets/images/poses/touch_chin_left.png',
+    detectionStrategy: 'combined',
+    difficulty: 'medium'
+  },
+  {
+    id: 32,
+    name: 'Touch Right Cheek',
+    description: 'Touch your right cheek with right palm',
+    category: 'combined',
+    imagePath: 'assets/images/poses/touch_right_cheek.jpeg',
+    detectionStrategy: 'combined',
+    difficulty: 'medium'
+  },
+  {
+    id: 33,
+    name: 'Touch Left Cheek',
+    description: 'Touch your left cheek with left palm',
+    category: 'combined',
+    imagePath: 'assets/images/poses/touch_left_cheek.jpeg',
+    detectionStrategy: 'combined',
+    difficulty: 'medium'
+  },
+  {
+    id: 34,
+    name: 'Cover Right Eye',
+    description: 'Cover right eye with right hand, then uncover',
+    category: 'combined',
+    imagePath: 'assets/images/poses/cover_right_eye.png',
+    detectionStrategy: 'combined',
+    difficulty: 'medium'
+  },
+  {
+    id: 35,
+    name: 'Cover Mouth',
+    description: 'Cover your mouth with one hand, then uncover',
+    category: 'combined',
+    imagePath: 'assets/images/poses/cover_mouth.png',
+    detectionStrategy: 'combined',
+    difficulty: 'easy'
+  },
+  {
+    id: 36,
+    name: 'Frame Face',
+    description: 'Frame your face with both hands (sides of face)',
+    category: 'combined',
+    imagePath: 'assets/images/poses/36-frame-face.png',
+    detectionStrategy: 'combined',
+    difficulty: 'medium'
+  },
+  {
+    id: 37,
+    name: 'Hand Ear to Shoulder',
+    description: 'Move right hand from ear level to shoulder level',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/37-hand-ear-shoulder.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'medium'
+  },
+  {
+    id: 38,
+    name: 'Cross Arms',
+    description: 'Cross arms briefly, then return hands down',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/cross_arms.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'easy'
+  },
+  {
+    id: 39,
+    name: 'Clap Once',
+    description: 'Clap once softly in view',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/clap.jpeg',
+    detectionStrategy: 'openpose',
+    difficulty: 'medium'
+  },
+  {
+    id: 40,
+    name: 'Point Left-Right',
+    description: 'Point to left edge, then right edge of screen with index finger',
+    category: 'gesture',
+    imagePath: 'assets/images/poses/40-point-left-right.png',
+    detectionStrategy: 'openpose',
+    difficulty: 'hard'
+  }
+];
+

package/projects/facecog-liveness-verification/src/lib/models/index.ts

@@ -0,0 +1,5 @@
+// Constants
+export * from './constants';
+
+// Utils
+export * from './utils';

package/projects/facecog-liveness-verification/src/lib/models/utils/index.ts

@@ -0,0 +1,2 @@
+export { getPosesByCategory, getPosesByDifficulty, getPoseById } from './pose.utils';
+

package/projects/facecog-liveness-verification/src/lib/models/utils/pose.utils.spec.ts

@@ -0,0 +1,76 @@
+import {
+  getPosesByCategory,
+  getPosesByDifficulty,
+  getPoseById,
+  customPoseToPoseDefinition,
+  mergeCustomPoses,
+  getCustomPosesOnly,
+} from './pose.utils';
+import { POSE_DEFINITIONS } from '../constants/pose-definitions.constant';
+
+describe('pose.utils', () => {
+  it('getPosesByCategory filters by category', () => {
+    const facePoses = getPosesByCategory('face');
+    expect(facePoses.length).toBeGreaterThan(0);
+    expect(facePoses.every(p => p.category === 'face')).toBe(true);
+  });
+
+  it('getPosesByDifficulty filters by difficulty', () => {
+    const easyPoses = getPosesByDifficulty('easy');
+    expect(easyPoses.length).toBeGreaterThan(0);
+    expect(easyPoses.every(p => p.difficulty === 'easy')).toBe(true);
+  });
+
+  it('getPoseById returns correct pose', () => {
+    const pose = getPoseById(1);
+    expect(pose).toBeDefined();
+    expect(pose!.id).toBe(1);
+  });
+
+  it('getPoseById returns undefined for non-existent id', () => {
+    expect(getPoseById(99999)).toBeUndefined();
+  });
+
+  it('customPoseToPoseDefinition converts correctly', () => {
+    const customPose = {
+      id: 5,
+      name: 'Custom Smile',
+      description: 'A custom smile pose',
+      category: 'face',
+      difficulty: 'easy',
+      detectionStrategy: 'face-api',
+      imageBlobUrl: 'https://example.com/img.png',
+      poseKeypoints: [{ x: 0, y: 0 }],
+    };
+
+    const result = customPoseToPoseDefinition(customPose as any);
+    expect(result.id).toBe(10005);
+    expect(result.name).toBe('Custom Smile');
+    expect(result.isCustom).toBe(true);
+    expect(result.imageBlobUrl).toBe('https://example.com/img.png');
+    expect(result.poseKeypoints).toEqual([{ x: 0, y: 0 }]);
+  });
+
+  it('mergeCustomPoses combines static and custom poses', () => {
+    const customPoses = [
+      { id: 1, name: 'Custom1', description: 'd', category: 'face', difficulty: 'easy' },
+    ];
+    const merged = mergeCustomPoses(customPoses as any);
+    expect(merged.length).toBe(POSE_DEFINITIONS.length + 1);
+    expect(merged[merged.length - 1].isCustom).toBe(true);
+  });
+
+  it('getCustomPosesOnly filters custom poses', () => {
+    const poses = [
+      ...POSE_DEFINITIONS,
+      { ...POSE_DEFINITIONS[0], id: 10001, isCustom: true },
+    ];
+    const custom = getCustomPosesOnly(poses);
+    expect(custom.length).toBe(1);
+    expect(custom[0].isCustom).toBe(true);
+  });
+
+  it('getCustomPosesOnly returns empty for no custom poses', () => {
+    expect(getCustomPosesOnly(POSE_DEFINITIONS).length).toBe(0);
+  });
+});