@adtrackify/at-service-common 4.0.4 → 4.0.5

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 (715) hide show
  1. package/dist/cjs/__tests__/clients/acuity-client.spec.d.ts +1 -1
  2. package/dist/cjs/__tests__/clients/acuity-client.spec.js +43 -43
  3. package/dist/cjs/__tests__/clients/cross-platform-compression.spec.d.ts +1 -1
  4. package/dist/cjs/__tests__/clients/cross-platform-compression.spec.js +354 -354
  5. package/dist/cjs/__tests__/clients/dynamodb-client.spec.d.ts +1 -1
  6. package/dist/cjs/__tests__/clients/dynamodb-client.spec.js +194 -194
  7. package/dist/cjs/__tests__/clients/sqs-bundled-client.spec.d.ts +1 -1
  8. package/dist/cjs/__tests__/clients/sqs-bundled-client.spec.js +931 -931
  9. package/dist/cjs/__tests__/clients/sqs-bundling-contracts.spec.d.ts +1 -1
  10. package/dist/cjs/__tests__/clients/sqs-bundling-contracts.spec.js +563 -563
  11. package/dist/cjs/__tests__/clients/sqs-client.spec.d.ts +1 -1
  12. package/dist/cjs/__tests__/clients/sqs-client.spec.js +191 -191
  13. package/dist/cjs/__tests__/clients/sqs-unbundle.spec.d.ts +1 -1
  14. package/dist/cjs/__tests__/clients/sqs-unbundle.spec.js +1357 -1357
  15. package/dist/cjs/__tests__/db/contact-enrichments-db-service.spec.d.ts +1 -1
  16. package/dist/cjs/__tests__/db/contact-enrichments-db-service.spec.js +68 -68
  17. package/dist/cjs/__tests__/db/destinations-db-service.spec.d.ts +1 -1
  18. package/dist/cjs/__tests__/db/destinations-db-service.spec.js +125 -125
  19. package/dist/cjs/__tests__/db/products-db-service.spec.d.ts +1 -1
  20. package/dist/cjs/__tests__/db/products-db-service.spec.js +89 -89
  21. package/dist/cjs/__tests__/db/shared-read-db-services.spec.d.ts +1 -1
  22. package/dist/cjs/__tests__/db/shared-read-db-services.spec.js +89 -89
  23. package/dist/cjs/__tests__/db/shopify-app-installs-db-service.spec.d.ts +1 -1
  24. package/dist/cjs/__tests__/db/shopify-app-installs-db-service.spec.js +104 -104
  25. package/dist/cjs/__tests__/db/subscriptions-db-service.spec.d.ts +1 -1
  26. package/dist/cjs/__tests__/db/subscriptions-db-service.spec.js +95 -95
  27. package/dist/cjs/__tests__/db/user-accounts-db-service.spec.d.ts +1 -1
  28. package/dist/cjs/__tests__/db/user-accounts-db-service.spec.js +76 -76
  29. package/dist/cjs/__tests__/helpers/account-users-helper.spec.d.ts +1 -1
  30. package/dist/cjs/__tests__/helpers/account-users-helper.spec.js +220 -220
  31. package/dist/cjs/__tests__/helpers/acuity-helper.spec.d.ts +1 -1
  32. package/dist/cjs/__tests__/helpers/acuity-helper.spec.js +69 -69
  33. package/dist/cjs/__tests__/helpers/api-key-auth-helper.spec.d.ts +1 -1
  34. package/dist/cjs/__tests__/helpers/api-key-auth-helper.spec.js +82 -82
  35. package/dist/cjs/__tests__/identity-cache/identity-cache-db-service.spec.d.ts +1 -1
  36. package/dist/cjs/__tests__/identity-cache/identity-cache-db-service.spec.js +676 -676
  37. package/dist/cjs/__tests__/identity-cache/identity-cache-dynamodb-service.spec.d.ts +1 -1
  38. package/dist/cjs/__tests__/identity-cache/identity-cache-dynamodb-service.spec.js +1140 -1140
  39. package/dist/cjs/__tests__/identity-cache/identity-cache-tier-routing.spec.d.ts +1 -1
  40. package/dist/cjs/__tests__/identity-cache/identity-cache-tier-routing.spec.js +851 -851
  41. package/dist/cjs/__tests__/identity-cache/trait-merging-and-staleness.spec.d.ts +1 -1
  42. package/dist/cjs/__tests__/identity-cache/trait-merging-and-staleness.spec.js +1060 -1060
  43. package/dist/cjs/__tests__/identity-cache/volatile-traits-optimization.spec.d.ts +1 -1
  44. package/dist/cjs/__tests__/identity-cache/volatile-traits-optimization.spec.js +818 -818
  45. package/dist/cjs/__tests__/integration/sqs-bundling-roundtrip.spec.d.ts +1 -1
  46. package/dist/cjs/__tests__/integration/sqs-bundling-roundtrip.spec.js +584 -584
  47. package/dist/cjs/__tests__/libs/compress-decompress.spec.d.ts +1 -1
  48. package/dist/cjs/__tests__/libs/compress-decompress.spec.js +16 -16
  49. package/dist/cjs/__tests__/libs/contacts.spec.d.ts +1 -1
  50. package/dist/cjs/__tests__/libs/contacts.spec.js +294 -294
  51. package/dist/cjs/__tests__/libs/currency.spec.d.ts +1 -1
  52. package/dist/cjs/__tests__/libs/currency.spec.js +220 -220
  53. package/dist/cjs/__tests__/libs/dates.spec.d.ts +1 -1
  54. package/dist/cjs/__tests__/libs/dates.spec.js +130 -130
  55. package/dist/cjs/__tests__/libs/domain.spec.d.ts +1 -1
  56. package/dist/cjs/__tests__/libs/domain.spec.js +107 -107
  57. package/dist/cjs/__tests__/libs/numbers.spec.d.ts +1 -1
  58. package/dist/cjs/__tests__/libs/numbers.spec.js +261 -261
  59. package/dist/cjs/__tests__/s3-client/s3-client.spec.d.ts +1 -1
  60. package/dist/cjs/__tests__/s3-client/s3-client.spec.js +33 -33
  61. package/dist/cjs/__tests__/services/acuity-api-service.spec.d.ts +1 -1
  62. package/dist/cjs/__tests__/services/acuity-api-service.spec.js +71 -71
  63. package/dist/cjs/__tests__/services/cost/cost-calculation-types.spec.d.ts +1 -1
  64. package/dist/cjs/__tests__/services/cost/cost-calculation-types.spec.js +23 -23
  65. package/dist/cjs/__tests__/services/cost/cost-calculator-service.spec.d.ts +1 -1
  66. package/dist/cjs/__tests__/services/cost/cost-calculator-service.spec.js +3319 -3319
  67. package/dist/cjs/__tests__/services/cost/cost-currency-service.spec.d.ts +1 -1
  68. package/dist/cjs/__tests__/services/cost/cost-currency-service.spec.js +114 -114
  69. package/dist/cjs/__tests__/services/cost/cost-filter-service.spec.d.ts +1 -1
  70. package/dist/cjs/__tests__/services/cost/cost-filter-service.spec.js +468 -468
  71. package/dist/cjs/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.d.ts +1 -1
  72. package/dist/cjs/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.js +206 -206
  73. package/dist/cjs/__tests__/services/currency-exchange-rate-lookup-service.spec.d.ts +1 -1
  74. package/dist/cjs/__tests__/services/currency-exchange-rate-lookup-service.spec.js +34 -34
  75. package/dist/cjs/__tests__/services/email-verification/contact-email-verification-service.spec.d.ts +1 -1
  76. package/dist/cjs/__tests__/services/email-verification/contact-email-verification-service.spec.js +93 -93
  77. package/dist/cjs/__tests__/services/email-verification/email-verification-service.spec.d.ts +1 -1
  78. package/dist/cjs/__tests__/services/email-verification/email-verification-service.spec.js +57 -57
  79. package/dist/cjs/__tests__/shopify/shopify-graphql-transformer.spec.d.ts +1 -1
  80. package/dist/cjs/__tests__/shopify/shopify-graphql-transformer.spec.js +35 -35
  81. package/dist/cjs/__tests__/unit/libs/api-router/public-api-router.spec.d.ts +1 -1
  82. package/dist/cjs/__tests__/unit/libs/api-router/public-api-router.spec.js +181 -181
  83. package/dist/cjs/__tests__/unit/libs/api-router/route-matcher.spec.d.ts +1 -1
  84. package/dist/cjs/__tests__/unit/libs/api-router/route-matcher.spec.js +69 -69
  85. package/dist/cjs/__tests__/utils/custom-measure-formula-utils.spec.d.ts +1 -1
  86. package/dist/cjs/__tests__/utils/custom-measure-formula-utils.spec.js +139 -139
  87. package/dist/cjs/clients/generic/cognito-client.d.ts +23 -23
  88. package/dist/cjs/clients/generic/cognito-client.js +209 -209
  89. package/dist/cjs/clients/generic/dynamodb-client.d.ts +20 -20
  90. package/dist/cjs/clients/generic/dynamodb-client.js +235 -235
  91. package/dist/cjs/clients/generic/eventbridge-client.d.ts +14 -14
  92. package/dist/cjs/clients/generic/eventbridge-client.js +51 -51
  93. package/dist/cjs/clients/generic/http-client.d.ts +14 -14
  94. package/dist/cjs/clients/generic/http-client.js +61 -61
  95. package/dist/cjs/clients/generic/index.d.ts +13 -13
  96. package/dist/cjs/clients/generic/index.js +29 -29
  97. package/dist/cjs/clients/generic/lambda-invoke-client.d.ts +10 -10
  98. package/dist/cjs/clients/generic/lambda-invoke-client.js +39 -39
  99. package/dist/cjs/clients/generic/location-client.d.ts +8 -8
  100. package/dist/cjs/clients/generic/location-client.js +31 -31
  101. package/dist/cjs/clients/generic/redis-client.d.ts +33 -33
  102. package/dist/cjs/clients/generic/redis-client.js +191 -191
  103. package/dist/cjs/clients/generic/s3-client.d.ts +23 -23
  104. package/dist/cjs/clients/generic/s3-client.js +216 -216
  105. package/dist/cjs/clients/generic/singlestore-db-client.d.ts +14 -14
  106. package/dist/cjs/clients/generic/singlestore-db-client.js +67 -67
  107. package/dist/cjs/clients/generic/sqs-bundled-client.d.ts +15 -15
  108. package/dist/cjs/clients/generic/sqs-bundled-client.js +311 -311
  109. package/dist/cjs/clients/generic/sqs-bundled-client.types.d.ts +53 -53
  110. package/dist/cjs/clients/generic/sqs-bundled-client.types.js +17 -17
  111. package/dist/cjs/clients/generic/sqs-client.d.ts +53 -53
  112. package/dist/cjs/clients/generic/sqs-client.js +285 -285
  113. package/dist/cjs/clients/generic/sqs-unbundle.d.ts +32 -32
  114. package/dist/cjs/clients/generic/sqs-unbundle.js +144 -144
  115. package/dist/cjs/clients/index.d.ts +3 -3
  116. package/dist/cjs/clients/index.js +19 -19
  117. package/dist/cjs/clients/internal-api/accounts-client.d.ts +91 -91
  118. package/dist/cjs/clients/internal-api/accounts-client.js +129 -129
  119. package/dist/cjs/clients/internal-api/cache-lambda-client.d.ts +26 -26
  120. package/dist/cjs/clients/internal-api/cache-lambda-client.js +89 -89
  121. package/dist/cjs/clients/internal-api/db-management-client.d.ts +18 -18
  122. package/dist/cjs/clients/internal-api/db-management-client.js +36 -36
  123. package/dist/cjs/clients/internal-api/destinations-client.d.ts +34 -34
  124. package/dist/cjs/clients/internal-api/destinations-client.js +79 -79
  125. package/dist/cjs/clients/internal-api/event-collector-client.d.ts +20 -20
  126. package/dist/cjs/clients/internal-api/event-collector-client.js +36 -36
  127. package/dist/cjs/clients/internal-api/identity-client.d.ts +31 -31
  128. package/dist/cjs/clients/internal-api/identity-client.js +91 -91
  129. package/dist/cjs/clients/internal-api/index.d.ts +9 -9
  130. package/dist/cjs/clients/internal-api/index.js +25 -25
  131. package/dist/cjs/clients/internal-api/shopify-app-install-client.d.ts +37 -37
  132. package/dist/cjs/clients/internal-api/shopify-app-install-client.js +81 -81
  133. package/dist/cjs/clients/internal-api/subscriptions-client.d.ts +26 -26
  134. package/dist/cjs/clients/internal-api/subscriptions-client.js +77 -77
  135. package/dist/cjs/clients/internal-api/users-auth-client.d.ts +35 -35
  136. package/dist/cjs/clients/internal-api/users-auth-client.js +110 -110
  137. package/dist/cjs/clients/third-party/acuity-client.d.ts +10 -10
  138. package/dist/cjs/clients/third-party/acuity-client.js +40 -40
  139. package/dist/cjs/clients/third-party/emailable-client.d.ts +7 -7
  140. package/dist/cjs/clients/third-party/emailable-client.js +25 -25
  141. package/dist/cjs/clients/third-party/exchange-rate-api-client.d.ts +17 -17
  142. package/dist/cjs/clients/third-party/exchange-rate-api-client.js +19 -19
  143. package/dist/cjs/clients/third-party/index.d.ts +5 -5
  144. package/dist/cjs/clients/third-party/index.js +21 -21
  145. package/dist/cjs/clients/third-party/loops-client.d.ts +10 -10
  146. package/dist/cjs/clients/third-party/loops-client.js +30 -30
  147. package/dist/cjs/clients/third-party/shopify/graphql-order-queries.d.ts +25 -25
  148. package/dist/cjs/clients/third-party/shopify/graphql-order-queries.js +4 -4
  149. package/dist/cjs/clients/third-party/shopify/graphql-product-queries.d.ts +2 -2
  150. package/dist/cjs/clients/third-party/shopify/graphql-product-queries.js +5 -5
  151. package/dist/cjs/clients/third-party/shopify/shopify-graphql-client.d.ts +10 -10
  152. package/dist/cjs/clients/third-party/shopify/shopify-graphql-client.js +161 -161
  153. package/dist/cjs/clients/third-party/shopify-client.d.ts +29 -29
  154. package/dist/cjs/clients/third-party/shopify-client.js +146 -146
  155. package/dist/cjs/constants/index.d.ts +1 -1
  156. package/dist/cjs/constants/index.js +17 -17
  157. package/dist/cjs/constants/sqs.d.ts +20 -20
  158. package/dist/cjs/constants/sqs.js +26 -26
  159. package/dist/cjs/helpers/account-users-helper.d.ts +2 -2
  160. package/dist/cjs/helpers/account-users-helper.js +22 -22
  161. package/dist/cjs/helpers/acuity-helper.d.ts +4 -4
  162. package/dist/cjs/helpers/acuity-helper.js +56 -56
  163. package/dist/cjs/helpers/api-key-auth-helper.d.ts +9 -9
  164. package/dist/cjs/helpers/api-key-auth-helper.js +40 -40
  165. package/dist/cjs/helpers/api-key-authorizer-helper.d.ts +36 -36
  166. package/dist/cjs/helpers/api-key-authorizer-helper.js +87 -87
  167. package/dist/cjs/helpers/identity-cache-helper.d.ts +30 -30
  168. package/dist/cjs/helpers/identity-cache-helper.js +253 -253
  169. package/dist/cjs/helpers/index.d.ts +10 -10
  170. package/dist/cjs/helpers/index.js +26 -26
  171. package/dist/cjs/helpers/input-validation-helper.d.ts +3 -3
  172. package/dist/cjs/helpers/input-validation-helper.js +22 -22
  173. package/dist/cjs/helpers/logging-helper.d.ts +16 -16
  174. package/dist/cjs/helpers/logging-helper.js +84 -84
  175. package/dist/cjs/helpers/response-helper.d.ts +18 -18
  176. package/dist/cjs/helpers/response-helper.js +43 -43
  177. package/dist/cjs/helpers/shopify-helper.d.ts +9 -9
  178. package/dist/cjs/helpers/shopify-helper.js +26 -26
  179. package/dist/cjs/helpers/sqs-utils.d.ts +6 -6
  180. package/dist/cjs/helpers/sqs-utils.js +14 -14
  181. package/dist/cjs/index.d.ts +7 -7
  182. package/dist/cjs/index.js +23 -23
  183. package/dist/cjs/libs/api-router/index.d.ts +2 -2
  184. package/dist/cjs/libs/api-router/index.js +18 -18
  185. package/dist/cjs/libs/api-router/public-api-router.d.ts +3 -3
  186. package/dist/cjs/libs/api-router/public-api-router.js +36 -36
  187. package/dist/cjs/libs/api-router/route-matcher.d.ts +21 -21
  188. package/dist/cjs/libs/api-router/route-matcher.js +36 -36
  189. package/dist/cjs/libs/click-id-parser.d.ts +23 -23
  190. package/dist/cjs/libs/click-id-parser.js +49 -49
  191. package/dist/cjs/libs/compression.d.ts +2 -2
  192. package/dist/cjs/libs/compression.js +33 -33
  193. package/dist/cjs/libs/contacts.d.ts +7 -7
  194. package/dist/cjs/libs/contacts.js +152 -152
  195. package/dist/cjs/libs/cookie.d.ts +17 -17
  196. package/dist/cjs/libs/cookie.js +76 -76
  197. package/dist/cjs/libs/crypto.d.ts +4 -4
  198. package/dist/cjs/libs/crypto.js +25 -25
  199. package/dist/cjs/libs/csv.d.ts +2 -2
  200. package/dist/cjs/libs/csv.js +35 -35
  201. package/dist/cjs/libs/currency.d.ts +1 -1
  202. package/dist/cjs/libs/currency.js +29 -29
  203. package/dist/cjs/libs/dates.d.ts +12 -12
  204. package/dist/cjs/libs/dates.js +96 -96
  205. package/dist/cjs/libs/domain.d.ts +2 -2
  206. package/dist/cjs/libs/domain.js +38 -38
  207. package/dist/cjs/libs/emails.d.ts +8 -8
  208. package/dist/cjs/libs/emails.js +154 -154
  209. package/dist/cjs/libs/http-error.d.ts +21 -21
  210. package/dist/cjs/libs/http-error.js +63 -63
  211. package/dist/cjs/libs/http-status-codes.d.ts +58 -58
  212. package/dist/cjs/libs/http-status-codes.js +62 -62
  213. package/dist/cjs/libs/index.d.ts +19 -19
  214. package/dist/cjs/libs/index.js +35 -35
  215. package/dist/cjs/libs/numbers.d.ts +1 -1
  216. package/dist/cjs/libs/numbers.js +15 -15
  217. package/dist/cjs/libs/referrer-parser/index.d.ts +2 -2
  218. package/dist/cjs/libs/referrer-parser/index.js +18 -18
  219. package/dist/cjs/libs/referrer-parser/referrer-data.d.ts +9 -9
  220. package/dist/cjs/libs/referrer-parser/referrer-data.js +3307 -3307
  221. package/dist/cjs/libs/referrer-parser/referrer-parser-util.d.ts +20 -20
  222. package/dist/cjs/libs/referrer-parser/referrer-parser-util.js +131 -131
  223. package/dist/cjs/libs/strings.d.ts +3 -3
  224. package/dist/cjs/libs/strings.js +46 -46
  225. package/dist/cjs/libs/traits.d.ts +6 -6
  226. package/dist/cjs/libs/traits.js +65 -65
  227. package/dist/cjs/libs/url.d.ts +1 -1
  228. package/dist/cjs/libs/url.js +13 -13
  229. package/dist/cjs/services/acuity-api-service.d.ts +9 -9
  230. package/dist/cjs/services/acuity-api-service.js +73 -73
  231. package/dist/cjs/services/cache/generic-cached-object.d.ts +5 -5
  232. package/dist/cjs/services/cache/generic-cached-object.js +2 -2
  233. package/dist/cjs/services/cache/index.d.ts +1 -1
  234. package/dist/cjs/services/cache/index.js +17 -17
  235. package/dist/cjs/services/cache/product-cache-service.d.ts +21 -21
  236. package/dist/cjs/services/cache/product-cache-service.js +76 -76
  237. package/dist/cjs/services/cost/cost-calculation-types.d.ts +69 -69
  238. package/dist/cjs/services/cost/cost-calculation-types.js +19 -19
  239. package/dist/cjs/services/cost/cost-calculator-service.d.ts +24 -24
  240. package/dist/cjs/services/cost/cost-calculator-service.js +456 -456
  241. package/dist/cjs/services/cost/cost-currency-service.d.ts +6 -6
  242. package/dist/cjs/services/cost/cost-currency-service.js +87 -87
  243. package/dist/cjs/services/cost/cost-filter-service.d.ts +10 -10
  244. package/dist/cjs/services/cost/cost-filter-service.js +121 -121
  245. package/dist/cjs/services/cost/index.d.ts +5 -5
  246. package/dist/cjs/services/cost/index.js +21 -21
  247. package/dist/cjs/services/cost/order-cost/index.d.ts +2 -2
  248. package/dist/cjs/services/cost/order-cost/index.js +18 -18
  249. package/dist/cjs/services/cost/order-cost/order-cost-resolution-service.d.ts +23 -23
  250. package/dist/cjs/services/cost/order-cost/order-cost-resolution-service.js +361 -361
  251. package/dist/cjs/services/cost/order-cost/order-cost-resolution-types.d.ts +37 -37
  252. package/dist/cjs/services/cost/order-cost/order-cost-resolution-types.js +2 -2
  253. package/dist/cjs/services/currency-exchange-rate-lookup-service.d.ts +12 -12
  254. package/dist/cjs/services/currency-exchange-rate-lookup-service.js +94 -94
  255. package/dist/cjs/services/db/accounts-db-service.d.ts +9 -9
  256. package/dist/cjs/services/db/accounts-db-service.js +33 -33
  257. package/dist/cjs/services/db/api-keys-db-service.d.ts +10 -10
  258. package/dist/cjs/services/db/api-keys-db-service.js +36 -36
  259. package/dist/cjs/services/db/contact-enrichments-db-service.d.ts +15 -15
  260. package/dist/cjs/services/db/contact-enrichments-db-service.js +94 -94
  261. package/dist/cjs/services/db/currency-exchange-rates-db-service.d.ts +21 -21
  262. package/dist/cjs/services/db/currency-exchange-rates-db-service.js +39 -39
  263. package/dist/cjs/services/db/custom-measures-db-service.d.ts +14 -14
  264. package/dist/cjs/services/db/custom-measures-db-service.js +48 -48
  265. package/dist/cjs/services/db/destinations-db-service.d.ts +13 -13
  266. package/dist/cjs/services/db/destinations-db-service.js +74 -74
  267. package/dist/cjs/services/db/identity-cache-db-service.d.ts +28 -28
  268. package/dist/cjs/services/db/identity-cache-db-service.js +320 -320
  269. package/dist/cjs/services/db/identity-cache-dynamodb-service.d.ts +44 -44
  270. package/dist/cjs/services/db/identity-cache-dynamodb-service.js +734 -734
  271. package/dist/cjs/services/db/identity-cache-dynamodb-service.js.map +1 -1
  272. package/dist/cjs/services/db/index.d.ts +19 -19
  273. package/dist/cjs/services/db/index.js +35 -35
  274. package/dist/cjs/services/db/log-events-db-service.d.ts +11 -11
  275. package/dist/cjs/services/db/log-events-db-service.js +181 -181
  276. package/dist/cjs/services/db/pixels-db-service.d.ts +8 -8
  277. package/dist/cjs/services/db/pixels-db-service.js +35 -35
  278. package/dist/cjs/services/db/products-db-service-types.d.ts +10 -10
  279. package/dist/cjs/services/db/products-db-service-types.js +2 -2
  280. package/dist/cjs/services/db/products-db-service.d.ts +19 -19
  281. package/dist/cjs/services/db/products-db-service.js +281 -281
  282. package/dist/cjs/services/db/purchasable-contacts-db-service.d.ts +9 -9
  283. package/dist/cjs/services/db/purchasable-contacts-db-service.js +43 -43
  284. package/dist/cjs/services/db/purchased-contacts/index.d.ts +2 -2
  285. package/dist/cjs/services/db/purchased-contacts/index.js +18 -18
  286. package/dist/cjs/services/db/purchased-contacts/purchased-contacts-db-service.d.ts +18 -18
  287. package/dist/cjs/services/db/purchased-contacts/purchased-contacts-db-service.js +152 -152
  288. package/dist/cjs/services/db/purchased-contacts/types.d.ts +11 -11
  289. package/dist/cjs/services/db/purchased-contacts/types.js +2 -2
  290. package/dist/cjs/services/db/shopify-app-installs-db-service.d.ts +10 -10
  291. package/dist/cjs/services/db/shopify-app-installs-db-service.js +52 -52
  292. package/dist/cjs/services/db/shopify-products-cache-db-service.d.ts +16 -16
  293. package/dist/cjs/services/db/shopify-products-cache-db-service.js +73 -73
  294. package/dist/cjs/services/db/subscriptions-db-service.d.ts +11 -11
  295. package/dist/cjs/services/db/subscriptions-db-service.js +38 -38
  296. package/dist/cjs/services/db/tracking-events-db-service.d.ts +21 -21
  297. package/dist/cjs/services/db/tracking-events-db-service.js +188 -188
  298. package/dist/cjs/services/db/user-accounts-db-service.d.ts +7 -7
  299. package/dist/cjs/services/db/user-accounts-db-service.js +17 -17
  300. package/dist/cjs/services/email-verification/contact-email-verification-service.d.ts +7 -7
  301. package/dist/cjs/services/email-verification/contact-email-verification-service.js +101 -101
  302. package/dist/cjs/services/email-verification/email-verification-service.d.ts +19 -19
  303. package/dist/cjs/services/email-verification/email-verification-service.js +131 -131
  304. package/dist/cjs/services/email-verification/index.d.ts +2 -2
  305. package/dist/cjs/services/email-verification/index.js +18 -18
  306. package/dist/cjs/services/eventbridge-integration-service.d.ts +9 -9
  307. package/dist/cjs/services/eventbridge-integration-service.js +28 -28
  308. package/dist/cjs/services/events/index.d.ts +3 -3
  309. package/dist/cjs/services/events/index.js +19 -19
  310. package/dist/cjs/services/events/log-event-service.d.ts +19 -19
  311. package/dist/cjs/services/events/log-event-service.js +77 -77
  312. package/dist/cjs/services/events/metric-event-service.d.ts +9 -9
  313. package/dist/cjs/services/events/metric-event-service.js +49 -49
  314. package/dist/cjs/services/events/tracking-event-sqs-service.d.ts +8 -8
  315. package/dist/cjs/services/events/tracking-event-sqs-service.js +34 -34
  316. package/dist/cjs/services/generic-cache-service.d.ts +7 -7
  317. package/dist/cjs/services/generic-cache-service.js +33 -33
  318. package/dist/cjs/services/index.d.ts +11 -11
  319. package/dist/cjs/services/index.js +27 -27
  320. package/dist/cjs/services/ipdata-lookup-service.d.ts +20 -20
  321. package/dist/cjs/services/ipdata-lookup-service.js +112 -112
  322. package/dist/cjs/services/shopify/index.d.ts +2 -2
  323. package/dist/cjs/services/shopify/index.js +18 -18
  324. package/dist/cjs/services/shopify/products/index.d.ts +1 -1
  325. package/dist/cjs/services/shopify/products/index.js +17 -17
  326. package/dist/cjs/services/shopify/products/shopify-products-serviceV2.d.ts +17 -17
  327. package/dist/cjs/services/shopify/products/shopify-products-serviceV2.js +112 -112
  328. package/dist/cjs/services/shopify/shopify-graphql-transformer.d.ts +8 -8
  329. package/dist/cjs/services/shopify/shopify-graphql-transformer.js +141 -141
  330. package/dist/cjs/types/acuity-types.d.ts +74 -74
  331. package/dist/cjs/types/acuity-types.js +2 -2
  332. package/dist/cjs/types/api-response.d.ts +6 -6
  333. package/dist/cjs/types/api-response.js +2 -2
  334. package/dist/cjs/types/index.d.ts +4 -4
  335. package/dist/cjs/types/index.js +33 -33
  336. package/dist/cjs/types/internal-events/event-detail-types.d.ts +20 -20
  337. package/dist/cjs/types/internal-events/event-detail-types.js +27 -27
  338. package/dist/cjs/types/internal-events/index.d.ts +1 -1
  339. package/dist/cjs/types/internal-events/index.js +17 -17
  340. package/dist/cjs/types/shopify-graphql-types/admin.generated.d.ts +123 -123
  341. package/dist/cjs/types/shopify-graphql-types/admin.generated.js +2 -2
  342. package/dist/cjs/types/shopify-graphql-types/admin.types.d.ts +26289 -26289
  343. package/dist/cjs/types/shopify-graphql-types/admin.types.js +5311 -5311
  344. package/dist/cjs/types/shopify-graphql-types/index.d.ts +2 -2
  345. package/dist/cjs/types/shopify-graphql-types/index.js +18 -18
  346. package/dist/cjs/types/shopify-rest-types.d.ts +767 -767
  347. package/dist/cjs/types/shopify-rest-types.js +2 -2
  348. package/dist/cjs/utils/compression.d.ts +36 -36
  349. package/dist/cjs/utils/compression.js +198 -198
  350. package/dist/cjs/utils/custom-measure-formula-utils.d.ts +6 -6
  351. package/dist/cjs/utils/custom-measure-formula-utils.js +209 -209
  352. package/dist/cjs/utils/index.d.ts +4 -4
  353. package/dist/cjs/utils/index.js +20 -20
  354. package/dist/cjs/utils/retry-envelope.d.ts +12 -12
  355. package/dist/cjs/utils/retry-envelope.js +28 -28
  356. package/dist/cjs/utils/size.d.ts +2 -2
  357. package/dist/cjs/utils/size.js +49 -49
  358. package/dist/esm/__tests__/clients/acuity-client.spec.d.ts +1 -1
  359. package/dist/esm/__tests__/clients/acuity-client.spec.js +41 -41
  360. package/dist/esm/__tests__/clients/cross-platform-compression.spec.d.ts +1 -1
  361. package/dist/esm/__tests__/clients/cross-platform-compression.spec.js +329 -329
  362. package/dist/esm/__tests__/clients/dynamodb-client.spec.d.ts +1 -1
  363. package/dist/esm/__tests__/clients/dynamodb-client.spec.js +192 -192
  364. package/dist/esm/__tests__/clients/sqs-bundled-client.spec.d.ts +1 -1
  365. package/dist/esm/__tests__/clients/sqs-bundled-client.spec.js +906 -906
  366. package/dist/esm/__tests__/clients/sqs-bundling-contracts.spec.d.ts +1 -1
  367. package/dist/esm/__tests__/clients/sqs-bundling-contracts.spec.js +538 -538
  368. package/dist/esm/__tests__/clients/sqs-client.spec.d.ts +1 -1
  369. package/dist/esm/__tests__/clients/sqs-client.spec.js +189 -189
  370. package/dist/esm/__tests__/clients/sqs-unbundle.spec.d.ts +1 -1
  371. package/dist/esm/__tests__/clients/sqs-unbundle.spec.js +1355 -1355
  372. package/dist/esm/__tests__/db/contact-enrichments-db-service.spec.d.ts +1 -1
  373. package/dist/esm/__tests__/db/contact-enrichments-db-service.spec.js +66 -66
  374. package/dist/esm/__tests__/db/destinations-db-service.spec.d.ts +1 -1
  375. package/dist/esm/__tests__/db/destinations-db-service.spec.js +123 -123
  376. package/dist/esm/__tests__/db/products-db-service.spec.d.ts +1 -1
  377. package/dist/esm/__tests__/db/products-db-service.spec.js +87 -87
  378. package/dist/esm/__tests__/db/shared-read-db-services.spec.d.ts +1 -1
  379. package/dist/esm/__tests__/db/shared-read-db-services.spec.js +87 -87
  380. package/dist/esm/__tests__/db/shopify-app-installs-db-service.spec.d.ts +1 -1
  381. package/dist/esm/__tests__/db/shopify-app-installs-db-service.spec.js +102 -102
  382. package/dist/esm/__tests__/db/subscriptions-db-service.spec.d.ts +1 -1
  383. package/dist/esm/__tests__/db/subscriptions-db-service.spec.js +93 -93
  384. package/dist/esm/__tests__/db/user-accounts-db-service.spec.d.ts +1 -1
  385. package/dist/esm/__tests__/db/user-accounts-db-service.spec.js +74 -74
  386. package/dist/esm/__tests__/helpers/account-users-helper.spec.d.ts +1 -1
  387. package/dist/esm/__tests__/helpers/account-users-helper.spec.js +218 -218
  388. package/dist/esm/__tests__/helpers/acuity-helper.spec.d.ts +1 -1
  389. package/dist/esm/__tests__/helpers/acuity-helper.spec.js +67 -67
  390. package/dist/esm/__tests__/helpers/api-key-auth-helper.spec.d.ts +1 -1
  391. package/dist/esm/__tests__/helpers/api-key-auth-helper.spec.js +80 -80
  392. package/dist/esm/__tests__/identity-cache/identity-cache-db-service.spec.d.ts +1 -1
  393. package/dist/esm/__tests__/identity-cache/identity-cache-db-service.spec.js +674 -674
  394. package/dist/esm/__tests__/identity-cache/identity-cache-dynamodb-service.spec.d.ts +1 -1
  395. package/dist/esm/__tests__/identity-cache/identity-cache-dynamodb-service.spec.js +1138 -1138
  396. package/dist/esm/__tests__/identity-cache/identity-cache-tier-routing.spec.d.ts +1 -1
  397. package/dist/esm/__tests__/identity-cache/identity-cache-tier-routing.spec.js +849 -849
  398. package/dist/esm/__tests__/identity-cache/trait-merging-and-staleness.spec.d.ts +1 -1
  399. package/dist/esm/__tests__/identity-cache/trait-merging-and-staleness.spec.js +1058 -1058
  400. package/dist/esm/__tests__/identity-cache/volatile-traits-optimization.spec.d.ts +1 -1
  401. package/dist/esm/__tests__/identity-cache/volatile-traits-optimization.spec.js +816 -816
  402. package/dist/esm/__tests__/integration/sqs-bundling-roundtrip.spec.d.ts +1 -1
  403. package/dist/esm/__tests__/integration/sqs-bundling-roundtrip.spec.js +582 -582
  404. package/dist/esm/__tests__/libs/compress-decompress.spec.d.ts +1 -1
  405. package/dist/esm/__tests__/libs/compress-decompress.spec.js +14 -14
  406. package/dist/esm/__tests__/libs/contacts.spec.d.ts +1 -1
  407. package/dist/esm/__tests__/libs/contacts.spec.js +292 -292
  408. package/dist/esm/__tests__/libs/currency.spec.d.ts +1 -1
  409. package/dist/esm/__tests__/libs/currency.spec.js +218 -218
  410. package/dist/esm/__tests__/libs/dates.spec.d.ts +1 -1
  411. package/dist/esm/__tests__/libs/dates.spec.js +128 -128
  412. package/dist/esm/__tests__/libs/domain.spec.d.ts +1 -1
  413. package/dist/esm/__tests__/libs/domain.spec.js +105 -105
  414. package/dist/esm/__tests__/libs/numbers.spec.d.ts +1 -1
  415. package/dist/esm/__tests__/libs/numbers.spec.js +259 -259
  416. package/dist/esm/__tests__/s3-client/s3-client.spec.d.ts +1 -1
  417. package/dist/esm/__tests__/s3-client/s3-client.spec.js +31 -31
  418. package/dist/esm/__tests__/services/acuity-api-service.spec.d.ts +1 -1
  419. package/dist/esm/__tests__/services/acuity-api-service.spec.js +69 -69
  420. package/dist/esm/__tests__/services/cost/cost-calculation-types.spec.d.ts +1 -1
  421. package/dist/esm/__tests__/services/cost/cost-calculation-types.spec.js +21 -21
  422. package/dist/esm/__tests__/services/cost/cost-calculator-service.spec.d.ts +1 -1
  423. package/dist/esm/__tests__/services/cost/cost-calculator-service.spec.js +3317 -3317
  424. package/dist/esm/__tests__/services/cost/cost-currency-service.spec.d.ts +1 -1
  425. package/dist/esm/__tests__/services/cost/cost-currency-service.spec.js +112 -112
  426. package/dist/esm/__tests__/services/cost/cost-filter-service.spec.d.ts +1 -1
  427. package/dist/esm/__tests__/services/cost/cost-filter-service.spec.js +466 -466
  428. package/dist/esm/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.d.ts +1 -1
  429. package/dist/esm/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.js +204 -204
  430. package/dist/esm/__tests__/services/currency-exchange-rate-lookup-service.spec.d.ts +1 -1
  431. package/dist/esm/__tests__/services/currency-exchange-rate-lookup-service.spec.js +32 -32
  432. package/dist/esm/__tests__/services/email-verification/contact-email-verification-service.spec.d.ts +1 -1
  433. package/dist/esm/__tests__/services/email-verification/contact-email-verification-service.spec.js +91 -91
  434. package/dist/esm/__tests__/services/email-verification/email-verification-service.spec.d.ts +1 -1
  435. package/dist/esm/__tests__/services/email-verification/email-verification-service.spec.js +55 -55
  436. package/dist/esm/__tests__/shopify/shopify-graphql-transformer.spec.d.ts +1 -1
  437. package/dist/esm/__tests__/shopify/shopify-graphql-transformer.spec.js +33 -33
  438. package/dist/esm/__tests__/unit/libs/api-router/public-api-router.spec.d.ts +1 -1
  439. package/dist/esm/__tests__/unit/libs/api-router/public-api-router.spec.js +156 -156
  440. package/dist/esm/__tests__/unit/libs/api-router/route-matcher.spec.d.ts +1 -1
  441. package/dist/esm/__tests__/unit/libs/api-router/route-matcher.spec.js +67 -67
  442. package/dist/esm/__tests__/utils/custom-measure-formula-utils.spec.d.ts +1 -1
  443. package/dist/esm/__tests__/utils/custom-measure-formula-utils.spec.js +137 -137
  444. package/dist/esm/clients/generic/cognito-client.d.ts +23 -23
  445. package/dist/esm/clients/generic/cognito-client.js +204 -204
  446. package/dist/esm/clients/generic/dynamodb-client.d.ts +20 -20
  447. package/dist/esm/clients/generic/dynamodb-client.js +231 -231
  448. package/dist/esm/clients/generic/eventbridge-client.d.ts +14 -14
  449. package/dist/esm/clients/generic/eventbridge-client.js +47 -47
  450. package/dist/esm/clients/generic/http-client.d.ts +14 -14
  451. package/dist/esm/clients/generic/http-client.js +53 -53
  452. package/dist/esm/clients/generic/index.d.ts +13 -13
  453. package/dist/esm/clients/generic/index.js +13 -13
  454. package/dist/esm/clients/generic/lambda-invoke-client.d.ts +10 -10
  455. package/dist/esm/clients/generic/lambda-invoke-client.js +35 -35
  456. package/dist/esm/clients/generic/location-client.d.ts +8 -8
  457. package/dist/esm/clients/generic/location-client.js +27 -27
  458. package/dist/esm/clients/generic/redis-client.d.ts +33 -33
  459. package/dist/esm/clients/generic/redis-client.js +184 -184
  460. package/dist/esm/clients/generic/s3-client.d.ts +23 -23
  461. package/dist/esm/clients/generic/s3-client.js +209 -209
  462. package/dist/esm/clients/generic/singlestore-db-client.d.ts +14 -14
  463. package/dist/esm/clients/generic/singlestore-db-client.js +40 -40
  464. package/dist/esm/clients/generic/sqs-bundled-client.d.ts +15 -15
  465. package/dist/esm/clients/generic/sqs-bundled-client.js +307 -307
  466. package/dist/esm/clients/generic/sqs-bundled-client.types.d.ts +53 -53
  467. package/dist/esm/clients/generic/sqs-bundled-client.types.js +14 -14
  468. package/dist/esm/clients/generic/sqs-client.d.ts +53 -53
  469. package/dist/esm/clients/generic/sqs-client.js +281 -281
  470. package/dist/esm/clients/generic/sqs-unbundle.d.ts +32 -32
  471. package/dist/esm/clients/generic/sqs-unbundle.js +137 -137
  472. package/dist/esm/clients/index.d.ts +3 -3
  473. package/dist/esm/clients/index.js +3 -3
  474. package/dist/esm/clients/internal-api/accounts-client.d.ts +91 -91
  475. package/dist/esm/clients/internal-api/accounts-client.js +125 -125
  476. package/dist/esm/clients/internal-api/cache-lambda-client.d.ts +26 -26
  477. package/dist/esm/clients/internal-api/cache-lambda-client.js +85 -85
  478. package/dist/esm/clients/internal-api/db-management-client.d.ts +18 -18
  479. package/dist/esm/clients/internal-api/db-management-client.js +32 -32
  480. package/dist/esm/clients/internal-api/destinations-client.d.ts +34 -34
  481. package/dist/esm/clients/internal-api/destinations-client.js +75 -75
  482. package/dist/esm/clients/internal-api/event-collector-client.d.ts +20 -20
  483. package/dist/esm/clients/internal-api/event-collector-client.js +32 -32
  484. package/dist/esm/clients/internal-api/identity-client.d.ts +31 -31
  485. package/dist/esm/clients/internal-api/identity-client.js +87 -87
  486. package/dist/esm/clients/internal-api/index.d.ts +9 -9
  487. package/dist/esm/clients/internal-api/index.js +9 -9
  488. package/dist/esm/clients/internal-api/shopify-app-install-client.d.ts +37 -37
  489. package/dist/esm/clients/internal-api/shopify-app-install-client.js +77 -77
  490. package/dist/esm/clients/internal-api/subscriptions-client.d.ts +26 -26
  491. package/dist/esm/clients/internal-api/subscriptions-client.js +73 -73
  492. package/dist/esm/clients/internal-api/users-auth-client.d.ts +35 -35
  493. package/dist/esm/clients/internal-api/users-auth-client.js +106 -106
  494. package/dist/esm/clients/third-party/acuity-client.d.ts +10 -10
  495. package/dist/esm/clients/third-party/acuity-client.js +36 -36
  496. package/dist/esm/clients/third-party/emailable-client.d.ts +7 -7
  497. package/dist/esm/clients/third-party/emailable-client.js +21 -21
  498. package/dist/esm/clients/third-party/exchange-rate-api-client.d.ts +17 -17
  499. package/dist/esm/clients/third-party/exchange-rate-api-client.js +15 -15
  500. package/dist/esm/clients/third-party/index.d.ts +5 -5
  501. package/dist/esm/clients/third-party/index.js +5 -5
  502. package/dist/esm/clients/third-party/loops-client.d.ts +10 -10
  503. package/dist/esm/clients/third-party/loops-client.js +26 -26
  504. package/dist/esm/clients/third-party/shopify/graphql-order-queries.d.ts +25 -25
  505. package/dist/esm/clients/third-party/shopify/graphql-order-queries.js +1 -1
  506. package/dist/esm/clients/third-party/shopify/graphql-product-queries.d.ts +2 -2
  507. package/dist/esm/clients/third-party/shopify/graphql-product-queries.js +2 -2
  508. package/dist/esm/clients/third-party/shopify/shopify-graphql-client.d.ts +10 -10
  509. package/dist/esm/clients/third-party/shopify/shopify-graphql-client.js +157 -157
  510. package/dist/esm/clients/third-party/shopify-client.d.ts +29 -29
  511. package/dist/esm/clients/third-party/shopify-client.js +142 -142
  512. package/dist/esm/constants/index.d.ts +1 -1
  513. package/dist/esm/constants/index.js +1 -1
  514. package/dist/esm/constants/sqs.d.ts +20 -20
  515. package/dist/esm/constants/sqs.js +22 -22
  516. package/dist/esm/helpers/account-users-helper.d.ts +2 -2
  517. package/dist/esm/helpers/account-users-helper.js +18 -18
  518. package/dist/esm/helpers/acuity-helper.d.ts +4 -4
  519. package/dist/esm/helpers/acuity-helper.js +51 -51
  520. package/dist/esm/helpers/api-key-auth-helper.d.ts +9 -9
  521. package/dist/esm/helpers/api-key-auth-helper.js +35 -35
  522. package/dist/esm/helpers/api-key-authorizer-helper.d.ts +36 -36
  523. package/dist/esm/helpers/api-key-authorizer-helper.js +83 -83
  524. package/dist/esm/helpers/identity-cache-helper.d.ts +30 -30
  525. package/dist/esm/helpers/identity-cache-helper.js +248 -248
  526. package/dist/esm/helpers/index.d.ts +10 -10
  527. package/dist/esm/helpers/index.js +10 -10
  528. package/dist/esm/helpers/input-validation-helper.d.ts +3 -3
  529. package/dist/esm/helpers/input-validation-helper.js +18 -18
  530. package/dist/esm/helpers/logging-helper.d.ts +16 -16
  531. package/dist/esm/helpers/logging-helper.js +56 -56
  532. package/dist/esm/helpers/response-helper.d.ts +18 -18
  533. package/dist/esm/helpers/response-helper.js +37 -37
  534. package/dist/esm/helpers/shopify-helper.d.ts +9 -9
  535. package/dist/esm/helpers/shopify-helper.js +21 -21
  536. package/dist/esm/helpers/sqs-utils.d.ts +6 -6
  537. package/dist/esm/helpers/sqs-utils.js +9 -9
  538. package/dist/esm/index.d.ts +7 -7
  539. package/dist/esm/index.js +7 -7
  540. package/dist/esm/libs/api-router/index.d.ts +2 -2
  541. package/dist/esm/libs/api-router/index.js +2 -2
  542. package/dist/esm/libs/api-router/public-api-router.d.ts +3 -3
  543. package/dist/esm/libs/api-router/public-api-router.js +32 -32
  544. package/dist/esm/libs/api-router/route-matcher.d.ts +21 -21
  545. package/dist/esm/libs/api-router/route-matcher.js +30 -30
  546. package/dist/esm/libs/click-id-parser.d.ts +23 -23
  547. package/dist/esm/libs/click-id-parser.js +45 -45
  548. package/dist/esm/libs/compression.d.ts +2 -2
  549. package/dist/esm/libs/compression.js +25 -25
  550. package/dist/esm/libs/contacts.d.ts +7 -7
  551. package/dist/esm/libs/contacts.js +143 -143
  552. package/dist/esm/libs/cookie.d.ts +17 -17
  553. package/dist/esm/libs/cookie.js +70 -70
  554. package/dist/esm/libs/crypto.d.ts +4 -4
  555. package/dist/esm/libs/crypto.js +15 -15
  556. package/dist/esm/libs/csv.d.ts +2 -2
  557. package/dist/esm/libs/csv.js +30 -30
  558. package/dist/esm/libs/currency.d.ts +1 -1
  559. package/dist/esm/libs/currency.js +22 -22
  560. package/dist/esm/libs/dates.d.ts +12 -12
  561. package/dist/esm/libs/dates.js +83 -83
  562. package/dist/esm/libs/domain.d.ts +2 -2
  563. package/dist/esm/libs/domain.js +33 -33
  564. package/dist/esm/libs/emails.d.ts +8 -8
  565. package/dist/esm/libs/emails.js +146 -146
  566. package/dist/esm/libs/http-error.d.ts +21 -21
  567. package/dist/esm/libs/http-error.js +59 -59
  568. package/dist/esm/libs/http-status-codes.d.ts +58 -58
  569. package/dist/esm/libs/http-status-codes.js +59 -59
  570. package/dist/esm/libs/index.d.ts +19 -19
  571. package/dist/esm/libs/index.js +19 -19
  572. package/dist/esm/libs/numbers.d.ts +1 -1
  573. package/dist/esm/libs/numbers.js +11 -11
  574. package/dist/esm/libs/referrer-parser/index.d.ts +2 -2
  575. package/dist/esm/libs/referrer-parser/index.js +2 -2
  576. package/dist/esm/libs/referrer-parser/referrer-data.d.ts +9 -9
  577. package/dist/esm/libs/referrer-parser/referrer-data.js +3304 -3304
  578. package/dist/esm/libs/referrer-parser/referrer-parser-util.d.ts +20 -20
  579. package/dist/esm/libs/referrer-parser/referrer-parser-util.js +124 -124
  580. package/dist/esm/libs/strings.d.ts +3 -3
  581. package/dist/esm/libs/strings.js +40 -40
  582. package/dist/esm/libs/traits.d.ts +6 -6
  583. package/dist/esm/libs/traits.js +54 -54
  584. package/dist/esm/libs/url.d.ts +1 -1
  585. package/dist/esm/libs/url.js +9 -9
  586. package/dist/esm/services/acuity-api-service.d.ts +9 -9
  587. package/dist/esm/services/acuity-api-service.js +69 -69
  588. package/dist/esm/services/cache/generic-cached-object.d.ts +5 -5
  589. package/dist/esm/services/cache/generic-cached-object.js +1 -1
  590. package/dist/esm/services/cache/index.d.ts +1 -1
  591. package/dist/esm/services/cache/index.js +1 -1
  592. package/dist/esm/services/cache/product-cache-service.d.ts +21 -21
  593. package/dist/esm/services/cache/product-cache-service.js +68 -68
  594. package/dist/esm/services/cost/cost-calculation-types.d.ts +69 -69
  595. package/dist/esm/services/cost/cost-calculation-types.js +15 -15
  596. package/dist/esm/services/cost/cost-calculator-service.d.ts +24 -24
  597. package/dist/esm/services/cost/cost-calculator-service.js +450 -450
  598. package/dist/esm/services/cost/cost-currency-service.d.ts +6 -6
  599. package/dist/esm/services/cost/cost-currency-service.js +84 -84
  600. package/dist/esm/services/cost/cost-filter-service.d.ts +10 -10
  601. package/dist/esm/services/cost/cost-filter-service.js +118 -118
  602. package/dist/esm/services/cost/index.d.ts +5 -5
  603. package/dist/esm/services/cost/index.js +5 -5
  604. package/dist/esm/services/cost/order-cost/index.d.ts +2 -2
  605. package/dist/esm/services/cost/order-cost/index.js +2 -2
  606. package/dist/esm/services/cost/order-cost/order-cost-resolution-service.d.ts +23 -23
  607. package/dist/esm/services/cost/order-cost/order-cost-resolution-service.js +355 -355
  608. package/dist/esm/services/cost/order-cost/order-cost-resolution-types.d.ts +37 -37
  609. package/dist/esm/services/cost/order-cost/order-cost-resolution-types.js +1 -1
  610. package/dist/esm/services/currency-exchange-rate-lookup-service.d.ts +12 -12
  611. package/dist/esm/services/currency-exchange-rate-lookup-service.js +90 -90
  612. package/dist/esm/services/db/accounts-db-service.d.ts +9 -9
  613. package/dist/esm/services/db/accounts-db-service.js +29 -29
  614. package/dist/esm/services/db/api-keys-db-service.d.ts +10 -10
  615. package/dist/esm/services/db/api-keys-db-service.js +32 -32
  616. package/dist/esm/services/db/contact-enrichments-db-service.d.ts +15 -15
  617. package/dist/esm/services/db/contact-enrichments-db-service.js +90 -90
  618. package/dist/esm/services/db/currency-exchange-rates-db-service.d.ts +21 -21
  619. package/dist/esm/services/db/currency-exchange-rates-db-service.js +35 -35
  620. package/dist/esm/services/db/custom-measures-db-service.d.ts +14 -14
  621. package/dist/esm/services/db/custom-measures-db-service.js +44 -44
  622. package/dist/esm/services/db/destinations-db-service.d.ts +13 -13
  623. package/dist/esm/services/db/destinations-db-service.js +70 -70
  624. package/dist/esm/services/db/identity-cache-db-service.d.ts +28 -28
  625. package/dist/esm/services/db/identity-cache-db-service.js +313 -313
  626. package/dist/esm/services/db/identity-cache-dynamodb-service.d.ts +44 -44
  627. package/dist/esm/services/db/identity-cache-dynamodb-service.js +727 -727
  628. package/dist/esm/services/db/identity-cache-dynamodb-service.js.map +1 -1
  629. package/dist/esm/services/db/index.d.ts +19 -19
  630. package/dist/esm/services/db/index.js +19 -19
  631. package/dist/esm/services/db/log-events-db-service.d.ts +11 -11
  632. package/dist/esm/services/db/log-events-db-service.js +177 -177
  633. package/dist/esm/services/db/pixels-db-service.d.ts +8 -8
  634. package/dist/esm/services/db/pixels-db-service.js +31 -31
  635. package/dist/esm/services/db/products-db-service-types.d.ts +10 -10
  636. package/dist/esm/services/db/products-db-service-types.js +1 -1
  637. package/dist/esm/services/db/products-db-service.d.ts +19 -19
  638. package/dist/esm/services/db/products-db-service.js +277 -277
  639. package/dist/esm/services/db/purchasable-contacts-db-service.d.ts +9 -9
  640. package/dist/esm/services/db/purchasable-contacts-db-service.js +39 -39
  641. package/dist/esm/services/db/purchased-contacts/index.d.ts +2 -2
  642. package/dist/esm/services/db/purchased-contacts/index.js +2 -2
  643. package/dist/esm/services/db/purchased-contacts/purchased-contacts-db-service.d.ts +18 -18
  644. package/dist/esm/services/db/purchased-contacts/purchased-contacts-db-service.js +148 -148
  645. package/dist/esm/services/db/purchased-contacts/types.d.ts +11 -11
  646. package/dist/esm/services/db/purchased-contacts/types.js +1 -1
  647. package/dist/esm/services/db/shopify-app-installs-db-service.d.ts +10 -10
  648. package/dist/esm/services/db/shopify-app-installs-db-service.js +48 -48
  649. package/dist/esm/services/db/shopify-products-cache-db-service.d.ts +16 -16
  650. package/dist/esm/services/db/shopify-products-cache-db-service.js +66 -66
  651. package/dist/esm/services/db/subscriptions-db-service.d.ts +11 -11
  652. package/dist/esm/services/db/subscriptions-db-service.js +34 -34
  653. package/dist/esm/services/db/tracking-events-db-service.d.ts +21 -21
  654. package/dist/esm/services/db/tracking-events-db-service.js +184 -184
  655. package/dist/esm/services/db/user-accounts-db-service.d.ts +7 -7
  656. package/dist/esm/services/db/user-accounts-db-service.js +13 -13
  657. package/dist/esm/services/email-verification/contact-email-verification-service.d.ts +7 -7
  658. package/dist/esm/services/email-verification/contact-email-verification-service.js +97 -97
  659. package/dist/esm/services/email-verification/email-verification-service.d.ts +19 -19
  660. package/dist/esm/services/email-verification/email-verification-service.js +127 -127
  661. package/dist/esm/services/email-verification/index.d.ts +2 -2
  662. package/dist/esm/services/email-verification/index.js +2 -2
  663. package/dist/esm/services/eventbridge-integration-service.d.ts +9 -9
  664. package/dist/esm/services/eventbridge-integration-service.js +24 -24
  665. package/dist/esm/services/events/index.d.ts +3 -3
  666. package/dist/esm/services/events/index.js +3 -3
  667. package/dist/esm/services/events/log-event-service.d.ts +19 -19
  668. package/dist/esm/services/events/log-event-service.js +73 -73
  669. package/dist/esm/services/events/metric-event-service.d.ts +9 -9
  670. package/dist/esm/services/events/metric-event-service.js +45 -45
  671. package/dist/esm/services/events/tracking-event-sqs-service.d.ts +8 -8
  672. package/dist/esm/services/events/tracking-event-sqs-service.js +30 -30
  673. package/dist/esm/services/generic-cache-service.d.ts +7 -7
  674. package/dist/esm/services/generic-cache-service.js +29 -29
  675. package/dist/esm/services/index.d.ts +11 -11
  676. package/dist/esm/services/index.js +11 -11
  677. package/dist/esm/services/ipdata-lookup-service.d.ts +20 -20
  678. package/dist/esm/services/ipdata-lookup-service.js +108 -108
  679. package/dist/esm/services/shopify/index.d.ts +2 -2
  680. package/dist/esm/services/shopify/index.js +2 -2
  681. package/dist/esm/services/shopify/products/index.d.ts +1 -1
  682. package/dist/esm/services/shopify/products/index.js +1 -1
  683. package/dist/esm/services/shopify/products/shopify-products-serviceV2.d.ts +17 -17
  684. package/dist/esm/services/shopify/products/shopify-products-serviceV2.js +108 -108
  685. package/dist/esm/services/shopify/shopify-graphql-transformer.d.ts +8 -8
  686. package/dist/esm/services/shopify/shopify-graphql-transformer.js +138 -138
  687. package/dist/esm/types/acuity-types.d.ts +74 -74
  688. package/dist/esm/types/acuity-types.js +1 -1
  689. package/dist/esm/types/api-response.d.ts +6 -6
  690. package/dist/esm/types/api-response.js +1 -1
  691. package/dist/esm/types/index.d.ts +4 -4
  692. package/dist/esm/types/index.js +4 -4
  693. package/dist/esm/types/internal-events/event-detail-types.d.ts +20 -20
  694. package/dist/esm/types/internal-events/event-detail-types.js +24 -24
  695. package/dist/esm/types/internal-events/index.d.ts +1 -1
  696. package/dist/esm/types/internal-events/index.js +1 -1
  697. package/dist/esm/types/shopify-graphql-types/admin.generated.d.ts +123 -123
  698. package/dist/esm/types/shopify-graphql-types/admin.generated.js +1 -1
  699. package/dist/esm/types/shopify-graphql-types/admin.types.d.ts +26289 -26289
  700. package/dist/esm/types/shopify-graphql-types/admin.types.js +5299 -5299
  701. package/dist/esm/types/shopify-graphql-types/index.d.ts +2 -2
  702. package/dist/esm/types/shopify-graphql-types/index.js +2 -2
  703. package/dist/esm/types/shopify-rest-types.d.ts +767 -767
  704. package/dist/esm/types/shopify-rest-types.js +1 -1
  705. package/dist/esm/utils/compression.d.ts +36 -36
  706. package/dist/esm/utils/compression.js +187 -187
  707. package/dist/esm/utils/custom-measure-formula-utils.d.ts +6 -6
  708. package/dist/esm/utils/custom-measure-formula-utils.js +201 -201
  709. package/dist/esm/utils/index.d.ts +4 -4
  710. package/dist/esm/utils/index.js +4 -4
  711. package/dist/esm/utils/retry-envelope.d.ts +12 -12
  712. package/dist/esm/utils/retry-envelope.js +22 -22
  713. package/dist/esm/utils/size.d.ts +2 -2
  714. package/dist/esm/utils/size.js +44 -44
  715. package/package.json +134 -134
@@ -1,1141 +1,1141 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", { value: true });
3
- const mockInvokeFunction = jest.fn();
4
- jest.mock('../../clients/index.js', () => ({
5
- DynamoDbClient: {
6
- safeGet: jest.fn(),
7
- safePut: jest.fn(),
8
- safeDelete: jest.fn(),
9
- safeBatchGet: jest.fn(),
10
- safeBatchWrite: jest.fn(),
11
- safeQueryByGSI: jest.fn(),
12
- batchWrite: jest.fn(),
13
- },
14
- LambdaInvokeClient: jest.fn().mockImplementation(() => ({
15
- invokeFunction: mockInvokeFunction,
16
- })),
17
- }));
18
- jest.mock('../../helpers/index.js', () => ({
19
- Logger: {
20
- debug: jest.fn(),
21
- info: jest.fn(),
22
- warn: jest.fn(),
23
- error: jest.fn(),
24
- },
25
- }));
26
- const identity_cache_dynamodb_service_js_1 = require("../../services/db/identity-cache-dynamodb-service.js");
27
- const index_js_1 = require("../../clients/index.js");
28
- const mockedDynamoDbClient = index_js_1.DynamoDbClient;
29
- describe('IdentityCacheDynamoDbService', () => {
30
- beforeEach(() => {
31
- jest.clearAllMocks();
32
- mockedDynamoDbClient.safeGet.mockReset();
33
- mockedDynamoDbClient.safePut.mockReset();
34
- mockedDynamoDbClient.safeDelete.mockReset();
35
- mockedDynamoDbClient.safeBatchGet.mockReset();
36
- mockedDynamoDbClient.safeBatchWrite.mockReset();
37
- mockedDynamoDbClient.safeQueryByGSI.mockReset();
38
- mockedDynamoDbClient.batchWrite.mockReset();
39
- mockInvokeFunction.mockReset();
40
- identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.lambdaInvokeClient = undefined;
41
- });
42
- describe('getIdentityWithCaching', () => {
43
- const pixelId = 'pixel123';
44
- const lambdaArn = 'arn:aws:lambda:us-east-1:123456789:function:identity-private';
45
- describe('cache hit (fresh cache)', () => {
46
- it('should return cached identity without invoking Neptune Lambda', async () => {
47
- const incomingIdentity = {
48
- identityId: 'identity456',
49
- traits: { emails: ['test@email.com'] },
50
- };
51
- const cachedResponse = {
52
- pk: `identity#${pixelId}#identity456`,
53
- pixelId,
54
- identityId: 'identity456',
55
- response: {
56
- identityId: 'identity456',
57
- traits: { emails: ['test@email.com'] },
58
- },
59
- updatedAt: new Date().toISOString(),
60
- };
61
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
62
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
63
- expect(result).toBeDefined();
64
- expect(result?.identityId).toBe('identity456');
65
- expect(mockInvokeFunction).not.toHaveBeenCalled();
66
- });
67
- });
68
- describe('cache miss', () => {
69
- it('should invoke Neptune Lambda and return resolved identity', async () => {
70
- const incomingIdentity = {
71
- identityId: 'identity456',
72
- traits: { emails: ['test@email.com'] },
73
- };
74
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
75
- mockInvokeFunction.mockResolvedValueOnce({
76
- statusCode: 200,
77
- body: JSON.stringify({
78
- identity: {
79
- identityId: 'resolved-identity',
80
- traits: { emails: ['test@email.com', 'resolved@email.com'] },
81
- },
82
- }),
83
- });
84
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
85
- expect(mockInvokeFunction).toHaveBeenCalledWith(lambdaArn, {
86
- pixelId,
87
- context: { identity: incomingIdentity },
88
- });
89
- expect(result?.identityId).toBe('resolved-identity');
90
- expect(mockedDynamoDbClient.safeBatchWrite).toHaveBeenCalled();
91
- });
92
- it('should return incomingIdentity when Neptune Lambda fails to resolve', async () => {
93
- const incomingIdentity = {
94
- identityId: 'identity456',
95
- traits: { emails: ['test@email.com'] },
96
- };
97
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
98
- mockInvokeFunction.mockResolvedValueOnce({
99
- statusCode: 200,
100
- body: JSON.stringify({ identity: undefined }),
101
- });
102
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
103
- expect(result).toEqual(incomingIdentity);
104
- });
105
- });
106
- describe('cache stale', () => {
107
- it('should invoke Neptune Lambda when cache is stale', async () => {
108
- const incomingIdentity = {
109
- identityId: 'identity456',
110
- traits: { emails: ['old@email.com', 'new@email.com'] },
111
- };
112
- const cachedResponse = {
113
- pk: `identity#${pixelId}#identity456`,
114
- pixelId,
115
- identityId: 'identity456',
116
- response: {
117
- identityId: 'identity456',
118
- traits: { emails: ['old@email.com'] },
119
- },
120
- updatedAt: new Date().toISOString(),
121
- };
122
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
123
- mockInvokeFunction.mockResolvedValueOnce({
124
- statusCode: 200,
125
- body: JSON.stringify({
126
- identity: {
127
- identityId: 'identity456',
128
- traits: { emails: ['old@email.com', 'new@email.com'] },
129
- },
130
- }),
131
- });
132
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
133
- expect(mockInvokeFunction).toHaveBeenCalled();
134
- expect(result?.identityId).toBe('identity456');
135
- expect(result?.traits?.emails).toContain('new@email.com');
136
- });
137
- it('should use merged cache identity when Neptune fails', async () => {
138
- const incomingIdentity = {
139
- identityId: 'identity456',
140
- traits: { emails: ['old@email.com', 'new@email.com'] },
141
- };
142
- const cachedResponse = {
143
- pk: `identity#${pixelId}#identity456`,
144
- pixelId,
145
- identityId: 'identity456',
146
- response: {
147
- identityId: 'identity456',
148
- traits: { emails: ['old@email.com'] },
149
- },
150
- updatedAt: new Date().toISOString(),
151
- };
152
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
153
- mockInvokeFunction.mockResolvedValueOnce({
154
- statusCode: 500,
155
- body: 'Internal Server Error',
156
- });
157
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
158
- expect(result).toBeDefined();
159
- expect(result?.identityId).toBe('identity456');
160
- });
161
- });
162
- describe('Neptune Lambda invocation', () => {
163
- it('should write-back Neptune response to cache on success', async () => {
164
- const incomingIdentity = {
165
- traits: { emails: ['test@email.com'] },
166
- };
167
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
168
- mockInvokeFunction.mockResolvedValueOnce({
169
- statusCode: 200,
170
- body: JSON.stringify({
171
- identity: {
172
- identityId: 'neptune-resolved-id',
173
- traits: { emails: ['test@email.com'] },
174
- },
175
- }),
176
- });
177
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
178
- expect(mockedDynamoDbClient.safeBatchWrite).toHaveBeenCalled();
179
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
180
- const identityPks = writtenItems.map((item) => item.pk);
181
- expect(identityPks).toContain(`identity#${pixelId}#neptune-resolved-id`);
182
- });
183
- it('should not write to cache when Neptune returns undefined', async () => {
184
- const incomingIdentity = {
185
- traits: { emails: ['test@email.com'] },
186
- };
187
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
188
- mockInvokeFunction.mockResolvedValueOnce({
189
- statusCode: 200,
190
- body: JSON.stringify({ identity: undefined }),
191
- });
192
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
193
- expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
194
- });
195
- });
196
- describe('error handling (fail-open)', () => {
197
- it('should return undefined when pixelId is missing', async () => {
198
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(null, { identityId: 'test-id' }, lambdaArn);
199
- expect(result).toBeUndefined();
200
- expect(mockInvokeFunction).not.toHaveBeenCalled();
201
- });
202
- it('should return undefined when incomingIdentity is missing', async () => {
203
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, null, lambdaArn);
204
- expect(result).toBeUndefined();
205
- expect(mockInvokeFunction).not.toHaveBeenCalled();
206
- });
207
- it('should return undefined when Neptune Lambda throws', async () => {
208
- const incomingIdentity = {
209
- identityId: 'identity456',
210
- traits: { emails: ['test@email.com'] },
211
- };
212
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
213
- mockInvokeFunction.mockRejectedValueOnce(new Error('Lambda invocation failed'));
214
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
215
- expect(result).toEqual(incomingIdentity);
216
- });
217
- it('should not throw when cache write fails after Neptune success', async () => {
218
- const incomingIdentity = {
219
- traits: { emails: ['test@email.com'] },
220
- };
221
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
222
- mockInvokeFunction.mockResolvedValueOnce({
223
- statusCode: 200,
224
- body: JSON.stringify({
225
- identity: {
226
- identityId: 'neptune-resolved-id',
227
- traits: { emails: ['test@email.com'] },
228
- },
229
- }),
230
- });
231
- mockedDynamoDbClient.safeBatchWrite.mockRejectedValueOnce(new Error('DynamoDB write failed'));
232
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
233
- expect(result?.identityId).toBe('neptune-resolved-id');
234
- });
235
- });
236
- });
237
- describe('Key Builders', () => {
238
- describe('buildIdentityPk', () => {
239
- it('should build correct pk for identity lookup', async () => {
240
- const pixelId = 'pixel123';
241
- const identityId = 'identity456';
242
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
243
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, { identityId });
244
- expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `identity#${pixelId}#${identityId}`);
245
- });
246
- });
247
- describe('buildEmailPk', () => {
248
- it('should build correct pk for email lookup (lowercase)', async () => {
249
- const pixelId = 'pixel123';
250
- const email = 'Test@Email.COM';
251
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
252
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
253
- traits: { emails: [email] },
254
- });
255
- expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `email#${pixelId}#test@email.com`);
256
- });
257
- });
258
- describe('buildUserIdPk (no longer used for lookup)', () => {
259
- it('should NOT lookup by userId (optimization: email-only secondary lookup)', async () => {
260
- const pixelId = 'pixel123';
261
- const userId = ' user789 ';
262
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
263
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
264
- traits: { userIds: [userId] },
265
- });
266
- expect(mockedDynamoDbClient.safeBatchGet).not.toHaveBeenCalled();
267
- });
268
- });
269
- });
270
- describe('getIdentityFromCache', () => {
271
- const pixelId = 'pixel123';
272
- describe('with identityId (primary lookup)', () => {
273
- it('should return cache hit when identity found', async () => {
274
- const identityId = 'identity456';
275
- const cachedResponse = {
276
- pk: `identity#${pixelId}#${identityId}`,
277
- pixelId,
278
- identityId,
279
- response: {
280
- identityId,
281
- traits: { emails: ['test@email.com'] },
282
- },
283
- updatedAt: new Date().toISOString(),
284
- };
285
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
286
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
287
- identityId,
288
- traits: { emails: ['test@email.com'] },
289
- });
290
- expect(result.resolvedIdentity).toBeDefined();
291
- expect(result.resolvedIdentity?.identityId).toBe(identityId);
292
- expect(result.isCacheStale).toBe(false);
293
- });
294
- it('should return cache miss when identity not found', async () => {
295
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
296
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
297
- identityId: 'unknown-id',
298
- });
299
- expect(result.resolvedIdentity).toBeUndefined();
300
- expect(result.isCacheStale).toBe(true);
301
- });
302
- it('should NOT fallback to secondary keys when identityId lookup misses', async () => {
303
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
304
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
305
- identityId: 'unknown-id',
306
- traits: { emails: ['test@email.com'] },
307
- });
308
- expect(mockedDynamoDbClient.safeBatchGet).not.toHaveBeenCalled();
309
- });
310
- it('should detect stale cache when new traits present', async () => {
311
- const identityId = 'identity456';
312
- const cachedResponse = {
313
- pk: `identity#${pixelId}#${identityId}`,
314
- pixelId,
315
- identityId,
316
- response: {
317
- identityId,
318
- traits: { emails: ['old@email.com'] },
319
- },
320
- updatedAt: new Date().toISOString(),
321
- };
322
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
323
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
324
- identityId,
325
- traits: { emails: ['old@email.com', 'new@email.com'] },
326
- });
327
- expect(result.resolvedIdentity).toBeDefined();
328
- expect(result.isCacheStale).toBe(true);
329
- });
330
- });
331
- describe('without identityId (secondary lookup)', () => {
332
- it('should use single get for email lookup (pointer-based)', async () => {
333
- const pointerRecord = {
334
- pk: `email#${pixelId}#test@email.com`,
335
- pixelId,
336
- identityId: 'resolved-id',
337
- gsi1pk: 'resolved-id',
338
- updatedAt: new Date().toISOString(),
339
- };
340
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(pointerRecord);
341
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
342
- traits: { emails: ['test@email.com'], userIds: ['user123'] },
343
- });
344
- expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `email#${pixelId}#test@email.com`);
345
- expect(mockedDynamoDbClient.safeBatchGet).not.toHaveBeenCalled();
346
- expect(result.resolvedIdentity).toBeDefined();
347
- expect(result.resolvedIdentity?.traits?.emails).toContain('test@email.com');
348
- expect(result.isCacheStale).toBe(true);
349
- });
350
- it('should return discovered identityId with stale flag for Neptune resolution', async () => {
351
- const pointerRecord = {
352
- pk: `email#${pixelId}#test@email.com`,
353
- pixelId,
354
- identityId: 'discovered-id',
355
- gsi1pk: 'discovered-id',
356
- updatedAt: new Date().toISOString(),
357
- };
358
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(pointerRecord);
359
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
360
- traits: { emails: ['test@email.com'], userIds: ['user123'] },
361
- });
362
- expect(result.resolvedIdentity).toBeDefined();
363
- expect(result.resolvedIdentity?.identityId).toBe('discovered-id');
364
- expect(result.isCacheStale).toBe(true);
365
- });
366
- it('should return cache miss when no secondary keys match', async () => {
367
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
368
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
369
- traits: { emails: ['unknown@email.com'] },
370
- });
371
- expect(result.resolvedIdentity).toBeUndefined();
372
- expect(result.isCacheStale).toBe(true);
373
- });
374
- it('should return cache miss when no emails to lookup', async () => {
375
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
376
- traits: { userIds: ['user123'] },
377
- });
378
- expect(result.resolvedIdentity).toBeUndefined();
379
- expect(result.isCacheStale).toBe(true);
380
- expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
381
- });
382
- it('should return cache miss when empty traits', async () => {
383
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
384
- traits: {},
385
- });
386
- expect(result.resolvedIdentity).toBeUndefined();
387
- expect(result.isCacheStale).toBe(true);
388
- });
389
- });
390
- describe('error handling (fail-open)', () => {
391
- it('should return cache miss on safeGet error', async () => {
392
- mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
393
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
394
- identityId: 'test-id',
395
- });
396
- expect(result.resolvedIdentity).toBeUndefined();
397
- expect(result.isCacheStale).toBe(true);
398
- });
399
- it('should return cache miss on safeGet error for email lookup', async () => {
400
- mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
401
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
402
- traits: { emails: ['test@email.com'] },
403
- });
404
- expect(result.resolvedIdentity).toBeUndefined();
405
- expect(result.isCacheStale).toBe(true);
406
- });
407
- it('should return cache miss for null pixelId', async () => {
408
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(null, {
409
- identityId: 'test-id',
410
- });
411
- expect(result.resolvedIdentity).toBeUndefined();
412
- expect(result.isCacheStale).toBe(true);
413
- });
414
- it('should return cache miss for null incomingIdentity', async () => {
415
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, null);
416
- expect(result.resolvedIdentity).toBeUndefined();
417
- expect(result.isCacheStale).toBe(true);
418
- });
419
- });
420
- });
421
- describe('updateIdentityCache', () => {
422
- const pixelId = 'pixel123';
423
- it('should write identity with email pointer (no full blob on secondary keys)', async () => {
424
- const identity = {
425
- identityId: 'identity456',
426
- traits: {
427
- emails: ['test@email.com', 'other@email.com'],
428
- userIds: ['user1', 'user2'],
429
- },
430
- };
431
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
432
- expect(mockedDynamoDbClient.safeBatchWrite).toHaveBeenCalledTimes(1);
433
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
434
- expect(writtenItems).toHaveLength(3);
435
- const pks = writtenItems.map((item) => item.pk);
436
- expect(pks).toContain(`identity#${pixelId}#identity456`);
437
- expect(pks).toContain(`email#${pixelId}#test@email.com`);
438
- expect(pks).toContain(`email#${pixelId}#other@email.com`);
439
- expect(pks).not.toContain(`user_id#${pixelId}#user1`);
440
- expect(pks).not.toContain(`user_id#${pixelId}#user2`);
441
- const identityItem = writtenItems.find((item) => item.pk.startsWith('identity#'));
442
- expect(identityItem).toBeDefined();
443
- expect(identityItem.response).toBeDefined();
444
- expect(identityItem.response.identityId).toBe('identity456');
445
- const emailItem = writtenItems.find((item) => item.pk.startsWith('email#'));
446
- expect(emailItem).toBeDefined();
447
- expect(emailItem.response).toBeUndefined();
448
- expect(emailItem.identityId).toBe('identity456');
449
- });
450
- it('should not throw on safeBatchWrite error (fail-open)', async () => {
451
- mockedDynamoDbClient.safeBatchWrite.mockRejectedValueOnce(new Error('DynamoDB error'));
452
- const identity = {
453
- identityId: 'identity456',
454
- traits: { emails: ['test@email.com'] },
455
- };
456
- await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity)).resolves.toBeUndefined();
457
- });
458
- it('should return early for missing identityId', async () => {
459
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, {});
460
- expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
461
- });
462
- it('should return early for missing pixelId', async () => {
463
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(null, {
464
- identityId: 'test-id',
465
- });
466
- expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
467
- });
468
- it('should handle identity with no traits', async () => {
469
- const identity = {
470
- identityId: 'identity456',
471
- };
472
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
473
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
474
- expect(writtenItems).toHaveLength(1);
475
- });
476
- it('should include gsi1pk for reverse lookups', async () => {
477
- const identity = {
478
- identityId: 'identity456',
479
- traits: { emails: ['test@email.com'] },
480
- };
481
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
482
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
483
- for (const item of writtenItems) {
484
- expect(item.gsi1pk).toBe('identity456');
485
- }
486
- });
487
- });
488
- describe('getIdentityMap', () => {
489
- it('should return identity map when found', async () => {
490
- const mockMap = {
491
- pk: 'identity_map#pixel123#identity456',
492
- pixelId: 'pixel123',
493
- identityId: 'identity456',
494
- linkedIdentities: ['identity789'],
495
- updatedAt: new Date().toISOString(),
496
- };
497
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(mockMap);
498
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', 'identity456');
499
- expect(result).toEqual(mockMap);
500
- expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', 'identity_map#pixel123#identity456');
501
- });
502
- it('should return undefined when not found', async () => {
503
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
504
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', 'identity456');
505
- expect(result).toBeUndefined();
506
- });
507
- it('should return undefined for missing params (fail-open)', async () => {
508
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('', '');
509
- expect(result).toBeUndefined();
510
- expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
511
- });
512
- it('should return undefined when only pixelId is missing', async () => {
513
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('', 'identity456');
514
- expect(result).toBeUndefined();
515
- expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
516
- });
517
- it('should return undefined when only identityId is missing', async () => {
518
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', '');
519
- expect(result).toBeUndefined();
520
- expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
521
- });
522
- it('should return undefined on safeGet error (fail-open)', async () => {
523
- mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
524
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', 'identity456');
525
- expect(result).toBeUndefined();
526
- });
527
- });
528
- describe('getForcePurgeFlag', () => {
529
- it('should return true when flag exists', async () => {
530
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce({
531
- pk: 'force_purge#pixel123#identity456',
532
- });
533
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('pixel123', 'identity456');
534
- expect(result).toBe(true);
535
- });
536
- it('should return false when flag not found', async () => {
537
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
538
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('pixel123', 'identity456');
539
- expect(result).toBe(false);
540
- });
541
- it('should return false on error (fail-open)', async () => {
542
- mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
543
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('pixel123', 'identity456');
544
- expect(result).toBe(false);
545
- });
546
- it('should return false for missing params', async () => {
547
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('', '');
548
- expect(result).toBe(false);
549
- expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
550
- });
551
- });
552
- describe('setForcePurgeFlag', () => {
553
- it('should set flag with TTL', async () => {
554
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456');
555
- expect(mockedDynamoDbClient.safePut).toHaveBeenCalledTimes(1);
556
- const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
557
- expect(putItem.pk).toBe('force_purge#pixel123#identity456');
558
- expect(putItem.pixelId).toBe('pixel123');
559
- expect(putItem.identityId).toBe('identity456');
560
- expect(putItem.ttl).toBeGreaterThan(0);
561
- });
562
- it('should accept custom TTL', async () => {
563
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456', 3600);
564
- const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
565
- expect(putItem.ttl).toBeGreaterThan(0);
566
- });
567
- it('should include createdAt timestamp', async () => {
568
- const before = new Date().toISOString();
569
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456');
570
- const after = new Date().toISOString();
571
- const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
572
- expect(putItem.createdAt).toBeDefined();
573
- expect(putItem.createdAt >= before).toBe(true);
574
- expect(putItem.createdAt <= after).toBe(true);
575
- });
576
- it('should return early when pixelId is missing', async () => {
577
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('', 'identity456');
578
- expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
579
- });
580
- it('should return early when identityId is missing', async () => {
581
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', '');
582
- expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
583
- });
584
- it('should not throw on error (fail-open)', async () => {
585
- mockedDynamoDbClient.safePut.mockRejectedValueOnce(new Error('DynamoDB error'));
586
- await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456')).resolves.toBeUndefined();
587
- });
588
- });
589
- describe('putIdentityMap', () => {
590
- it('should write identity map', async () => {
591
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', 'identity456', ['linked1', 'linked2']);
592
- expect(mockedDynamoDbClient.safePut).toHaveBeenCalledTimes(1);
593
- const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
594
- expect(putItem.pk).toBe('identity_map#pixel123#identity456');
595
- expect(putItem.linkedIdentities).toEqual(['linked1', 'linked2']);
596
- });
597
- it('should return early for missing params', async () => {
598
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('', '', []);
599
- expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
600
- });
601
- it('should return early when only pixelId is missing', async () => {
602
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('', 'identity456', ['linked1']);
603
- expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
604
- });
605
- it('should return early when only identityId is missing', async () => {
606
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', '', ['linked1']);
607
- expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
608
- });
609
- it('should include updatedAt timestamp', async () => {
610
- const before = new Date().toISOString();
611
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', 'identity456', ['linked1']);
612
- const after = new Date().toISOString();
613
- const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
614
- expect(putItem.updatedAt).toBeDefined();
615
- expect(putItem.updatedAt >= before).toBe(true);
616
- expect(putItem.updatedAt <= after).toBe(true);
617
- });
618
- it('should not throw on safePut error (fail-open)', async () => {
619
- mockedDynamoDbClient.safePut.mockRejectedValueOnce(new Error('DynamoDB error'));
620
- await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', 'identity456', ['linked1'])).resolves.toBeUndefined();
621
- });
622
- });
623
- describe('deleteIdentityMap', () => {
624
- it('should delete identity map', async () => {
625
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('pixel123', 'identity456');
626
- expect(mockedDynamoDbClient.safeDelete).toHaveBeenCalledWith(expect.any(String), 'pk', 'identity_map#pixel123#identity456');
627
- });
628
- it('should return early for missing params', async () => {
629
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('', '');
630
- expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
631
- });
632
- it('should return early when only pixelId is missing', async () => {
633
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('', 'identity456');
634
- expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
635
- });
636
- it('should return early when only identityId is missing', async () => {
637
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('pixel123', '');
638
- expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
639
- });
640
- it('should not throw on safeDelete error (fail-open)', async () => {
641
- mockedDynamoDbClient.safeDelete.mockRejectedValueOnce(new Error('DynamoDB error'));
642
- await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('pixel123', 'identity456')).resolves.toBeUndefined();
643
- });
644
- });
645
- describe('deleteForcePurgeFlag', () => {
646
- it('should delete force purge flag', async () => {
647
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('pixel123', 'identity456');
648
- expect(mockedDynamoDbClient.safeDelete).toHaveBeenCalledWith(expect.any(String), 'pk', 'force_purge#pixel123#identity456');
649
- });
650
- it('should return early for missing params', async () => {
651
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('', '');
652
- expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
653
- });
654
- it('should return early when only pixelId is missing', async () => {
655
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('', 'identity456');
656
- expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
657
- });
658
- it('should return early when only identityId is missing', async () => {
659
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('pixel123', '');
660
- expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
661
- });
662
- it('should not throw on safeDelete error (fail-open)', async () => {
663
- mockedDynamoDbClient.safeDelete.mockRejectedValueOnce(new Error('DynamoDB error'));
664
- await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('pixel123', 'identity456')).resolves.toBeUndefined();
665
- });
666
- });
667
- describe('deleteIdentityCache', () => {
668
- const pixelId = 'pixel123';
669
- it('should delete all related cache items', async () => {
670
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
671
- { pk: `identity#${pixelId}#identity456`, pixelId },
672
- { pk: `email#${pixelId}#test@email.com`, pixelId },
673
- ]);
674
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
675
- const incomingIdentity = {
676
- identityId: 'identity456',
677
- traits: { emails: ['test@email.com'] },
678
- };
679
- const resolvedIdentity = {
680
- identityId: 'identity456',
681
- traits: { emails: ['test@email.com', 'other@email.com'] },
682
- };
683
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, incomingIdentity, resolvedIdentity);
684
- expect(mockedDynamoDbClient.safeQueryByGSI).toHaveBeenCalled();
685
- expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
686
- });
687
- it('should return early for missing pixelId', async () => {
688
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(null, {}, {});
689
- expect(mockedDynamoDbClient.safeQueryByGSI).not.toHaveBeenCalled();
690
- });
691
- it('should handle different identityIds in incoming vs resolved', async () => {
692
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([{ pk: `identity#${pixelId}#incoming-id`, pixelId }]);
693
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
694
- const incomingIdentity = {
695
- identityId: 'incoming-id',
696
- traits: { emails: ['test@email.com'] },
697
- };
698
- const resolvedIdentity = {
699
- identityId: 'resolved-id',
700
- traits: { emails: ['test@email.com'] },
701
- };
702
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, incomingIdentity, resolvedIdentity);
703
- expect(mockedDynamoDbClient.safeQueryByGSI).toHaveBeenCalledTimes(2);
704
- });
705
- it('should not throw on batchWrite error (fail-open)', async () => {
706
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([{ pk: `identity#${pixelId}#identity456`, pixelId }]);
707
- mockedDynamoDbClient.batchWrite.mockRejectedValueOnce(new Error('DynamoDB error'));
708
- await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' })).resolves.toBeUndefined();
709
- });
710
- it('should deduplicate keys when same items returned from GSI query', async () => {
711
- const duplicateItem = { pk: `identity#${pixelId}#identity456`, pixelId };
712
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([duplicateItem, duplicateItem]);
713
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
714
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' });
715
- expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
716
- const batchWriteCall = mockedDynamoDbClient.batchWrite.mock.calls[0];
717
- expect(batchWriteCall).toBeDefined();
718
- });
719
- });
720
- describe('merge and staleness logic', () => {
721
- const pixelId = 'pixel123';
722
- it('should merge incoming traits with cached traits', async () => {
723
- const cachedResponse = {
724
- pk: `identity#${pixelId}#identity456`,
725
- pixelId,
726
- identityId: 'identity456',
727
- response: {
728
- identityId: 'identity456',
729
- traits: {
730
- emails: ['cached@email.com'],
731
- userIds: ['cached-user'],
732
- },
733
- },
734
- updatedAt: new Date().toISOString(),
735
- };
736
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
737
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
738
- identityId: 'identity456',
739
- traits: {
740
- emails: ['incoming@email.com'],
741
- phones: ['+1234567890'],
742
- },
743
- });
744
- expect(result.resolvedIdentity?.traits?.emails).toContain('incoming@email.com');
745
- expect(result.resolvedIdentity?.traits?.emails).toContain('cached@email.com');
746
- expect(result.resolvedIdentity?.traits?.userIds).toContain('cached-user');
747
- expect(result.resolvedIdentity?.traits?.phones).toContain('+1234567890');
748
- });
749
- it('should mark cache stale when new data present', async () => {
750
- const cachedResponse = {
751
- pk: `identity#${pixelId}#identity456`,
752
- pixelId,
753
- identityId: 'identity456',
754
- response: {
755
- identityId: 'identity456',
756
- traits: { emails: ['cached@email.com'] },
757
- },
758
- updatedAt: new Date().toISOString(),
759
- };
760
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
761
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
762
- identityId: 'identity456',
763
- traits: {
764
- emails: ['cached@email.com', 'new@email.com'],
765
- },
766
- });
767
- expect(result.isCacheStale).toBe(true);
768
- });
769
- it('should not mark cache stale when incoming is subset of cached', async () => {
770
- const cachedResponse = {
771
- pk: `identity#${pixelId}#identity456`,
772
- pixelId,
773
- identityId: 'identity456',
774
- response: {
775
- identityId: 'identity456',
776
- traits: {
777
- emails: ['a@email.com', 'b@email.com'],
778
- userIds: ['user1', 'user2'],
779
- },
780
- },
781
- updatedAt: new Date().toISOString(),
782
- };
783
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
784
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
785
- identityId: 'identity456',
786
- traits: {
787
- emails: ['a@email.com'],
788
- },
789
- });
790
- expect(result.isCacheStale).toBe(false);
791
- });
792
- });
793
- describe('multiple emails pointer writes', () => {
794
- const pixelId = 'pixel123';
795
- it('should write ALL emails as pointer records (not just first)', async () => {
796
- const identity = {
797
- identityId: 'identity456',
798
- traits: {
799
- emails: ['first@email.com', 'second@email.com', 'third@email.com', 'fourth@email.com'],
800
- },
801
- };
802
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
803
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
804
- expect(writtenItems).toHaveLength(5);
805
- const emailPks = writtenItems
806
- .filter((item) => item.pk.startsWith('email#'))
807
- .map((item) => item.pk);
808
- expect(emailPks).toContain(`email#${pixelId}#first@email.com`);
809
- expect(emailPks).toContain(`email#${pixelId}#second@email.com`);
810
- expect(emailPks).toContain(`email#${pixelId}#third@email.com`);
811
- expect(emailPks).toContain(`email#${pixelId}#fourth@email.com`);
812
- });
813
- it('should skip null/undefined emails in array', async () => {
814
- const identity = {
815
- identityId: 'identity456',
816
- traits: {
817
- emails: ['valid@email.com', null, undefined, '', 'another@email.com'],
818
- },
819
- };
820
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
821
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
822
- const emailItems = writtenItems.filter((item) => item.pk.startsWith('email#'));
823
- expect(emailItems).toHaveLength(2);
824
- expect(emailItems.map((e) => e.pk)).toContain(`email#${pixelId}#valid@email.com`);
825
- expect(emailItems.map((e) => e.pk)).toContain(`email#${pixelId}#another@email.com`);
826
- });
827
- it('should handle empty emails array', async () => {
828
- const identity = {
829
- identityId: 'identity456',
830
- traits: { emails: [] },
831
- };
832
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
833
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
834
- expect(writtenItems).toHaveLength(1);
835
- expect(writtenItems[0].pk).toBe(`identity#${pixelId}#identity456`);
836
- });
837
- it('should handle email normalization (lowercase)', async () => {
838
- const identity = {
839
- identityId: 'identity456',
840
- traits: {
841
- emails: ['UPPERCASE@EMAIL.COM', 'MixedCase@Email.Com'],
842
- },
843
- };
844
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
845
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
846
- const emailPks = writtenItems
847
- .filter((item) => item.pk.startsWith('email#'))
848
- .map((item) => item.pk);
849
- expect(emailPks).toContain(`email#${pixelId}#uppercase@email.com`);
850
- expect(emailPks).toContain(`email#${pixelId}#mixedcase@email.com`);
851
- });
852
- });
853
- describe('null/undefined traits edge cases', () => {
854
- const pixelId = 'pixel123';
855
- it('should handle null traits object', async () => {
856
- const identity = {
857
- identityId: 'identity456',
858
- traits: null,
859
- };
860
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
861
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
862
- expect(writtenItems).toHaveLength(1);
863
- });
864
- it('should handle undefined traits object', async () => {
865
- const identity = {
866
- identityId: 'identity456',
867
- traits: undefined,
868
- };
869
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
870
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
871
- expect(writtenItems).toHaveLength(1);
872
- });
873
- it('should return cache miss for identity with null traits in lookup', async () => {
874
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
875
- traits: null,
876
- });
877
- expect(result.resolvedIdentity).toBeUndefined();
878
- expect(result.isCacheStale).toBe(true);
879
- expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
880
- });
881
- it('should handle identity with undefined emails in traits', async () => {
882
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
883
- traits: { userIds: ['user123'] },
884
- });
885
- expect(result.resolvedIdentity).toBeUndefined();
886
- expect(result.isCacheStale).toBe(true);
887
- });
888
- });
889
- describe('backward compatibility (old full-blob format)', () => {
890
- const pixelId = 'pixel123';
891
- it('should read old format email record with full response blob', async () => {
892
- const oldFormatEmailRecord = {
893
- pk: `email#${pixelId}#test@email.com`,
894
- pixelId,
895
- identityId: 'discovered-id',
896
- gsi1pk: 'discovered-id',
897
- response: {
898
- identityId: 'discovered-id',
899
- traits: { emails: ['test@email.com', 'other@email.com'] },
900
- },
901
- updatedAt: new Date().toISOString(),
902
- };
903
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(oldFormatEmailRecord);
904
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
905
- traits: { emails: ['test@email.com'] },
906
- });
907
- expect(result.resolvedIdentity).toBeDefined();
908
- expect(result.resolvedIdentity?.identityId).toBe('discovered-id');
909
- expect(result.isCacheStale).toBe(true);
910
- });
911
- it('should read new format pointer record (no response blob)', async () => {
912
- const newFormatPointerRecord = {
913
- pk: `email#${pixelId}#test@email.com`,
914
- pixelId,
915
- identityId: 'discovered-id',
916
- gsi1pk: 'discovered-id',
917
- updatedAt: new Date().toISOString(),
918
- };
919
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(newFormatPointerRecord);
920
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
921
- traits: { emails: ['test@email.com'] },
922
- });
923
- expect(result.resolvedIdentity).toBeDefined();
924
- expect(result.resolvedIdentity?.identityId).toBe('discovered-id');
925
- expect(result.isCacheStale).toBe(true);
926
- });
927
- it('should trigger Neptune resolution after finding pointer record', async () => {
928
- const lambdaArn = 'arn:aws:lambda:us-east-1:123456789:function:identity-private';
929
- const pointerRecord = {
930
- pk: `email#${pixelId}#test@email.com`,
931
- pixelId,
932
- identityId: 'discovered-id',
933
- gsi1pk: 'discovered-id',
934
- updatedAt: new Date().toISOString(),
935
- };
936
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(pointerRecord);
937
- mockInvokeFunction.mockResolvedValueOnce({
938
- statusCode: 200,
939
- body: JSON.stringify({
940
- identity: {
941
- identityId: 'discovered-id',
942
- traits: { emails: ['test@email.com', 'resolved@email.com'] },
943
- },
944
- }),
945
- });
946
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, { traits: { emails: ['test@email.com'] } }, lambdaArn);
947
- expect(mockInvokeFunction).toHaveBeenCalledWith(lambdaArn, expect.objectContaining({
948
- pixelId,
949
- context: {
950
- identity: expect.objectContaining({
951
- identityId: 'discovered-id',
952
- }),
953
- },
954
- }));
955
- expect(result?.identityId).toBe('discovered-id');
956
- });
957
- });
958
- describe('deleteIdentityCache with multiple email pointers', () => {
959
- const pixelId = 'pixel123';
960
- it('should delete all email pointers from both incoming and resolved identities', async () => {
961
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
962
- { pk: `identity#${pixelId}#identity456`, pixelId },
963
- ]);
964
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
965
- const incomingIdentity = {
966
- identityId: 'identity456',
967
- traits: { emails: ['incoming1@email.com', 'incoming2@email.com'] },
968
- };
969
- const resolvedIdentity = {
970
- identityId: 'identity456',
971
- traits: { emails: ['resolved1@email.com', 'resolved2@email.com', 'resolved3@email.com'] },
972
- };
973
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, incomingIdentity, resolvedIdentity);
974
- expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
975
- const batchWriteCall = mockedDynamoDbClient.batchWrite.mock.calls[0][0];
976
- const deleteRequests = batchWriteCall.RequestItems[Object.keys(batchWriteCall.RequestItems)[0]];
977
- const deletedPks = deleteRequests.map((req) => req.DeleteRequest.Key.pk);
978
- expect(deletedPks).toContain(`identity#${pixelId}#identity456`);
979
- expect(deletedPks).toContain(`email#${pixelId}#incoming1@email.com`);
980
- expect(deletedPks).toContain(`email#${pixelId}#incoming2@email.com`);
981
- expect(deletedPks).toContain(`email#${pixelId}#resolved1@email.com`);
982
- expect(deletedPks).toContain(`email#${pixelId}#resolved2@email.com`);
983
- expect(deletedPks).toContain(`email#${pixelId}#resolved3@email.com`);
984
- });
985
- it('should handle empty emails in delete', async () => {
986
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
987
- { pk: `identity#${pixelId}#identity456`, pixelId },
988
- ]);
989
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
990
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456', traits: { emails: [] } }, { identityId: 'identity456' });
991
- expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
992
- });
993
- it('should handle missing traits in delete', async () => {
994
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
995
- { pk: `identity#${pixelId}#identity456`, pixelId },
996
- ]);
997
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
998
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' });
999
- expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
1000
- });
1001
- it('should not delete items from other pixelIds', async () => {
1002
- const otherPixelId = 'other-pixel';
1003
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
1004
- { pk: `identity#${pixelId}#identity456`, pixelId },
1005
- { pk: `identity#${otherPixelId}#identity456`, pixelId: otherPixelId },
1006
- ]);
1007
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
1008
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' });
1009
- const batchWriteCall = mockedDynamoDbClient.batchWrite.mock.calls[0][0];
1010
- const deleteRequests = batchWriteCall.RequestItems[Object.keys(batchWriteCall.RequestItems)[0]];
1011
- const deletedPks = deleteRequests.map((req) => req.DeleteRequest.Key.pk);
1012
- expect(deletedPks).toContain(`identity#${pixelId}#identity456`);
1013
- expect(deletedPks).not.toContain(`identity#${otherPixelId}#identity456`);
1014
- });
1015
- });
1016
- describe('GSI1 query for reverse lookups', () => {
1017
- const pixelId = 'pixel123';
1018
- it('should find all records by identityId via GSI1', async () => {
1019
- const identityId = 'identity456';
1020
- const mockResults = [
1021
- { pk: `identity#${pixelId}#${identityId}`, pixelId, identityId },
1022
- { pk: `email#${pixelId}#email1@test.com`, pixelId, identityId },
1023
- { pk: `email#${pixelId}#email2@test.com`, pixelId, identityId },
1024
- ];
1025
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue(mockResults);
1026
- mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
1027
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId }, { identityId });
1028
- expect(mockedDynamoDbClient.safeQueryByGSI).toHaveBeenCalledWith(expect.any(String), expect.any(String), 'gsi1pk', identityId);
1029
- });
1030
- it('should handle GSI1 query returning empty results', async () => {
1031
- mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([]);
1032
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'unknown-id' }, { identityId: 'unknown-id' });
1033
- expect(mockedDynamoDbClient.batchWrite).not.toHaveBeenCalled();
1034
- });
1035
- it('should handle GSI1 query error gracefully (fail-open)', async () => {
1036
- mockedDynamoDbClient.safeQueryByGSI.mockRejectedValueOnce(new Error('GSI query failed'));
1037
- await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' })).resolves.toBeUndefined();
1038
- });
1039
- });
1040
- describe('email pointer lookups', () => {
1041
- const pixelId = 'pixel123';
1042
- it('should only lookup first email (optimization)', async () => {
1043
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1044
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
1045
- traits: { emails: ['first@email.com', 'second@email.com', 'third@email.com'] },
1046
- });
1047
- expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledTimes(1);
1048
- expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `email#${pixelId}#first@email.com`);
1049
- });
1050
- it('should handle whitespace in email during lookup', async () => {
1051
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1052
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
1053
- traits: { emails: [' test@email.com '] },
1054
- });
1055
- expect(mockedDynamoDbClient.safeGet).toHaveBeenCalled();
1056
- });
1057
- });
1058
- describe('fail-open behavior comprehensive', () => {
1059
- const pixelId = 'pixel123';
1060
- const lambdaArn = 'arn:aws:lambda:us-east-1:123456789:function:identity-private';
1061
- it('should return incoming identity when Neptune throws (fail-open fallback)', async () => {
1062
- const incomingIdentity = {
1063
- identityId: 'identity456',
1064
- traits: { emails: ['test@email.com'] },
1065
- };
1066
- mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB down'));
1067
- mockInvokeFunction.mockRejectedValueOnce(new Error('Lambda down'));
1068
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
1069
- expect(result).toEqual(incomingIdentity);
1070
- });
1071
- it('should continue when cache write fails after Neptune success', async () => {
1072
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1073
- mockInvokeFunction.mockResolvedValueOnce({
1074
- statusCode: 200,
1075
- body: JSON.stringify({
1076
- identity: { identityId: 'resolved-id', traits: { emails: ['test@email.com'] } },
1077
- }),
1078
- });
1079
- mockedDynamoDbClient.safeBatchWrite.mockRejectedValueOnce(new Error('Write failed'));
1080
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, { traits: { emails: ['test@email.com'] } }, lambdaArn);
1081
- expect(result?.identityId).toBe('resolved-id');
1082
- });
1083
- it('should return incoming identity when Neptune returns non-200', async () => {
1084
- const incomingIdentity = {
1085
- identityId: 'incoming-id',
1086
- traits: { emails: ['test@email.com'] },
1087
- };
1088
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1089
- mockInvokeFunction.mockResolvedValueOnce({
1090
- statusCode: 500,
1091
- body: 'Internal Server Error',
1092
- });
1093
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
1094
- expect(result).toEqual(incomingIdentity);
1095
- });
1096
- it('should return incoming identity when Neptune returns malformed JSON (fail-open)', async () => {
1097
- const incomingIdentity = {
1098
- identityId: 'test-id',
1099
- traits: { emails: ['test@email.com'] },
1100
- };
1101
- mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1102
- mockInvokeFunction.mockResolvedValueOnce({
1103
- statusCode: 200,
1104
- body: 'not valid json',
1105
- });
1106
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
1107
- expect(result).toEqual(incomingIdentity);
1108
- });
1109
- it('should return undefined only when both inputs are invalid', async () => {
1110
- const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(null, null, lambdaArn);
1111
- expect(result).toBeUndefined();
1112
- });
1113
- });
1114
- describe('gsi1pk attribute on all records', () => {
1115
- const pixelId = 'pixel123';
1116
- it('should include gsi1pk on identity record', async () => {
1117
- const identity = {
1118
- identityId: 'identity456',
1119
- traits: { emails: ['test@email.com'] },
1120
- };
1121
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
1122
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
1123
- const identityItem = writtenItems.find((item) => item.pk.startsWith('identity#'));
1124
- expect(identityItem).toBeDefined();
1125
- expect(identityItem.gsi1pk).toBe('identity456');
1126
- });
1127
- it('should include gsi1pk on all email pointer records', async () => {
1128
- const identity = {
1129
- identityId: 'identity456',
1130
- traits: { emails: ['email1@test.com', 'email2@test.com'] },
1131
- };
1132
- await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
1133
- const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
1134
- const emailItems = writtenItems.filter((item) => item.pk.startsWith('email#'));
1135
- for (const emailItem of emailItems) {
1136
- expect(emailItem.gsi1pk).toBe('identity456');
1137
- }
1138
- });
1139
- });
1140
- });
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const mockInvokeFunction = jest.fn();
4
+ jest.mock('../../clients/index.js', () => ({
5
+ DynamoDbClient: {
6
+ safeGet: jest.fn(),
7
+ safePut: jest.fn(),
8
+ safeDelete: jest.fn(),
9
+ safeBatchGet: jest.fn(),
10
+ safeBatchWrite: jest.fn(),
11
+ safeQueryByGSI: jest.fn(),
12
+ batchWrite: jest.fn(),
13
+ },
14
+ LambdaInvokeClient: jest.fn().mockImplementation(() => ({
15
+ invokeFunction: mockInvokeFunction,
16
+ })),
17
+ }));
18
+ jest.mock('../../helpers/index.js', () => ({
19
+ Logger: {
20
+ debug: jest.fn(),
21
+ info: jest.fn(),
22
+ warn: jest.fn(),
23
+ error: jest.fn(),
24
+ },
25
+ }));
26
+ const identity_cache_dynamodb_service_js_1 = require("../../services/db/identity-cache-dynamodb-service.js");
27
+ const index_js_1 = require("../../clients/index.js");
28
+ const mockedDynamoDbClient = index_js_1.DynamoDbClient;
29
+ describe('IdentityCacheDynamoDbService', () => {
30
+ beforeEach(() => {
31
+ jest.clearAllMocks();
32
+ mockedDynamoDbClient.safeGet.mockReset();
33
+ mockedDynamoDbClient.safePut.mockReset();
34
+ mockedDynamoDbClient.safeDelete.mockReset();
35
+ mockedDynamoDbClient.safeBatchGet.mockReset();
36
+ mockedDynamoDbClient.safeBatchWrite.mockReset();
37
+ mockedDynamoDbClient.safeQueryByGSI.mockReset();
38
+ mockedDynamoDbClient.batchWrite.mockReset();
39
+ mockInvokeFunction.mockReset();
40
+ identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.lambdaInvokeClient = undefined;
41
+ });
42
+ describe('getIdentityWithCaching', () => {
43
+ const pixelId = 'pixel123';
44
+ const lambdaArn = 'arn:aws:lambda:us-east-1:123456789:function:identity-private';
45
+ describe('cache hit (fresh cache)', () => {
46
+ it('should return cached identity without invoking Neptune Lambda', async () => {
47
+ const incomingIdentity = {
48
+ identityId: 'identity456',
49
+ traits: { emails: ['test@email.com'] },
50
+ };
51
+ const cachedResponse = {
52
+ pk: `identity#${pixelId}#identity456`,
53
+ pixelId,
54
+ identityId: 'identity456',
55
+ response: {
56
+ identityId: 'identity456',
57
+ traits: { emails: ['test@email.com'] },
58
+ },
59
+ updatedAt: new Date().toISOString(),
60
+ };
61
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
62
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
63
+ expect(result).toBeDefined();
64
+ expect(result?.identityId).toBe('identity456');
65
+ expect(mockInvokeFunction).not.toHaveBeenCalled();
66
+ });
67
+ });
68
+ describe('cache miss', () => {
69
+ it('should invoke Neptune Lambda and return resolved identity', async () => {
70
+ const incomingIdentity = {
71
+ identityId: 'identity456',
72
+ traits: { emails: ['test@email.com'] },
73
+ };
74
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
75
+ mockInvokeFunction.mockResolvedValueOnce({
76
+ statusCode: 200,
77
+ body: JSON.stringify({
78
+ identity: {
79
+ identityId: 'resolved-identity',
80
+ traits: { emails: ['test@email.com', 'resolved@email.com'] },
81
+ },
82
+ }),
83
+ });
84
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
85
+ expect(mockInvokeFunction).toHaveBeenCalledWith(lambdaArn, {
86
+ pixelId,
87
+ context: { identity: incomingIdentity },
88
+ });
89
+ expect(result?.identityId).toBe('resolved-identity');
90
+ expect(mockedDynamoDbClient.safeBatchWrite).toHaveBeenCalled();
91
+ });
92
+ it('should return incomingIdentity when Neptune Lambda fails to resolve', async () => {
93
+ const incomingIdentity = {
94
+ identityId: 'identity456',
95
+ traits: { emails: ['test@email.com'] },
96
+ };
97
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
98
+ mockInvokeFunction.mockResolvedValueOnce({
99
+ statusCode: 200,
100
+ body: JSON.stringify({ identity: undefined }),
101
+ });
102
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
103
+ expect(result).toEqual(incomingIdentity);
104
+ });
105
+ });
106
+ describe('cache stale', () => {
107
+ it('should invoke Neptune Lambda when cache is stale', async () => {
108
+ const incomingIdentity = {
109
+ identityId: 'identity456',
110
+ traits: { emails: ['old@email.com', 'new@email.com'] },
111
+ };
112
+ const cachedResponse = {
113
+ pk: `identity#${pixelId}#identity456`,
114
+ pixelId,
115
+ identityId: 'identity456',
116
+ response: {
117
+ identityId: 'identity456',
118
+ traits: { emails: ['old@email.com'] },
119
+ },
120
+ updatedAt: new Date().toISOString(),
121
+ };
122
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
123
+ mockInvokeFunction.mockResolvedValueOnce({
124
+ statusCode: 200,
125
+ body: JSON.stringify({
126
+ identity: {
127
+ identityId: 'identity456',
128
+ traits: { emails: ['old@email.com', 'new@email.com'] },
129
+ },
130
+ }),
131
+ });
132
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
133
+ expect(mockInvokeFunction).toHaveBeenCalled();
134
+ expect(result?.identityId).toBe('identity456');
135
+ expect(result?.traits?.emails).toContain('new@email.com');
136
+ });
137
+ it('should use merged cache identity when Neptune fails', async () => {
138
+ const incomingIdentity = {
139
+ identityId: 'identity456',
140
+ traits: { emails: ['old@email.com', 'new@email.com'] },
141
+ };
142
+ const cachedResponse = {
143
+ pk: `identity#${pixelId}#identity456`,
144
+ pixelId,
145
+ identityId: 'identity456',
146
+ response: {
147
+ identityId: 'identity456',
148
+ traits: { emails: ['old@email.com'] },
149
+ },
150
+ updatedAt: new Date().toISOString(),
151
+ };
152
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
153
+ mockInvokeFunction.mockResolvedValueOnce({
154
+ statusCode: 500,
155
+ body: 'Internal Server Error',
156
+ });
157
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
158
+ expect(result).toBeDefined();
159
+ expect(result?.identityId).toBe('identity456');
160
+ });
161
+ });
162
+ describe('Neptune Lambda invocation', () => {
163
+ it('should write-back Neptune response to cache on success', async () => {
164
+ const incomingIdentity = {
165
+ traits: { emails: ['test@email.com'] },
166
+ };
167
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
168
+ mockInvokeFunction.mockResolvedValueOnce({
169
+ statusCode: 200,
170
+ body: JSON.stringify({
171
+ identity: {
172
+ identityId: 'neptune-resolved-id',
173
+ traits: { emails: ['test@email.com'] },
174
+ },
175
+ }),
176
+ });
177
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
178
+ expect(mockedDynamoDbClient.safeBatchWrite).toHaveBeenCalled();
179
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
180
+ const identityPks = writtenItems.map((item) => item.pk);
181
+ expect(identityPks).toContain(`identity#${pixelId}#neptune-resolved-id`);
182
+ });
183
+ it('should not write to cache when Neptune returns undefined', async () => {
184
+ const incomingIdentity = {
185
+ traits: { emails: ['test@email.com'] },
186
+ };
187
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
188
+ mockInvokeFunction.mockResolvedValueOnce({
189
+ statusCode: 200,
190
+ body: JSON.stringify({ identity: undefined }),
191
+ });
192
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
193
+ expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
194
+ });
195
+ });
196
+ describe('error handling (fail-open)', () => {
197
+ it('should return undefined when pixelId is missing', async () => {
198
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(null, { identityId: 'test-id' }, lambdaArn);
199
+ expect(result).toBeUndefined();
200
+ expect(mockInvokeFunction).not.toHaveBeenCalled();
201
+ });
202
+ it('should return undefined when incomingIdentity is missing', async () => {
203
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, null, lambdaArn);
204
+ expect(result).toBeUndefined();
205
+ expect(mockInvokeFunction).not.toHaveBeenCalled();
206
+ });
207
+ it('should return undefined when Neptune Lambda throws', async () => {
208
+ const incomingIdentity = {
209
+ identityId: 'identity456',
210
+ traits: { emails: ['test@email.com'] },
211
+ };
212
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
213
+ mockInvokeFunction.mockRejectedValueOnce(new Error('Lambda invocation failed'));
214
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
215
+ expect(result).toEqual(incomingIdentity);
216
+ });
217
+ it('should not throw when cache write fails after Neptune success', async () => {
218
+ const incomingIdentity = {
219
+ traits: { emails: ['test@email.com'] },
220
+ };
221
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
222
+ mockInvokeFunction.mockResolvedValueOnce({
223
+ statusCode: 200,
224
+ body: JSON.stringify({
225
+ identity: {
226
+ identityId: 'neptune-resolved-id',
227
+ traits: { emails: ['test@email.com'] },
228
+ },
229
+ }),
230
+ });
231
+ mockedDynamoDbClient.safeBatchWrite.mockRejectedValueOnce(new Error('DynamoDB write failed'));
232
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
233
+ expect(result?.identityId).toBe('neptune-resolved-id');
234
+ });
235
+ });
236
+ });
237
+ describe('Key Builders', () => {
238
+ describe('buildIdentityPk', () => {
239
+ it('should build correct pk for identity lookup', async () => {
240
+ const pixelId = 'pixel123';
241
+ const identityId = 'identity456';
242
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
243
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, { identityId });
244
+ expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `identity#${pixelId}#${identityId}`);
245
+ });
246
+ });
247
+ describe('buildEmailPk', () => {
248
+ it('should build correct pk for email lookup (lowercase)', async () => {
249
+ const pixelId = 'pixel123';
250
+ const email = 'Test@Email.COM';
251
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
252
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
253
+ traits: { emails: [email] },
254
+ });
255
+ expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `email#${pixelId}#test@email.com`);
256
+ });
257
+ });
258
+ describe('buildUserIdPk (no longer used for lookup)', () => {
259
+ it('should NOT lookup by userId (optimization: email-only secondary lookup)', async () => {
260
+ const pixelId = 'pixel123';
261
+ const userId = ' user789 ';
262
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
263
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
264
+ traits: { userIds: [userId] },
265
+ });
266
+ expect(mockedDynamoDbClient.safeBatchGet).not.toHaveBeenCalled();
267
+ });
268
+ });
269
+ });
270
+ describe('getIdentityFromCache', () => {
271
+ const pixelId = 'pixel123';
272
+ describe('with identityId (primary lookup)', () => {
273
+ it('should return cache hit when identity found', async () => {
274
+ const identityId = 'identity456';
275
+ const cachedResponse = {
276
+ pk: `identity#${pixelId}#${identityId}`,
277
+ pixelId,
278
+ identityId,
279
+ response: {
280
+ identityId,
281
+ traits: { emails: ['test@email.com'] },
282
+ },
283
+ updatedAt: new Date().toISOString(),
284
+ };
285
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
286
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
287
+ identityId,
288
+ traits: { emails: ['test@email.com'] },
289
+ });
290
+ expect(result.resolvedIdentity).toBeDefined();
291
+ expect(result.resolvedIdentity?.identityId).toBe(identityId);
292
+ expect(result.isCacheStale).toBe(false);
293
+ });
294
+ it('should return cache miss when identity not found', async () => {
295
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
296
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
297
+ identityId: 'unknown-id',
298
+ });
299
+ expect(result.resolvedIdentity).toBeUndefined();
300
+ expect(result.isCacheStale).toBe(true);
301
+ });
302
+ it('should NOT fallback to secondary keys when identityId lookup misses', async () => {
303
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
304
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
305
+ identityId: 'unknown-id',
306
+ traits: { emails: ['test@email.com'] },
307
+ });
308
+ expect(mockedDynamoDbClient.safeBatchGet).not.toHaveBeenCalled();
309
+ });
310
+ it('should detect stale cache when new traits present', async () => {
311
+ const identityId = 'identity456';
312
+ const cachedResponse = {
313
+ pk: `identity#${pixelId}#${identityId}`,
314
+ pixelId,
315
+ identityId,
316
+ response: {
317
+ identityId,
318
+ traits: { emails: ['old@email.com'] },
319
+ },
320
+ updatedAt: new Date().toISOString(),
321
+ };
322
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
323
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
324
+ identityId,
325
+ traits: { emails: ['old@email.com', 'new@email.com'] },
326
+ });
327
+ expect(result.resolvedIdentity).toBeDefined();
328
+ expect(result.isCacheStale).toBe(true);
329
+ });
330
+ });
331
+ describe('without identityId (secondary lookup)', () => {
332
+ it('should use single get for email lookup (pointer-based)', async () => {
333
+ const pointerRecord = {
334
+ pk: `email#${pixelId}#test@email.com`,
335
+ pixelId,
336
+ identityId: 'resolved-id',
337
+ gsi1pk: 'resolved-id',
338
+ updatedAt: new Date().toISOString(),
339
+ };
340
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(pointerRecord);
341
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
342
+ traits: { emails: ['test@email.com'], userIds: ['user123'] },
343
+ });
344
+ expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `email#${pixelId}#test@email.com`);
345
+ expect(mockedDynamoDbClient.safeBatchGet).not.toHaveBeenCalled();
346
+ expect(result.resolvedIdentity).toBeDefined();
347
+ expect(result.resolvedIdentity?.traits?.emails).toContain('test@email.com');
348
+ expect(result.isCacheStale).toBe(true);
349
+ });
350
+ it('should return discovered identityId with stale flag for Neptune resolution', async () => {
351
+ const pointerRecord = {
352
+ pk: `email#${pixelId}#test@email.com`,
353
+ pixelId,
354
+ identityId: 'discovered-id',
355
+ gsi1pk: 'discovered-id',
356
+ updatedAt: new Date().toISOString(),
357
+ };
358
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(pointerRecord);
359
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
360
+ traits: { emails: ['test@email.com'], userIds: ['user123'] },
361
+ });
362
+ expect(result.resolvedIdentity).toBeDefined();
363
+ expect(result.resolvedIdentity?.identityId).toBe('discovered-id');
364
+ expect(result.isCacheStale).toBe(true);
365
+ });
366
+ it('should return cache miss when no secondary keys match', async () => {
367
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
368
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
369
+ traits: { emails: ['unknown@email.com'] },
370
+ });
371
+ expect(result.resolvedIdentity).toBeUndefined();
372
+ expect(result.isCacheStale).toBe(true);
373
+ });
374
+ it('should return cache miss when no emails to lookup', async () => {
375
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
376
+ traits: { userIds: ['user123'] },
377
+ });
378
+ expect(result.resolvedIdentity).toBeUndefined();
379
+ expect(result.isCacheStale).toBe(true);
380
+ expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
381
+ });
382
+ it('should return cache miss when empty traits', async () => {
383
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
384
+ traits: {},
385
+ });
386
+ expect(result.resolvedIdentity).toBeUndefined();
387
+ expect(result.isCacheStale).toBe(true);
388
+ });
389
+ });
390
+ describe('error handling (fail-open)', () => {
391
+ it('should return cache miss on safeGet error', async () => {
392
+ mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
393
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
394
+ identityId: 'test-id',
395
+ });
396
+ expect(result.resolvedIdentity).toBeUndefined();
397
+ expect(result.isCacheStale).toBe(true);
398
+ });
399
+ it('should return cache miss on safeGet error for email lookup', async () => {
400
+ mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
401
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
402
+ traits: { emails: ['test@email.com'] },
403
+ });
404
+ expect(result.resolvedIdentity).toBeUndefined();
405
+ expect(result.isCacheStale).toBe(true);
406
+ });
407
+ it('should return cache miss for null pixelId', async () => {
408
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(null, {
409
+ identityId: 'test-id',
410
+ });
411
+ expect(result.resolvedIdentity).toBeUndefined();
412
+ expect(result.isCacheStale).toBe(true);
413
+ });
414
+ it('should return cache miss for null incomingIdentity', async () => {
415
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, null);
416
+ expect(result.resolvedIdentity).toBeUndefined();
417
+ expect(result.isCacheStale).toBe(true);
418
+ });
419
+ });
420
+ });
421
+ describe('updateIdentityCache', () => {
422
+ const pixelId = 'pixel123';
423
+ it('should write identity with email pointer (no full blob on secondary keys)', async () => {
424
+ const identity = {
425
+ identityId: 'identity456',
426
+ traits: {
427
+ emails: ['test@email.com', 'other@email.com'],
428
+ userIds: ['user1', 'user2'],
429
+ },
430
+ };
431
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
432
+ expect(mockedDynamoDbClient.safeBatchWrite).toHaveBeenCalledTimes(1);
433
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
434
+ expect(writtenItems).toHaveLength(3);
435
+ const pks = writtenItems.map((item) => item.pk);
436
+ expect(pks).toContain(`identity#${pixelId}#identity456`);
437
+ expect(pks).toContain(`email#${pixelId}#test@email.com`);
438
+ expect(pks).toContain(`email#${pixelId}#other@email.com`);
439
+ expect(pks).not.toContain(`user_id#${pixelId}#user1`);
440
+ expect(pks).not.toContain(`user_id#${pixelId}#user2`);
441
+ const identityItem = writtenItems.find((item) => item.pk.startsWith('identity#'));
442
+ expect(identityItem).toBeDefined();
443
+ expect(identityItem.response).toBeDefined();
444
+ expect(identityItem.response.identityId).toBe('identity456');
445
+ const emailItem = writtenItems.find((item) => item.pk.startsWith('email#'));
446
+ expect(emailItem).toBeDefined();
447
+ expect(emailItem.response).toBeUndefined();
448
+ expect(emailItem.identityId).toBe('identity456');
449
+ });
450
+ it('should not throw on safeBatchWrite error (fail-open)', async () => {
451
+ mockedDynamoDbClient.safeBatchWrite.mockRejectedValueOnce(new Error('DynamoDB error'));
452
+ const identity = {
453
+ identityId: 'identity456',
454
+ traits: { emails: ['test@email.com'] },
455
+ };
456
+ await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity)).resolves.toBeUndefined();
457
+ });
458
+ it('should return early for missing identityId', async () => {
459
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, {});
460
+ expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
461
+ });
462
+ it('should return early for missing pixelId', async () => {
463
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(null, {
464
+ identityId: 'test-id',
465
+ });
466
+ expect(mockedDynamoDbClient.safeBatchWrite).not.toHaveBeenCalled();
467
+ });
468
+ it('should handle identity with no traits', async () => {
469
+ const identity = {
470
+ identityId: 'identity456',
471
+ };
472
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
473
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
474
+ expect(writtenItems).toHaveLength(1);
475
+ });
476
+ it('should include gsi1pk for reverse lookups', async () => {
477
+ const identity = {
478
+ identityId: 'identity456',
479
+ traits: { emails: ['test@email.com'] },
480
+ };
481
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
482
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
483
+ for (const item of writtenItems) {
484
+ expect(item.gsi1pk).toBe('identity456');
485
+ }
486
+ });
487
+ });
488
+ describe('getIdentityMap', () => {
489
+ it('should return identity map when found', async () => {
490
+ const mockMap = {
491
+ pk: 'identity_map#pixel123#identity456',
492
+ pixelId: 'pixel123',
493
+ identityId: 'identity456',
494
+ linkedIdentities: ['identity789'],
495
+ updatedAt: new Date().toISOString(),
496
+ };
497
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(mockMap);
498
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', 'identity456');
499
+ expect(result).toEqual(mockMap);
500
+ expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', 'identity_map#pixel123#identity456');
501
+ });
502
+ it('should return undefined when not found', async () => {
503
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
504
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', 'identity456');
505
+ expect(result).toBeUndefined();
506
+ });
507
+ it('should return undefined for missing params (fail-open)', async () => {
508
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('', '');
509
+ expect(result).toBeUndefined();
510
+ expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
511
+ });
512
+ it('should return undefined when only pixelId is missing', async () => {
513
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('', 'identity456');
514
+ expect(result).toBeUndefined();
515
+ expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
516
+ });
517
+ it('should return undefined when only identityId is missing', async () => {
518
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', '');
519
+ expect(result).toBeUndefined();
520
+ expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
521
+ });
522
+ it('should return undefined on safeGet error (fail-open)', async () => {
523
+ mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
524
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityMap('pixel123', 'identity456');
525
+ expect(result).toBeUndefined();
526
+ });
527
+ });
528
+ describe('getForcePurgeFlag', () => {
529
+ it('should return true when flag exists', async () => {
530
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce({
531
+ pk: 'force_purge#pixel123#identity456',
532
+ });
533
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('pixel123', 'identity456');
534
+ expect(result).toBe(true);
535
+ });
536
+ it('should return false when flag not found', async () => {
537
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
538
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('pixel123', 'identity456');
539
+ expect(result).toBe(false);
540
+ });
541
+ it('should return false on error (fail-open)', async () => {
542
+ mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB error'));
543
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('pixel123', 'identity456');
544
+ expect(result).toBe(false);
545
+ });
546
+ it('should return false for missing params', async () => {
547
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getForcePurgeFlag('', '');
548
+ expect(result).toBe(false);
549
+ expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
550
+ });
551
+ });
552
+ describe('setForcePurgeFlag', () => {
553
+ it('should set flag with TTL', async () => {
554
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456');
555
+ expect(mockedDynamoDbClient.safePut).toHaveBeenCalledTimes(1);
556
+ const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
557
+ expect(putItem.pk).toBe('force_purge#pixel123#identity456');
558
+ expect(putItem.pixelId).toBe('pixel123');
559
+ expect(putItem.identityId).toBe('identity456');
560
+ expect(putItem.ttl).toBeGreaterThan(0);
561
+ });
562
+ it('should accept custom TTL', async () => {
563
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456', 3600);
564
+ const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
565
+ expect(putItem.ttl).toBeGreaterThan(0);
566
+ });
567
+ it('should include createdAt timestamp', async () => {
568
+ const before = new Date().toISOString();
569
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456');
570
+ const after = new Date().toISOString();
571
+ const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
572
+ expect(putItem.createdAt).toBeDefined();
573
+ expect(putItem.createdAt >= before).toBe(true);
574
+ expect(putItem.createdAt <= after).toBe(true);
575
+ });
576
+ it('should return early when pixelId is missing', async () => {
577
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('', 'identity456');
578
+ expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
579
+ });
580
+ it('should return early when identityId is missing', async () => {
581
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', '');
582
+ expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
583
+ });
584
+ it('should not throw on error (fail-open)', async () => {
585
+ mockedDynamoDbClient.safePut.mockRejectedValueOnce(new Error('DynamoDB error'));
586
+ await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.setForcePurgeFlag('pixel123', 'identity456')).resolves.toBeUndefined();
587
+ });
588
+ });
589
+ describe('putIdentityMap', () => {
590
+ it('should write identity map', async () => {
591
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', 'identity456', ['linked1', 'linked2']);
592
+ expect(mockedDynamoDbClient.safePut).toHaveBeenCalledTimes(1);
593
+ const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
594
+ expect(putItem.pk).toBe('identity_map#pixel123#identity456');
595
+ expect(putItem.linkedIdentities).toEqual(['linked1', 'linked2']);
596
+ });
597
+ it('should return early for missing params', async () => {
598
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('', '', []);
599
+ expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
600
+ });
601
+ it('should return early when only pixelId is missing', async () => {
602
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('', 'identity456', ['linked1']);
603
+ expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
604
+ });
605
+ it('should return early when only identityId is missing', async () => {
606
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', '', ['linked1']);
607
+ expect(mockedDynamoDbClient.safePut).not.toHaveBeenCalled();
608
+ });
609
+ it('should include updatedAt timestamp', async () => {
610
+ const before = new Date().toISOString();
611
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', 'identity456', ['linked1']);
612
+ const after = new Date().toISOString();
613
+ const putItem = mockedDynamoDbClient.safePut.mock.calls[0][1];
614
+ expect(putItem.updatedAt).toBeDefined();
615
+ expect(putItem.updatedAt >= before).toBe(true);
616
+ expect(putItem.updatedAt <= after).toBe(true);
617
+ });
618
+ it('should not throw on safePut error (fail-open)', async () => {
619
+ mockedDynamoDbClient.safePut.mockRejectedValueOnce(new Error('DynamoDB error'));
620
+ await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.putIdentityMap('pixel123', 'identity456', ['linked1'])).resolves.toBeUndefined();
621
+ });
622
+ });
623
+ describe('deleteIdentityMap', () => {
624
+ it('should delete identity map', async () => {
625
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('pixel123', 'identity456');
626
+ expect(mockedDynamoDbClient.safeDelete).toHaveBeenCalledWith(expect.any(String), 'pk', 'identity_map#pixel123#identity456');
627
+ });
628
+ it('should return early for missing params', async () => {
629
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('', '');
630
+ expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
631
+ });
632
+ it('should return early when only pixelId is missing', async () => {
633
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('', 'identity456');
634
+ expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
635
+ });
636
+ it('should return early when only identityId is missing', async () => {
637
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('pixel123', '');
638
+ expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
639
+ });
640
+ it('should not throw on safeDelete error (fail-open)', async () => {
641
+ mockedDynamoDbClient.safeDelete.mockRejectedValueOnce(new Error('DynamoDB error'));
642
+ await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityMap('pixel123', 'identity456')).resolves.toBeUndefined();
643
+ });
644
+ });
645
+ describe('deleteForcePurgeFlag', () => {
646
+ it('should delete force purge flag', async () => {
647
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('pixel123', 'identity456');
648
+ expect(mockedDynamoDbClient.safeDelete).toHaveBeenCalledWith(expect.any(String), 'pk', 'force_purge#pixel123#identity456');
649
+ });
650
+ it('should return early for missing params', async () => {
651
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('', '');
652
+ expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
653
+ });
654
+ it('should return early when only pixelId is missing', async () => {
655
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('', 'identity456');
656
+ expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
657
+ });
658
+ it('should return early when only identityId is missing', async () => {
659
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('pixel123', '');
660
+ expect(mockedDynamoDbClient.safeDelete).not.toHaveBeenCalled();
661
+ });
662
+ it('should not throw on safeDelete error (fail-open)', async () => {
663
+ mockedDynamoDbClient.safeDelete.mockRejectedValueOnce(new Error('DynamoDB error'));
664
+ await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteForcePurgeFlag('pixel123', 'identity456')).resolves.toBeUndefined();
665
+ });
666
+ });
667
+ describe('deleteIdentityCache', () => {
668
+ const pixelId = 'pixel123';
669
+ it('should delete all related cache items', async () => {
670
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
671
+ { pk: `identity#${pixelId}#identity456`, pixelId },
672
+ { pk: `email#${pixelId}#test@email.com`, pixelId },
673
+ ]);
674
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
675
+ const incomingIdentity = {
676
+ identityId: 'identity456',
677
+ traits: { emails: ['test@email.com'] },
678
+ };
679
+ const resolvedIdentity = {
680
+ identityId: 'identity456',
681
+ traits: { emails: ['test@email.com', 'other@email.com'] },
682
+ };
683
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, incomingIdentity, resolvedIdentity);
684
+ expect(mockedDynamoDbClient.safeQueryByGSI).toHaveBeenCalled();
685
+ expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
686
+ });
687
+ it('should return early for missing pixelId', async () => {
688
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(null, {}, {});
689
+ expect(mockedDynamoDbClient.safeQueryByGSI).not.toHaveBeenCalled();
690
+ });
691
+ it('should handle different identityIds in incoming vs resolved', async () => {
692
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([{ pk: `identity#${pixelId}#incoming-id`, pixelId }]);
693
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
694
+ const incomingIdentity = {
695
+ identityId: 'incoming-id',
696
+ traits: { emails: ['test@email.com'] },
697
+ };
698
+ const resolvedIdentity = {
699
+ identityId: 'resolved-id',
700
+ traits: { emails: ['test@email.com'] },
701
+ };
702
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, incomingIdentity, resolvedIdentity);
703
+ expect(mockedDynamoDbClient.safeQueryByGSI).toHaveBeenCalledTimes(2);
704
+ });
705
+ it('should not throw on batchWrite error (fail-open)', async () => {
706
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([{ pk: `identity#${pixelId}#identity456`, pixelId }]);
707
+ mockedDynamoDbClient.batchWrite.mockRejectedValueOnce(new Error('DynamoDB error'));
708
+ await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' })).resolves.toBeUndefined();
709
+ });
710
+ it('should deduplicate keys when same items returned from GSI query', async () => {
711
+ const duplicateItem = { pk: `identity#${pixelId}#identity456`, pixelId };
712
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([duplicateItem, duplicateItem]);
713
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
714
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' });
715
+ expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
716
+ const batchWriteCall = mockedDynamoDbClient.batchWrite.mock.calls[0];
717
+ expect(batchWriteCall).toBeDefined();
718
+ });
719
+ });
720
+ describe('merge and staleness logic', () => {
721
+ const pixelId = 'pixel123';
722
+ it('should merge incoming traits with cached traits', async () => {
723
+ const cachedResponse = {
724
+ pk: `identity#${pixelId}#identity456`,
725
+ pixelId,
726
+ identityId: 'identity456',
727
+ response: {
728
+ identityId: 'identity456',
729
+ traits: {
730
+ emails: ['cached@email.com'],
731
+ userIds: ['cached-user'],
732
+ },
733
+ },
734
+ updatedAt: new Date().toISOString(),
735
+ };
736
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
737
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
738
+ identityId: 'identity456',
739
+ traits: {
740
+ emails: ['incoming@email.com'],
741
+ phones: ['+1234567890'],
742
+ },
743
+ });
744
+ expect(result.resolvedIdentity?.traits?.emails).toContain('incoming@email.com');
745
+ expect(result.resolvedIdentity?.traits?.emails).toContain('cached@email.com');
746
+ expect(result.resolvedIdentity?.traits?.userIds).toContain('cached-user');
747
+ expect(result.resolvedIdentity?.traits?.phones).toContain('+1234567890');
748
+ });
749
+ it('should mark cache stale when new data present', async () => {
750
+ const cachedResponse = {
751
+ pk: `identity#${pixelId}#identity456`,
752
+ pixelId,
753
+ identityId: 'identity456',
754
+ response: {
755
+ identityId: 'identity456',
756
+ traits: { emails: ['cached@email.com'] },
757
+ },
758
+ updatedAt: new Date().toISOString(),
759
+ };
760
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
761
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
762
+ identityId: 'identity456',
763
+ traits: {
764
+ emails: ['cached@email.com', 'new@email.com'],
765
+ },
766
+ });
767
+ expect(result.isCacheStale).toBe(true);
768
+ });
769
+ it('should not mark cache stale when incoming is subset of cached', async () => {
770
+ const cachedResponse = {
771
+ pk: `identity#${pixelId}#identity456`,
772
+ pixelId,
773
+ identityId: 'identity456',
774
+ response: {
775
+ identityId: 'identity456',
776
+ traits: {
777
+ emails: ['a@email.com', 'b@email.com'],
778
+ userIds: ['user1', 'user2'],
779
+ },
780
+ },
781
+ updatedAt: new Date().toISOString(),
782
+ };
783
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(cachedResponse);
784
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
785
+ identityId: 'identity456',
786
+ traits: {
787
+ emails: ['a@email.com'],
788
+ },
789
+ });
790
+ expect(result.isCacheStale).toBe(false);
791
+ });
792
+ });
793
+ describe('multiple emails pointer writes', () => {
794
+ const pixelId = 'pixel123';
795
+ it('should write ALL emails as pointer records (not just first)', async () => {
796
+ const identity = {
797
+ identityId: 'identity456',
798
+ traits: {
799
+ emails: ['first@email.com', 'second@email.com', 'third@email.com', 'fourth@email.com'],
800
+ },
801
+ };
802
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
803
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
804
+ expect(writtenItems).toHaveLength(5);
805
+ const emailPks = writtenItems
806
+ .filter((item) => item.pk.startsWith('email#'))
807
+ .map((item) => item.pk);
808
+ expect(emailPks).toContain(`email#${pixelId}#first@email.com`);
809
+ expect(emailPks).toContain(`email#${pixelId}#second@email.com`);
810
+ expect(emailPks).toContain(`email#${pixelId}#third@email.com`);
811
+ expect(emailPks).toContain(`email#${pixelId}#fourth@email.com`);
812
+ });
813
+ it('should skip null/undefined emails in array', async () => {
814
+ const identity = {
815
+ identityId: 'identity456',
816
+ traits: {
817
+ emails: ['valid@email.com', null, undefined, '', 'another@email.com'],
818
+ },
819
+ };
820
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
821
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
822
+ const emailItems = writtenItems.filter((item) => item.pk.startsWith('email#'));
823
+ expect(emailItems).toHaveLength(2);
824
+ expect(emailItems.map((e) => e.pk)).toContain(`email#${pixelId}#valid@email.com`);
825
+ expect(emailItems.map((e) => e.pk)).toContain(`email#${pixelId}#another@email.com`);
826
+ });
827
+ it('should handle empty emails array', async () => {
828
+ const identity = {
829
+ identityId: 'identity456',
830
+ traits: { emails: [] },
831
+ };
832
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
833
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
834
+ expect(writtenItems).toHaveLength(1);
835
+ expect(writtenItems[0].pk).toBe(`identity#${pixelId}#identity456`);
836
+ });
837
+ it('should handle email normalization (lowercase)', async () => {
838
+ const identity = {
839
+ identityId: 'identity456',
840
+ traits: {
841
+ emails: ['UPPERCASE@EMAIL.COM', 'MixedCase@Email.Com'],
842
+ },
843
+ };
844
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
845
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
846
+ const emailPks = writtenItems
847
+ .filter((item) => item.pk.startsWith('email#'))
848
+ .map((item) => item.pk);
849
+ expect(emailPks).toContain(`email#${pixelId}#uppercase@email.com`);
850
+ expect(emailPks).toContain(`email#${pixelId}#mixedcase@email.com`);
851
+ });
852
+ });
853
+ describe('null/undefined traits edge cases', () => {
854
+ const pixelId = 'pixel123';
855
+ it('should handle null traits object', async () => {
856
+ const identity = {
857
+ identityId: 'identity456',
858
+ traits: null,
859
+ };
860
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
861
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
862
+ expect(writtenItems).toHaveLength(1);
863
+ });
864
+ it('should handle undefined traits object', async () => {
865
+ const identity = {
866
+ identityId: 'identity456',
867
+ traits: undefined,
868
+ };
869
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
870
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
871
+ expect(writtenItems).toHaveLength(1);
872
+ });
873
+ it('should return cache miss for identity with null traits in lookup', async () => {
874
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
875
+ traits: null,
876
+ });
877
+ expect(result.resolvedIdentity).toBeUndefined();
878
+ expect(result.isCacheStale).toBe(true);
879
+ expect(mockedDynamoDbClient.safeGet).not.toHaveBeenCalled();
880
+ });
881
+ it('should handle identity with undefined emails in traits', async () => {
882
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
883
+ traits: { userIds: ['user123'] },
884
+ });
885
+ expect(result.resolvedIdentity).toBeUndefined();
886
+ expect(result.isCacheStale).toBe(true);
887
+ });
888
+ });
889
+ describe('backward compatibility (old full-blob format)', () => {
890
+ const pixelId = 'pixel123';
891
+ it('should read old format email record with full response blob', async () => {
892
+ const oldFormatEmailRecord = {
893
+ pk: `email#${pixelId}#test@email.com`,
894
+ pixelId,
895
+ identityId: 'discovered-id',
896
+ gsi1pk: 'discovered-id',
897
+ response: {
898
+ identityId: 'discovered-id',
899
+ traits: { emails: ['test@email.com', 'other@email.com'] },
900
+ },
901
+ updatedAt: new Date().toISOString(),
902
+ };
903
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(oldFormatEmailRecord);
904
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
905
+ traits: { emails: ['test@email.com'] },
906
+ });
907
+ expect(result.resolvedIdentity).toBeDefined();
908
+ expect(result.resolvedIdentity?.identityId).toBe('discovered-id');
909
+ expect(result.isCacheStale).toBe(true);
910
+ });
911
+ it('should read new format pointer record (no response blob)', async () => {
912
+ const newFormatPointerRecord = {
913
+ pk: `email#${pixelId}#test@email.com`,
914
+ pixelId,
915
+ identityId: 'discovered-id',
916
+ gsi1pk: 'discovered-id',
917
+ updatedAt: new Date().toISOString(),
918
+ };
919
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(newFormatPointerRecord);
920
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
921
+ traits: { emails: ['test@email.com'] },
922
+ });
923
+ expect(result.resolvedIdentity).toBeDefined();
924
+ expect(result.resolvedIdentity?.identityId).toBe('discovered-id');
925
+ expect(result.isCacheStale).toBe(true);
926
+ });
927
+ it('should trigger Neptune resolution after finding pointer record', async () => {
928
+ const lambdaArn = 'arn:aws:lambda:us-east-1:123456789:function:identity-private';
929
+ const pointerRecord = {
930
+ pk: `email#${pixelId}#test@email.com`,
931
+ pixelId,
932
+ identityId: 'discovered-id',
933
+ gsi1pk: 'discovered-id',
934
+ updatedAt: new Date().toISOString(),
935
+ };
936
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(pointerRecord);
937
+ mockInvokeFunction.mockResolvedValueOnce({
938
+ statusCode: 200,
939
+ body: JSON.stringify({
940
+ identity: {
941
+ identityId: 'discovered-id',
942
+ traits: { emails: ['test@email.com', 'resolved@email.com'] },
943
+ },
944
+ }),
945
+ });
946
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, { traits: { emails: ['test@email.com'] } }, lambdaArn);
947
+ expect(mockInvokeFunction).toHaveBeenCalledWith(lambdaArn, expect.objectContaining({
948
+ pixelId,
949
+ context: {
950
+ identity: expect.objectContaining({
951
+ identityId: 'discovered-id',
952
+ }),
953
+ },
954
+ }));
955
+ expect(result?.identityId).toBe('discovered-id');
956
+ });
957
+ });
958
+ describe('deleteIdentityCache with multiple email pointers', () => {
959
+ const pixelId = 'pixel123';
960
+ it('should delete all email pointers from both incoming and resolved identities', async () => {
961
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
962
+ { pk: `identity#${pixelId}#identity456`, pixelId },
963
+ ]);
964
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
965
+ const incomingIdentity = {
966
+ identityId: 'identity456',
967
+ traits: { emails: ['incoming1@email.com', 'incoming2@email.com'] },
968
+ };
969
+ const resolvedIdentity = {
970
+ identityId: 'identity456',
971
+ traits: { emails: ['resolved1@email.com', 'resolved2@email.com', 'resolved3@email.com'] },
972
+ };
973
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, incomingIdentity, resolvedIdentity);
974
+ expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
975
+ const batchWriteCall = mockedDynamoDbClient.batchWrite.mock.calls[0][0];
976
+ const deleteRequests = batchWriteCall.RequestItems[Object.keys(batchWriteCall.RequestItems)[0]];
977
+ const deletedPks = deleteRequests.map((req) => req.DeleteRequest.Key.pk);
978
+ expect(deletedPks).toContain(`identity#${pixelId}#identity456`);
979
+ expect(deletedPks).toContain(`email#${pixelId}#incoming1@email.com`);
980
+ expect(deletedPks).toContain(`email#${pixelId}#incoming2@email.com`);
981
+ expect(deletedPks).toContain(`email#${pixelId}#resolved1@email.com`);
982
+ expect(deletedPks).toContain(`email#${pixelId}#resolved2@email.com`);
983
+ expect(deletedPks).toContain(`email#${pixelId}#resolved3@email.com`);
984
+ });
985
+ it('should handle empty emails in delete', async () => {
986
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
987
+ { pk: `identity#${pixelId}#identity456`, pixelId },
988
+ ]);
989
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
990
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456', traits: { emails: [] } }, { identityId: 'identity456' });
991
+ expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
992
+ });
993
+ it('should handle missing traits in delete', async () => {
994
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
995
+ { pk: `identity#${pixelId}#identity456`, pixelId },
996
+ ]);
997
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
998
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' });
999
+ expect(mockedDynamoDbClient.batchWrite).toHaveBeenCalled();
1000
+ });
1001
+ it('should not delete items from other pixelIds', async () => {
1002
+ const otherPixelId = 'other-pixel';
1003
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([
1004
+ { pk: `identity#${pixelId}#identity456`, pixelId },
1005
+ { pk: `identity#${otherPixelId}#identity456`, pixelId: otherPixelId },
1006
+ ]);
1007
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
1008
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' });
1009
+ const batchWriteCall = mockedDynamoDbClient.batchWrite.mock.calls[0][0];
1010
+ const deleteRequests = batchWriteCall.RequestItems[Object.keys(batchWriteCall.RequestItems)[0]];
1011
+ const deletedPks = deleteRequests.map((req) => req.DeleteRequest.Key.pk);
1012
+ expect(deletedPks).toContain(`identity#${pixelId}#identity456`);
1013
+ expect(deletedPks).not.toContain(`identity#${otherPixelId}#identity456`);
1014
+ });
1015
+ });
1016
+ describe('GSI1 query for reverse lookups', () => {
1017
+ const pixelId = 'pixel123';
1018
+ it('should find all records by identityId via GSI1', async () => {
1019
+ const identityId = 'identity456';
1020
+ const mockResults = [
1021
+ { pk: `identity#${pixelId}#${identityId}`, pixelId, identityId },
1022
+ { pk: `email#${pixelId}#email1@test.com`, pixelId, identityId },
1023
+ { pk: `email#${pixelId}#email2@test.com`, pixelId, identityId },
1024
+ ];
1025
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue(mockResults);
1026
+ mockedDynamoDbClient.batchWrite.mockResolvedValue({ $metadata: {} });
1027
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId }, { identityId });
1028
+ expect(mockedDynamoDbClient.safeQueryByGSI).toHaveBeenCalledWith(expect.any(String), expect.any(String), 'gsi1pk', identityId);
1029
+ });
1030
+ it('should handle GSI1 query returning empty results', async () => {
1031
+ mockedDynamoDbClient.safeQueryByGSI.mockResolvedValue([]);
1032
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'unknown-id' }, { identityId: 'unknown-id' });
1033
+ expect(mockedDynamoDbClient.batchWrite).not.toHaveBeenCalled();
1034
+ });
1035
+ it('should handle GSI1 query error gracefully (fail-open)', async () => {
1036
+ mockedDynamoDbClient.safeQueryByGSI.mockRejectedValueOnce(new Error('GSI query failed'));
1037
+ await expect(identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.deleteIdentityCache(pixelId, { identityId: 'identity456' }, { identityId: 'identity456' })).resolves.toBeUndefined();
1038
+ });
1039
+ });
1040
+ describe('email pointer lookups', () => {
1041
+ const pixelId = 'pixel123';
1042
+ it('should only lookup first email (optimization)', async () => {
1043
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1044
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
1045
+ traits: { emails: ['first@email.com', 'second@email.com', 'third@email.com'] },
1046
+ });
1047
+ expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledTimes(1);
1048
+ expect(mockedDynamoDbClient.safeGet).toHaveBeenCalledWith(expect.any(String), 'pk', `email#${pixelId}#first@email.com`);
1049
+ });
1050
+ it('should handle whitespace in email during lookup', async () => {
1051
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1052
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityFromCache(pixelId, {
1053
+ traits: { emails: [' test@email.com '] },
1054
+ });
1055
+ expect(mockedDynamoDbClient.safeGet).toHaveBeenCalled();
1056
+ });
1057
+ });
1058
+ describe('fail-open behavior comprehensive', () => {
1059
+ const pixelId = 'pixel123';
1060
+ const lambdaArn = 'arn:aws:lambda:us-east-1:123456789:function:identity-private';
1061
+ it('should return incoming identity when Neptune throws (fail-open fallback)', async () => {
1062
+ const incomingIdentity = {
1063
+ identityId: 'identity456',
1064
+ traits: { emails: ['test@email.com'] },
1065
+ };
1066
+ mockedDynamoDbClient.safeGet.mockRejectedValueOnce(new Error('DynamoDB down'));
1067
+ mockInvokeFunction.mockRejectedValueOnce(new Error('Lambda down'));
1068
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
1069
+ expect(result).toEqual(incomingIdentity);
1070
+ });
1071
+ it('should continue when cache write fails after Neptune success', async () => {
1072
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1073
+ mockInvokeFunction.mockResolvedValueOnce({
1074
+ statusCode: 200,
1075
+ body: JSON.stringify({
1076
+ identity: { identityId: 'resolved-id', traits: { emails: ['test@email.com'] } },
1077
+ }),
1078
+ });
1079
+ mockedDynamoDbClient.safeBatchWrite.mockRejectedValueOnce(new Error('Write failed'));
1080
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, { traits: { emails: ['test@email.com'] } }, lambdaArn);
1081
+ expect(result?.identityId).toBe('resolved-id');
1082
+ });
1083
+ it('should return incoming identity when Neptune returns non-200', async () => {
1084
+ const incomingIdentity = {
1085
+ identityId: 'incoming-id',
1086
+ traits: { emails: ['test@email.com'] },
1087
+ };
1088
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1089
+ mockInvokeFunction.mockResolvedValueOnce({
1090
+ statusCode: 500,
1091
+ body: 'Internal Server Error',
1092
+ });
1093
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
1094
+ expect(result).toEqual(incomingIdentity);
1095
+ });
1096
+ it('should return incoming identity when Neptune returns malformed JSON (fail-open)', async () => {
1097
+ const incomingIdentity = {
1098
+ identityId: 'test-id',
1099
+ traits: { emails: ['test@email.com'] },
1100
+ };
1101
+ mockedDynamoDbClient.safeGet.mockResolvedValueOnce(null);
1102
+ mockInvokeFunction.mockResolvedValueOnce({
1103
+ statusCode: 200,
1104
+ body: 'not valid json',
1105
+ });
1106
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(pixelId, incomingIdentity, lambdaArn);
1107
+ expect(result).toEqual(incomingIdentity);
1108
+ });
1109
+ it('should return undefined only when both inputs are invalid', async () => {
1110
+ const result = await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.getIdentityWithCaching(null, null, lambdaArn);
1111
+ expect(result).toBeUndefined();
1112
+ });
1113
+ });
1114
+ describe('gsi1pk attribute on all records', () => {
1115
+ const pixelId = 'pixel123';
1116
+ it('should include gsi1pk on identity record', async () => {
1117
+ const identity = {
1118
+ identityId: 'identity456',
1119
+ traits: { emails: ['test@email.com'] },
1120
+ };
1121
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
1122
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
1123
+ const identityItem = writtenItems.find((item) => item.pk.startsWith('identity#'));
1124
+ expect(identityItem).toBeDefined();
1125
+ expect(identityItem.gsi1pk).toBe('identity456');
1126
+ });
1127
+ it('should include gsi1pk on all email pointer records', async () => {
1128
+ const identity = {
1129
+ identityId: 'identity456',
1130
+ traits: { emails: ['email1@test.com', 'email2@test.com'] },
1131
+ };
1132
+ await identity_cache_dynamodb_service_js_1.IdentityCacheDynamoDbService.updateIdentityCache(pixelId, identity);
1133
+ const writtenItems = mockedDynamoDbClient.safeBatchWrite.mock.calls[0][1];
1134
+ const emailItems = writtenItems.filter((item) => item.pk.startsWith('email#'));
1135
+ for (const emailItem of emailItems) {
1136
+ expect(emailItem.gsi1pk).toBe('identity456');
1137
+ }
1138
+ });
1139
+ });
1140
+ });
1141
1141
  //# sourceMappingURL=identity-cache-dynamodb-service.spec.js.map