@sudoplatform/sudo-privacy-interaction 2.3.0 → 2.5.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.
Files changed (105) hide show
  1. package/cjs/gen/graphqlTypes.js +308 -1
  2. package/cjs/private/data/action/defaultActionService.js +8 -0
  3. package/cjs/private/data/action/transformer/actionIntentTransformer.js +32 -0
  4. package/cjs/private/data/action/transformer/availableActionTransformer.js +8 -0
  5. package/cjs/private/data/analysis-result/defaultAnalysisResultService.js +6 -0
  6. package/cjs/private/data/analysis-result/transformer/analysisResultStatusReasonTransformer.js +45 -0
  7. package/cjs/private/data/analysis-result/transformer/analysisResultTransformer.js +6 -0
  8. package/cjs/private/data/common/apiClient.js +21 -0
  9. package/cjs/private/data/organization-analysis/transformer/organizationAnalysisTransformer.js +6 -0
  10. package/cjs/private/data/virtual-presence/defaultVirtualPresenceService.js +4 -0
  11. package/cjs/private/domain/entities/action/actionEntity.js +14 -0
  12. package/cjs/private/domain/entities/analysis-result/analysisResultEntity.js +20 -1
  13. package/cjs/private/domain/use-cases/action/listActionsForDataHolderUseCase.js +26 -0
  14. package/cjs/private/domain/use-cases/virtual-presence/refreshVirtualPresenceStateUseCase.js +25 -0
  15. package/cjs/public/defaultSudoPrivacyInteractionClient.js +23 -1
  16. package/cjs/public/typings/action.js +14 -0
  17. package/cjs/public/typings/analysisResult.js +20 -1
  18. package/docs/assets/hierarchy.js +1 -1
  19. package/docs/assets/navigation.js +1 -1
  20. package/docs/assets/search.js +1 -1
  21. package/docs/classes/DefaultSudoPrivacyInteractionClient.html +77 -29
  22. package/docs/enums/ActionFulfilmentMethod.html +3 -3
  23. package/docs/enums/ActionIntent.html +31 -7
  24. package/docs/enums/ActionOrigin.html +5 -5
  25. package/docs/enums/ActionStatus.html +9 -9
  26. package/docs/enums/AnalysisResultStatus.html +6 -6
  27. package/docs/enums/AnalysisResultStatusReason.html +81 -0
  28. package/docs/enums/DataCategory.html +18 -18
  29. package/docs/enums/OrganizationAnalysisDomainResolution.html +3 -3
  30. package/docs/enums/OrganizationAnalysisMode.html +3 -3
  31. package/docs/enums/OrganizationCategory.html +31 -31
  32. package/docs/enums/RetentionStyle.html +5 -5
  33. package/docs/enums/ShareStyle.html +6 -6
  34. package/docs/enums/SignalValue.html +4 -4
  35. package/docs/hierarchy.html +7 -6
  36. package/docs/interfaces/Action.html +15 -15
  37. package/docs/interfaces/ActionContact.html +4 -4
  38. package/docs/interfaces/AnalysisResult.html +21 -13
  39. package/docs/interfaces/AnalysisResultData.html +8 -8
  40. package/docs/interfaces/AnalysisResultUpdate.html +20 -12
  41. package/docs/interfaces/AssistedEmailTemplate.html +3 -3
  42. package/docs/interfaces/AssistedPayload.html +8 -8
  43. package/docs/interfaces/AvailableAction.html +20 -9
  44. package/docs/interfaces/CapabilitySignals.html +10 -10
  45. package/docs/interfaces/CategorySignals.html +11 -11
  46. package/docs/interfaces/InitiateActionInput.html +4 -4
  47. package/docs/interfaces/ListActionsForDataHolderInput.html +85 -0
  48. package/docs/interfaces/ListAnalysisResultsInput.html +1 -1
  49. package/docs/interfaces/ListAvailableActionsInput.html +14 -4
  50. package/docs/interfaces/ListDataHolderScanSummariesInput.html +1 -1
  51. package/docs/interfaces/ListDataHoldersInput.html +1 -1
  52. package/docs/interfaces/ListVirtualPresencesInput.html +1 -1
  53. package/docs/interfaces/OrganizationAnalysis.html +20 -12
  54. package/docs/interfaces/OrganizationIdentity.html +5 -5
  55. package/docs/interfaces/Pagination.html +2 -1
  56. package/docs/interfaces/PrivacyScore.html +4 -4
  57. package/docs/interfaces/PrivacySummary.html +4 -4
  58. package/docs/interfaces/RetentionInfo.html +4 -4
  59. package/docs/interfaces/RiskIndicators.html +8 -8
  60. package/docs/interfaces/ScoreContribution.html +3 -3
  61. package/docs/interfaces/ScoreCoverage.html +3 -3
  62. package/docs/interfaces/SudoPrivacyInteractionClient.html +75 -29
  63. package/docs/modules.html +4 -4
  64. package/docs/types/SudoPrivacyInteractionClientOptions.html +2 -2
  65. package/lib/gen/graphqlTypes.js +307 -0
  66. package/lib/private/data/action/defaultActionService.js +8 -0
  67. package/lib/private/data/action/transformer/actionIntentTransformer.js +32 -0
  68. package/lib/private/data/action/transformer/availableActionTransformer.js +8 -0
  69. package/lib/private/data/analysis-result/defaultAnalysisResultService.js +6 -0
  70. package/lib/private/data/analysis-result/transformer/analysisResultStatusReasonTransformer.js +41 -0
  71. package/lib/private/data/analysis-result/transformer/analysisResultTransformer.js +6 -0
  72. package/lib/private/data/common/apiClient.js +22 -1
  73. package/lib/private/data/organization-analysis/transformer/organizationAnalysisTransformer.js +6 -0
  74. package/lib/private/data/virtual-presence/defaultVirtualPresenceService.js +4 -0
  75. package/lib/private/domain/entities/action/actionEntity.js +14 -0
  76. package/lib/private/domain/entities/analysis-result/analysisResultEntity.js +19 -0
  77. package/lib/private/domain/use-cases/action/listActionsForDataHolderUseCase.js +22 -0
  78. package/lib/private/domain/use-cases/virtual-presence/refreshVirtualPresenceStateUseCase.js +21 -0
  79. package/lib/public/defaultSudoPrivacyInteractionClient.js +23 -1
  80. package/lib/public/typings/action.js +14 -0
  81. package/lib/public/typings/analysisResult.js +19 -0
  82. package/package.json +6 -1
  83. package/types/gen/graphqlTypes.d.ts +78 -1
  84. package/types/gen/schema-types.d.ts +39 -2
  85. package/types/private/data/action/defaultActionService.d.ts +2 -1
  86. package/types/private/data/action/transformer/availableActionTransformer.d.ts +1 -0
  87. package/types/private/data/analysis-result/defaultAnalysisResultService.d.ts +1 -0
  88. package/types/private/data/analysis-result/transformer/analysisResultStatusReasonTransformer.d.ts +12 -0
  89. package/types/private/data/analysis-result/transformer/analysisResultTransformer.d.ts +1 -0
  90. package/types/private/data/common/apiClient.d.ts +8 -1
  91. package/types/private/data/organization-analysis/transformer/organizationAnalysisTransformer.d.ts +1 -0
  92. package/types/private/data/virtual-presence/defaultVirtualPresenceService.d.ts +1 -0
  93. package/types/private/domain/entities/action/actionEntity.d.ts +18 -0
  94. package/types/private/domain/entities/action/actionService.d.ts +36 -0
  95. package/types/private/domain/entities/analysis-result/analysisResultEntity.d.ts +20 -0
  96. package/types/private/domain/entities/organization-analysis/organizationAnalysisEntity.d.ts +3 -1
  97. package/types/private/domain/entities/virtual-presence/virtualPresenceService.d.ts +11 -1
  98. package/types/private/domain/use-cases/action/listActionsForDataHolderUseCase.d.ts +16 -0
  99. package/types/private/domain/use-cases/virtual-presence/refreshVirtualPresenceStateUseCase.d.ts +16 -0
  100. package/types/public/defaultSudoPrivacyInteractionClient.d.ts +3 -1
  101. package/types/public/inputs/action.d.ts +16 -0
  102. package/types/public/sudoPrivacyInteractionClient.d.ts +23 -1
  103. package/types/public/typings/action.d.ts +19 -0
  104. package/types/public/typings/analysisResult.d.ts +22 -0
  105. package/types/public/typings/organizationAnalysis.d.ts +3 -1
@@ -4,15 +4,19 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
  import { AnalysisResultDataTransformer } from '../../analysis-result/transformer/analysisResultDataTransformer';
7
+ import { AnalysisResultStatusReasonTransformer } from '../../analysis-result/transformer/analysisResultStatusReasonTransformer';
7
8
  import { AnalysisResultStatusTransformer } from '../../analysis-result/transformer/analysisResultStatusTransformer';
8
9
  export class OrganizationAnalysisTransformer {
9
10
  statusTransformer = new AnalysisResultStatusTransformer();
11
+ statusReasonTransformer = new AnalysisResultStatusReasonTransformer();
10
12
  dataTransformer = new AnalysisResultDataTransformer();
11
13
  fromGraphQLToEntity(data) {
14
+ const statusReason = this.statusReasonTransformer.fromGraphQLToEntity(data.statusReason);
12
15
  return {
13
16
  id: data.id,
14
17
  domain: data.domain,
15
18
  status: this.statusTransformer.fromGraphQLToEntity(data.status),
19
+ ...(statusReason !== undefined && { statusReason }),
16
20
  lastAnalyzedAt: new Date(data.lastAnalyzedAtEpochMs),
17
21
  data: data.data
18
22
  ? this.dataTransformer.fromGraphQLToEntity(data.data)
@@ -24,10 +28,12 @@ export class OrganizationAnalysisTransformer {
24
28
  };
25
29
  }
26
30
  fromEntityToAPI(entity) {
31
+ const statusReason = this.statusReasonTransformer.fromEntityToAPI(entity.statusReason);
27
32
  return {
28
33
  id: entity.id,
29
34
  domain: entity.domain,
30
35
  status: this.statusTransformer.fromEntityToAPI(entity.status),
36
+ ...(statusReason !== undefined && { statusReason }),
31
37
  lastAnalyzedAt: entity.lastAnalyzedAt,
32
38
  data: entity.data
33
39
  ? this.dataTransformer.fromEntityToAPI(entity.data)
@@ -48,6 +48,10 @@ export class DefaultVirtualPresenceService {
48
48
  const result = await this.appSync.disconnectVirtualPresence(id);
49
49
  return this.virtualPresenceTransformer.fromGraphQLToEntity(result);
50
50
  }
51
+ async refreshState(id) {
52
+ const result = await this.appSync.refreshVirtualPresenceState(id);
53
+ return this.virtualPresenceTransformer.fromGraphQLToEntity(result);
54
+ }
51
55
  async subscribe(input) {
52
56
  this.subscriptionManager.subscribe(input.subscriptionId, input.subscriber);
53
57
  if (!this.subscriptionManager.getWatcher()) {
@@ -15,6 +15,16 @@
15
15
  * @property AccessMyData Data subject access / portability request.
16
16
  * @property DeleteMyData Account deletion / data erasure.
17
17
  * @property LimitDataUse Opt out of sale / tracking, manage consent.
18
+ * @property SwapEmail The user has replaced the account's email with a private
19
+ * email. Always available for an email presence; self-reported.
20
+ * @property SwapPhone The user has replaced the account's phone number with a
21
+ * private number. Offered only when a signal indicates the data holder holds
22
+ * the user's phone number.
23
+ * @property SwapVirtualCard The user has replaced the account's payment card
24
+ * with a virtual card. Offered only when the data holder is identified as
25
+ * collecting credit card data.
26
+ * @property SaveInPassword The user has saved this account in a password
27
+ * manager. Offered only when the data holder supports account creation.
18
28
  * @property Other Anything unmapped; carries additionalInfo.
19
29
  *
20
30
  * @enum
@@ -25,6 +35,10 @@ export var ActionIntentEntity;
25
35
  ActionIntentEntity["AccessMyData"] = "ACCESS_MY_DATA";
26
36
  ActionIntentEntity["DeleteMyData"] = "DELETE_MY_DATA";
27
37
  ActionIntentEntity["LimitDataUse"] = "LIMIT_DATA_USE";
38
+ ActionIntentEntity["SwapEmail"] = "SWAP_EMAIL";
39
+ ActionIntentEntity["SwapPhone"] = "SWAP_PHONE";
40
+ ActionIntentEntity["SwapVirtualCard"] = "SWAP_VIRTUAL_CARD";
41
+ ActionIntentEntity["SaveInPassword"] = "SAVE_IN_PASSWORD";
28
42
  ActionIntentEntity["Other"] = "OTHER";
29
43
  })(ActionIntentEntity || (ActionIntentEntity = {}));
30
44
  /**
@@ -22,6 +22,25 @@ export var AnalysisResultStatusEntity;
22
22
  AnalysisResultStatusEntity["Failed"] = "FAILED";
23
23
  AnalysisResultStatusEntity["Unavailable"] = "UNAVAILABLE";
24
24
  })(AnalysisResultStatusEntity || (AnalysisResultStatusEntity = {}));
25
+ /**
26
+ * The reason explaining an analysis result's status.
27
+ *
28
+ * @property INVALID_DOMAIN The requested domain was not a valid analyzable domain.
29
+ * @property POLICY_UNAVAILABLE No privacy policy could be located for the organization.
30
+ * @property MALICIOUS The domain was identified as malicious.
31
+ * @property NOT_ATTEMPTED Analysis was not attempted for the domain.
32
+ * @property OTHER A reason that does not fit the other categories.
33
+ *
34
+ * @enum
35
+ */
36
+ export var AnalysisResultStatusReasonEntity;
37
+ (function (AnalysisResultStatusReasonEntity) {
38
+ AnalysisResultStatusReasonEntity["InvalidDomain"] = "INVALID_DOMAIN";
39
+ AnalysisResultStatusReasonEntity["PolicyUnavailable"] = "POLICY_UNAVAILABLE";
40
+ AnalysisResultStatusReasonEntity["Malicious"] = "MALICIOUS";
41
+ AnalysisResultStatusReasonEntity["NotAttempted"] = "NOT_ATTEMPTED";
42
+ AnalysisResultStatusReasonEntity["Other"] = "OTHER";
43
+ })(AnalysisResultStatusReasonEntity || (AnalysisResultStatusReasonEntity = {}));
25
44
  /**
26
45
  * Tri-state signal value representing confidence in a determination.
27
46
  *
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
3
+ *
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { DefaultLogger } from '@sudoplatform/sudo-common';
7
+ /**
8
+ * Application business logic for listing the persisted action history for a data
9
+ * holder.
10
+ */
11
+ export class ListActionsForDataHolderUseCase {
12
+ actionService;
13
+ log;
14
+ constructor(actionService) {
15
+ this.actionService = actionService;
16
+ this.log = new DefaultLogger(this.constructor.name);
17
+ }
18
+ async execute(input) {
19
+ this.log.debug(this.constructor.name, { input });
20
+ return await this.actionService.listForDataHolder(input);
21
+ }
22
+ }
@@ -0,0 +1,21 @@
1
+ /**
2
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
3
+ *
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { DefaultLogger } from '@sudoplatform/sudo-common';
7
+ /**
8
+ * Application business logic for refreshing a virtual presence's state.
9
+ */
10
+ export class RefreshVirtualPresenceStateUseCase {
11
+ virtualPresenceService;
12
+ log;
13
+ constructor(virtualPresenceService) {
14
+ this.virtualPresenceService = virtualPresenceService;
15
+ this.log = new DefaultLogger(this.constructor.name);
16
+ }
17
+ async execute(id) {
18
+ this.log.debug(this.constructor.name, { id });
19
+ return await this.virtualPresenceService.refreshState(id);
20
+ }
21
+ }
@@ -28,6 +28,7 @@ import { GetAnalysisResultUseCase } from '../private/domain/use-cases/analysis-r
28
28
  import { ConfirmActionOutcomeUseCase } from '../private/domain/use-cases/action/confirmActionOutcomeUseCase';
29
29
  import { GetActionUseCase } from '../private/domain/use-cases/action/getActionUseCase';
30
30
  import { InitiateActionUseCase } from '../private/domain/use-cases/action/initiateActionUseCase';
31
+ import { ListActionsForDataHolderUseCase } from '../private/domain/use-cases/action/listActionsForDataHolderUseCase';
31
32
  import { ListAvailableActionsUseCase } from '../private/domain/use-cases/action/listAvailableActionsUseCase';
32
33
  import { SubscribeToActionUseCase } from '../private/domain/use-cases/action/subscribeToActionUseCase';
33
34
  import { UnsubscribeFromActionUseCase } from '../private/domain/use-cases/action/unsubscribeFromActionUseCase';
@@ -47,6 +48,7 @@ import { ConnectVirtualPresenceWithAuthCodeUseCase } from '../private/domain/use
47
48
  import { ConnectVirtualPresenceWithRefreshTokenUseCase } from '../private/domain/use-cases/virtual-presence/connectVirtualPresenceWithRefreshTokenUseCase';
48
49
  import { DisconnectVirtualPresenceUseCase } from '../private/domain/use-cases/virtual-presence/disconnectVirtualPresenceUseCase';
49
50
  import { ListVirtualPresencesUseCase } from '../private/domain/use-cases/virtual-presence/listVirtualPresencesUseCase';
51
+ import { RefreshVirtualPresenceStateUseCase } from '../private/domain/use-cases/virtual-presence/refreshVirtualPresenceStateUseCase';
50
52
  import { RescanVirtualPresenceUseCase } from '../private/domain/use-cases/virtual-presence/rescanVirtualPresenceUseCase';
51
53
  import { SubscribeToVirtualPresenceUseCase } from '../private/domain/use-cases/virtual-presence/subscribeToVirtualPresenceUseCase';
52
54
  import { UnsubscribeFromVirtualPresenceUseCase } from '../private/domain/use-cases/virtual-presence/unsubscribeFromVirtualPresenceUseCase';
@@ -148,6 +150,12 @@ export class DefaultSudoPrivacyInteractionClient {
148
150
  const result = await useCase.execute(input);
149
151
  return this.virtualPresenceTransformer.fromEntityToAPI(result);
150
152
  }
153
+ async refreshVirtualPresenceState(id) {
154
+ this.log.debug(this.refreshVirtualPresenceState.name, { id });
155
+ const useCase = new RefreshVirtualPresenceStateUseCase(this.virtualPresenceService);
156
+ const result = await useCase.execute(id);
157
+ return this.virtualPresenceTransformer.fromEntityToAPI(result);
158
+ }
151
159
  async listVirtualPresences(input) {
152
160
  this.log.debug(this.listVirtualPresences.name, {
153
161
  input,
@@ -337,10 +345,24 @@ export class DefaultSudoPrivacyInteractionClient {
337
345
  async listAvailableActions(input) {
338
346
  this.log.debug(this.listAvailableActions.name, { input });
339
347
  const useCase = new ListAvailableActionsUseCase(this.actionService);
340
- const { availableActions, nextToken: resultNextToken } = await useCase.execute({ dataHolderId: input.dataHolderId });
348
+ const { availableActions, nextToken: resultNextToken } = await useCase.execute({
349
+ dataHolderId: input.dataHolderId,
350
+ includeCompleted: input.includeCompleted,
351
+ });
341
352
  const transformedAvailableActions = availableActions.map((availableAction) => this.availableActionTransformer.fromEntityToAPI(availableAction));
342
353
  return { items: transformedAvailableActions, nextToken: resultNextToken };
343
354
  }
355
+ async listActionsForDataHolder(input) {
356
+ this.log.debug(this.listActionsForDataHolder.name, { input });
357
+ const useCase = new ListActionsForDataHolderUseCase(this.actionService);
358
+ const { actions, nextToken: resultNextToken } = await useCase.execute({
359
+ dataHolderId: input.dataHolderId,
360
+ limit: input.limit,
361
+ nextToken: input.nextToken,
362
+ });
363
+ const transformedActions = actions.map((action) => this.actionTransformer.fromEntityToAPI(action));
364
+ return { items: transformedActions, nextToken: resultNextToken };
365
+ }
344
366
  async subscribeToActions(subscriptionId, subscriber) {
345
367
  this.log.debug(this.subscribeToActions.name, {
346
368
  subscriptionId,
@@ -14,6 +14,16 @@
14
14
  * @property ACCESS_MY_DATA Data subject access / portability request.
15
15
  * @property DELETE_MY_DATA Account deletion / data erasure.
16
16
  * @property LIMIT_DATA_USE Opt out of sale / tracking, manage consent.
17
+ * @property SWAP_EMAIL The user has replaced the account's email with a private
18
+ * email. Always available for an email presence; self-reported.
19
+ * @property SWAP_PHONE The user has replaced the account's phone number with a
20
+ * private number. Offered only when a signal indicates the data holder holds
21
+ * the user's phone number.
22
+ * @property SWAP_VIRTUAL_CARD The user has replaced the account's payment card
23
+ * with a virtual card. Offered only when the data holder is identified as
24
+ * collecting credit card data.
25
+ * @property SAVE_IN_PASSWORD The user has saved this account in a password
26
+ * manager. Offered only when the data holder supports account creation.
17
27
  * @property OTHER Anything unmapped; carries additionalInfo.
18
28
  *
19
29
  * @enum
@@ -24,6 +34,10 @@ export var ActionIntent;
24
34
  ActionIntent["AccessMyData"] = "ACCESS_MY_DATA";
25
35
  ActionIntent["DeleteMyData"] = "DELETE_MY_DATA";
26
36
  ActionIntent["LimitDataUse"] = "LIMIT_DATA_USE";
37
+ ActionIntent["SwapEmail"] = "SWAP_EMAIL";
38
+ ActionIntent["SwapPhone"] = "SWAP_PHONE";
39
+ ActionIntent["SwapVirtualCard"] = "SWAP_VIRTUAL_CARD";
40
+ ActionIntent["SaveInPassword"] = "SAVE_IN_PASSWORD";
27
41
  ActionIntent["Other"] = "OTHER";
28
42
  })(ActionIntent || (ActionIntent = {}));
29
43
  /**
@@ -22,6 +22,25 @@ export var AnalysisResultStatus;
22
22
  AnalysisResultStatus["Failed"] = "FAILED";
23
23
  AnalysisResultStatus["Unavailable"] = "UNAVAILABLE";
24
24
  })(AnalysisResultStatus || (AnalysisResultStatus = {}));
25
+ /**
26
+ * The reason explaining an analysis result's status.
27
+ *
28
+ * @property INVALID_DOMAIN The requested domain was not a valid analyzable domain.
29
+ * @property POLICY_UNAVAILABLE No privacy policy could be located for the organization.
30
+ * @property MALICIOUS The domain was identified as malicious.
31
+ * @property NOT_ATTEMPTED Analysis was not attempted for the domain.
32
+ * @property OTHER A reason that does not fit the other categories.
33
+ *
34
+ * @enum
35
+ */
36
+ export var AnalysisResultStatusReason;
37
+ (function (AnalysisResultStatusReason) {
38
+ AnalysisResultStatusReason["InvalidDomain"] = "INVALID_DOMAIN";
39
+ AnalysisResultStatusReason["PolicyUnavailable"] = "POLICY_UNAVAILABLE";
40
+ AnalysisResultStatusReason["Malicious"] = "MALICIOUS";
41
+ AnalysisResultStatusReason["NotAttempted"] = "NOT_ATTEMPTED";
42
+ AnalysisResultStatusReason["Other"] = "OTHER";
43
+ })(AnalysisResultStatusReason || (AnalysisResultStatusReason = {}));
25
44
  /**
26
45
  * Tri-state signal value representing confidence in a determination.
27
46
  *
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@sudoplatform/sudo-privacy-interaction",
3
- "version": "2.3.0",
3
+ "version": "2.5.0",
4
4
  "author": "Anonyome Labs, Inc.",
5
5
  "license": "Apache-2.0",
6
6
  "repository": {
@@ -115,6 +115,11 @@
115
115
  "until": 1795224255,
116
116
  "untilISO": "2026-11-21T01:24:15Z",
117
117
  "reason": "markdown-it fix too new"
118
+ },
119
+ "1244623": {
120
+ "until": 1796479200,
121
+ "untilISO": "2026-12-06T00:00:00Z",
122
+ "reason": "minimatch 10.2.6 pulled in by typedoc (latest stable 0.28.20); typedoc requires minimatch 10.x and is incompatible with 11.x. Dev/build-time docs tool only, not shipped at runtime"
118
123
  }
119
124
  }
120
125
  }
@@ -11,10 +11,11 @@ export type Incremental<T> = T | {
11
11
  import { TypedDocumentNode as DocumentNode } from '@graphql-typed-document-node/core';
12
12
  export * from './schema-types';
13
13
  export type ActionFulfilmentMethod = 'ASSISTED' | 'DELEGATED' | '%future added value';
14
- export type ActionIntent = 'ACCESS_MY_DATA' | 'DELETE_MY_DATA' | 'LIMIT_DATA_USE' | 'OTHER' | 'STOP_CONTACT' | '%future added value';
14
+ export type ActionIntent = 'ACCESS_MY_DATA' | 'DELETE_MY_DATA' | 'LIMIT_DATA_USE' | 'OTHER' | 'SAVE_IN_PASSWORD' | 'STOP_CONTACT' | 'SWAP_EMAIL' | 'SWAP_PHONE' | 'SWAP_VIRTUAL_CARD' | '%future added value';
15
15
  export type ActionOrigin = 'ANALYSIS' | 'DISCOVERY' | 'STATIC' | '%future added value';
16
16
  export type ActionStatus = 'COMPLETED_UNVERIFIED' | 'COMPLETED_VERIFIED' | 'CONTRADICTED' | 'FAILED' | 'IN_PROGRESS' | 'PENDING' | 'REQUIRES_USER_INPUT' | '%future added value';
17
17
  export type AnalysisResultStatus = 'COMPLETE' | 'FAILED' | 'PARTIAL' | 'PENDING' | 'UNAVAILABLE' | '%future added value';
18
+ export type AnalysisResultStatusReason = 'INVALID_DOMAIN' | 'MALICIOUS' | 'NOT_ATTEMPTED' | 'OTHER' | 'POLICY_UNAVAILABLE' | '%future added value';
18
19
  export type AuthCodeInput = {
19
20
  authCode: string;
20
21
  redirectUri?: string | null | undefined;
@@ -99,6 +100,7 @@ export type AvailableActionFieldsFragment = {
99
100
  origin: ActionOrigin;
100
101
  title: string | null;
101
102
  description: string | null;
103
+ status: ActionStatus | null;
102
104
  };
103
105
  export type AnalysisResultDataFieldsFragment = {
104
106
  attribution: Array<string>;
@@ -165,6 +167,7 @@ export type AnalysisResultFieldsFragment = {
165
167
  virtualPresenceId: string;
166
168
  dataHolderIdentifier: string;
167
169
  status: AnalysisResultStatus;
170
+ statusReason: AnalysisResultStatusReason | null;
168
171
  lastAnalyzedAtEpochMs: number;
169
172
  owner: string;
170
173
  version: number;
@@ -263,6 +266,7 @@ export type OrganizationAnalysisFieldsFragment = {
263
266
  id: string;
264
267
  domain: string;
265
268
  status: AnalysisResultStatus;
269
+ statusReason: AnalysisResultStatusReason | null;
266
270
  lastAnalyzedAtEpochMs: number;
267
271
  owner: string;
268
272
  version: number;
@@ -421,6 +425,30 @@ export type RescanVirtualPresenceMutation = {
421
425
  };
422
426
  };
423
427
  };
428
+ export type RefreshVirtualPresenceStateMutationVariables = Exact<{
429
+ id: string;
430
+ }>;
431
+ export type RefreshVirtualPresenceStateMutation = {
432
+ refreshVirtualPresenceState: {
433
+ id: string;
434
+ providerType: ProviderType;
435
+ identifier: string;
436
+ state: VirtualPresenceState;
437
+ lastScannedAtEpochMs: number;
438
+ lastScanFailureReason: string | null;
439
+ owner: string;
440
+ version: number;
441
+ createdAtEpochMs: number;
442
+ updatedAtEpochMs: number;
443
+ dataHolderCount: {
444
+ count: number;
445
+ monitored: number;
446
+ initiatedActions: number;
447
+ completedActions: number;
448
+ archived: number;
449
+ };
450
+ };
451
+ };
424
452
  export type InitiateActionMutationVariables = Exact<{
425
453
  input: InitiateActionInput;
426
454
  }>;
@@ -614,6 +642,7 @@ export type GetAnalysisResultQuery = {
614
642
  virtualPresenceId: string;
615
643
  dataHolderIdentifier: string;
616
644
  status: AnalysisResultStatus;
645
+ statusReason: AnalysisResultStatusReason | null;
617
646
  lastAnalyzedAtEpochMs: number;
618
647
  owner: string;
619
648
  version: number;
@@ -691,6 +720,7 @@ export type GetOrganizationAnalysisQuery = {
691
720
  id: string;
692
721
  domain: string;
693
722
  status: AnalysisResultStatus;
723
+ statusReason: AnalysisResultStatusReason | null;
694
724
  lastAnalyzedAtEpochMs: number;
695
725
  owner: string;
696
726
  version: number;
@@ -771,6 +801,7 @@ export type ListAnalysisResultsQuery = {
771
801
  virtualPresenceId: string;
772
802
  dataHolderIdentifier: string;
773
803
  status: AnalysisResultStatus;
804
+ statusReason: AnalysisResultStatusReason | null;
774
805
  lastAnalyzedAtEpochMs: number;
775
806
  owner: string;
776
807
  version: number;
@@ -866,6 +897,7 @@ export type ListDataHolderScanSummariesQuery = {
866
897
  };
867
898
  export type ListAvailableActionsQueryVariables = Exact<{
868
899
  dataHolderId: string | number;
900
+ includeCompleted?: boolean | null | undefined;
869
901
  }>;
870
902
  export type ListAvailableActionsQuery = {
871
903
  listAvailableActions: {
@@ -877,6 +909,48 @@ export type ListAvailableActionsQuery = {
877
909
  origin: ActionOrigin;
878
910
  title: string | null;
879
911
  description: string | null;
912
+ status: ActionStatus | null;
913
+ }>;
914
+ };
915
+ };
916
+ export type ListActionsForDataHolderQueryVariables = Exact<{
917
+ dataHolderId: string | number;
918
+ limit?: number | null | undefined;
919
+ nextToken?: string | null | undefined;
920
+ }>;
921
+ export type ListActionsForDataHolderQuery = {
922
+ listActionsForDataHolder: {
923
+ nextToken: string | null;
924
+ items: Array<{
925
+ id: string;
926
+ virtualPresenceId: string;
927
+ dataHolderId: string | null;
928
+ intent: ActionIntent;
929
+ additionalInfo: string | null;
930
+ fulfilmentMethod: ActionFulfilmentMethod;
931
+ status: ActionStatus;
932
+ initiatedAtEpochMs: number | null;
933
+ completedAtEpochMs: number | null;
934
+ owner: string;
935
+ version: number;
936
+ createdAtEpochMs: number;
937
+ updatedAtEpochMs: number;
938
+ assistedPayload: {
939
+ toAddress: string | null;
940
+ unsubscribeUrl: string | null;
941
+ unsubscribeMailto: string | null;
942
+ jurisdiction: string | null;
943
+ instructions: string | null;
944
+ contact: {
945
+ email: string | null;
946
+ phone: string | null;
947
+ address: string | null;
948
+ } | null;
949
+ emailTemplate: {
950
+ subject: string | null;
951
+ body: string;
952
+ } | null;
953
+ } | null;
880
954
  }>;
881
955
  };
882
956
  };
@@ -970,6 +1044,7 @@ export type OnAnalysisResultUpdateSubscription = {
970
1044
  virtualPresenceId: string;
971
1045
  dataHolderIdentifier: string;
972
1046
  status: AnalysisResultStatus;
1047
+ statusReason: AnalysisResultStatusReason | null;
973
1048
  lastAnalyzedAtEpochMs: number;
974
1049
  owner: string;
975
1050
  version: number;
@@ -1008,6 +1083,7 @@ export declare const VirtualPresenceFieldsFragmentDoc: DocumentNode<VirtualPrese
1008
1083
  export declare const ConnectVirtualPresenceDocument: DocumentNode<ConnectVirtualPresenceMutation, ConnectVirtualPresenceMutationVariables>;
1009
1084
  export declare const DisconnectVirtualPresenceDocument: DocumentNode<DisconnectVirtualPresenceMutation, DisconnectVirtualPresenceMutationVariables>;
1010
1085
  export declare const RescanVirtualPresenceDocument: DocumentNode<RescanVirtualPresenceMutation, RescanVirtualPresenceMutationVariables>;
1086
+ export declare const RefreshVirtualPresenceStateDocument: DocumentNode<RefreshVirtualPresenceStateMutation, RefreshVirtualPresenceStateMutationVariables>;
1011
1087
  export declare const InitiateActionDocument: DocumentNode<InitiateActionMutation, InitiateActionMutationVariables>;
1012
1088
  export declare const ConfirmActionOutcomeDocument: DocumentNode<ConfirmActionOutcomeMutation, ConfirmActionOutcomeMutationVariables>;
1013
1089
  export declare const ArchiveDataHolderDocument: DocumentNode<ArchiveDataHolderMutation, ArchiveDataHolderMutationVariables>;
@@ -1021,6 +1097,7 @@ export declare const GetOrganizationAnalysisDocument: DocumentNode<GetOrganizati
1021
1097
  export declare const ListAnalysisResultsDocument: DocumentNode<ListAnalysisResultsQuery, ListAnalysisResultsQueryVariables>;
1022
1098
  export declare const ListDataHolderScanSummariesDocument: DocumentNode<ListDataHolderScanSummariesQuery, ListDataHolderScanSummariesQueryVariables>;
1023
1099
  export declare const ListAvailableActionsDocument: DocumentNode<ListAvailableActionsQuery, ListAvailableActionsQueryVariables>;
1100
+ export declare const ListActionsForDataHolderDocument: DocumentNode<ListActionsForDataHolderQuery, ListActionsForDataHolderQueryVariables>;
1024
1101
  export declare const GetActionDocument: DocumentNode<GetActionQuery, GetActionQueryVariables>;
1025
1102
  export declare const OnVirtualPresenceUpdateDocument: DocumentNode<OnVirtualPresenceUpdateSubscription, OnVirtualPresenceUpdateSubscriptionVariables>;
1026
1103
  export declare const OnDataHoldersUpdateDocument: DocumentNode<OnDataHoldersUpdateSubscription, OnDataHoldersUpdateSubscriptionVariables>;
@@ -75,13 +75,17 @@ export type Action = {
75
75
  version: Scalars['Int']['output'];
76
76
  virtualPresenceId: Scalars['ID']['output'];
77
77
  };
78
+ export type ActionConnection = {
79
+ items: Array<Action>;
80
+ nextToken?: Maybe<Scalars['String']['output']>;
81
+ };
78
82
  export type ActionContact = {
79
83
  address?: Maybe<Scalars['String']['output']>;
80
84
  email?: Maybe<Scalars['String']['output']>;
81
85
  phone?: Maybe<Scalars['String']['output']>;
82
86
  };
83
87
  export type ActionFulfilmentMethod = 'ASSISTED' | 'DELEGATED' | '%future added value';
84
- export type ActionIntent = 'ACCESS_MY_DATA' | 'DELETE_MY_DATA' | 'LIMIT_DATA_USE' | 'OTHER' | 'STOP_CONTACT' | '%future added value';
88
+ export type ActionIntent = 'ACCESS_MY_DATA' | 'DELETE_MY_DATA' | 'LIMIT_DATA_USE' | 'OTHER' | 'SAVE_IN_PASSWORD' | 'STOP_CONTACT' | 'SWAP_EMAIL' | 'SWAP_PHONE' | 'SWAP_VIRTUAL_CARD' | '%future added value';
85
89
  export type ActionOrigin = 'ANALYSIS' | 'DISCOVERY' | 'STATIC' | '%future added value';
86
90
  export type ActionStatus = 'COMPLETED_UNVERIFIED' | 'COMPLETED_VERIFIED' | 'CONTRADICTED' | 'FAILED' | 'IN_PROGRESS' | 'PENDING' | 'REQUIRES_USER_INPUT' | '%future added value';
87
91
  export type AnalysisResult = {
@@ -92,6 +96,7 @@ export type AnalysisResult = {
92
96
  lastAnalyzedAtEpochMs: Scalars['Float']['output'];
93
97
  owner: Scalars['ID']['output'];
94
98
  status: AnalysisResultStatus;
99
+ statusReason?: Maybe<AnalysisResultStatusReason>;
95
100
  updatedAtEpochMs: Scalars['Float']['output'];
96
101
  version: Scalars['Int']['output'];
97
102
  virtualPresenceId: Scalars['ID']['output'];
@@ -110,6 +115,7 @@ export type AnalysisResultData = {
110
115
  riskIndicators: RiskIndicators;
111
116
  };
112
117
  export type AnalysisResultStatus = 'COMPLETE' | 'FAILED' | 'PARTIAL' | 'PENDING' | 'UNAVAILABLE' | '%future added value';
118
+ export type AnalysisResultStatusReason = 'INVALID_DOMAIN' | 'MALICIOUS' | 'NOT_ATTEMPTED' | 'OTHER' | 'POLICY_UNAVAILABLE' | '%future added value';
113
119
  export type AnalysisResultUpdate = {
114
120
  createdAtEpochMs: Scalars['Float']['output'];
115
121
  dataHolderIdentifier: Scalars['String']['output'];
@@ -117,6 +123,7 @@ export type AnalysisResultUpdate = {
117
123
  lastAnalyzedAtEpochMs: Scalars['Float']['output'];
118
124
  owner: Scalars['ID']['output'];
119
125
  status: AnalysisResultStatus;
126
+ statusReason?: Maybe<AnalysisResultStatusReason>;
120
127
  updatedAtEpochMs: Scalars['Float']['output'];
121
128
  version: Scalars['Int']['output'];
122
129
  virtualPresenceId: Scalars['ID']['output'];
@@ -144,6 +151,7 @@ export type AvailableAction = {
144
151
  fulfilmentMethod: ActionFulfilmentMethod;
145
152
  intent: ActionIntent;
146
153
  origin: ActionOrigin;
154
+ status?: Maybe<ActionStatus>;
147
155
  title?: Maybe<Scalars['String']['output']>;
148
156
  };
149
157
  export type AvailableActionConnection = {
@@ -191,7 +199,6 @@ export type DataHolder = {
191
199
  version: Scalars['Int']['output'];
192
200
  virtualPresenceId: Scalars['ID']['output'];
193
201
  };
194
- export type DataHolderChangeType = 'METADATA_UPDATE' | 'NEW' | 'SIGNIFICANT_UPDATE' | '%future added value';
195
202
  export type DataHolderConnection = {
196
203
  items: Array<DataHolder>;
197
204
  nextToken?: Maybe<Scalars['String']['output']>;
@@ -271,6 +278,14 @@ export type Mutation = {
271
278
  * for the client to complete.
272
279
  */
273
280
  initiateAction: Action;
281
+ /**
282
+ * Validate a virtual presence's provider grant on demand and return its
283
+ * reconciled state. If the provider confirms the grant has been revoked (e.g.
284
+ * the user removed access in their provider account), the presence transitions
285
+ * to NEEDS_REAUTH; otherwise its state is returned unchanged. Use before gating
286
+ * access on a current CONNECTED state.
287
+ */
288
+ refreshVirtualPresenceState: VirtualPresence;
274
289
  /**
275
290
  * Rescan an existing virtual presence for new data holders.
276
291
  * Scans from the last scan date forward.
@@ -298,6 +313,9 @@ export type MutationDisconnectVirtualPresenceArgs = {
298
313
  export type MutationInitiateActionArgs = {
299
314
  input: InitiateActionInput;
300
315
  };
316
+ export type MutationRefreshVirtualPresenceStateArgs = {
317
+ id: Scalars['String']['input'];
318
+ };
301
319
  export type MutationRescanVirtualPresenceArgs = {
302
320
  id: Scalars['String']['input'];
303
321
  options?: InputMaybe<ScanOptionsInput>;
@@ -313,6 +331,7 @@ export type OrganizationAnalysis = {
313
331
  lastAnalyzedAtEpochMs: Scalars['Float']['output'];
314
332
  owner: Scalars['ID']['output'];
315
333
  status: AnalysisResultStatus;
334
+ statusReason?: Maybe<AnalysisResultStatusReason>;
316
335
  updatedAtEpochMs: Scalars['Float']['output'];
317
336
  version: Scalars['Int']['output'];
318
337
  };
@@ -375,12 +394,24 @@ export type Query = {
375
394
  * the provider OAuth flow.
376
395
  */
377
396
  getProviderConfiguration: ProviderConfiguration;
397
+ /**
398
+ * List the persisted action history for a data holder. Returns every action
399
+ * that has been initiated against the data holder (all intents, all statuses,
400
+ * every attempt), ordered newest-first. This is the executed-action history,
401
+ * distinct from listAvailableActions, which returns the derived set of actions
402
+ * a user could take.
403
+ */
404
+ listActionsForDataHolder: ActionConnection;
378
405
  /** List analysis results for a virtual presence. */
379
406
  listAnalysisResults: AnalysisResultConnection;
380
407
  /**
381
408
  * List the actions currently available for a data holder relationship. Derived
382
409
  * at query time by merging static, analysis, and discovery sources; not
383
410
  * persisted. The owning virtual presence is derived from the data holder.
411
+ *
412
+ * Each returned action carries its latest status for the data holder (null when
413
+ * never initiated). By default actions the user has already completed are
414
+ * omitted; pass includeCompleted: true to return them as well.
384
415
  */
385
416
  listAvailableActions: AvailableActionConnection;
386
417
  /** List scan summaries for a data holder (most recent first) */
@@ -404,6 +435,11 @@ export type QueryGetOrganizationAnalysisArgs = {
404
435
  name?: InputMaybe<Scalars['String']['input']>;
405
436
  options?: InputMaybe<OrganizationAnalysisOptions>;
406
437
  };
438
+ export type QueryListActionsForDataHolderArgs = {
439
+ dataHolderId: Scalars['ID']['input'];
440
+ limit?: InputMaybe<Scalars['Int']['input']>;
441
+ nextToken?: InputMaybe<Scalars['String']['input']>;
442
+ };
407
443
  export type QueryListAnalysisResultsArgs = {
408
444
  limit?: InputMaybe<Scalars['Int']['input']>;
409
445
  nextToken?: InputMaybe<Scalars['String']['input']>;
@@ -411,6 +447,7 @@ export type QueryListAnalysisResultsArgs = {
411
447
  };
412
448
  export type QueryListAvailableActionsArgs = {
413
449
  dataHolderId: Scalars['ID']['input'];
450
+ includeCompleted?: InputMaybe<Scalars['Boolean']['input']>;
414
451
  };
415
452
  export type QueryListDataHolderScanSummariesArgs = {
416
453
  dataHolderId: Scalars['ID']['input'];
@@ -4,7 +4,7 @@
4
4
  * SPDX-License-Identifier: Apache-2.0
5
5
  */
6
6
  import { ActionEntity } from '../../domain/entities/action/actionEntity';
7
- import { ActionService, InitiateActionInput, ListAvailableActionsInput, ListAvailableActionsOutput, SubscribeToActionsInput } from '../../domain/entities/action/actionService';
7
+ import { ActionService, InitiateActionInput, ListActionsForDataHolderInput, ListActionsForDataHolderOutput, ListAvailableActionsInput, ListAvailableActionsOutput, SubscribeToActionsInput } from '../../domain/entities/action/actionService';
8
8
  import { ApiClient } from '../common/apiClient';
9
9
  export declare class DefaultActionService implements ActionService {
10
10
  private readonly appSync;
@@ -18,6 +18,7 @@ export declare class DefaultActionService implements ActionService {
18
18
  get(id: string): Promise<ActionEntity | undefined>;
19
19
  confirmOutcome(id: string): Promise<ActionEntity>;
20
20
  listAvailable(input: ListAvailableActionsInput): Promise<ListAvailableActionsOutput>;
21
+ listForDataHolder(input: ListActionsForDataHolderInput): Promise<ListActionsForDataHolderOutput>;
21
22
  subscribe(input: SubscribeToActionsInput): Promise<void>;
22
23
  unsubscribe(subscriptionId: string): void;
23
24
  private setupUpdateSubscription;
@@ -10,6 +10,7 @@ export declare class AvailableActionTransformer {
10
10
  private readonly intentTransformer;
11
11
  private readonly fulfilmentMethodTransformer;
12
12
  private readonly originTransformer;
13
+ private readonly statusTransformer;
13
14
  fromGraphQLToEntity(data: AvailableActionGraphQL): AvailableActionEntity;
14
15
  fromEntityToAPI(entity: AvailableActionEntity): AvailableAction;
15
16
  }
@@ -10,6 +10,7 @@ export declare class DefaultAnalysisResultService implements AnalysisResultServi
10
10
  private readonly appSync;
11
11
  private readonly analysisResultTransformer;
12
12
  private readonly analysisResultStatusTransformer;
13
+ private readonly analysisResultStatusReasonTransformer;
13
14
  private readonly subscriptionManager;
14
15
  constructor(appSync: ApiClient);
15
16
  get(id: string): Promise<AnalysisResultEntity | undefined>;
@@ -0,0 +1,12 @@
1
+ /**
2
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
3
+ *
4
+ * SPDX-License-Identifier: Apache-2.0
5
+ */
6
+ import { AnalysisResultStatusReason as AnalysisResultStatusReasonGraphQL } from '../../../../gen/graphqlTypes';
7
+ import { AnalysisResultStatusReason } from '../../../../public/typings/analysisResult';
8
+ import { AnalysisResultStatusReasonEntity } from '../../../domain/entities/analysis-result/analysisResultEntity';
9
+ export declare class AnalysisResultStatusReasonTransformer {
10
+ fromGraphQLToEntity(data: AnalysisResultStatusReasonGraphQL | null | undefined): AnalysisResultStatusReasonEntity | undefined;
11
+ fromEntityToAPI(entity: AnalysisResultStatusReasonEntity | undefined): AnalysisResultStatusReason | undefined;
12
+ }
@@ -8,6 +8,7 @@ import { AnalysisResult } from '../../../../public/typings/analysisResult';
8
8
  import { AnalysisResultEntity } from '../../../domain/entities/analysis-result/analysisResultEntity';
9
9
  export declare class AnalysisResultTransformer {
10
10
  private readonly statusTransformer;
11
+ private readonly statusReasonTransformer;
11
12
  private readonly dataTransformer;
12
13
  fromGraphQLToEntity(data: AnalysisResultGraphQL): AnalysisResultEntity;
13
14
  fromEntityToAPI(entity: AnalysisResultEntity): AnalysisResult;