@qore-id/web-sdk 1.0.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +0 -36
- package/dist/index.d.ts +7 -6
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -8,42 +8,6 @@ A clean, event-driven JavaScript SDK wrapper for integrating QoreID identity ver
|
|
|
8
8
|
npm install @qore-id/web-sdk
|
|
9
9
|
```
|
|
10
10
|
|
|
11
|
-
## Quick Start
|
|
12
|
-
|
|
13
|
-
```javascript
|
|
14
|
-
import QoreID from '@qore-id/web-sdk';
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
// Listen for events
|
|
18
|
-
QoreID.on('success', (data) => {
|
|
19
|
-
console.log('Verification successful:', data);
|
|
20
|
-
});
|
|
21
|
-
|
|
22
|
-
QoreID.on('error', (error) => {
|
|
23
|
-
console.error('Verification error:', error);
|
|
24
|
-
});
|
|
25
|
-
|
|
26
|
-
QoreID.on('close', (data) => {
|
|
27
|
-
console.error('Verification modal closed:', data);
|
|
28
|
-
});
|
|
29
|
-
|
|
30
|
-
QoreID.on('loading', (isLoading) => {
|
|
31
|
-
console.log('Loading:', isLoading);
|
|
32
|
-
});
|
|
33
|
-
|
|
34
|
-
// Start verification flow
|
|
35
|
-
await QoreID.start({
|
|
36
|
-
clientId: 'your-client-id',
|
|
37
|
-
product: 'your-product',
|
|
38
|
-
customerReference: 'unique-reference',
|
|
39
|
-
applicantData: {
|
|
40
|
-
firstname: 'John',
|
|
41
|
-
lastname: 'Doe',
|
|
42
|
-
email: 'john@example.com',
|
|
43
|
-
},
|
|
44
|
-
});
|
|
45
|
-
```
|
|
46
|
-
|
|
47
11
|
## Full Documentation
|
|
48
12
|
|
|
49
13
|
For complete documentation, examples, and API reference, visit:
|
package/dist/index.d.ts
CHANGED
|
@@ -1,15 +1,15 @@
|
|
|
1
1
|
//#region src/index.d.ts
|
|
2
|
-
type QoreidEvent = "success" | "error" | "close" | "loading";
|
|
2
|
+
type QoreidEvent = "init" | "success" | "error" | "close" | "loading";
|
|
3
3
|
type QoreidEventPayloads = {
|
|
4
4
|
success: Record<string, any>;
|
|
5
5
|
error: any;
|
|
6
6
|
close: Record<string, any>;
|
|
7
|
+
init: Record<string, any>;
|
|
7
8
|
loading: boolean;
|
|
8
9
|
};
|
|
9
10
|
type Handler<T extends QoreidEvent> = (payload: QoreidEventPayloads[T]) => void;
|
|
10
11
|
interface InitConfig {
|
|
11
12
|
containerId?: string;
|
|
12
|
-
environment?: "sandbox" | "production";
|
|
13
13
|
scriptUrl?: string;
|
|
14
14
|
}
|
|
15
15
|
interface ApplicantData {
|
|
@@ -25,6 +25,9 @@ interface ApplicantData {
|
|
|
25
25
|
interface IdentityData {
|
|
26
26
|
idType: string;
|
|
27
27
|
idNumber: string;
|
|
28
|
+
/** e.g NIN */
|
|
29
|
+
requiredIdType?: string;
|
|
30
|
+
useIdentityCache?: boolean;
|
|
28
31
|
}
|
|
29
32
|
interface AddressData {
|
|
30
33
|
address: string;
|
|
@@ -32,19 +35,17 @@ interface AddressData {
|
|
|
32
35
|
lgaName: string;
|
|
33
36
|
}
|
|
34
37
|
interface StartConfig {
|
|
35
|
-
|
|
36
|
-
product: string;
|
|
38
|
+
token: string;
|
|
37
39
|
customerReference: string;
|
|
38
|
-
flowId?: number;
|
|
39
40
|
applicantData: ApplicantData;
|
|
40
41
|
identityData?: IdentityData;
|
|
41
42
|
addressData?: AddressData;
|
|
43
|
+
ocrAcceptedDocuments?: string;
|
|
42
44
|
}
|
|
43
45
|
declare class QoreidSDK {
|
|
44
46
|
private listeners;
|
|
45
47
|
private container;
|
|
46
48
|
private loadPromise;
|
|
47
|
-
private currentElement;
|
|
48
49
|
constructor();
|
|
49
50
|
init(config?: InitConfig): Promise<void>;
|
|
50
51
|
on<T extends QoreidEvent>(event: T, handler: Handler<T>): void;
|
package/dist/index.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";KAAK,WAAA;AAAA,KAEA,mBAAA;EACH,OAAA,EAAS,MAAA;EACT,KAAA;EACA,KAAA,EAAO,MAAA;EACP,OAAA;AAAA;AAAA,KAIG,OAAA,WAAkB,WAAA,
|
|
1
|
+
{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";KAAK,WAAA;AAAA,KAEA,mBAAA;EACH,OAAA,EAAS,MAAA;EACT,KAAA;EACA,KAAA,EAAO,MAAA;EACP,IAAA,EAAM,MAAA;EACN,OAAA;AAAA;AAAA,KAIG,OAAA,WAAkB,WAAA,KAAgB,OAAA,EAAS,mBAAA,CAAoB,CAAA;AAAA,UAE1D,UAAA;EACR,WAAA;EACA,SAAA;AAAA;AAAA,UAGQ,aAAA;EACR,SAAA;EACA,UAAA;EACA,QAAA;EACA,MAAA;EAjBO;EAmBP,GAAA;EACA,KAAA;EACA,KAAA;AAAA;AAAA,UAGQ,YAAA;EACR,MAAA;EACA,QAAA;EApBU;EAsBV,cAAA;EACA,gBAAA;AAAA;AAAA,UAGQ,WAAA;EACR,OAAA;EACA,IAAA;EACA,OAAA;AAAA;AAAA,UAGQ,WAAA;EACR,KAAA;EACA,iBAAA;EACA,aAAA,EAAe,aAAA;EACf,YAAA,GAAe,YAAA;EACf,WAAA,GAAc,WAAA;EACd,oBAAA;AAAA;AAAA,cAGI,SAAA;EAAA,QACI,SAAA;EAAA,QACA,SAAA;EAAA,QACA,WAAA;;EAUR,IAAA,CAAK,MAAA,GAAS,UAAA,GAAU,OAAA;EA0CxB,EAAA,WAAa,WAAA,CAAA,CAAa,KAAA,EAAO,CAAA,EAAG,OAAA,EAAS,OAAA,CAAQ,CAAA;EAIrD,GAAA,WAAc,WAAA,CAAA,CAAa,KAAA,EAAO,CAAA,EAAG,OAAA,EAAS,OAAA,CAAQ,CAAA;EAItD,IAAA,WAAe,WAAA,CAAA,CAAa,KAAA,EAAO,CAAA,EAAG,OAAA,EAAS,OAAA,CAAQ,CAAA;EAQvD,kBAAA,CAAmB,KAAA,GAAQ,WAAA;EAAA,QAQnB,IAAA;EAUF,KAAA,CAAM,MAAA,EAAQ,WAAA,GAAW,OAAA;AAAA;AAAA,cA+C3B,MAAA,EAAM,SAAA"}
|
package/dist/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
const e=new class{constructor(){this.listeners=new Map,this.loadPromise=null,
|
|
1
|
+
const e=new class{constructor(){this.listeners=new Map,this.loadPromise=null,[`init`,`success`,`error`,`close`,`loading`].forEach(e=>{this.listeners.set(e,new Set)})}init(e){if(this.loadPromise)return this.loadPromise;let t=e?.scriptUrl||`https://dashboard.qoreid.com/qoreid-sdk/qoreid.js`;return this.loadPromise=new Promise((n,r)=>{if(e?.containerId){let t=document.getElementById(e.containerId);if(!t)throw Error(`Container not found`);this.container=t}else this.container=document.createElement(`div`),this.container.id=`qoreid-sdk-root`,document.body.appendChild(this.container);if(window.QoreIDWebSdk){n();return}let i=document.createElement(`script`);i.src=t,i.async=!0,i.onload=()=>{n()},i.onerror=r,document.body.appendChild(i)}),this.loadPromise}on(e,t){this.listeners.get(e)?.add(t)}off(e,t){this.listeners.get(e)?.delete(t)}once(e,t){let n=r=>{t(r),this.off(e,n)};this.on(e,n)}removeAllListeners(e){e?this.listeners.get(e)?.clear():this.listeners.forEach(e=>e.clear())}emit(e,t){this.listeners.get(e)?.forEach(e=>e(t))}async start(e){if(this.emit(`loading`,!0),await this.init(),!e.customerReference)throw Error(`customerReference is required`);if(!e?.token)throw Error(`token required`);try{window.QoreIdSDK.init({...e,initializedEventTrigger:e=>{this.emit(`init`,e)},submittedEventTrigger:e=>{this.emit(`success`,e)},errorEventTrigger:e=>{this.emit(`error`,e)},closedEventTrigger:e=>{this.emit(`close`,e)}});let t=()=>{document.querySelector(`.sdkPopup`)?this.emit(`loading`,!1):setTimeout(t,1e3)};setTimeout(t,1e3)}catch(e){this.emit(`error`,e)}}};export{e as default};
|
|
2
2
|
//# sourceMappingURL=index.js.map
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["type QoreidEvent = \"success\" | \"error\" | \"close\" | \"loading\";\n\ntype QoreidEventPayloads = {\n success: Record<string, any>;\n error: any;\n close: Record<string, any>;\n loading: boolean;\n};\n\n// if the event is loading payload is boolean, otherwise it's the detail object\ntype Handler<T extends QoreidEvent> = (
|
|
1
|
+
{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["type QoreidEvent = \"init\" | \"success\" | \"error\" | \"close\" | \"loading\";\n\ntype QoreidEventPayloads = {\n success: Record<string, any>;\n error: any;\n close: Record<string, any>;\n init: Record<string, any>;\n loading: boolean;\n};\n\n// if the event is loading payload is boolean, otherwise it's the detail object\ntype Handler<T extends QoreidEvent> = (payload: QoreidEventPayloads[T]) => void;\n\ninterface InitConfig {\n containerId?: string;\n scriptUrl?: string;\n}\n\ninterface ApplicantData {\n firstname: string;\n middlename?: string;\n lastname: string;\n gender?: string;\n /**YYYY-MM-DD */\n dob?: string;\n phone?: string;\n email?: string;\n}\n\ninterface IdentityData {\n idType: string;\n idNumber: string;\n /** e.g NIN */\n requiredIdType?: string;\n useIdentityCache?: boolean;\n}\n\ninterface AddressData {\n address: string;\n city: string;\n lgaName: string;\n}\n\ninterface StartConfig {\n token: string;\n customerReference: string;\n applicantData: ApplicantData;\n identityData?: IdentityData;\n addressData?: AddressData;\n ocrAcceptedDocuments?: string;\n}\n\nclass QoreidSDK {\n private listeners = new Map<QoreidEvent, Set<Handler<QoreidEvent>>>();\n private container!: HTMLElement;\n private loadPromise: Promise<void> | null = null;\n constructor() {\n [\"init\", \"success\", \"error\", \"close\", \"loading\"].forEach((event) => {\n this.listeners.set(event as QoreidEvent, new Set());\n });\n }\n\n // -------------------\n // Init\n // -------------------\n init(config?: InitConfig) {\n if (this.loadPromise) return this.loadPromise;\n const scriptUrl =\n config?.scriptUrl || \"https://dashboard.qoreid.com/qoreid-sdk/qoreid.js\";\n\n this.loadPromise = new Promise((resolve, reject) => {\n // 1. Setup container\n if (config?.containerId) {\n const el = document.getElementById(config.containerId);\n if (!el) throw new Error(\"Container not found\");\n this.container = el;\n } else {\n this.container = document.createElement(\"div\");\n this.container.id = \"qoreid-sdk-root\";\n document.body.appendChild(this.container);\n }\n\n // 2. Load script once\n if ((window as any).QoreIDWebSdk) {\n resolve();\n return;\n }\n\n const script = document.createElement(\"script\");\n script.src = scriptUrl;\n script.async = true;\n\n script.onload = () => {\n resolve();\n };\n\n script.onerror = reject;\n\n document.body.appendChild(script);\n });\n\n return this.loadPromise;\n }\n\n // -------------------\n // Events\n // -------------------\n on<T extends QoreidEvent>(event: T, handler: Handler<T>) {\n this.listeners.get(event)?.add(handler as Handler<QoreidEvent>);\n }\n\n off<T extends QoreidEvent>(event: T, handler: Handler<T>) {\n this.listeners.get(event)?.delete(handler as Handler<QoreidEvent>);\n }\n\n once<T extends QoreidEvent>(event: T, handler: Handler<T>) {\n const onceHandler: Handler<T> = (payload) => {\n handler(payload);\n this.off(event, onceHandler);\n };\n this.on(event, onceHandler);\n }\n\n removeAllListeners(event?: QoreidEvent) {\n if (event) {\n this.listeners.get(event)?.clear();\n } else {\n this.listeners.forEach((set) => set.clear());\n }\n }\n\n private emit<T extends QoreidEvent>(\n event: T,\n payload?: QoreidEventPayloads[T],\n ) {\n this.listeners.get(event)?.forEach((h) => h(payload));\n }\n\n // -------------------\n // Start\n // -------------------\n async start(config: StartConfig) {\n this.emit(\"loading\", true);\n await this.init();\n\n if (!config.customerReference) {\n throw new Error(\"customerReference is required\");\n }\n\n if (!config?.token) {\n throw new Error(\"token required\");\n }\n\n // 5. Trigger SDK\n try {\n (window as any).QoreIdSDK.init({\n ...config,\n initializedEventTrigger: (e: Event) => {\n this.emit(\"init\", e);\n },\n submittedEventTrigger: (e: Event) => {\n this.emit(\"success\", e);\n },\n errorEventTrigger: (e: Event) => {\n this.emit(\"error\", e);\n },\n closedEventTrigger: (e: Event) => {\n this.emit(\"close\", e);\n },\n });\n\n // check for element with class sdkPopup in embedded iframe\n const checkPopup = () => {\n const popup = document.querySelector(\".sdkPopup\") as HTMLElement | null;\n if (popup) {\n this.emit(\"loading\", false);\n } else {\n setTimeout(checkPopup, 1000);\n }\n };\n setTimeout(checkPopup, 1000);\n } catch (err) {\n this.emit(\"error\", err);\n }\n }\n}\n\n// Singleton export\nconst QoreID = new QoreidSDK();\nexport default QoreID;\n"],"mappings":"AA4LA,MAAM,EAAS,IAxIf,KAAgB,CAId,aAAc,gBAHM,IAAI,qBAEoB,KAE1C,CAAC,OAAQ,UAAW,QAAS,QAAS,UAAU,CAAC,QAAS,GAAU,CAClE,KAAK,UAAU,IAAI,EAAsB,IAAI,IAAM,EACnD,CAMJ,KAAK,EAAqB,CACxB,GAAI,KAAK,YAAa,OAAO,KAAK,YAClC,IAAM,EACJ,GAAQ,WAAa,oDAiCvB,MA/BA,MAAK,YAAc,IAAI,SAAS,EAAS,IAAW,CAElD,GAAI,GAAQ,YAAa,CACvB,IAAM,EAAK,SAAS,eAAe,EAAO,YAAY,CACtD,GAAI,CAAC,EAAI,MAAU,MAAM,sBAAsB,CAC/C,KAAK,UAAY,OAEjB,KAAK,UAAY,SAAS,cAAc,MAAM,CAC9C,KAAK,UAAU,GAAK,kBACpB,SAAS,KAAK,YAAY,KAAK,UAAU,CAI3C,GAAK,OAAe,aAAc,CAChC,GAAS,CACT,OAGF,IAAM,EAAS,SAAS,cAAc,SAAS,CAC/C,EAAO,IAAM,EACb,EAAO,MAAQ,GAEf,EAAO,WAAe,CACpB,GAAS,EAGX,EAAO,QAAU,EAEjB,SAAS,KAAK,YAAY,EAAO,EACjC,CAEK,KAAK,YAMd,GAA0B,EAAU,EAAqB,CACvD,KAAK,UAAU,IAAI,EAAM,EAAE,IAAI,EAAgC,CAGjE,IAA2B,EAAU,EAAqB,CACxD,KAAK,UAAU,IAAI,EAAM,EAAE,OAAO,EAAgC,CAGpE,KAA4B,EAAU,EAAqB,CACzD,IAAM,EAA2B,GAAY,CAC3C,EAAQ,EAAQ,CAChB,KAAK,IAAI,EAAO,EAAY,EAE9B,KAAK,GAAG,EAAO,EAAY,CAG7B,mBAAmB,EAAqB,CAClC,EACF,KAAK,UAAU,IAAI,EAAM,EAAE,OAAO,CAElC,KAAK,UAAU,QAAS,GAAQ,EAAI,OAAO,CAAC,CAIhD,KACE,EACA,EACA,CACA,KAAK,UAAU,IAAI,EAAM,EAAE,QAAS,GAAM,EAAE,EAAQ,CAAC,CAMvD,MAAM,MAAM,EAAqB,CAI/B,GAHA,KAAK,KAAK,UAAW,GAAK,CAC1B,MAAM,KAAK,MAAM,CAEb,CAAC,EAAO,kBACV,MAAU,MAAM,gCAAgC,CAGlD,GAAI,CAAC,GAAQ,MACX,MAAU,MAAM,iBAAiB,CAInC,GAAI,CACD,OAAe,UAAU,KAAK,CAC7B,GAAG,EACH,wBAA0B,GAAa,CACrC,KAAK,KAAK,OAAQ,EAAE,EAEtB,sBAAwB,GAAa,CACnC,KAAK,KAAK,UAAW,EAAE,EAEzB,kBAAoB,GAAa,CAC/B,KAAK,KAAK,QAAS,EAAE,EAEvB,mBAAqB,GAAa,CAChC,KAAK,KAAK,QAAS,EAAE,EAExB,CAAC,CAGF,IAAM,MAAmB,CACT,SAAS,cAAc,YAAY,CAE/C,KAAK,KAAK,UAAW,GAAM,CAE3B,WAAW,EAAY,IAAK,EAGhC,WAAW,EAAY,IAAK,OACrB,EAAK,CACZ,KAAK,KAAK,QAAS,EAAI"}
|