@simprints/simface-sdk 0.5.1 → 0.7.1

package/dist/index.d.ts

@@ -10,8 +10,8 @@
  *   // Verify an existing user
  *   const result = await verify({ apiUrl: '...', projectId: '...', apiKey: '...' }, 'user-123');
  */
-import type { SimFaceConfig, EnrollResult, VerifyResult } from './types/index.js';
-export type { SimFaceConfig, EnrollResult, VerifyResult, FaceQualityResult, ValidateResult } from './types/index.js';
+import type { SimFaceCaptureOptions, SimFaceConfig, EnrollResult, VerifyResult } from './types/index.js';
+export type { CapturePreference, CapturePresentation, SimFaceCaptureOptions, SimFaceConfig, EnrollResult, VerifyResult, FaceQualityResult, ValidateResult, } from './types/index.js';
 export { SimFaceAPIClient } from './services/api-client.js';
 export { assessFaceQuality, assessFaceQualityForVideo } from './services/face-detection.js';
 export { captureFromCamera, blobToImage, blobToDataURL } from './services/camera.js';
@@ -23,8 +23,10 @@ export { SimFaceCapture } from './components/simface-capture.js';
  * and sends it to the backend for enrollment.
  *
  * If the user is already enrolled, returns { alreadyEnrolled: true }.
+ * The optional capture options let the host choose popup vs embedded capture
+ * and the preferred fallback policy.
  */
-export declare function enroll(config: SimFaceConfig, clientId: string): Promise<EnrollResult>;
+export declare function enroll(config: SimFaceConfig, clientId: string, captureOptions?: SimFaceCaptureOptions): Promise<EnrollResult>;
 /**
  * Verify a user with facial recognition.
  *
@@ -32,5 +34,7 @@ export declare function enroll(config: SimFaceConfig, clientId: string): Promise
  * and sends it to the backend for comparison against the enrolled image.
  *
  * If the user is not enrolled, returns { notEnrolled: true }.
+ * The optional capture options let the host choose popup vs embedded capture
+ * and the preferred fallback policy.
  */
-export declare function verify(config: SimFaceConfig, clientId: string): Promise<VerifyResult>;
+export declare function verify(config: SimFaceConfig, clientId: string, captureOptions?: SimFaceCaptureOptions): Promise<VerifyResult>;

package/dist/index.js

@@ -23,13 +23,15 @@ export { SimFaceCapture } from './components/simface-capture.js';
  * and sends it to the backend for enrollment.
  *
  * If the user is already enrolled, returns { alreadyEnrolled: true }.
+ * The optional capture options let the host choose popup vs embedded capture
+ * and the preferred fallback policy.
  */
-export async function enroll(config, clientId) {
+export async function enroll(config, clientId, captureOptions) {
     const client = new SimFaceAPIClient(config);
     // Validate API key first
     await client.validateAPIKey();
     // Capture face image
-    const blob = await captureWithQualityCheck();
+    const blob = await captureWithQualityCheck(captureOptions);
     if (!blob) {
         return { success: false, clientId, message: 'Capture cancelled by user' };
     }
@@ -48,13 +50,15 @@ export async function enroll(config, clientId) {
  * and sends it to the backend for comparison against the enrolled image.
  *
  * If the user is not enrolled, returns { notEnrolled: true }.
+ * The optional capture options let the host choose popup vs embedded capture
+ * and the preferred fallback policy.
  */
-export async function verify(config, clientId) {
+export async function verify(config, clientId, captureOptions) {
     const client = new SimFaceAPIClient(config);
     // Validate API key first
     await client.validateAPIKey();
     // Capture face image
-    const blob = await captureWithQualityCheck();
+    const blob = await captureWithQualityCheck(captureOptions);
     if (!blob) {
         return { match: false, score: 0, threshold: 0, message: 'Capture cancelled by user' };
     }
@@ -63,7 +67,7 @@ export async function verify(config, clientId) {
 /**
  * Capture a face image with the camera flow's built-in quality validation.
  */
-async function captureWithQualityCheck() {
-    return captureFromCamera();
+async function captureWithQualityCheck(captureOptions) {
+    return captureFromCamera(captureOptions);
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAIzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAqB,EAAE,QAAgB;IAClE,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,yBAAyB;IACzB,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAE9B,qBAAqB;IACrB,MAAM,IAAI,GAAG,MAAM,uBAAuB,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;IAC5E,CAAC;IAED,kBAAkB;IAClB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEnD,+CAA+C;IAC/C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,MAAqB,EAAE,QAAgB;IAClE,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,yBAAyB;IACzB,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAE9B,qBAAqB;IACrB,MAAM,IAAI,GAAG,MAAM,uBAAuB,EAAE,CAAC;IAC7C,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACxF,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,uBAAuB;IACpC,OAAO,iBAAiB,EAAE,CAAC;AAC7B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAazD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,QAAgB,EAChB,cAAsC;IAEtC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,yBAAyB;IACzB,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAE9B,qBAAqB;IACrB,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;IAC5E,CAAC;IAED,kBAAkB;IAClB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAEnD,+CAA+C;IAC/C,IAAI,MAAM,CAAC,eAAe,EAAE,CAAC;QAC3B,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,QAAgB,EAChB,cAAsC;IAEtC,MAAM,MAAM,GAAG,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC;IAE5C,yBAAyB;IACzB,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC;IAE9B,qBAAqB;IACrB,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,2BAA2B,EAAE,CAAC;IACxF,CAAC;IAED,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,KAAK,UAAU,uBAAuB,CACpC,cAAsC;IAEtC,OAAO,iBAAiB,CAAC,cAAc,CAAC,CAAC;AAC3C,CAAC"}

package/dist/services/camera.d.ts

@@ -1,18 +1,14 @@
 /**
  * Camera capture service.
  *
- * Uses realtime face guidance with automatic capture when supported and falls
- * back to a simpler manual capture flow when the browser cannot support it.
+ * Plans capture explicitly as an ordered fallback chain:
+ * auto camera -> manual camera -> media picker.
  */
+import { blobToDataURL, blobToImage } from '../shared/capture-runtime.js';
+import type { SimFaceCaptureOptions } from '../types/index.js';
 /**
- * Opens the device camera and returns a confirmed image Blob, or null if cancelled.
+ * Opens the configured capture presentation and returns a confirmed image Blob,
+ * or null if the user cancels.
  */
-export declare function captureFromCamera(): Promise<Blob | null>;
-/**
- * Loads a Blob as an HTMLImageElement for face detection analysis.
- */
-export declare function blobToImage(blob: Blob): Promise<HTMLImageElement>;
-/**
- * Creates a data URL from a Blob for display in an <img> tag.
- */
-export declare function blobToDataURL(blob: Blob): Promise<string>;
+export declare function captureFromCamera(options?: SimFaceCaptureOptions): Promise<Blob | null>;
+export { blobToImage, blobToDataURL };