@adtrackify/at-service-common 3.19.25 → 4.0.1

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 (761) 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/shared-read-db-services.spec.d.ts +1 -1
  20. package/dist/cjs/__tests__/db/shared-read-db-services.spec.js +89 -89
  21. package/dist/cjs/__tests__/db/shopify-app-installs-db-service.spec.d.ts +1 -1
  22. package/dist/cjs/__tests__/db/shopify-app-installs-db-service.spec.js +104 -104
  23. package/dist/cjs/__tests__/db/subscriptions-db-service.spec.d.ts +1 -1
  24. package/dist/cjs/__tests__/db/subscriptions-db-service.spec.js +95 -95
  25. package/dist/cjs/__tests__/db/user-accounts-db-service.spec.d.ts +1 -1
  26. package/dist/cjs/__tests__/db/user-accounts-db-service.spec.js +76 -76
  27. package/dist/cjs/__tests__/helpers/account-users-helper.spec.d.ts +1 -1
  28. package/dist/cjs/__tests__/helpers/account-users-helper.spec.js +220 -220
  29. package/dist/cjs/__tests__/helpers/acuity-helper.spec.d.ts +1 -1
  30. package/dist/cjs/__tests__/helpers/acuity-helper.spec.js +69 -69
  31. package/dist/cjs/__tests__/helpers/api-key-auth-helper.spec.d.ts +1 -1
  32. package/dist/cjs/__tests__/helpers/api-key-auth-helper.spec.js +82 -82
  33. package/dist/cjs/__tests__/identity-cache/identity-cache-db-service.spec.d.ts +1 -1
  34. package/dist/cjs/__tests__/identity-cache/identity-cache-db-service.spec.js +676 -674
  35. package/dist/cjs/__tests__/identity-cache/identity-cache-db-service.spec.js.map +1 -1
  36. package/dist/cjs/__tests__/identity-cache/identity-cache-dynamodb-service.spec.d.ts +1 -1
  37. package/dist/cjs/__tests__/identity-cache/identity-cache-dynamodb-service.spec.js +1140 -1140
  38. package/dist/cjs/__tests__/{db/products-db-service.spec.d.ts → identity-cache/identity-cache-tier-routing.spec.d.ts} +1 -1
  39. package/dist/cjs/__tests__/identity-cache/identity-cache-tier-routing.spec.js +852 -0
  40. package/dist/cjs/__tests__/identity-cache/identity-cache-tier-routing.spec.js.map +1 -0
  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 -588
  43. package/dist/cjs/__tests__/identity-cache/trait-merging-and-staleness.spec.js.map +1 -1
  44. package/dist/cjs/__tests__/{services/cost/cost-calculator-service.spec.d.ts → identity-cache/volatile-traits-optimization.spec.d.ts} +1 -1
  45. package/dist/cjs/__tests__/identity-cache/volatile-traits-optimization.spec.js +819 -0
  46. package/dist/cjs/__tests__/identity-cache/volatile-traits-optimization.spec.js.map +1 -0
  47. package/dist/cjs/__tests__/integration/sqs-bundling-roundtrip.spec.d.ts +1 -1
  48. package/dist/cjs/__tests__/integration/sqs-bundling-roundtrip.spec.js +584 -584
  49. package/dist/cjs/__tests__/libs/compress-decompress.spec.d.ts +1 -1
  50. package/dist/cjs/__tests__/libs/compress-decompress.spec.js +16 -16
  51. package/dist/cjs/__tests__/libs/contacts.spec.d.ts +1 -1
  52. package/dist/cjs/__tests__/libs/contacts.spec.js +294 -294
  53. package/dist/cjs/__tests__/libs/currency.spec.d.ts +1 -1
  54. package/dist/cjs/__tests__/libs/currency.spec.js +220 -220
  55. package/dist/cjs/__tests__/libs/dates.spec.d.ts +1 -1
  56. package/dist/cjs/__tests__/libs/dates.spec.js +130 -130
  57. package/dist/cjs/__tests__/libs/domain.spec.d.ts +1 -1
  58. package/dist/cjs/__tests__/libs/domain.spec.js +107 -107
  59. package/dist/cjs/__tests__/libs/numbers.spec.d.ts +1 -1
  60. package/dist/cjs/__tests__/libs/numbers.spec.js +261 -261
  61. package/dist/cjs/__tests__/s3-client/s3-client.spec.d.ts +1 -1
  62. package/dist/cjs/__tests__/s3-client/s3-client.spec.js +33 -33
  63. package/dist/cjs/__tests__/services/acuity-api-service.spec.d.ts +1 -1
  64. package/dist/cjs/__tests__/services/acuity-api-service.spec.js +71 -71
  65. package/dist/cjs/__tests__/services/email-verification/contact-email-verification-service.spec.d.ts +1 -1
  66. package/dist/cjs/__tests__/services/email-verification/contact-email-verification-service.spec.js +93 -93
  67. package/dist/cjs/__tests__/services/email-verification/email-verification-service.spec.d.ts +1 -1
  68. package/dist/cjs/__tests__/services/email-verification/email-verification-service.spec.js +57 -57
  69. package/dist/cjs/__tests__/shopify/shopify-graphql-transformer.spec.d.ts +1 -1
  70. package/dist/cjs/__tests__/shopify/shopify-graphql-transformer.spec.js +35 -35
  71. package/dist/cjs/__tests__/unit/libs/api-router/public-api-router.spec.d.ts +1 -1
  72. package/dist/cjs/__tests__/unit/libs/api-router/public-api-router.spec.js +181 -181
  73. package/dist/cjs/__tests__/unit/libs/api-router/route-matcher.spec.d.ts +1 -1
  74. package/dist/cjs/__tests__/unit/libs/api-router/route-matcher.spec.js +69 -69
  75. package/dist/cjs/__tests__/utils/custom-measure-formula-utils.spec.d.ts +1 -1
  76. package/dist/cjs/__tests__/utils/custom-measure-formula-utils.spec.js +139 -139
  77. package/dist/cjs/clients/generic/cognito-client.d.ts +23 -23
  78. package/dist/cjs/clients/generic/cognito-client.js +209 -209
  79. package/dist/cjs/clients/generic/dynamodb-client.d.ts +20 -20
  80. package/dist/cjs/clients/generic/dynamodb-client.js +235 -235
  81. package/dist/cjs/clients/generic/eventbridge-client.d.ts +14 -14
  82. package/dist/cjs/clients/generic/eventbridge-client.js +51 -51
  83. package/dist/cjs/clients/generic/http-client.d.ts +14 -14
  84. package/dist/cjs/clients/generic/http-client.js +61 -61
  85. package/dist/cjs/clients/generic/index.d.ts +13 -13
  86. package/dist/cjs/clients/generic/index.js +29 -29
  87. package/dist/cjs/clients/generic/lambda-invoke-client.d.ts +10 -10
  88. package/dist/cjs/clients/generic/lambda-invoke-client.js +39 -39
  89. package/dist/cjs/clients/generic/location-client.d.ts +8 -8
  90. package/dist/cjs/clients/generic/location-client.js +31 -31
  91. package/dist/cjs/clients/generic/redis-client.d.ts +33 -33
  92. package/dist/cjs/clients/generic/redis-client.js +191 -191
  93. package/dist/cjs/clients/generic/s3-client.d.ts +23 -23
  94. package/dist/cjs/clients/generic/s3-client.js +216 -216
  95. package/dist/cjs/clients/generic/singlestore-db-client.d.ts +14 -14
  96. package/dist/cjs/clients/generic/singlestore-db-client.js +67 -67
  97. package/dist/cjs/clients/generic/sqs-bundled-client.d.ts +15 -15
  98. package/dist/cjs/clients/generic/sqs-bundled-client.js +311 -311
  99. package/dist/cjs/clients/generic/sqs-bundled-client.types.d.ts +53 -53
  100. package/dist/cjs/clients/generic/sqs-bundled-client.types.js +17 -17
  101. package/dist/cjs/clients/generic/sqs-client.d.ts +53 -53
  102. package/dist/cjs/clients/generic/sqs-client.js +285 -285
  103. package/dist/cjs/clients/generic/sqs-unbundle.d.ts +32 -32
  104. package/dist/cjs/clients/generic/sqs-unbundle.js +144 -144
  105. package/dist/cjs/clients/index.d.ts +3 -3
  106. package/dist/cjs/clients/index.js +19 -19
  107. package/dist/cjs/clients/internal-api/accounts-client.d.ts +91 -91
  108. package/dist/cjs/clients/internal-api/accounts-client.js +129 -129
  109. package/dist/cjs/clients/internal-api/cache-lambda-client.d.ts +26 -26
  110. package/dist/cjs/clients/internal-api/cache-lambda-client.js +89 -89
  111. package/dist/cjs/clients/internal-api/db-management-client.d.ts +18 -18
  112. package/dist/cjs/clients/internal-api/db-management-client.js +36 -36
  113. package/dist/cjs/clients/internal-api/destinations-client.d.ts +34 -34
  114. package/dist/cjs/clients/internal-api/destinations-client.js +79 -79
  115. package/dist/cjs/clients/internal-api/event-collector-client.d.ts +20 -20
  116. package/dist/cjs/clients/internal-api/event-collector-client.js +36 -36
  117. package/dist/cjs/clients/internal-api/identity-client.d.ts +31 -31
  118. package/dist/cjs/clients/internal-api/identity-client.js +91 -91
  119. package/dist/cjs/clients/internal-api/index.d.ts +9 -9
  120. package/dist/cjs/clients/internal-api/index.js +25 -25
  121. package/dist/cjs/clients/internal-api/shopify-app-install-client.d.ts +37 -37
  122. package/dist/cjs/clients/internal-api/shopify-app-install-client.js +81 -81
  123. package/dist/cjs/clients/internal-api/subscriptions-client.d.ts +26 -26
  124. package/dist/cjs/clients/internal-api/subscriptions-client.js +77 -77
  125. package/dist/cjs/clients/internal-api/users-auth-client.d.ts +35 -35
  126. package/dist/cjs/clients/internal-api/users-auth-client.js +110 -110
  127. package/dist/cjs/clients/third-party/acuity-client.d.ts +10 -10
  128. package/dist/cjs/clients/third-party/acuity-client.js +40 -40
  129. package/dist/cjs/clients/third-party/emailable-client.d.ts +7 -7
  130. package/dist/cjs/clients/third-party/emailable-client.js +25 -25
  131. package/dist/cjs/clients/third-party/exchange-rate-api-client.d.ts +17 -17
  132. package/dist/cjs/clients/third-party/exchange-rate-api-client.js +19 -19
  133. package/dist/cjs/clients/third-party/index.d.ts +5 -5
  134. package/dist/cjs/clients/third-party/index.js +21 -21
  135. package/dist/cjs/clients/third-party/loops-client.d.ts +10 -10
  136. package/dist/cjs/clients/third-party/loops-client.js +30 -30
  137. package/dist/cjs/clients/third-party/shopify/graphql-order-queries.d.ts +25 -25
  138. package/dist/cjs/clients/third-party/shopify/graphql-order-queries.js +4 -4
  139. package/dist/cjs/clients/third-party/shopify/graphql-product-queries.d.ts +2 -2
  140. package/dist/cjs/clients/third-party/shopify/graphql-product-queries.js +5 -5
  141. package/dist/cjs/clients/third-party/shopify/shopify-graphql-client.d.ts +10 -10
  142. package/dist/cjs/clients/third-party/shopify/shopify-graphql-client.js +161 -161
  143. package/dist/cjs/clients/third-party/shopify-client.d.ts +29 -29
  144. package/dist/cjs/clients/third-party/shopify-client.js +146 -146
  145. package/dist/cjs/constants/index.d.ts +1 -1
  146. package/dist/cjs/constants/index.js +17 -17
  147. package/dist/cjs/constants/sqs.d.ts +20 -20
  148. package/dist/cjs/constants/sqs.js +26 -26
  149. package/dist/cjs/helpers/account-users-helper.d.ts +2 -2
  150. package/dist/cjs/helpers/account-users-helper.js +22 -22
  151. package/dist/cjs/helpers/acuity-helper.d.ts +4 -4
  152. package/dist/cjs/helpers/acuity-helper.js +56 -56
  153. package/dist/cjs/helpers/api-key-auth-helper.d.ts +9 -9
  154. package/dist/cjs/helpers/api-key-auth-helper.js +40 -40
  155. package/dist/cjs/helpers/api-key-authorizer-helper.d.ts +36 -36
  156. package/dist/cjs/helpers/api-key-authorizer-helper.js +87 -87
  157. package/dist/cjs/helpers/identity-cache-helper.d.ts +30 -21
  158. package/dist/cjs/helpers/identity-cache-helper.js +253 -157
  159. package/dist/cjs/helpers/identity-cache-helper.js.map +1 -1
  160. package/dist/cjs/helpers/index.d.ts +10 -10
  161. package/dist/cjs/helpers/index.js +26 -26
  162. package/dist/cjs/helpers/input-validation-helper.d.ts +3 -3
  163. package/dist/cjs/helpers/input-validation-helper.js +22 -22
  164. package/dist/cjs/helpers/logging-helper.d.ts +16 -16
  165. package/dist/cjs/helpers/logging-helper.js +84 -84
  166. package/dist/cjs/helpers/response-helper.d.ts +18 -18
  167. package/dist/cjs/helpers/response-helper.js +43 -43
  168. package/dist/cjs/helpers/shopify-helper.d.ts +9 -9
  169. package/dist/cjs/helpers/shopify-helper.js +26 -26
  170. package/dist/cjs/helpers/sqs-utils.d.ts +6 -6
  171. package/dist/cjs/helpers/sqs-utils.js +14 -14
  172. package/dist/cjs/index.d.ts +7 -7
  173. package/dist/cjs/index.js +23 -23
  174. package/dist/cjs/libs/api-router/index.d.ts +2 -2
  175. package/dist/cjs/libs/api-router/index.js +18 -18
  176. package/dist/cjs/libs/api-router/public-api-router.d.ts +3 -3
  177. package/dist/cjs/libs/api-router/public-api-router.js +36 -36
  178. package/dist/cjs/libs/api-router/route-matcher.d.ts +21 -21
  179. package/dist/cjs/libs/api-router/route-matcher.js +36 -36
  180. package/dist/cjs/libs/click-id-parser.d.ts +23 -23
  181. package/dist/cjs/libs/click-id-parser.js +49 -49
  182. package/dist/cjs/libs/compression.d.ts +2 -2
  183. package/dist/cjs/libs/compression.js +33 -33
  184. package/dist/cjs/libs/contacts.d.ts +7 -7
  185. package/dist/cjs/libs/contacts.js +152 -152
  186. package/dist/cjs/libs/cookie.d.ts +17 -17
  187. package/dist/cjs/libs/cookie.js +76 -76
  188. package/dist/cjs/libs/crypto.d.ts +4 -4
  189. package/dist/cjs/libs/crypto.js +25 -25
  190. package/dist/cjs/libs/csv.d.ts +2 -2
  191. package/dist/cjs/libs/csv.js +35 -35
  192. package/dist/cjs/libs/currency.d.ts +1 -1
  193. package/dist/cjs/libs/currency.js +29 -29
  194. package/dist/cjs/libs/dates.d.ts +12 -12
  195. package/dist/cjs/libs/dates.js +96 -96
  196. package/dist/cjs/libs/domain.d.ts +2 -2
  197. package/dist/cjs/libs/domain.js +38 -38
  198. package/dist/cjs/libs/emails.d.ts +8 -8
  199. package/dist/cjs/libs/emails.js +154 -154
  200. package/dist/cjs/libs/http-error.d.ts +21 -21
  201. package/dist/cjs/libs/http-error.js +63 -63
  202. package/dist/cjs/libs/http-status-codes.d.ts +58 -58
  203. package/dist/cjs/libs/http-status-codes.js +62 -62
  204. package/dist/cjs/libs/index.d.ts +19 -19
  205. package/dist/cjs/libs/index.js +35 -35
  206. package/dist/cjs/libs/numbers.d.ts +1 -1
  207. package/dist/cjs/libs/numbers.js +15 -15
  208. package/dist/cjs/libs/referrer-parser/index.d.ts +2 -2
  209. package/dist/cjs/libs/referrer-parser/index.js +18 -18
  210. package/dist/cjs/libs/referrer-parser/referrer-data.d.ts +9 -9
  211. package/dist/cjs/libs/referrer-parser/referrer-data.js +3307 -3307
  212. package/dist/cjs/libs/referrer-parser/referrer-parser-util.d.ts +20 -20
  213. package/dist/cjs/libs/referrer-parser/referrer-parser-util.js +131 -131
  214. package/dist/cjs/libs/strings.d.ts +3 -3
  215. package/dist/cjs/libs/strings.js +46 -46
  216. package/dist/cjs/libs/traits.d.ts +6 -6
  217. package/dist/cjs/libs/traits.js +65 -65
  218. package/dist/cjs/libs/url.d.ts +1 -1
  219. package/dist/cjs/libs/url.js +13 -13
  220. package/dist/cjs/services/acuity-api-service.d.ts +9 -9
  221. package/dist/cjs/services/acuity-api-service.js +73 -73
  222. package/dist/cjs/services/cache/generic-cached-object.d.ts +5 -5
  223. package/dist/cjs/services/cache/generic-cached-object.js +2 -2
  224. package/dist/cjs/services/cache/index.d.ts +1 -1
  225. package/dist/cjs/services/cache/index.js +17 -17
  226. package/dist/cjs/services/cache/product-cache-service.d.ts +21 -21
  227. package/dist/cjs/services/cache/product-cache-service.js +76 -76
  228. package/dist/cjs/services/currency-exchange-rate-lookup-service.d.ts +11 -12
  229. package/dist/cjs/services/currency-exchange-rate-lookup-service.js +66 -94
  230. package/dist/cjs/services/currency-exchange-rate-lookup-service.js.map +1 -1
  231. package/dist/cjs/services/db/accounts-db-service.d.ts +9 -9
  232. package/dist/cjs/services/db/accounts-db-service.js +33 -33
  233. package/dist/cjs/services/db/api-keys-db-service.d.ts +10 -10
  234. package/dist/cjs/services/db/api-keys-db-service.js +36 -36
  235. package/dist/cjs/services/db/contact-enrichments-db-service.d.ts +15 -15
  236. package/dist/cjs/services/db/contact-enrichments-db-service.js +94 -94
  237. package/dist/cjs/services/db/currency-exchange-rates-db-service.d.ts +21 -21
  238. package/dist/cjs/services/db/currency-exchange-rates-db-service.js +39 -39
  239. package/dist/cjs/services/db/custom-measures-db-service.d.ts +14 -14
  240. package/dist/cjs/services/db/custom-measures-db-service.js +48 -48
  241. package/dist/cjs/services/db/destinations-db-service.d.ts +13 -13
  242. package/dist/cjs/services/db/destinations-db-service.js +74 -74
  243. package/dist/cjs/services/db/identity-cache-db-service.d.ts +28 -28
  244. package/dist/cjs/services/db/identity-cache-db-service.js +320 -320
  245. package/dist/cjs/services/db/identity-cache-dynamodb-service.d.ts +44 -38
  246. package/dist/cjs/services/db/identity-cache-dynamodb-service.js +734 -439
  247. package/dist/cjs/services/db/identity-cache-dynamodb-service.js.map +1 -1
  248. package/dist/cjs/services/db/index.d.ts +17 -19
  249. package/dist/cjs/services/db/index.js +33 -35
  250. package/dist/cjs/services/db/index.js.map +1 -1
  251. package/dist/cjs/services/db/log-events-db-service.d.ts +11 -11
  252. package/dist/cjs/services/db/log-events-db-service.js +181 -181
  253. package/dist/cjs/services/db/pixels-db-service.d.ts +8 -8
  254. package/dist/cjs/services/db/pixels-db-service.js +35 -35
  255. package/dist/cjs/services/db/purchasable-contacts-db-service.d.ts +9 -9
  256. package/dist/cjs/services/db/purchasable-contacts-db-service.js +43 -43
  257. package/dist/cjs/services/db/purchased-contacts/index.d.ts +2 -2
  258. package/dist/cjs/services/db/purchased-contacts/index.js +18 -18
  259. package/dist/cjs/services/db/purchased-contacts/purchased-contacts-db-service.d.ts +18 -18
  260. package/dist/cjs/services/db/purchased-contacts/purchased-contacts-db-service.js +152 -152
  261. package/dist/cjs/services/db/purchased-contacts/types.d.ts +11 -11
  262. package/dist/cjs/services/db/purchased-contacts/types.js +2 -2
  263. package/dist/cjs/services/db/shopify-app-installs-db-service.d.ts +10 -10
  264. package/dist/cjs/services/db/shopify-app-installs-db-service.js +52 -52
  265. package/dist/cjs/services/db/shopify-products-cache-db-service.d.ts +16 -16
  266. package/dist/cjs/services/db/shopify-products-cache-db-service.js +73 -73
  267. package/dist/cjs/services/db/subscriptions-db-service.d.ts +11 -11
  268. package/dist/cjs/services/db/subscriptions-db-service.js +38 -38
  269. package/dist/cjs/services/db/tracking-events-db-service.d.ts +21 -21
  270. package/dist/cjs/services/db/tracking-events-db-service.js +188 -188
  271. package/dist/cjs/services/db/user-accounts-db-service.d.ts +7 -7
  272. package/dist/cjs/services/db/user-accounts-db-service.js +17 -17
  273. package/dist/cjs/services/email-verification/contact-email-verification-service.d.ts +7 -7
  274. package/dist/cjs/services/email-verification/contact-email-verification-service.js +101 -101
  275. package/dist/cjs/services/email-verification/email-verification-service.d.ts +19 -19
  276. package/dist/cjs/services/email-verification/email-verification-service.js +131 -131
  277. package/dist/cjs/services/email-verification/index.d.ts +2 -2
  278. package/dist/cjs/services/email-verification/index.js +18 -18
  279. package/dist/cjs/services/eventbridge-integration-service.d.ts +9 -9
  280. package/dist/cjs/services/eventbridge-integration-service.js +28 -28
  281. package/dist/cjs/services/events/index.d.ts +3 -3
  282. package/dist/cjs/services/events/index.js +19 -19
  283. package/dist/cjs/services/events/log-event-service.d.ts +19 -19
  284. package/dist/cjs/services/events/log-event-service.js +77 -77
  285. package/dist/cjs/services/events/metric-event-service.d.ts +9 -9
  286. package/dist/cjs/services/events/metric-event-service.js +49 -49
  287. package/dist/cjs/services/events/tracking-event-sqs-service.d.ts +8 -8
  288. package/dist/cjs/services/events/tracking-event-sqs-service.js +34 -34
  289. package/dist/cjs/services/generic-cache-service.d.ts +7 -7
  290. package/dist/cjs/services/generic-cache-service.js +33 -33
  291. package/dist/cjs/services/index.d.ts +10 -11
  292. package/dist/cjs/services/index.js +26 -27
  293. package/dist/cjs/services/index.js.map +1 -1
  294. package/dist/cjs/services/ipdata-lookup-service.d.ts +20 -20
  295. package/dist/cjs/services/ipdata-lookup-service.js +112 -112
  296. package/dist/cjs/services/shopify/index.d.ts +2 -2
  297. package/dist/cjs/services/shopify/index.js +18 -18
  298. package/dist/cjs/services/shopify/products/index.d.ts +1 -1
  299. package/dist/cjs/services/shopify/products/index.js +17 -17
  300. package/dist/cjs/services/shopify/products/shopify-products-serviceV2.d.ts +17 -17
  301. package/dist/cjs/services/shopify/products/shopify-products-serviceV2.js +112 -112
  302. package/dist/cjs/services/shopify/shopify-graphql-transformer.d.ts +8 -8
  303. package/dist/cjs/services/shopify/shopify-graphql-transformer.js +141 -141
  304. package/dist/cjs/types/acuity-types.d.ts +74 -74
  305. package/dist/cjs/types/acuity-types.js +2 -2
  306. package/dist/cjs/types/api-response.d.ts +6 -6
  307. package/dist/cjs/types/api-response.js +2 -2
  308. package/dist/cjs/types/index.d.ts +4 -4
  309. package/dist/cjs/types/index.js +33 -33
  310. package/dist/cjs/types/internal-events/event-detail-types.d.ts +20 -20
  311. package/dist/cjs/types/internal-events/event-detail-types.js +27 -27
  312. package/dist/cjs/types/internal-events/index.d.ts +1 -1
  313. package/dist/cjs/types/internal-events/index.js +17 -17
  314. package/dist/cjs/types/shopify-graphql-types/admin.generated.d.ts +123 -123
  315. package/dist/cjs/types/shopify-graphql-types/admin.generated.js +2 -2
  316. package/dist/cjs/types/shopify-graphql-types/admin.types.d.ts +26289 -26289
  317. package/dist/cjs/types/shopify-graphql-types/admin.types.js +5311 -5311
  318. package/dist/cjs/types/shopify-graphql-types/index.d.ts +2 -2
  319. package/dist/cjs/types/shopify-graphql-types/index.js +18 -18
  320. package/dist/cjs/types/shopify-rest-types.d.ts +767 -767
  321. package/dist/cjs/types/shopify-rest-types.js +2 -2
  322. package/dist/cjs/utils/compression.d.ts +36 -36
  323. package/dist/cjs/utils/compression.js +198 -198
  324. package/dist/cjs/utils/custom-measure-formula-utils.d.ts +6 -6
  325. package/dist/cjs/utils/custom-measure-formula-utils.js +209 -209
  326. package/dist/cjs/utils/index.d.ts +4 -4
  327. package/dist/cjs/utils/index.js +20 -20
  328. package/dist/cjs/utils/retry-envelope.d.ts +12 -12
  329. package/dist/cjs/utils/retry-envelope.js +28 -28
  330. package/dist/cjs/utils/size.d.ts +2 -2
  331. package/dist/cjs/utils/size.js +49 -49
  332. package/dist/esm/__tests__/clients/acuity-client.spec.d.ts +1 -1
  333. package/dist/esm/__tests__/clients/acuity-client.spec.js +41 -41
  334. package/dist/esm/__tests__/clients/cross-platform-compression.spec.d.ts +1 -1
  335. package/dist/esm/__tests__/clients/cross-platform-compression.spec.js +329 -329
  336. package/dist/esm/__tests__/clients/dynamodb-client.spec.d.ts +1 -1
  337. package/dist/esm/__tests__/clients/dynamodb-client.spec.js +192 -192
  338. package/dist/esm/__tests__/clients/sqs-bundled-client.spec.d.ts +1 -1
  339. package/dist/esm/__tests__/clients/sqs-bundled-client.spec.js +906 -906
  340. package/dist/esm/__tests__/clients/sqs-bundling-contracts.spec.d.ts +1 -1
  341. package/dist/esm/__tests__/clients/sqs-bundling-contracts.spec.js +538 -538
  342. package/dist/esm/__tests__/clients/sqs-client.spec.d.ts +1 -1
  343. package/dist/esm/__tests__/clients/sqs-client.spec.js +189 -189
  344. package/dist/esm/__tests__/clients/sqs-unbundle.spec.d.ts +1 -1
  345. package/dist/esm/__tests__/clients/sqs-unbundle.spec.js +1355 -1355
  346. package/dist/esm/__tests__/db/contact-enrichments-db-service.spec.d.ts +1 -1
  347. package/dist/esm/__tests__/db/contact-enrichments-db-service.spec.js +66 -66
  348. package/dist/esm/__tests__/db/destinations-db-service.spec.d.ts +1 -1
  349. package/dist/esm/__tests__/db/destinations-db-service.spec.js +123 -123
  350. package/dist/esm/__tests__/db/shared-read-db-services.spec.d.ts +1 -1
  351. package/dist/esm/__tests__/db/shared-read-db-services.spec.js +87 -87
  352. package/dist/esm/__tests__/db/shopify-app-installs-db-service.spec.d.ts +1 -1
  353. package/dist/esm/__tests__/db/shopify-app-installs-db-service.spec.js +102 -102
  354. package/dist/esm/__tests__/db/subscriptions-db-service.spec.d.ts +1 -1
  355. package/dist/esm/__tests__/db/subscriptions-db-service.spec.js +93 -93
  356. package/dist/esm/__tests__/db/user-accounts-db-service.spec.d.ts +1 -1
  357. package/dist/esm/__tests__/db/user-accounts-db-service.spec.js +74 -74
  358. package/dist/esm/__tests__/helpers/account-users-helper.spec.d.ts +1 -1
  359. package/dist/esm/__tests__/helpers/account-users-helper.spec.js +218 -218
  360. package/dist/esm/__tests__/helpers/acuity-helper.spec.d.ts +1 -1
  361. package/dist/esm/__tests__/helpers/acuity-helper.spec.js +67 -67
  362. package/dist/esm/__tests__/helpers/api-key-auth-helper.spec.d.ts +1 -1
  363. package/dist/esm/__tests__/helpers/api-key-auth-helper.spec.js +80 -80
  364. package/dist/esm/__tests__/identity-cache/identity-cache-db-service.spec.d.ts +1 -1
  365. package/dist/esm/__tests__/identity-cache/identity-cache-db-service.spec.js +674 -672
  366. package/dist/esm/__tests__/identity-cache/identity-cache-db-service.spec.js.map +1 -1
  367. package/dist/esm/__tests__/identity-cache/identity-cache-dynamodb-service.spec.d.ts +1 -1
  368. package/dist/esm/__tests__/identity-cache/identity-cache-dynamodb-service.spec.js +1138 -1138
  369. package/dist/{cjs/__tests__/services/cost/cost-currency-service.spec.d.ts → esm/__tests__/identity-cache/identity-cache-tier-routing.spec.d.ts} +1 -1
  370. package/dist/esm/__tests__/identity-cache/identity-cache-tier-routing.spec.js +850 -0
  371. package/dist/esm/__tests__/identity-cache/identity-cache-tier-routing.spec.js.map +1 -0
  372. package/dist/esm/__tests__/identity-cache/trait-merging-and-staleness.spec.d.ts +1 -1
  373. package/dist/esm/__tests__/identity-cache/trait-merging-and-staleness.spec.js +1058 -586
  374. package/dist/esm/__tests__/identity-cache/trait-merging-and-staleness.spec.js.map +1 -1
  375. package/dist/{cjs/__tests__/services/cost/cost-calculation-types.spec.d.ts → esm/__tests__/identity-cache/volatile-traits-optimization.spec.d.ts} +1 -1
  376. package/dist/esm/__tests__/identity-cache/volatile-traits-optimization.spec.js +817 -0
  377. package/dist/esm/__tests__/identity-cache/volatile-traits-optimization.spec.js.map +1 -0
  378. package/dist/esm/__tests__/integration/sqs-bundling-roundtrip.spec.d.ts +1 -1
  379. package/dist/esm/__tests__/integration/sqs-bundling-roundtrip.spec.js +582 -582
  380. package/dist/esm/__tests__/libs/compress-decompress.spec.d.ts +1 -1
  381. package/dist/esm/__tests__/libs/compress-decompress.spec.js +14 -14
  382. package/dist/esm/__tests__/libs/contacts.spec.d.ts +1 -1
  383. package/dist/esm/__tests__/libs/contacts.spec.js +292 -292
  384. package/dist/esm/__tests__/libs/currency.spec.d.ts +1 -1
  385. package/dist/esm/__tests__/libs/currency.spec.js +218 -218
  386. package/dist/esm/__tests__/libs/dates.spec.d.ts +1 -1
  387. package/dist/esm/__tests__/libs/dates.spec.js +128 -128
  388. package/dist/esm/__tests__/libs/domain.spec.d.ts +1 -1
  389. package/dist/esm/__tests__/libs/domain.spec.js +105 -105
  390. package/dist/esm/__tests__/libs/numbers.spec.d.ts +1 -1
  391. package/dist/esm/__tests__/libs/numbers.spec.js +259 -259
  392. package/dist/esm/__tests__/s3-client/s3-client.spec.d.ts +1 -1
  393. package/dist/esm/__tests__/s3-client/s3-client.spec.js +31 -31
  394. package/dist/esm/__tests__/services/acuity-api-service.spec.d.ts +1 -1
  395. package/dist/esm/__tests__/services/acuity-api-service.spec.js +69 -69
  396. package/dist/esm/__tests__/services/email-verification/contact-email-verification-service.spec.d.ts +1 -1
  397. package/dist/esm/__tests__/services/email-verification/contact-email-verification-service.spec.js +91 -91
  398. package/dist/esm/__tests__/services/email-verification/email-verification-service.spec.d.ts +1 -1
  399. package/dist/esm/__tests__/services/email-verification/email-verification-service.spec.js +55 -55
  400. package/dist/esm/__tests__/shopify/shopify-graphql-transformer.spec.d.ts +1 -1
  401. package/dist/esm/__tests__/shopify/shopify-graphql-transformer.spec.js +33 -33
  402. package/dist/esm/__tests__/unit/libs/api-router/public-api-router.spec.d.ts +1 -1
  403. package/dist/esm/__tests__/unit/libs/api-router/public-api-router.spec.js +156 -156
  404. package/dist/esm/__tests__/unit/libs/api-router/route-matcher.spec.d.ts +1 -1
  405. package/dist/esm/__tests__/unit/libs/api-router/route-matcher.spec.js +67 -67
  406. package/dist/esm/__tests__/utils/custom-measure-formula-utils.spec.d.ts +1 -1
  407. package/dist/esm/__tests__/utils/custom-measure-formula-utils.spec.js +137 -137
  408. package/dist/esm/clients/generic/cognito-client.d.ts +23 -23
  409. package/dist/esm/clients/generic/cognito-client.js +204 -204
  410. package/dist/esm/clients/generic/dynamodb-client.d.ts +20 -20
  411. package/dist/esm/clients/generic/dynamodb-client.js +231 -231
  412. package/dist/esm/clients/generic/eventbridge-client.d.ts +14 -14
  413. package/dist/esm/clients/generic/eventbridge-client.js +47 -47
  414. package/dist/esm/clients/generic/http-client.d.ts +14 -14
  415. package/dist/esm/clients/generic/http-client.js +53 -53
  416. package/dist/esm/clients/generic/index.d.ts +13 -13
  417. package/dist/esm/clients/generic/index.js +13 -13
  418. package/dist/esm/clients/generic/lambda-invoke-client.d.ts +10 -10
  419. package/dist/esm/clients/generic/lambda-invoke-client.js +35 -35
  420. package/dist/esm/clients/generic/location-client.d.ts +8 -8
  421. package/dist/esm/clients/generic/location-client.js +27 -27
  422. package/dist/esm/clients/generic/redis-client.d.ts +33 -33
  423. package/dist/esm/clients/generic/redis-client.js +184 -184
  424. package/dist/esm/clients/generic/s3-client.d.ts +23 -23
  425. package/dist/esm/clients/generic/s3-client.js +209 -209
  426. package/dist/esm/clients/generic/singlestore-db-client.d.ts +14 -14
  427. package/dist/esm/clients/generic/singlestore-db-client.js +40 -40
  428. package/dist/esm/clients/generic/sqs-bundled-client.d.ts +15 -15
  429. package/dist/esm/clients/generic/sqs-bundled-client.js +307 -307
  430. package/dist/esm/clients/generic/sqs-bundled-client.types.d.ts +53 -53
  431. package/dist/esm/clients/generic/sqs-bundled-client.types.js +14 -14
  432. package/dist/esm/clients/generic/sqs-client.d.ts +53 -53
  433. package/dist/esm/clients/generic/sqs-client.js +281 -281
  434. package/dist/esm/clients/generic/sqs-unbundle.d.ts +32 -32
  435. package/dist/esm/clients/generic/sqs-unbundle.js +137 -137
  436. package/dist/esm/clients/index.d.ts +3 -3
  437. package/dist/esm/clients/index.js +3 -3
  438. package/dist/esm/clients/internal-api/accounts-client.d.ts +91 -91
  439. package/dist/esm/clients/internal-api/accounts-client.js +125 -125
  440. package/dist/esm/clients/internal-api/cache-lambda-client.d.ts +26 -26
  441. package/dist/esm/clients/internal-api/cache-lambda-client.js +85 -85
  442. package/dist/esm/clients/internal-api/db-management-client.d.ts +18 -18
  443. package/dist/esm/clients/internal-api/db-management-client.js +32 -32
  444. package/dist/esm/clients/internal-api/destinations-client.d.ts +34 -34
  445. package/dist/esm/clients/internal-api/destinations-client.js +75 -75
  446. package/dist/esm/clients/internal-api/event-collector-client.d.ts +20 -20
  447. package/dist/esm/clients/internal-api/event-collector-client.js +32 -32
  448. package/dist/esm/clients/internal-api/identity-client.d.ts +31 -31
  449. package/dist/esm/clients/internal-api/identity-client.js +87 -87
  450. package/dist/esm/clients/internal-api/index.d.ts +9 -9
  451. package/dist/esm/clients/internal-api/index.js +9 -9
  452. package/dist/esm/clients/internal-api/shopify-app-install-client.d.ts +37 -37
  453. package/dist/esm/clients/internal-api/shopify-app-install-client.js +77 -77
  454. package/dist/esm/clients/internal-api/subscriptions-client.d.ts +26 -26
  455. package/dist/esm/clients/internal-api/subscriptions-client.js +73 -73
  456. package/dist/esm/clients/internal-api/users-auth-client.d.ts +35 -35
  457. package/dist/esm/clients/internal-api/users-auth-client.js +106 -106
  458. package/dist/esm/clients/third-party/acuity-client.d.ts +10 -10
  459. package/dist/esm/clients/third-party/acuity-client.js +36 -36
  460. package/dist/esm/clients/third-party/emailable-client.d.ts +7 -7
  461. package/dist/esm/clients/third-party/emailable-client.js +21 -21
  462. package/dist/esm/clients/third-party/exchange-rate-api-client.d.ts +17 -17
  463. package/dist/esm/clients/third-party/exchange-rate-api-client.js +15 -15
  464. package/dist/esm/clients/third-party/index.d.ts +5 -5
  465. package/dist/esm/clients/third-party/index.js +5 -5
  466. package/dist/esm/clients/third-party/loops-client.d.ts +10 -10
  467. package/dist/esm/clients/third-party/loops-client.js +26 -26
  468. package/dist/esm/clients/third-party/shopify/graphql-order-queries.d.ts +25 -25
  469. package/dist/esm/clients/third-party/shopify/graphql-order-queries.js +1 -1
  470. package/dist/esm/clients/third-party/shopify/graphql-product-queries.d.ts +2 -2
  471. package/dist/esm/clients/third-party/shopify/graphql-product-queries.js +2 -2
  472. package/dist/esm/clients/third-party/shopify/shopify-graphql-client.d.ts +10 -10
  473. package/dist/esm/clients/third-party/shopify/shopify-graphql-client.js +157 -157
  474. package/dist/esm/clients/third-party/shopify-client.d.ts +29 -29
  475. package/dist/esm/clients/third-party/shopify-client.js +142 -142
  476. package/dist/esm/constants/index.d.ts +1 -1
  477. package/dist/esm/constants/index.js +1 -1
  478. package/dist/esm/constants/sqs.d.ts +20 -20
  479. package/dist/esm/constants/sqs.js +22 -22
  480. package/dist/esm/helpers/account-users-helper.d.ts +2 -2
  481. package/dist/esm/helpers/account-users-helper.js +18 -18
  482. package/dist/esm/helpers/acuity-helper.d.ts +4 -4
  483. package/dist/esm/helpers/acuity-helper.js +51 -51
  484. package/dist/esm/helpers/api-key-auth-helper.d.ts +9 -9
  485. package/dist/esm/helpers/api-key-auth-helper.js +35 -35
  486. package/dist/esm/helpers/api-key-authorizer-helper.d.ts +36 -36
  487. package/dist/esm/helpers/api-key-authorizer-helper.js +83 -83
  488. package/dist/esm/helpers/identity-cache-helper.d.ts +30 -21
  489. package/dist/esm/helpers/identity-cache-helper.js +248 -152
  490. package/dist/esm/helpers/identity-cache-helper.js.map +1 -1
  491. package/dist/esm/helpers/index.d.ts +10 -10
  492. package/dist/esm/helpers/index.js +10 -10
  493. package/dist/esm/helpers/input-validation-helper.d.ts +3 -3
  494. package/dist/esm/helpers/input-validation-helper.js +18 -18
  495. package/dist/esm/helpers/logging-helper.d.ts +16 -16
  496. package/dist/esm/helpers/logging-helper.js +56 -56
  497. package/dist/esm/helpers/response-helper.d.ts +18 -18
  498. package/dist/esm/helpers/response-helper.js +37 -37
  499. package/dist/esm/helpers/shopify-helper.d.ts +9 -9
  500. package/dist/esm/helpers/shopify-helper.js +21 -21
  501. package/dist/esm/helpers/sqs-utils.d.ts +6 -6
  502. package/dist/esm/helpers/sqs-utils.js +9 -9
  503. package/dist/esm/index.d.ts +7 -7
  504. package/dist/esm/index.js +7 -7
  505. package/dist/esm/libs/api-router/index.d.ts +2 -2
  506. package/dist/esm/libs/api-router/index.js +2 -2
  507. package/dist/esm/libs/api-router/public-api-router.d.ts +3 -3
  508. package/dist/esm/libs/api-router/public-api-router.js +32 -32
  509. package/dist/esm/libs/api-router/route-matcher.d.ts +21 -21
  510. package/dist/esm/libs/api-router/route-matcher.js +30 -30
  511. package/dist/esm/libs/click-id-parser.d.ts +23 -23
  512. package/dist/esm/libs/click-id-parser.js +45 -45
  513. package/dist/esm/libs/compression.d.ts +2 -2
  514. package/dist/esm/libs/compression.js +25 -25
  515. package/dist/esm/libs/contacts.d.ts +7 -7
  516. package/dist/esm/libs/contacts.js +143 -143
  517. package/dist/esm/libs/cookie.d.ts +17 -17
  518. package/dist/esm/libs/cookie.js +70 -70
  519. package/dist/esm/libs/crypto.d.ts +4 -4
  520. package/dist/esm/libs/crypto.js +15 -15
  521. package/dist/esm/libs/csv.d.ts +2 -2
  522. package/dist/esm/libs/csv.js +30 -30
  523. package/dist/esm/libs/currency.d.ts +1 -1
  524. package/dist/esm/libs/currency.js +22 -22
  525. package/dist/esm/libs/dates.d.ts +12 -12
  526. package/dist/esm/libs/dates.js +83 -83
  527. package/dist/esm/libs/domain.d.ts +2 -2
  528. package/dist/esm/libs/domain.js +33 -33
  529. package/dist/esm/libs/emails.d.ts +8 -8
  530. package/dist/esm/libs/emails.js +146 -146
  531. package/dist/esm/libs/http-error.d.ts +21 -21
  532. package/dist/esm/libs/http-error.js +59 -59
  533. package/dist/esm/libs/http-status-codes.d.ts +58 -58
  534. package/dist/esm/libs/http-status-codes.js +59 -59
  535. package/dist/esm/libs/index.d.ts +19 -19
  536. package/dist/esm/libs/index.js +19 -19
  537. package/dist/esm/libs/numbers.d.ts +1 -1
  538. package/dist/esm/libs/numbers.js +11 -11
  539. package/dist/esm/libs/referrer-parser/index.d.ts +2 -2
  540. package/dist/esm/libs/referrer-parser/index.js +2 -2
  541. package/dist/esm/libs/referrer-parser/referrer-data.d.ts +9 -9
  542. package/dist/esm/libs/referrer-parser/referrer-data.js +3304 -3304
  543. package/dist/esm/libs/referrer-parser/referrer-parser-util.d.ts +20 -20
  544. package/dist/esm/libs/referrer-parser/referrer-parser-util.js +124 -124
  545. package/dist/esm/libs/strings.d.ts +3 -3
  546. package/dist/esm/libs/strings.js +40 -40
  547. package/dist/esm/libs/traits.d.ts +6 -6
  548. package/dist/esm/libs/traits.js +54 -54
  549. package/dist/esm/libs/url.d.ts +1 -1
  550. package/dist/esm/libs/url.js +9 -9
  551. package/dist/esm/services/acuity-api-service.d.ts +9 -9
  552. package/dist/esm/services/acuity-api-service.js +69 -69
  553. package/dist/esm/services/cache/generic-cached-object.d.ts +5 -5
  554. package/dist/esm/services/cache/generic-cached-object.js +1 -1
  555. package/dist/esm/services/cache/index.d.ts +1 -1
  556. package/dist/esm/services/cache/index.js +1 -1
  557. package/dist/esm/services/cache/product-cache-service.d.ts +21 -21
  558. package/dist/esm/services/cache/product-cache-service.js +68 -68
  559. package/dist/esm/services/currency-exchange-rate-lookup-service.d.ts +11 -12
  560. package/dist/esm/services/currency-exchange-rate-lookup-service.js +62 -90
  561. package/dist/esm/services/currency-exchange-rate-lookup-service.js.map +1 -1
  562. package/dist/esm/services/db/accounts-db-service.d.ts +9 -9
  563. package/dist/esm/services/db/accounts-db-service.js +29 -29
  564. package/dist/esm/services/db/api-keys-db-service.d.ts +10 -10
  565. package/dist/esm/services/db/api-keys-db-service.js +32 -32
  566. package/dist/esm/services/db/contact-enrichments-db-service.d.ts +15 -15
  567. package/dist/esm/services/db/contact-enrichments-db-service.js +90 -90
  568. package/dist/esm/services/db/currency-exchange-rates-db-service.d.ts +21 -21
  569. package/dist/esm/services/db/currency-exchange-rates-db-service.js +35 -35
  570. package/dist/esm/services/db/custom-measures-db-service.d.ts +14 -14
  571. package/dist/esm/services/db/custom-measures-db-service.js +44 -44
  572. package/dist/esm/services/db/destinations-db-service.d.ts +13 -13
  573. package/dist/esm/services/db/destinations-db-service.js +70 -70
  574. package/dist/esm/services/db/identity-cache-db-service.d.ts +28 -28
  575. package/dist/esm/services/db/identity-cache-db-service.js +313 -313
  576. package/dist/esm/services/db/identity-cache-dynamodb-service.d.ts +44 -38
  577. package/dist/esm/services/db/identity-cache-dynamodb-service.js +727 -432
  578. package/dist/esm/services/db/identity-cache-dynamodb-service.js.map +1 -1
  579. package/dist/esm/services/db/index.d.ts +17 -19
  580. package/dist/esm/services/db/index.js +17 -19
  581. package/dist/esm/services/db/index.js.map +1 -1
  582. package/dist/esm/services/db/log-events-db-service.d.ts +11 -11
  583. package/dist/esm/services/db/log-events-db-service.js +177 -177
  584. package/dist/esm/services/db/pixels-db-service.d.ts +8 -8
  585. package/dist/esm/services/db/pixels-db-service.js +31 -31
  586. package/dist/esm/services/db/purchasable-contacts-db-service.d.ts +9 -9
  587. package/dist/esm/services/db/purchasable-contacts-db-service.js +39 -39
  588. package/dist/esm/services/db/purchased-contacts/index.d.ts +2 -2
  589. package/dist/esm/services/db/purchased-contacts/index.js +2 -2
  590. package/dist/esm/services/db/purchased-contacts/purchased-contacts-db-service.d.ts +18 -18
  591. package/dist/esm/services/db/purchased-contacts/purchased-contacts-db-service.js +148 -148
  592. package/dist/esm/services/db/purchased-contacts/types.d.ts +11 -11
  593. package/dist/esm/services/db/purchased-contacts/types.js +1 -1
  594. package/dist/esm/services/db/shopify-app-installs-db-service.d.ts +10 -10
  595. package/dist/esm/services/db/shopify-app-installs-db-service.js +48 -48
  596. package/dist/esm/services/db/shopify-products-cache-db-service.d.ts +16 -16
  597. package/dist/esm/services/db/shopify-products-cache-db-service.js +66 -66
  598. package/dist/esm/services/db/subscriptions-db-service.d.ts +11 -11
  599. package/dist/esm/services/db/subscriptions-db-service.js +34 -34
  600. package/dist/esm/services/db/tracking-events-db-service.d.ts +21 -21
  601. package/dist/esm/services/db/tracking-events-db-service.js +184 -184
  602. package/dist/esm/services/db/user-accounts-db-service.d.ts +7 -7
  603. package/dist/esm/services/db/user-accounts-db-service.js +13 -13
  604. package/dist/esm/services/email-verification/contact-email-verification-service.d.ts +7 -7
  605. package/dist/esm/services/email-verification/contact-email-verification-service.js +97 -97
  606. package/dist/esm/services/email-verification/email-verification-service.d.ts +19 -19
  607. package/dist/esm/services/email-verification/email-verification-service.js +127 -127
  608. package/dist/esm/services/email-verification/index.d.ts +2 -2
  609. package/dist/esm/services/email-verification/index.js +2 -2
  610. package/dist/esm/services/eventbridge-integration-service.d.ts +9 -9
  611. package/dist/esm/services/eventbridge-integration-service.js +24 -24
  612. package/dist/esm/services/events/index.d.ts +3 -3
  613. package/dist/esm/services/events/index.js +3 -3
  614. package/dist/esm/services/events/log-event-service.d.ts +19 -19
  615. package/dist/esm/services/events/log-event-service.js +73 -73
  616. package/dist/esm/services/events/metric-event-service.d.ts +9 -9
  617. package/dist/esm/services/events/metric-event-service.js +45 -45
  618. package/dist/esm/services/events/tracking-event-sqs-service.d.ts +8 -8
  619. package/dist/esm/services/events/tracking-event-sqs-service.js +30 -30
  620. package/dist/esm/services/generic-cache-service.d.ts +7 -7
  621. package/dist/esm/services/generic-cache-service.js +29 -29
  622. package/dist/esm/services/index.d.ts +10 -11
  623. package/dist/esm/services/index.js +10 -11
  624. package/dist/esm/services/index.js.map +1 -1
  625. package/dist/esm/services/ipdata-lookup-service.d.ts +20 -20
  626. package/dist/esm/services/ipdata-lookup-service.js +108 -108
  627. package/dist/esm/services/shopify/index.d.ts +2 -2
  628. package/dist/esm/services/shopify/index.js +2 -2
  629. package/dist/esm/services/shopify/products/index.d.ts +1 -1
  630. package/dist/esm/services/shopify/products/index.js +1 -1
  631. package/dist/esm/services/shopify/products/shopify-products-serviceV2.d.ts +17 -17
  632. package/dist/esm/services/shopify/products/shopify-products-serviceV2.js +108 -108
  633. package/dist/esm/services/shopify/shopify-graphql-transformer.d.ts +8 -8
  634. package/dist/esm/services/shopify/shopify-graphql-transformer.js +138 -138
  635. package/dist/esm/types/acuity-types.d.ts +74 -74
  636. package/dist/esm/types/acuity-types.js +1 -1
  637. package/dist/esm/types/api-response.d.ts +6 -6
  638. package/dist/esm/types/api-response.js +1 -1
  639. package/dist/esm/types/index.d.ts +4 -4
  640. package/dist/esm/types/index.js +4 -4
  641. package/dist/esm/types/internal-events/event-detail-types.d.ts +20 -20
  642. package/dist/esm/types/internal-events/event-detail-types.js +24 -24
  643. package/dist/esm/types/internal-events/index.d.ts +1 -1
  644. package/dist/esm/types/internal-events/index.js +1 -1
  645. package/dist/esm/types/shopify-graphql-types/admin.generated.d.ts +123 -123
  646. package/dist/esm/types/shopify-graphql-types/admin.generated.js +1 -1
  647. package/dist/esm/types/shopify-graphql-types/admin.types.d.ts +26289 -26289
  648. package/dist/esm/types/shopify-graphql-types/admin.types.js +5299 -5299
  649. package/dist/esm/types/shopify-graphql-types/index.d.ts +2 -2
  650. package/dist/esm/types/shopify-graphql-types/index.js +2 -2
  651. package/dist/esm/types/shopify-rest-types.d.ts +767 -767
  652. package/dist/esm/types/shopify-rest-types.js +1 -1
  653. package/dist/esm/utils/compression.d.ts +36 -36
  654. package/dist/esm/utils/compression.js +187 -187
  655. package/dist/esm/utils/custom-measure-formula-utils.d.ts +6 -6
  656. package/dist/esm/utils/custom-measure-formula-utils.js +201 -201
  657. package/dist/esm/utils/index.d.ts +4 -4
  658. package/dist/esm/utils/index.js +4 -4
  659. package/dist/esm/utils/retry-envelope.d.ts +12 -12
  660. package/dist/esm/utils/retry-envelope.js +22 -22
  661. package/dist/esm/utils/size.d.ts +2 -2
  662. package/dist/esm/utils/size.js +44 -44
  663. package/package.json +134 -134
  664. package/dist/cjs/__tests__/db/products-db-service.spec.js +0 -90
  665. package/dist/cjs/__tests__/db/products-db-service.spec.js.map +0 -1
  666. package/dist/cjs/__tests__/services/cost/cost-calculation-types.spec.js +0 -24
  667. package/dist/cjs/__tests__/services/cost/cost-calculation-types.spec.js.map +0 -1
  668. package/dist/cjs/__tests__/services/cost/cost-calculator-service.spec.js +0 -3320
  669. package/dist/cjs/__tests__/services/cost/cost-calculator-service.spec.js.map +0 -1
  670. package/dist/cjs/__tests__/services/cost/cost-currency-service.spec.js +0 -115
  671. package/dist/cjs/__tests__/services/cost/cost-currency-service.spec.js.map +0 -1
  672. package/dist/cjs/__tests__/services/cost/cost-filter-service.spec.d.ts +0 -1
  673. package/dist/cjs/__tests__/services/cost/cost-filter-service.spec.js +0 -469
  674. package/dist/cjs/__tests__/services/cost/cost-filter-service.spec.js.map +0 -1
  675. package/dist/cjs/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.d.ts +0 -1
  676. package/dist/cjs/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.js +0 -207
  677. package/dist/cjs/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.js.map +0 -1
  678. package/dist/cjs/__tests__/services/currency-exchange-rate-lookup-service.spec.d.ts +0 -1
  679. package/dist/cjs/__tests__/services/currency-exchange-rate-lookup-service.spec.js +0 -35
  680. package/dist/cjs/__tests__/services/currency-exchange-rate-lookup-service.spec.js.map +0 -1
  681. package/dist/cjs/services/cost/cost-calculation-types.d.ts +0 -69
  682. package/dist/cjs/services/cost/cost-calculation-types.js +0 -20
  683. package/dist/cjs/services/cost/cost-calculation-types.js.map +0 -1
  684. package/dist/cjs/services/cost/cost-calculator-service.d.ts +0 -24
  685. package/dist/cjs/services/cost/cost-calculator-service.js +0 -457
  686. package/dist/cjs/services/cost/cost-calculator-service.js.map +0 -1
  687. package/dist/cjs/services/cost/cost-currency-service.d.ts +0 -6
  688. package/dist/cjs/services/cost/cost-currency-service.js +0 -88
  689. package/dist/cjs/services/cost/cost-currency-service.js.map +0 -1
  690. package/dist/cjs/services/cost/cost-filter-service.d.ts +0 -10
  691. package/dist/cjs/services/cost/cost-filter-service.js +0 -122
  692. package/dist/cjs/services/cost/cost-filter-service.js.map +0 -1
  693. package/dist/cjs/services/cost/index.d.ts +0 -5
  694. package/dist/cjs/services/cost/index.js +0 -22
  695. package/dist/cjs/services/cost/index.js.map +0 -1
  696. package/dist/cjs/services/cost/order-cost/index.d.ts +0 -2
  697. package/dist/cjs/services/cost/order-cost/index.js +0 -19
  698. package/dist/cjs/services/cost/order-cost/index.js.map +0 -1
  699. package/dist/cjs/services/cost/order-cost/order-cost-resolution-service.d.ts +0 -23
  700. package/dist/cjs/services/cost/order-cost/order-cost-resolution-service.js +0 -362
  701. package/dist/cjs/services/cost/order-cost/order-cost-resolution-service.js.map +0 -1
  702. package/dist/cjs/services/cost/order-cost/order-cost-resolution-types.d.ts +0 -37
  703. package/dist/cjs/services/cost/order-cost/order-cost-resolution-types.js +0 -3
  704. package/dist/cjs/services/cost/order-cost/order-cost-resolution-types.js.map +0 -1
  705. package/dist/cjs/services/db/products-db-service-types.d.ts +0 -10
  706. package/dist/cjs/services/db/products-db-service-types.js +0 -3
  707. package/dist/cjs/services/db/products-db-service-types.js.map +0 -1
  708. package/dist/cjs/services/db/products-db-service.d.ts +0 -19
  709. package/dist/cjs/services/db/products-db-service.js +0 -282
  710. package/dist/cjs/services/db/products-db-service.js.map +0 -1
  711. package/dist/esm/__tests__/db/products-db-service.spec.d.ts +0 -1
  712. package/dist/esm/__tests__/db/products-db-service.spec.js +0 -88
  713. package/dist/esm/__tests__/db/products-db-service.spec.js.map +0 -1
  714. package/dist/esm/__tests__/services/cost/cost-calculation-types.spec.d.ts +0 -1
  715. package/dist/esm/__tests__/services/cost/cost-calculation-types.spec.js +0 -22
  716. package/dist/esm/__tests__/services/cost/cost-calculation-types.spec.js.map +0 -1
  717. package/dist/esm/__tests__/services/cost/cost-calculator-service.spec.d.ts +0 -1
  718. package/dist/esm/__tests__/services/cost/cost-calculator-service.spec.js +0 -3318
  719. package/dist/esm/__tests__/services/cost/cost-calculator-service.spec.js.map +0 -1
  720. package/dist/esm/__tests__/services/cost/cost-currency-service.spec.d.ts +0 -1
  721. package/dist/esm/__tests__/services/cost/cost-currency-service.spec.js +0 -113
  722. package/dist/esm/__tests__/services/cost/cost-currency-service.spec.js.map +0 -1
  723. package/dist/esm/__tests__/services/cost/cost-filter-service.spec.d.ts +0 -1
  724. package/dist/esm/__tests__/services/cost/cost-filter-service.spec.js +0 -467
  725. package/dist/esm/__tests__/services/cost/cost-filter-service.spec.js.map +0 -1
  726. package/dist/esm/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.d.ts +0 -1
  727. package/dist/esm/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.js +0 -205
  728. package/dist/esm/__tests__/services/cost/order-cost/order-cost-resolution-service.spec.js.map +0 -1
  729. package/dist/esm/__tests__/services/currency-exchange-rate-lookup-service.spec.d.ts +0 -1
  730. package/dist/esm/__tests__/services/currency-exchange-rate-lookup-service.spec.js +0 -33
  731. package/dist/esm/__tests__/services/currency-exchange-rate-lookup-service.spec.js.map +0 -1
  732. package/dist/esm/services/cost/cost-calculation-types.d.ts +0 -69
  733. package/dist/esm/services/cost/cost-calculation-types.js +0 -16
  734. package/dist/esm/services/cost/cost-calculation-types.js.map +0 -1
  735. package/dist/esm/services/cost/cost-calculator-service.d.ts +0 -24
  736. package/dist/esm/services/cost/cost-calculator-service.js +0 -451
  737. package/dist/esm/services/cost/cost-calculator-service.js.map +0 -1
  738. package/dist/esm/services/cost/cost-currency-service.d.ts +0 -6
  739. package/dist/esm/services/cost/cost-currency-service.js +0 -85
  740. package/dist/esm/services/cost/cost-currency-service.js.map +0 -1
  741. package/dist/esm/services/cost/cost-filter-service.d.ts +0 -10
  742. package/dist/esm/services/cost/cost-filter-service.js +0 -119
  743. package/dist/esm/services/cost/cost-filter-service.js.map +0 -1
  744. package/dist/esm/services/cost/index.d.ts +0 -5
  745. package/dist/esm/services/cost/index.js +0 -6
  746. package/dist/esm/services/cost/index.js.map +0 -1
  747. package/dist/esm/services/cost/order-cost/index.d.ts +0 -2
  748. package/dist/esm/services/cost/order-cost/index.js +0 -3
  749. package/dist/esm/services/cost/order-cost/index.js.map +0 -1
  750. package/dist/esm/services/cost/order-cost/order-cost-resolution-service.d.ts +0 -23
  751. package/dist/esm/services/cost/order-cost/order-cost-resolution-service.js +0 -356
  752. package/dist/esm/services/cost/order-cost/order-cost-resolution-service.js.map +0 -1
  753. package/dist/esm/services/cost/order-cost/order-cost-resolution-types.d.ts +0 -37
  754. package/dist/esm/services/cost/order-cost/order-cost-resolution-types.js +0 -2
  755. package/dist/esm/services/cost/order-cost/order-cost-resolution-types.js.map +0 -1
  756. package/dist/esm/services/db/products-db-service-types.d.ts +0 -10
  757. package/dist/esm/services/db/products-db-service-types.js +0 -2
  758. package/dist/esm/services/db/products-db-service-types.js.map +0 -1
  759. package/dist/esm/services/db/products-db-service.d.ts +0 -19
  760. package/dist/esm/services/db/products-db-service.js +0 -278
  761. package/dist/esm/services/db/products-db-service.js.map +0 -1
@@ -1,564 +1,564 @@
1
- "use strict";
2
- var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
- if (k2 === undefined) k2 = k;
4
- var desc = Object.getOwnPropertyDescriptor(m, k);
5
- if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
- desc = { enumerable: true, get: function() { return m[k]; } };
7
- }
8
- Object.defineProperty(o, k2, desc);
9
- }) : (function(o, m, k, k2) {
10
- if (k2 === undefined) k2 = k;
11
- o[k2] = m[k];
12
- }));
13
- var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
- Object.defineProperty(o, "default", { enumerable: true, value: v });
15
- }) : function(o, v) {
16
- o["default"] = v;
17
- });
18
- var __importStar = (this && this.__importStar) || function (mod) {
19
- if (mod && mod.__esModule) return mod;
20
- var result = {};
21
- if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
22
- __setModuleDefault(result, mod);
23
- return result;
24
- };
25
- Object.defineProperty(exports, "__esModule", { value: true });
26
- const zlib = __importStar(require("zlib"));
27
- const util_1 = require("util");
28
- const sqs_unbundle_1 = require("../../clients/generic/sqs-unbundle");
29
- const gzip = (0, util_1.promisify)(zlib.gzip);
30
- const MESSAGE_TYPES = {
31
- TRACKING_EVENT_COLLECT: 'TRACKING_EVENT_COLLECT',
32
- SESSION_EVENT_COLLECT: 'SESSION_EVENT_COLLECT',
33
- LOG_EVENT_COLLECT: 'LOG_EVENT_COLLECT',
34
- };
35
- async function createBundledMessage(messageType, items) {
36
- const json = JSON.stringify(items);
37
- const uncompressedBuffer = Buffer.from(json, 'utf-8');
38
- const compressedBuffer = await gzip(uncompressedBuffer);
39
- const base64 = compressedBuffer.toString('base64');
40
- const envelope = {
41
- v: 1,
42
- c: 'gzip',
43
- n: items.length,
44
- p: base64,
45
- s: uncompressedBuffer.length,
46
- };
47
- const wrapped = {
48
- messageId: crypto.randomUUID(),
49
- messageType,
50
- messageTime: new Date().toISOString(),
51
- messageBody: envelope,
52
- };
53
- return wrapped;
54
- }
55
- function createSQSRecord(messageBody, messageId) {
56
- return {
57
- messageId: messageId ?? crypto.randomUUID(),
58
- receiptHandle: 'test-receipt-handle',
59
- body: messageBody,
60
- attributes: {
61
- ApproximateReceiveCount: '1',
62
- SentTimestamp: Date.now().toString(),
63
- SenderId: 'test-sender',
64
- ApproximateFirstReceiveTimestamp: Date.now().toString(),
65
- },
66
- messageAttributes: {},
67
- md5OfBody: 'test-md5',
68
- eventSource: 'aws:sqs',
69
- eventSourceARN: 'arn:aws:sqs:us-east-1:123456789:test-queue',
70
- awsRegion: 'us-east-1',
71
- };
72
- }
73
- describe('Producer-Consumer Contract Tests', () => {
74
- describe('TRACKING_EVENT_COLLECT Contract', () => {
75
- it('producer creates valid InternalSQSMessage<BundledEnvelope> structure', async () => {
76
- const trackingEvents = [
77
- {
78
- pixelId: 'px_test_001',
79
- id: 'evt_001',
80
- trackingEvent: {
81
- name: 'PageView',
82
- context: { properties: { page: '/products' } },
83
- data: { url: 'https://example.com/products' },
84
- },
85
- edgeContext: {
86
- ipAddress: '192.168.1.1',
87
- userAgent: 'Mozilla/5.0',
88
- requestHeaders: { 'cf-connecting-ip': '192.168.1.1' },
89
- },
90
- },
91
- {
92
- pixelId: 'px_test_002',
93
- id: 'evt_002',
94
- _encrypted: 'base64_encrypted_payload',
95
- },
96
- ];
97
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, trackingEvents);
98
- expect(bundledMessage).toMatchObject({
99
- messageId: expect.any(String),
100
- messageType: 'TRACKING_EVENT_COLLECT',
101
- messageTime: expect.any(String),
102
- messageBody: {
103
- v: 1,
104
- c: 'gzip',
105
- n: 2,
106
- p: expect.any(String),
107
- s: expect.any(Number),
108
- },
109
- });
110
- expect(new Date(bundledMessage.messageTime).toISOString()).toBe(bundledMessage.messageTime);
111
- });
112
- it('consumer unbundleRecords extracts items matching TrackingEventCollectMessage', async () => {
113
- const originalItems = [
114
- {
115
- pixelId: 'px_tracking_001',
116
- id: 'evt_tracking_001',
117
- trackingEvent: {
118
- name: 'AddToCart',
119
- eventName: 'add_to_cart',
120
- context: {
121
- properties: {
122
- sessionId: 'sess_001',
123
- page: { path: '/products/widget' },
124
- },
125
- },
126
- data: {
127
- productId: 'prod_001',
128
- value: 29.99,
129
- currency: 'USD',
130
- },
131
- },
132
- edgeContext: {
133
- ipAddress: '10.0.0.1',
134
- userAgent: 'Chrome/120',
135
- requestHeaders: {
136
- 'cf-connecting-ip': '10.0.0.1',
137
- 'user-agent': 'Chrome/120',
138
- 'accept-language': 'en-US',
139
- },
140
- cf: { country: 'US', colo: 'SJC' },
141
- },
142
- },
143
- {
144
- pixelId: 'px_tracking_002',
145
- _encrypted: 'encrypted_payload_base64',
146
- edgeContext: {
147
- ipAddress: '10.0.0.2',
148
- userAgent: 'Safari/17',
149
- requestHeaders: {},
150
- },
151
- },
152
- ];
153
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, originalItems);
154
- const serialized = JSON.stringify(bundledMessage);
155
- const sqsRecord = createSQSRecord(serialized);
156
- const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
157
- expect(result.items).toHaveLength(2);
158
- expect(result.failedMessageIds).toHaveLength(0);
159
- expect(result.stats.bundledSqsRecords).toBe(1);
160
- expect(result.stats.totalItems).toBe(2);
161
- const item1 = result.items[0];
162
- expect(item1.pixelId).toBe('px_tracking_001');
163
- expect(item1.trackingEvent?.name).toBe('AddToCart');
164
- expect(item1.trackingEvent?.data?.productId).toBe('prod_001');
165
- expect(item1.edgeContext?.ipAddress).toBe('10.0.0.1');
166
- const item2 = result.items[1];
167
- expect(item2.pixelId).toBe('px_tracking_002');
168
- expect(item2._encrypted).toBe('encrypted_payload_base64');
169
- });
170
- it('consumer validates required pixelId field exists', async () => {
171
- const items = [{ pixelId: 'px_valid', trackingEvent: { name: 'PageView' } }];
172
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, items);
173
- const serialized = JSON.stringify(bundledMessage);
174
- const sqsRecord = createSQSRecord(serialized);
175
- const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
176
- expect(result.items).toHaveLength(1);
177
- expect(result.items[0].pixelId).toBe('px_valid');
178
- });
179
- });
180
- describe('SESSION_EVENT_COLLECT Contract', () => {
181
- it('producer creates valid InternalSQSMessage<BundledEnvelope> structure', async () => {
182
- const sessionEvents = [
183
- {
184
- pixelId: 'px_session_001',
185
- id: 'sess_evt_001',
186
- sessionEvent: {
187
- id: 'sess_evt_001',
188
- type: 'session',
189
- name: 'session_end',
190
- version: '1.0',
191
- pixelId: 'px_session_001',
192
- sessionId: 'sess_001',
193
- context: {
194
- identity: { identityId: 'id_001' },
195
- properties: { sessionId: 'sess_001' },
196
- },
197
- data: {
198
- messageId: 'msg_001',
199
- pixelId_sessionId: 'px_session_001_sess_001',
200
- isFinal: true,
201
- sessionStartAt: '2024-01-01T00:00:00.000Z',
202
- sessionEndAt: '2024-01-01T00:30:00.000Z',
203
- sessionDuration: 1800000,
204
- pageCount: 5,
205
- totalActiveTime: 600000,
206
- },
207
- },
208
- edgeContext: {
209
- ipAddress: '192.168.1.100',
210
- userAgent: 'Mozilla/5.0',
211
- requestHeaders: { 'cf-connecting-ip': '192.168.1.100' },
212
- cf: { country: 'US' },
213
- },
214
- },
215
- ];
216
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, sessionEvents);
217
- expect(bundledMessage).toMatchObject({
218
- messageId: expect.any(String),
219
- messageType: 'SESSION_EVENT_COLLECT',
220
- messageTime: expect.any(String),
221
- messageBody: {
222
- v: 1,
223
- c: 'gzip',
224
- n: 1,
225
- p: expect.any(String),
226
- s: expect.any(Number),
227
- },
228
- });
229
- });
230
- it('consumer unbundleRecords extracts items matching SessionCollectMessage', async () => {
231
- const originalItems = [
232
- {
233
- pixelId: 'px_sess_001',
234
- id: 'sess_record_001',
235
- sessionEvent: {
236
- id: 'sess_record_001',
237
- type: 'session',
238
- name: 'session_start',
239
- version: '1.0',
240
- pixelId: 'px_sess_001',
241
- sessionId: 'sess_abc123',
242
- context: {
243
- identity: { identityId: 'identity_001' },
244
- properties: {
245
- sessionId: 'sess_abc123',
246
- userAgent: 'Chrome/120',
247
- ipAddress: '10.0.0.100',
248
- },
249
- },
250
- data: {
251
- messageId: 'msg_sess_001',
252
- pixelId_sessionId: 'px_sess_001_sess_abc123',
253
- isFinal: false,
254
- sessionStartAt: '2024-01-15T10:00:00.000Z',
255
- landingPage: '/home',
256
- returnTier: 'new',
257
- },
258
- },
259
- edgeContext: {
260
- ipAddress: '10.0.0.100',
261
- userAgent: 'Chrome/120',
262
- requestHeaders: {},
263
- cf: { country: 'CA', region: 'ON', city: 'Toronto' },
264
- },
265
- },
266
- {
267
- pixelId: 'px_sess_002',
268
- id: 'sess_record_002',
269
- sessionEvent: {
270
- id: 'sess_record_002',
271
- type: 'session',
272
- name: 'session_end',
273
- pixelId: 'px_sess_002',
274
- sessionId: 'sess_xyz789',
275
- data: {
276
- isFinal: true,
277
- sessionDuration: 300000,
278
- pageCount: 3,
279
- endReason: 'timeout',
280
- },
281
- },
282
- },
283
- ];
284
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, originalItems);
285
- const serialized = JSON.stringify(bundledMessage);
286
- const sqsRecord = createSQSRecord(serialized);
287
- const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
288
- expect(result.items).toHaveLength(2);
289
- expect(result.failedMessageIds).toHaveLength(0);
290
- expect(result.stats.bundledSqsRecords).toBe(1);
291
- expect(result.stats.totalItems).toBe(2);
292
- const item1 = result.items[0];
293
- expect(item1.pixelId).toBe('px_sess_001');
294
- expect(item1.sessionEvent).toBeDefined();
295
- expect(item1.sessionEvent.name).toBe('session_start');
296
- expect(item1.sessionEvent.sessionId).toBe('sess_abc123');
297
- expect(item1.sessionEvent.data?.landingPage).toBe('/home');
298
- expect(item1.edgeContext?.cf?.country).toBe('CA');
299
- const item2 = result.items[1];
300
- expect(item2.pixelId).toBe('px_sess_002');
301
- expect(item2.sessionEvent.name).toBe('session_end');
302
- expect(item2.sessionEvent.data?.isFinal).toBe(true);
303
- expect(item2.sessionEvent.data?.endReason).toBe('timeout');
304
- });
305
- it('consumer validates required sessionEvent field exists', async () => {
306
- const items = [
307
- {
308
- pixelId: 'px_valid_session',
309
- sessionEvent: {
310
- name: 'session_update',
311
- pixelId: 'px_valid_session',
312
- sessionId: 'sess_valid',
313
- },
314
- },
315
- ];
316
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, items);
317
- const serialized = JSON.stringify(bundledMessage);
318
- const sqsRecord = createSQSRecord(serialized);
319
- const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
320
- expect(result.items).toHaveLength(1);
321
- expect(result.items[0].sessionEvent).toBeDefined();
322
- expect(result.items[0].sessionEvent.sessionId).toBe('sess_valid');
323
- });
324
- });
325
- describe('LOG_EVENT_COLLECT Contract', () => {
326
- it('producer creates valid InternalSQSMessage<BundledEnvelope> structure', async () => {
327
- const logEvents = [
328
- {
329
- pixelId: 'px_log_001',
330
- logEvent: {
331
- name: 'error',
332
- type: 'client_error',
333
- message: 'Failed to load resource',
334
- stack: 'Error at line 42',
335
- },
336
- requestHeaders: { 'user-agent': 'Chrome/120' },
337
- },
338
- ];
339
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, logEvents);
340
- expect(bundledMessage).toMatchObject({
341
- messageId: expect.any(String),
342
- messageType: 'LOG_EVENT_COLLECT',
343
- messageTime: expect.any(String),
344
- messageBody: {
345
- v: 1,
346
- c: 'gzip',
347
- n: 1,
348
- p: expect.any(String),
349
- s: expect.any(Number),
350
- },
351
- });
352
- });
353
- it('consumer unbundleRecords extracts items matching LogCollectMessage', async () => {
354
- const originalItems = [
355
- {
356
- pixelId: 'px_log_001',
357
- logEvent: {
358
- name: 'performance',
359
- type: 'web_vital',
360
- metric: 'LCP',
361
- value: 2500,
362
- timestamp: Date.now(),
363
- },
364
- requestHeaders: {
365
- 'user-agent': 'Safari/17',
366
- 'cf-connecting-ip': '172.16.0.1',
367
- },
368
- },
369
- {
370
- pixelId: 'px_log_002',
371
- _encrypted: 'encrypted_log_payload',
372
- },
373
- {
374
- pixelId: 'px_log_003',
375
- logEvent: {
376
- name: 'debug',
377
- type: 'pixel_init',
378
- data: { version: '2.1.0', config: { trackClicks: true } },
379
- },
380
- },
381
- ];
382
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, originalItems);
383
- const serialized = JSON.stringify(bundledMessage);
384
- const sqsRecord = createSQSRecord(serialized);
385
- const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
386
- expect(result.items).toHaveLength(3);
387
- expect(result.failedMessageIds).toHaveLength(0);
388
- expect(result.stats.bundledSqsRecords).toBe(1);
389
- expect(result.stats.totalItems).toBe(3);
390
- const item1 = result.items[0];
391
- expect(item1.pixelId).toBe('px_log_001');
392
- expect(item1.logEvent?.name).toBe('performance');
393
- expect(item1.logEvent?.metric).toBe('LCP');
394
- expect(item1.requestHeaders?.['user-agent']).toBe('Safari/17');
395
- const item2 = result.items[1];
396
- expect(item2.pixelId).toBe('px_log_002');
397
- expect(item2._encrypted).toBe('encrypted_log_payload');
398
- const item3 = result.items[2];
399
- expect(item3.pixelId).toBe('px_log_003');
400
- expect(item3.logEvent?.type).toBe('pixel_init');
401
- });
402
- });
403
- describe('Cross-Queue Contract Consistency', () => {
404
- it('all message types use identical BundledEnvelope structure', async () => {
405
- const trackingMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [{ pixelId: 'px1' }]);
406
- const sessionMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, [
407
- { pixelId: 'px2', sessionEvent: { name: 'test' } },
408
- ]);
409
- const logMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, [{ pixelId: 'px3' }]);
410
- const envelopeKeys = ['c', 'n', 'p', 's', 'v'];
411
- expect(Object.keys(trackingMessage.messageBody).sort()).toEqual(envelopeKeys);
412
- expect(Object.keys(sessionMessage.messageBody).sort()).toEqual(envelopeKeys);
413
- expect(Object.keys(logMessage.messageBody).sort()).toEqual(envelopeKeys);
414
- expect(trackingMessage.messageBody.v).toBe(1);
415
- expect(trackingMessage.messageBody.c).toBe('gzip');
416
- expect(sessionMessage.messageBody.v).toBe(1);
417
- expect(sessionMessage.messageBody.c).toBe('gzip');
418
- expect(logMessage.messageBody.v).toBe(1);
419
- expect(logMessage.messageBody.c).toBe('gzip');
420
- });
421
- it('all message types use identical InternalSQSMessage wrapper structure', async () => {
422
- const trackingMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [{ pixelId: 'px1' }]);
423
- const sessionMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, [
424
- { pixelId: 'px2', sessionEvent: { name: 'test' } },
425
- ]);
426
- const logMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, [{ pixelId: 'px3' }]);
427
- const wrapperKeys = ['messageBody', 'messageId', 'messageTime', 'messageType'];
428
- expect(Object.keys(trackingMessage).sort()).toEqual(wrapperKeys);
429
- expect(Object.keys(sessionMessage).sort()).toEqual(wrapperKeys);
430
- expect(Object.keys(logMessage).sort()).toEqual(wrapperKeys);
431
- expect([
432
- MESSAGE_TYPES.TRACKING_EVENT_COLLECT,
433
- MESSAGE_TYPES.SESSION_EVENT_COLLECT,
434
- MESSAGE_TYPES.LOG_EVENT_COLLECT,
435
- ]).toContain(trackingMessage.messageType);
436
- expect([
437
- MESSAGE_TYPES.TRACKING_EVENT_COLLECT,
438
- MESSAGE_TYPES.SESSION_EVENT_COLLECT,
439
- MESSAGE_TYPES.LOG_EVENT_COLLECT,
440
- ]).toContain(sessionMessage.messageType);
441
- expect([
442
- MESSAGE_TYPES.TRACKING_EVENT_COLLECT,
443
- MESSAGE_TYPES.SESSION_EVENT_COLLECT,
444
- MESSAGE_TYPES.LOG_EVENT_COLLECT,
445
- ]).toContain(logMessage.messageType);
446
- });
447
- it('unbundleRecords handles all message types uniformly', async () => {
448
- const tracking = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [
449
- { pixelId: 'px_t1', trackingEvent: { name: 'PageView' } },
450
- { pixelId: 'px_t2', trackingEvent: { name: 'AddToCart' } },
451
- ]);
452
- const session = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, [
453
- { pixelId: 'px_s1', sessionEvent: { name: 'session_start' } },
454
- ]);
455
- const log = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, [
456
- { pixelId: 'px_l1', logEvent: { name: 'error' } },
457
- { pixelId: 'px_l2', logEvent: { name: 'debug' } },
458
- { pixelId: 'px_l3', logEvent: { name: 'info' } },
459
- ]);
460
- const records = [
461
- createSQSRecord(JSON.stringify(tracking), 'msg-tracking'),
462
- createSQSRecord(JSON.stringify(session), 'msg-session'),
463
- createSQSRecord(JSON.stringify(log), 'msg-log'),
464
- ];
465
- const result = await (0, sqs_unbundle_1.unbundleRecords)(records);
466
- expect(result.failedMessageIds).toHaveLength(0);
467
- expect(result.stats.bundledSqsRecords).toBe(3);
468
- expect(result.stats.totalItems).toBe(6);
469
- expect(result.items).toHaveLength(6);
470
- const pixelIds = result.items.map((item) => item.pixelId);
471
- expect(pixelIds).toContain('px_t1');
472
- expect(pixelIds).toContain('px_t2');
473
- expect(pixelIds).toContain('px_s1');
474
- expect(pixelIds).toContain('px_l1');
475
- expect(pixelIds).toContain('px_l2');
476
- expect(pixelIds).toContain('px_l3');
477
- });
478
- });
479
- describe('Edge Cases and Error Handling', () => {
480
- it('handles empty bundle gracefully', async () => {
481
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, []);
482
- const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
483
- const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
484
- expect(result.items).toHaveLength(0);
485
- expect(result.failedMessageIds).toHaveLength(0);
486
- expect(result.stats.bundledSqsRecords).toBe(1);
487
- expect(result.stats.totalItems).toBe(0);
488
- });
489
- it('handles mixed bundled and legacy records in same batch', async () => {
490
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [
491
- { pixelId: 'px_bundled_1' },
492
- { pixelId: 'px_bundled_2' },
493
- ]);
494
- const legacyItem = { pixelId: 'px_legacy' };
495
- const records = [
496
- createSQSRecord(JSON.stringify(bundledMessage), 'msg-bundled'),
497
- createSQSRecord(JSON.stringify(legacyItem), 'msg-legacy'),
498
- ];
499
- const result = await (0, sqs_unbundle_1.unbundleRecords)(records);
500
- expect(result.items).toHaveLength(3);
501
- expect(result.stats.bundledSqsRecords).toBe(1);
502
- expect(result.stats.legacySqsRecords).toBe(1);
503
- expect(result.stats.totalItems).toBe(3);
504
- const pixelIds = result.items.map((item) => item.pixelId);
505
- expect(pixelIds).toContain('px_bundled_1');
506
- expect(pixelIds).toContain('px_bundled_2');
507
- expect(pixelIds).toContain('px_legacy');
508
- });
509
- it('preserves exact item data through bundle/unbundle cycle', async () => {
510
- const complexItem = {
511
- pixelId: 'px_complex',
512
- id: 'evt_complex',
513
- dd: 1234567890,
514
- trackingEvent: {
515
- name: 'Purchase',
516
- eventName: 'purchase',
517
- context: {
518
- properties: {
519
- sessionId: 'sess_xyz',
520
- page: { path: '/checkout/success', title: 'Order Complete' },
521
- device: { type: 'mobile', os: 'iOS', browser: 'Safari' },
522
- },
523
- },
524
- data: {
525
- orderId: 'order_12345',
526
- value: 199.99,
527
- currency: 'USD',
528
- items: [
529
- { sku: 'SKU001', name: 'Widget', quantity: 2, price: 49.99 },
530
- { sku: 'SKU002', name: 'Gadget', quantity: 1, price: 100.01 },
531
- ],
532
- },
533
- },
534
- edgeContext: {
535
- ipAddress: '2001:db8::1',
536
- userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0)',
537
- requestHeaders: {
538
- 'cf-connecting-ip': '2001:db8::1',
539
- 'cf-ipcountry': 'US',
540
- 'user-agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0)',
541
- 'accept-language': 'en-US,en;q=0.9',
542
- },
543
- cf: {
544
- country: 'US',
545
- region: 'CA',
546
- city: 'San Francisco',
547
- colo: 'SJC',
548
- timezone: 'America/Los_Angeles',
549
- },
550
- },
551
- };
552
- const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [complexItem]);
553
- const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
554
- const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
555
- expect(result.items).toHaveLength(1);
556
- const extracted = result.items[0];
557
- expect(extracted).toEqual(complexItem);
558
- expect(extracted.trackingEvent?.data?.items).toHaveLength(2);
559
- expect(extracted?.trackingEvent?.data && (extracted?.trackingEvent?.data?.items)[0]?.sku).toBe('SKU001');
560
- expect(extracted.edgeContext?.cf?.timezone).toBe('America/Los_Angeles');
561
- });
562
- });
563
- });
1
+ "use strict";
2
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
3
+ if (k2 === undefined) k2 = k;
4
+ var desc = Object.getOwnPropertyDescriptor(m, k);
5
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
6
+ desc = { enumerable: true, get: function() { return m[k]; } };
7
+ }
8
+ Object.defineProperty(o, k2, desc);
9
+ }) : (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ o[k2] = m[k];
12
+ }));
13
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
14
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
15
+ }) : function(o, v) {
16
+ o["default"] = v;
17
+ });
18
+ var __importStar = (this && this.__importStar) || function (mod) {
19
+ if (mod && mod.__esModule) return mod;
20
+ var result = {};
21
+ if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
22
+ __setModuleDefault(result, mod);
23
+ return result;
24
+ };
25
+ Object.defineProperty(exports, "__esModule", { value: true });
26
+ const zlib = __importStar(require("zlib"));
27
+ const util_1 = require("util");
28
+ const sqs_unbundle_1 = require("../../clients/generic/sqs-unbundle");
29
+ const gzip = (0, util_1.promisify)(zlib.gzip);
30
+ const MESSAGE_TYPES = {
31
+ TRACKING_EVENT_COLLECT: 'TRACKING_EVENT_COLLECT',
32
+ SESSION_EVENT_COLLECT: 'SESSION_EVENT_COLLECT',
33
+ LOG_EVENT_COLLECT: 'LOG_EVENT_COLLECT',
34
+ };
35
+ async function createBundledMessage(messageType, items) {
36
+ const json = JSON.stringify(items);
37
+ const uncompressedBuffer = Buffer.from(json, 'utf-8');
38
+ const compressedBuffer = await gzip(uncompressedBuffer);
39
+ const base64 = compressedBuffer.toString('base64');
40
+ const envelope = {
41
+ v: 1,
42
+ c: 'gzip',
43
+ n: items.length,
44
+ p: base64,
45
+ s: uncompressedBuffer.length,
46
+ };
47
+ const wrapped = {
48
+ messageId: crypto.randomUUID(),
49
+ messageType,
50
+ messageTime: new Date().toISOString(),
51
+ messageBody: envelope,
52
+ };
53
+ return wrapped;
54
+ }
55
+ function createSQSRecord(messageBody, messageId) {
56
+ return {
57
+ messageId: messageId ?? crypto.randomUUID(),
58
+ receiptHandle: 'test-receipt-handle',
59
+ body: messageBody,
60
+ attributes: {
61
+ ApproximateReceiveCount: '1',
62
+ SentTimestamp: Date.now().toString(),
63
+ SenderId: 'test-sender',
64
+ ApproximateFirstReceiveTimestamp: Date.now().toString(),
65
+ },
66
+ messageAttributes: {},
67
+ md5OfBody: 'test-md5',
68
+ eventSource: 'aws:sqs',
69
+ eventSourceARN: 'arn:aws:sqs:us-east-1:123456789:test-queue',
70
+ awsRegion: 'us-east-1',
71
+ };
72
+ }
73
+ describe('Producer-Consumer Contract Tests', () => {
74
+ describe('TRACKING_EVENT_COLLECT Contract', () => {
75
+ it('producer creates valid InternalSQSMessage<BundledEnvelope> structure', async () => {
76
+ const trackingEvents = [
77
+ {
78
+ pixelId: 'px_test_001',
79
+ id: 'evt_001',
80
+ trackingEvent: {
81
+ name: 'PageView',
82
+ context: { properties: { page: '/products' } },
83
+ data: { url: 'https://example.com/products' },
84
+ },
85
+ edgeContext: {
86
+ ipAddress: '192.168.1.1',
87
+ userAgent: 'Mozilla/5.0',
88
+ requestHeaders: { 'cf-connecting-ip': '192.168.1.1' },
89
+ },
90
+ },
91
+ {
92
+ pixelId: 'px_test_002',
93
+ id: 'evt_002',
94
+ _encrypted: 'base64_encrypted_payload',
95
+ },
96
+ ];
97
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, trackingEvents);
98
+ expect(bundledMessage).toMatchObject({
99
+ messageId: expect.any(String),
100
+ messageType: 'TRACKING_EVENT_COLLECT',
101
+ messageTime: expect.any(String),
102
+ messageBody: {
103
+ v: 1,
104
+ c: 'gzip',
105
+ n: 2,
106
+ p: expect.any(String),
107
+ s: expect.any(Number),
108
+ },
109
+ });
110
+ expect(new Date(bundledMessage.messageTime).toISOString()).toBe(bundledMessage.messageTime);
111
+ });
112
+ it('consumer unbundleRecords extracts items matching TrackingEventCollectMessage', async () => {
113
+ const originalItems = [
114
+ {
115
+ pixelId: 'px_tracking_001',
116
+ id: 'evt_tracking_001',
117
+ trackingEvent: {
118
+ name: 'AddToCart',
119
+ eventName: 'add_to_cart',
120
+ context: {
121
+ properties: {
122
+ sessionId: 'sess_001',
123
+ page: { path: '/products/widget' },
124
+ },
125
+ },
126
+ data: {
127
+ productId: 'prod_001',
128
+ value: 29.99,
129
+ currency: 'USD',
130
+ },
131
+ },
132
+ edgeContext: {
133
+ ipAddress: '10.0.0.1',
134
+ userAgent: 'Chrome/120',
135
+ requestHeaders: {
136
+ 'cf-connecting-ip': '10.0.0.1',
137
+ 'user-agent': 'Chrome/120',
138
+ 'accept-language': 'en-US',
139
+ },
140
+ cf: { country: 'US', colo: 'SJC' },
141
+ },
142
+ },
143
+ {
144
+ pixelId: 'px_tracking_002',
145
+ _encrypted: 'encrypted_payload_base64',
146
+ edgeContext: {
147
+ ipAddress: '10.0.0.2',
148
+ userAgent: 'Safari/17',
149
+ requestHeaders: {},
150
+ },
151
+ },
152
+ ];
153
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, originalItems);
154
+ const serialized = JSON.stringify(bundledMessage);
155
+ const sqsRecord = createSQSRecord(serialized);
156
+ const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
157
+ expect(result.items).toHaveLength(2);
158
+ expect(result.failedMessageIds).toHaveLength(0);
159
+ expect(result.stats.bundledSqsRecords).toBe(1);
160
+ expect(result.stats.totalItems).toBe(2);
161
+ const item1 = result.items[0];
162
+ expect(item1.pixelId).toBe('px_tracking_001');
163
+ expect(item1.trackingEvent?.name).toBe('AddToCart');
164
+ expect(item1.trackingEvent?.data?.productId).toBe('prod_001');
165
+ expect(item1.edgeContext?.ipAddress).toBe('10.0.0.1');
166
+ const item2 = result.items[1];
167
+ expect(item2.pixelId).toBe('px_tracking_002');
168
+ expect(item2._encrypted).toBe('encrypted_payload_base64');
169
+ });
170
+ it('consumer validates required pixelId field exists', async () => {
171
+ const items = [{ pixelId: 'px_valid', trackingEvent: { name: 'PageView' } }];
172
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, items);
173
+ const serialized = JSON.stringify(bundledMessage);
174
+ const sqsRecord = createSQSRecord(serialized);
175
+ const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
176
+ expect(result.items).toHaveLength(1);
177
+ expect(result.items[0].pixelId).toBe('px_valid');
178
+ });
179
+ });
180
+ describe('SESSION_EVENT_COLLECT Contract', () => {
181
+ it('producer creates valid InternalSQSMessage<BundledEnvelope> structure', async () => {
182
+ const sessionEvents = [
183
+ {
184
+ pixelId: 'px_session_001',
185
+ id: 'sess_evt_001',
186
+ sessionEvent: {
187
+ id: 'sess_evt_001',
188
+ type: 'session',
189
+ name: 'session_end',
190
+ version: '1.0',
191
+ pixelId: 'px_session_001',
192
+ sessionId: 'sess_001',
193
+ context: {
194
+ identity: { identityId: 'id_001' },
195
+ properties: { sessionId: 'sess_001' },
196
+ },
197
+ data: {
198
+ messageId: 'msg_001',
199
+ pixelId_sessionId: 'px_session_001_sess_001',
200
+ isFinal: true,
201
+ sessionStartAt: '2024-01-01T00:00:00.000Z',
202
+ sessionEndAt: '2024-01-01T00:30:00.000Z',
203
+ sessionDuration: 1800000,
204
+ pageCount: 5,
205
+ totalActiveTime: 600000,
206
+ },
207
+ },
208
+ edgeContext: {
209
+ ipAddress: '192.168.1.100',
210
+ userAgent: 'Mozilla/5.0',
211
+ requestHeaders: { 'cf-connecting-ip': '192.168.1.100' },
212
+ cf: { country: 'US' },
213
+ },
214
+ },
215
+ ];
216
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, sessionEvents);
217
+ expect(bundledMessage).toMatchObject({
218
+ messageId: expect.any(String),
219
+ messageType: 'SESSION_EVENT_COLLECT',
220
+ messageTime: expect.any(String),
221
+ messageBody: {
222
+ v: 1,
223
+ c: 'gzip',
224
+ n: 1,
225
+ p: expect.any(String),
226
+ s: expect.any(Number),
227
+ },
228
+ });
229
+ });
230
+ it('consumer unbundleRecords extracts items matching SessionCollectMessage', async () => {
231
+ const originalItems = [
232
+ {
233
+ pixelId: 'px_sess_001',
234
+ id: 'sess_record_001',
235
+ sessionEvent: {
236
+ id: 'sess_record_001',
237
+ type: 'session',
238
+ name: 'session_start',
239
+ version: '1.0',
240
+ pixelId: 'px_sess_001',
241
+ sessionId: 'sess_abc123',
242
+ context: {
243
+ identity: { identityId: 'identity_001' },
244
+ properties: {
245
+ sessionId: 'sess_abc123',
246
+ userAgent: 'Chrome/120',
247
+ ipAddress: '10.0.0.100',
248
+ },
249
+ },
250
+ data: {
251
+ messageId: 'msg_sess_001',
252
+ pixelId_sessionId: 'px_sess_001_sess_abc123',
253
+ isFinal: false,
254
+ sessionStartAt: '2024-01-15T10:00:00.000Z',
255
+ landingPage: '/home',
256
+ returnTier: 'new',
257
+ },
258
+ },
259
+ edgeContext: {
260
+ ipAddress: '10.0.0.100',
261
+ userAgent: 'Chrome/120',
262
+ requestHeaders: {},
263
+ cf: { country: 'CA', region: 'ON', city: 'Toronto' },
264
+ },
265
+ },
266
+ {
267
+ pixelId: 'px_sess_002',
268
+ id: 'sess_record_002',
269
+ sessionEvent: {
270
+ id: 'sess_record_002',
271
+ type: 'session',
272
+ name: 'session_end',
273
+ pixelId: 'px_sess_002',
274
+ sessionId: 'sess_xyz789',
275
+ data: {
276
+ isFinal: true,
277
+ sessionDuration: 300000,
278
+ pageCount: 3,
279
+ endReason: 'timeout',
280
+ },
281
+ },
282
+ },
283
+ ];
284
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, originalItems);
285
+ const serialized = JSON.stringify(bundledMessage);
286
+ const sqsRecord = createSQSRecord(serialized);
287
+ const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
288
+ expect(result.items).toHaveLength(2);
289
+ expect(result.failedMessageIds).toHaveLength(0);
290
+ expect(result.stats.bundledSqsRecords).toBe(1);
291
+ expect(result.stats.totalItems).toBe(2);
292
+ const item1 = result.items[0];
293
+ expect(item1.pixelId).toBe('px_sess_001');
294
+ expect(item1.sessionEvent).toBeDefined();
295
+ expect(item1.sessionEvent.name).toBe('session_start');
296
+ expect(item1.sessionEvent.sessionId).toBe('sess_abc123');
297
+ expect(item1.sessionEvent.data?.landingPage).toBe('/home');
298
+ expect(item1.edgeContext?.cf?.country).toBe('CA');
299
+ const item2 = result.items[1];
300
+ expect(item2.pixelId).toBe('px_sess_002');
301
+ expect(item2.sessionEvent.name).toBe('session_end');
302
+ expect(item2.sessionEvent.data?.isFinal).toBe(true);
303
+ expect(item2.sessionEvent.data?.endReason).toBe('timeout');
304
+ });
305
+ it('consumer validates required sessionEvent field exists', async () => {
306
+ const items = [
307
+ {
308
+ pixelId: 'px_valid_session',
309
+ sessionEvent: {
310
+ name: 'session_update',
311
+ pixelId: 'px_valid_session',
312
+ sessionId: 'sess_valid',
313
+ },
314
+ },
315
+ ];
316
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, items);
317
+ const serialized = JSON.stringify(bundledMessage);
318
+ const sqsRecord = createSQSRecord(serialized);
319
+ const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
320
+ expect(result.items).toHaveLength(1);
321
+ expect(result.items[0].sessionEvent).toBeDefined();
322
+ expect(result.items[0].sessionEvent.sessionId).toBe('sess_valid');
323
+ });
324
+ });
325
+ describe('LOG_EVENT_COLLECT Contract', () => {
326
+ it('producer creates valid InternalSQSMessage<BundledEnvelope> structure', async () => {
327
+ const logEvents = [
328
+ {
329
+ pixelId: 'px_log_001',
330
+ logEvent: {
331
+ name: 'error',
332
+ type: 'client_error',
333
+ message: 'Failed to load resource',
334
+ stack: 'Error at line 42',
335
+ },
336
+ requestHeaders: { 'user-agent': 'Chrome/120' },
337
+ },
338
+ ];
339
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, logEvents);
340
+ expect(bundledMessage).toMatchObject({
341
+ messageId: expect.any(String),
342
+ messageType: 'LOG_EVENT_COLLECT',
343
+ messageTime: expect.any(String),
344
+ messageBody: {
345
+ v: 1,
346
+ c: 'gzip',
347
+ n: 1,
348
+ p: expect.any(String),
349
+ s: expect.any(Number),
350
+ },
351
+ });
352
+ });
353
+ it('consumer unbundleRecords extracts items matching LogCollectMessage', async () => {
354
+ const originalItems = [
355
+ {
356
+ pixelId: 'px_log_001',
357
+ logEvent: {
358
+ name: 'performance',
359
+ type: 'web_vital',
360
+ metric: 'LCP',
361
+ value: 2500,
362
+ timestamp: Date.now(),
363
+ },
364
+ requestHeaders: {
365
+ 'user-agent': 'Safari/17',
366
+ 'cf-connecting-ip': '172.16.0.1',
367
+ },
368
+ },
369
+ {
370
+ pixelId: 'px_log_002',
371
+ _encrypted: 'encrypted_log_payload',
372
+ },
373
+ {
374
+ pixelId: 'px_log_003',
375
+ logEvent: {
376
+ name: 'debug',
377
+ type: 'pixel_init',
378
+ data: { version: '2.1.0', config: { trackClicks: true } },
379
+ },
380
+ },
381
+ ];
382
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, originalItems);
383
+ const serialized = JSON.stringify(bundledMessage);
384
+ const sqsRecord = createSQSRecord(serialized);
385
+ const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
386
+ expect(result.items).toHaveLength(3);
387
+ expect(result.failedMessageIds).toHaveLength(0);
388
+ expect(result.stats.bundledSqsRecords).toBe(1);
389
+ expect(result.stats.totalItems).toBe(3);
390
+ const item1 = result.items[0];
391
+ expect(item1.pixelId).toBe('px_log_001');
392
+ expect(item1.logEvent?.name).toBe('performance');
393
+ expect(item1.logEvent?.metric).toBe('LCP');
394
+ expect(item1.requestHeaders?.['user-agent']).toBe('Safari/17');
395
+ const item2 = result.items[1];
396
+ expect(item2.pixelId).toBe('px_log_002');
397
+ expect(item2._encrypted).toBe('encrypted_log_payload');
398
+ const item3 = result.items[2];
399
+ expect(item3.pixelId).toBe('px_log_003');
400
+ expect(item3.logEvent?.type).toBe('pixel_init');
401
+ });
402
+ });
403
+ describe('Cross-Queue Contract Consistency', () => {
404
+ it('all message types use identical BundledEnvelope structure', async () => {
405
+ const trackingMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [{ pixelId: 'px1' }]);
406
+ const sessionMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, [
407
+ { pixelId: 'px2', sessionEvent: { name: 'test' } },
408
+ ]);
409
+ const logMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, [{ pixelId: 'px3' }]);
410
+ const envelopeKeys = ['c', 'n', 'p', 's', 'v'];
411
+ expect(Object.keys(trackingMessage.messageBody).sort()).toEqual(envelopeKeys);
412
+ expect(Object.keys(sessionMessage.messageBody).sort()).toEqual(envelopeKeys);
413
+ expect(Object.keys(logMessage.messageBody).sort()).toEqual(envelopeKeys);
414
+ expect(trackingMessage.messageBody.v).toBe(1);
415
+ expect(trackingMessage.messageBody.c).toBe('gzip');
416
+ expect(sessionMessage.messageBody.v).toBe(1);
417
+ expect(sessionMessage.messageBody.c).toBe('gzip');
418
+ expect(logMessage.messageBody.v).toBe(1);
419
+ expect(logMessage.messageBody.c).toBe('gzip');
420
+ });
421
+ it('all message types use identical InternalSQSMessage wrapper structure', async () => {
422
+ const trackingMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [{ pixelId: 'px1' }]);
423
+ const sessionMessage = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, [
424
+ { pixelId: 'px2', sessionEvent: { name: 'test' } },
425
+ ]);
426
+ const logMessage = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, [{ pixelId: 'px3' }]);
427
+ const wrapperKeys = ['messageBody', 'messageId', 'messageTime', 'messageType'];
428
+ expect(Object.keys(trackingMessage).sort()).toEqual(wrapperKeys);
429
+ expect(Object.keys(sessionMessage).sort()).toEqual(wrapperKeys);
430
+ expect(Object.keys(logMessage).sort()).toEqual(wrapperKeys);
431
+ expect([
432
+ MESSAGE_TYPES.TRACKING_EVENT_COLLECT,
433
+ MESSAGE_TYPES.SESSION_EVENT_COLLECT,
434
+ MESSAGE_TYPES.LOG_EVENT_COLLECT,
435
+ ]).toContain(trackingMessage.messageType);
436
+ expect([
437
+ MESSAGE_TYPES.TRACKING_EVENT_COLLECT,
438
+ MESSAGE_TYPES.SESSION_EVENT_COLLECT,
439
+ MESSAGE_TYPES.LOG_EVENT_COLLECT,
440
+ ]).toContain(sessionMessage.messageType);
441
+ expect([
442
+ MESSAGE_TYPES.TRACKING_EVENT_COLLECT,
443
+ MESSAGE_TYPES.SESSION_EVENT_COLLECT,
444
+ MESSAGE_TYPES.LOG_EVENT_COLLECT,
445
+ ]).toContain(logMessage.messageType);
446
+ });
447
+ it('unbundleRecords handles all message types uniformly', async () => {
448
+ const tracking = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [
449
+ { pixelId: 'px_t1', trackingEvent: { name: 'PageView' } },
450
+ { pixelId: 'px_t2', trackingEvent: { name: 'AddToCart' } },
451
+ ]);
452
+ const session = await createBundledMessage(MESSAGE_TYPES.SESSION_EVENT_COLLECT, [
453
+ { pixelId: 'px_s1', sessionEvent: { name: 'session_start' } },
454
+ ]);
455
+ const log = await createBundledMessage(MESSAGE_TYPES.LOG_EVENT_COLLECT, [
456
+ { pixelId: 'px_l1', logEvent: { name: 'error' } },
457
+ { pixelId: 'px_l2', logEvent: { name: 'debug' } },
458
+ { pixelId: 'px_l3', logEvent: { name: 'info' } },
459
+ ]);
460
+ const records = [
461
+ createSQSRecord(JSON.stringify(tracking), 'msg-tracking'),
462
+ createSQSRecord(JSON.stringify(session), 'msg-session'),
463
+ createSQSRecord(JSON.stringify(log), 'msg-log'),
464
+ ];
465
+ const result = await (0, sqs_unbundle_1.unbundleRecords)(records);
466
+ expect(result.failedMessageIds).toHaveLength(0);
467
+ expect(result.stats.bundledSqsRecords).toBe(3);
468
+ expect(result.stats.totalItems).toBe(6);
469
+ expect(result.items).toHaveLength(6);
470
+ const pixelIds = result.items.map((item) => item.pixelId);
471
+ expect(pixelIds).toContain('px_t1');
472
+ expect(pixelIds).toContain('px_t2');
473
+ expect(pixelIds).toContain('px_s1');
474
+ expect(pixelIds).toContain('px_l1');
475
+ expect(pixelIds).toContain('px_l2');
476
+ expect(pixelIds).toContain('px_l3');
477
+ });
478
+ });
479
+ describe('Edge Cases and Error Handling', () => {
480
+ it('handles empty bundle gracefully', async () => {
481
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, []);
482
+ const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
483
+ const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
484
+ expect(result.items).toHaveLength(0);
485
+ expect(result.failedMessageIds).toHaveLength(0);
486
+ expect(result.stats.bundledSqsRecords).toBe(1);
487
+ expect(result.stats.totalItems).toBe(0);
488
+ });
489
+ it('handles mixed bundled and legacy records in same batch', async () => {
490
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [
491
+ { pixelId: 'px_bundled_1' },
492
+ { pixelId: 'px_bundled_2' },
493
+ ]);
494
+ const legacyItem = { pixelId: 'px_legacy' };
495
+ const records = [
496
+ createSQSRecord(JSON.stringify(bundledMessage), 'msg-bundled'),
497
+ createSQSRecord(JSON.stringify(legacyItem), 'msg-legacy'),
498
+ ];
499
+ const result = await (0, sqs_unbundle_1.unbundleRecords)(records);
500
+ expect(result.items).toHaveLength(3);
501
+ expect(result.stats.bundledSqsRecords).toBe(1);
502
+ expect(result.stats.legacySqsRecords).toBe(1);
503
+ expect(result.stats.totalItems).toBe(3);
504
+ const pixelIds = result.items.map((item) => item.pixelId);
505
+ expect(pixelIds).toContain('px_bundled_1');
506
+ expect(pixelIds).toContain('px_bundled_2');
507
+ expect(pixelIds).toContain('px_legacy');
508
+ });
509
+ it('preserves exact item data through bundle/unbundle cycle', async () => {
510
+ const complexItem = {
511
+ pixelId: 'px_complex',
512
+ id: 'evt_complex',
513
+ dd: 1234567890,
514
+ trackingEvent: {
515
+ name: 'Purchase',
516
+ eventName: 'purchase',
517
+ context: {
518
+ properties: {
519
+ sessionId: 'sess_xyz',
520
+ page: { path: '/checkout/success', title: 'Order Complete' },
521
+ device: { type: 'mobile', os: 'iOS', browser: 'Safari' },
522
+ },
523
+ },
524
+ data: {
525
+ orderId: 'order_12345',
526
+ value: 199.99,
527
+ currency: 'USD',
528
+ items: [
529
+ { sku: 'SKU001', name: 'Widget', quantity: 2, price: 49.99 },
530
+ { sku: 'SKU002', name: 'Gadget', quantity: 1, price: 100.01 },
531
+ ],
532
+ },
533
+ },
534
+ edgeContext: {
535
+ ipAddress: '2001:db8::1',
536
+ userAgent: 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0)',
537
+ requestHeaders: {
538
+ 'cf-connecting-ip': '2001:db8::1',
539
+ 'cf-ipcountry': 'US',
540
+ 'user-agent': 'Mozilla/5.0 (iPhone; CPU iPhone OS 17_0)',
541
+ 'accept-language': 'en-US,en;q=0.9',
542
+ },
543
+ cf: {
544
+ country: 'US',
545
+ region: 'CA',
546
+ city: 'San Francisco',
547
+ colo: 'SJC',
548
+ timezone: 'America/Los_Angeles',
549
+ },
550
+ },
551
+ };
552
+ const bundledMessage = await createBundledMessage(MESSAGE_TYPES.TRACKING_EVENT_COLLECT, [complexItem]);
553
+ const sqsRecord = createSQSRecord(JSON.stringify(bundledMessage));
554
+ const result = await (0, sqs_unbundle_1.unbundleRecords)([sqsRecord]);
555
+ expect(result.items).toHaveLength(1);
556
+ const extracted = result.items[0];
557
+ expect(extracted).toEqual(complexItem);
558
+ expect(extracted.trackingEvent?.data?.items).toHaveLength(2);
559
+ expect(extracted?.trackingEvent?.data && (extracted?.trackingEvent?.data?.items)[0]?.sku).toBe('SKU001');
560
+ expect(extracted.edgeContext?.cf?.timezone).toBe('America/Los_Angeles');
561
+ });
562
+ });
563
+ });
564
564
  //# sourceMappingURL=sqs-bundling-contracts.spec.js.map