@drip-apex/sdk 0.1.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 (227) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +46 -0
  3. package/dist/_headers +3 -0
  4. package/dist/bundle-report.json +564 -0
  5. package/dist/drip.debug.js +2 -0
  6. package/dist/drip.debug.js.map +1 -0
  7. package/dist/drip.heatmap.js +2 -0
  8. package/dist/drip.heatmap.js.map +1 -0
  9. package/dist/drip.js +2 -0
  10. package/dist/drip.js.map +1 -0
  11. package/dist/drip.live.js +2 -0
  12. package/dist/drip.live.js.map +1 -0
  13. package/dist/editor.js +480 -0
  14. package/dist/editor.js.map +7 -0
  15. package/dist/index.mjs +645 -0
  16. package/dist/index.mjs.map +7 -0
  17. package/dist/metafiles/drip.debug.meta.json +973 -0
  18. package/dist/metafiles/drip.heatmap.meta.json +918 -0
  19. package/dist/metafiles/drip.live.meta.json +918 -0
  20. package/dist/metafiles/drip.meta.json +973 -0
  21. package/dist/metafiles/editor.meta.json +321 -0
  22. package/dist/metafiles/index.meta.json +1039 -0
  23. package/dist/metafiles/index.mjs.meta.json +78 -0
  24. package/dist/react/index.js +16973 -0
  25. package/dist/react/index.js.map +7 -0
  26. package/dist/sri.json +27 -0
  27. package/dist/types/analytics.d.ts +15 -0
  28. package/dist/types/antiflicker.d.ts +14 -0
  29. package/dist/types/assignment-store.d.ts +30 -0
  30. package/dist/types/audit.d.ts +9 -0
  31. package/dist/types/bucket.d.ts +2 -0
  32. package/dist/types/bucketing-cleanup.d.ts +5 -0
  33. package/dist/types/commerce-gift.d.ts +41 -0
  34. package/dist/types/commerce-price.d.ts +22 -0
  35. package/dist/types/commerce-shipping.d.ts +28 -0
  36. package/dist/types/css.d.ts +5 -0
  37. package/dist/types/cwv.d.ts +10 -0
  38. package/dist/types/data-layer-normalize.d.ts +1 -0
  39. package/dist/types/debug.d.ts +23 -0
  40. package/dist/types/define.d.ts +87 -0
  41. package/dist/types/devtools.d.ts +32 -0
  42. package/dist/types/dom-trigger.d.ts +3 -0
  43. package/dist/types/editor/api.d.ts +37 -0
  44. package/dist/types/editor/artifacts.d.ts +15 -0
  45. package/dist/types/editor/command-runtime.d.ts +48 -0
  46. package/dist/types/editor/controller.d.ts +97 -0
  47. package/dist/types/editor/device-preview.d.ts +23 -0
  48. package/dist/types/editor/index.d.ts +9 -0
  49. package/dist/types/editor/operator.d.ts +39 -0
  50. package/dist/types/editor/picker.d.ts +23 -0
  51. package/dist/types/editor/selector.d.ts +2 -0
  52. package/dist/types/editor/types.d.ts +55 -0
  53. package/dist/types/editor/view-kit.d.ts +33 -0
  54. package/dist/types/editor/view.d.ts +5 -0
  55. package/dist/types/editor-bootstrap.d.ts +37 -0
  56. package/dist/types/exclusion-groups.d.ts +59 -0
  57. package/dist/types/exposure-signals.d.ts +7 -0
  58. package/dist/types/flags.d.ts +65 -0
  59. package/dist/types/goals.d.ts +16 -0
  60. package/dist/types/guards.d.ts +39 -0
  61. package/dist/types/handover.d.ts +10 -0
  62. package/dist/types/hash.d.ts +19 -0
  63. package/dist/types/heatmap.d.ts +8 -0
  64. package/dist/types/hideflicker.d.ts +15 -0
  65. package/dist/types/hydration.d.ts +11 -0
  66. package/dist/types/index.d.ts +144 -0
  67. package/dist/types/js.d.ts +6 -0
  68. package/dist/types/module.d.ts +4 -0
  69. package/dist/types/money.d.ts +14 -0
  70. package/dist/types/mutate.d.ts +34 -0
  71. package/dist/types/observer-mute.d.ts +3 -0
  72. package/dist/types/pii-keys.d.ts +1 -0
  73. package/dist/types/prerequisites.d.ts +12 -0
  74. package/dist/types/qa-assistant-state.d.ts +68 -0
  75. package/dist/types/qa-assistant-view.d.ts +6 -0
  76. package/dist/types/qa-assistant.d.ts +9 -0
  77. package/dist/types/qa-toolbar.d.ts +19 -0
  78. package/dist/types/react/index.d.ts +84 -0
  79. package/dist/types/reassert-sentinel.d.ts +6 -0
  80. package/dist/types/router.d.ts +9 -0
  81. package/dist/types/runtime-tools.d.ts +50 -0
  82. package/dist/types/runtime.d.ts +22 -0
  83. package/dist/types/safe-regex.d.ts +6 -0
  84. package/dist/types/sanitize.d.ts +5 -0
  85. package/dist/types/semantic.d.ts +7 -0
  86. package/dist/types/shopify-cart-events.d.ts +7 -0
  87. package/dist/types/shopify-cart.d.ts +62 -0
  88. package/dist/types/signals.d.ts +31 -0
  89. package/dist/types/surface-signals.d.ts +6 -0
  90. package/dist/types/targeting-diagnostics.d.ts +5 -0
  91. package/dist/types/targeting.d.ts +50 -0
  92. package/dist/types/test-fixtures/commerce.d.ts +12 -0
  93. package/dist/types/track.d.ts +79 -0
  94. package/dist/types/types.d.ts +859 -0
  95. package/dist/types/wait.d.ts +7 -0
  96. package/package.json +74 -0
  97. package/src/analytics.ts +146 -0
  98. package/src/antiflicker.test.ts +127 -0
  99. package/src/antiflicker.ts +147 -0
  100. package/src/assignment-store.test.ts +171 -0
  101. package/src/assignment-store.ts +208 -0
  102. package/src/audit.test.ts +17 -0
  103. package/src/audit.ts +362 -0
  104. package/src/bucket.test.ts +65 -0
  105. package/src/bucket.ts +18 -0
  106. package/src/bucketing-cleanup.test.ts +30 -0
  107. package/src/bucketing-cleanup.ts +72 -0
  108. package/src/bucketing-parity.test.ts +41 -0
  109. package/src/commerce-analytics-lifecycle.test.ts +1416 -0
  110. package/src/commerce-config-lifecycle.test.ts +274 -0
  111. package/src/commerce-epoch-lifecycle.test.ts +62 -0
  112. package/src/commerce-gift.test.ts +1293 -0
  113. package/src/commerce-gift.ts +979 -0
  114. package/src/commerce-offers-display.test.ts +154 -0
  115. package/src/commerce-price.test.ts +1145 -0
  116. package/src/commerce-price.ts +941 -0
  117. package/src/commerce-revocation-lifecycle.test.ts +78 -0
  118. package/src/commerce-shipping.test.ts +630 -0
  119. package/src/commerce-shipping.ts +447 -0
  120. package/src/config-fetch.test.ts +325 -0
  121. package/src/css.ts +54 -0
  122. package/src/cwv.test.ts +95 -0
  123. package/src/cwv.ts +129 -0
  124. package/src/data-layer-normalize.ts +21 -0
  125. package/src/debug.test.ts +83 -0
  126. package/src/debug.ts +138 -0
  127. package/src/define.test.ts +327 -0
  128. package/src/define.ts +208 -0
  129. package/src/devtools.ts +582 -0
  130. package/src/dom-trigger.test.ts +70 -0
  131. package/src/dom-trigger.ts +55 -0
  132. package/src/editor/api.test.ts +154 -0
  133. package/src/editor/api.ts +185 -0
  134. package/src/editor/artifacts.test.ts +57 -0
  135. package/src/editor/artifacts.ts +115 -0
  136. package/src/editor/command-runtime.test.ts +225 -0
  137. package/src/editor/command-runtime.ts +572 -0
  138. package/src/editor/controller.test.ts +371 -0
  139. package/src/editor/controller.ts +596 -0
  140. package/src/editor/device-preview.test.ts +60 -0
  141. package/src/editor/device-preview.ts +120 -0
  142. package/src/editor/index.test.ts +161 -0
  143. package/src/editor/index.ts +169 -0
  144. package/src/editor/operator.test.ts +148 -0
  145. package/src/editor/operator.ts +256 -0
  146. package/src/editor/picker.test.ts +58 -0
  147. package/src/editor/picker.ts +152 -0
  148. package/src/editor/selector.test.ts +44 -0
  149. package/src/editor/selector.ts +110 -0
  150. package/src/editor/types.ts +92 -0
  151. package/src/editor/view-kit.ts +162 -0
  152. package/src/editor/view.test.ts +535 -0
  153. package/src/editor/view.ts +1395 -0
  154. package/src/editor-bootstrap.test.ts +116 -0
  155. package/src/editor-bootstrap.ts +213 -0
  156. package/src/event-schema-contract.test.ts +35 -0
  157. package/src/exclusion-groups.test.ts +383 -0
  158. package/src/exclusion-groups.ts +270 -0
  159. package/src/exposure-signals.test.ts +182 -0
  160. package/src/exposure-signals.ts +110 -0
  161. package/src/flags.test.ts +322 -0
  162. package/src/flags.ts +201 -0
  163. package/src/goals.test.ts +42 -0
  164. package/src/goals.ts +200 -0
  165. package/src/guards.test.ts +249 -0
  166. package/src/guards.ts +250 -0
  167. package/src/handover-cache-order.test.ts +32 -0
  168. package/src/handover.test.ts +349 -0
  169. package/src/handover.ts +309 -0
  170. package/src/hash.ts +214 -0
  171. package/src/heatmap.test.ts +305 -0
  172. package/src/heatmap.ts +373 -0
  173. package/src/hideflicker.ts +21 -0
  174. package/src/hydration.test.ts +252 -0
  175. package/src/hydration.ts +203 -0
  176. package/src/index.ts +7513 -0
  177. package/src/init-empty.test.ts +5572 -0
  178. package/src/js.test.ts +26 -0
  179. package/src/js.ts +61 -0
  180. package/src/module.ts +50 -0
  181. package/src/money.test.ts +35 -0
  182. package/src/money.ts +53 -0
  183. package/src/mutate.test.ts +304 -0
  184. package/src/mutate.ts +469 -0
  185. package/src/observer-mute.test.ts +88 -0
  186. package/src/observer-mute.ts +45 -0
  187. package/src/page-trigger.test.ts +84 -0
  188. package/src/personalization.test.ts +68 -0
  189. package/src/pii-keys.ts +17 -0
  190. package/src/prerequisites.test.ts +39 -0
  191. package/src/prerequisites.ts +94 -0
  192. package/src/qa-assistant-state.test.ts +471 -0
  193. package/src/qa-assistant-state.ts +505 -0
  194. package/src/qa-assistant-view.test.ts +185 -0
  195. package/src/qa-assistant-view.ts +768 -0
  196. package/src/qa-assistant.ts +40 -0
  197. package/src/qa-toolbar.ts +444 -0
  198. package/src/react/index.test.tsx +177 -0
  199. package/src/react/index.tsx +252 -0
  200. package/src/reassert-sentinel.test.ts +314 -0
  201. package/src/reassert-sentinel.ts +191 -0
  202. package/src/router.test.ts +78 -0
  203. package/src/router.ts +92 -0
  204. package/src/runtime-tools.test.ts +112 -0
  205. package/src/runtime-tools.ts +403 -0
  206. package/src/runtime.test.ts +217 -0
  207. package/src/runtime.ts +268 -0
  208. package/src/safe-regex.ts +35 -0
  209. package/src/sanitize.ts +34 -0
  210. package/src/semantic.ts +245 -0
  211. package/src/shopify-cart-events.test.ts +76 -0
  212. package/src/shopify-cart-events.ts +115 -0
  213. package/src/shopify-cart.test.ts +2823 -0
  214. package/src/shopify-cart.ts +1256 -0
  215. package/src/signals.ts +226 -0
  216. package/src/surface-signals.test.ts +83 -0
  217. package/src/surface-signals.ts +165 -0
  218. package/src/targeting-diagnostics.ts +560 -0
  219. package/src/targeting.detailed.test.ts +443 -0
  220. package/src/targeting.test.ts +1054 -0
  221. package/src/targeting.ts +1024 -0
  222. package/src/test-fixtures/commerce.ts +65 -0
  223. package/src/track.test.ts +817 -0
  224. package/src/track.ts +519 -0
  225. package/src/types.ts +991 -0
  226. package/src/wait.test.ts +96 -0
  227. package/src/wait.ts +238 -0
@@ -0,0 +1,185 @@
1
+ // @vitest-environment jsdom
2
+ import { afterEach, describe, expect, it, vi } from "vitest";
3
+ import type { QaAssistantState, QaAssistantStore } from "./qa-assistant-state";
4
+ import { mountQaAssistantView, QA_ASSISTANT_HOST_ID } from "./qa-assistant-view";
5
+
6
+ function state(subline = "Showing Variant B"): QaAssistantState {
7
+ return {
8
+ experiments: [{
9
+ id: "exp_products", name: "Product CTA", variationId: "var_b", variationName: "Variant B",
10
+ applied: true, forced: false, subline,
11
+ triggerPill: "accepted", segmentPill: "all visitors", displayFrequencyPill: "accepted",
12
+ conditions: [{
13
+ id: "page:products", group: "pages", state: "pass", text: "Product pages",
14
+ detail: 'Expected: [{"include":true,"matchType":"simple","pattern":"/products/*"}] · Actual: https://shop.test/products/shirt — passed',
15
+ rawCode: null,
16
+ }],
17
+ variations: [
18
+ { id: "var_a", name: "Control", isControl: true, isCurrent: false, isReal: true },
19
+ { id: "var_b", name: "Variant B", isControl: false, isCurrent: true, isReal: true },
20
+ ],
21
+ }],
22
+ events: [], transactions: { kind: "unsupported" }, forcedSummary: null,
23
+ };
24
+ }
25
+
26
+ function fakeStore(initial: QaAssistantState) {
27
+ let current = initial;
28
+ const listeners = new Set<(value: QaAssistantState) => void>();
29
+ const store: QaAssistantStore = {
30
+ getState: () => current,
31
+ subscribe(listener) { listeners.add(listener); return () => listeners.delete(listener); },
32
+ forceVariation: vi.fn(), resetForce: vi.fn(), exitQa: vi.fn(),
33
+ };
34
+ return { store, emit(next: QaAssistantState) { current = next; listeners.forEach((listener) => listener(next)); } };
35
+ }
36
+
37
+ afterEach(() => {
38
+ document.body.innerHTML = "";
39
+ vi.useRealTimers();
40
+ });
41
+
42
+ describe("mountQaAssistantView", () => {
43
+ it("coalesces refresh bursts while preserving the panel, expanded rows, and scroll", () => {
44
+ vi.useFakeTimers();
45
+ const source = fakeStore(state());
46
+ const view = mountQaAssistantView(source.store);
47
+ const shadow = document.getElementById(QA_ASSISTANT_HOST_ID)!.shadowRoot!;
48
+ const panel = shadow.querySelector(".panel")!;
49
+ (shadow.querySelector('[data-action="toggle-exp"]') as HTMLElement).click();
50
+ const body = shadow.querySelector<HTMLElement>(".body")!;
51
+ body.scrollTop = 37;
52
+
53
+ source.emit(state("refresh one"));
54
+ source.emit(state("refresh two"));
55
+ expect(shadow.querySelector(".panel")).toBe(panel);
56
+ vi.advanceTimersByTime(100);
57
+
58
+ expect(shadow.querySelector(".panel")).toBe(panel);
59
+ expect(shadow.querySelector('[data-action="toggle-exp"]')?.getAttribute("data-open")).toBe("true");
60
+ expect(body.scrollTop).toBe(37);
61
+ expect(shadow.textContent).toContain('/products/*');
62
+ view.destroy();
63
+ });
64
+
65
+ it("keeps in-progress search text across store-driven refreshes", () => {
66
+ vi.useFakeTimers();
67
+ const source = fakeStore(state());
68
+ const view = mountQaAssistantView(source.store);
69
+ const shadow = document.getElementById(QA_ASSISTANT_HOST_ID)!.shadowRoot!;
70
+ const search = shadow.querySelector<HTMLInputElement>('[data-action="search"]')!;
71
+ search.focus();
72
+ search.value = "cta";
73
+ search.dispatchEvent(new Event("input", { bubbles: true }));
74
+
75
+ source.emit(state("refresh while typing"));
76
+ vi.advanceTimersByTime(100);
77
+
78
+ const rebuilt = shadow.querySelector<HTMLInputElement>('[data-action="search"]')!;
79
+ expect(rebuilt.value).toBe("cta");
80
+ view.destroy();
81
+ });
82
+
83
+ it("shows unevaluated targeting honestly in details and excludes it from the on-page filter", () => {
84
+ const base = state();
85
+ const unevaluated: QaAssistantState = {
86
+ ...base,
87
+ experiments: [{
88
+ ...base.experiments[0],
89
+ applied: false,
90
+ triggerPill: "not evaluated",
91
+ segmentPill: "not evaluated",
92
+ displayFrequencyPill: "not running",
93
+ conditions: [],
94
+ }],
95
+ };
96
+ const source = fakeStore(unevaluated);
97
+ const view = mountQaAssistantView(source.store);
98
+ const shadow = document.getElementById(QA_ASSISTANT_HOST_ID)!.shadowRoot!;
99
+ (shadow.querySelector('[data-action="toggle-exp"]') as HTMLElement).click();
100
+ const text = shadow.textContent ?? "";
101
+ expect(text).toContain("Not evaluated");
102
+ expect(text).not.toContain("All pages");
103
+ expect(text).not.toContain("All visitors");
104
+
105
+ const pageFilter = shadow.querySelector<HTMLSelectElement>('[data-action="page-filter"]')!;
106
+ pageFilter.value = "on";
107
+ pageFilter.dispatchEvent(new Event("change", { bubbles: true }));
108
+ expect(shadow.textContent).not.toContain("Product CTA");
109
+ view.destroy();
110
+ });
111
+
112
+ it("filters a targeting-rejected force request as not applied, not forced", () => {
113
+ const base = state();
114
+ const rejectedRequest: QaAssistantState = {
115
+ ...base,
116
+ experiments: [{
117
+ ...base.experiments[0],
118
+ applied: false,
119
+ forced: false,
120
+ variationId: null,
121
+ variationName: null,
122
+ subline: "Product pages",
123
+ triggerPill: "rejected",
124
+ displayFrequencyPill: "not evaluated",
125
+ }],
126
+ forcedSummary: "Product CTA: Variant B",
127
+ };
128
+ const source = fakeStore(rejectedRequest);
129
+ const view = mountQaAssistantView(source.store);
130
+ const shadow = document.getElementById(QA_ASSISTANT_HOST_ID)!.shadowRoot!;
131
+
132
+ expect(shadow.querySelector(".exp .chip-off")?.textContent).toBe("Not applied");
133
+ expect(shadow.querySelector(".exp .chip-forced")).toBeNull();
134
+
135
+ const statusFilter = shadow.querySelector<HTMLSelectElement>('[data-action="status-filter"]')!;
136
+ statusFilter.value = "forced";
137
+ statusFilter.dispatchEvent(new Event("change", { bubbles: true }));
138
+ expect(shadow.querySelectorAll(".exp")).toHaveLength(0);
139
+
140
+ const rebuiltFilter = shadow.querySelector<HTMLSelectElement>('[data-action="status-filter"]')!;
141
+ rebuiltFilter.value = "rejected";
142
+ rebuiltFilter.dispatchEvent(new Event("change", { bubbles: true }));
143
+ expect(shadow.querySelectorAll(".exp")).toHaveLength(1);
144
+ expect(shadow.querySelector(".exp .chip-off")?.textContent).toBe("Not applied");
145
+ view.destroy();
146
+ });
147
+
148
+ it("preserves the search input and defers filtering during IME composition", () => {
149
+ vi.useFakeTimers();
150
+ const source = fakeStore(state());
151
+ const view = mountQaAssistantView(source.store);
152
+ const shadow = document.getElementById(QA_ASSISTANT_HOST_ID)!.shadowRoot!;
153
+ const search = shadow.querySelector<HTMLInputElement>('[data-action="search"]')!;
154
+
155
+ search.dispatchEvent(new CompositionEvent("compositionstart", { bubbles: true }));
156
+ search.value = "missing";
157
+ search.dispatchEvent(new Event("input", { bubbles: true }));
158
+ source.emit(state("refresh during composition"));
159
+ vi.advanceTimersByTime(100);
160
+
161
+ expect(shadow.querySelector('[data-action="search"]')).toBe(search);
162
+ expect(search.value).toBe("missing");
163
+ expect(shadow.textContent).toContain("Product CTA");
164
+
165
+ search.dispatchEvent(new CompositionEvent("compositionend", { bubbles: true }));
166
+ expect(shadow.querySelector('[data-action="search"]')).not.toBe(search);
167
+ expect(shadow.textContent).not.toContain("Product CTA");
168
+ view.destroy();
169
+ });
170
+
171
+ it("does not remount or rerun the enter animation for identical notifications", () => {
172
+ vi.useFakeTimers();
173
+ const initial = state();
174
+ const source = fakeStore(initial);
175
+ const view = mountQaAssistantView(source.store);
176
+ const shadow = document.getElementById(QA_ASSISTANT_HOST_ID)!.shadowRoot!;
177
+ const panel = shadow.querySelector(".panel")!;
178
+ source.emit(initial);
179
+ source.emit(initial);
180
+ vi.advanceTimersByTime(100);
181
+ expect(shadow.querySelector(".panel")).toBe(panel);
182
+ expect(shadow.querySelectorAll(".panel")).toHaveLength(1);
183
+ view.destroy();
184
+ });
185
+ });