facecog-liveness-showcase 0.0.1

package/projects/facecog-liveness-verification/README.md

@@ -0,0 +1,295 @@
+# @naniteninja/liveness-verification
+
+Angular library for liveness verification with pose detection and multi-backend support.
+
+## Features
+
+- **40+ Predefined Poses**: Face expressions, head movements, hand gestures, and combined poses
+- **Multi-Backend Support**: Amazon Rekognition, FaceTec, OpenPose, Azure, and Mock backends
+- **Configurable**: Extensive configuration options for customization
+- **Standalone Components**: Works with Angular 14+ standalone components
+- **Observable API**: RxJS-based API for reactive programming
+- **Ionic Integration**: Built-in Ionic components for mobile-first UI
+
+## Installation
+
+```bash
+npm install @naniteninja/liveness-verification
+```
+
+## Peer Dependencies
+
+```bash
+npm install @angular/common @angular/core @angular/forms @ionic/angular rxjs
+```
+
+## Quick Start
+
+### Module-based Usage
+
+```typescript
+import { LivenessVerificationModule } from '@naniteninja/liveness-verification';
+
+@NgModule({
+  imports: [
+    LivenessVerificationModule.forRoot({
+      apiUrl: 'https://api.example.com',
+      backends: ['amazon', 'facetec'],
+      maxRetries: 3
+    })
+  ]
+})
+export class AppModule {}
+```
+
+### Standalone Usage
+
+```typescript
+import { provideLivenessVerification } from '@naniteninja/liveness-verification';
+
+bootstrapApplication(AppComponent, {
+  providers: [
+    provideLivenessVerification({
+      apiUrl: 'https://api.example.com',
+      backends: ['mock']
+    })
+  ]
+});
+```
+
+### Template Usage
+
+```html
+<facecog-liveness-verification
+  [pose]="5"
+  (verificationComplete)="onComplete($event)"
+  (verificationError)="onError($event)">
+</facecog-liveness-verification>
+```
+
+## Library Structure
+
+```
+src/lib/
+├── models/
+│   ├── types/                              # Type definitions (one per file)
+│   │   ├── liveness-backend.type.ts
+│   │   ├── verification-flow-step.type.ts
+│   │   ├── liveness-action.type.ts
+│   │   ├── pose-category.type.ts
+│   │   ├── pose-difficulty.type.ts
+│   │   ├── detection-strategy.type.ts
+│   │   └── index.ts
+│   │
+│   ├── interfaces/                         # Interface definitions (one per file)
+│   │   ├── liveness-verification-config.interface.ts
+│   │   ├── verification-step-change-event.interface.ts
+│   │   ├── verification-progress-event.interface.ts
+│   │   ├── liveness-result.interface.ts
+│   │   ├── pose-definition.interface.ts
+│   │   ├── ... (14 more interfaces)
+│   │   └── index.ts
+│   │
+│   ├── constants/                          # Constant values
+│   │   ├── default-liveness-config.constant.ts
+│   │   ├── liveness-verification-config.token.ts
+│   │   ├── pose-definitions.constant.ts
+│   │   ├── category-info.constant.ts
+│   │   └── index.ts
+│   │
+│   ├── utils/                              # Utility functions
+│   │   ├── pose.utils.ts
+│   │   └── index.ts
+│   │
+│   └── index.ts                            # Barrel export
+│
+├── services/
+│   ├── backends/
+│   │   ├── backend-adapter.interface.ts
+│   │   └── mock-backend.service.ts
+│   ├── camera.service.ts
+│   ├── liveness-config.service.ts
+│   ├── pose-selection.service.ts
+│   ├── video-recorder.service.ts
+│   └── index.ts
+│
+├── liveness-verification.component.ts
+├── liveness-verification.module.ts
+└── public-api.ts
+```
+
+## Types
+
+```typescript
+import { 
+  LivenessBackend,        // 'amazon' | 'openpose' | 'facetec' | 'azure' | 'mock'
+  VerificationFlowStep,   // 'intro' | 'permission' | 'preview' | 'facetec' | 'processing' | 'result'
+  LivenessAction,         // 'blink' | 'smile' | 'turn-left' | ... (26 actions)
+  PoseCategory,           // 'face' | 'head' | 'hand' | 'gesture' | 'combined'
+  PoseDifficulty,         // 'easy' | 'medium' | 'hard'
+  DetectionStrategy       // 'face-api' | 'openpose' | 'combined'
+} from '@naniteninja/liveness-verification';
+```
+
+## Interfaces
+
+```typescript
+import {
+  LivenessVerificationConfig,   // Main configuration interface
+  LivenessResult,               // Verification result
+  PoseDefinition,               // Pose definition
+  VerificationStepChangeEvent,  // Step change event
+  VerificationProgressEvent,    // Progress event
+  BackendResponse,              // Backend response
+  // ... and more
+} from '@naniteninja/liveness-verification';
+```
+
+## Constants
+
+```typescript
+import {
+  DEFAULT_LIVENESS_CONFIG,       // Default configuration object
+  LIVENESS_VERIFICATION_CONFIG,  // Injection token
+  POSE_DEFINITIONS,              // Array of 40 poses
+  CATEGORY_INFO                  // Category display info
+} from '@naniteninja/liveness-verification';
+```
+
+## Utility Functions
+
+```typescript
+import {
+  getPoseById,          // Get pose by ID (1-40)
+  getPosesByCategory,   // Filter poses by category
+  getPosesByDifficulty  // Filter poses by difficulty
+} from '@naniteninja/liveness-verification';
+```
+
+## Services
+
+### PoseSelectionService
+
+```typescript
+import { PoseSelectionService } from '@naniteninja/liveness-verification';
+
+@Component({ ... })
+export class MyComponent {
+  constructor(private poseSelection: PoseSelectionService) {}
+
+  selectPose(id: number) {
+    this.poseSelection.selectPose(id);
+  }
+
+  getRandomPose() {
+    return this.poseSelection.getRandomPose();
+  }
+}
+```
+
+### LivenessConfigService
+
+```typescript
+import { LivenessConfigService } from '@naniteninja/liveness-verification';
+
+@Component({ ... })
+export class MyComponent {
+  constructor(private configService: LivenessConfigService) {}
+
+  updateConfig() {
+    this.configService.updateConfig({
+      maxRetries: 5,
+      similarityThreshold: 0.7
+    });
+  }
+}
+```
+
+## Configuration Options
+
+| Property | Type | Default | Description |
+|----------|------|---------|-------------|
+| `apiUrl` | `string` | `'http://localhost:3002'` | Backend API URL |
+| `backends` | `LivenessBackend[]` | `['mock']` | Backends to use |
+| `poseId` | `number` | `undefined` | Predefined pose ID (1-40) |
+| `maxRetries` | `number` | `3` | Maximum retry attempts |
+| `autoCapture` | `boolean` | `true` | Auto-capture when pose matches |
+| `enableVideoRecording` | `boolean` | `true` | Record video |
+| `similarityThreshold` | `number` | `0.62` | Pose matching threshold |
+
+## Available Poses
+
+### Face Expressions (1-6)
+Face Straight, Blink Once, Blink Twice, Open Mouth, Smile, Raise Eyebrows
+
+### Head Movements (7-14)
+Turn Left, Turn Right, Look Up, Look Down, Tilt Left, Tilt Right, Nod, Shake Head
+
+### Eye & Face Tracking (15-20)
+Follow Dot, Wink, Move Closer, Speak Phrase, Rotate Face, Center Face
+
+### Hand Gestures (21-29)
+Right Palm, Left Palm, Wave Right, Thumbs Up (R/L), OK Sign, Peace Sign, Three Fingers, Five Fingers
+
+### Combined Poses (30-40)
+Touch Nose, Touch Chin, Touch Cheek (R/L), Cover Eye, Cover Mouth, Frame Face, Cross Arms, Clap, Point
+
+## Events
+
+```typescript
+interface LivenessResult {
+  success: boolean;
+  confidence: number;
+  verifiedImage: string;
+  videoBlob?: Blob;
+  metadata: LivenessMetadata;
+  error?: string;
+}
+
+interface VerificationStepChangeEvent {
+  step: VerificationFlowStep;
+  previousStep?: VerificationFlowStep;
+  timestamp: Date;
+}
+
+interface VerificationProgressEvent {
+  step: VerificationFlowStep;
+  progress: number; // 0-100
+  message: string;
+}
+```
+
+## Push Notification Integration
+
+```typescript
+import { PoseSelectionService, LivenessConfigService } from '@naniteninja/liveness-verification';
+
+@Component({ ... })
+export class AppComponent {
+  showVerification = false;
+
+  constructor(
+    private poseSelection: PoseSelectionService,
+    private configService: LivenessConfigService
+  ) {
+    this.pushService.onNotification.subscribe(notification => {
+      if (notification.type === 'verification_required') {
+        this.poseSelection.selectPose(notification.poseId);
+        this.configService.updateConfig({ showIntroScreen: false });
+        this.showVerification = true;
+      }
+    });
+  }
+
+  onComplete(result: LivenessResult) {
+    this.showVerification = false;
+    if (result.success) {
+      this.sendToBackend(result);
+    }
+  }
+}
+```
+
+## License
+
+MIT

package/projects/facecog-liveness-verification/ng-package.json

@@ -0,0 +1,7 @@
+{
+  "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
+  "dest": "../../dist/naniteninjas-liveness-verification",
+  "lib": {
+    "entryFile": "src/public-api.ts"
+  }
+}

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

@@ -0,0 +1,48 @@
+{
+  "name": "@naniteninja/liveness-verification",
+  "version": "1.10.0",
+  "description": "Angular library for liveness verification with pose detection and multi-backend support",
+  "author": "NaniteNinjas",
+  "repository": {
+    "type": "git"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  },
+  "keywords": [
+    "angular",
+    "ionic",
+    "liveness",
+    "verification",
+    "pose-detection",
+    "face-recognition",
+    "mediapipe",
+    "tensorflow"
+  ],
+  "license": "MIT",
+  "peerDependencies": {
+    "@angular/common": "^20.0.0",
+    "@angular/core": "^20.0.0",
+    "@angular/forms": "^20.0.0",
+    "@ionic/angular": "^8.0.0",
+    "rxjs": "^7.8.0",
+    "@tensorflow/tfjs-core": "^4.0.0",
+    "@tensorflow/tfjs-backend-webgl": "^4.0.0",
+    "@tensorflow-models/pose-detection": "^2.0.0",
+    "@mediapipe/tasks-vision": "^0.10.0",
+    "@aws-amplify/ui-react-liveness": "^3.0.0",
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "ngPackage": {
+    "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
+    "dest": "../../dist/naniteninjas-liveness-verification",
+    "lib": {
+      "entryFile": "src/public-api.ts"
+    }
+  },
+  "sideEffects": false
+}

package/projects/facecog-liveness-verification/scripts/build-with-wrapper-copy.js

@@ -0,0 +1,38 @@
+/**
+ * Build the lib: compile wrapper, then run ng-packagr with a background
+ * poll that copies FaceLivenessReactWrapper.generated.js into tmp as soon
+ * as tmp exists (after ngc), so rollup can load it from disk (file-loader
+ * fallback in ng-packagr patch).
+ */
+const { spawn } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+
+const projectRoot = path.resolve(__dirname, '..');
+const workspaceRoot = path.resolve(projectRoot, '../..');
+const distRoot = path.join(workspaceRoot, 'dist/naniteninjas-liveness-verification');
+const tmpTargetDir = path.join(distRoot, 'tmp-esm2022', 'lib', 'components', 'aws-face-liveness');
+const sourceFile = path.join(projectRoot, 'src/lib/components/aws-face-liveness/FaceLivenessReactWrapper.generated.js');
+const relPath = path.relative(workspaceRoot, path.join(projectRoot, 'ng-package.json'));
+
+function copyWrapper() {
+  if (!fs.existsSync(sourceFile)) return false;
+  if (!fs.existsSync(path.join(distRoot, 'tmp-esm2022'))) return false;
+  if (!fs.existsSync(tmpTargetDir)) {
+    fs.mkdirSync(tmpTargetDir, { recursive: true });
+  }
+  const dest = path.join(tmpTargetDir, 'FaceLivenessReactWrapper.generated.js');
+  fs.copyFileSync(sourceFile, dest);
+  return true;
+}
+
+const interval = setInterval(() => copyWrapper(), 20);
+const child = spawn('npx', ['ng-packagr', '-p', relPath], {
+  cwd: workspaceRoot,
+  stdio: 'inherit',
+  shell: true,
+});
+child.on('close', (code) => {
+  clearInterval(interval);
+  process.exit(code);
+});

package/projects/facecog-liveness-verification/scripts/copy-wrapper-after-ngc.js

@@ -0,0 +1,35 @@
+/**
+ * Copies FaceLivenessReactWrapper.generated.js into ng-packagr's tmp folder
+ * as soon as tmp-esm2022 exists, so rollup can resolve the dynamic import.
+ * Run this script in the background while ng-packagr runs.
+ */
+const fs = require('fs');
+const path = require('path');
+
+const projectRoot = path.resolve(__dirname, '..');
+const distRoot = path.resolve(projectRoot, '../../dist/naniteninjas-liveness-verification');
+const tmpRoot = path.join(distRoot, 'tmp-esm2022');
+const tmpTargetDir = path.join(tmpRoot, 'lib', 'components', 'aws-face-liveness');
+const sourceFile = path.join(projectRoot, 'src/lib/components/aws-face-liveness/FaceLivenessReactWrapper.generated.js');
+
+function copyOnce() {
+  if (!fs.existsSync(sourceFile)) return false;
+  // As soon as tmp-esm2022 exists, create subdir and copy so file is there before rollup
+  if (!fs.existsSync(tmpRoot)) return false;
+  if (!fs.existsSync(tmpTargetDir)) {
+    fs.mkdirSync(tmpTargetDir, { recursive: true });
+  }
+  const dest = path.join(tmpTargetDir, 'FaceLivenessReactWrapper.generated.js');
+  fs.copyFileSync(sourceFile, dest);
+  return true;
+}
+
+// Poll for tmp root (created early by ngc) and copy once
+const interval = setInterval(() => {
+  if (copyOnce()) {
+    clearInterval(interval);
+  }
+}, 20);
+
+// Stop after 2 minutes
+setTimeout(() => clearInterval(interval), 120000);