@learncard/network-brain-service 3.18.0 → 3.19.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 (199) hide show
  1. package/.env.example +4 -0
  2. package/CHANGELOG.md +80 -0
  3. package/compose.inbox.yml +7 -0
  4. package/dist/accesslayer/auth-grant/read.d.ts +1 -0
  5. package/dist/accesslayer/auth-grant/read.d.ts.map +1 -1
  6. package/dist/accesslayer/credential-activity/create.d.ts.map +1 -1
  7. package/dist/accesslayer/credential-refresh/email-delivery.d.ts +18 -0
  8. package/dist/accesslayer/credential-refresh/email-delivery.d.ts.map +1 -0
  9. package/dist/accesslayer/credential-refresh/index.d.ts +1 -0
  10. package/dist/accesslayer/credential-refresh/index.d.ts.map +1 -1
  11. package/dist/accesslayer/credential-refresh/read.d.ts.map +1 -1
  12. package/dist/accesslayer/credential-refresh/update.d.ts.map +1 -1
  13. package/dist/accesslayer/inbox-batch/store.d.ts +33 -0
  14. package/dist/accesslayer/inbox-batch/store.d.ts.map +1 -0
  15. package/dist/accesslayer/inbox-credential/create.d.ts +5 -0
  16. package/dist/accesslayer/inbox-credential/create.d.ts.map +1 -1
  17. package/dist/accesslayer/inbox-credential/refresh.d.ts +71 -0
  18. package/dist/accesslayer/inbox-credential/refresh.d.ts.map +1 -0
  19. package/dist/accesslayer/inbox-credential/update.d.ts +1 -1
  20. package/dist/accesslayer/inbox-credential/update.d.ts.map +1 -1
  21. package/dist/cache/atomic-counter.test-helpers.d.ts +3 -0
  22. package/dist/cache/atomic-counter.test-helpers.d.ts.map +1 -0
  23. package/dist/cache/atomic-counter.test.d.ts +2 -0
  24. package/dist/cache/atomic-counter.test.d.ts.map +1 -0
  25. package/dist/cache/index.d.ts +1 -1
  26. package/dist/cache/index.d.ts.map +1 -1
  27. package/dist/config/environment.d.ts +46 -0
  28. package/dist/config/environment.d.ts.map +1 -1
  29. package/dist/credential-refresh.d.ts.map +1 -1
  30. package/dist/helpers/activity.helpers.d.ts +4 -0
  31. package/dist/helpers/activity.helpers.d.ts.map +1 -1
  32. package/dist/helpers/contact-method.helpers.d.ts.map +1 -1
  33. package/dist/helpers/contact-method.helpers.test.d.ts +2 -0
  34. package/dist/helpers/contact-method.helpers.test.d.ts.map +1 -0
  35. package/dist/helpers/credential-refresh-email-content.helpers.d.ts +44 -0
  36. package/dist/helpers/credential-refresh-email-content.helpers.d.ts.map +1 -0
  37. package/dist/helpers/credential-refresh-email-content.helpers.test.d.ts +2 -0
  38. package/dist/helpers/credential-refresh-email-content.helpers.test.d.ts.map +1 -0
  39. package/dist/helpers/credential-refresh-email.helpers.d.ts +17 -0
  40. package/dist/helpers/credential-refresh-email.helpers.d.ts.map +1 -0
  41. package/dist/helpers/credential-refresh-proof.helpers.d.ts +4 -0
  42. package/dist/helpers/credential-refresh-proof.helpers.d.ts.map +1 -0
  43. package/dist/helpers/credential-refresh-proof.helpers.test.d.ts +2 -0
  44. package/dist/helpers/credential-refresh-proof.helpers.test.d.ts.map +1 -0
  45. package/dist/helpers/credential-refresh.helpers.d.ts +45 -2
  46. package/dist/helpers/credential-refresh.helpers.d.ts.map +1 -1
  47. package/dist/helpers/credential.helpers.d.ts +2 -1
  48. package/dist/helpers/credential.helpers.d.ts.map +1 -1
  49. package/dist/helpers/finalize-inbox.helpers.d.ts.map +1 -1
  50. package/dist/helpers/inbox-batch-http.helpers.d.ts +15 -0
  51. package/dist/helpers/inbox-batch-http.helpers.d.ts.map +1 -0
  52. package/dist/helpers/inbox-batch-http.helpers.test.d.ts +2 -0
  53. package/dist/helpers/inbox-batch-http.helpers.test.d.ts.map +1 -0
  54. package/dist/helpers/inbox-batch-status.helpers.d.ts +3 -0
  55. package/dist/helpers/inbox-batch-status.helpers.d.ts.map +1 -0
  56. package/dist/helpers/inbox-batch.helpers.d.ts +10 -0
  57. package/dist/helpers/inbox-batch.helpers.d.ts.map +1 -0
  58. package/dist/helpers/inbox-batch.helpers.test.d.ts +2 -0
  59. package/dist/helpers/inbox-batch.helpers.test.d.ts.map +1 -0
  60. package/dist/helpers/inbox-issuance-error.helpers.d.ts +13 -0
  61. package/dist/helpers/inbox-issuance-error.helpers.d.ts.map +1 -0
  62. package/dist/helpers/inbox-queue.helpers.d.ts +11 -0
  63. package/dist/helpers/inbox-queue.helpers.d.ts.map +1 -0
  64. package/dist/helpers/inbox-queue.helpers.test.d.ts +2 -0
  65. package/dist/helpers/inbox-queue.helpers.test.d.ts.map +1 -0
  66. package/dist/helpers/inbox-refresh.helpers.d.ts +186 -0
  67. package/dist/helpers/inbox-refresh.helpers.d.ts.map +1 -0
  68. package/dist/helpers/inbox.helpers.d.ts +9 -1
  69. package/dist/helpers/inbox.helpers.d.ts.map +1 -1
  70. package/dist/helpers/notifications.helpers.d.ts.map +1 -1
  71. package/dist/helpers/rateLimit.helpers.d.ts.map +1 -1
  72. package/dist/helpers/refresh-send-intent.helpers.d.ts +51 -0
  73. package/dist/helpers/refresh-send-intent.helpers.d.ts.map +1 -0
  74. package/dist/helpers/shim.d.ts +1 -1
  75. package/dist/helpers/shim.d.ts.map +1 -1
  76. package/dist/inbox-queue-local.d.ts +2 -0
  77. package/dist/inbox-queue-local.d.ts.map +1 -0
  78. package/dist/index.js +2 -2
  79. package/dist/models/AuthGrant.d.ts.map +1 -1
  80. package/dist/models/CredentialActivity.d.ts +1 -0
  81. package/dist/models/CredentialActivity.d.ts.map +1 -1
  82. package/dist/models/CredentialRefresh.d.ts +5 -2
  83. package/dist/models/CredentialRefresh.d.ts.map +1 -1
  84. package/dist/models/InboxCredential.d.ts +1 -0
  85. package/dist/models/InboxCredential.d.ts.map +1 -1
  86. package/dist/models/credential-refresh-constraints.d.ts.map +1 -1
  87. package/dist/openapi.d.ts.map +1 -1
  88. package/dist/routes/act-as.test.d.ts +2 -0
  89. package/dist/routes/act-as.test.d.ts.map +1 -0
  90. package/dist/routes/activity.d.ts +3 -0
  91. package/dist/routes/activity.d.ts.map +1 -1
  92. package/dist/routes/auth-grants.d.ts +10 -0
  93. package/dist/routes/auth-grants.d.ts.map +1 -1
  94. package/dist/routes/boosts.d.ts +494 -0
  95. package/dist/routes/boosts.d.ts.map +1 -1
  96. package/dist/routes/credential-refreshes.d.ts.map +1 -1
  97. package/dist/routes/credentials.d.ts.map +1 -1
  98. package/dist/routes/inbox.d.ts +953 -11
  99. package/dist/routes/inbox.d.ts.map +1 -1
  100. package/dist/routes/index.d.ts +42 -126
  101. package/dist/routes/index.d.ts.map +1 -1
  102. package/dist/routes/workflows.d.ts.map +1 -1
  103. package/dist/services/delivery/adapters/postmark.adapter.d.ts.map +1 -1
  104. package/dist/services/delivery/adapters/postmark.adapter.test.d.ts +2 -0
  105. package/dist/services/delivery/adapters/postmark.adapter.test.d.ts.map +1 -0
  106. package/dist/services/registry/registry.factory.d.ts.map +1 -1
  107. package/dist/types/activity.d.ts +4 -0
  108. package/dist/types/activity.d.ts.map +1 -1
  109. package/dist/types/credential-refresh.d.ts +10 -1
  110. package/dist/types/credential-refresh.d.ts.map +1 -1
  111. package/dist/types/inbox-batch.d.ts +38 -0
  112. package/dist/types/inbox-batch.d.ts.map +1 -0
  113. package/inbox-e2e-setup.ts +53 -1
  114. package/inbox-elasticmq.conf +10 -0
  115. package/lambda.ts +61 -16
  116. package/package.json +18 -16
  117. package/scripts/setup-inbox-queues.ts +60 -0
  118. package/serverless-local.yml +2 -0
  119. package/serverless.yml +75 -0
  120. package/src/accesslayer/auth-grant/read.ts +2 -1
  121. package/src/accesslayer/credential-activity/create.ts +1 -0
  122. package/src/accesslayer/credential-refresh/email-delivery.ts +116 -0
  123. package/src/accesslayer/credential-refresh/index.ts +1 -0
  124. package/src/accesslayer/credential-refresh/read.ts +8 -2
  125. package/src/accesslayer/credential-refresh/update.ts +4 -0
  126. package/src/accesslayer/inbox-batch/store.ts +469 -0
  127. package/src/accesslayer/inbox-credential/create.ts +51 -19
  128. package/src/accesslayer/inbox-credential/refresh.ts +221 -0
  129. package/src/accesslayer/inbox-credential/update.ts +1 -1
  130. package/src/cache/atomic-counter.test-helpers.ts +27 -0
  131. package/src/cache/atomic-counter.test.ts +6 -0
  132. package/src/cache/index.ts +25 -13
  133. package/src/config/environment.ts +26 -0
  134. package/src/credential-refresh.ts +5 -1
  135. package/src/docker-entry.ts +8 -0
  136. package/src/helpers/activity.helpers.ts +4 -0
  137. package/src/helpers/app-counter.helpers.ts +1 -1
  138. package/src/helpers/contact-method.helpers.test.ts +43 -0
  139. package/src/helpers/contact-method.helpers.ts +3 -4
  140. package/src/helpers/credential-refresh-email-content.helpers.test.ts +222 -0
  141. package/src/helpers/credential-refresh-email-content.helpers.ts +155 -0
  142. package/src/helpers/credential-refresh-email.helpers.ts +201 -0
  143. package/src/helpers/credential-refresh-proof.helpers.test.ts +103 -0
  144. package/src/helpers/credential-refresh-proof.helpers.ts +43 -0
  145. package/src/helpers/credential-refresh.helpers.ts +375 -99
  146. package/src/helpers/credential.helpers.ts +4 -1
  147. package/src/helpers/finalize-inbox.helpers.ts +29 -14
  148. package/src/helpers/inbox-batch-http.helpers.test.ts +188 -0
  149. package/src/helpers/inbox-batch-http.helpers.ts +150 -0
  150. package/src/helpers/inbox-batch-status.helpers.ts +11 -0
  151. package/src/helpers/inbox-batch.helpers.test.ts +668 -0
  152. package/src/helpers/inbox-batch.helpers.ts +374 -0
  153. package/src/helpers/inbox-issuance-error.helpers.ts +25 -0
  154. package/src/helpers/inbox-queue.helpers.test.ts +253 -0
  155. package/src/helpers/inbox-queue.helpers.ts +372 -0
  156. package/src/helpers/inbox-refresh.helpers.ts +432 -0
  157. package/src/helpers/inbox.helpers.ts +268 -32
  158. package/src/helpers/notifications.helpers.ts +4 -2
  159. package/src/helpers/rateLimit.helpers.ts +2 -5
  160. package/src/helpers/refresh-send-intent.helpers.ts +273 -0
  161. package/src/helpers/shim.ts +32 -31
  162. package/src/inbox-queue-local.ts +28 -0
  163. package/src/models/AuthGrant.ts +1 -0
  164. package/src/models/CredentialActivity.ts +3 -5
  165. package/src/models/CredentialRefresh.ts +4 -2
  166. package/src/models/InboxCredential.ts +2 -0
  167. package/src/models/credential-refresh-constraints.test.ts +8 -3
  168. package/src/models/credential-refresh-constraints.ts +5 -0
  169. package/src/openapi.ts +8 -0
  170. package/src/routes/act-as.test.ts +239 -0
  171. package/src/routes/app-store.ts +2 -2
  172. package/src/routes/auth-grants.ts +13 -11
  173. package/src/routes/boosts.ts +914 -92
  174. package/src/routes/credential-refreshes.test.ts +8 -2
  175. package/src/routes/credential-refreshes.ts +4 -1
  176. package/src/routes/credentials.ts +2 -1
  177. package/src/routes/inbox.ts +95 -49
  178. package/src/routes/index.ts +82 -7
  179. package/src/routes/skills.ts +1 -1
  180. package/src/routes/workflows.ts +43 -24
  181. package/src/services/delivery/adapters/postmark.adapter.test.ts +54 -0
  182. package/src/services/delivery/adapters/postmark.adapter.ts +12 -0
  183. package/src/services/registry/registry.factory.ts +2 -1
  184. package/src/types/activity.ts +2 -0
  185. package/src/types/credential-refresh.ts +21 -2
  186. package/src/types/inbox-batch.ts +46 -0
  187. package/test/atomic-counter.e2e.ts +12 -0
  188. package/test/auth-grant.spec.ts +21 -21
  189. package/test/credential-refresh-email.spec.ts +663 -0
  190. package/test/credential-refresh-publication.spec.ts +2 -0
  191. package/test/helpers/inbox-e2e-environment.ts +6 -0
  192. package/test/inbox-batch.spec.ts +1338 -0
  193. package/test/inbox-refresh.spec.ts +534 -0
  194. package/test/openapi.spec.ts +41 -1
  195. package/test/refresh-send.spec.ts +1799 -0
  196. package/test/registry.spec.ts +56 -11
  197. package/vitest.config.ts +9 -0
  198. package/vitest.inbox-e2e.config.ts +5 -1
  199. package/vitest.integration.config.ts +2 -0
@@ -1,8 +1,30 @@
1
- import { getRegistryService } from '@services/registry/registry.factory';
2
-
3
1
  describe('Registry Service', () => {
4
2
  const originalEnv = process.env;
5
3
 
4
+ const getRegistryServiceForEnvironment = async (
5
+ overrides: Record<string, string | undefined>
6
+ ) => {
7
+ process.env = {
8
+ ...originalEnv,
9
+ SEED: originalEnv.SEED ?? 'registry-test-seed',
10
+ NEO4J_URI: originalEnv.NEO4J_URI ?? 'bolt://localhost:7687',
11
+ NEO4J_USERNAME: originalEnv.NEO4J_USERNAME ?? 'neo4j',
12
+ NEO4J_PASSWORD: originalEnv.NEO4J_PASSWORD ?? 'registry-test-password',
13
+ DOMAIN_NAME: originalEnv.DOMAIN_NAME ?? 'localhost%3A3000',
14
+ CREDENTIAL_REFRESH_DIGEST_SECRET:
15
+ originalEnv.CREDENTIAL_REFRESH_DIGEST_SECRET ?? 'registry-test-refresh-secret',
16
+ };
17
+
18
+ Object.entries(overrides).forEach(([key, value]) => {
19
+ if (value === undefined) delete process.env[key];
20
+ else process.env[key] = value;
21
+ });
22
+
23
+ vi.resetModules();
24
+
25
+ return (await import('@services/registry/registry.factory')).getRegistryService();
26
+ };
27
+
6
28
  beforeEach(() => {
7
29
  process.env = { ...originalEnv };
8
30
  });
@@ -13,8 +35,12 @@ describe('Registry Service', () => {
13
35
 
14
36
  describe('Whitelist Adapter', () => {
15
37
  it('should use WhitelistAdapter when TRUSTED_ISSUERS_WHITELIST is set', async () => {
16
- process.env.TRUSTED_ISSUERS_WHITELIST = 'did:example:123,did:example:456';
17
- const registry = getRegistryService();
38
+ const registry = await getRegistryServiceForEnvironment({
39
+ NODE_ENV: 'production',
40
+ IS_CI: 'false',
41
+ IS_E2E_TEST: 'false',
42
+ TRUSTED_ISSUERS_WHITELIST: 'did:example:123,did:example:456',
43
+ });
18
44
  expect(registry.constructor.name).toBe('WhitelistAdapter');
19
45
  expect(await registry.isTrusted('did:example:123')).toBe(true);
20
46
  expect(await registry.isTrusted('did:example:456')).toBe(true);
@@ -23,21 +49,40 @@ describe('Registry Service', () => {
23
49
  const issuerDoc = await registry.getIssuer('did:example:123');
24
50
  expect(issuerDoc).not.toBeNull();
25
51
  if (!issuerDoc?.matchingIssuers?.[0]) throw new Error('Issuer doc is null');
26
- expect(issuerDoc.matchingIssuers[0].issuer.federation_entity.organization_name).toBe('Whitelisted Issuer');
52
+ expect(issuerDoc.matchingIssuers[0].issuer.federation_entity.organization_name).toBe(
53
+ 'Whitelisted Issuer'
54
+ );
27
55
  });
28
56
 
29
57
  it('should use WhitelistAdapter in test environment', async () => {
30
- process.env.NODE_ENV = 'test';
31
- const registry = getRegistryService();
58
+ const registry = await getRegistryServiceForEnvironment({
59
+ NODE_ENV: 'test',
60
+ IS_CI: 'false',
61
+ IS_E2E_TEST: 'false',
62
+ TRUSTED_ISSUERS_WHITELIST: undefined,
63
+ });
64
+ expect(registry.constructor.name).toBe('WhitelistAdapter');
65
+ });
66
+
67
+ it('should use WhitelistAdapter in E2E environment', async () => {
68
+ const registry = await getRegistryServiceForEnvironment({
69
+ NODE_ENV: 'production',
70
+ IS_CI: 'false',
71
+ IS_E2E_TEST: 'true',
72
+ TRUSTED_ISSUERS_WHITELIST: undefined,
73
+ });
32
74
  expect(registry.constructor.name).toBe('WhitelistAdapter');
33
75
  });
34
76
  });
35
77
 
36
78
  describe('DccIssuerRegistryAdapter', () => {
37
- it('should use DccIssuerRegistryAdapter when TRUSTED_ISSUERS_WHITELIST is not set and not in test env', () => {
38
- process.env.NODE_ENV = 'production';
39
- delete process.env.TRUSTED_ISSUERS_WHITELIST;
40
- const registry = getRegistryService();
79
+ it('should use DccIssuerRegistryAdapter outside test environments without a whitelist', async () => {
80
+ const registry = await getRegistryServiceForEnvironment({
81
+ NODE_ENV: 'production',
82
+ IS_CI: 'false',
83
+ IS_E2E_TEST: 'false',
84
+ TRUSTED_ISSUERS_WHITELIST: undefined,
85
+ });
41
86
  expect(registry.constructor.name).toBe('DccIssuerRegistryAdapter');
42
87
  });
43
88
  });
package/vitest.config.ts CHANGED
@@ -15,7 +15,13 @@ export default createVitestConfig(brainServicePreset, {
15
15
  'test/notificationMessages.spec.ts',
16
16
  'src/helpers/posthog.helpers.test.ts',
17
17
  'src/helpers/rateLimit.helpers.test.ts',
18
+ 'src/helpers/inbox-batch.helpers.test.ts',
19
+ 'src/helpers/inbox-queue.helpers.test.ts',
20
+ 'src/helpers/inbox-batch-http.helpers.test.ts',
21
+ 'src/cache/atomic-counter.test.ts',
18
22
  'src/helpers/credential-refresh-auth.helpers.test.ts',
23
+ 'src/helpers/credential-refresh-proof.helpers.test.ts',
24
+ 'src/helpers/credential-refresh-email-content.helpers.test.ts',
19
25
  'src/helpers/credential-refresh-initial-binding.helpers.test.ts',
20
26
  'src/helpers/credential-refresh-materiality.helpers.test.ts',
21
27
  'src/helpers/credential-refresh-notification-policy.helpers.test.ts',
@@ -24,6 +30,7 @@ export default createVitestConfig(brainServicePreset, {
24
30
  'src/accesslayer/credential-refresh/read.test.ts',
25
31
  'src/models/credential-refresh-constraints.test.ts',
26
32
  'src/routes/credential-refreshes.test.ts',
33
+ 'src/routes/act-as.test.ts',
27
34
  'src/helpers/percentile.helpers.test.ts',
28
35
  'src/helpers/perf.test.ts',
29
36
  'src/helpers/signingAuthority.helpers.test.ts',
@@ -32,6 +39,8 @@ export default createVitestConfig(brainServicePreset, {
32
39
  'src/accesslayer/credential/create.test.ts',
33
40
  'src/helpers/inbox-encryption.helpers.test.ts',
34
41
  'src/helpers/send-inbox-config.helpers.test.ts',
42
+ 'src/helpers/contact-method.helpers.test.ts',
43
+ 'src/services/delivery/adapters/postmark.adapter.test.ts',
35
44
  'src/helpers/inbox-maintenance.helpers.test.ts',
36
45
  ],
37
46
  },
@@ -8,7 +8,11 @@ export default createVitestConfig(serviceIntegrationPreset, {
8
8
  test: {
9
9
  globalSetup: './inbox-e2e-setup.ts',
10
10
  setupFiles: ['./test/helpers/inbox-e2e-environment.ts'],
11
- include: ['test/inbox-security.e2e.ts'],
11
+ include: [
12
+ 'test/inbox-security.e2e.ts',
13
+ 'test/inbox-batch.spec.ts',
14
+ 'test/atomic-counter.e2e.ts',
15
+ ],
12
16
  alias: { '@instance': require.resolve('./test/helpers/mock-instance.ts') },
13
17
  env: {
14
18
  NODE_ENV: 'test',
@@ -8,6 +8,8 @@ export default createVitestConfig(serviceIntegrationPreset, {
8
8
  test: {
9
9
  globalSetup: './test-setup.ts',
10
10
  include: ['test/**/*.spec.ts'],
11
+ // Batch tests require SQS as well as Neo4j; run via test:inbox:e2e.
12
+ exclude: ['test/inbox-batch.spec.ts'],
11
13
  alias: { '@instance': require.resolve('./test/helpers/mock-instance.ts') },
12
14
  env: {
13
15
  IS_E2E_TEST: 'true',