@guidelytech/shared 0.15.0 → 0.17.0

package/dist/runtime.cjs

@@ -28,6 +28,7 @@ __export(runtime_exports, {
   AGENT_TURNS_PER_BATCH: () => AGENT_TURNS_PER_BATCH,
   AGENT_TURN_MAX_TEXT: () => AGENT_TURN_MAX_TEXT,
   AGENT_TURN_ROLES: () => AGENT_TURN_ROLES,
+  ARTICLE_HREF_PREFIX: () => ARTICLE_HREF_PREFIX,
   ARTICLE_VISIBILITIES: () => ARTICLE_VISIBILITIES,
   CAPTURE_PARAM: () => CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES: () => CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -49,6 +50,10 @@ __export(runtime_exports, {
   GUIDE_EXPERIMENT_STATUSES: () => GUIDE_EXPERIMENT_STATUSES,
   GUIDE_VISIBILITIES: () => GUIDE_VISIBILITIES,
   LOGGED_IN_AUDIENCE: () => LOGGED_IN_AUDIENCE,
+  MAX_APP_VERSION_LENGTH: () => MAX_APP_VERSION_LENGTH,
+  MAX_BREADCRUMBS: () => MAX_BREADCRUMBS,
+  MAX_BUG_REPORT_LENGTH: () => MAX_BUG_REPORT_LENGTH,
+  MAX_BUG_REPORT_SCREENSHOT_BYTES: () => MAX_BUG_REPORT_SCREENSHOT_BYTES,
   MAX_COLLECTION_DEPTH: () => MAX_COLLECTION_DEPTH,
   MAX_COMPLAINT_ANSWER_LENGTH: () => MAX_COMPLAINT_ANSWER_LENGTH,
   MAX_COMPLAINT_ATTACHMENT_BYTES: () => MAX_COMPLAINT_ATTACHMENT_BYTES,
@@ -56,6 +61,13 @@ __export(runtime_exports, {
   MAX_COMPLAINT_FIELDS: () => MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH: () => MAX_COMPLAINT_LENGTH,
   MAX_CUSTOM_CSS: () => MAX_CUSTOM_CSS,
+  MAX_DEBUG_IMAGES: () => MAX_DEBUG_IMAGES,
+  MAX_DETAIL_FRAMES: () => MAX_DETAIL_FRAMES,
+  MAX_DETAIL_THREADS: () => MAX_DETAIL_THREADS,
+  MAX_ERROR_TAGS: () => MAX_ERROR_TAGS,
+  MAX_EXCEPTION_CHAIN: () => MAX_EXCEPTION_CHAIN,
+  MAX_EXCEPTION_DETAIL_BYTES: () => MAX_EXCEPTION_DETAIL_BYTES,
+  MAX_EXCEPTION_DETAIL_RAW_BYTES: () => MAX_EXCEPTION_DETAIL_RAW_BYTES,
   MAX_PROPERTY_BYTES: () => MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES: () => MAX_STACK_FRAMES,
   MEDIA_FILE_MAX_BYTES: () => MEDIA_FILE_MAX_BYTES,
@@ -96,6 +108,8 @@ __export(runtime_exports, {
   WS_MAX_MESSAGES_PER_SOCKET: () => WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES: () => WS_MAX_MESSAGE_BYTES,
   applyGuideTranslations: () => applyGuideTranslations,
+  articleHref: () => articleHref,
+  articleIdFromHref: () => articleIdFromHref,
   articleTextEntries: () => articleTextEntries,
   assignGuideVariant: () => assignGuideVariant,
   baseLanguage: () => baseLanguage,
@@ -107,8 +121,10 @@ __export(runtime_exports, {
   contrastIssues: () => contrastIssues,
   contrastRatio: () => contrastRatio,
   cssSelectorError: () => cssSelectorError,
+  customFingerprint: () => customFingerprint,
   describeRule: () => describeRule,
   emptyRuleGroup: () => emptyRuleGroup,
+  errorFilterDrops: () => errorFilterDrops,
   evaluateRule: () => evaluateRule,
   evaluateRules: () => evaluateRules,
   evenWeights: () => evenWeights,
@@ -137,6 +153,7 @@ __export(runtime_exports, {
   isRuleGroup: () => isRuleGroup,
   isSafeMediaUrl: () => isSafeMediaUrl,
   isVideoContentType: () => isVideoContentType,
+  isVideoFileUrl: () => isVideoFileUrl,
   localeName: () => localeName,
   localizeAnnouncement: () => localizeAnnouncement,
   localizeArticle: () => localizeArticle,
@@ -149,10 +166,12 @@ __export(runtime_exports, {
   mediaKind: () => mediaKind,
   mediaMaxBytes: () => mediaMaxBytes,
   needsReview: () => needsReview,
+  normalizeAppVersion: () => normalizeAppVersion,
   normalizeErrorMessage: () => normalizeErrorMessage,
   normalizeFrameFile: () => normalizeFrameFile,
   normalizeLocale: () => normalizeLocale,
   normalizeSnapshot: () => normalizeSnapshot,
+  normalizeTags: () => normalizeTags,
   orderedModules: () => orderedModules,
   pageLabel: () => pageLabel,
   pagePattern: () => pagePattern,
@@ -166,6 +185,7 @@ __export(runtime_exports, {
   propertyAttributeAllowed: () => propertyAttributeAllowed,
   queryConditionRegex: () => queryConditionRegex,
   randomId: () => randomId,
+  reactNativeBundleUrl: () => reactNativeBundleUrl,
   readableTextOn: () => readableTextOn,
   relativeLuminance: () => relativeLuminance,
   resolveLocale: () => resolveLocale,
@@ -185,13 +205,16 @@ __export(runtime_exports, {
   slugify: () => slugify,
   snapshotFromSelector: () => snapshotFromSelector,
   stableStringify: () => stableStringify,
+  stepVideo: () => stepVideo,
   stripOrigin: () => stripOrigin,
   supportsPlatform: () => supportsPlatform,
   toEmbedUrl: () => toEmbedUrl,
   translationCoverage: () => translationCoverage,
+  trimExceptionDetail: () => trimExceptionDetail,
   unreadAnnouncements: () => unreadAnnouncements,
   variantProblems: () => variantProblems,
   variantRanges: () => variantRanges,
+  videoThumbnailUrl: () => videoThumbnailUrl,
   visibleAnnouncements: () => visibleAnnouncements,
   visibleArticleIds: () => visibleArticleIds,
   visitorAudiences: () => visitorAudiences,
@@ -217,18 +240,18 @@ function slugify(input) {
   return input.toLowerCase().trim().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 64) || "untitled";
 }
 var ALPHABET = "0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ";
-function randomId(size = 16) {
+function randomId(size2 = 16) {
   const g = typeof globalThis !== "undefined" ? globalThis : {};
   let bytes;
   if (g.crypto && typeof g.crypto.getRandomValues === "function") {
-    bytes = new Uint8Array(size);
+    bytes = new Uint8Array(size2);
     g.crypto.getRandomValues(bytes);
   } else {
-    bytes = new Uint8Array(size);
-    for (let i = 0; i < size; i++) bytes[i] = Math.floor(Math.random() * 256);
+    bytes = new Uint8Array(size2);
+    for (let i = 0; i < size2; i++) bytes[i] = Math.floor(Math.random() * 256);
   }
   let out = "";
-  for (let i = 0; i < size; i++) out += ALPHABET[bytes[i] % ALPHABET.length];
+  for (let i = 0; i < size2; i++) out += ALPHABET[bytes[i] % ALPHABET.length];
   return out;
 }
 function isPlainObject(v) {
@@ -585,16 +608,23 @@ function describeRule(rule) {
 // src/events-util.ts
 var SENSITIVE_PROPERTY_PATTERN = /(password|passwd|secret|token|credit|card|cvv|ssn|iban)/i;
 var MAX_PROPERTY_BYTES = 8 * 1024;
+var MAX_APP_VERSION_LENGTH = 64;
+function normalizeAppVersion(input) {
+  if (typeof input !== "string" && typeof input !== "number") return null;
+  const printable = Array.from(String(input)).filter((c) => c.charCodeAt(0) > 31 && c.charCodeAt(0) !== 127).join("");
+  const v = printable.trim().slice(0, MAX_APP_VERSION_LENGTH).trim();
+  return v || null;
+}
 function sanitizeProperties(props) {
   if (!props) return {};
   const out = {};
-  let size = 0;
+  let size2 = 0;
   for (const [k, v] of Object.entries(props)) {
     if (SENSITIVE_PROPERTY_PATTERN.test(k)) continue;
     if (typeof v === "function" || typeof v === "symbol") continue;
     const str2 = typeof v === "string" ? v : JSON.stringify(v ?? null);
-    size += k.length + (str2?.length ?? 0);
-    if (size > MAX_PROPERTY_BYTES) break;
+    size2 += k.length + (str2?.length ?? 0);
+    if (size2 > MAX_PROPERTY_BYTES) break;
     out[k.slice(0, 100)] = typeof v === "string" ? v.slice(0, 1e3) : v;
   }
   return out;
@@ -604,16 +634,23 @@ function sanitizeProperties(props) {
 var MAX_STACK_FRAMES = 30;
 var V8 = /^\s*at (?:(.+?) \()?((?:[a-z][\w+.-]*:)?[^\s()]+?):(\d+):(\d+)\)?\s*$/i;
 var GECKO = /^\s*(.*?)@(.+?):(\d+):(\d+)\s*$/;
+var HERMES = /^\s*at (?:(.+?) \()?address at ([^\s()]+?):(\d+):(\d+)\)?\s*$/;
+function reactNativeBundleUrl(file) {
+  const base = file.replace(/[?#].*$/, "").split("/").pop() || file;
+  return `app:///${base}`;
+}
 function parseStack(stack, max = MAX_STACK_FRAMES) {
   if (!stack || typeof stack !== "string") return [];
   const frames = [];
   for (const raw of stack.split("\n")) {
     if (frames.length >= max) break;
     const line = raw.slice(0, 1e3);
-    const m = V8.exec(line) ?? GECKO.exec(line);
+    const hermes = HERMES.exec(line);
+    const m = hermes ?? V8.exec(line) ?? GECKO.exec(line);
     if (!m) continue;
     const fn = (m[1] || "").trim();
-    frames.push({ fn: fn ? fn.slice(0, 200) : void 0, file: m[2]?.slice(0, 500), line: Number(m[3]), col: Number(m[4]) });
+    const file = hermes ? reactNativeBundleUrl(m[2]) : m[2];
+    frames.push({ fn: fn ? fn.slice(0, 200) : void 0, file: file?.slice(0, 500), line: Number(m[3]), col: Number(m[4]) });
   }
   return frames;
 }
@@ -633,13 +670,23 @@ function normalizeFrameFile(file) {
 var SOURCEMAP_MAX_FILE_BYTES = 100 * 1024 * 1024;
 var SOURCEMAP_MAX_FILES_PER_UPLOAD = 200;
 function fingerprintError(input) {
-  const top = (input.frames ?? []).find((f) => f.file);
-  const frameKey = input.original ? `src:${input.original.source}:${input.original.name || "?"}` : top ? `${normalizeFrameFile(top.file)}:${top.fn || "?"}` : "";
+  const withFile = (input.frames ?? []).filter((f) => f.file || f.module);
+  const top = withFile.find((f) => f.inApp === true) ?? withFile.find((f) => f.inApp !== false) ?? withFile[0];
+  const frameKey = input.original ? `src:${input.original.source}:${input.original.name || "?"}` : top ? `${top.file ? normalizeFrameFile(top.file) : `mod:${top.module}`}:${top.fn || "?"}` : "";
   const key = [input.type || "Error", normalizeErrorMessage(input.message || ""), frameKey].join("|");
   const a = fnv1a(key).toString(16).padStart(8, "0");
   const b = fnv1a(`guidely:${key}`).toString(16).padStart(8, "0");
   return a + b;
 }
+function customFingerprint(parts, computed) {
+  if (!Array.isArray(parts) || parts.length === 0) return computed;
+  const items = parts.filter((p) => typeof p === "string" || typeof p === "number").map((p) => String(p).slice(0, 200)).slice(0, 20);
+  if (items.length === 0) return computed;
+  const isDefault = (p) => /^\{\{\s*default\s*\}\}$/i.test(p);
+  if (items.every(isDefault)) return computed;
+  const key = items.map((p) => isDefault(p) ? computed : p).join("|");
+  return fnv1a(key).toString(16).padStart(8, "0") + fnv1a(`guidely:fp:${key}`).toString(16).padStart(8, "0");
+}
 
 // src/network.ts
 var NETWORK_PLUGIN = "guidely/network@1";
@@ -775,6 +822,19 @@ function isSafeMediaUrl(url) {
     return false;
   }
 }
+function videoThumbnailUrl(url) {
+  const embed = url ? toEmbedUrl(url) : null;
+  if (embed?.provider !== "youtube") return null;
+  const id = embed.src.split("/embed/")[1]?.split("?")[0];
+  return id ? `https://i.ytimg.com/vi/${id}/hqdefault.jpg` : null;
+}
+function isVideoFileUrl(url) {
+  return isSafeMediaUrl(url) && /\.(mp4|webm|m4v|mov|ogv)$/i.test(new URL(url).pathname);
+}
+function stepVideo(step) {
+  if (!step.videoUrl || !isSafeMediaUrl(step.videoUrl)) return null;
+  return { url: step.videoUrl, poster: (step.imageUrl && isSafeMediaUrl(step.imageUrl) ? step.imageUrl : null) ?? videoThumbnailUrl(step.videoUrl) };
+}
 
 // src/resource-center.ts
 var MAX_COLLECTION_DEPTH = 3;
@@ -897,6 +957,16 @@ function unreadAnnouncements(items, lastSeenAt) {
   if (Number.isNaN(seen)) return items.length;
   return items.filter((a) => Date.parse(a.publishedAt) > seen).length;
 }
+var ARTICLE_HREF_PREFIX = "#guidely-article:";
+var ARTICLE_ID = /^[A-Za-z0-9_-]{1,64}$/;
+function articleHref(articleId) {
+  return `${ARTICLE_HREF_PREFIX}${articleId}`;
+}
+function articleIdFromHref(href) {
+  if (!href || !href.startsWith(ARTICLE_HREF_PREFIX)) return null;
+  const id = href.slice(ARTICLE_HREF_PREFIX.length);
+  return ARTICLE_ID.test(id) ? id : null;
+}
 
 // src/howto-limits.ts
 var CAPTURE_PARAM = "guidely_capture";
@@ -1487,6 +1557,10 @@ var MAX_COMPLAINT_ANSWER_LENGTH = 500;
 var MAX_COMPLAINT_ATTACHMENT_BYTES = 2 * 1024 * 1024;
 var complaintReference = (number) => `CMP-${number}`;
 
+// src/bug-reports-limits.ts
+var MAX_BUG_REPORT_LENGTH = 4e3;
+var MAX_BUG_REPORT_SCREENSHOT_BYTES = 4 * 1024 * 1024;
+
 // src/agents-limits.ts
 var AGENT_TURN_ROLES = ["user", "assistant", "tool", "system"];
 var AGENT_OUTCOMES = ["success", "failure", "escalated", "abandoned"];
@@ -1960,6 +2034,71 @@ function contrastIssues(colors) {
   }
   return issues;
 }
+
+// src/error-detail.ts
+var MAX_EXCEPTION_DETAIL_BYTES = 64 * 1024;
+var MAX_EXCEPTION_DETAIL_RAW_BYTES = 1024 * 1024;
+var MAX_BREADCRUMBS = 100;
+var MAX_EXCEPTION_CHAIN = 20;
+var MAX_DETAIL_FRAMES = 250;
+var MAX_DETAIL_THREADS = 100;
+var MAX_DEBUG_IMAGES = 500;
+var MAX_ERROR_TAGS = 50;
+var size = (v) => {
+  try {
+    return JSON.stringify(v)?.length ?? 0;
+  } catch {
+    return Infinity;
+  }
+};
+function normalizeTags(tags) {
+  const out = {};
+  for (const [k, v] of Object.entries(tags ?? {})) {
+    if (Object.keys(out).length >= MAX_ERROR_TAGS) break;
+    if (!k || v === void 0 || v === null) continue;
+    out[k.slice(0, 32)] = String(v).slice(0, 200);
+  }
+  return out;
+}
+function trimExceptionDetail(detail, max = MAX_EXCEPTION_DETAIL_BYTES) {
+  const d = detail;
+  if (d.breadcrumbs?.values && d.breadcrumbs.values.length > MAX_BREADCRUMBS) d.breadcrumbs.values = d.breadcrumbs.values.slice(-MAX_BREADCRUMBS);
+  if (d.exception?.values && d.exception.values.length > MAX_EXCEPTION_CHAIN) d.exception.values = d.exception.values.slice(-MAX_EXCEPTION_CHAIN);
+  if (d.threads?.values && d.threads.values.length > MAX_DETAIL_THREADS) d.threads.values = d.threads.values.slice(0, MAX_DETAIL_THREADS);
+  if (d.debug_meta?.images && d.debug_meta.images.length > MAX_DEBUG_IMAGES) d.debug_meta.images = d.debug_meta.images.slice(0, MAX_DEBUG_IMAGES);
+  const stacks = () => [...d.exception?.values ?? [], ...d.threads?.values ?? []].map((x) => x.stacktrace).filter((s) => !!s);
+  for (const s of stacks()) if (s.frames && s.frames.length > MAX_DETAIL_FRAMES) s.frames = s.frames.slice(-MAX_DETAIL_FRAMES);
+  if (size(d) <= max) return d;
+  while (d.breadcrumbs?.values.length && size(d) > max) d.breadcrumbs.values = d.breadcrumbs.values.slice(Math.ceil(d.breadcrumbs.values.length / 2));
+  if (size(d) <= max) return d;
+  for (const s of stacks())
+    for (const f of s.frames ?? []) {
+      delete f.vars;
+      delete f.pre_context;
+      delete f.post_context;
+    }
+  if (size(d) <= max) return d;
+  if (d.threads?.values) d.threads.values = d.threads.values.filter((t) => t.crashed || t.current);
+  if (size(d) <= max) return d;
+  if (d.extra) d.extra = { _trimmed: true };
+  if (d.request) delete d.request.data;
+  for (const s of stacks()) while (s.frames && s.frames.length > 20 && size(d) > max) s.frames.splice(Math.floor(s.frames.length / 2) - 5, 10);
+  if (d.debug_meta?.images && size(d) > max) d.debug_meta.images = d.debug_meta.images.slice(0, 50);
+  return d;
+}
+var matches = (patterns, value) => patterns.some((p) => typeof p === "string" ? p !== "" && value.includes(p) : safeTest(p, value));
+function safeTest(re, value) {
+  re.lastIndex = 0;
+  return re.test(value);
+}
+function errorFilterDrops(e, opts) {
+  const message = e.message ?? "";
+  if (opts.ignoreErrors?.length && (matches(opts.ignoreErrors, `${e.type || "Error"}: ${message}`) || matches(opts.ignoreErrors, message))) return true;
+  if (!e.file) return false;
+  if (opts.denyUrls?.length && matches(opts.denyUrls, e.file)) return true;
+  if (opts.allowUrls?.length && !matches(opts.allowUrls, e.file)) return true;
+  return false;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AGENT_METADATA_MAX_BYTES,
@@ -1970,6 +2109,7 @@ function contrastIssues(colors) {
   AGENT_TURNS_PER_BATCH,
   AGENT_TURN_MAX_TEXT,
   AGENT_TURN_ROLES,
+  ARTICLE_HREF_PREFIX,
   ARTICLE_VISIBILITIES,
   CAPTURE_PARAM,
   CAPTURE_SCREENSHOT_MAX_BYTES,
@@ -1991,6 +2131,10 @@ function contrastIssues(colors) {
   GUIDE_EXPERIMENT_STATUSES,
   GUIDE_VISIBILITIES,
   LOGGED_IN_AUDIENCE,
+  MAX_APP_VERSION_LENGTH,
+  MAX_BREADCRUMBS,
+  MAX_BUG_REPORT_LENGTH,
+  MAX_BUG_REPORT_SCREENSHOT_BYTES,
   MAX_COLLECTION_DEPTH,
   MAX_COMPLAINT_ANSWER_LENGTH,
   MAX_COMPLAINT_ATTACHMENT_BYTES,
@@ -1998,6 +2142,13 @@ function contrastIssues(colors) {
   MAX_COMPLAINT_FIELDS,
   MAX_COMPLAINT_LENGTH,
   MAX_CUSTOM_CSS,
+  MAX_DEBUG_IMAGES,
+  MAX_DETAIL_FRAMES,
+  MAX_DETAIL_THREADS,
+  MAX_ERROR_TAGS,
+  MAX_EXCEPTION_CHAIN,
+  MAX_EXCEPTION_DETAIL_BYTES,
+  MAX_EXCEPTION_DETAIL_RAW_BYTES,
   MAX_PROPERTY_BYTES,
   MAX_STACK_FRAMES,
   MEDIA_FILE_MAX_BYTES,
@@ -2038,6 +2189,8 @@ function contrastIssues(colors) {
   WS_MAX_MESSAGES_PER_SOCKET,
   WS_MAX_MESSAGE_BYTES,
   applyGuideTranslations,
+  articleHref,
+  articleIdFromHref,
   articleTextEntries,
   assignGuideVariant,
   baseLanguage,
@@ -2049,8 +2202,10 @@ function contrastIssues(colors) {
   contrastIssues,
   contrastRatio,
   cssSelectorError,
+  customFingerprint,
   describeRule,
   emptyRuleGroup,
+  errorFilterDrops,
   evaluateRule,
   evaluateRules,
   evenWeights,
@@ -2079,6 +2234,7 @@ function contrastIssues(colors) {
   isRuleGroup,
   isSafeMediaUrl,
   isVideoContentType,
+  isVideoFileUrl,
   localeName,
   localizeAnnouncement,
   localizeArticle,
@@ -2091,10 +2247,12 @@ function contrastIssues(colors) {
   mediaKind,
   mediaMaxBytes,
   needsReview,
+  normalizeAppVersion,
   normalizeErrorMessage,
   normalizeFrameFile,
   normalizeLocale,
   normalizeSnapshot,
+  normalizeTags,
   orderedModules,
   pageLabel,
   pagePattern,
@@ -2108,6 +2266,7 @@ function contrastIssues(colors) {
   propertyAttributeAllowed,
   queryConditionRegex,
   randomId,
+  reactNativeBundleUrl,
   readableTextOn,
   relativeLuminance,
   resolveLocale,
@@ -2127,13 +2286,16 @@ function contrastIssues(colors) {
   slugify,
   snapshotFromSelector,
   stableStringify,
+  stepVideo,
   stripOrigin,
   supportsPlatform,
   toEmbedUrl,
   translationCoverage,
+  trimExceptionDetail,
   unreadAnnouncements,
   variantProblems,
   variantRanges,
+  videoThumbnailUrl,
   visibleAnnouncements,
   visibleArticleIds,
   visitorAudiences,