@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,154 @@
1
+ // @vitest-environment jsdom
2
+ import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
3
+ import type { Experiment, InitConfig } from "./types";
4
+
5
+ const offersCommerce: NonNullable<InitConfig["commerce"]> = {
6
+ offers: {
7
+ authorization: {
8
+ version: 1,
9
+ revision: 1,
10
+ checksum: "a".repeat(64),
11
+ experimentIds: ["exp_offer"],
12
+ },
13
+ experiments: [{
14
+ experiment_id: "exp_offer",
15
+ assignment_epoch: 1,
16
+ currency: "EUR",
17
+ variants: {
18
+ treatment: {
19
+ offer_type: "discount_depth",
20
+ percent_off: 10,
21
+ target: { productGids: [], variantGids: [] },
22
+ },
23
+ },
24
+ }],
25
+ },
26
+ };
27
+
28
+ const offerExperiments: Experiment[] = [{
29
+ id: "exp_offer",
30
+ assignmentEpoch: 1,
31
+ status: "running",
32
+ trafficAllocation: 1,
33
+ variations: [{
34
+ id: "treatment",
35
+ weight: 1,
36
+ isControl: false,
37
+ mutations: [{
38
+ selector: ".companion",
39
+ action: "text",
40
+ text: "Bundle & save 10%",
41
+ }],
42
+ }],
43
+ }];
44
+
45
+ const offersToken = JSON.stringify({
46
+ v: 2,
47
+ p: { offers: { v: 1, a: [{ e: "exp_offer", v: "treatment", ep: 1 }] } },
48
+ });
49
+
50
+ const assignResponse = {
51
+ assignments: [{
52
+ experiment_id: "exp_offer",
53
+ variation_id: "treatment",
54
+ assignment_epoch: 1,
55
+ }],
56
+ commerce_authorization: offersToken,
57
+ };
58
+
59
+ describe("offers display authorization gating", () => {
60
+ const originalFetch = globalThis.fetch;
61
+
62
+ beforeEach(() => {
63
+ vi.useFakeTimers();
64
+ vi.resetModules();
65
+ delete (globalThis as any).__drip;
66
+ delete (globalThis as any).drip;
67
+ delete (globalThis as any).Apex;
68
+ localStorage.clear();
69
+ sessionStorage.clear();
70
+ document.head.innerHTML = "";
71
+ document.body.innerHTML = '<div class="companion">Control companion</div>';
72
+ Object.assign(window, { Shopify: { currency: { active: "EUR" } } });
73
+ });
74
+
75
+ afterEach(async () => {
76
+ // The wait/mutation observers are module-level; without disconnecting
77
+ // them the previous test's tracked mutations re-apply into this test's
78
+ // fresh DOM after vi.resetModules().
79
+ const wait = await import("./wait");
80
+ const mutate = await import("./mutate");
81
+ wait.resetWaitEntries();
82
+ mutate.resetAppliedMutations();
83
+ vi.clearAllTimers();
84
+ vi.useRealTimers();
85
+ vi.restoreAllMocks();
86
+ globalThis.fetch = originalFetch;
87
+ delete (globalThis as any).__drip;
88
+ delete (globalThis as any).drip;
89
+ delete (globalThis as any).Apex;
90
+ delete (window as Window & { Shopify?: unknown }).Shopify;
91
+ document.head.innerHTML = "";
92
+ document.body.innerHTML = "";
93
+ });
94
+
95
+ it("applies offer companion DOM only after the cart stamp succeeds", async () => {
96
+ const fetchMock = vi.fn(async (input: RequestInfo | URL) =>
97
+ String(input).endsWith("/cart.js")
98
+ ? Response.json({ token: "cart-runtime?key=runtime-secret" })
99
+ : String(input).includes("/v1/assign")
100
+ ? Response.json(assignResponse)
101
+ : new Response("ok", { status: 200 }));
102
+ globalThis.fetch = fetchMock as typeof fetch;
103
+ const { init } = await import("./index");
104
+
105
+ init({
106
+ antiFlickerMode: "off",
107
+ commerce: offersCommerce,
108
+ endpoint: "https://events.test",
109
+ experiments: offerExperiments,
110
+ ingestSignature: "ingest-token",
111
+ shopId: "shop_123",
112
+ trackingStart: "immediate",
113
+ userId: "visitor_123",
114
+ });
115
+
116
+ // Before the stamped cart write completes, the treatment stays withheld.
117
+ expect(document.querySelector(".companion")?.textContent).toBe("Control companion");
118
+ await vi.waitFor(() => {
119
+ expect(fetchMock.mock.calls.some(([url]) => url === "/cart/update.js")).toBe(true);
120
+ expect(document.querySelector(".companion")?.textContent).toBe("Bundle & save 10%");
121
+ });
122
+ });
123
+
124
+ it("never shows offer companion DOM when the cart stamp fails", async () => {
125
+ const fetchMock = vi.fn(async (input: RequestInfo | URL) =>
126
+ String(input).endsWith("/cart.js")
127
+ ? Response.json({ token: "cart-runtime?key=runtime-secret" })
128
+ : String(input).includes("/v1/assign")
129
+ ? Response.json(assignResponse)
130
+ : String(input) === "/cart/update.js"
131
+ ? new Response("no", { status: 500 })
132
+ : new Response("ok", { status: 200 }));
133
+ globalThis.fetch = fetchMock as typeof fetch;
134
+ const { getDiagnostics, init } = await import("./index");
135
+
136
+ init({
137
+ antiFlickerMode: "off",
138
+ commerce: offersCommerce,
139
+ endpoint: "https://events.test",
140
+ experiments: offerExperiments,
141
+ ingestSignature: "ingest-token",
142
+ shopId: "shop_123",
143
+ trackingStart: "immediate",
144
+ userId: "visitor_123",
145
+ });
146
+
147
+ await vi.waitFor(() => {
148
+ expect(fetchMock.mock.calls.some(([url]) => url === "/cart/update.js")).toBe(true);
149
+ expect(getDiagnostics().spa.lastShopifyCartSync?.status).toBe("failed");
150
+ });
151
+ // Shopify holds no authorization for this offer, so no treatment renders.
152
+ expect(document.querySelector(".companion")?.textContent).toBe("Control companion");
153
+ });
154
+ });