facecog-liveness-showcase 0.0.1

package/projects/facecog-liveness-verification/src/lib/services/video-recorder.service.ts

@@ -0,0 +1,117 @@
+import { Injectable } from '@angular/core';
+import { VideoRecording } from '../interfaces/video-recording.interface';
+
+@Injectable({
+  providedIn: 'root'
+})
+export class VideoRecorderService {
+  private mediaRecorder: MediaRecorder | null = null;
+  private recordedChunks: Blob[] = [];
+  private startTime: number = 0;
+
+  constructor() {}
+
+  /**
+   * Start recording video from the provided stream
+   */
+  startRecording(stream: MediaStream): Promise<void> {
+    return new Promise((resolve, reject) => {
+      try {
+        this.recordedChunks = [];
+
+        const mimeType = this.getSupportedMimeType();
+
+        this.mediaRecorder = new MediaRecorder(stream, {
+          mimeType,
+          videoBitsPerSecond: 2500000
+        });
+
+        this.mediaRecorder.ondataavailable = (event) => {
+          if (event.data && event.data.size > 0) {
+            this.recordedChunks.push(event.data);
+          }
+        };
+
+        this.mediaRecorder.onerror = (event: Event) => {
+          console.error('MediaRecorder error:', event);
+          reject(new Error('Recording failed'));
+        };
+
+        this.mediaRecorder.start(100);
+        this.startTime = Date.now();
+        resolve();
+      } catch (error) {
+        reject(error);
+      }
+    });
+  }
+
+  /**
+   * Stop recording and return the video blob
+   */
+  stopRecording(): Promise<VideoRecording> {
+    return new Promise((resolve, reject) => {
+      if (!this.mediaRecorder) {
+        reject(new Error('No active recording'));
+        return;
+      }
+
+      this.mediaRecorder.onstop = () => {
+        const duration = (Date.now() - this.startTime) / 1000;
+        const blob = new Blob(this.recordedChunks, {
+          type: this.getSupportedMimeType()
+        });
+        const sizeMB = blob.size / (1024 * 1024);
+
+        resolve({
+          blob,
+          sizeMB,
+          duration
+        });
+
+        this.recordedChunks = [];
+        this.mediaRecorder = null;
+      };
+
+      this.mediaRecorder.stop();
+    });
+  }
+
+  /**
+   * Get supported MIME type for video recording
+   */
+  private getSupportedMimeType(): string {
+    const types = [
+      'video/webm;codecs=vp9',
+      'video/webm;codecs=vp8',
+      'video/webm',
+      'video/mp4'
+    ];
+
+    for (const type of types) {
+      if (MediaRecorder.isTypeSupported(type)) {
+        return type;
+      }
+    }
+
+    return 'video/webm';
+  }
+
+  /**
+   * Check if recording is in progress
+   */
+  isRecording(): boolean {
+    return this.mediaRecorder !== null && this.mediaRecorder.state === 'recording';
+  }
+
+  /**
+   * Cleanup resources
+   */
+  cleanup(): void {
+    if (this.mediaRecorder && this.mediaRecorder.state === 'recording') {
+      this.mediaRecorder.stop();
+    }
+    this.mediaRecorder = null;
+    this.recordedChunks = [];
+  }
+}

package/projects/facecog-liveness-verification/src/lib/types/detection-strategy.type.ts

@@ -0,0 +1,5 @@
+/**
+ * Detection strategy types for pose verification
+ */
+export type DetectionStrategy = 'face-api' | 'openpose' | 'combined';
+

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

@@ -0,0 +1,7 @@
+export { LivenessBackend } from './liveness-backend.type';
+export { VerificationFlowStep } from './verification-flow-step.type';
+export { LivenessAction } from './liveness-action.type';
+export { PoseCategory } from './pose-category.type';
+export { PoseDifficulty } from './pose-difficulty.type';
+export { DetectionStrategy } from './detection-strategy.type';
+export { VerificationStepKind } from './verification-step-kind.type';

package/projects/facecog-liveness-verification/src/lib/types/liveness-action.type.ts

@@ -0,0 +1,31 @@
+/**
+ * Liveness action types for verification challenges
+ */
+export type LivenessAction =
+  | 'face-center'
+  | 'turn-left'
+  | 'turn-right'
+  | 'tilt-left'
+  | 'tilt-right'
+  | 'look-up'
+  | 'look-down'
+  | 'blink'
+  | 'blink-twice'
+  | 'wink'
+  | 'follow-dot'
+  | 'nod'
+  | 'shake-head'
+  | 'smile'
+  | 'open-mouth'
+  | 'speak-phrase'
+  | 'raise-eyebrows'
+  | 'rotate-face'
+  | 'smile-thumbs-up'
+  | 'hand-gesture'
+  | 'wave'
+  | 'clap'
+  | 'cross-arms'
+  | 'point'
+  | 'combined-pose'
+  | 'custom-pose';
+

package/projects/facecog-liveness-verification/src/lib/types/liveness-backend.type.ts

@@ -0,0 +1,5 @@
+/**
+ * Supported liveness verification backends
+ */
+export type LivenessBackend = 'amazon' | 'openpose' | 'facetec' | 'azure' | 'mock';
+

package/projects/facecog-liveness-verification/src/lib/types/pose-category.type.ts

@@ -0,0 +1,5 @@
+/**
+ * Pose category types
+ */
+export type PoseCategory = 'face' | 'head' | 'hand' | 'gesture' | 'combined';
+

package/projects/facecog-liveness-verification/src/lib/types/pose-difficulty.type.ts

@@ -0,0 +1,5 @@
+/**
+ * Pose difficulty levels
+ */
+export type PoseDifficulty = 'easy' | 'medium' | 'hard';
+

package/projects/facecog-liveness-verification/src/lib/types/verification-flow-step.type.ts

@@ -0,0 +1,5 @@
+/**
+ * Flow step types for verification process
+ */
+export type VerificationFlowStep = 'intro' | 'permission' | 'preview' | 'facetec' | 'processing' | 'result';
+

package/projects/facecog-liveness-verification/src/lib/types/verification-step-kind.type.ts

@@ -0,0 +1,4 @@
+/**
+ * Type of verification step in the sequential flow
+ */
+export type VerificationStepKind = 'gesture' | 'facetec';

package/projects/facecog-liveness-verification/src/public-api.ts

@@ -0,0 +1,150 @@
+/**
+ * @naniteninja/liveness-verification
+ * 
+ * Angular library for liveness verification with pose detection and multi-backend support.
+ * 
+ * @example Basic Usage
+ * ```typescript
+ * // In your module
+ * import { LivenessVerificationModule } from '@naniteninja/liveness-verification';
+ * 
+ * @NgModule({
+ *   imports: [
+ *     LivenessVerificationModule.forRoot({
+ *       apiUrl: 'https://api.example.com',
+ *       backends: ['amazon', 'facetec']
+ *     })
+ *   ]
+ * })
+ * export class AppModule {}
+ * 
+ * // In your template
+ * <facecog-liveness-verification
+ *   [pose]="5"
+ *   (verificationComplete)="onVerificationComplete($event)">
+ * </facecog-liveness-verification>
+ * ```
+ * 
+ * @example Standalone Usage
+ * ```typescript
+ * import { 
+ *   LivenessVerificationComponent,
+ *   provideLivenessVerification 
+ * } from '@naniteninja/liveness-verification';
+ * 
+ * bootstrapApplication(AppComponent, {
+ *   providers: [
+ *     provideLivenessVerification({ backends: ['mock'] })
+ *   ]
+ * });
+ * ```
+ */
+
+// Module
+export { LivenessVerificationModule, provideLivenessVerification, provideLivenessFlow } from './lib/liveness-verification.module';
+
+// Components
+export { LivenessVerificationComponent } from './lib/components/liveness-verification/liveness-verification.component';
+export { PoseSelectionComponent } from './lib/components/pose-selection/pose-selection.component';
+export { CameraVerificationComponent, CapturedVerificationData } from './lib/components/camera-verification/camera-verification.component';
+export { VerificationResultComponent } from './lib/components/verification-result/verification-result.component';
+export { CameraPermissionComponent } from './lib/components/camera-permission/camera-permission.component';
+export { ProcessingComponent } from './lib/components/processing/processing.component';
+export { SaveCustomPoseDialogComponent } from './lib/components/dialogs/save-custom-pose-dialog.component';
+export { IntroComponent } from './lib/components/intro/intro.component';
+export { LivePreviewComponent } from './lib/components/live-preview/live-preview.component';
+export { FaceTecScanComponent } from './lib/components/facetec-scan/facetec-scan.component';
+export { LivenessFlowComponent } from './lib/components/liveness-flow/liveness-flow.component';
+export { AwsFaceLivenessComponent } from './lib/components/aws-face-liveness/aws-face-liveness.component';
+
+// Types
+export { LivenessBackend } from './lib/types/liveness-backend.type';
+export { VerificationFlowStep } from './lib/types/verification-flow-step.type';
+export { LivenessAction } from './lib/types/liveness-action.type';
+export { PoseCategory } from './lib/types/pose-category.type';
+export { PoseDifficulty } from './lib/types/pose-difficulty.type';
+export { DetectionStrategy } from './lib/types/detection-strategy.type';
+export { VerificationStepKind } from './lib/types/verification-step-kind.type';
+
+// Interfaces
+export { LivenessVerificationConfig } from './lib/interfaces/liveness-verification-config.interface';
+export { VerificationStepChangeEvent } from './lib/interfaces/verification-step-change-event.interface';
+export { VerificationProgressEvent } from './lib/interfaces/verification-progress-event.interface';
+export { LivenessConfig } from './lib/interfaces/liveness-config.interface';
+export { LivenessMetadata } from './lib/interfaces/liveness-metadata.interface';
+export { AnalyzeResponse } from './lib/interfaces/analyze-response.interface';
+export { MultiBackendAnalyzeResponse } from './lib/interfaces/multi-backend-analyze-response.interface';
+export { LivenessResult } from './lib/interfaces/liveness-result.interface';
+export { PoseMatchResult } from './lib/interfaces/pose-match-result.interface';
+export { LivenessActionResult } from './lib/interfaces/liveness-action-result.interface';
+export { VideoRecording } from './lib/interfaces/video-recording.interface';
+export { BackendResponse } from './lib/interfaces/backend-response.interface';
+export { MultiBackendLivenessResult } from './lib/interfaces/multi-backend-liveness-result.interface';
+export { PoseKeypoint } from './lib/interfaces/pose-keypoint.interface';
+export { PoseDefinition } from './lib/interfaces/pose-definition.interface';
+export { CategoryInfo } from './lib/interfaces/category-info.interface';
+export { CustomPoseData } from './lib/interfaces/custom-pose-data.interface';
+export { CustomPoseResponse } from './lib/interfaces/custom-pose-response.interface';
+export { PoseVerifyResponse } from './lib/interfaces/pose-verify-response.interface';
+export { VerificationStep, VerificationPlan, GestureResult, FaceTecResult } from './lib/interfaces/verification-plan.interface';
+export {
+  VerificationSessionStartRequest,
+  VerificationSessionStartResponse,
+  VerifyGesturesRequest,
+  VerifyGesturesResponse,
+  VerifyFaceTecRequest,
+  VerifyFaceTecResponse,
+  VerifyFinalizeResponse
+} from './lib/interfaces/verification-session.interface';
+export { AwsFaceLivenessSessionResponse, AwsFaceLivenessResultsResponse, AwsCredentialsResponse } from './lib/interfaces/aws-face-liveness.interface';
+export { FaceTecScanResult, AwsFaceLivenessScanResult } from './lib/interfaces/scan-results.interface';
+
+// Constants
+export { DEFAULT_LIVENESS_CONFIG } from './lib/models/constants/default-liveness-config.constant';
+export { LIVENESS_VERIFICATION_CONFIG } from './lib/models/constants/liveness-verification-config.token';
+export { AWS_FACE_LIVENESS_COMPONENT } from './lib/models/constants/aws-face-liveness-component.token';
+export { POSE_DEFINITIONS } from './lib/models/constants/pose-definitions.constant';
+export { CATEGORY_INFO } from './lib/models/constants/category-info.constant';
+
+// Utils
+export {
+  getPosesByCategory,
+  getPosesByDifficulty,
+  getPoseById,
+  customPoseToPoseDefinition,
+  mergeCustomPoses,
+  getCustomPosesOnly
+} from './lib/models/utils/pose.utils';
+
+// Services
+export { LivenessConfigService } from './lib/services/liveness-config.service';
+export { PoseSelectionService, SelectedPoseInfo } from './lib/services/pose-selection.service';
+export { CameraService } from './lib/services/camera.service';
+export { VideoRecorderService } from './lib/services/video-recorder.service';
+export { BackendHttpService } from './lib/services/backend-http.service';
+export { CustomPosesApiService } from './lib/services/custom-poses-api.service';
+export { VerificationPlanService } from './lib/services/verification-plan.service';
+export { VerificationApiService } from './lib/services/verification-api.service';
+export { AwsFaceLivenessService } from './lib/services/aws-face-liveness.service';
+export { LivenessBackendService } from './lib/services/liveness-backend.service';
+
+// Provider/Backend Abstractions (Interfaces & Injection Tokens)
+export { ICameraProvider, CAMERA_PROVIDER, BrightnessData } from './lib/interfaces/camera-provider.interface';
+export { ICustomPoseRepository, CUSTOM_POSE_REPOSITORY } from './lib/interfaces/custom-pose-repository.interface';
+export { IBackendAdapter } from './lib/interfaces/backend-adapter.interface';
+export { IBackendHttpClient, BACKEND_HTTP_CLIENT, SessionResponse } from './lib/interfaces/backend-http-client.interface';
+
+// Backend Services
+export { MockBackendService } from './lib/services/backends/mock-backend.service';
+export { RekognitionAnalysisBackendService, AmazonBackendService } from './lib/services/backends/rekognition-analysis-backend.service';
+export { OpenPoseBackendService } from './lib/services/backends/openpose-backend.service';
+export { FaceTecBackendService } from './lib/services/backends/facetec-backend.service';
+export { AzureBackendService } from './lib/services/backends/azure-backend.service';
+export { LivenessOrchestratorService } from './lib/services/liveness-orchestrator.service';
+
+// Pose Detection Services
+export { OpenposeService, PoseKeypoints } from './lib/services/pose-detection/openpose.service';
+export { HandGestureDetectionService, HandGestureResult } from './lib/services/pose-detection/hand-gesture-detection.service';
+export { ReferencePoseService, ReferencePose } from './lib/services/pose-detection/reference-pose.service';
+export { PoseComparisonService, PoseComparisonResult } from './lib/services/pose-detection/pose-comparison.service';
+export { PoseMatchingService } from './lib/services/pose-detection/pose-matching.service';

package/projects/facecog-liveness-verification/tsconfig.lib.json

@@ -0,0 +1,20 @@
+/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */
+/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../out-tsc/lib",
+    "declaration": true,
+    "declarationMap": true,
+    "inlineSources": true,
+    "types": [],
+    "allowJs": true
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.js"
+  ],
+  "exclude": [
+    "**/*.spec.ts"
+  ]
+}

package/projects/facecog-liveness-verification/tsconfig.lib.prod.json

@@ -0,0 +1,11 @@
+/* To learn more about Typescript configuration file: https://www.typescriptlang.org/docs/handbook/tsconfig-json.html. */
+/* To learn more about Angular compiler options: https://angular.dev/reference/configs/angular-compiler-options. */
+{
+  "extends": "./tsconfig.lib.json",
+  "compilerOptions": {
+    "declarationMap": false
+  },
+  "angularCompilerOptions": {
+    "compilationMode": "partial"
+  }
+}

package/projects/facecog-liveness-verification/tsconfig.spec.json

@@ -0,0 +1,13 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../out-tsc/spec",
+    "types": ["jest"],
+    "esModuleInterop": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": [
+    "src/**/*.ts",
+    "src/**/*.spec.ts"
+  ]
+}

package/projects/facecog-liveness-verification/tsconfig.wrapper.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "src/lib/components/aws-face-liveness",
+    "rootDir": "sources",
+    "declaration": false,
+    "declarationMap": false,
+    "module": "esnext",
+    "moduleResolution": "node",
+    "jsx": "react-jsx",
+    "noEmit": false
+  },
+  "include": ["sources/FaceLivenessReactWrapper.tsx"],
+  "exclude": []
+}

package/projects/facecog-liveness-verification-test/src/app/app-routing.module.ts

@@ -0,0 +1,22 @@
+import { NgModule } from '@angular/core';
+import { PreloadAllModules, RouterModule, Routes } from '@angular/router';
+
+const routes: Routes = [
+  {
+    path: 'home',
+    loadComponent: () => import('./home/home.page').then(m => m.HomePage)
+  },
+  {
+    path: '',
+    redirectTo: 'home',
+    pathMatch: 'full'
+  },
+];
+
+@NgModule({
+  imports: [
+    RouterModule.forRoot(routes, { preloadingStrategy: PreloadAllModules })
+  ],
+  exports: [RouterModule]
+})
+export class AppRoutingModule { }

package/projects/facecog-liveness-verification-test/src/app/app.component.html

@@ -0,0 +1,3 @@
+<ion-app>
+  <ion-router-outlet></ion-router-outlet>
+</ion-app>

package/projects/facecog-liveness-verification-test/src/app/app.component.ts

@@ -0,0 +1,11 @@
+import { Component } from '@angular/core';
+
+@Component({
+  selector: 'app-root',
+  templateUrl: 'app.component.html',
+  styleUrls: ['app.component.scss'],
+  standalone: false,
+})
+export class AppComponent {
+  constructor() {}
+}

package/projects/facecog-liveness-verification-test/src/app/app.module.ts

@@ -0,0 +1,27 @@
+import { NgModule } from '@angular/core';
+import { BrowserModule } from '@angular/platform-browser';
+import { RouteReuseStrategy } from '@angular/router';
+import { HttpClientModule } from '@angular/common/http';
+
+import { IonicModule, IonicRouteStrategy } from '@ionic/angular';
+import { provideLivenessFlow } from '@naniteninja/liveness-verification';
+
+import { AppComponent } from './app.component';
+import { AppRoutingModule } from './app-routing.module';
+import { environment } from '../environments/environment';
+
+@NgModule({
+  declarations: [AppComponent],
+  imports: [
+    BrowserModule,
+    HttpClientModule,
+    IonicModule.forRoot(),
+    AppRoutingModule
+  ],
+  providers: [
+    { provide: RouteReuseStrategy, useClass: IonicRouteStrategy },
+    ...provideLivenessFlow({ apiUrl: environment.apiUrl })
+  ],
+  bootstrap: [AppComponent],
+})
+export class AppModule {}

package/projects/facecog-liveness-verification-test/src/app/home/home-routing.module.ts

@@ -0,0 +1,16 @@
+import { NgModule } from '@angular/core';
+import { RouterModule, Routes } from '@angular/router';
+import { HomePage } from './home.page';
+
+const routes: Routes = [
+  {
+    path: '',
+    component: HomePage,
+  }
+];
+
+@NgModule({
+  imports: [RouterModule.forChild(routes)],
+  exports: [RouterModule]
+})
+export class HomePageRoutingModule {}

package/projects/facecog-liveness-verification-test/src/app/home/home.module.ts

@@ -0,0 +1,19 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { IonicModule } from '@ionic/angular';
+import { FormsModule } from '@angular/forms';
+import { HomePage } from './home.page';
+
+import { HomePageRoutingModule } from './home-routing.module';
+
+
+@NgModule({
+  imports: [
+    CommonModule,
+    FormsModule,
+    IonicModule,
+    HomePageRoutingModule,
+    HomePage
+  ]
+})
+export class HomePageModule {}

package/projects/facecog-liveness-verification-test/src/app/home/home.page.html

@@ -0,0 +1,39 @@
+<ion-header>
+  <ion-toolbar color="primary">
+    <ion-title>Liveness Verification Showcase</ion-title>
+  </ion-toolbar>
+</ion-header>
+
+<ion-content class="ion-padding">
+  <div class="showcase-container">
+    <div class="showcase-header">
+      <ion-icon name="shield-checkmark" color="primary" class="hero-icon"></ion-icon>
+      <h1>Verification Showcase</h1>
+      <p>Test the liveness verification flow as it would appear inside a host application modal.</p>
+    </div>
+
+    <div class="showcase-actions">
+      <ion-button expand="block" (click)="openVerificationModal()">
+        <ion-icon slot="start" name="person-circle"></ion-icon>
+        Start Verification (Modal)
+      </ion-button>
+
+      <ion-button expand="block" fill="outline" (click)="openPoseSpecificModal()">
+        <ion-icon slot="start" name="camera"></ion-icon>
+        Pose-Specific Verification (Modal)
+      </ion-button>
+    </div>
+
+    <div class="last-result" *ngIf="lastResult">
+      <h3>Last Result</h3>
+      <ion-card [color]="lastResult.success ? 'success' : 'danger'">
+        <ion-card-content>
+          <p><strong>{{ lastResult.success ? 'Verification Successful' : 'Verification Failed' }}</strong></p>
+          <p *ngIf="lastResult.confidence">Confidence: {{ (lastResult.confidence * 100).toFixed(1) }}%</p>
+          <p *ngIf="lastResult.error">Error: {{ lastResult.error }}</p>
+          <p *ngIf="lastResult.metadata?.backend">Backend: {{ lastResult.metadata.backend }}</p>
+        </ion-card-content>
+      </ion-card>
+    </div>
+  </div>
+</ion-content>

package/projects/facecog-liveness-verification-test/src/app/home/home.page.scss

@@ -0,0 +1,97 @@
+.showcase-container {
+  max-width: 480px;
+  margin: 0 auto;
+  padding: 24px 0;
+}
+
+.showcase-header {
+  text-align: center;
+  margin-bottom: 40px;
+
+  .hero-icon {
+    font-size: 80px;
+    margin-bottom: 16px;
+  }
+
+  h1 {
+    font-size: 24px;
+    font-weight: 700;
+    margin: 0 0 8px;
+  }
+
+  p {
+    font-size: 15px;
+    color: var(--ion-color-medium);
+    line-height: 1.5;
+    margin: 0;
+  }
+}
+
+.showcase-actions {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  margin-bottom: 32px;
+}
+
+.last-result {
+  h3 {
+    font-size: 16px;
+    font-weight: 600;
+    margin: 0 0 12px;
+    color: var(--ion-text-color);
+  }
+
+  ion-card {
+    margin: 0;
+  }
+
+  p {
+    margin: 4px 0;
+    font-size: 14px;
+  }
+}
+
+.verification-modal-wrapper {
+  display: flex;
+  flex-direction: column;
+  height: 100%;
+  width: 100%;
+  background: var(--ion-background-color, #fff);
+}
+
+.verification-modal-header {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 12px 16px;
+  background: var(--ion-color-primary);
+  color: #fff;
+  flex-shrink: 0;
+
+  h2 {
+    margin: 0;
+    font-size: 18px;
+    font-weight: 600;
+  }
+
+  button {
+    background: none;
+    border: none;
+    color: #fff;
+    font-size: 24px;
+    cursor: pointer;
+    padding: 4px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+  }
+}
+
+.verification-modal-body {
+  flex: 1;
+  min-height: 0;
+  overflow: hidden;
+  display: flex;
+  flex-direction: column;
+}