@aws-amplify/analytics 0.0.0-unstable-1ca644b-20260128091132

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 (456) hide show
  1. package/README.md +3 -0
  2. package/dist/cjs/apis/disable.js +16 -0
  3. package/dist/cjs/apis/disable.js.map +1 -0
  4. package/dist/cjs/apis/enable.js +15 -0
  5. package/dist/cjs/apis/enable.js.map +1 -0
  6. package/dist/cjs/apis/index.js +11 -0
  7. package/dist/cjs/apis/index.js.map +1 -0
  8. package/dist/cjs/errors/AnalyticsError.js +21 -0
  9. package/dist/cjs/errors/AnalyticsError.js.map +1 -0
  10. package/dist/cjs/errors/assertValidationError.js +22 -0
  11. package/dist/cjs/errors/assertValidationError.js.map +1 -0
  12. package/dist/cjs/errors/index.js +14 -0
  13. package/dist/cjs/errors/index.js.map +1 -0
  14. package/dist/cjs/errors/validation.js +44 -0
  15. package/dist/cjs/errors/validation.js.map +1 -0
  16. package/dist/cjs/index.js +17 -0
  17. package/dist/cjs/index.js.map +1 -0
  18. package/dist/cjs/providers/kinesis/apis/flushEvents.js +39 -0
  19. package/dist/cjs/providers/kinesis/apis/flushEvents.js.map +1 -0
  20. package/dist/cjs/providers/kinesis/apis/index.js +11 -0
  21. package/dist/cjs/providers/kinesis/apis/index.js.map +1 -0
  22. package/dist/cjs/providers/kinesis/apis/record.js +69 -0
  23. package/dist/cjs/providers/kinesis/apis/record.js.map +1 -0
  24. package/dist/cjs/providers/kinesis/index.js +10 -0
  25. package/dist/cjs/providers/kinesis/index.js.map +1 -0
  26. package/dist/cjs/providers/kinesis/types/buffer.js +6 -0
  27. package/dist/cjs/providers/kinesis/types/buffer.js.map +1 -0
  28. package/dist/cjs/providers/kinesis/types/index.js +6 -0
  29. package/dist/cjs/providers/kinesis/types/index.js.map +1 -0
  30. package/dist/cjs/providers/kinesis/types/inputs.js +6 -0
  31. package/dist/cjs/providers/kinesis/types/inputs.js.map +1 -0
  32. package/dist/cjs/providers/kinesis/utils/constants.js +13 -0
  33. package/dist/cjs/providers/kinesis/utils/constants.js.map +1 -0
  34. package/dist/cjs/providers/kinesis/utils/getEventBuffer.js +85 -0
  35. package/dist/cjs/providers/kinesis/utils/getEventBuffer.js.map +1 -0
  36. package/dist/cjs/providers/kinesis/utils/resolveConfig.js +27 -0
  37. package/dist/cjs/providers/kinesis/utils/resolveConfig.js.map +1 -0
  38. package/dist/cjs/providers/kinesis-firehose/apis/flushEvents.js +38 -0
  39. package/dist/cjs/providers/kinesis-firehose/apis/flushEvents.js.map +1 -0
  40. package/dist/cjs/providers/kinesis-firehose/apis/index.js +11 -0
  41. package/dist/cjs/providers/kinesis-firehose/apis/index.js.map +1 -0
  42. package/dist/cjs/providers/kinesis-firehose/apis/record.js +62 -0
  43. package/dist/cjs/providers/kinesis-firehose/apis/record.js.map +1 -0
  44. package/dist/cjs/providers/kinesis-firehose/index.js +10 -0
  45. package/dist/cjs/providers/kinesis-firehose/index.js.map +1 -0
  46. package/dist/cjs/providers/kinesis-firehose/types/buffer.js +6 -0
  47. package/dist/cjs/providers/kinesis-firehose/types/buffer.js.map +1 -0
  48. package/dist/cjs/providers/kinesis-firehose/types/index.js +6 -0
  49. package/dist/cjs/providers/kinesis-firehose/types/index.js.map +1 -0
  50. package/dist/cjs/providers/kinesis-firehose/types/inputs.js +6 -0
  51. package/dist/cjs/providers/kinesis-firehose/types/inputs.js.map +1 -0
  52. package/dist/cjs/providers/kinesis-firehose/utils/constants.js +13 -0
  53. package/dist/cjs/providers/kinesis-firehose/utils/constants.js.map +1 -0
  54. package/dist/cjs/providers/kinesis-firehose/utils/getEventBuffer.js +83 -0
  55. package/dist/cjs/providers/kinesis-firehose/utils/getEventBuffer.js.map +1 -0
  56. package/dist/cjs/providers/kinesis-firehose/utils/index.js +11 -0
  57. package/dist/cjs/providers/kinesis-firehose/utils/index.js.map +1 -0
  58. package/dist/cjs/providers/kinesis-firehose/utils/resolveConfig.js +27 -0
  59. package/dist/cjs/providers/kinesis-firehose/utils/resolveConfig.js.map +1 -0
  60. package/dist/cjs/providers/personalize/apis/flushEvents.js +37 -0
  61. package/dist/cjs/providers/personalize/apis/flushEvents.js.map +1 -0
  62. package/dist/cjs/providers/personalize/apis/index.js +11 -0
  63. package/dist/cjs/providers/personalize/apis/index.js.map +1 -0
  64. package/dist/cjs/providers/personalize/apis/record.js +98 -0
  65. package/dist/cjs/providers/personalize/apis/record.js.map +1 -0
  66. package/dist/cjs/providers/personalize/index.js +10 -0
  67. package/dist/cjs/providers/personalize/index.js.map +1 -0
  68. package/dist/cjs/providers/personalize/types/buffer.js +6 -0
  69. package/dist/cjs/providers/personalize/types/buffer.js.map +1 -0
  70. package/dist/cjs/providers/personalize/types/index.js +6 -0
  71. package/dist/cjs/providers/personalize/types/index.js.map +1 -0
  72. package/dist/cjs/providers/personalize/types/inputs.js +6 -0
  73. package/dist/cjs/providers/personalize/types/inputs.js.map +1 -0
  74. package/dist/cjs/providers/personalize/utils/autoTrackMedia.js +183 -0
  75. package/dist/cjs/providers/personalize/utils/autoTrackMedia.js.map +1 -0
  76. package/dist/cjs/providers/personalize/utils/cachedSession.js +51 -0
  77. package/dist/cjs/providers/personalize/utils/cachedSession.js.map +1 -0
  78. package/dist/cjs/providers/personalize/utils/constants.js +14 -0
  79. package/dist/cjs/providers/personalize/utils/constants.js.map +1 -0
  80. package/dist/cjs/providers/personalize/utils/getEventBuffer.js +86 -0
  81. package/dist/cjs/providers/personalize/utils/getEventBuffer.js.map +1 -0
  82. package/dist/cjs/providers/personalize/utils/index.js +19 -0
  83. package/dist/cjs/providers/personalize/utils/index.js.map +1 -0
  84. package/dist/cjs/providers/personalize/utils/resolveConfig.js +28 -0
  85. package/dist/cjs/providers/personalize/utils/resolveConfig.js.map +1 -0
  86. package/dist/cjs/providers/pinpoint/apis/configureAutoTrack.js +39 -0
  87. package/dist/cjs/providers/pinpoint/apis/configureAutoTrack.js.map +1 -0
  88. package/dist/cjs/providers/pinpoint/apis/flushEvents.js +43 -0
  89. package/dist/cjs/providers/pinpoint/apis/flushEvents.js.map +1 -0
  90. package/dist/cjs/providers/pinpoint/apis/identifyUser.js +75 -0
  91. package/dist/cjs/providers/pinpoint/apis/identifyUser.js.map +1 -0
  92. package/dist/cjs/providers/pinpoint/apis/index.js +15 -0
  93. package/dist/cjs/providers/pinpoint/apis/index.js.map +1 -0
  94. package/dist/cjs/providers/pinpoint/apis/record.js +74 -0
  95. package/dist/cjs/providers/pinpoint/apis/record.js.map +1 -0
  96. package/dist/cjs/providers/pinpoint/index.js +12 -0
  97. package/dist/cjs/providers/pinpoint/index.js.map +1 -0
  98. package/dist/cjs/providers/pinpoint/types/index.js +6 -0
  99. package/dist/cjs/providers/pinpoint/types/index.js.map +1 -0
  100. package/dist/cjs/providers/pinpoint/types/inputs.js +6 -0
  101. package/dist/cjs/providers/pinpoint/types/inputs.js.map +1 -0
  102. package/dist/cjs/providers/pinpoint/types/options.js +6 -0
  103. package/dist/cjs/providers/pinpoint/types/options.js.map +1 -0
  104. package/dist/cjs/providers/pinpoint/utils/index.js +11 -0
  105. package/dist/cjs/providers/pinpoint/utils/index.js.map +1 -0
  106. package/dist/cjs/providers/pinpoint/utils/resolveConfig.js +19 -0
  107. package/dist/cjs/providers/pinpoint/utils/resolveConfig.js.map +1 -0
  108. package/dist/cjs/providers/pinpoint/utils/resolveCredentials.js +18 -0
  109. package/dist/cjs/providers/pinpoint/utils/resolveCredentials.js.map +1 -0
  110. package/dist/cjs/trackers/EventTracker.js +100 -0
  111. package/dist/cjs/trackers/EventTracker.js.map +1 -0
  112. package/dist/cjs/trackers/PageViewTracker.js +112 -0
  113. package/dist/cjs/trackers/PageViewTracker.js.map +1 -0
  114. package/dist/cjs/trackers/SessionTracker.js +69 -0
  115. package/dist/cjs/trackers/SessionTracker.js.map +1 -0
  116. package/dist/cjs/trackers/SessionTracker.native.js +69 -0
  117. package/dist/cjs/trackers/SessionTracker.native.js.map +1 -0
  118. package/dist/cjs/trackers/index.js +13 -0
  119. package/dist/cjs/trackers/index.js.map +1 -0
  120. package/dist/cjs/types/index.js +6 -0
  121. package/dist/cjs/types/index.js.map +1 -0
  122. package/dist/cjs/types/inputs.js +6 -0
  123. package/dist/cjs/types/inputs.js.map +1 -0
  124. package/dist/cjs/types/kinesis.js +6 -0
  125. package/dist/cjs/types/kinesis.js.map +1 -0
  126. package/dist/cjs/types/options.js +6 -0
  127. package/dist/cjs/types/options.js.map +1 -0
  128. package/dist/cjs/types/trackers.js +6 -0
  129. package/dist/cjs/types/trackers.js.map +1 -0
  130. package/dist/cjs/utils/eventBuffer/EventBuffer.js +65 -0
  131. package/dist/cjs/utils/eventBuffer/EventBuffer.js.map +1 -0
  132. package/dist/cjs/utils/eventBuffer/index.js +9 -0
  133. package/dist/cjs/utils/eventBuffer/index.js.map +1 -0
  134. package/dist/cjs/utils/eventBuffer/types.js +6 -0
  135. package/dist/cjs/utils/eventBuffer/types.js.map +1 -0
  136. package/dist/cjs/utils/groupBy.js +14 -0
  137. package/dist/cjs/utils/groupBy.js.map +1 -0
  138. package/dist/cjs/utils/index.js +24 -0
  139. package/dist/cjs/utils/index.js.map +1 -0
  140. package/dist/cjs/utils/resolveCredentials.js +15 -0
  141. package/dist/cjs/utils/resolveCredentials.js.map +1 -0
  142. package/dist/cjs/utils/statusHelpers.js +21 -0
  143. package/dist/cjs/utils/statusHelpers.js.map +1 -0
  144. package/dist/cjs/utils/trackerConfigHelpers.js +17 -0
  145. package/dist/cjs/utils/trackerConfigHelpers.js.map +1 -0
  146. package/dist/cjs/utils/trackerConfigHelpers.native.js +16 -0
  147. package/dist/cjs/utils/trackerConfigHelpers.native.js.map +1 -0
  148. package/dist/cjs/utils/trackerHelpers.js +46 -0
  149. package/dist/cjs/utils/trackerHelpers.js.map +1 -0
  150. package/dist/cjs/utils/userAgent.js +21 -0
  151. package/dist/cjs/utils/userAgent.js.map +1 -0
  152. package/dist/esm/apis/disable.d.ts +8 -0
  153. package/dist/esm/apis/disable.mjs +22 -0
  154. package/dist/esm/apis/disable.mjs.map +1 -0
  155. package/dist/esm/apis/enable.d.ts +7 -0
  156. package/dist/esm/apis/enable.mjs +21 -0
  157. package/dist/esm/apis/enable.mjs.map +1 -0
  158. package/dist/esm/apis/index.d.ts +2 -0
  159. package/dist/esm/apis/index.mjs +3 -0
  160. package/dist/esm/apis/index.mjs.map +1 -0
  161. package/dist/esm/errors/AnalyticsError.d.ts +7 -0
  162. package/dist/esm/errors/AnalyticsError.mjs +19 -0
  163. package/dist/esm/errors/AnalyticsError.mjs.map +1 -0
  164. package/dist/esm/errors/assertValidationError.d.ts +5 -0
  165. package/dist/esm/errors/assertValidationError.mjs +21 -0
  166. package/dist/esm/errors/assertValidationError.mjs.map +1 -0
  167. package/dist/esm/errors/index.d.ts +3 -0
  168. package/dist/esm/errors/index.mjs +4 -0
  169. package/dist/esm/errors/index.mjs.map +1 -0
  170. package/dist/esm/errors/validation.d.ts +12 -0
  171. package/dist/esm/errors/validation.mjs +42 -0
  172. package/dist/esm/errors/validation.mjs.map +1 -0
  173. package/dist/esm/index.d.ts +3 -0
  174. package/dist/esm/index.mjs +9 -0
  175. package/dist/esm/index.mjs.map +1 -0
  176. package/dist/esm/providers/kinesis/apis/flushEvents.d.ts +8 -0
  177. package/dist/esm/providers/kinesis/apis/flushEvents.mjs +43 -0
  178. package/dist/esm/providers/kinesis/apis/flushEvents.mjs.map +1 -0
  179. package/dist/esm/providers/kinesis/apis/index.d.ts +2 -0
  180. package/dist/esm/providers/kinesis/apis/index.mjs +3 -0
  181. package/dist/esm/providers/kinesis/apis/index.mjs.map +1 -0
  182. package/dist/esm/providers/kinesis/apis/record.d.ts +23 -0
  183. package/dist/esm/providers/kinesis/apis/record.mjs +74 -0
  184. package/dist/esm/providers/kinesis/apis/record.mjs.map +1 -0
  185. package/dist/esm/providers/kinesis/index.d.ts +1 -0
  186. package/dist/esm/providers/kinesis/index.mjs +3 -0
  187. package/dist/esm/providers/kinesis/index.mjs.map +1 -0
  188. package/dist/esm/providers/kinesis/types/buffer.d.ts +15 -0
  189. package/dist/esm/providers/kinesis/types/buffer.mjs +2 -0
  190. package/dist/esm/providers/kinesis/types/buffer.mjs.map +1 -0
  191. package/dist/esm/providers/kinesis/types/index.d.ts +2 -0
  192. package/dist/esm/providers/kinesis/types/index.mjs +2 -0
  193. package/dist/esm/providers/kinesis/types/index.mjs.map +1 -0
  194. package/dist/esm/providers/kinesis/types/inputs.d.ts +6 -0
  195. package/dist/esm/providers/kinesis/types/inputs.mjs +2 -0
  196. package/dist/esm/providers/kinesis/types/inputs.mjs.map +1 -0
  197. package/dist/esm/providers/kinesis/utils/constants.d.ts +6 -0
  198. package/dist/esm/providers/kinesis/utils/constants.mjs +11 -0
  199. package/dist/esm/providers/kinesis/utils/constants.mjs.map +1 -0
  200. package/dist/esm/providers/kinesis/utils/getEventBuffer.d.ts +3 -0
  201. package/dist/esm/providers/kinesis/utils/getEventBuffer.mjs +89 -0
  202. package/dist/esm/providers/kinesis/utils/getEventBuffer.mjs.map +1 -0
  203. package/dist/esm/providers/kinesis/utils/resolveConfig.d.ts +7 -0
  204. package/dist/esm/providers/kinesis/utils/resolveConfig.mjs +27 -0
  205. package/dist/esm/providers/kinesis/utils/resolveConfig.mjs.map +1 -0
  206. package/dist/esm/providers/kinesis-firehose/apis/flushEvents.d.ts +8 -0
  207. package/dist/esm/providers/kinesis-firehose/apis/flushEvents.mjs +43 -0
  208. package/dist/esm/providers/kinesis-firehose/apis/flushEvents.mjs.map +1 -0
  209. package/dist/esm/providers/kinesis-firehose/apis/index.d.ts +2 -0
  210. package/dist/esm/providers/kinesis-firehose/apis/index.mjs +3 -0
  211. package/dist/esm/providers/kinesis-firehose/apis/index.mjs.map +1 -0
  212. package/dist/esm/providers/kinesis-firehose/apis/record.d.ts +19 -0
  213. package/dist/esm/providers/kinesis-firehose/apis/record.mjs +68 -0
  214. package/dist/esm/providers/kinesis-firehose/apis/record.mjs.map +1 -0
  215. package/dist/esm/providers/kinesis-firehose/index.d.ts +1 -0
  216. package/dist/esm/providers/kinesis-firehose/index.mjs +3 -0
  217. package/dist/esm/providers/kinesis-firehose/index.mjs.map +1 -0
  218. package/dist/esm/providers/kinesis-firehose/types/buffer.d.ts +15 -0
  219. package/dist/esm/providers/kinesis-firehose/types/buffer.mjs +2 -0
  220. package/dist/esm/providers/kinesis-firehose/types/buffer.mjs.map +1 -0
  221. package/dist/esm/providers/kinesis-firehose/types/index.d.ts +2 -0
  222. package/dist/esm/providers/kinesis-firehose/types/index.mjs +2 -0
  223. package/dist/esm/providers/kinesis-firehose/types/index.mjs.map +1 -0
  224. package/dist/esm/providers/kinesis-firehose/types/inputs.d.ts +5 -0
  225. package/dist/esm/providers/kinesis-firehose/types/inputs.mjs +2 -0
  226. package/dist/esm/providers/kinesis-firehose/types/inputs.mjs.map +1 -0
  227. package/dist/esm/providers/kinesis-firehose/utils/constants.d.ts +6 -0
  228. package/dist/esm/providers/kinesis-firehose/utils/constants.mjs +11 -0
  229. package/dist/esm/providers/kinesis-firehose/utils/constants.mjs.map +1 -0
  230. package/dist/esm/providers/kinesis-firehose/utils/getEventBuffer.d.ts +3 -0
  231. package/dist/esm/providers/kinesis-firehose/utils/getEventBuffer.mjs +87 -0
  232. package/dist/esm/providers/kinesis-firehose/utils/getEventBuffer.mjs.map +1 -0
  233. package/dist/esm/providers/kinesis-firehose/utils/index.d.ts +2 -0
  234. package/dist/esm/providers/kinesis-firehose/utils/index.mjs +3 -0
  235. package/dist/esm/providers/kinesis-firehose/utils/index.mjs.map +1 -0
  236. package/dist/esm/providers/kinesis-firehose/utils/resolveConfig.d.ts +7 -0
  237. package/dist/esm/providers/kinesis-firehose/utils/resolveConfig.mjs +27 -0
  238. package/dist/esm/providers/kinesis-firehose/utils/resolveConfig.mjs.map +1 -0
  239. package/dist/esm/providers/personalize/apis/flushEvents.d.ts +8 -0
  240. package/dist/esm/providers/personalize/apis/flushEvents.mjs +43 -0
  241. package/dist/esm/providers/personalize/apis/flushEvents.mjs.map +1 -0
  242. package/dist/esm/providers/personalize/apis/index.d.ts +2 -0
  243. package/dist/esm/providers/personalize/apis/index.mjs +3 -0
  244. package/dist/esm/providers/personalize/apis/index.mjs.map +1 -0
  245. package/dist/esm/providers/personalize/apis/record.d.ts +27 -0
  246. package/dist/esm/providers/personalize/apis/record.mjs +106 -0
  247. package/dist/esm/providers/personalize/apis/record.mjs.map +1 -0
  248. package/dist/esm/providers/personalize/index.d.ts +1 -0
  249. package/dist/esm/providers/personalize/index.mjs +3 -0
  250. package/dist/esm/providers/personalize/index.mjs.map +1 -0
  251. package/dist/esm/providers/personalize/types/buffer.d.ts +16 -0
  252. package/dist/esm/providers/personalize/types/buffer.mjs +2 -0
  253. package/dist/esm/providers/personalize/types/buffer.mjs.map +1 -0
  254. package/dist/esm/providers/personalize/types/index.d.ts +2 -0
  255. package/dist/esm/providers/personalize/types/index.mjs +2 -0
  256. package/dist/esm/providers/personalize/types/index.mjs.map +1 -0
  257. package/dist/esm/providers/personalize/types/inputs.d.ts +7 -0
  258. package/dist/esm/providers/personalize/types/inputs.mjs +2 -0
  259. package/dist/esm/providers/personalize/types/inputs.mjs.map +1 -0
  260. package/dist/esm/providers/personalize/utils/autoTrackMedia.d.ts +10 -0
  261. package/dist/esm/providers/personalize/utils/autoTrackMedia.mjs +181 -0
  262. package/dist/esm/providers/personalize/utils/autoTrackMedia.mjs.map +1 -0
  263. package/dist/esm/providers/personalize/utils/cachedSession.d.ts +5 -0
  264. package/dist/esm/providers/personalize/utils/cachedSession.mjs +48 -0
  265. package/dist/esm/providers/personalize/utils/cachedSession.mjs.map +1 -0
  266. package/dist/esm/providers/personalize/utils/constants.d.ts +7 -0
  267. package/dist/esm/providers/personalize/utils/constants.mjs +12 -0
  268. package/dist/esm/providers/personalize/utils/constants.mjs.map +1 -0
  269. package/dist/esm/providers/personalize/utils/getEventBuffer.d.ts +3 -0
  270. package/dist/esm/providers/personalize/utils/getEventBuffer.mjs +90 -0
  271. package/dist/esm/providers/personalize/utils/getEventBuffer.mjs.map +1 -0
  272. package/dist/esm/providers/personalize/utils/index.d.ts +5 -0
  273. package/dist/esm/providers/personalize/utils/index.mjs +6 -0
  274. package/dist/esm/providers/personalize/utils/index.mjs.map +1 -0
  275. package/dist/esm/providers/personalize/utils/resolveConfig.d.ts +7 -0
  276. package/dist/esm/providers/personalize/utils/resolveConfig.mjs +28 -0
  277. package/dist/esm/providers/personalize/utils/resolveConfig.mjs.map +1 -0
  278. package/dist/esm/providers/pinpoint/apis/configureAutoTrack.d.ts +17 -0
  279. package/dist/esm/providers/pinpoint/apis/configureAutoTrack.mjs +42 -0
  280. package/dist/esm/providers/pinpoint/apis/configureAutoTrack.mjs.map +1 -0
  281. package/dist/esm/providers/pinpoint/apis/flushEvents.d.ts +10 -0
  282. package/dist/esm/providers/pinpoint/apis/flushEvents.mjs +47 -0
  283. package/dist/esm/providers/pinpoint/apis/flushEvents.mjs.map +1 -0
  284. package/dist/esm/providers/pinpoint/apis/identifyUser.d.ts +49 -0
  285. package/dist/esm/providers/pinpoint/apis/identifyUser.mjs +80 -0
  286. package/dist/esm/providers/pinpoint/apis/identifyUser.mjs.map +1 -0
  287. package/dist/esm/providers/pinpoint/apis/index.d.ts +4 -0
  288. package/dist/esm/providers/pinpoint/apis/index.mjs +5 -0
  289. package/dist/esm/providers/pinpoint/apis/index.mjs.map +1 -0
  290. package/dist/esm/providers/pinpoint/apis/record.d.ts +32 -0
  291. package/dist/esm/providers/pinpoint/apis/record.mjs +79 -0
  292. package/dist/esm/providers/pinpoint/apis/record.mjs.map +1 -0
  293. package/dist/esm/providers/pinpoint/index.d.ts +2 -0
  294. package/dist/esm/providers/pinpoint/index.mjs +5 -0
  295. package/dist/esm/providers/pinpoint/index.mjs.map +1 -0
  296. package/dist/esm/providers/pinpoint/types/index.d.ts +2 -0
  297. package/dist/esm/providers/pinpoint/types/index.mjs +2 -0
  298. package/dist/esm/providers/pinpoint/types/index.mjs.map +1 -0
  299. package/dist/esm/providers/pinpoint/types/inputs.d.ts +15 -0
  300. package/dist/esm/providers/pinpoint/types/inputs.mjs +2 -0
  301. package/dist/esm/providers/pinpoint/types/inputs.mjs.map +1 -0
  302. package/dist/esm/providers/pinpoint/types/options.d.ts +5 -0
  303. package/dist/esm/providers/pinpoint/types/options.mjs +2 -0
  304. package/dist/esm/providers/pinpoint/types/options.mjs.map +1 -0
  305. package/dist/esm/providers/pinpoint/utils/index.d.ts +2 -0
  306. package/dist/esm/providers/pinpoint/utils/index.mjs +3 -0
  307. package/dist/esm/providers/pinpoint/utils/index.mjs.map +1 -0
  308. package/dist/esm/providers/pinpoint/utils/resolveConfig.d.ts +11 -0
  309. package/dist/esm/providers/pinpoint/utils/resolveConfig.mjs +19 -0
  310. package/dist/esm/providers/pinpoint/utils/resolveConfig.mjs.map +1 -0
  311. package/dist/esm/providers/pinpoint/utils/resolveCredentials.d.ts +7 -0
  312. package/dist/esm/providers/pinpoint/utils/resolveCredentials.mjs +18 -0
  313. package/dist/esm/providers/pinpoint/utils/resolveCredentials.mjs.map +1 -0
  314. package/dist/esm/trackers/EventTracker.d.ts +10 -0
  315. package/dist/esm/trackers/EventTracker.mjs +98 -0
  316. package/dist/esm/trackers/EventTracker.mjs.map +1 -0
  317. package/dist/esm/trackers/PageViewTracker.d.ts +18 -0
  318. package/dist/esm/trackers/PageViewTracker.mjs +110 -0
  319. package/dist/esm/trackers/PageViewTracker.mjs.map +1 -0
  320. package/dist/esm/trackers/SessionTracker.d.ts +13 -0
  321. package/dist/esm/trackers/SessionTracker.mjs +67 -0
  322. package/dist/esm/trackers/SessionTracker.mjs.map +1 -0
  323. package/dist/esm/trackers/SessionTracker.native.d.ts +13 -0
  324. package/dist/esm/trackers/SessionTracker.native.mjs +67 -0
  325. package/dist/esm/trackers/SessionTracker.native.mjs.map +1 -0
  326. package/dist/esm/trackers/index.d.ts +3 -0
  327. package/dist/esm/trackers/index.mjs +4 -0
  328. package/dist/esm/trackers/index.mjs.map +1 -0
  329. package/dist/esm/types/index.d.ts +3 -0
  330. package/dist/esm/types/index.mjs +2 -0
  331. package/dist/esm/types/index.mjs.map +1 -0
  332. package/dist/esm/types/inputs.d.ts +35 -0
  333. package/dist/esm/types/inputs.mjs +2 -0
  334. package/dist/esm/types/inputs.mjs.map +1 -0
  335. package/dist/esm/types/kinesis.d.ts +8 -0
  336. package/dist/esm/types/kinesis.mjs +2 -0
  337. package/dist/esm/types/kinesis.mjs.map +1 -0
  338. package/dist/esm/types/options.d.ts +4 -0
  339. package/dist/esm/types/options.mjs +2 -0
  340. package/dist/esm/types/options.mjs.map +1 -0
  341. package/dist/esm/types/trackers.d.ts +22 -0
  342. package/dist/esm/types/trackers.mjs +2 -0
  343. package/dist/esm/types/trackers.mjs.map +1 -0
  344. package/dist/esm/utils/eventBuffer/EventBuffer.d.ts +16 -0
  345. package/dist/esm/utils/eventBuffer/EventBuffer.mjs +63 -0
  346. package/dist/esm/utils/eventBuffer/EventBuffer.mjs.map +1 -0
  347. package/dist/esm/utils/eventBuffer/index.d.ts +2 -0
  348. package/dist/esm/utils/eventBuffer/index.mjs +2 -0
  349. package/dist/esm/utils/eventBuffer/index.mjs.map +1 -0
  350. package/dist/esm/utils/eventBuffer/types.d.ts +6 -0
  351. package/dist/esm/utils/eventBuffer/types.mjs +2 -0
  352. package/dist/esm/utils/eventBuffer/types.mjs.map +1 -0
  353. package/dist/esm/utils/groupBy.d.ts +1 -0
  354. package/dist/esm/utils/groupBy.mjs +11 -0
  355. package/dist/esm/utils/groupBy.mjs.map +1 -0
  356. package/dist/esm/utils/index.d.ts +7 -0
  357. package/dist/esm/utils/index.mjs +8 -0
  358. package/dist/esm/utils/index.mjs.map +1 -0
  359. package/dist/esm/utils/resolveCredentials.d.ts +4 -0
  360. package/dist/esm/utils/resolveCredentials.mjs +15 -0
  361. package/dist/esm/utils/resolveCredentials.mjs.map +1 -0
  362. package/dist/esm/utils/statusHelpers.d.ts +6 -0
  363. package/dist/esm/utils/statusHelpers.mjs +16 -0
  364. package/dist/esm/utils/statusHelpers.mjs.map +1 -0
  365. package/dist/esm/utils/trackerConfigHelpers.d.ts +5 -0
  366. package/dist/esm/utils/trackerConfigHelpers.mjs +17 -0
  367. package/dist/esm/utils/trackerConfigHelpers.mjs.map +1 -0
  368. package/dist/esm/utils/trackerConfigHelpers.native.d.ts +5 -0
  369. package/dist/esm/utils/trackerConfigHelpers.native.mjs +16 -0
  370. package/dist/esm/utils/trackerConfigHelpers.native.mjs.map +1 -0
  371. package/dist/esm/utils/trackerHelpers.d.ts +9 -0
  372. package/dist/esm/utils/trackerHelpers.mjs +46 -0
  373. package/dist/esm/utils/trackerHelpers.mjs.map +1 -0
  374. package/dist/esm/utils/userAgent.d.ts +4 -0
  375. package/dist/esm/utils/userAgent.mjs +19 -0
  376. package/dist/esm/utils/userAgent.mjs.map +1 -0
  377. package/kinesis/package.json +8 -0
  378. package/kinesis-firehose/package.json +8 -0
  379. package/package.json +110 -0
  380. package/personalize/package.json +8 -0
  381. package/pinpoint/package.json +8 -0
  382. package/src/apis/disable.ts +13 -0
  383. package/src/apis/enable.ts +12 -0
  384. package/src/apis/index.ts +5 -0
  385. package/src/errors/AnalyticsError.ts +21 -0
  386. package/src/errors/assertValidationError.ts +25 -0
  387. package/src/errors/index.ts +6 -0
  388. package/src/errors/validation.ts +43 -0
  389. package/src/index.ts +14 -0
  390. package/src/providers/kinesis/apis/flushEvents.ts +43 -0
  391. package/src/providers/kinesis/apis/index.ts +5 -0
  392. package/src/providers/kinesis/apis/record.ts +82 -0
  393. package/src/providers/kinesis/index.ts +4 -0
  394. package/src/providers/kinesis/types/buffer.ts +21 -0
  395. package/src/providers/kinesis/types/index.ts +5 -0
  396. package/src/providers/kinesis/types/inputs.ts +10 -0
  397. package/src/providers/kinesis/utils/constants.ts +9 -0
  398. package/src/providers/kinesis/utils/getEventBuffer.ts +130 -0
  399. package/src/providers/kinesis/utils/resolveConfig.ts +39 -0
  400. package/src/providers/kinesis-firehose/apis/flushEvents.ts +42 -0
  401. package/src/providers/kinesis-firehose/apis/index.ts +5 -0
  402. package/src/providers/kinesis-firehose/apis/record.ts +71 -0
  403. package/src/providers/kinesis-firehose/index.ts +4 -0
  404. package/src/providers/kinesis-firehose/types/buffer.ts +21 -0
  405. package/src/providers/kinesis-firehose/types/index.ts +9 -0
  406. package/src/providers/kinesis-firehose/types/inputs.ts +9 -0
  407. package/src/providers/kinesis-firehose/utils/constants.ts +9 -0
  408. package/src/providers/kinesis-firehose/utils/getEventBuffer.ts +138 -0
  409. package/src/providers/kinesis-firehose/utils/index.ts +5 -0
  410. package/src/providers/kinesis-firehose/utils/resolveConfig.ts +39 -0
  411. package/src/providers/personalize/apis/flushEvents.ts +40 -0
  412. package/src/providers/personalize/apis/index.ts +5 -0
  413. package/src/providers/personalize/apis/record.ts +130 -0
  414. package/src/providers/personalize/index.ts +4 -0
  415. package/src/providers/personalize/types/buffer.ts +23 -0
  416. package/src/providers/personalize/types/index.ts +5 -0
  417. package/src/providers/personalize/types/inputs.ts +11 -0
  418. package/src/providers/personalize/utils/autoTrackMedia.ts +240 -0
  419. package/src/providers/personalize/utils/cachedSession.ts +68 -0
  420. package/src/providers/personalize/utils/constants.ts +12 -0
  421. package/src/providers/personalize/utils/getEventBuffer.ts +135 -0
  422. package/src/providers/personalize/utils/index.ts +11 -0
  423. package/src/providers/personalize/utils/resolveConfig.ts +46 -0
  424. package/src/providers/pinpoint/apis/configureAutoTrack.ts +54 -0
  425. package/src/providers/pinpoint/apis/flushEvents.ts +42 -0
  426. package/src/providers/pinpoint/apis/identifyUser.ts +81 -0
  427. package/src/providers/pinpoint/apis/index.ts +7 -0
  428. package/src/providers/pinpoint/apis/record.ts +92 -0
  429. package/src/providers/pinpoint/index.ts +9 -0
  430. package/src/providers/pinpoint/types/index.ts +9 -0
  431. package/src/providers/pinpoint/types/inputs.ts +26 -0
  432. package/src/providers/pinpoint/types/options.ts +12 -0
  433. package/src/providers/pinpoint/utils/index.ts +5 -0
  434. package/src/providers/pinpoint/utils/resolveConfig.ts +21 -0
  435. package/src/providers/pinpoint/utils/resolveCredentials.ts +22 -0
  436. package/src/trackers/EventTracker.ts +136 -0
  437. package/src/trackers/PageViewTracker.ts +155 -0
  438. package/src/trackers/SessionTracker.native.ts +106 -0
  439. package/src/trackers/SessionTracker.ts +106 -0
  440. package/src/trackers/index.ts +6 -0
  441. package/src/types/index.ts +11 -0
  442. package/src/types/inputs.ts +53 -0
  443. package/src/types/kinesis.ts +13 -0
  444. package/src/types/options.ts +7 -0
  445. package/src/types/trackers.ts +35 -0
  446. package/src/utils/eventBuffer/EventBuffer.ts +85 -0
  447. package/src/utils/eventBuffer/index.ts +5 -0
  448. package/src/utils/eventBuffer/types.ts +10 -0
  449. package/src/utils/groupBy.ts +16 -0
  450. package/src/utils/index.ts +21 -0
  451. package/src/utils/resolveCredentials.ts +16 -0
  452. package/src/utils/statusHelpers.ts +17 -0
  453. package/src/utils/trackerConfigHelpers.native.ts +18 -0
  454. package/src/utils/trackerConfigHelpers.ts +19 -0
  455. package/src/utils/trackerHelpers.ts +56 -0
  456. package/src/utils/userAgent.ts +23 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"configureAutoTrack.mjs","sources":["../../../../../src/providers/pinpoint/apis/configureAutoTrack.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { updateProviderTrackers, validateTrackerConfiguration, } from '../../../utils';\nimport { record } from './record';\n// Configured Tracker instances for Pinpoint\nconst configuredTrackers = {};\n// Callback that will emit an appropriate event to Pinpoint when required by the Tracker\nconst emitTrackingEvent = (eventName, attributes) => {\n record({\n name: eventName,\n attributes,\n });\n};\n/**\n * Configures automatic event tracking for Pinpoint. This API will automatically transmit an analytic event when\n * configured events are detected within your application. This can include: DOM element events (via the `event`\n * tracker), session events (via the `session` tracker), and page view events (via the `pageView` tracker).\n *\n * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.\n *\n * @remark Only session tracking is currently supported on React Native.\n *\n * @param {ConfigureAutoTrackInput} params The input object to configure auto track behavior.\n *\n * @throws service: {@link UpdateEndpointException} - Thrown when the underlying Pinpoint service returns an error.\n * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library\n * configuration is incorrect.\n */\nexport const configureAutoTrack = (input) => {\n validateTrackerConfiguration(input);\n // Initialize or update this provider's trackers\n updateProviderTrackers(input, emitTrackingEvent, configuredTrackers);\n};\n"],"names":[],"mappings":";;;;;;;;AAAA;AACA;AAGA;AACA,MAAM,kBAAkB,GAAG,EAAE;AAC7B;AACA,MAAM,iBAAiB,GAAG,CAAC,SAAS,EAAE,UAAU,KAAK;AACrD,IAAI,MAAM,CAAC;AACX,QAAQ,IAAI,EAAE,SAAS;AACvB,QAAQ,UAAU;AAClB,KAAK,CAAC;AACN,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,kBAAkB,GAAG,CAAC,KAAK,KAAK;AAC7C,IAAI,4BAA4B,CAAC,KAAK,CAAC;AACvC;AACA,IAAI,sBAAsB,CAAC,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,CAAC;AACxE;;;;"}
@@ -0,0 +1,10 @@
1
+ /**
2
+ * Flushes all buffered Pinpoint events to the service.
3
+ *
4
+ * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.
5
+ *
6
+ * @note
7
+ * This API will make a best-effort attempt to flush events from the buffer. Events recorded immediately after invoking
8
+ * this API may not be included in the flush.
9
+ */
10
+ export declare const flushEvents: () => void;
@@ -0,0 +1,47 @@
1
+ import { flushEvents as flushEvents$1 } from '@aws-amplify/core/internals/providers/pinpoint';
2
+ import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
3
+ import { ConsoleLogger } from '@aws-amplify/core';
4
+ import { resolveConfig } from '../utils/resolveConfig.mjs';
5
+ import { resolveCredentials } from '../utils/resolveCredentials.mjs';
6
+ import '../../../errors/validation.mjs';
7
+ import '../../../utils/eventBuffer/EventBuffer.mjs';
8
+ import { getAnalyticsUserAgentString } from '../../../utils/userAgent.mjs';
9
+ import '../../../trackers/EventTracker.mjs';
10
+ import '../../../trackers/PageViewTracker.mjs';
11
+ import '../../../trackers/SessionTracker.mjs';
12
+
13
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
14
+ // SPDX-License-Identifier: Apache-2.0
15
+ const logger = new ConsoleLogger('Analytics');
16
+ /**
17
+ * Flushes all buffered Pinpoint events to the service.
18
+ *
19
+ * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.
20
+ *
21
+ * @note
22
+ * This API will make a best-effort attempt to flush events from the buffer. Events recorded immediately after invoking
23
+ * this API may not be included in the flush.
24
+ */
25
+ const flushEvents = () => {
26
+ const { appId, region, bufferSize, flushSize, flushInterval, resendLimit } = resolveConfig();
27
+ resolveCredentials()
28
+ .then(({ credentials, identityId }) => {
29
+ flushEvents$1({
30
+ appId,
31
+ region,
32
+ credentials,
33
+ identityId,
34
+ bufferSize,
35
+ flushSize,
36
+ flushInterval,
37
+ resendLimit,
38
+ userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),
39
+ });
40
+ })
41
+ .catch(e => {
42
+ logger.warn('Failed to flush events', e);
43
+ });
44
+ };
45
+
46
+ export { flushEvents };
47
+ //# sourceMappingURL=flushEvents.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"flushEvents.mjs","sources":["../../../../../src/providers/pinpoint/apis/flushEvents.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { flushEvents as flushEventsCore } from '@aws-amplify/core/internals/providers/pinpoint';\nimport { AnalyticsAction } from '@aws-amplify/core/internals/utils';\nimport { ConsoleLogger } from '@aws-amplify/core';\nimport { resolveConfig, resolveCredentials } from '../utils';\nimport { getAnalyticsUserAgentString } from '../../../utils';\nconst logger = new ConsoleLogger('Analytics');\n/**\n * Flushes all buffered Pinpoint events to the service.\n *\n * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.\n *\n * @note\n * This API will make a best-effort attempt to flush events from the buffer. Events recorded immediately after invoking\n * this API may not be included in the flush.\n */\nexport const flushEvents = () => {\n const { appId, region, bufferSize, flushSize, flushInterval, resendLimit } = resolveConfig();\n resolveCredentials()\n .then(({ credentials, identityId }) => {\n flushEventsCore({\n appId,\n region,\n credentials,\n identityId,\n bufferSize,\n flushSize,\n flushInterval,\n resendLimit,\n userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),\n });\n })\n .catch(e => {\n logger.warn('Failed to flush events', e);\n });\n};\n"],"names":["flushEventsCore"],"mappings":";;;;;;;;;;;;AAAA;AACA;AAMA,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC;AAC7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,WAAW,GAAG,MAAM;AACjC,IAAI,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE;AAChG,IAAI,kBAAkB;AACtB,SAAS,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK;AAC/C,QAAQA,aAAe,CAAC;AACxB,YAAY,KAAK;AACjB,YAAY,MAAM;AAClB,YAAY,WAAW;AACvB,YAAY,UAAU;AACtB,YAAY,UAAU;AACtB,YAAY,SAAS;AACrB,YAAY,aAAa;AACzB,YAAY,WAAW;AACvB,YAAY,cAAc,EAAE,2BAA2B,CAAC,eAAe,CAAC,MAAM,CAAC;AAC/E,SAAS,CAAC;AACV,IAAI,CAAC;AACL,SAAS,KAAK,CAAC,CAAC,IAAI;AACpB,QAAQ,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,CAAC,CAAC;AAChD,IAAI,CAAC,CAAC;AACN;;;;"}
@@ -0,0 +1,49 @@
1
+ import { IdentifyUserInput } from '../types';
2
+ /**
3
+ * Sends information about a user to Pinpoint. Sending user information allows you to associate a user to their user
4
+ * profile and activities or actions in your application. Activity can be tracked across devices & platforms by using
5
+ * the same `userId`.
6
+ *
7
+ * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.
8
+ *
9
+ * @param {IdentifyUserInput} params The input object used to construct requests sent to Pinpoint's UpdateEndpoint
10
+ * API.
11
+ *
12
+ * @throws service: {@link UpdateEndpointException} - Thrown when the underlying Pinpoint service returns an error.
13
+ * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
14
+ * configuration is incorrect.
15
+ *
16
+ * @returns A promise that will resolve when the operation is complete.
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * // Identify a user with Pinpoint
21
+ * await identifyUser({
22
+ * userId,
23
+ * userProfile: {
24
+ * email: 'userEmail@example.com'
25
+ * customProperties: {
26
+ * phoneNumber: ['555-555-5555'],
27
+ * },
28
+ * }
29
+ * });
30
+ * ```
31
+ *
32
+ * @example
33
+ * ```ts
34
+ * // Identify a user with Pinpoint with some additional demographics
35
+ * await identifyUser({
36
+ * userId,
37
+ * userProfile: {
38
+ * email: 'userEmail@example.com'
39
+ * customProperties: {
40
+ * phoneNumber: ['555-555-5555'],
41
+ * },
42
+ * demographic: {
43
+ * platform: 'ios',
44
+ * timezone: 'America/Los_Angeles'
45
+ * }
46
+ * }
47
+ * });
48
+ */
49
+ export declare const identifyUser: ({ userId, userProfile, options, }: IdentifyUserInput) => Promise<void>;
@@ -0,0 +1,80 @@
1
+ import { AnalyticsAction } from '@aws-amplify/core/internals/utils';
2
+ import { updateEndpoint } from '@aws-amplify/core/internals/providers/pinpoint';
3
+ import '@aws-amplify/core';
4
+ import '../../../errors/validation.mjs';
5
+ import '../../../utils/eventBuffer/EventBuffer.mjs';
6
+ import { getAnalyticsUserAgentString } from '../../../utils/userAgent.mjs';
7
+ import '../../../trackers/EventTracker.mjs';
8
+ import '../../../trackers/PageViewTracker.mjs';
9
+ import '../../../trackers/SessionTracker.mjs';
10
+ import { resolveConfig } from '../utils/resolveConfig.mjs';
11
+ import { resolveCredentials } from '../utils/resolveCredentials.mjs';
12
+
13
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
14
+ // SPDX-License-Identifier: Apache-2.0
15
+ /**
16
+ * Sends information about a user to Pinpoint. Sending user information allows you to associate a user to their user
17
+ * profile and activities or actions in your application. Activity can be tracked across devices & platforms by using
18
+ * the same `userId`.
19
+ *
20
+ * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.
21
+ *
22
+ * @param {IdentifyUserInput} params The input object used to construct requests sent to Pinpoint's UpdateEndpoint
23
+ * API.
24
+ *
25
+ * @throws service: {@link UpdateEndpointException} - Thrown when the underlying Pinpoint service returns an error.
26
+ * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
27
+ * configuration is incorrect.
28
+ *
29
+ * @returns A promise that will resolve when the operation is complete.
30
+ *
31
+ * @example
32
+ * ```ts
33
+ * // Identify a user with Pinpoint
34
+ * await identifyUser({
35
+ * userId,
36
+ * userProfile: {
37
+ * email: 'userEmail@example.com'
38
+ * customProperties: {
39
+ * phoneNumber: ['555-555-5555'],
40
+ * },
41
+ * }
42
+ * });
43
+ * ```
44
+ *
45
+ * @example
46
+ * ```ts
47
+ * // Identify a user with Pinpoint with some additional demographics
48
+ * await identifyUser({
49
+ * userId,
50
+ * userProfile: {
51
+ * email: 'userEmail@example.com'
52
+ * customProperties: {
53
+ * phoneNumber: ['555-555-5555'],
54
+ * },
55
+ * demographic: {
56
+ * platform: 'ios',
57
+ * timezone: 'America/Los_Angeles'
58
+ * }
59
+ * }
60
+ * });
61
+ */
62
+ const identifyUser = async ({ userId, userProfile, options, }) => {
63
+ const { credentials, identityId } = await resolveCredentials();
64
+ const { appId, region } = resolveConfig();
65
+ const { userAttributes } = options ?? {};
66
+ await updateEndpoint({
67
+ appId,
68
+ category: 'Analytics',
69
+ credentials,
70
+ identityId,
71
+ region,
72
+ userAttributes,
73
+ userId,
74
+ userProfile,
75
+ userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.IdentifyUser),
76
+ });
77
+ };
78
+
79
+ export { identifyUser };
80
+ //# sourceMappingURL=identifyUser.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"identifyUser.mjs","sources":["../../../../../src/providers/pinpoint/apis/identifyUser.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { AnalyticsAction } from '@aws-amplify/core/internals/utils';\nimport { updateEndpoint, } from '@aws-amplify/core/internals/providers/pinpoint';\nimport { getAnalyticsUserAgentString } from '../../../utils';\nimport { resolveConfig, resolveCredentials } from '../utils';\n/**\n * Sends information about a user to Pinpoint. Sending user information allows you to associate a user to their user\n * profile and activities or actions in your application. Activity can be tracked across devices & platforms by using\n * the same `userId`.\n *\n * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.\n *\n * @param {IdentifyUserInput} params The input object used to construct requests sent to Pinpoint's UpdateEndpoint\n * API.\n *\n * @throws service: {@link UpdateEndpointException} - Thrown when the underlying Pinpoint service returns an error.\n * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library\n * configuration is incorrect.\n *\n * @returns A promise that will resolve when the operation is complete.\n *\n * @example\n * ```ts\n * // Identify a user with Pinpoint\n * await identifyUser({\n * userId,\n * userProfile: {\n * email: 'userEmail@example.com'\n * customProperties: {\n * phoneNumber: ['555-555-5555'],\n * },\n * }\n * });\n * ```\n *\n * @example\n * ```ts\n * // Identify a user with Pinpoint with some additional demographics\n * await identifyUser({\n * userId,\n * userProfile: {\n * email: 'userEmail@example.com'\n * customProperties: {\n * phoneNumber: ['555-555-5555'],\n * },\n * demographic: {\n * platform: 'ios',\n * timezone: 'America/Los_Angeles'\n * }\n * }\n * });\n */\nexport const identifyUser = async ({ userId, userProfile, options, }) => {\n const { credentials, identityId } = await resolveCredentials();\n const { appId, region } = resolveConfig();\n const { userAttributes } = options ?? {};\n await updateEndpoint({\n appId,\n category: 'Analytics',\n credentials,\n identityId,\n region,\n userAttributes,\n userId,\n userProfile,\n userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.IdentifyUser),\n });\n};\n"],"names":[],"mappings":";;;;;;;;;;;;AAAA;AACA;AAKA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,YAAY,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,GAAG,KAAK;AACzE,IAAI,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,kBAAkB,EAAE;AAClE,IAAI,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,aAAa,EAAE;AAC7C,IAAI,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,IAAI,EAAE;AAC5C,IAAI,MAAM,cAAc,CAAC;AACzB,QAAQ,KAAK;AACb,QAAQ,QAAQ,EAAE,WAAW;AAC7B,QAAQ,WAAW;AACnB,QAAQ,UAAU;AAClB,QAAQ,MAAM;AACd,QAAQ,cAAc;AACtB,QAAQ,MAAM;AACd,QAAQ,WAAW;AACnB,QAAQ,cAAc,EAAE,2BAA2B,CAAC,eAAe,CAAC,YAAY,CAAC;AACjF,KAAK,CAAC;AACN;;;;"}
@@ -0,0 +1,4 @@
1
+ export { record } from './record';
2
+ export { identifyUser } from './identifyUser';
3
+ export { configureAutoTrack } from './configureAutoTrack';
4
+ export { flushEvents } from './flushEvents';
@@ -0,0 +1,5 @@
1
+ export { record } from './record.mjs';
2
+ export { identifyUser } from './identifyUser.mjs';
3
+ export { configureAutoTrack } from './configureAutoTrack.mjs';
4
+ export { flushEvents } from './flushEvents.mjs';
5
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}
@@ -0,0 +1,32 @@
1
+ import { RecordInput } from '../types';
2
+ /**
3
+ * Records an Analytic event to Pinpoint. Events will be buffered and periodically sent to Pinpoint.
4
+ *
5
+ * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.
6
+ *
7
+ * @param params The input object used to construct the request.
8
+ *
9
+ * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
10
+ * configuration is incorrect.
11
+ *
12
+ * @example
13
+ * ```ts
14
+ * // Send an event to Pinpoint
15
+ * record({ name: eventName })
16
+ * ```
17
+ *
18
+ * @example
19
+ * ```ts
20
+ * // Send an event to Pinpoint with metrics & custom attributes
21
+ * record({
22
+ * name: eventName,
23
+ * attributes: {
24
+ * 'my-attribute': attributeValue
25
+ * },
26
+ * metrics: {
27
+ * 'my-metric': metricValue
28
+ * }
29
+ * })
30
+ * ```
31
+ */
32
+ export declare const record: (input: RecordInput) => void;
@@ -0,0 +1,79 @@
1
+ import { ConsoleLogger, Hub } from '@aws-amplify/core';
2
+ import { AMPLIFY_SYMBOL, AnalyticsAction } from '@aws-amplify/core/internals/utils';
3
+ import { record as record$1 } from '@aws-amplify/core/internals/providers/pinpoint';
4
+ import { assertValidationError } from '../../../errors/assertValidationError.mjs';
5
+ import { AnalyticsValidationErrorCode } from '../../../errors/validation.mjs';
6
+ import '../../../utils/eventBuffer/EventBuffer.mjs';
7
+ import { isAnalyticsEnabled } from '../../../utils/statusHelpers.mjs';
8
+ import { getAnalyticsUserAgentString } from '../../../utils/userAgent.mjs';
9
+ import '../../../trackers/EventTracker.mjs';
10
+ import '../../../trackers/PageViewTracker.mjs';
11
+ import '../../../trackers/SessionTracker.mjs';
12
+ import { resolveConfig } from '../utils/resolveConfig.mjs';
13
+ import { resolveCredentials } from '../utils/resolveCredentials.mjs';
14
+
15
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
16
+ // SPDX-License-Identifier: Apache-2.0
17
+ const logger = new ConsoleLogger('Analytics');
18
+ /**
19
+ * Records an Analytic event to Pinpoint. Events will be buffered and periodically sent to Pinpoint.
20
+ *
21
+ * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.
22
+ *
23
+ * @param params The input object used to construct the request.
24
+ *
25
+ * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library
26
+ * configuration is incorrect.
27
+ *
28
+ * @example
29
+ * ```ts
30
+ * // Send an event to Pinpoint
31
+ * record({ name: eventName })
32
+ * ```
33
+ *
34
+ * @example
35
+ * ```ts
36
+ * // Send an event to Pinpoint with metrics & custom attributes
37
+ * record({
38
+ * name: eventName,
39
+ * attributes: {
40
+ * 'my-attribute': attributeValue
41
+ * },
42
+ * metrics: {
43
+ * 'my-metric': metricValue
44
+ * }
45
+ * })
46
+ * ```
47
+ */
48
+ const record = (input) => {
49
+ const { appId, region, bufferSize, flushSize, flushInterval, resendLimit } = resolveConfig();
50
+ if (!isAnalyticsEnabled()) {
51
+ logger.debug('Analytics is disabled, event will not be recorded.');
52
+ return;
53
+ }
54
+ assertValidationError(!!input.name, AnalyticsValidationErrorCode.NoEventName);
55
+ resolveCredentials()
56
+ .then(({ credentials, identityId }) => {
57
+ Hub.dispatch('analytics', { event: 'record', data: input, message: 'Recording Analytics event' }, 'Analytics', AMPLIFY_SYMBOL);
58
+ record$1({
59
+ appId,
60
+ category: 'Analytics',
61
+ credentials,
62
+ event: input,
63
+ identityId,
64
+ region,
65
+ userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),
66
+ bufferSize,
67
+ flushSize,
68
+ flushInterval,
69
+ resendLimit,
70
+ });
71
+ })
72
+ .catch(e => {
73
+ // An error occured while fetching credentials or persisting the event to the buffer
74
+ logger.warn('Failed to record event.', e);
75
+ });
76
+ };
77
+
78
+ export { record };
79
+ //# sourceMappingURL=record.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"record.mjs","sources":["../../../../../src/providers/pinpoint/apis/record.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { ConsoleLogger, Hub } from '@aws-amplify/core';\nimport { AMPLIFY_SYMBOL, AnalyticsAction, } from '@aws-amplify/core/internals/utils';\nimport { record as recordCore } from '@aws-amplify/core/internals/providers/pinpoint';\nimport { AnalyticsValidationErrorCode, assertValidationError, } from '../../../errors';\nimport { getAnalyticsUserAgentString, isAnalyticsEnabled, } from '../../../utils';\nimport { resolveConfig, resolveCredentials } from '../utils';\nconst logger = new ConsoleLogger('Analytics');\n/**\n * Records an Analytic event to Pinpoint. Events will be buffered and periodically sent to Pinpoint.\n *\n * @deprecated AWS will end support for Amazon Pinpoint on October 30, 2026.\n *\n * @param params The input object used to construct the request.\n *\n * @throws validation: {@link AnalyticsValidationErrorCode} - Thrown when the provided parameters or library\n * configuration is incorrect.\n *\n * @example\n * ```ts\n * // Send an event to Pinpoint\n * record({ name: eventName })\n * ```\n *\n * @example\n * ```ts\n * // Send an event to Pinpoint with metrics & custom attributes\n * record({\n * name: eventName,\n * attributes: {\n * 'my-attribute': attributeValue\n * },\n * metrics: {\n * 'my-metric': metricValue\n * }\n * })\n * ```\n */\nexport const record = (input) => {\n const { appId, region, bufferSize, flushSize, flushInterval, resendLimit } = resolveConfig();\n if (!isAnalyticsEnabled()) {\n logger.debug('Analytics is disabled, event will not be recorded.');\n return;\n }\n assertValidationError(!!input.name, AnalyticsValidationErrorCode.NoEventName);\n resolveCredentials()\n .then(({ credentials, identityId }) => {\n Hub.dispatch('analytics', { event: 'record', data: input, message: 'Recording Analytics event' }, 'Analytics', AMPLIFY_SYMBOL);\n recordCore({\n appId,\n category: 'Analytics',\n credentials,\n event: input,\n identityId,\n region,\n userAgentValue: getAnalyticsUserAgentString(AnalyticsAction.Record),\n bufferSize,\n flushSize,\n flushInterval,\n resendLimit,\n });\n })\n .catch(e => {\n // An error occured while fetching credentials or persisting the event to the buffer\n logger.warn('Failed to record event.', e);\n });\n};\n"],"names":["recordCore"],"mappings":";;;;;;;;;;;;;;AAAA;AACA;AAOA,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC,WAAW,CAAC;AAC7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,MAAM,GAAG,CAAC,KAAK,KAAK;AACjC,IAAI,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,aAAa,EAAE;AAChG,IAAI,IAAI,CAAC,kBAAkB,EAAE,EAAE;AAC/B,QAAQ,MAAM,CAAC,KAAK,CAAC,oDAAoD,CAAC;AAC1E,QAAQ;AACR,IAAI;AACJ,IAAI,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,4BAA4B,CAAC,WAAW,CAAC;AACjF,IAAI,kBAAkB;AACtB,SAAS,IAAI,CAAC,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK;AAC/C,QAAQ,GAAG,CAAC,QAAQ,CAAC,WAAW,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,2BAA2B,EAAE,EAAE,WAAW,EAAE,cAAc,CAAC;AACtI,QAAQA,QAAU,CAAC;AACnB,YAAY,KAAK;AACjB,YAAY,QAAQ,EAAE,WAAW;AACjC,YAAY,WAAW;AACvB,YAAY,KAAK,EAAE,KAAK;AACxB,YAAY,UAAU;AACtB,YAAY,MAAM;AAClB,YAAY,cAAc,EAAE,2BAA2B,CAAC,eAAe,CAAC,MAAM,CAAC;AAC/E,YAAY,UAAU;AACtB,YAAY,SAAS;AACrB,YAAY,aAAa;AACzB,YAAY,WAAW;AACvB,SAAS,CAAC;AACV,IAAI,CAAC;AACL,SAAS,KAAK,CAAC,CAAC,IAAI;AACpB;AACA,QAAQ,MAAM,CAAC,IAAI,CAAC,yBAAyB,EAAE,CAAC,CAAC;AACjD,IAAI,CAAC,CAAC;AACN;;;;"}
@@ -0,0 +1,2 @@
1
+ export { record, identifyUser, flushEvents, configureAutoTrack } from './apis';
2
+ export { RecordInput, IdentifyUserInput, ConfigureAutoTrackInput, } from './types/inputs';
@@ -0,0 +1,5 @@
1
+ export { record } from './apis/record.mjs';
2
+ export { identifyUser } from './apis/identifyUser.mjs';
3
+ export { configureAutoTrack } from './apis/configureAutoTrack.mjs';
4
+ export { flushEvents } from './apis/flushEvents.mjs';
5
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;"}
@@ -0,0 +1,2 @@
1
+ export { RecordInput, IdentifyUserInput, ConfigureAutoTrackInput, } from './inputs';
2
+ export { IdentifyUserOptions } from './options';
@@ -0,0 +1,2 @@
1
+
2
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
@@ -0,0 +1,15 @@
1
+ import { PinpointAnalyticsEvent } from '@aws-amplify/core/internals/providers/pinpoint';
2
+ import { AnalyticsConfigureAutoTrackInput, AnalyticsIdentifyUserInput } from '../../../types';
3
+ import { IdentifyUserOptions } from './options';
4
+ /**
5
+ * Input type for Pinpoint record API.
6
+ */
7
+ export type RecordInput = PinpointAnalyticsEvent;
8
+ /**
9
+ * Input type for Pinpoint identifyUser API.
10
+ */
11
+ export type IdentifyUserInput = AnalyticsIdentifyUserInput<IdentifyUserOptions>;
12
+ /**
13
+ * Input type for Pinpoint configureAutoTrack API.
14
+ */
15
+ export type ConfigureAutoTrackInput = AnalyticsConfigureAutoTrackInput;
@@ -0,0 +1,2 @@
1
+
2
+ //# sourceMappingURL=inputs.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"inputs.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
@@ -0,0 +1,5 @@
1
+ import { PinpointServiceOptions } from '@aws-amplify/core/internals/providers/pinpoint';
2
+ /**
3
+ * Options specific to Pinpoint identityUser.
4
+ */
5
+ export type IdentifyUserOptions = Pick<PinpointServiceOptions, 'userAttributes'>;
@@ -0,0 +1,2 @@
1
+
2
+ //# sourceMappingURL=options.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"options.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}
@@ -0,0 +1,2 @@
1
+ export { resolveConfig } from './resolveConfig';
2
+ export { resolveCredentials } from './resolveCredentials';
@@ -0,0 +1,3 @@
1
+ export { resolveConfig } from './resolveConfig.mjs';
2
+ export { resolveCredentials } from './resolveCredentials.mjs';
3
+ //# sourceMappingURL=index.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";"}
@@ -0,0 +1,11 @@
1
+ /**
2
+ * @internal
3
+ */
4
+ export declare const resolveConfig: () => {
5
+ appId: string;
6
+ region: string;
7
+ bufferSize: number | undefined;
8
+ flushSize: number | undefined;
9
+ flushInterval: number | undefined;
10
+ resendLimit: number | undefined;
11
+ };
@@ -0,0 +1,19 @@
1
+ import { Amplify } from '@aws-amplify/core';
2
+ import '@aws-amplify/core/internals/utils';
3
+ import { assertValidationError } from '../../../errors/assertValidationError.mjs';
4
+ import { AnalyticsValidationErrorCode } from '../../../errors/validation.mjs';
5
+
6
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
7
+ // SPDX-License-Identifier: Apache-2.0
8
+ /**
9
+ * @internal
10
+ */
11
+ const resolveConfig = () => {
12
+ const { appId, region, bufferSize, flushSize, flushInterval, resendLimit } = Amplify.getConfig().Analytics?.Pinpoint ?? {};
13
+ assertValidationError(!!appId, AnalyticsValidationErrorCode.NoAppId);
14
+ assertValidationError(!!region, AnalyticsValidationErrorCode.NoRegion);
15
+ return { appId, region, bufferSize, flushSize, flushInterval, resendLimit };
16
+ };
17
+
18
+ export { resolveConfig };
19
+ //# sourceMappingURL=resolveConfig.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveConfig.mjs","sources":["../../../../../src/providers/pinpoint/utils/resolveConfig.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { Amplify } from '@aws-amplify/core';\nimport { AnalyticsValidationErrorCode, assertValidationError, } from '../../../errors';\n/**\n * @internal\n */\nexport const resolveConfig = () => {\n const { appId, region, bufferSize, flushSize, flushInterval, resendLimit } = Amplify.getConfig().Analytics?.Pinpoint ?? {};\n assertValidationError(!!appId, AnalyticsValidationErrorCode.NoAppId);\n assertValidationError(!!region, AnalyticsValidationErrorCode.NoRegion);\n return { appId, region, bufferSize, flushSize, flushInterval, resendLimit };\n};\n"],"names":[],"mappings":";;;;;AAAA;AACA;AAGA;AACA;AACA;AACY,MAAC,aAAa,GAAG,MAAM;AACnC,IAAI,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,SAAS,EAAE,QAAQ,IAAI,EAAE;AAC9H,IAAI,qBAAqB,CAAC,CAAC,CAAC,KAAK,EAAE,4BAA4B,CAAC,OAAO,CAAC;AACxE,IAAI,qBAAqB,CAAC,CAAC,CAAC,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC;AAC1E,IAAI,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE;AAC/E;;;;"}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * @internal
3
+ */
4
+ export declare const resolveCredentials: () => Promise<{
5
+ credentials: import("@aws-amplify/core/internals/utils").AWSCredentials;
6
+ identityId: string | undefined;
7
+ }>;
@@ -0,0 +1,18 @@
1
+ import { fetchAuthSession } from '@aws-amplify/core';
2
+ import '@aws-amplify/core/internals/utils';
3
+ import { assertValidationError } from '../../../errors/assertValidationError.mjs';
4
+ import { AnalyticsValidationErrorCode } from '../../../errors/validation.mjs';
5
+
6
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
7
+ // SPDX-License-Identifier: Apache-2.0
8
+ /**
9
+ * @internal
10
+ */
11
+ const resolveCredentials = async () => {
12
+ const { credentials, identityId } = await fetchAuthSession();
13
+ assertValidationError(!!credentials, AnalyticsValidationErrorCode.NoCredentials);
14
+ return { credentials, identityId };
15
+ };
16
+
17
+ export { resolveCredentials };
18
+ //# sourceMappingURL=resolveCredentials.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"resolveCredentials.mjs","sources":["../../../../../src/providers/pinpoint/utils/resolveCredentials.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { fetchAuthSession } from '@aws-amplify/core';\nimport { AnalyticsValidationErrorCode, assertValidationError, } from '../../../errors';\n/**\n * @internal\n */\nexport const resolveCredentials = async () => {\n const { credentials, identityId } = await fetchAuthSession();\n assertValidationError(!!credentials, AnalyticsValidationErrorCode.NoCredentials);\n return { credentials, identityId };\n};\n"],"names":[],"mappings":";;;;;AAAA;AACA;AAGA;AACA;AACA;AACY,MAAC,kBAAkB,GAAG,YAAY;AAC9C,IAAI,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,GAAG,MAAM,gBAAgB,EAAE;AAChE,IAAI,qBAAqB,CAAC,CAAC,CAAC,WAAW,EAAE,4BAA4B,CAAC,aAAa,CAAC;AACpF,IAAI,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE;AACtC;;;;"}
@@ -0,0 +1,10 @@
1
+ import { EventTrackingOptions, TrackerEventRecorder, TrackerInterface } from '../types/trackers';
2
+ export declare class EventTracker implements TrackerInterface {
3
+ private trackerActive;
4
+ private options;
5
+ private eventRecorder;
6
+ constructor(eventRecorder: TrackerEventRecorder, options?: EventTrackingOptions);
7
+ configure(eventRecorder: TrackerEventRecorder, options?: EventTrackingOptions): void;
8
+ cleanup(): void;
9
+ private handleDocEvent;
10
+ }
@@ -0,0 +1,98 @@
1
+ import { ConsoleLogger } from '@aws-amplify/core';
2
+ import { isBrowser } from '@aws-amplify/core/internals/utils';
3
+
4
+ // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
5
+ // SPDX-License-Identifier: Apache-2.0
6
+ const DEFAULT_EVENTS = ['click'];
7
+ const DEFAULT_SELECTOR_PREFIX = 'data-amplify-analytics-';
8
+ const DEFAULT_EVENT_NAME = 'event'; // Default event name as sent to the analytics provider
9
+ const logger = new ConsoleLogger('EventTracker');
10
+ class EventTracker {
11
+ constructor(eventRecorder, options) {
12
+ this.options = {};
13
+ this.trackerActive = false;
14
+ this.eventRecorder = eventRecorder;
15
+ this.handleDocEvent = this.handleDocEvent.bind(this);
16
+ this.configure(eventRecorder, options);
17
+ }
18
+ configure(eventRecorder, options) {
19
+ this.eventRecorder = eventRecorder;
20
+ // Clean up any existing listeners
21
+ this.cleanup();
22
+ // Apply defaults
23
+ this.options = {
24
+ attributes: options?.attributes ?? undefined,
25
+ events: options?.events ?? DEFAULT_EVENTS,
26
+ selectorPrefix: options?.selectorPrefix ?? DEFAULT_SELECTOR_PREFIX,
27
+ };
28
+ // Register event listeners
29
+ if (isBrowser()) {
30
+ this.options.events?.forEach(targetEvent => {
31
+ document.addEventListener(targetEvent, this.handleDocEvent, {
32
+ capture: true,
33
+ });
34
+ });
35
+ this.trackerActive = true;
36
+ }
37
+ }
38
+ cleanup() {
39
+ // No-op if document listener is not active
40
+ if (!this.trackerActive) {
41
+ return;
42
+ }
43
+ // Clean up event listeners
44
+ this.options.events?.forEach(targetEvent => {
45
+ document.removeEventListener(targetEvent, this.handleDocEvent, {
46
+ capture: true,
47
+ });
48
+ });
49
+ }
50
+ handleDocEvent(event) {
51
+ /**
52
+ * Example DOM element:
53
+ *
54
+ * ```
55
+ * <button
56
+ * data-amplify-analytics-on="click"
57
+ * data-amplify-analytics-name="click"
58
+ * data-amplify-analytics-attrs="attr1:attr1_value,attr2:attr2_value"
59
+ * />
60
+ * ```
61
+ */
62
+ const triggerSelector = `[${this.options.selectorPrefix}on]`;
63
+ const attrSelector = `${this.options.selectorPrefix}attrs`;
64
+ const eventNameSelector = `${this.options.selectorPrefix}name`;
65
+ const eventSource = event.target;
66
+ // Validate that the triggering event type is being tracked
67
+ if (!this.options.events?.includes(event.type)) {
68
+ return;
69
+ }
70
+ if (eventSource instanceof HTMLElement) {
71
+ const target = eventSource.closest(triggerSelector);
72
+ if (target) {
73
+ // Parse event name from the element
74
+ const eventName = target.getAttribute(eventNameSelector) || DEFAULT_EVENT_NAME;
75
+ // Parse attributes from the element
76
+ const elementAttributes = {};
77
+ const rawElementAttributes = target.getAttribute(attrSelector);
78
+ rawElementAttributes?.split(/\s*,\s*/).forEach(attr => {
79
+ const tmp = attr.trim().split(/\s*:\s*/);
80
+ elementAttributes[tmp[0]] = tmp[1];
81
+ });
82
+ // Assemble final list of attributes
83
+ const attributes = Object.assign({
84
+ type: event.type,
85
+ target: `${target.localName} with id ${target.id}`,
86
+ }, this.options.attributes, elementAttributes);
87
+ logger.debug('Recording automatically tracked DOM event', {
88
+ eventName,
89
+ attributes,
90
+ });
91
+ this.eventRecorder(eventName, attributes);
92
+ }
93
+ }
94
+ }
95
+ }
96
+
97
+ export { EventTracker };
98
+ //# sourceMappingURL=EventTracker.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EventTracker.mjs","sources":["../../../src/trackers/EventTracker.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { ConsoleLogger } from '@aws-amplify/core';\nimport { isBrowser } from '@aws-amplify/core/internals/utils';\nconst DEFAULT_EVENTS = ['click'];\nconst DEFAULT_SELECTOR_PREFIX = 'data-amplify-analytics-';\nconst DEFAULT_EVENT_NAME = 'event'; // Default event name as sent to the analytics provider\nconst logger = new ConsoleLogger('EventTracker');\nexport class EventTracker {\n constructor(eventRecorder, options) {\n this.options = {};\n this.trackerActive = false;\n this.eventRecorder = eventRecorder;\n this.handleDocEvent = this.handleDocEvent.bind(this);\n this.configure(eventRecorder, options);\n }\n configure(eventRecorder, options) {\n this.eventRecorder = eventRecorder;\n // Clean up any existing listeners\n this.cleanup();\n // Apply defaults\n this.options = {\n attributes: options?.attributes ?? undefined,\n events: options?.events ?? DEFAULT_EVENTS,\n selectorPrefix: options?.selectorPrefix ?? DEFAULT_SELECTOR_PREFIX,\n };\n // Register event listeners\n if (isBrowser()) {\n this.options.events?.forEach(targetEvent => {\n document.addEventListener(targetEvent, this.handleDocEvent, {\n capture: true,\n });\n });\n this.trackerActive = true;\n }\n }\n cleanup() {\n // No-op if document listener is not active\n if (!this.trackerActive) {\n return;\n }\n // Clean up event listeners\n this.options.events?.forEach(targetEvent => {\n document.removeEventListener(targetEvent, this.handleDocEvent, {\n capture: true,\n });\n });\n }\n handleDocEvent(event) {\n /**\n * Example DOM element:\n *\n * ```\n * <button\n * data-amplify-analytics-on=\"click\"\n * data-amplify-analytics-name=\"click\"\n * data-amplify-analytics-attrs=\"attr1:attr1_value,attr2:attr2_value\"\n * />\n * ```\n */\n const triggerSelector = `[${this.options.selectorPrefix}on]`;\n const attrSelector = `${this.options.selectorPrefix}attrs`;\n const eventNameSelector = `${this.options.selectorPrefix}name`;\n const eventSource = event.target;\n // Validate that the triggering event type is being tracked\n if (!this.options.events?.includes(event.type)) {\n return;\n }\n if (eventSource instanceof HTMLElement) {\n const target = eventSource.closest(triggerSelector);\n if (target) {\n // Parse event name from the element\n const eventName = target.getAttribute(eventNameSelector) || DEFAULT_EVENT_NAME;\n // Parse attributes from the element\n const elementAttributes = {};\n const rawElementAttributes = target.getAttribute(attrSelector);\n rawElementAttributes?.split(/\\s*,\\s*/).forEach(attr => {\n const tmp = attr.trim().split(/\\s*:\\s*/);\n elementAttributes[tmp[0]] = tmp[1];\n });\n // Assemble final list of attributes\n const attributes = Object.assign({\n type: event.type,\n target: `${target.localName} with id ${target.id}`,\n }, this.options.attributes, elementAttributes);\n logger.debug('Recording automatically tracked DOM event', {\n eventName,\n attributes,\n });\n this.eventRecorder(eventName, attributes);\n }\n }\n }\n}\n"],"names":[],"mappings":"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"}