@preprio/toolkit 0.1.0-beta.1

package/dist/astro/index.cjs

@@ -0,0 +1,319 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/astro/index.ts
+var astro_exports = {};
+__export(astro_exports, {
+  getActiveSegment: () => getActiveSegment,
+  getActiveVariant: () => getActiveVariant,
+  getPreprHeaders: () => getPreprHeaders,
+  getPreprUUID: () => getPreprUUID,
+  getToolbarProps: () => getToolbarProps,
+  onPreprRequest: () => onPreprRequest
+});
+module.exports = __toCommonJS(astro_exports);
+
+// src/version.ts
+var VERSION = "0.1.0-beta.1";
+
+// src/core/server.ts
+var PreprError = class extends Error {
+  constructor(message, code, context, originalError) {
+    super(message);
+    this.code = code;
+    this.context = context;
+    this.originalError = originalError;
+    this.name = "PreprError";
+  }
+};
+function getPreprUUIDFromHeaders(headers) {
+  return headers.get("prepr-customer-id");
+}
+function getActiveSegmentFromHeaders(headers) {
+  return headers.get("Prepr-Segments");
+}
+function getActiveVariantFromHeaders(headers) {
+  return headers.get("Prepr-ABtesting");
+}
+var PREPR_HEADER_KEYS = [
+  "prepr-customer-id",
+  "Prepr-Segments",
+  "Prepr-ABtesting",
+  "Prepr-Preview-Bar",
+  "Prepr-Context-utm_source",
+  "Prepr-Context-utm_medium",
+  "Prepr-Context-utm_term",
+  "Prepr-Context-utm_content",
+  "Prepr-Context-utm_campaign",
+  "Prepr-Context-initial_referral",
+  "Prepr-Visitor-IP",
+  "Prepr-Hubspot-Id",
+  "Prepr-Customer-Id-Created",
+  "Prepr-User-Agent"
+];
+function getPreprHeadersFromHeaders(headers) {
+  const preprHeaders = {};
+  const copy = (key) => {
+    const value = headers.get(key);
+    if (value !== null) {
+      preprHeaders[key] = value;
+    }
+  };
+  for (const key of PREPR_HEADER_KEYS) {
+    copy(key);
+  }
+  return preprHeaders;
+}
+function validatePreprToken(token) {
+  if (!token) {
+    throw new PreprError("Token is required", "MISSING_TOKEN", "validatePreprToken");
+  }
+  if (!token.startsWith("https://")) {
+    throw new PreprError(
+      "Token must be a valid HTTPS URL",
+      "INVALID_TOKEN",
+      "validatePreprToken"
+    );
+  }
+}
+async function getPreprEnvironmentSegments(token) {
+  validatePreprToken(token);
+  try {
+    const response = await fetch(token, {
+      headers: {
+        "User-Agent": `Prepr-Preview-Bar/${VERSION}`,
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify({
+        query: `{
+                _Segments {
+                    _id
+                    name
+                }
+            }`
+      })
+    });
+    if (!response.ok) {
+      throw new PreprError(
+        `HTTP ${response.status}: ${response.statusText}`,
+        "HTTP_ERROR",
+        "getPreprEnvironmentSegments"
+      );
+    }
+    const json = await response.json();
+    if (!json || !json.data || !json.data._Segments) {
+      throw new PreprError(
+        "Invalid response format from Prepr API",
+        "INVALID_RESPONSE",
+        "getPreprEnvironmentSegments"
+      );
+    }
+    return json.data._Segments;
+  } catch (error) {
+    if (error instanceof PreprError) {
+      throw error;
+    }
+    throw new PreprError(
+      "Failed to fetch segments from Prepr API",
+      "FETCH_ERROR",
+      "getPreprEnvironmentSegments",
+      error instanceof Error ? error : new Error(String(error))
+    );
+  }
+}
+async function getToolbarPropsFromHeaders(headers, token) {
+  let segments = [];
+  try {
+    segments = await getPreprEnvironmentSegments(token);
+  } catch {
+    segments = [];
+  }
+  return {
+    activeSegment: getActiveSegmentFromHeaders(headers),
+    activeVariant: getActiveVariantFromHeaders(headers),
+    segments,
+    data: segments
+  };
+}
+
+// src/core/constants.ts
+var COOKIE_PREVIEW_MODE = "Prepr-Preview-Mode";
+var COOKIE_SEGMENT = "Prepr-Segments";
+var COOKIE_VARIANT = "Prepr-ABtesting";
+var COOKIE_UID = "__prepr_uid";
+var COOKIE_HUBSPOT = "hubspotutk";
+var PARAM_SEGMENT = "prepr_preview_segment";
+var PARAM_VARIANT = "prepr_preview_ab";
+var PARAM_HIDE_BAR = "prepr_hide_bar";
+var ONE_YEAR_SECONDS = 60 * 60 * 24 * 365;
+
+// src/core/middleware.ts
+var UTM_PARAMS = [
+  "utm_source",
+  "utm_medium",
+  "utm_term",
+  "utm_content",
+  "utm_campaign"
+];
+function parseCookies(request) {
+  const cookies = /* @__PURE__ */ new Map();
+  const header = request.headers.get("cookie");
+  if (!header) return cookies;
+  for (const part of header.split(";")) {
+    const eq = part.indexOf("=");
+    if (eq === -1) continue;
+    const name = part.slice(0, eq).trim();
+    const value = part.slice(eq + 1).trim();
+    if (!name) continue;
+    cookies.set(name, decodeURIComponent(value));
+  }
+  return cookies;
+}
+function processPreprRequest(request, opts) {
+  const requestHeaders = new Headers(request.headers);
+  const responseCookies = [];
+  const requestCookies = parseCookies(request);
+  const searchParams = new URL(request.url).searchParams;
+  for (const key of UTM_PARAMS) {
+    const value = searchParams.get(key);
+    if (value !== null) {
+      requestHeaders.set(`Prepr-Context-${key}`, value);
+    }
+  }
+  const referer = request.headers.get("referer");
+  if (referer) {
+    requestHeaders.set("Prepr-Context-initial_referral", referer);
+  }
+  const userAgent = request.headers.get("user-agent");
+  if (userAgent) {
+    requestHeaders.set("Prepr-User-Agent", userAgent);
+  }
+  requestHeaders.set("Prepr-Package", `@preprio/toolkit@${opts?.version ?? VERSION}`);
+  const ip = request.headers.get("Cf-Connecting-Ip") ?? request.headers.get("x-real-ip");
+  if (ip) {
+    requestHeaders.set("Prepr-Visitor-IP", ip);
+  }
+  const hutkCookie = requestCookies.get(COOKIE_HUBSPOT);
+  if (hutkCookie) {
+    requestHeaders.set("Prepr-Hubspot-Id", hutkCookie);
+  }
+  let uid = requestCookies.get(COOKIE_UID);
+  if (!uid) {
+    uid = crypto.randomUUID();
+    responseCookies.push({
+      name: COOKIE_UID,
+      value: uid,
+      maxAge: ONE_YEAR_SECONDS,
+      path: "/"
+    });
+    requestHeaders.set("Prepr-Customer-Id-Created", "true");
+  }
+  requestHeaders.set("Prepr-Customer-Id", uid);
+  if (!opts?.preview) {
+    return { requestHeaders, responseCookies };
+  }
+  const hasPreviewParams = searchParams.has(PARAM_SEGMENT) || searchParams.has(PARAM_VARIANT);
+  if (!hasPreviewParams) {
+    const previewModeCookie = requestCookies.get(COOKIE_PREVIEW_MODE);
+    const previewModeEnabled = previewModeCookie !== "false";
+    if (!previewModeEnabled) {
+      return { requestHeaders, responseCookies };
+    }
+  }
+  requestHeaders.set("Prepr-Preview-Bar", "true");
+  const isLivePreview = searchParams.get(PARAM_HIDE_BAR) === "true";
+  if (!isLivePreview) {
+    const segmentCookie = requestCookies.get(COOKIE_SEGMENT);
+    if (segmentCookie) {
+      requestHeaders.set("Prepr-Segments", segmentCookie);
+    }
+    const abCookie = requestCookies.get(COOKIE_VARIANT);
+    if (abCookie) {
+      requestHeaders.set("Prepr-ABtesting", abCookie);
+    }
+  }
+  const previewAb = searchParams.get(PARAM_VARIANT);
+  if (previewAb !== null) {
+    requestHeaders.set("Prepr-ABtesting", previewAb);
+    if (!isLivePreview) {
+      responseCookies.push({
+        name: COOKIE_VARIANT,
+        value: previewAb,
+        maxAge: ONE_YEAR_SECONDS,
+        path: "/"
+      });
+    }
+  }
+  const previewSegment = searchParams.get(PARAM_SEGMENT);
+  if (previewSegment !== null) {
+    requestHeaders.set("Prepr-Segments", previewSegment);
+    if (!isLivePreview) {
+      responseCookies.push({
+        name: COOKIE_SEGMENT,
+        value: previewSegment,
+        maxAge: ONE_YEAR_SECONDS,
+        path: "/"
+      });
+    }
+  }
+  return { requestHeaders, responseCookies };
+}
+
+// src/astro/index.ts
+async function onPreprRequest(context, next, options) {
+  const { requestHeaders, responseCookies } = processPreprRequest(context.request, options);
+  requestHeaders.forEach((value, key) => {
+    context.request.headers.set(key, value);
+  });
+  const response = await next();
+  for (const cookie of responseCookies) {
+    const parts = [
+      `${cookie.name}=${encodeURIComponent(cookie.value)}`,
+      `Max-Age=${cookie.maxAge}`,
+      `Path=${cookie.path}`
+    ];
+    response.headers.append("Set-Cookie", parts.join("; "));
+  }
+  return response;
+}
+function getPreprUUID(headers) {
+  return getPreprUUIDFromHeaders(headers);
+}
+function getActiveSegment(headers) {
+  return getActiveSegmentFromHeaders(headers);
+}
+function getActiveVariant(headers) {
+  return getActiveVariantFromHeaders(headers);
+}
+function getPreprHeaders(headers) {
+  return getPreprHeadersFromHeaders(headers);
+}
+async function getToolbarProps(headers, token) {
+  return getToolbarPropsFromHeaders(headers, token);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getActiveSegment,
+  getActiveVariant,
+  getPreprHeaders,
+  getPreprUUID,
+  getToolbarProps,
+  onPreprRequest
+});

package/dist/astro/index.d.cts

@@ -0,0 +1,76 @@
+interface PreprMiddlewareOptions {
+    /** Enable preview-mode headers (segment/AB overrides, preview bar). */
+    preview?: boolean;
+    /** Override the version reported in Prepr-Package (mainly for tests). */
+    version?: string;
+}
+
+interface PreprSegment {
+    readonly _id: string;
+    readonly name: string;
+}
+interface PreprToolbarProps {
+    readonly activeSegment: string | null;
+    readonly activeVariant: string | null;
+    /** Available segments to personalize on. */
+    readonly segments?: readonly PreprSegment[];
+    /** @deprecated Alias for `segments`. */
+    readonly data?: readonly PreprSegment[];
+}
+type PreprVariant = 'A' | 'B';
+interface PreprHeaders {
+    readonly 'prepr-customer-id'?: string;
+    readonly 'Prepr-Segments'?: string;
+    readonly 'Prepr-ABtesting'?: PreprVariant;
+    readonly 'Prepr-Preview-Bar'?: 'true';
+    readonly 'Prepr-Context-utm_source'?: string;
+    readonly 'Prepr-Context-utm_medium'?: string;
+    readonly 'Prepr-Context-utm_term'?: string;
+    readonly 'Prepr-Context-utm_content'?: string;
+    readonly 'Prepr-Context-utm_campaign'?: string;
+    readonly 'Prepr-Context-initial_referral'?: string;
+    readonly 'Prepr-Visitor-IP'?: string;
+    readonly 'Prepr-Hubspot-Id'?: string;
+    readonly 'Prepr-Customer-Id-Created'?: 'true';
+    readonly 'Prepr-User-Agent'?: string;
+}
+
+/**
+ * Structural stand-in for Astro's `APIContext`, so this package needs no
+ * build-time dependency on `astro`. Only the fields `onPreprRequest` uses.
+ */
+interface AstroLikeContext {
+    request: Request;
+    /** Unused; typed loosely so passing the real Astro context still checks. */
+    cookies?: unknown;
+}
+/** Astro middleware's `next()` — resolves to the `Response` from downstream. */
+type AstroNext = () => Promise<Response>;
+/**
+ * Astro middleware entry point: computes the Prepr headers/cookies for this
+ * request, forwards the headers downstream and sets the cookies on the response.
+ *
+ * Astro hands downstream code the same `Request` instance we get here, so the
+ * headers are mutated in place — building a new `Request` would go nowhere,
+ * there's no way to hand a replacement back out of middleware.
+ */
+declare function onPreprRequest(context: AstroLikeContext, next: AstroNext, options?: PreprMiddlewareOptions): Promise<Response>;
+/** Prepr Customer ID for this request, from `Astro.request.headers`. */
+declare function getPreprUUID(headers: Headers): string | null;
+/** Active segment for this request, from `Astro.request.headers`. */
+declare function getActiveSegment(headers: Headers): string | null;
+/** Active A/B variant for this request, from `Astro.request.headers`. */
+declare function getActiveVariant(headers: Headers): string | null;
+/** All Prepr headers for this request, from `Astro.request.headers`. */
+declare function getPreprHeaders(headers: Headers): PreprHeaders;
+/**
+ * Props needed to mount `PreprToolbar.astro`, from `Astro.request.headers`
+ * plus a Prepr GraphQL token.
+ *
+ * Ungated: call it only when your app is in preview mode. Resolve that however
+ * your deployment already does — the toolkit reads no environment variables of
+ * its own.
+ */
+declare function getToolbarProps(headers: Headers, token: string): Promise<PreprToolbarProps>;
+
+export { type AstroLikeContext, type AstroNext, type PreprMiddlewareOptions, getActiveSegment, getActiveVariant, getPreprHeaders, getPreprUUID, getToolbarProps, onPreprRequest };

package/dist/astro/index.d.ts

@@ -0,0 +1,76 @@
+interface PreprMiddlewareOptions {
+    /** Enable preview-mode headers (segment/AB overrides, preview bar). */
+    preview?: boolean;
+    /** Override the version reported in Prepr-Package (mainly for tests). */
+    version?: string;
+}
+
+interface PreprSegment {
+    readonly _id: string;
+    readonly name: string;
+}
+interface PreprToolbarProps {
+    readonly activeSegment: string | null;
+    readonly activeVariant: string | null;
+    /** Available segments to personalize on. */
+    readonly segments?: readonly PreprSegment[];
+    /** @deprecated Alias for `segments`. */
+    readonly data?: readonly PreprSegment[];
+}
+type PreprVariant = 'A' | 'B';
+interface PreprHeaders {
+    readonly 'prepr-customer-id'?: string;
+    readonly 'Prepr-Segments'?: string;
+    readonly 'Prepr-ABtesting'?: PreprVariant;
+    readonly 'Prepr-Preview-Bar'?: 'true';
+    readonly 'Prepr-Context-utm_source'?: string;
+    readonly 'Prepr-Context-utm_medium'?: string;
+    readonly 'Prepr-Context-utm_term'?: string;
+    readonly 'Prepr-Context-utm_content'?: string;
+    readonly 'Prepr-Context-utm_campaign'?: string;
+    readonly 'Prepr-Context-initial_referral'?: string;
+    readonly 'Prepr-Visitor-IP'?: string;
+    readonly 'Prepr-Hubspot-Id'?: string;
+    readonly 'Prepr-Customer-Id-Created'?: 'true';
+    readonly 'Prepr-User-Agent'?: string;
+}
+
+/**
+ * Structural stand-in for Astro's `APIContext`, so this package needs no
+ * build-time dependency on `astro`. Only the fields `onPreprRequest` uses.
+ */
+interface AstroLikeContext {
+    request: Request;
+    /** Unused; typed loosely so passing the real Astro context still checks. */
+    cookies?: unknown;
+}
+/** Astro middleware's `next()` — resolves to the `Response` from downstream. */
+type AstroNext = () => Promise<Response>;
+/**
+ * Astro middleware entry point: computes the Prepr headers/cookies for this
+ * request, forwards the headers downstream and sets the cookies on the response.
+ *
+ * Astro hands downstream code the same `Request` instance we get here, so the
+ * headers are mutated in place — building a new `Request` would go nowhere,
+ * there's no way to hand a replacement back out of middleware.
+ */
+declare function onPreprRequest(context: AstroLikeContext, next: AstroNext, options?: PreprMiddlewareOptions): Promise<Response>;
+/** Prepr Customer ID for this request, from `Astro.request.headers`. */
+declare function getPreprUUID(headers: Headers): string | null;
+/** Active segment for this request, from `Astro.request.headers`. */
+declare function getActiveSegment(headers: Headers): string | null;
+/** Active A/B variant for this request, from `Astro.request.headers`. */
+declare function getActiveVariant(headers: Headers): string | null;
+/** All Prepr headers for this request, from `Astro.request.headers`. */
+declare function getPreprHeaders(headers: Headers): PreprHeaders;
+/**
+ * Props needed to mount `PreprToolbar.astro`, from `Astro.request.headers`
+ * plus a Prepr GraphQL token.
+ *
+ * Ungated: call it only when your app is in preview mode. Resolve that however
+ * your deployment already does — the toolkit reads no environment variables of
+ * its own.
+ */
+declare function getToolbarProps(headers: Headers, token: string): Promise<PreprToolbarProps>;
+
+export { type AstroLikeContext, type AstroNext, type PreprMiddlewareOptions, getActiveSegment, getActiveVariant, getPreprHeaders, getPreprUUID, getToolbarProps, onPreprRequest };