@unissey-web/sdk-angular 3.7.2

package/README.md

@@ -0,0 +1,311 @@
+# `@unissey-web/sdk-angular__next`
+
+> Unissey's Angular Library
+
+1. [Installation](#1-installation)
+2. [Getting Started](#2-getting-started)
+3. [Reference](#3-reference)
+4. [About](#4-about)
+
+# 1. Installation
+
+## Get a personnal access token
+
+First generate an access token by following [this link](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line). Make sure to include at least the `repo` && `read:packages` permission to the access token.
+
+Then, to get access permissions, you will need to contact someone from the Unissey organisation with your github account name.
+
+## Authenticate to the registry
+
+```shell
+# set your repository token environnement variable
+export NPM_TOKEN=repositoryToken
+```
+
+Then reference the new registry in a `.npmrc` in your project directory
+
+```shell
+//npm.pkg.github.com/:_authToken=${NPM_TOKEN}
+@unissey:registry=https://npm.pkg.github.com
+```
+
+.
+
+## Download the package
+
+```shell
+npm install @unissey-web/sdk-angular__next
+```
+
+# 2. Getting Started
+
+## Required configuration
+
+This library requires polyfills to work correctly. At the moment this library only needs polyfills for async functions.
+We recommend to add one of the following package in your application dependencies:
+
+- `babel-polyfill`
+- `regenerator-runtime`
+
+```shell
+npm install babel-polyfill
+```
+
+or
+
+```shell
+npm install regenerator-runtime
+```
+
+And then import one the dependency in your polyfill file:
+
+```typescript
+import "babel-polyfill";
+```
+
+or
+
+```typescript
+import "regenerator-runtime/runtime";
+```
+
+After that, all you need is to register the UnisseySdkModule in your application module.
+
+```typescript
+import { NgModule } from "@angular/core";
+import { BrowserModule } from "@angular/platform-browser";
+import { AppRoutingModule } from "./app-routing.module";
+import { AppComponent } from "./app.component";
+
+import { UnisseySdkModule } from "@unissey-web/sdk-angular__next"; // Unissey's SDK module
+
+@NgModule({
+  declarations: [AppComponent],
+  // We need to register the Unissey SDK module in the Angular module
+  imports: [BrowserModule, AppRoutingModule, UnisseySdkModule],
+  providers: [],
+  bootstrap: [AppComponent],
+})
+export class AppModule {}
+```
+
+# 3. Reference
+
+These is the list of all components present in the public API:
+
+## Liveness
+
+Component responsible to record a selfie
+
+```html
+<unissey-liveness></unissey-liveness>
+```
+
+### Reference
+
+| Property type | Name    | Default value                                    | Type                                 | Description                                                           |
+| ------------- | ------- | ------------------------------------------------ | ------------------------------------ | --------------------------------------------------------------------- |
+| `Input`       | strings | [see LivenessStrings defaults](#livenessstrings) | [LivenessStrings](#livenessstrings)  | Text to be displayed for the instructions and actions                 |
+| `Output`      | record  | `N/A`                                            | (event: [Capture](#capture)) => void | Callback triggered when the liveness selfie was successfully recorded |
+
+### Customizations
+
+You can override the default instructions and add custom actions next to the record button.
+To do so, you must add a child element, within the `unissey-liveness` tag, with the attribute `slot="custom-instructions"`, as the example below:
+
+```html
+<unissey-liveness (record)="onRecord($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+</unissey-liveness>
+```
+
+You can also add custom actions near the record button, which could be usefull to exit the liveness process.
+Just like for the custom instructions, you need to a child element with the attribute `slot="instructions-actions"`, as the example below:
+
+```html
+<unissey-liveness (record)="onRecord($event)">
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-liveness>
+```
+
+You can also combine both custom instructions & actions, as the example below:
+
+```html
+<unissey-liveness (record)="onRecord($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-liveness>
+```
+
+## Reference Capture
+
+Component responsible to take either a photo or a short video of a reference document (e.g. ID card, Driving license...)
+
+```html
+<unissey-reference-capture></unissey-reference-capture>
+```
+
+### Reference
+
+| Property type | Name      | Default value                                                    | Type                                                               | Description                                                     |
+| ------------- | --------- | ---------------------------------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------- |
+| `Input`       | strings   | [see ReferenceCaptureStrings defaults](#referenceCaptureStrings) | [ReferenceCaptureStrings](#referencecapturestrings)                | Text to be displayed for the instructions and actions           |
+| `Output`      | reference | `N/A`                                                            | (event: [ReferenceCaptureResult](#referencecaptureresult)) => void | Callback triggered when the reference was successfully recorded |
+
+### Customizations
+
+You can override the default instructions and add custom actions next to the record button.
+To do so, you must add a child element, within the `unissey-liveness` tag, with the attribute `slot="custom-instructions"`, as the example below:
+
+```html
+<unissey-reference-capture reference="onReference($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+</unissey-reference-capture>
+```
+
+You can also add custom actions near the record button, which could be usefull to exit the liveness process.
+Just like for the custom instructions, you need to a child element with the attribute `slot="instructions-actions"`, as the example below:
+
+```html
+<unissey-reference-capture reference="onReference($event)">
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-reference-capture>
+```
+
+You can also combine both custom instructions & actions, as the example below:
+
+```html
+<unissey-reference-capture reference="onReference($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-reference-capture>
+```
+
+## Full Capture
+
+Component responsible to take both a liveness selfie & a reference media
+
+```html
+<unissey-full-capture></unissey-full-capture>
+```
+
+### Reference
+
+| Property type | Name      | Default value                                          | Type                                                               | Description                                                           |
+| ------------- | --------- | ------------------------------------------------------ | ------------------------------------------------------------------ | --------------------------------------------------------------------- |
+| `Input`       | strings   | [see FullCaptureStrings defaults](#fullcapturestrings) | [FullCaptureStrings](#fullcapturestrings)                          | Text to be displayed for the instructions and actions                 |
+| `Output`      | reference | `N/A`                                                  | (event: [ReferenceCaptureResult](#referencecaptureresult)) => void | Callback triggered when the reference was successfully recorded       |
+| `Output`      | target    | `N/A`                                                  | (event: [Capture](#capture)) => void                               | Callback triggered when the liveness selfie was successfully recorded |
+
+### Example:
+
+```html
+<unissey-full-capture (reference)="onReference($event)" (target)="onLiveness($event)"></unissey-full-capture>
+```
+
+## Capture
+
+```typescript
+type Capture = {
+  video: Blob;
+  metadata: unknown;
+};
+```
+
+## LivenessStrings
+
+```typescript
+type LivenessStrings = {
+  back: string;
+  directionSubtitle: string;
+  recordBtnLabel: string;
+  title: string;
+  recordSubtitle: string;
+};
+```
+
+## ReferenceCaptureStrings
+
+```typescript
+type ReferenceCaptureStrings = {
+  back: string;
+  title: string;
+  captureTitle: string;
+  editorTitle: string;
+  directionSubtitle: string;
+  pictureRecordSubtitle: string;
+  videoRecordSubtitle: string;
+  uploadBtn: string;
+  pictureBtn: string;
+  recordVidBtn: string;
+  retryPictureCaptureBtn: string;
+  retryVideoCaptureBtn: string;
+  replayValidation: string;
+  editor: {
+    validate: string;
+  };
+  directions: {
+    document: string;
+    face: string;
+    light: string;
+  };
+  videoRecorder: {
+    capture: string;
+    retry: string;
+    errors: {
+      noFace: string;
+    };
+    hints: {
+      up: string;
+      down: string;
+      perfect: string;
+      right: string;
+      left: string;
+      closer: string;
+      record: string;
+      nil: string;
+    };
+  };
+  pictureRecorder: {
+    validate: string;
+  };
+};
+```
+
+## FullCaptureStrings
+
+```typescript
+type FullCaptureStrings = {
+  liveness: LivenessStrings;
+  reference: ReferenceCaptureStrings;
+};
+```
+
+## ReferenceCaptureResult
+
+```typescript
+type ReferenceCaptureResult = { kind: "video"; capture: Capture } | { kind: "picture"; picture: Blob };
+```
+
+# 4. About
+
+## Versions
+
+| Version | Date | Description |
+| ------- | ---- | ----------- |

package/dist/unissey-sdk/README.md

@@ -0,0 +1,311 @@
+# `@unissey-web/sdk-angular__next`
+
+> Unissey's Angular Library
+
+1. [Installation](#1-installation)
+2. [Getting Started](#2-getting-started)
+3. [Reference](#3-reference)
+4. [About](#4-about)
+
+# 1. Installation
+
+## Get a personnal access token
+
+First generate an access token by following [this link](https://help.github.com/en/github/authenticating-to-github/creating-a-personal-access-token-for-the-command-line). Make sure to include at least the `repo` && `read:packages` permission to the access token.
+
+Then, to get access permissions, you will need to contact someone from the Unissey organisation with your github account name.
+
+## Authenticate to the registry
+
+```shell
+# set your repository token environnement variable
+export NPM_TOKEN=repositoryToken
+```
+
+Then reference the new registry in a `.npmrc` in your project directory
+
+```shell
+//npm.pkg.github.com/:_authToken=${NPM_TOKEN}
+@unissey:registry=https://npm.pkg.github.com
+```
+
+.
+
+## Download the package
+
+```shell
+npm install @unissey-web/sdk-angular__next
+```
+
+# 2. Getting Started
+
+## Required configuration
+
+This library requires polyfills to work correctly. At the moment this library only needs polyfills for async functions.
+We recommend to add one of the following package in your application dependencies:
+
+- `babel-polyfill`
+- `regenerator-runtime`
+
+```shell
+npm install babel-polyfill
+```
+
+or
+
+```shell
+npm install regenerator-runtime
+```
+
+And then import one the dependency in your polyfill file:
+
+```typescript
+import "babel-polyfill";
+```
+
+or
+
+```typescript
+import "regenerator-runtime/runtime";
+```
+
+After that, all you need is to register the UnisseySdkModule in your application module.
+
+```typescript
+import { NgModule } from "@angular/core";
+import { BrowserModule } from "@angular/platform-browser";
+import { AppRoutingModule } from "./app-routing.module";
+import { AppComponent } from "./app.component";
+
+import { UnisseySdkModule } from "@unissey-web/sdk-angular__next"; // Unissey's SDK module
+
+@NgModule({
+  declarations: [AppComponent],
+  // We need to register the Unissey SDK module in the Angular module
+  imports: [BrowserModule, AppRoutingModule, UnisseySdkModule],
+  providers: [],
+  bootstrap: [AppComponent],
+})
+export class AppModule {}
+```
+
+# 3. Reference
+
+These is the list of all components present in the public API:
+
+## Liveness
+
+Component responsible to record a selfie
+
+```html
+<unissey-liveness></unissey-liveness>
+```
+
+### Reference
+
+| Property type | Name    | Default value                                    | Type                                 | Description                                                           |
+| ------------- | ------- | ------------------------------------------------ | ------------------------------------ | --------------------------------------------------------------------- |
+| `Input`       | strings | [see LivenessStrings defaults](#livenessstrings) | [LivenessStrings](#livenessstrings)  | Text to be displayed for the instructions and actions                 |
+| `Output`      | record  | `N/A`                                            | (event: [Capture](#capture)) => void | Callback triggered when the liveness selfie was successfully recorded |
+
+### Customizations
+
+You can override the default instructions and add custom actions next to the record button.
+To do so, you must add a child element, within the `unissey-liveness` tag, with the attribute `slot="custom-instructions"`, as the example below:
+
+```html
+<unissey-liveness (record)="onRecord($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+</unissey-liveness>
+```
+
+You can also add custom actions near the record button, which could be usefull to exit the liveness process.
+Just like for the custom instructions, you need to a child element with the attribute `slot="instructions-actions"`, as the example below:
+
+```html
+<unissey-liveness (record)="onRecord($event)">
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-liveness>
+```
+
+You can also combine both custom instructions & actions, as the example below:
+
+```html
+<unissey-liveness (record)="onRecord($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-liveness>
+```
+
+## Reference Capture
+
+Component responsible to take either a photo or a short video of a reference document (e.g. ID card, Driving license...)
+
+```html
+<unissey-reference-capture></unissey-reference-capture>
+```
+
+### Reference
+
+| Property type | Name      | Default value                                                    | Type                                                               | Description                                                     |
+| ------------- | --------- | ---------------------------------------------------------------- | ------------------------------------------------------------------ | --------------------------------------------------------------- |
+| `Input`       | strings   | [see ReferenceCaptureStrings defaults](#referenceCaptureStrings) | [ReferenceCaptureStrings](#referencecapturestrings)                | Text to be displayed for the instructions and actions           |
+| `Output`      | reference | `N/A`                                                            | (event: [ReferenceCaptureResult](#referencecaptureresult)) => void | Callback triggered when the reference was successfully recorded |
+
+### Customizations
+
+You can override the default instructions and add custom actions next to the record button.
+To do so, you must add a child element, within the `unissey-liveness` tag, with the attribute `slot="custom-instructions"`, as the example below:
+
+```html
+<unissey-reference-capture reference="onReference($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+</unissey-reference-capture>
+```
+
+You can also add custom actions near the record button, which could be usefull to exit the liveness process.
+Just like for the custom instructions, you need to a child element with the attribute `slot="instructions-actions"`, as the example below:
+
+```html
+<unissey-reference-capture reference="onReference($event)">
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-reference-capture>
+```
+
+You can also combine both custom instructions & actions, as the example below:
+
+```html
+<unissey-reference-capture reference="onReference($event)">
+  <div slot="custom-instructions">
+    <p>Time for a selfie!</p>
+  </div>
+  <div slot="instructions-actions">
+    <button (click)="goBackToHome()">Back</button>
+  </div>
+</unissey-reference-capture>
+```
+
+## Full Capture
+
+Component responsible to take both a liveness selfie & a reference media
+
+```html
+<unissey-full-capture></unissey-full-capture>
+```
+
+### Reference
+
+| Property type | Name      | Default value                                          | Type                                                               | Description                                                           |
+| ------------- | --------- | ------------------------------------------------------ | ------------------------------------------------------------------ | --------------------------------------------------------------------- |
+| `Input`       | strings   | [see FullCaptureStrings defaults](#fullcapturestrings) | [FullCaptureStrings](#fullcapturestrings)                          | Text to be displayed for the instructions and actions                 |
+| `Output`      | reference | `N/A`                                                  | (event: [ReferenceCaptureResult](#referencecaptureresult)) => void | Callback triggered when the reference was successfully recorded       |
+| `Output`      | target    | `N/A`                                                  | (event: [Capture](#capture)) => void                               | Callback triggered when the liveness selfie was successfully recorded |
+
+### Example:
+
+```html
+<unissey-full-capture (reference)="onReference($event)" (target)="onLiveness($event)"></unissey-full-capture>
+```
+
+## Capture
+
+```typescript
+type Capture = {
+  video: Blob;
+  metadata: unknown;
+};
+```
+
+## LivenessStrings
+
+```typescript
+type LivenessStrings = {
+  back: string;
+  directionSubtitle: string;
+  recordBtnLabel: string;
+  title: string;
+  recordSubtitle: string;
+};
+```
+
+## ReferenceCaptureStrings
+
+```typescript
+type ReferenceCaptureStrings = {
+  back: string;
+  title: string;
+  captureTitle: string;
+  editorTitle: string;
+  directionSubtitle: string;
+  pictureRecordSubtitle: string;
+  videoRecordSubtitle: string;
+  uploadBtn: string;
+  pictureBtn: string;
+  recordVidBtn: string;
+  retryPictureCaptureBtn: string;
+  retryVideoCaptureBtn: string;
+  replayValidation: string;
+  editor: {
+    validate: string;
+  };
+  directions: {
+    document: string;
+    face: string;
+    light: string;
+  };
+  videoRecorder: {
+    capture: string;
+    retry: string;
+    errors: {
+      noFace: string;
+    };
+    hints: {
+      up: string;
+      down: string;
+      perfect: string;
+      right: string;
+      left: string;
+      closer: string;
+      record: string;
+      nil: string;
+    };
+  };
+  pictureRecorder: {
+    validate: string;
+  };
+};
+```
+
+## FullCaptureStrings
+
+```typescript
+type FullCaptureStrings = {
+  liveness: LivenessStrings;
+  reference: ReferenceCaptureStrings;
+};
+```
+
+## ReferenceCaptureResult
+
+```typescript
+type ReferenceCaptureResult = { kind: "video"; capture: Capture } | { kind: "picture"; picture: Blob };
+```
+
+# 4. About
+
+## Versions
+
+| Version | Date | Description |
+| ------- | ---- | ----------- |