@sudoplatform/sudo-privacy-interaction 2.1.0 → 2.2.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 (98) hide show
  1. package/cjs/gen/graphqlTypes.js +557 -1
  2. package/cjs/private/data/action/actionSubscriptionManager.js +25 -0
  3. package/cjs/private/data/action/defaultActionService.js +80 -0
  4. package/cjs/private/data/action/transformer/actionFulfilmentMethodTransformer.js +47 -0
  5. package/cjs/private/data/action/transformer/actionIntentTransformer.js +69 -0
  6. package/cjs/private/data/action/transformer/actionOriginTransformer.js +37 -0
  7. package/cjs/private/data/action/transformer/actionStatusTransformer.js +53 -0
  8. package/cjs/private/data/action/transformer/actionTransformer.js +85 -0
  9. package/cjs/private/data/action/transformer/availableActionTransformer.js +37 -0
  10. package/cjs/private/data/common/apiClient.js +35 -0
  11. package/cjs/private/domain/entities/action/actionEntity.js +86 -0
  12. package/cjs/private/domain/entities/action/actionService.js +7 -0
  13. package/cjs/private/domain/use-cases/action/confirmActionOutcomeUseCase.js +25 -0
  14. package/cjs/private/domain/use-cases/action/initiateActionUseCase.js +26 -0
  15. package/cjs/private/domain/use-cases/action/listAvailableActionsUseCase.js +26 -0
  16. package/cjs/private/domain/use-cases/action/subscribeToActionUseCase.js +37 -0
  17. package/cjs/private/domain/use-cases/action/unsubscribeFromActionUseCase.js +27 -0
  18. package/cjs/public/defaultSudoPrivacyInteractionClient.js +58 -0
  19. package/cjs/public/inputs/action.js +7 -0
  20. package/cjs/public/inputs/index.js +1 -0
  21. package/cjs/public/typings/action.js +85 -0
  22. package/cjs/public/typings/index.js +1 -0
  23. package/docs/assets/hierarchy.js +1 -1
  24. package/docs/assets/navigation.js +1 -1
  25. package/docs/assets/search.js +1 -1
  26. package/docs/classes/DefaultSudoPrivacyInteractionClient.html +128 -22
  27. package/docs/enums/ActionFulfilmentMethod.html +63 -0
  28. package/docs/enums/ActionIntent.html +84 -0
  29. package/docs/enums/ActionOrigin.html +75 -0
  30. package/docs/enums/ActionStatus.html +99 -0
  31. package/docs/enums/ConnectionState.html +3 -3
  32. package/docs/hierarchy.html +6 -6
  33. package/docs/interfaces/Action.html +167 -0
  34. package/docs/interfaces/ActionContact.html +77 -0
  35. package/docs/interfaces/ActionSubscriber.html +92 -0
  36. package/docs/interfaces/AnalysisResultSubscriber.html +3 -3
  37. package/docs/interfaces/AssistedEmailTemplate.html +70 -0
  38. package/docs/interfaces/AssistedPayload.html +113 -0
  39. package/docs/interfaces/AvailableAction.html +102 -0
  40. package/docs/interfaces/DataHolderSubscriber.html +3 -3
  41. package/docs/interfaces/InitiateActionInput.html +79 -0
  42. package/docs/interfaces/ListAnalysisResultsInput.html +1 -1
  43. package/docs/interfaces/ListAvailableActionsInput.html +61 -0
  44. package/docs/interfaces/ListDataHolderScanSummariesInput.html +1 -1
  45. package/docs/interfaces/ListDataHoldersInput.html +1 -1
  46. package/docs/interfaces/ListVirtualPresencesInput.html +1 -1
  47. package/docs/interfaces/Pagination.html +1 -1
  48. package/docs/interfaces/SudoPrivacyInteractionClient.html +123 -22
  49. package/docs/interfaces/VirtualPresenceSubscriber.html +3 -3
  50. package/docs/modules.html +4 -4
  51. package/docs/types/SudoPrivacyInteractionClientOptions.html +2 -2
  52. package/lib/gen/graphqlTypes.js +556 -0
  53. package/lib/private/data/action/actionSubscriptionManager.js +21 -0
  54. package/lib/private/data/action/defaultActionService.js +76 -0
  55. package/lib/private/data/action/transformer/actionFulfilmentMethodTransformer.js +43 -0
  56. package/lib/private/data/action/transformer/actionIntentTransformer.js +65 -0
  57. package/lib/private/data/action/transformer/actionOriginTransformer.js +33 -0
  58. package/lib/private/data/action/transformer/actionStatusTransformer.js +49 -0
  59. package/lib/private/data/action/transformer/actionTransformer.js +81 -0
  60. package/lib/private/data/action/transformer/availableActionTransformer.js +33 -0
  61. package/lib/private/data/common/apiClient.js +36 -1
  62. package/lib/private/domain/entities/action/actionEntity.js +83 -0
  63. package/lib/private/domain/entities/action/actionService.js +6 -0
  64. package/lib/private/domain/use-cases/action/confirmActionOutcomeUseCase.js +21 -0
  65. package/lib/private/domain/use-cases/action/initiateActionUseCase.js +22 -0
  66. package/lib/private/domain/use-cases/action/listAvailableActionsUseCase.js +22 -0
  67. package/lib/private/domain/use-cases/action/subscribeToActionUseCase.js +33 -0
  68. package/lib/private/domain/use-cases/action/unsubscribeFromActionUseCase.js +23 -0
  69. package/lib/public/defaultSudoPrivacyInteractionClient.js +58 -0
  70. package/lib/public/inputs/action.js +6 -0
  71. package/lib/public/inputs/index.js +1 -0
  72. package/lib/public/typings/action.js +82 -0
  73. package/lib/public/typings/index.js +1 -0
  74. package/package.json +2 -2
  75. package/types/gen/graphqlTypes.d.ts +245 -1
  76. package/types/private/data/action/actionSubscriptionManager.d.ts +19 -0
  77. package/types/private/data/action/defaultActionService.d.ts +23 -0
  78. package/types/private/data/action/transformer/actionFulfilmentMethodTransformer.d.ts +14 -0
  79. package/types/private/data/action/transformer/actionIntentTransformer.d.ts +14 -0
  80. package/types/private/data/action/transformer/actionOriginTransformer.d.ts +12 -0
  81. package/types/private/data/action/transformer/actionStatusTransformer.d.ts +12 -0
  82. package/types/private/data/action/transformer/actionTransformer.d.ts +39 -0
  83. package/types/private/data/action/transformer/availableActionTransformer.d.ts +15 -0
  84. package/types/private/data/common/apiClient.d.ts +7 -1
  85. package/types/private/domain/entities/action/actionEntity.d.ts +187 -0
  86. package/types/private/domain/entities/action/actionService.d.ts +99 -0
  87. package/types/private/domain/use-cases/action/confirmActionOutcomeUseCase.d.ts +16 -0
  88. package/types/private/domain/use-cases/action/initiateActionUseCase.d.ts +17 -0
  89. package/types/private/domain/use-cases/action/listAvailableActionsUseCase.d.ts +16 -0
  90. package/types/private/domain/use-cases/action/subscribeToActionUseCase.d.ts +27 -0
  91. package/types/private/domain/use-cases/action/unsubscribeFromActionUseCase.d.ts +15 -0
  92. package/types/public/defaultSudoPrivacyInteractionClient.d.ts +12 -2
  93. package/types/public/inputs/action.d.ts +30 -0
  94. package/types/public/inputs/index.d.ts +1 -0
  95. package/types/public/sudoPrivacyInteractionClient.d.ts +41 -2
  96. package/types/public/typings/action.d.ts +185 -0
  97. package/types/public/typings/index.d.ts +1 -0
  98. package/types/public/typings/subscription.d.ts +23 -0
@@ -0,0 +1,80 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.DefaultActionService = void 0;
9
+ const subscription_1 = require("../../../public/typings/subscription");
10
+ const actionSubscriptionManager_1 = require("./actionSubscriptionManager");
11
+ const actionFulfilmentMethodTransformer_1 = require("./transformer/actionFulfilmentMethodTransformer");
12
+ const actionIntentTransformer_1 = require("./transformer/actionIntentTransformer");
13
+ const actionTransformer_1 = require("./transformer/actionTransformer");
14
+ const availableActionTransformer_1 = require("./transformer/availableActionTransformer");
15
+ class DefaultActionService {
16
+ appSync;
17
+ actionTransformer;
18
+ availableActionTransformer;
19
+ intentTransformer;
20
+ fulfilmentMethodTransformer;
21
+ subscriptionManager;
22
+ constructor(appSync) {
23
+ this.appSync = appSync;
24
+ this.actionTransformer = new actionTransformer_1.ActionTransformer();
25
+ this.availableActionTransformer = new availableActionTransformer_1.AvailableActionTransformer();
26
+ this.intentTransformer = new actionIntentTransformer_1.ActionIntentTransformer();
27
+ this.fulfilmentMethodTransformer = new actionFulfilmentMethodTransformer_1.ActionFulfilmentMethodTransformer();
28
+ this.subscriptionManager = new actionSubscriptionManager_1.ActionSubscriptionManager();
29
+ }
30
+ async initiate(input) {
31
+ const result = await this.appSync.initiateAction({
32
+ dataHolderId: input.dataHolderId,
33
+ intent: this.intentTransformer.fromEntityToGraphQL(input.intent),
34
+ fulfilmentMethod: this.fulfilmentMethodTransformer.fromEntityToGraphQL(input.fulfilmentMethod),
35
+ });
36
+ return this.actionTransformer.fromGraphQLToEntity(result);
37
+ }
38
+ async confirmOutcome(id) {
39
+ const result = await this.appSync.confirmActionOutcome(id);
40
+ return this.actionTransformer.fromGraphQLToEntity(result);
41
+ }
42
+ async listAvailable(input) {
43
+ const result = await this.appSync.listAvailableActions(input);
44
+ const availableActions = (result.items ?? []).map((item) => this.availableActionTransformer.fromGraphQLToEntity(item));
45
+ return {
46
+ availableActions,
47
+ nextToken: result.nextToken ?? undefined,
48
+ };
49
+ }
50
+ async subscribe(input) {
51
+ this.subscriptionManager.subscribe(input.subscriptionId, input.subscriber);
52
+ if (!this.subscriptionManager.getWatcher()) {
53
+ this.subscriptionManager.setWatcher(await this.appSync.onActionStatusUpdated(input.owner));
54
+ this.subscriptionManager.setSubscription(this.setupUpdateSubscription());
55
+ this.subscriptionManager.connectionStatusChanged(subscription_1.ConnectionState.Connected);
56
+ }
57
+ }
58
+ unsubscribe(subscriptionId) {
59
+ this.subscriptionManager.unsubscribe(subscriptionId);
60
+ }
61
+ setupUpdateSubscription() {
62
+ const subscription = this.subscriptionManager.getWatcher()?.subscribe({
63
+ complete: () => {
64
+ this.subscriptionManager.connectionStatusChanged(subscription_1.ConnectionState.Disconnected);
65
+ },
66
+ error: () => {
67
+ this.subscriptionManager.connectionStatusChanged(subscription_1.ConnectionState.Disconnected);
68
+ },
69
+ next: (result) => {
70
+ const action = result.data?.onActionStatusUpdate;
71
+ if (action) {
72
+ const entity = this.actionTransformer.fromGraphQLToEntity(action);
73
+ this.subscriptionManager.actionUpdated(this.actionTransformer.fromEntityToAPI(entity));
74
+ }
75
+ },
76
+ });
77
+ return subscription;
78
+ }
79
+ }
80
+ exports.DefaultActionService = DefaultActionService;
@@ -0,0 +1,47 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ActionFulfilmentMethodTransformer = void 0;
9
+ const public_1 = require("../../../../public");
10
+ const actionEntity_1 = require("../../../domain/entities/action/actionEntity");
11
+ class ActionFulfilmentMethodTransformer {
12
+ fromEntityToAPI(entity) {
13
+ switch (entity) {
14
+ case actionEntity_1.ActionFulfilmentMethodEntity.Assisted:
15
+ return public_1.ActionFulfilmentMethod.Assisted;
16
+ case actionEntity_1.ActionFulfilmentMethodEntity.Delegated:
17
+ return public_1.ActionFulfilmentMethod.Delegated;
18
+ }
19
+ }
20
+ fromAPIToEntity(data) {
21
+ switch (data) {
22
+ case public_1.ActionFulfilmentMethod.Assisted:
23
+ return actionEntity_1.ActionFulfilmentMethodEntity.Assisted;
24
+ case public_1.ActionFulfilmentMethod.Delegated:
25
+ return actionEntity_1.ActionFulfilmentMethodEntity.Delegated;
26
+ }
27
+ }
28
+ fromGraphQLToEntity(data) {
29
+ switch (data) {
30
+ case 'ASSISTED':
31
+ return actionEntity_1.ActionFulfilmentMethodEntity.Assisted;
32
+ case 'DELEGATED':
33
+ return actionEntity_1.ActionFulfilmentMethodEntity.Delegated;
34
+ default:
35
+ return actionEntity_1.ActionFulfilmentMethodEntity.Assisted;
36
+ }
37
+ }
38
+ fromEntityToGraphQL(entity) {
39
+ switch (entity) {
40
+ case actionEntity_1.ActionFulfilmentMethodEntity.Assisted:
41
+ return 'ASSISTED';
42
+ case actionEntity_1.ActionFulfilmentMethodEntity.Delegated:
43
+ return 'DELEGATED';
44
+ }
45
+ }
46
+ }
47
+ exports.ActionFulfilmentMethodTransformer = ActionFulfilmentMethodTransformer;
@@ -0,0 +1,69 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ActionIntentTransformer = void 0;
9
+ const public_1 = require("../../../../public");
10
+ const actionEntity_1 = require("../../../domain/entities/action/actionEntity");
11
+ class ActionIntentTransformer {
12
+ fromEntityToAPI(entity) {
13
+ switch (entity) {
14
+ case actionEntity_1.ActionIntentEntity.StopContact:
15
+ return public_1.ActionIntent.StopContact;
16
+ case actionEntity_1.ActionIntentEntity.AccessMyData:
17
+ return public_1.ActionIntent.AccessMyData;
18
+ case actionEntity_1.ActionIntentEntity.DeleteMyData:
19
+ return public_1.ActionIntent.DeleteMyData;
20
+ case actionEntity_1.ActionIntentEntity.LimitDataUse:
21
+ return public_1.ActionIntent.LimitDataUse;
22
+ case actionEntity_1.ActionIntentEntity.Other:
23
+ return public_1.ActionIntent.Other;
24
+ }
25
+ }
26
+ fromAPIToEntity(data) {
27
+ switch (data) {
28
+ case public_1.ActionIntent.StopContact:
29
+ return actionEntity_1.ActionIntentEntity.StopContact;
30
+ case public_1.ActionIntent.AccessMyData:
31
+ return actionEntity_1.ActionIntentEntity.AccessMyData;
32
+ case public_1.ActionIntent.DeleteMyData:
33
+ return actionEntity_1.ActionIntentEntity.DeleteMyData;
34
+ case public_1.ActionIntent.LimitDataUse:
35
+ return actionEntity_1.ActionIntentEntity.LimitDataUse;
36
+ case public_1.ActionIntent.Other:
37
+ return actionEntity_1.ActionIntentEntity.Other;
38
+ }
39
+ }
40
+ fromGraphQLToEntity(data) {
41
+ switch (data) {
42
+ case 'STOP_CONTACT':
43
+ return actionEntity_1.ActionIntentEntity.StopContact;
44
+ case 'ACCESS_MY_DATA':
45
+ return actionEntity_1.ActionIntentEntity.AccessMyData;
46
+ case 'DELETE_MY_DATA':
47
+ return actionEntity_1.ActionIntentEntity.DeleteMyData;
48
+ case 'LIMIT_DATA_USE':
49
+ return actionEntity_1.ActionIntentEntity.LimitDataUse;
50
+ default:
51
+ return actionEntity_1.ActionIntentEntity.Other;
52
+ }
53
+ }
54
+ fromEntityToGraphQL(entity) {
55
+ switch (entity) {
56
+ case actionEntity_1.ActionIntentEntity.StopContact:
57
+ return 'STOP_CONTACT';
58
+ case actionEntity_1.ActionIntentEntity.AccessMyData:
59
+ return 'ACCESS_MY_DATA';
60
+ case actionEntity_1.ActionIntentEntity.DeleteMyData:
61
+ return 'DELETE_MY_DATA';
62
+ case actionEntity_1.ActionIntentEntity.LimitDataUse:
63
+ return 'LIMIT_DATA_USE';
64
+ case actionEntity_1.ActionIntentEntity.Other:
65
+ return 'OTHER';
66
+ }
67
+ }
68
+ }
69
+ exports.ActionIntentTransformer = ActionIntentTransformer;
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ActionOriginTransformer = void 0;
9
+ const public_1 = require("../../../../public");
10
+ const actionEntity_1 = require("../../../domain/entities/action/actionEntity");
11
+ class ActionOriginTransformer {
12
+ fromEntityToAPI(entity) {
13
+ switch (entity) {
14
+ case actionEntity_1.ActionOriginEntity.Static:
15
+ return public_1.ActionOrigin.Static;
16
+ case actionEntity_1.ActionOriginEntity.Analysis:
17
+ return public_1.ActionOrigin.Analysis;
18
+ case actionEntity_1.ActionOriginEntity.Discovery:
19
+ return public_1.ActionOrigin.Discovery;
20
+ case actionEntity_1.ActionOriginEntity.Unknown:
21
+ return public_1.ActionOrigin.Unknown;
22
+ }
23
+ }
24
+ fromGraphQLToEntity(data) {
25
+ switch (data) {
26
+ case 'STATIC':
27
+ return actionEntity_1.ActionOriginEntity.Static;
28
+ case 'ANALYSIS':
29
+ return actionEntity_1.ActionOriginEntity.Analysis;
30
+ case 'DISCOVERY':
31
+ return actionEntity_1.ActionOriginEntity.Discovery;
32
+ default:
33
+ return actionEntity_1.ActionOriginEntity.Unknown;
34
+ }
35
+ }
36
+ }
37
+ exports.ActionOriginTransformer = ActionOriginTransformer;
@@ -0,0 +1,53 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ActionStatusTransformer = void 0;
9
+ const public_1 = require("../../../../public");
10
+ const actionEntity_1 = require("../../../domain/entities/action/actionEntity");
11
+ class ActionStatusTransformer {
12
+ fromEntityToAPI(entity) {
13
+ switch (entity) {
14
+ case actionEntity_1.ActionStatusEntity.Pending:
15
+ return public_1.ActionStatus.Pending;
16
+ case actionEntity_1.ActionStatusEntity.InProgress:
17
+ return public_1.ActionStatus.InProgress;
18
+ case actionEntity_1.ActionStatusEntity.CompletedUnverified:
19
+ return public_1.ActionStatus.CompletedUnverified;
20
+ case actionEntity_1.ActionStatusEntity.CompletedVerified:
21
+ return public_1.ActionStatus.CompletedVerified;
22
+ case actionEntity_1.ActionStatusEntity.Failed:
23
+ return public_1.ActionStatus.Failed;
24
+ case actionEntity_1.ActionStatusEntity.RequiresUserInput:
25
+ return public_1.ActionStatus.RequiresUserInput;
26
+ case actionEntity_1.ActionStatusEntity.Contradicted:
27
+ return public_1.ActionStatus.Contradicted;
28
+ case actionEntity_1.ActionStatusEntity.Unknown:
29
+ return public_1.ActionStatus.Unknown;
30
+ }
31
+ }
32
+ fromGraphQLToEntity(data) {
33
+ switch (data) {
34
+ case 'PENDING':
35
+ return actionEntity_1.ActionStatusEntity.Pending;
36
+ case 'IN_PROGRESS':
37
+ return actionEntity_1.ActionStatusEntity.InProgress;
38
+ case 'COMPLETED_UNVERIFIED':
39
+ return actionEntity_1.ActionStatusEntity.CompletedUnverified;
40
+ case 'COMPLETED_VERIFIED':
41
+ return actionEntity_1.ActionStatusEntity.CompletedVerified;
42
+ case 'FAILED':
43
+ return actionEntity_1.ActionStatusEntity.Failed;
44
+ case 'REQUIRES_USER_INPUT':
45
+ return actionEntity_1.ActionStatusEntity.RequiresUserInput;
46
+ case 'CONTRADICTED':
47
+ return actionEntity_1.ActionStatusEntity.Contradicted;
48
+ default:
49
+ return actionEntity_1.ActionStatusEntity.Unknown;
50
+ }
51
+ }
52
+ }
53
+ exports.ActionStatusTransformer = ActionStatusTransformer;
@@ -0,0 +1,85 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ActionTransformer = void 0;
9
+ const actionFulfilmentMethodTransformer_1 = require("./actionFulfilmentMethodTransformer");
10
+ const actionIntentTransformer_1 = require("./actionIntentTransformer");
11
+ const actionStatusTransformer_1 = require("./actionStatusTransformer");
12
+ class ActionTransformer {
13
+ intentTransformer = new actionIntentTransformer_1.ActionIntentTransformer();
14
+ fulfilmentMethodTransformer = new actionFulfilmentMethodTransformer_1.ActionFulfilmentMethodTransformer();
15
+ statusTransformer = new actionStatusTransformer_1.ActionStatusTransformer();
16
+ fromGraphQLToEntity(data) {
17
+ return {
18
+ id: data.id,
19
+ virtualPresenceId: data.virtualPresenceId,
20
+ dataHolderId: data.dataHolderId ?? undefined,
21
+ intent: this.intentTransformer.fromGraphQLToEntity(data.intent),
22
+ additionalInfo: data.additionalInfo ?? undefined,
23
+ fulfilmentMethod: this.fulfilmentMethodTransformer.fromGraphQLToEntity(data.fulfilmentMethod),
24
+ status: this.statusTransformer.fromGraphQLToEntity(data.status),
25
+ assistedPayload: data.assistedPayload
26
+ ? this.assistedPayloadFromGraphQL(data.assistedPayload)
27
+ : undefined,
28
+ initiatedAt: data.initiatedAtEpochMs != null
29
+ ? new Date(data.initiatedAtEpochMs)
30
+ : undefined,
31
+ completedAt: data.completedAtEpochMs != null
32
+ ? new Date(data.completedAtEpochMs)
33
+ : undefined,
34
+ owner: data.owner,
35
+ version: data.version,
36
+ createdAt: new Date(data.createdAtEpochMs),
37
+ updatedAt: new Date(data.updatedAtEpochMs),
38
+ };
39
+ }
40
+ fromEntityToAPI(entity) {
41
+ return {
42
+ id: entity.id,
43
+ virtualPresenceId: entity.virtualPresenceId,
44
+ dataHolderId: entity.dataHolderId,
45
+ intent: this.intentTransformer.fromEntityToAPI(entity.intent),
46
+ additionalInfo: entity.additionalInfo,
47
+ fulfilmentMethod: this.fulfilmentMethodTransformer.fromEntityToAPI(entity.fulfilmentMethod),
48
+ status: this.statusTransformer.fromEntityToAPI(entity.status),
49
+ assistedPayload: entity.assistedPayload,
50
+ initiatedAt: entity.initiatedAt,
51
+ completedAt: entity.completedAt,
52
+ owner: entity.owner,
53
+ version: entity.version,
54
+ createdAt: entity.createdAt,
55
+ updatedAt: entity.updatedAt,
56
+ };
57
+ }
58
+ assistedPayloadFromGraphQL(data) {
59
+ return {
60
+ toAddress: data.toAddress ?? undefined,
61
+ unsubscribeUrl: data.unsubscribeUrl ?? undefined,
62
+ unsubscribeMailto: data.unsubscribeMailto ?? undefined,
63
+ contact: data.contact ? this.contactFromGraphQL(data.contact) : undefined,
64
+ jurisdiction: data.jurisdiction ?? undefined,
65
+ instructions: data.instructions ?? undefined,
66
+ emailTemplate: data.emailTemplate
67
+ ? this.emailTemplateFromGraphQL(data.emailTemplate)
68
+ : undefined,
69
+ };
70
+ }
71
+ contactFromGraphQL(data) {
72
+ return {
73
+ email: data.email ?? undefined,
74
+ phone: data.phone ?? undefined,
75
+ address: data.address ?? undefined,
76
+ };
77
+ }
78
+ emailTemplateFromGraphQL(data) {
79
+ return {
80
+ subject: data.subject ?? undefined,
81
+ body: data.body,
82
+ };
83
+ }
84
+ }
85
+ exports.ActionTransformer = ActionTransformer;
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.AvailableActionTransformer = void 0;
9
+ const actionFulfilmentMethodTransformer_1 = require("./actionFulfilmentMethodTransformer");
10
+ const actionIntentTransformer_1 = require("./actionIntentTransformer");
11
+ const actionOriginTransformer_1 = require("./actionOriginTransformer");
12
+ class AvailableActionTransformer {
13
+ intentTransformer = new actionIntentTransformer_1.ActionIntentTransformer();
14
+ fulfilmentMethodTransformer = new actionFulfilmentMethodTransformer_1.ActionFulfilmentMethodTransformer();
15
+ originTransformer = new actionOriginTransformer_1.ActionOriginTransformer();
16
+ fromGraphQLToEntity(data) {
17
+ return {
18
+ intent: this.intentTransformer.fromGraphQLToEntity(data.intent),
19
+ additionalInfo: data.additionalInfo ?? undefined,
20
+ fulfilmentMethod: this.fulfilmentMethodTransformer.fromGraphQLToEntity(data.fulfilmentMethod),
21
+ origin: this.originTransformer.fromGraphQLToEntity(data.origin),
22
+ title: data.title ?? undefined,
23
+ description: data.description ?? undefined,
24
+ };
25
+ }
26
+ fromEntityToAPI(entity) {
27
+ return {
28
+ intent: this.intentTransformer.fromEntityToAPI(entity.intent),
29
+ additionalInfo: entity.additionalInfo,
30
+ fulfilmentMethod: this.fulfilmentMethodTransformer.fromEntityToAPI(entity.fulfilmentMethod),
31
+ origin: this.originTransformer.fromEntityToAPI(entity.origin),
32
+ title: entity.title,
33
+ description: entity.description,
34
+ };
35
+ }
36
+ }
37
+ exports.AvailableActionTransformer = AvailableActionTransformer;
@@ -125,6 +125,32 @@ class ApiClient {
125
125
  });
126
126
  return data.listAnalysisResults;
127
127
  }
128
+ async initiateAction(input) {
129
+ const data = await this.performMutation({
130
+ mutation: graphqlTypes_1.InitiateActionDocument,
131
+ variables: { input },
132
+ calleeName: this.initiateAction.name,
133
+ });
134
+ return data.initiateAction;
135
+ }
136
+ async confirmActionOutcome(id) {
137
+ const data = await this.performMutation({
138
+ mutation: graphqlTypes_1.ConfirmActionOutcomeDocument,
139
+ variables: { id },
140
+ calleeName: this.confirmActionOutcome.name,
141
+ });
142
+ return data.confirmActionOutcome;
143
+ }
144
+ async listAvailableActions(input) {
145
+ const data = await this.performQuery({
146
+ query: graphqlTypes_1.ListAvailableActionsDocument,
147
+ variables: {
148
+ dataHolderId: input.dataHolderId,
149
+ },
150
+ calleeName: this.listAvailableActions.name,
151
+ });
152
+ return data.listAvailableActions;
153
+ }
128
154
  onVirtualPresenceUpdated(owner) {
129
155
  return this.performSubscription({
130
156
  subscription: graphqlTypes_1.OnVirtualPresenceUpdateDocument,
@@ -152,6 +178,15 @@ class ApiClient {
152
178
  calleeName: this.onAnalysisResultUpdated.name,
153
179
  });
154
180
  }
181
+ onActionStatusUpdated(owner) {
182
+ return this.performSubscription({
183
+ subscription: graphqlTypes_1.OnActionStatusUpdateDocument,
184
+ variables: {
185
+ owner,
186
+ },
187
+ calleeName: this.onActionStatusUpdated.name,
188
+ });
189
+ }
155
190
  async performQuery({ variables, query, calleeName, }) {
156
191
  let result;
157
192
  try {
@@ -0,0 +1,86 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ActionStatusEntity = exports.ActionOriginEntity = exports.ActionFulfilmentMethodEntity = exports.ActionIntentEntity = void 0;
9
+ /**
10
+ * The user-facing intent of an action. This is a service-owned taxonomy,
11
+ * decoupled from any upstream provider's action vocabulary.
12
+ *
13
+ * Clients must tolerate unknown values: an unrecognised intent is represented
14
+ * as `Other` rather than failing, so newly added intents do not break existing
15
+ * clients.
16
+ *
17
+ * @property StopContact Unsubscribe / opt out of marketing communications.
18
+ * @property AccessMyData Data subject access / portability request.
19
+ * @property DeleteMyData Account deletion / data erasure.
20
+ * @property LimitDataUse Opt out of sale / tracking, manage consent.
21
+ * @property Other Anything unmapped; carries additionalInfo.
22
+ *
23
+ * @enum
24
+ */
25
+ var ActionIntentEntity;
26
+ (function (ActionIntentEntity) {
27
+ ActionIntentEntity["StopContact"] = "STOP_CONTACT";
28
+ ActionIntentEntity["AccessMyData"] = "ACCESS_MY_DATA";
29
+ ActionIntentEntity["DeleteMyData"] = "DELETE_MY_DATA";
30
+ ActionIntentEntity["LimitDataUse"] = "LIMIT_DATA_USE";
31
+ ActionIntentEntity["Other"] = "OTHER";
32
+ })(ActionIntentEntity || (exports.ActionIntentEntity = ActionIntentEntity = {}));
33
+ /**
34
+ * How an action is fulfilled from the user's perspective.
35
+ *
36
+ * @property Assisted The service returns structured materials for the client to
37
+ * complete the action.
38
+ * @property Delegated The service performs the action on the user's behalf.
39
+ *
40
+ * @enum
41
+ */
42
+ var ActionFulfilmentMethodEntity;
43
+ (function (ActionFulfilmentMethodEntity) {
44
+ ActionFulfilmentMethodEntity["Assisted"] = "ASSISTED";
45
+ ActionFulfilmentMethodEntity["Delegated"] = "DELEGATED";
46
+ })(ActionFulfilmentMethodEntity || (exports.ActionFulfilmentMethodEntity = ActionFulfilmentMethodEntity = {}));
47
+ /**
48
+ * Which source contributed an available action.
49
+ *
50
+ * @property Static Always-possible action for the virtual presence type.
51
+ * @property Analysis Derived from an analysis source's reported actions.
52
+ * @property Discovery Derived from a discovery scan (e.g. List-Unsubscribe).
53
+ *
54
+ * @enum
55
+ */
56
+ var ActionOriginEntity;
57
+ (function (ActionOriginEntity) {
58
+ ActionOriginEntity["Static"] = "STATIC";
59
+ ActionOriginEntity["Analysis"] = "ANALYSIS";
60
+ ActionOriginEntity["Discovery"] = "DISCOVERY";
61
+ ActionOriginEntity["Unknown"] = "UNKNOWN";
62
+ })(ActionOriginEntity || (exports.ActionOriginEntity = ActionOriginEntity = {}));
63
+ /**
64
+ * Lifecycle status of a persisted action instance.
65
+ *
66
+ * @property Pending The action has been created but not yet started.
67
+ * @property InProgress The action is being performed.
68
+ * @property CompletedUnverified The action completed but has not been verified.
69
+ * @property CompletedVerified The action completed and has been verified.
70
+ * @property Failed The action failed to complete.
71
+ * @property RequiresUserInput The action requires further input from the user.
72
+ * @property Contradicted Subsequent evidence contradicts the action's completion.
73
+ *
74
+ * @enum
75
+ */
76
+ var ActionStatusEntity;
77
+ (function (ActionStatusEntity) {
78
+ ActionStatusEntity["Pending"] = "PENDING";
79
+ ActionStatusEntity["InProgress"] = "IN_PROGRESS";
80
+ ActionStatusEntity["CompletedUnverified"] = "COMPLETED_UNVERIFIED";
81
+ ActionStatusEntity["CompletedVerified"] = "COMPLETED_VERIFIED";
82
+ ActionStatusEntity["Failed"] = "FAILED";
83
+ ActionStatusEntity["RequiresUserInput"] = "REQUIRES_USER_INPUT";
84
+ ActionStatusEntity["Contradicted"] = "CONTRADICTED";
85
+ ActionStatusEntity["Unknown"] = "UNKNOWN";
86
+ })(ActionStatusEntity || (exports.ActionStatusEntity = ActionStatusEntity = {}));
@@ -0,0 +1,7 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
@@ -0,0 +1,25 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ConfirmActionOutcomeUseCase = void 0;
9
+ const sudo_common_1 = require("@sudoplatform/sudo-common");
10
+ /**
11
+ * Application business logic for confirming that an action was completed.
12
+ */
13
+ class ConfirmActionOutcomeUseCase {
14
+ actionService;
15
+ log;
16
+ constructor(actionService) {
17
+ this.actionService = actionService;
18
+ this.log = new sudo_common_1.DefaultLogger(this.constructor.name);
19
+ }
20
+ async execute(id) {
21
+ this.log.debug(this.constructor.name, { id });
22
+ return await this.actionService.confirmOutcome(id);
23
+ }
24
+ }
25
+ exports.ConfirmActionOutcomeUseCase = ConfirmActionOutcomeUseCase;
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.InitiateActionUseCase = void 0;
9
+ const sudo_common_1 = require("@sudoplatform/sudo-common");
10
+ /**
11
+ * Application business logic for initiating an action against a data holder
12
+ * relationship.
13
+ */
14
+ class InitiateActionUseCase {
15
+ actionService;
16
+ log;
17
+ constructor(actionService) {
18
+ this.actionService = actionService;
19
+ this.log = new sudo_common_1.DefaultLogger(this.constructor.name);
20
+ }
21
+ async execute(input) {
22
+ this.log.debug(this.constructor.name, { input });
23
+ return await this.actionService.initiate(input);
24
+ }
25
+ }
26
+ exports.InitiateActionUseCase = InitiateActionUseCase;
@@ -0,0 +1,26 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.ListAvailableActionsUseCase = void 0;
9
+ const sudo_common_1 = require("@sudoplatform/sudo-common");
10
+ /**
11
+ * Application business logic for listing the actions available for a data holder
12
+ * relationship.
13
+ */
14
+ class ListAvailableActionsUseCase {
15
+ actionService;
16
+ log;
17
+ constructor(actionService) {
18
+ this.actionService = actionService;
19
+ this.log = new sudo_common_1.DefaultLogger(this.constructor.name);
20
+ }
21
+ async execute(input) {
22
+ this.log.debug(this.constructor.name, { input });
23
+ return await this.actionService.listAvailable(input);
24
+ }
25
+ }
26
+ exports.ListAvailableActionsUseCase = ListAvailableActionsUseCase;
@@ -0,0 +1,37 @@
1
+ "use strict";
2
+ /**
3
+ * Copyright © 2026 Anonyome Labs, Inc. All rights reserved.
4
+ *
5
+ * SPDX-License-Identifier: Apache-2.0
6
+ */
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ exports.SubscribeToActionUseCase = void 0;
9
+ const sudo_common_1 = require("@sudoplatform/sudo-common");
10
+ /**
11
+ * Application business logic for subscribing to action status events.
12
+ */
13
+ class SubscribeToActionUseCase {
14
+ actionService;
15
+ sudoUserClient;
16
+ log;
17
+ constructor(actionService, sudoUserClient) {
18
+ this.actionService = actionService;
19
+ this.sudoUserClient = sudoUserClient;
20
+ this.log = new sudo_common_1.DefaultLogger(this.constructor.name);
21
+ }
22
+ async execute(input) {
23
+ this.log.debug(this.constructor.name, {
24
+ subscriptionId: input.subscriptionId,
25
+ });
26
+ const owner = await this.sudoUserClient.getSubject();
27
+ if (!owner) {
28
+ throw new sudo_common_1.NotSignedInError();
29
+ }
30
+ await this.actionService.subscribe({
31
+ subscriptionId: input.subscriptionId,
32
+ owner,
33
+ subscriber: input.subscriber,
34
+ });
35
+ }
36
+ }
37
+ exports.SubscribeToActionUseCase = SubscribeToActionUseCase;