@preprio/toolkit 0.5.0-rc.1 → 0.6.0-alpha.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 (69) hide show
  1. package/README.md +300 -19
  2. package/dist/astro/chunk-3UVUDDNY.js +173 -0
  3. package/dist/astro/graphql.cjs +983 -0
  4. package/dist/astro/graphql.d.cts +231 -0
  5. package/dist/astro/graphql.d.ts +231 -0
  6. package/dist/astro/graphql.js +893 -0
  7. package/dist/astro/index-XT_z-RYT.d.cts +130 -0
  8. package/dist/astro/index-XT_z-RYT.d.ts +130 -0
  9. package/dist/astro/index.cjs +14 -1
  10. package/dist/astro/index.d.cts +1 -120
  11. package/dist/astro/index.d.ts +1 -120
  12. package/dist/astro/index.js +15 -153
  13. package/dist/{chunk-4JNKYIEV.js → chunk-BJ2LBLWO.js} +69 -268
  14. package/dist/chunk-DGZA7KX7.js +172 -0
  15. package/dist/chunk-YR7P4IWE.js +187 -0
  16. package/dist/graphql.cjs +894 -0
  17. package/dist/graphql.d.cts +231 -0
  18. package/dist/graphql.d.ts +231 -0
  19. package/dist/graphql.js +787 -0
  20. package/dist/index.cjs +74 -111
  21. package/dist/index.d.cts +11 -62
  22. package/dist/index.d.ts +11 -62
  23. package/dist/index.js +23 -167
  24. package/dist/nextjs/chunk-U4HXENF7.js +231 -0
  25. package/dist/nextjs/components.cjs +188 -114
  26. package/dist/nextjs/components.d.cts +33 -2
  27. package/dist/nextjs/components.d.ts +33 -2
  28. package/dist/nextjs/components.js +132 -4
  29. package/dist/nextjs/graphql.cjs +1315 -0
  30. package/dist/nextjs/graphql.d.cts +361 -0
  31. package/dist/nextjs/graphql.d.ts +361 -0
  32. package/dist/nextjs/graphql.js +1218 -0
  33. package/dist/nextjs/index.cjs +126 -6
  34. package/dist/nextjs/index.d.cts +53 -141
  35. package/dist/nextjs/index.d.ts +53 -141
  36. package/dist/nextjs/index.js +113 -203
  37. package/dist/nextjs/server-CjpELYvq.d.cts +156 -0
  38. package/dist/nextjs/server-CjpELYvq.d.ts +156 -0
  39. package/dist/nuxt/chunk-P6ENNAEE.js +417 -0
  40. package/dist/nuxt/graphql.cjs +990 -0
  41. package/dist/nuxt/graphql.d.cts +228 -0
  42. package/dist/nuxt/graphql.d.ts +228 -0
  43. package/dist/nuxt/graphql.js +894 -0
  44. package/dist/nuxt/index.cjs +14 -1
  45. package/dist/nuxt/index.d.cts +3 -148
  46. package/dist/nuxt/index.d.ts +3 -148
  47. package/dist/nuxt/index.js +15 -391
  48. package/dist/nuxt/server-8v6OHbsw.d.cts +158 -0
  49. package/dist/nuxt/server-8v6OHbsw.d.ts +158 -0
  50. package/dist/pixel-DwW7cXJm.d.cts +49 -0
  51. package/dist/pixel-DwW7cXJm.d.ts +49 -0
  52. package/dist/react/components.cjs +86 -112
  53. package/dist/react/components.js +86 -112
  54. package/dist/server-Brr1UgtW.d.ts +59 -0
  55. package/dist/server-DJuS3YU0.d.cts +59 -0
  56. package/dist/sveltekit/chunk-FSARVMG5.js +413 -0
  57. package/dist/sveltekit/graphql.cjs +996 -0
  58. package/dist/sveltekit/graphql.d.cts +233 -0
  59. package/dist/sveltekit/graphql.d.ts +233 -0
  60. package/dist/sveltekit/graphql.js +900 -0
  61. package/dist/sveltekit/index.cjs +14 -1
  62. package/dist/sveltekit/index.d.cts +3 -88
  63. package/dist/sveltekit/index.d.ts +3 -88
  64. package/dist/sveltekit/index.js +15 -387
  65. package/dist/sveltekit/server-CO847mEV.d.cts +98 -0
  66. package/dist/sveltekit/server-CO847mEV.d.ts +98 -0
  67. package/dist/{pixel-e1fUWl2Y.d.cts → types-BYH9XqmN.d.cts} +2 -50
  68. package/dist/{pixel-e1fUWl2Y.d.ts → types-BYH9XqmN.d.ts} +2 -50
  69. package/package.json +31 -1
package/dist/index.js CHANGED
@@ -9,179 +9,30 @@ import {
9
9
  PARAM_SEGMENT,
10
10
  PARAM_VARIANT,
11
11
  PreprToolbarElement,
12
- VERSION,
13
12
  createPreprPreview,
14
13
  createToolbarStore,
15
14
  definePreprToolbar,
16
15
  loadTrackingPixel,
17
- resolveFeatures,
18
16
  setTrackingParam,
19
- stegaClean,
20
17
  trackEvent
21
- } from "./chunk-4JNKYIEV.js";
22
-
23
- // src/core/server.ts
24
- var PreprError = class extends Error {
25
- constructor(message, code, context, originalError) {
26
- super(message);
27
- this.code = code;
28
- this.context = context;
29
- this.originalError = originalError;
30
- this.name = "PreprError";
31
- }
32
- };
33
- function getPreprUUIDFromHeaders(headers) {
34
- return headers.get("prepr-customer-id");
35
- }
36
- function getActiveSegmentFromHeaders(headers) {
37
- return headers.get("Prepr-Segments");
38
- }
39
- function getActiveVariantFromHeaders(headers) {
40
- return headers.get("Prepr-ABtesting");
41
- }
42
- var PREPR_HEADER_KEYS = [
43
- "prepr-customer-id",
44
- "Prepr-Segments",
45
- "Prepr-ABtesting",
46
- "Prepr-Preview-Bar",
47
- "Prepr-Context-utm_source",
48
- "Prepr-Context-utm_medium",
49
- "Prepr-Context-utm_term",
50
- "Prepr-Context-utm_content",
51
- "Prepr-Context-utm_campaign",
52
- "Prepr-Context-initial_referral",
53
- "Prepr-Visitor-IP",
54
- "Prepr-Hubspot-Id",
55
- "Prepr-Customer-Id-Created",
56
- "User-Agent",
57
- "Prepr-Package"
58
- ];
59
- function getPreprHeadersFromHeaders(headers) {
60
- const preprHeaders = {};
61
- const copy = (key) => {
62
- const value = headers.get(key);
63
- if (value !== null) {
64
- preprHeaders[key] = value;
65
- }
66
- };
67
- for (const key of PREPR_HEADER_KEYS) {
68
- copy(key);
69
- }
70
- return preprHeaders;
71
- }
72
- function validatePreprToken(token) {
73
- if (!token) {
74
- throw new PreprError(
75
- "Token is required",
76
- "MISSING_TOKEN",
77
- "validatePreprToken"
78
- );
79
- }
80
- if (!token.startsWith("https://")) {
81
- throw new PreprError(
82
- "Token must be a valid HTTPS URL",
83
- "INVALID_TOKEN",
84
- "validatePreprToken"
85
- );
86
- }
87
- }
88
- function extractAccessToken(graphqlUrl) {
89
- let url;
90
- try {
91
- url = new URL(graphqlUrl);
92
- } catch (error) {
93
- throw new PreprError(
94
- "Token must be a valid URL",
95
- "INVALID_TOKEN",
96
- "extractAccessToken",
97
- error instanceof Error ? error : new Error(String(error))
98
- );
99
- }
100
- if (url.hostname !== "graphql.prepr.io") {
101
- throw new PreprError(
102
- "Token must be a graphql.prepr.io URL",
103
- "INVALID_TOKEN",
104
- "extractAccessToken"
105
- );
106
- }
107
- const pathParts = url.pathname.split("/");
108
- const token = pathParts[pathParts.length - 1];
109
- if (!token) {
110
- throw new PreprError(
111
- "Token URL is missing an access token segment",
112
- "INVALID_TOKEN",
113
- "extractAccessToken"
114
- );
115
- }
116
- return token;
117
- }
118
- async function getPreprEnvironmentSegments(token) {
119
- validatePreprToken(token);
120
- try {
121
- const response = await fetch(token, {
122
- headers: {
123
- "Prepr-Package": `@preprio/toolkit@${VERSION}`,
124
- // Duplicates the version in Prepr-Package. It keeps the User-Agent
125
- // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
126
- // still identify the toolbar by that string.
127
- "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
128
- "Content-Type": "application/json"
129
- },
130
- method: "POST",
131
- body: JSON.stringify({
132
- query: `{
133
- _Segments {
134
- _id
135
- name
136
- }
137
- }`
138
- })
139
- });
140
- if (!response.ok) {
141
- throw new PreprError(
142
- `HTTP ${response.status}: ${response.statusText}`,
143
- "HTTP_ERROR",
144
- "getPreprEnvironmentSegments"
145
- );
146
- }
147
- const json = await response.json();
148
- if (!json || !json.data || !json.data._Segments) {
149
- throw new PreprError(
150
- "Invalid response format from Prepr API",
151
- "INVALID_RESPONSE",
152
- "getPreprEnvironmentSegments"
153
- );
154
- }
155
- return json.data._Segments;
156
- } catch (error) {
157
- if (error instanceof PreprError) {
158
- throw error;
159
- }
160
- throw new PreprError(
161
- "Failed to fetch segments from Prepr API",
162
- "FETCH_ERROR",
163
- "getPreprEnvironmentSegments",
164
- error instanceof Error ? error : new Error(String(error))
165
- );
166
- }
167
- }
168
- async function getToolbarPropsFromHeaders(headers, token, features) {
169
- const resolved = resolveFeatures(features);
170
- let segments = [];
171
- if (resolved.segments) {
172
- try {
173
- segments = await getPreprEnvironmentSegments(token);
174
- } catch {
175
- segments = [];
176
- }
177
- }
178
- return {
179
- activeSegment: resolved.segments ? getActiveSegmentFromHeaders(headers) : null,
180
- activeVariant: resolved.abTesting ? getActiveVariantFromHeaders(headers) : null,
181
- segments,
182
- data: segments
183
- };
184
- }
18
+ } from "./chunk-BJ2LBLWO.js";
19
+ import {
20
+ PreprError,
21
+ extractAccessToken,
22
+ getActiveSegmentFromHeaders,
23
+ getActiveVariantFromHeaders,
24
+ getPreprEnvironmentSegments,
25
+ getPreprHeadersFromHeaders,
26
+ getPreprUUIDFromHeaders,
27
+ getToolbarPropsFromHeaders,
28
+ isPersonalizedResponse,
29
+ validatePreprToken
30
+ } from "./chunk-YR7P4IWE.js";
31
+ import {
32
+ VERSION,
33
+ resolveFeatures,
34
+ stegaClean
35
+ } from "./chunk-DGZA7KX7.js";
185
36
 
186
37
  // src/core/middleware.ts
187
38
  var UTM_PARAMS = [
@@ -335,6 +186,10 @@ function processFrameworkRequest(request, opts, framework) {
335
186
  });
336
187
  }
337
188
  }
189
+ if (requestHeaders.has("Prepr-Segments")) {
190
+ requestHeaders.delete("Prepr-Customer-Id");
191
+ requestHeaders.delete("Prepr-Customer-Id-Created");
192
+ }
338
193
  return { requestHeaders, responseCookies };
339
194
  }
340
195
  export {
@@ -351,6 +206,7 @@ export {
351
206
  getPreprHeadersFromHeaders,
352
207
  getPreprUUIDFromHeaders,
353
208
  getToolbarPropsFromHeaders,
209
+ isPersonalizedResponse,
354
210
  loadTrackingPixel,
355
211
  processPreprRequest,
356
212
  resolveFeatures,
@@ -0,0 +1,231 @@
1
+ // src/version.ts
2
+ var VERSION = "0.6.0-alpha.0";
3
+
4
+ // src/core/features.ts
5
+ function isEnabled(config) {
6
+ if (typeof config === "boolean") return config;
7
+ return config?.enabled ?? true;
8
+ }
9
+ function resolveFeatures(features) {
10
+ return {
11
+ segments: isEnabled(features?.segments),
12
+ abTesting: isEnabled(features?.abTesting),
13
+ editMode: isEnabled(features?.editMode)
14
+ };
15
+ }
16
+ var ALL_FEATURES_ENABLED = Object.freeze({
17
+ segments: true,
18
+ abTesting: true,
19
+ editMode: true
20
+ });
21
+
22
+ // src/core/server.ts
23
+ var PreprError = class extends Error {
24
+ constructor(message, code, context, originalError) {
25
+ super(message);
26
+ this.code = code;
27
+ this.context = context;
28
+ this.originalError = originalError;
29
+ this.name = "PreprError";
30
+ }
31
+ };
32
+ function getPreprUUIDFromHeaders(headers2) {
33
+ return headers2.get("prepr-customer-id");
34
+ }
35
+ function getActiveSegmentFromHeaders(headers2) {
36
+ return headers2.get("Prepr-Segments");
37
+ }
38
+ function getActiveVariantFromHeaders(headers2) {
39
+ return headers2.get("Prepr-ABtesting");
40
+ }
41
+ var PREPR_HEADER_KEYS = [
42
+ "prepr-customer-id",
43
+ "Prepr-Segments",
44
+ "Prepr-ABtesting",
45
+ "Prepr-Preview-Bar",
46
+ "Prepr-Context-utm_source",
47
+ "Prepr-Context-utm_medium",
48
+ "Prepr-Context-utm_term",
49
+ "Prepr-Context-utm_content",
50
+ "Prepr-Context-utm_campaign",
51
+ "Prepr-Context-initial_referral",
52
+ "Prepr-Visitor-IP",
53
+ "Prepr-Hubspot-Id",
54
+ "Prepr-Customer-Id-Created",
55
+ "User-Agent",
56
+ "Prepr-Package"
57
+ ];
58
+ function getPreprHeadersFromHeaders(headers2) {
59
+ const preprHeaders = {};
60
+ const copy = (key) => {
61
+ const value = headers2.get(key);
62
+ if (value !== null) {
63
+ preprHeaders[key] = value;
64
+ }
65
+ };
66
+ for (const key of PREPR_HEADER_KEYS) {
67
+ copy(key);
68
+ }
69
+ return preprHeaders;
70
+ }
71
+ function validatePreprToken(token) {
72
+ if (!token) {
73
+ throw new PreprError(
74
+ "Token is required",
75
+ "MISSING_TOKEN",
76
+ "validatePreprToken"
77
+ );
78
+ }
79
+ if (!token.startsWith("https://")) {
80
+ throw new PreprError(
81
+ "Token must be a valid HTTPS URL",
82
+ "INVALID_TOKEN",
83
+ "validatePreprToken"
84
+ );
85
+ }
86
+ }
87
+ function extractAccessToken(graphqlUrl) {
88
+ let url;
89
+ try {
90
+ url = new URL(graphqlUrl);
91
+ } catch (error) {
92
+ throw new PreprError(
93
+ "Token must be a valid URL",
94
+ "INVALID_TOKEN",
95
+ "extractAccessToken",
96
+ error instanceof Error ? error : new Error(String(error))
97
+ );
98
+ }
99
+ if (url.hostname !== "graphql.prepr.io") {
100
+ throw new PreprError(
101
+ "Token must be a graphql.prepr.io URL",
102
+ "INVALID_TOKEN",
103
+ "extractAccessToken"
104
+ );
105
+ }
106
+ const pathParts = url.pathname.split("/");
107
+ const token = pathParts[pathParts.length - 1];
108
+ if (!token) {
109
+ throw new PreprError(
110
+ "Token URL is missing an access token segment",
111
+ "INVALID_TOKEN",
112
+ "extractAccessToken"
113
+ );
114
+ }
115
+ return token;
116
+ }
117
+ async function getPreprEnvironmentSegments(token) {
118
+ validatePreprToken(token);
119
+ try {
120
+ const response = await fetch(token, {
121
+ headers: {
122
+ "Prepr-Package": `@preprio/toolkit@${VERSION}`,
123
+ // Duplicates the version in Prepr-Package. It keeps the User-Agent
124
+ // format used by `@preprio/prepr-nextjs`, for Prepr API consumers that
125
+ // still identify the toolbar by that string.
126
+ "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
127
+ "Content-Type": "application/json"
128
+ },
129
+ method: "POST",
130
+ body: JSON.stringify({
131
+ query: `{
132
+ _Segments {
133
+ _id
134
+ name
135
+ }
136
+ }`
137
+ })
138
+ });
139
+ if (!response.ok) {
140
+ throw new PreprError(
141
+ `HTTP ${response.status}: ${response.statusText}`,
142
+ "HTTP_ERROR",
143
+ "getPreprEnvironmentSegments"
144
+ );
145
+ }
146
+ const json = await response.json();
147
+ if (!json || !json.data || !json.data._Segments) {
148
+ throw new PreprError(
149
+ "Invalid response format from Prepr API",
150
+ "INVALID_RESPONSE",
151
+ "getPreprEnvironmentSegments"
152
+ );
153
+ }
154
+ return json.data._Segments;
155
+ } catch (error) {
156
+ if (error instanceof PreprError) {
157
+ throw error;
158
+ }
159
+ throw new PreprError(
160
+ "Failed to fetch segments from Prepr API",
161
+ "FETCH_ERROR",
162
+ "getPreprEnvironmentSegments",
163
+ error instanceof Error ? error : new Error(String(error))
164
+ );
165
+ }
166
+ }
167
+ async function getToolbarPropsFromHeaders(headers2, token, features) {
168
+ const resolved = resolveFeatures(features);
169
+ let segments = [];
170
+ if (resolved.segments) {
171
+ try {
172
+ segments = await getPreprEnvironmentSegments(token);
173
+ } catch {
174
+ segments = [];
175
+ }
176
+ }
177
+ return {
178
+ activeSegment: resolved.segments ? getActiveSegmentFromHeaders(headers2) : null,
179
+ activeVariant: resolved.abTesting ? getActiveVariantFromHeaders(headers2) : null,
180
+ segments,
181
+ data: segments
182
+ };
183
+ }
184
+
185
+ // src/nextjs/server.ts
186
+ import { headers } from "next/headers";
187
+ async function readHeaders() {
188
+ return await headers();
189
+ }
190
+ async function getPreprUUID() {
191
+ const h = await readHeaders();
192
+ return getPreprUUIDFromHeaders(h);
193
+ }
194
+ async function getActiveSegment() {
195
+ const h = await readHeaders();
196
+ return getActiveSegmentFromHeaders(h);
197
+ }
198
+ async function getActiveVariant() {
199
+ const h = await readHeaders();
200
+ return getActiveVariantFromHeaders(h);
201
+ }
202
+ async function getPreprHeaders() {
203
+ const h = await readHeaders();
204
+ return getPreprHeadersFromHeaders(h);
205
+ }
206
+ async function getToolbarProps(token, features) {
207
+ const h = await readHeaders();
208
+ return getToolbarPropsFromHeaders(h, token, features);
209
+ }
210
+
211
+ // src/core/personalization.ts
212
+ var PERSONALIZED_VARY = /\bPrepr-(Segments|ABTesting)/i;
213
+ function isPersonalizedResponse(source) {
214
+ const headers2 = "headers" in source ? source.headers : source;
215
+ return PERSONALIZED_VARY.test(headers2.get("vary") ?? "");
216
+ }
217
+
218
+ export {
219
+ VERSION,
220
+ resolveFeatures,
221
+ PreprError,
222
+ getPreprHeadersFromHeaders,
223
+ validatePreprToken,
224
+ extractAccessToken,
225
+ getPreprUUID,
226
+ getActiveSegment,
227
+ getActiveVariant,
228
+ getPreprHeaders,
229
+ getToolbarProps,
230
+ isPersonalizedResponse
231
+ };