@connectid-tools/idp-selector-react 6.10.0-alpha.2 → 6.10.0-alpha.3

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.
Files changed (9) hide show
  1. package/CidButton.d.ts +1 -0
  2. package/CidButton.js +2 -1
  3. package/README.md +32 -22
  4. package/compatibility.d.ts +1 -1
  5. package/compatibility.js +5 -4
  6. package/{compability.test.js → compatibility.test.js} +37 -4
  7. package/package.json +1 -1
  8. package/types.d.ts +1 -0
  9. /package/{compability.test.d.ts → compatibility.test.d.ts} +0 -0
package/CidButton.d.ts CHANGED
@@ -22,6 +22,7 @@ type CidButtonProps = {
22
22
  showInfoContent?: boolean;
23
23
  onError?: (error: string) => void;
24
24
  showCompatibilityWarnings?: boolean;
25
+ supportIncognito?: boolean;
25
26
  forceMobile?: boolean;
26
27
  forceIos?: boolean;
27
28
  forceAndroid?: boolean;
package/CidButton.js CHANGED
@@ -30,7 +30,7 @@ import detectIncognito from './incognito';
30
30
  import { getDeviceType, isAndroid, isChromeBrowser, isIos, isSamsungBrowser } from './userAgent';
31
31
  import { hasCertification } from './certification';
32
32
  import { getCompatibility } from './compatibility';
33
- export const CidButton = ({ onProceed, claims, requiredClaims, rpLogoUrl, requiredCertifications, label = 'Verify', size = 'regular', type, introTextType, fullProcessCollapsible = false, participantsUri = 'https://data.directory.connectid.com.au/participants', certificationStatus = 'Active', rpDataSharingDescription = 'Your details will be shared with the current website.', enableManualVerification = false, showAllParticipants = false, theme = 'dark', logoLockupStyle = 'light', showInfoContent = false, onError = () => { }, showCompatibilityWarnings = false, forceMobile = false, // only for testing purposes
33
+ export const CidButton = ({ onProceed, claims, requiredClaims, rpLogoUrl, requiredCertifications, label = 'Verify', size = 'regular', type, introTextType, fullProcessCollapsible = false, participantsUri = 'https://data.directory.connectid.com.au/participants', certificationStatus = 'Active', rpDataSharingDescription = 'Your details will be shared with the current website.', enableManualVerification = false, showAllParticipants = false, theme = 'dark', logoLockupStyle = 'light', showInfoContent = false, onError = () => { }, showCompatibilityWarnings = false, supportIncognito = false, forceMobile = false, // only for testing purposes
34
34
  forceIos = false, // only for testing purposes
35
35
  forceAndroid = false, // only for testing purposes
36
36
  forceIncognito = false, // only for testing purposes
@@ -131,6 +131,7 @@ forceIncognito = false, // only for testing purposes
131
131
  const isMobile = forceMobile || getDeviceType() === 'mobile';
132
132
  const idpHasAppCertification = hasCertification(authorisationServerCertifications, 'Channel', 'app');
133
133
  const compatibility = getCompatibility({
134
+ supportIncognito,
134
135
  idpHasAppCertification,
135
136
  isMobile,
136
137
  isIncognito: forceIncognito || !!isIncognito,
package/README.md CHANGED
@@ -29,28 +29,29 @@ Your page should render a widget similar to this 👇 And when the button is cli
29
29
 
30
30
  ## ⭐ CidButton Options
31
31
 
32
- | key | description | type | required | default |
33
- | ------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------- | ------------------------------------------------- | ------------------------------------------------------- |
34
- | onProceed | Callback to be called when IDP Selector `Proceed` button is clicked | (authorisationServerId: string, compatibilityWarnings: CompatibilityWarnings) => void | yes | - |
35
- | claims | List of claims to be displayed to the user and will be requested from IDP to be shared. If `requiredClaims` not supplied then only IDPs that support all listed `claims` will be displayed to the user. | Claim[] | yes | - |
36
- | requiredClaims | List of claims to be supported by IDPs. Must be a subset of `claims`. Where an RP can successfully complete their use case without all claims specified in `claims`, they can specify `requiredClaims` with the minimum list of claims needed, which will then be used for filtering and may result in additional IDP options being displayed to the customer. | Claim[] | no (`claims` will be used if no `requiredClaims`) | - |
37
- | label | The button label. Do not use 'Sign Up'. It is deprecated. | 'Verify' \| 'Login' \| 'Sign Up' \| 'Age check' \| 'Sign up' \| 'Authenticate' \| 'Checkout' | no | 'Verify' |
38
- | size | The button size | 'regular' \| 'large' | no | 'regular' |
39
- | participantsUri | Registry API URI used to retrieve the list of participating Identity Providers. Should be changed only for testing. | string | no | 'https://data.directory.connectid.com.au/participants' |
40
- | certificationStatus | Filter Identity Provider by certification status. | 'Active' \| 'All' | no | 'Active' |
41
- | requiredCertifications | Filter Identity Provider by certifications. | RequiredCertification[] | no | All certifications. |
42
- | rpLogoUrl | URL of the RP logo (your logo). Size 40x40. | URL | no | No logo. |
43
- | rpDataSharingDescription | The text that goes under the popup title explaining how shared data will be used. | string | no | 'Your details will be shared with the current website.' |
44
- | enableManualVerification | Whether an option to verify identity manually is displayed or not. | boolean | no | false |
45
- | type | The type of ConnectID button widget. [More details here](#type) | 'tiny' \| 'medium benefits' \| 'medium process' \| 'full benefits' \| 'full process' | no | undefined (shows only ConnectID button). |
46
- | introTextType | The text that goes above the ConnectID button. [More details here](#introTextType) | 'verify-trust' \| 'verify-account' \| 'power' \| 'sign-up' \| 'bank-details-plus-personal-info' \| 'bank-details-only' \| 'verify-age' | yes when `type` is set. | - |
47
- | fullProcessCollapsible | Whether process items are collapsible or not. Only available when `type` is `full process`. | boolean | no | false |
48
- | showAllParticipants | Show all participants regardless of any other option. **_This should only be used for testing_**. | boolean | no | false |
49
- | theme | ConnectID button theme. | 'dark' \| 'light' | no | 'dark' |
50
- | logoLockupStyle | Logo lockup theme | 'dark' \| 'light' | no | 'light' |
51
- | showInfoContent | The text that goes below the ConnectID button [More details here](#infoContent) | boolean | false | false |
52
- | onError | Callback to be called when there is an error fetching participants or invalid options. | () => void | no | () => {} // do nothing |
53
- | showCompatibilityWarnings | Whether to show compatibility warnings or not. If set to `true` a popup with compatibility message will show up after an IDP is selected (if conditions are met) [More details here](#showCompatibilityWarnings) | boolean | no | false |
32
+ | option | description | type | required | default |
33
+ |-----|-------------|------|----------|---------|
34
+ | onProceed | Callback when Proceed button is clicked | (id: string, warnings: CompatibilityWarnings) => void | yes | - |
35
+ | claims | Claims to display and request from IDP | Claim[] | yes | - |
36
+ | requiredClaims | Subset of `claims` that must be supported | Claim[] | no (`claims` used if not set) | - |
37
+ | label | Button label (avoid 'Sign Up') | 'Verify'\|'Login'\|'Sign Up'\|'Age check'\|'Sign up'\|'Authenticate'\|'Checkout' | no | 'Verify' |
38
+ | size | Button size | 'regular'\|'large' | no | 'regular' |
39
+ | participantsUri | API URI for IDPs | string | no | 'https://data.directory.connectid.com.au/participants' |
40
+ | certificationStatus | Filter IDPs by certification | 'Active'\|'All' | no | 'Active' |
41
+ | requiredCertifications | Filter by certifications | RequiredCertification[] | no | All certifications |
42
+ | rpLogoUrl | RP logo URL (40x40) | URL | no | No logo |
43
+ | rpDataSharingDescription | Explains how data is used | string | no | 'Your details will be shared with the current website.' |
44
+ | enableManualVerification | Show manual verification option | boolean | no | false |
45
+ | type | Widget type [More](#type) | 'tiny'\|'medium benefits'\|'medium process'\|'full benefits'\|'full process' | no | undefined |
46
+ | introTextType | Text above button [More](#introTextType) | 'verify-trust'\|'verify-account'\|'power'\|'sign-up'\|'bank-details-plus-personal-info'\|'bank-details-only'\|'verify-age' | yes if `type` is set | - |
47
+ | fullProcessCollapsible | Collapse process items (for `full process`) | boolean | no | false |
48
+ | showAllParticipants | Show all IDPs (testing) | boolean | no | false |
49
+ | theme | Button theme | 'dark'\|'light' | no | 'dark' |
50
+ | logoLockupStyle | Logo theme | 'dark'\|'light' | no | 'light' |
51
+ | showInfoContent | Show text below button [More](#infoContent) | boolean | no | false |
52
+ | onError | Called on error | () => void | no | () => {} |
53
+ | showCompatibilityWarnings | Show compatibility popup [More](#showCompatibilityWarnings) | boolean | no | false |
54
+ | supportIncognito | Whether RP supports incognito mode or not (to be able to support incognito mode RP website cannot use browser storage like `cookies`, `sessionStorage`, `localStorage`, etc). | boolean | no | false |
54
55
 
55
56
  #### CompatibilityWarnings type
56
57
 
@@ -70,6 +71,12 @@ It returns information about the compatibility of the user's browser and device
70
71
  - `mobileOs`: The operating system of the mobile device, if applicable.
71
72
  - `browser`: The browser being used by the user.
72
73
 
74
+ Here are the possible reasons why the flow might fail:
75
+ | Scenario | Why it might fail | Suggested message | Incognito support |
76
+ |---|---|---|---|
77
+ | Mobile incognito (`isMobile: true`, `isIncognito: true`) | When a user is returned from the IDP app to the your RP site, the user will be returned in a new incognito tab. If your app relies on `cookies`, `sessionStorage` or `localStorage` it will not have access to any of the these values from the user's original tab. If your flow relies on them it will not be able to continue. | "You are using incognito mode – this may not work properly. Please switch to normal mode." | If `supportIncognito` is set to `true`, this flow will not fail. |
78
+ | Android Samsung browser (`isMobile: true`, `mobileOs: 'android'`, `browser: 'samsung'`) | The Samsung browser default settings prevent the opening of App Links, meaning the IDP app may not open when the user is redirected. User may need to use an alternate browser on the mobile device, or a desktop device. | "It looks like you are using the Samsung browser which may not work properly with this provider. We suggest trying an alternate browser on your mobile, or using a desktop device." | Regardless of `supportIncognito` value, this flow might fail. |
79
+
73
80
  #### certificationStatus values
74
81
 
75
82
  - `Active`: only IDPs with active certification
@@ -252,6 +259,9 @@ The SVG image below the ConnectID button has either option dark or light mode. B
252
259
 
253
260
  ## 🚀 Release Notes
254
261
 
262
+ ### 6.10.0-alpha.3 (Jun 20, 2025)
263
+ - Add `supportIncognito` option.
264
+
255
265
  ### 6.10.0-alpha.2 (Jun 17, 2025)
256
266
  - Add `showCompatibilityWarnings` option.
257
267
 
package/compatibility.d.ts CHANGED
@@ -1,3 +1,3 @@
1
1
  import { CompatibilityEnvironment, CompatibilityWarnings } from './types';
2
2
  export declare const getCompatibility: (env: CompatibilityEnvironment) => CompatibilityWarnings;
3
- export declare const getMightFail: (env: Pick<CompatibilityEnvironment, "idpHasAppCertification" | "isMobile" | "isIncognito" | "isAndroid" | "isIos" | "isSamsungBrowser" | "isChromeBrowser">) => boolean;
3
+ export declare const getMightFail: (env: Pick<CompatibilityEnvironment, "supportIncognito" | "idpHasAppCertification" | "isMobile" | "isIncognito" | "isAndroid" | "isIos" | "isSamsungBrowser" | "isChromeBrowser">) => boolean;
package/compatibility.js CHANGED
@@ -1,7 +1,8 @@
1
1
  import { getBrowserName } from './userAgent';
2
2
  export const getCompatibility = (env) => {
3
- const { idpHasAppCertification, isAndroid, isChromeBrowser, isIncognito, isMobile, isSamsungBrowser, isIos } = env;
3
+ const { supportIncognito, idpHasAppCertification, isAndroid, isChromeBrowser, isIncognito, isMobile, isSamsungBrowser, isIos, } = env;
4
4
  const mightFail = getMightFail({
5
+ supportIncognito,
5
6
  idpHasAppCertification,
6
7
  isMobile,
7
8
  isIncognito,
@@ -19,17 +20,17 @@ export const getCompatibility = (env) => {
19
20
  };
20
21
  };
21
22
  export const getMightFail = (env) => {
22
- const { idpHasAppCertification, isMobile, isIncognito, isAndroid, isChromeBrowser, isSamsungBrowser, isIos } = env;
23
+ const { supportIncognito, idpHasAppCertification, isMobile, isIncognito, isAndroid, isChromeBrowser, isSamsungBrowser, isIos, } = env;
23
24
  if (!idpHasAppCertification || !isMobile) {
24
25
  return false;
25
26
  }
26
- if (isIncognito && isAndroid && isChromeBrowser) {
27
+ if (!supportIncognito && isIncognito && isAndroid && isChromeBrowser) {
27
28
  return true;
28
29
  }
29
30
  if (isAndroid && isSamsungBrowser) {
30
31
  return true;
31
32
  }
32
- if (isIncognito && isIos) {
33
+ if (!supportIncognito && isIncognito && isIos) {
33
34
  return true;
34
35
  }
35
36
  return false;
package/{compability.test.js → compatibility.test.js} RENAMED
@@ -4,6 +4,7 @@ import { getCompatibility, getMightFail } from './compatibility';
4
4
  describe('getCompatibility', () => {
5
5
  it('should return compatibility warnings', () => {
6
6
  const compatibility = getCompatibility({
7
+ supportIncognito: false,
7
8
  idpHasAppCertification: true,
8
9
  isMobile: true,
9
10
  isIncognito: false,
@@ -17,13 +18,14 @@ describe('getCompatibility', () => {
17
18
  isIncognito: false,
18
19
  mobileOs: 'other',
19
20
  browser: 'other',
20
- mightFail: false
21
+ mightFail: false,
21
22
  });
22
23
  });
23
24
  });
24
25
  describe('getMightFail', () => {
25
26
  it('should return false when idpHasAppCertification is false', () => {
26
27
  const mightFail = getMightFail({
28
+ supportIncognito: false,
27
29
  idpHasAppCertification: false,
28
30
  isMobile: true,
29
31
  isIncognito: false,
@@ -36,6 +38,7 @@ describe('getMightFail', () => {
36
38
  });
37
39
  it('should return false when isMobile is false', () => {
38
40
  const mightFail = getMightFail({
41
+ supportIncognito: false,
39
42
  idpHasAppCertification: true,
40
43
  isMobile: false,
41
44
  isIncognito: false,
@@ -46,8 +49,9 @@ describe('getMightFail', () => {
46
49
  });
47
50
  assert.ok(mightFail === false);
48
51
  });
49
- it('should return true when isIncognito is true, isAndroid is true, and isChromeBrowser is true', () => {
52
+ it('should return true when does not support incognito and settings are incognito/android/chrome', () => {
50
53
  const mightFail = getMightFail({
54
+ supportIncognito: false,
51
55
  idpHasAppCertification: true,
52
56
  isMobile: true,
53
57
  isIncognito: true,
@@ -58,8 +62,22 @@ describe('getMightFail', () => {
58
62
  });
59
63
  assert.ok(mightFail === true);
60
64
  });
61
- it('should return true when isAndroid is true and isSamsungBrowser is true', () => {
65
+ it('should return false when supports incognito and settings are incognito/android/chrome', () => {
62
66
  const mightFail = getMightFail({
67
+ supportIncognito: true,
68
+ idpHasAppCertification: true,
69
+ isMobile: true,
70
+ isIncognito: true,
71
+ isAndroid: true,
72
+ isIos: false,
73
+ isSamsungBrowser: false,
74
+ isChromeBrowser: true,
75
+ });
76
+ assert.ok(mightFail === false);
77
+ });
78
+ it('should return true when android/samsung', () => {
79
+ const mightFail = getMightFail({
80
+ supportIncognito: false,
63
81
  idpHasAppCertification: true,
64
82
  isMobile: true,
65
83
  isIncognito: false,
@@ -70,8 +88,9 @@ describe('getMightFail', () => {
70
88
  });
71
89
  assert.ok(mightFail === true);
72
90
  });
73
- it('should return true when isIncognito is true and isIos is true', () => {
91
+ it('should return true when does not support incognito and settings are incognito/ios', () => {
74
92
  const mightFail = getMightFail({
93
+ supportIncognito: false,
75
94
  idpHasAppCertification: true,
76
95
  isMobile: true,
77
96
  isIncognito: true,
@@ -82,8 +101,22 @@ describe('getMightFail', () => {
82
101
  });
83
102
  assert.ok(mightFail === true);
84
103
  });
104
+ it('should return false when supports incognito and settings are incognito/ios', () => {
105
+ const mightFail = getMightFail({
106
+ supportIncognito: true,
107
+ idpHasAppCertification: true,
108
+ isMobile: true,
109
+ isIncognito: true,
110
+ isAndroid: false,
111
+ isIos: true,
112
+ isSamsungBrowser: false,
113
+ isChromeBrowser: false,
114
+ });
115
+ assert.ok(mightFail === false);
116
+ });
85
117
  it('should return false when none of the conditions are met', () => {
86
118
  const mightFail = getMightFail({
119
+ supportIncognito: false,
87
120
  idpHasAppCertification: true,
88
121
  isMobile: true,
89
122
  isIncognito: false,
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@connectid-tools/idp-selector-react",
3
- "version": "6.10.0-alpha.2",
3
+ "version": "6.10.0-alpha.3",
4
4
  "description": "React component for IDP Selector.",
5
5
  "main": "index.js",
6
6
  "type": "module",
package/types.d.ts CHANGED
@@ -39,6 +39,7 @@ export type CidButtonTypeConfig = {
39
39
  hasLearnMore: boolean;
40
40
  };
41
41
  export type CompatibilityEnvironment = {
42
+ supportIncognito: boolean;
42
43
  isMobile: boolean;
43
44
  isIncognito: boolean;
44
45
  idpHasAppCertification: boolean;