@formo/analytics 1.25.0 → 1.27.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (192) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +6 -4
  3. package/dist/cjs/src/FormoAnalytics.d.ts +27 -15
  4. package/dist/cjs/src/FormoAnalytics.js +198 -257
  5. package/dist/cjs/src/FormoAnalyticsProvider.js +71 -13
  6. package/dist/{esm/src/lib/consent.d.ts → cjs/src/consent/index.d.ts} +1 -1
  7. package/dist/cjs/src/{lib/consent.js → consent/index.js} +1 -1
  8. package/dist/cjs/src/constants/base.d.ts +0 -2
  9. package/dist/cjs/src/constants/base.js +3 -3
  10. package/dist/cjs/src/constants/config.js +1 -1
  11. package/dist/cjs/src/{lib/event → event}/EventFactory.d.ts +2 -2
  12. package/dist/cjs/src/{lib/event → event}/EventFactory.js +9 -9
  13. package/dist/cjs/src/{lib/event → event}/EventManager.d.ts +1 -1
  14. package/dist/cjs/src/{lib/event → event}/EventManager.js +1 -1
  15. package/dist/cjs/src/{lib/event → event}/type.d.ts +1 -1
  16. package/dist/cjs/src/{lib/event → event}/utils.d.ts +1 -1
  17. package/dist/cjs/src/{lib/event → event}/utils.js +1 -1
  18. package/dist/cjs/src/fetch/index.d.ts +11 -0
  19. package/dist/cjs/src/fetch/index.js +126 -0
  20. package/dist/cjs/src/provider/detection.d.ts +58 -0
  21. package/dist/cjs/src/provider/detection.js +103 -0
  22. package/dist/cjs/src/provider/index.d.ts +6 -0
  23. package/dist/cjs/src/provider/index.js +11 -0
  24. package/dist/cjs/src/queue/EventQueue.d.ts +56 -0
  25. package/dist/cjs/src/{lib/queue → queue}/EventQueue.js +161 -52
  26. package/dist/{esm/src/lib → cjs/src}/queue/type.d.ts +1 -1
  27. package/dist/cjs/src/session/index.d.ts +91 -0
  28. package/dist/cjs/src/session/index.js +126 -0
  29. package/dist/cjs/src/{lib/storage → storage}/built-in/blueprint.js +1 -1
  30. package/dist/cjs/src/types/base.d.ts +35 -1
  31. package/dist/cjs/src/types/events.d.ts +5 -3
  32. package/dist/cjs/src/validators/object.js +0 -2
  33. package/dist/cjs/src/version.d.ts +1 -1
  34. package/dist/cjs/src/version.js +1 -1
  35. package/dist/cjs/src/wagmi/WagmiEventHandler.d.ts +93 -0
  36. package/dist/cjs/src/wagmi/WagmiEventHandler.js +669 -0
  37. package/dist/cjs/src/wagmi/index.d.ts +9 -0
  38. package/dist/cjs/src/wagmi/index.js +12 -0
  39. package/dist/cjs/src/wagmi/types.d.ts +146 -0
  40. package/dist/cjs/src/wagmi/types.js +10 -0
  41. package/dist/cjs/src/wagmi/utils.d.ts +74 -0
  42. package/dist/cjs/src/wagmi/utils.js +198 -0
  43. package/dist/esm/src/FormoAnalytics.d.ts +27 -15
  44. package/dist/esm/src/FormoAnalytics.js +88 -147
  45. package/dist/esm/src/FormoAnalyticsProvider.js +68 -10
  46. package/dist/{cjs/src/lib/consent.d.ts → esm/src/consent/index.d.ts} +1 -1
  47. package/dist/esm/src/{lib/consent.js → consent/index.js} +1 -1
  48. package/dist/esm/src/constants/base.d.ts +0 -2
  49. package/dist/esm/src/constants/base.js +2 -2
  50. package/dist/esm/src/constants/config.js +1 -1
  51. package/dist/esm/src/{lib/event → event}/EventFactory.d.ts +2 -2
  52. package/dist/esm/src/{lib/event → event}/EventFactory.js +9 -9
  53. package/dist/esm/src/{lib/event → event}/EventManager.d.ts +1 -1
  54. package/dist/esm/src/{lib/event → event}/EventManager.js +1 -1
  55. package/dist/esm/src/{lib/event → event}/type.d.ts +1 -1
  56. package/dist/esm/src/{lib/event → event}/utils.d.ts +1 -1
  57. package/dist/esm/src/{lib/event → event}/utils.js +1 -1
  58. package/dist/esm/src/fetch/index.d.ts +11 -0
  59. package/dist/esm/src/fetch/index.js +124 -0
  60. package/dist/esm/src/provider/detection.d.ts +58 -0
  61. package/dist/esm/src/provider/detection.js +98 -0
  62. package/dist/esm/src/provider/index.d.ts +6 -0
  63. package/dist/esm/src/provider/index.js +5 -0
  64. package/dist/esm/src/queue/EventQueue.d.ts +56 -0
  65. package/dist/esm/src/{lib/queue → queue}/EventQueue.js +161 -52
  66. package/dist/{cjs/src/lib → esm/src}/queue/type.d.ts +1 -1
  67. package/dist/esm/src/session/index.d.ts +91 -0
  68. package/dist/esm/src/session/index.js +123 -0
  69. package/dist/esm/src/{lib/storage → storage}/built-in/blueprint.js +1 -1
  70. package/dist/esm/src/types/base.d.ts +35 -1
  71. package/dist/esm/src/types/events.d.ts +5 -3
  72. package/dist/esm/src/validators/object.js +0 -2
  73. package/dist/esm/src/version.d.ts +1 -1
  74. package/dist/esm/src/version.js +1 -1
  75. package/dist/esm/src/wagmi/WagmiEventHandler.d.ts +93 -0
  76. package/dist/esm/src/wagmi/WagmiEventHandler.js +666 -0
  77. package/dist/esm/src/wagmi/index.d.ts +9 -0
  78. package/dist/esm/src/wagmi/index.js +8 -0
  79. package/dist/esm/src/wagmi/types.d.ts +146 -0
  80. package/dist/esm/src/wagmi/types.js +9 -0
  81. package/dist/esm/src/wagmi/utils.d.ts +74 -0
  82. package/dist/esm/src/wagmi/utils.js +192 -0
  83. package/dist/index.umd.min.js +1 -1
  84. package/package.json +23 -4
  85. package/dist/cjs/src/lib/fetch.d.ts +0 -3
  86. package/dist/cjs/src/lib/fetch.js +0 -8
  87. package/dist/cjs/src/lib/index.d.ts +0 -7
  88. package/dist/cjs/src/lib/index.js +0 -28
  89. package/dist/cjs/src/lib/queue/EventQueue.d.ts +0 -34
  90. package/dist/esm/src/lib/fetch.d.ts +0 -3
  91. package/dist/esm/src/lib/fetch.js +0 -3
  92. package/dist/esm/src/lib/index.d.ts +0 -7
  93. package/dist/esm/src/lib/index.js +0 -7
  94. package/dist/esm/src/lib/queue/EventQueue.d.ts +0 -34
  95. /package/dist/cjs/src/{lib/browser → browser}/browsers.d.ts +0 -0
  96. /package/dist/cjs/src/{lib/browser → browser}/browsers.js +0 -0
  97. /package/dist/cjs/src/{lib/event → event}/constants.d.ts +0 -0
  98. /package/dist/cjs/src/{lib/event → event}/constants.js +0 -0
  99. /package/dist/cjs/src/{lib/event → event}/index.d.ts +0 -0
  100. /package/dist/cjs/src/{lib/event → event}/index.js +0 -0
  101. /package/dist/cjs/src/{lib/event → event}/type.js +0 -0
  102. /package/dist/cjs/src/{lib/logger → logger}/Logger.d.ts +0 -0
  103. /package/dist/cjs/src/{lib/logger → logger}/Logger.js +0 -0
  104. /package/dist/cjs/src/{lib/logger → logger}/index.d.ts +0 -0
  105. /package/dist/cjs/src/{lib/logger → logger}/index.js +0 -0
  106. /package/dist/cjs/src/{lib/logger → logger}/type.d.ts +0 -0
  107. /package/dist/cjs/src/{lib/logger → logger}/type.js +0 -0
  108. /package/dist/cjs/src/{lib/queue → queue}/index.d.ts +0 -0
  109. /package/dist/cjs/src/{lib/queue → queue}/index.js +0 -0
  110. /package/dist/cjs/src/{lib/queue → queue}/type.js +0 -0
  111. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_curry1.d.ts +0 -0
  112. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_curry1.js +0 -0
  113. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_curry2.d.ts +0 -0
  114. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_curry2.js +0 -0
  115. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_curry3.d.ts +0 -0
  116. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_curry3.js +0 -0
  117. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_has.d.ts +0 -0
  118. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_has.js +0 -0
  119. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_isObject.d.ts +0 -0
  120. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_isObject.js +0 -0
  121. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_isPlaceholder.d.ts +0 -0
  122. /package/dist/cjs/src/{lib/ramda → ramda}/internal/_isPlaceholder.js +0 -0
  123. /package/dist/cjs/src/{lib/ramda → ramda}/mergeDeepRight.d.ts +0 -0
  124. /package/dist/cjs/src/{lib/ramda → ramda}/mergeDeepRight.js +0 -0
  125. /package/dist/cjs/src/{lib/ramda → ramda}/mergeDeepWithKey.d.ts +0 -0
  126. /package/dist/cjs/src/{lib/ramda → ramda}/mergeDeepWithKey.js +0 -0
  127. /package/dist/cjs/src/{lib/ramda → ramda}/mergeWithKey.d.ts +0 -0
  128. /package/dist/cjs/src/{lib/ramda → ramda}/mergeWithKey.js +0 -0
  129. /package/dist/cjs/src/{lib/storage → storage}/StorageManager.d.ts +0 -0
  130. /package/dist/cjs/src/{lib/storage → storage}/StorageManager.js +0 -0
  131. /package/dist/cjs/src/{lib/storage → storage}/built-in/blueprint.d.ts +0 -0
  132. /package/dist/cjs/src/{lib/storage → storage}/built-in/cookie.d.ts +0 -0
  133. /package/dist/cjs/src/{lib/storage → storage}/built-in/cookie.js +0 -0
  134. /package/dist/cjs/src/{lib/storage → storage}/built-in/memory.d.ts +0 -0
  135. /package/dist/cjs/src/{lib/storage → storage}/built-in/memory.js +0 -0
  136. /package/dist/cjs/src/{lib/storage → storage}/built-in/web.d.ts +0 -0
  137. /package/dist/cjs/src/{lib/storage → storage}/built-in/web.js +0 -0
  138. /package/dist/cjs/src/{lib/storage → storage}/constant.d.ts +0 -0
  139. /package/dist/cjs/src/{lib/storage → storage}/constant.js +0 -0
  140. /package/dist/cjs/src/{lib/storage → storage}/index.d.ts +0 -0
  141. /package/dist/cjs/src/{lib/storage → storage}/index.js +0 -0
  142. /package/dist/cjs/src/{lib/storage → storage}/type.d.ts +0 -0
  143. /package/dist/cjs/src/{lib/storage → storage}/type.js +0 -0
  144. /package/dist/esm/src/{lib/browser → browser}/browsers.d.ts +0 -0
  145. /package/dist/esm/src/{lib/browser → browser}/browsers.js +0 -0
  146. /package/dist/esm/src/{lib/event → event}/constants.d.ts +0 -0
  147. /package/dist/esm/src/{lib/event → event}/constants.js +0 -0
  148. /package/dist/esm/src/{lib/event → event}/index.d.ts +0 -0
  149. /package/dist/esm/src/{lib/event → event}/index.js +0 -0
  150. /package/dist/esm/src/{lib/event → event}/type.js +0 -0
  151. /package/dist/esm/src/{lib/logger → logger}/Logger.d.ts +0 -0
  152. /package/dist/esm/src/{lib/logger → logger}/Logger.js +0 -0
  153. /package/dist/esm/src/{lib/logger → logger}/index.d.ts +0 -0
  154. /package/dist/esm/src/{lib/logger → logger}/index.js +0 -0
  155. /package/dist/esm/src/{lib/logger → logger}/type.d.ts +0 -0
  156. /package/dist/esm/src/{lib/logger → logger}/type.js +0 -0
  157. /package/dist/esm/src/{lib/queue → queue}/index.d.ts +0 -0
  158. /package/dist/esm/src/{lib/queue → queue}/index.js +0 -0
  159. /package/dist/esm/src/{lib/queue → queue}/type.js +0 -0
  160. /package/dist/esm/src/{lib/ramda → ramda}/internal/_curry1.d.ts +0 -0
  161. /package/dist/esm/src/{lib/ramda → ramda}/internal/_curry1.js +0 -0
  162. /package/dist/esm/src/{lib/ramda → ramda}/internal/_curry2.d.ts +0 -0
  163. /package/dist/esm/src/{lib/ramda → ramda}/internal/_curry2.js +0 -0
  164. /package/dist/esm/src/{lib/ramda → ramda}/internal/_curry3.d.ts +0 -0
  165. /package/dist/esm/src/{lib/ramda → ramda}/internal/_curry3.js +0 -0
  166. /package/dist/esm/src/{lib/ramda → ramda}/internal/_has.d.ts +0 -0
  167. /package/dist/esm/src/{lib/ramda → ramda}/internal/_has.js +0 -0
  168. /package/dist/esm/src/{lib/ramda → ramda}/internal/_isObject.d.ts +0 -0
  169. /package/dist/esm/src/{lib/ramda → ramda}/internal/_isObject.js +0 -0
  170. /package/dist/esm/src/{lib/ramda → ramda}/internal/_isPlaceholder.d.ts +0 -0
  171. /package/dist/esm/src/{lib/ramda → ramda}/internal/_isPlaceholder.js +0 -0
  172. /package/dist/esm/src/{lib/ramda → ramda}/mergeDeepRight.d.ts +0 -0
  173. /package/dist/esm/src/{lib/ramda → ramda}/mergeDeepRight.js +0 -0
  174. /package/dist/esm/src/{lib/ramda → ramda}/mergeDeepWithKey.d.ts +0 -0
  175. /package/dist/esm/src/{lib/ramda → ramda}/mergeDeepWithKey.js +0 -0
  176. /package/dist/esm/src/{lib/ramda → ramda}/mergeWithKey.d.ts +0 -0
  177. /package/dist/esm/src/{lib/ramda → ramda}/mergeWithKey.js +0 -0
  178. /package/dist/esm/src/{lib/storage → storage}/StorageManager.d.ts +0 -0
  179. /package/dist/esm/src/{lib/storage → storage}/StorageManager.js +0 -0
  180. /package/dist/esm/src/{lib/storage → storage}/built-in/blueprint.d.ts +0 -0
  181. /package/dist/esm/src/{lib/storage → storage}/built-in/cookie.d.ts +0 -0
  182. /package/dist/esm/src/{lib/storage → storage}/built-in/cookie.js +0 -0
  183. /package/dist/esm/src/{lib/storage → storage}/built-in/memory.d.ts +0 -0
  184. /package/dist/esm/src/{lib/storage → storage}/built-in/memory.js +0 -0
  185. /package/dist/esm/src/{lib/storage → storage}/built-in/web.d.ts +0 -0
  186. /package/dist/esm/src/{lib/storage → storage}/built-in/web.js +0 -0
  187. /package/dist/esm/src/{lib/storage → storage}/constant.d.ts +0 -0
  188. /package/dist/esm/src/{lib/storage → storage}/constant.js +0 -0
  189. /package/dist/esm/src/{lib/storage → storage}/index.d.ts +0 -0
  190. /package/dist/esm/src/{lib/storage → storage}/index.js +0 -0
  191. /package/dist/esm/src/{lib/storage → storage}/type.d.ts +0 -0
  192. /package/dist/esm/src/{lib/storage → storage}/type.js +0 -0
@@ -0,0 +1,124 @@
1
+ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
2
+ function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
3
+ return new (P || (P = Promise))(function (resolve, reject) {
4
+ function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
5
+ function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
6
+ function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
7
+ step((generator = generator.apply(thisArg, _arguments || [])).next());
8
+ });
9
+ };
10
+ var __generator = (this && this.__generator) || function (thisArg, body) {
11
+ var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
12
+ return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
13
+ function verb(n) { return function (v) { return step([n, v]); }; }
14
+ function step(op) {
15
+ if (f) throw new TypeError("Generator is already executing.");
16
+ while (g && (g = 0, op[0] && (_ = 0)), _) try {
17
+ if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
18
+ if (y = 0, t) op = [op[0] & 2, t.value];
19
+ switch (op[0]) {
20
+ case 0: case 1: t = op; break;
21
+ case 4: _.label++; return { value: op[1], done: false };
22
+ case 5: _.label++; y = op[1]; op = [0]; continue;
23
+ case 7: op = _.ops.pop(); _.trys.pop(); continue;
24
+ default:
25
+ if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
26
+ if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
27
+ if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
28
+ if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
29
+ if (t[2]) _.ops.pop();
30
+ _.trys.pop(); continue;
31
+ }
32
+ op = body.call(thisArg, _);
33
+ } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
34
+ if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
35
+ }
36
+ };
37
+ var __rest = (this && this.__rest) || function (s, e) {
38
+ var t = {};
39
+ for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
40
+ t[p] = s[p];
41
+ if (s != null && typeof Object.getOwnPropertySymbols === "function")
42
+ for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
43
+ if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
44
+ t[p[i]] = s[p[i]];
45
+ }
46
+ return t;
47
+ };
48
+ function fetchWithRetry(input, init) {
49
+ return __awaiter(this, void 0, void 0, function () {
50
+ var _a, _b, retries, retryDelay, retryOn, fetchInit, _loop_1, attempt, state_1;
51
+ return __generator(this, function (_c) {
52
+ switch (_c.label) {
53
+ case 0:
54
+ _a = init || {}, _b = _a.retries, retries = _b === void 0 ? 0 : _b, retryDelay = _a.retryDelay, retryOn = _a.retryOn, fetchInit = __rest(_a, ["retries", "retryDelay", "retryOn"]);
55
+ _loop_1 = function (attempt) {
56
+ var isLastAttempt, response, responseError, error_1;
57
+ return __generator(this, function (_d) {
58
+ switch (_d.label) {
59
+ case 0:
60
+ isLastAttempt = attempt === retries;
61
+ _d.label = 1;
62
+ case 1:
63
+ _d.trys.push([1, 6, , 10]);
64
+ return [4 /*yield*/, globalThis.fetch(input, fetchInit)];
65
+ case 2:
66
+ response = _d.sent();
67
+ if (response.ok) {
68
+ return [2 /*return*/, { value: response }];
69
+ }
70
+ // On the last attempt, return whatever we got
71
+ if (isLastAttempt) {
72
+ return [2 /*return*/, { value: response }];
73
+ }
74
+ responseError = new Error(response.statusText);
75
+ responseError.response = response;
76
+ if (!(retryOn === null || retryOn === void 0 ? void 0 : retryOn(attempt, responseError, response))) return [3 /*break*/, 5];
77
+ if (!retryDelay) return [3 /*break*/, 4];
78
+ return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, retryDelay(attempt)); })];
79
+ case 3:
80
+ _d.sent();
81
+ _d.label = 4;
82
+ case 4: return [2 /*return*/, "continue"];
83
+ case 5: return [2 /*return*/, { value: response }];
84
+ case 6:
85
+ error_1 = _d.sent();
86
+ // On the last attempt, throw immediately
87
+ if (isLastAttempt) {
88
+ throw error_1;
89
+ }
90
+ if (!(retryOn === null || retryOn === void 0 ? void 0 : retryOn(attempt, error_1, null))) return [3 /*break*/, 9];
91
+ if (!retryDelay) return [3 /*break*/, 8];
92
+ return [4 /*yield*/, new Promise(function (resolve) { return setTimeout(resolve, retryDelay(attempt)); })];
93
+ case 7:
94
+ _d.sent();
95
+ _d.label = 8;
96
+ case 8: return [2 /*return*/, "continue"];
97
+ case 9: throw error_1;
98
+ case 10: return [2 /*return*/];
99
+ }
100
+ });
101
+ };
102
+ attempt = 0;
103
+ _c.label = 1;
104
+ case 1:
105
+ if (!(attempt <= retries)) return [3 /*break*/, 4];
106
+ return [5 /*yield**/, _loop_1(attempt)];
107
+ case 2:
108
+ state_1 = _c.sent();
109
+ if (typeof state_1 === "object")
110
+ return [2 /*return*/, state_1.value];
111
+ _c.label = 3;
112
+ case 3:
113
+ attempt++;
114
+ return [3 /*break*/, 1];
115
+ case 4:
116
+ // Unreachable — the loop always returns or throws on the last attempt.
117
+ // Required to satisfy TypeScript's control flow analysis.
118
+ throw new Error("Unexpected: retry loop exited without returning or throwing");
119
+ }
120
+ });
121
+ });
122
+ }
123
+ export default fetchWithRetry;
124
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,58 @@
1
+ /**
2
+ * Provider detection utilities for identifying wallet providers
3
+ */
4
+ import { EIP1193Provider } from "../types";
5
+ /**
6
+ * Default icon for providers without custom icons
7
+ */
8
+ export declare const DEFAULT_PROVIDER_ICON: "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzIiIGhlaWdodD0iMzIiIHZpZXdCb3g9IjAgMCAzMiAzMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjMyIiBoZWlnaHQ9IjMyIiBmaWxsPSIjRkZGIi8+CjxwYXRoIGQ9Ik0xNiA4TDggMjRoMTZMMTYgOHoiIGZpbGw9IiMzMzMiLz4KPC9zdmc+Cg==";
9
+ /**
10
+ * Common wallet provider flags used for detection
11
+ */
12
+ export interface WalletProviderFlags {
13
+ isMetaMask?: boolean;
14
+ isCoinbaseWallet?: boolean;
15
+ isWalletConnect?: boolean;
16
+ isTrust?: boolean;
17
+ isBraveWallet?: boolean;
18
+ isPhantom?: boolean;
19
+ }
20
+ /**
21
+ * Provider information returned by detection
22
+ */
23
+ export interface ProviderInfo {
24
+ name: string;
25
+ rdns: string;
26
+ uuid: string;
27
+ icon: `data:image/${string}`;
28
+ }
29
+ /**
30
+ * Attempts to detect information about an injected provider by examining
31
+ * common wallet-specific flags and properties.
32
+ *
33
+ * @param provider The injected provider to analyze
34
+ * @returns Provider information with fallback values if detection fails
35
+ *
36
+ * @example
37
+ * ```typescript
38
+ * const provider = window.ethereum;
39
+ * const info = detectInjectedProviderInfo(provider);
40
+ * console.log(info.name); // "MetaMask" or "Injected Provider"
41
+ * ```
42
+ */
43
+ export declare function detectInjectedProviderInfo(provider: EIP1193Provider): ProviderInfo;
44
+ /**
45
+ * Validates that a provider implements the required EIP-1193 interface
46
+ *
47
+ * @param provider The provider to validate
48
+ * @returns true if the provider has all required methods
49
+ *
50
+ * @example
51
+ * ```typescript
52
+ * if (isValidProvider(window.ethereum)) {
53
+ * // Safe to use provider
54
+ * }
55
+ * ```
56
+ */
57
+ export declare function isValidProvider(provider: EIP1193Provider | undefined | null): provider is EIP1193Provider;
58
+ //# sourceMappingURL=detection.d.ts.map
@@ -0,0 +1,98 @@
1
+ /**
2
+ * Provider detection utilities for identifying wallet providers
3
+ */
4
+ /**
5
+ * Default icon for providers without custom icons
6
+ */
7
+ export var DEFAULT_PROVIDER_ICON = "data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iMzIiIGhlaWdodD0iMzIiIHZpZXdCb3g9IjAgMCAzMiAzMiIgZmlsbD0ibm9uZSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIj4KPHJlY3Qgd2lkdGg9IjMyIiBoZWlnaHQ9IjMyIiBmaWxsPSIjRkZGIi8+CjxwYXRoIGQ9Ik0xNiA4TDggMjRoMTZMMTYgOHoiIGZpbGw9IiMzMzMiLz4KPC9zdmc+Cg==";
8
+ /**
9
+ * Known wallet providers with their identifying flags and metadata
10
+ */
11
+ var KNOWN_PROVIDERS = [
12
+ {
13
+ flag: 'isMetaMask',
14
+ name: 'MetaMask',
15
+ rdns: 'io.metamask',
16
+ },
17
+ {
18
+ flag: 'isCoinbaseWallet',
19
+ name: 'Coinbase Wallet',
20
+ rdns: 'com.coinbase.wallet',
21
+ },
22
+ {
23
+ flag: 'isWalletConnect',
24
+ name: 'WalletConnect',
25
+ rdns: 'com.walletconnect',
26
+ },
27
+ {
28
+ flag: 'isTrust',
29
+ name: 'Trust Wallet',
30
+ rdns: 'com.trustwallet',
31
+ },
32
+ {
33
+ flag: 'isBraveWallet',
34
+ name: 'Brave Wallet',
35
+ rdns: 'com.brave.wallet',
36
+ },
37
+ {
38
+ flag: 'isPhantom',
39
+ name: 'Phantom',
40
+ rdns: 'app.phantom',
41
+ },
42
+ ];
43
+ /**
44
+ * Attempts to detect information about an injected provider by examining
45
+ * common wallet-specific flags and properties.
46
+ *
47
+ * @param provider The injected provider to analyze
48
+ * @returns Provider information with fallback values if detection fails
49
+ *
50
+ * @example
51
+ * ```typescript
52
+ * const provider = window.ethereum;
53
+ * const info = detectInjectedProviderInfo(provider);
54
+ * console.log(info.name); // "MetaMask" or "Injected Provider"
55
+ * ```
56
+ */
57
+ export function detectInjectedProviderInfo(provider) {
58
+ // Default values for unknown providers
59
+ var name = "Injected Provider";
60
+ var rdns = "io.injected.provider";
61
+ // Cast to check for wallet-specific flags
62
+ var flags = provider;
63
+ // Check known providers in order of precedence
64
+ for (var _i = 0, KNOWN_PROVIDERS_1 = KNOWN_PROVIDERS; _i < KNOWN_PROVIDERS_1.length; _i++) {
65
+ var knownProvider = KNOWN_PROVIDERS_1[_i];
66
+ if (flags[knownProvider.flag]) {
67
+ name = knownProvider.name;
68
+ rdns = knownProvider.rdns;
69
+ break;
70
+ }
71
+ }
72
+ return {
73
+ name: name,
74
+ rdns: rdns,
75
+ uuid: "injected-".concat(rdns.replace(/[^a-zA-Z0-9]/g, "-")),
76
+ icon: DEFAULT_PROVIDER_ICON,
77
+ };
78
+ }
79
+ /**
80
+ * Validates that a provider implements the required EIP-1193 interface
81
+ *
82
+ * @param provider The provider to validate
83
+ * @returns true if the provider has all required methods
84
+ *
85
+ * @example
86
+ * ```typescript
87
+ * if (isValidProvider(window.ethereum)) {
88
+ * // Safe to use provider
89
+ * }
90
+ * ```
91
+ */
92
+ export function isValidProvider(provider) {
93
+ return (!!provider &&
94
+ typeof provider.request === "function" &&
95
+ typeof provider.on === "function" &&
96
+ typeof provider.removeListener === "function");
97
+ }
98
+ //# sourceMappingURL=detection.js.map
@@ -0,0 +1,6 @@
1
+ /**
2
+ * Provider-related exports
3
+ */
4
+ export { detectInjectedProviderInfo, isValidProvider, DEFAULT_PROVIDER_ICON, } from './detection';
5
+ export type { WalletProviderFlags, ProviderInfo, } from './detection';
6
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1,5 @@
1
+ /**
2
+ * Provider-related exports
3
+ */
4
+ export { detectInjectedProviderInfo, isValidProvider, DEFAULT_PROVIDER_ICON, } from './detection';
5
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1,56 @@
1
+ import { IFormoEvent, IFormoEventPayload } from "../types";
2
+ import { IEventQueue } from "./type";
3
+ type IFormoEventFlushPayload = IFormoEventPayload & {
4
+ sent_at: string;
5
+ };
6
+ type Options = {
7
+ apiHost: string;
8
+ flushAt?: number;
9
+ flushInterval?: number;
10
+ host?: string;
11
+ retryCount?: number;
12
+ errorHandler?: any;
13
+ maxQueueSize?: number;
14
+ };
15
+ export declare class EventQueue implements IEventQueue {
16
+ private writeKey;
17
+ private apiHost;
18
+ private queue;
19
+ private timer;
20
+ private flushAt;
21
+ private flushIntervalMs;
22
+ private flushed;
23
+ private maxQueueSize;
24
+ private errorHandler;
25
+ private retryCount;
26
+ private pendingFlush;
27
+ private payloadHashes;
28
+ constructor(writeKey: string, options: Options);
29
+ private generateMessageId;
30
+ enqueue(event: IFormoEvent, callback?: (...args: any) => void): Promise<void>;
31
+ flush(callback?: (...args: any) => void): Promise<void | IFormoEventFlushPayload[]>;
32
+ /**
33
+ * Returns the UTF-8 byte length of a string. The browser's keepalive limit
34
+ * is enforced on the wire (UTF-8 bytes), not on JS string length (UTF-16
35
+ * code units). Non-ASCII characters (CJK, emoji) can be 2–4x larger in
36
+ * UTF-8 than their string .length suggests.
37
+ */
38
+ private static byteLength;
39
+ /**
40
+ * Splits events into batches that respect the browser's 64KB keepalive
41
+ * payload size limit. Each batch pairs its serialized data with the
42
+ * original queue items (for per-item callback reporting) and a flag
43
+ * indicating whether keepalive is safe to use.
44
+ */
45
+ private splitIntoBatches;
46
+ /**
47
+ * Sends batches sequentially, notifying per-item callbacks on success/failure.
48
+ * Returns the first error encountered (if any) so the caller can report it.
49
+ */
50
+ private sendBatches;
51
+ private isErrorRetryable;
52
+ private isDuplicate;
53
+ private onPageLeave;
54
+ }
55
+ export {};
56
+ //# sourceMappingURL=EventQueue.d.ts.map
@@ -45,12 +45,22 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
45
45
  if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
46
46
  }
47
47
  };
48
- import { isNetworkError } from "../../validators";
49
- import { clampNumber, getActionDescriptor, hash, millisecondsToSecond, toDateHourMinute, } from "../../utils";
48
+ import { isNetworkError } from "../validators";
49
+ import { clampNumber, getActionDescriptor, hash, millisecondsToSecond, toDateHourMinute, } from "../utils";
50
50
  import { logger } from "../logger";
51
- import { EVENTS_API_REQUEST_HEADER } from "../../constants";
51
+ import { EVENTS_API_REQUEST_HEADER } from "../constants";
52
52
  import fetch from "../fetch";
53
53
  var noop = function () { };
54
+ var safeCall = function (fn) {
55
+ var args = [];
56
+ for (var _i = 1; _i < arguments.length; _i++) {
57
+ args[_i - 1] = arguments[_i];
58
+ }
59
+ try {
60
+ fn.apply(void 0, args);
61
+ }
62
+ catch ( /* swallow */_a) { /* swallow */ }
63
+ };
54
64
  var DEFAULT_RETRY = 3;
55
65
  var MAX_RETRY = 5;
56
66
  var MIN_RETRY = 1;
@@ -60,6 +70,10 @@ var MIN_FLUSH_AT = 1;
60
70
  var DEFAULT_QUEUE_SIZE = 1024 * 500; // 500kB
61
71
  var MAX_QUEUE_SIZE = 1024 * 500; // 500kB
62
72
  var MIN_QUEUE_SIZE = 200; // 200 bytes
73
+ // Browsers enforce a 64KB limit on the total body size of in-flight
74
+ // keepalive fetch requests. Payloads exceeding this are silently cancelled,
75
+ // producing a TypeError: Failed to fetch that cannot be resolved by retrying.
76
+ var KEEPALIVE_PAYLOAD_LIMIT = 64 * 1024; // 64kB
63
77
  var DEFAULT_FLUSH_INTERVAL = 1000 * 30; // 1 MINUTE
64
78
  var MAX_FLUSH_INTERVAL = 1000 * 300; // 5 MINUTES
65
79
  var MIN_FLUSH_INTERVAL = 1000 * 10; // 10 SECONDS
@@ -144,7 +158,6 @@ var EventQueue = /** @class */ (function () {
144
158
  });
145
159
  }); });
146
160
  }
147
- //#region Public functions
148
161
  EventQueue.prototype.generateMessageId = function (event) {
149
162
  return __awaiter(this, void 0, void 0, function () {
150
163
  var formattedTimestamp, eventForHashing, eventString;
@@ -200,7 +213,7 @@ var EventQueue = /** @class */ (function () {
200
213
  };
201
214
  EventQueue.prototype.flush = function (callback) {
202
215
  return __awaiter(this, void 0, void 0, function () {
203
- var err_1, items, sentAt, data, done;
216
+ var items, sentAt, data, batches;
204
217
  var _this = this;
205
218
  return __generator(this, function (_a) {
206
219
  switch (_a.label) {
@@ -214,75 +227,171 @@ var EventQueue = /** @class */ (function () {
214
227
  callback();
215
228
  return [2 /*return*/, Promise.resolve()];
216
229
  }
217
- _a.label = 1;
218
- case 1:
219
- _a.trys.push([1, 4, , 5]);
220
- if (!this.pendingFlush) return [3 /*break*/, 3];
230
+ if (!this.pendingFlush) return [3 /*break*/, 2];
221
231
  return [4 /*yield*/, this.pendingFlush];
222
- case 2:
232
+ case 1:
223
233
  _a.sent();
224
- _a.label = 3;
225
- case 3: return [3 /*break*/, 5];
226
- case 4:
227
- err_1 = _a.sent();
228
- this.pendingFlush = null;
229
- throw err_1;
230
- case 5:
234
+ _a.label = 2;
235
+ case 2:
231
236
  items = this.queue.splice(0, this.flushAt);
232
237
  this.payloadHashes.clear();
233
238
  sentAt = new Date().toISOString();
234
239
  data = items.map(function (item) { return (__assign(__assign({}, item.message), { sent_at: sentAt })); });
235
- done = function (err) {
236
- items.forEach(function (_a) {
237
- var message = _a.message, callback = _a.callback;
238
- return callback(err, message, data);
239
- });
240
- callback(err, data);
241
- };
242
- return [2 /*return*/, (this.pendingFlush = fetch("".concat(this.apiHost), {
243
- headers: EVENTS_API_REQUEST_HEADER(this.writeKey),
244
- method: "POST",
245
- body: JSON.stringify(data),
246
- keepalive: true,
247
- retries: this.retryCount,
248
- retryDelay: function (attempt) { return Math.pow(2, attempt) * 1000; }, // exponential backoff
249
- retryOn: function (_, error) { return _this.isErrorRetryable(error); },
250
- })
251
- .then(function () {
252
- done();
240
+ batches = this.splitIntoBatches(items, data);
241
+ return [2 /*return*/, (this.pendingFlush = this.sendBatches(batches, data)
242
+ .then(function (firstError) {
243
+ if (firstError) {
244
+ safeCall(callback, firstError, data);
245
+ if (typeof _this.errorHandler === "function") {
246
+ safeCall(_this.errorHandler, firstError);
247
+ }
248
+ }
249
+ else {
250
+ safeCall(callback, undefined, data);
251
+ }
253
252
  return Promise.resolve(data);
254
253
  })
255
254
  .catch(function (err) {
255
+ // Defensive: should not be reachable since sendBatches catches
256
+ // all errors internally, but guard against unexpected failures.
257
+ safeCall(callback, err, data);
256
258
  if (typeof _this.errorHandler === "function") {
257
- done(err);
258
- return _this.errorHandler(err);
259
- }
260
- if (err.response) {
261
- var error = new Error(err.response.statusText);
262
- done(error);
263
- throw error;
259
+ safeCall(_this.errorHandler, err);
264
260
  }
265
- done(err);
266
- throw err;
261
+ // Do NOT re-throw — analytics errors should never
262
+ // propagate as unhandled rejections to the host app
267
263
  }))];
268
264
  }
269
265
  });
270
266
  });
271
267
  };
272
- //#region Utility functions
273
- EventQueue.prototype.isErrorRetryable = function (error) {
274
- var _a, _b, _c;
268
+ /**
269
+ * Returns the UTF-8 byte length of a string. The browser's keepalive limit
270
+ * is enforced on the wire (UTF-8 bytes), not on JS string length (UTF-16
271
+ * code units). Non-ASCII characters (CJK, emoji) can be 2–4x larger in
272
+ * UTF-8 than their string .length suggests.
273
+ */
274
+ EventQueue.byteLength = function (str) {
275
+ return new TextEncoder().encode(str).byteLength;
276
+ };
277
+ /**
278
+ * Splits events into batches that respect the browser's 64KB keepalive
279
+ * payload size limit. Each batch pairs its serialized data with the
280
+ * original queue items (for per-item callback reporting) and a flag
281
+ * indicating whether keepalive is safe to use.
282
+ */
283
+ EventQueue.prototype.splitIntoBatches = function (items, data) {
284
+ var serialized = JSON.stringify(data);
285
+ if (EventQueue.byteLength(serialized) <= KEEPALIVE_PAYLOAD_LIMIT) {
286
+ return [{ data: data, items: items, keepalive: true }];
287
+ }
288
+ var batches = [];
289
+ var currentData = [];
290
+ var currentItems = [];
291
+ var currentSize = 2; // account for JSON array brackets "[]"
292
+ for (var i = 0; i < data.length; i++) {
293
+ var event_1 = data[i];
294
+ var eventSize = EventQueue.byteLength(JSON.stringify(event_1));
295
+ var sizeWithEvent = currentSize + (currentData.length > 0 ? 1 : 0) + eventSize;
296
+ if (sizeWithEvent > KEEPALIVE_PAYLOAD_LIMIT) {
297
+ if (currentData.length > 0) {
298
+ batches.push({ data: currentData, items: currentItems, keepalive: true });
299
+ }
300
+ // If a single event exceeds the limit, send it without keepalive
301
+ if (eventSize + 2 > KEEPALIVE_PAYLOAD_LIMIT) {
302
+ batches.push({ data: [event_1], items: [items[i]], keepalive: false });
303
+ currentData = [];
304
+ currentItems = [];
305
+ currentSize = 2;
306
+ }
307
+ else {
308
+ currentData = [event_1];
309
+ currentItems = [items[i]];
310
+ currentSize = 2 + eventSize;
311
+ }
312
+ }
313
+ else {
314
+ currentData.push(event_1);
315
+ currentItems.push(items[i]);
316
+ currentSize = sizeWithEvent;
317
+ }
318
+ }
319
+ if (currentData.length > 0) {
320
+ batches.push({ data: currentData, items: currentItems, keepalive: true });
321
+ }
322
+ return batches;
323
+ };
324
+ /**
325
+ * Sends batches sequentially, notifying per-item callbacks on success/failure.
326
+ * Returns the first error encountered (if any) so the caller can report it.
327
+ */
328
+ EventQueue.prototype.sendBatches = function (batches, allData) {
329
+ return __awaiter(this, void 0, void 0, function () {
330
+ var firstError, _i, batches_1, batch, body, response, error, err_1;
331
+ var _this = this;
332
+ return __generator(this, function (_a) {
333
+ switch (_a.label) {
334
+ case 0:
335
+ _i = 0, batches_1 = batches;
336
+ _a.label = 1;
337
+ case 1:
338
+ if (!(_i < batches_1.length)) return [3 /*break*/, 6];
339
+ batch = batches_1[_i];
340
+ _a.label = 2;
341
+ case 2:
342
+ _a.trys.push([2, 4, , 5]);
343
+ body = JSON.stringify(batch.data);
344
+ return [4 /*yield*/, fetch("".concat(this.apiHost), {
345
+ headers: EVENTS_API_REQUEST_HEADER(this.writeKey),
346
+ method: "POST",
347
+ body: body,
348
+ keepalive: batch.keepalive,
349
+ retries: this.retryCount,
350
+ retryDelay: function (attempt) { return Math.pow(2, attempt) * 1000; },
351
+ retryOn: function (_, error, response) { return _this.isErrorRetryable(error, response); },
352
+ })];
353
+ case 3:
354
+ response = _a.sent();
355
+ if (!response.ok) {
356
+ error = new Error(response.statusText || "HTTP ".concat(response.status));
357
+ error.response = response;
358
+ throw error;
359
+ }
360
+ batch.items.forEach(function (_a) {
361
+ var message = _a.message, cb = _a.callback;
362
+ return safeCall(cb, undefined, message, allData);
363
+ });
364
+ return [3 /*break*/, 5];
365
+ case 4:
366
+ err_1 = _a.sent();
367
+ firstError = firstError || err_1;
368
+ batch.items.forEach(function (_a) {
369
+ var message = _a.message, cb = _a.callback;
370
+ return safeCall(cb, err_1, message, allData);
371
+ });
372
+ return [3 /*break*/, 5];
373
+ case 5:
374
+ _i++;
375
+ return [3 /*break*/, 1];
376
+ case 6: return [2 /*return*/, firstError];
377
+ }
378
+ });
379
+ });
380
+ };
381
+ EventQueue.prototype.isErrorRetryable = function (error, response) {
382
+ var _a, _b;
275
383
  // Retry Network Errors.
276
- if (isNetworkError(error))
384
+ if (error && isNetworkError(error))
277
385
  return true;
278
- // Cannot determine if the request can be retried
279
- if (!(error === null || error === void 0 ? void 0 : error.response))
386
+ // Check response status if available
387
+ var status = (_a = response === null || response === void 0 ? void 0 : response.status) !== null && _a !== void 0 ? _a : (_b = error === null || error === void 0 ? void 0 : error.response) === null || _b === void 0 ? void 0 : _b.status;
388
+ if (!status)
280
389
  return false;
281
390
  // Retry Server Errors (5xx).
282
- if (((_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.status) >= 500 && ((_b = error === null || error === void 0 ? void 0 : error.response) === null || _b === void 0 ? void 0 : _b.status) <= 599)
391
+ if (status >= 500 && status <= 599)
283
392
  return true;
284
393
  // Retry if rate limited.
285
- if (((_c = error === null || error === void 0 ? void 0 : error.response) === null || _c === void 0 ? void 0 : _c.status) === 429)
394
+ if (status === 429)
286
395
  return true;
287
396
  return false;
288
397
  };
@@ -1,4 +1,4 @@
1
- import { IFormoEvent } from "../../types";
1
+ import { IFormoEvent } from "../types";
2
2
  export interface IEventQueue {
3
3
  enqueue(event: IFormoEvent, callback?: (...args: any) => void): Promise<void>;
4
4
  flush(callback?: (...args: any) => void): Promise<any>;