@hanzo/event 0.3.8 → 0.3.9

package/dist/index.d.cts

@@ -6,7 +6,7 @@ declare function getFirstTouch(): Attribution | undefined;
 /** Read persisted cohort dimensions. */
 declare function getCohort(): Cohort | undefined;
 
-declare const VERSION = "0.3.8";
+declare const VERSION = "0.3.9";
 
 /**
  * parseDsn parses "https://<version>:<hmac>@<host>/v1/sentry/<projectId>" into its
@@ -60,6 +60,16 @@ declare function buildSentryEvent(input: BuildEventInput): SentryEvent;
  */
 declare function buildEnvelope(event: SentryEvent, dsn: Dsn, sentAt?: string): string;
 
+/**
+ * uuidv7 mints a time-ordered UUIDv7 for `now` (epoch milliseconds).
+ *
+ * Two ids minted in the same millisecond sort arbitrarily between themselves; ids
+ * from different milliseconds sort by time, lexically and numerically alike.
+ */
+declare function uuidv7(now?: number): string;
+/** The millisecond timestamp a v7 id was minted at — the inverse of uuidv7. */
+declare function uuidv7Time(id: string): number;
+
 /**
  * The product → Sentry DSN registry.
  *
@@ -273,4 +283,4 @@ declare function hasAttribution(a: Attribution): boolean;
 /** isoWeek returns the ISO-8601 week label, e.g. "2026-W28". */
 declare function isoWeek(d: Date): string;
 
-export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, EVENTS, type ErrorIdentity, type EventName, FUNNELS, type FunnelDef, type FunnelId, type FunnelStep, GOALS, type GoalDef, PAGEVIEW, PRODUCTS, PRODUCT_DSN, type ProductId, SentryEvent, SentryFrame, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, dsnForProduct, eventsOf, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText };
+export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, EVENTS, type ErrorIdentity, type EventName, FUNNELS, type FunnelDef, type FunnelId, type FunnelStep, GOALS, type GoalDef, PAGEVIEW, PRODUCTS, PRODUCT_DSN, type ProductId, SentryEvent, SentryFrame, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, dsnForProduct, eventsOf, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText, uuidv7, uuidv7Time };

package/dist/index.d.ts

@@ -6,7 +6,7 @@ declare function getFirstTouch(): Attribution | undefined;
 /** Read persisted cohort dimensions. */
 declare function getCohort(): Cohort | undefined;
 
-declare const VERSION = "0.3.8";
+declare const VERSION = "0.3.9";
 
 /**
  * parseDsn parses "https://<version>:<hmac>@<host>/v1/sentry/<projectId>" into its
@@ -60,6 +60,16 @@ declare function buildSentryEvent(input: BuildEventInput): SentryEvent;
  */
 declare function buildEnvelope(event: SentryEvent, dsn: Dsn, sentAt?: string): string;
 
+/**
+ * uuidv7 mints a time-ordered UUIDv7 for `now` (epoch milliseconds).
+ *
+ * Two ids minted in the same millisecond sort arbitrarily between themselves; ids
+ * from different milliseconds sort by time, lexically and numerically alike.
+ */
+declare function uuidv7(now?: number): string;
+/** The millisecond timestamp a v7 id was minted at — the inverse of uuidv7. */
+declare function uuidv7Time(id: string): number;
+
 /**
  * The product → Sentry DSN registry.
  *
@@ -273,4 +283,4 @@ declare function hasAttribution(a: Attribution): boolean;
 /** isoWeek returns the ISO-8601 week label, e.g. "2026-W28". */
 declare function isoWeek(d: Date): string;
 
-export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, EVENTS, type ErrorIdentity, type EventName, FUNNELS, type FunnelDef, type FunnelId, type FunnelStep, GOALS, type GoalDef, PAGEVIEW, PRODUCTS, PRODUCT_DSN, type ProductId, SentryEvent, SentryFrame, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, dsnForProduct, eventsOf, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText };
+export { Attribution, COHORTS, CaptureErrorOptions, Cohort, type CohortDef, Dsn, EVENTS, type ErrorIdentity, type EventName, FUNNELS, type FunnelDef, type FunnelId, type FunnelStep, GOALS, type GoalDef, PAGEVIEW, PRODUCTS, PRODUCT_DSN, type ProductId, SentryEvent, SentryFrame, VERSION, buildEnvelope, buildSentryEvent, deriveChannel, dsnForProduct, eventsOf, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText, uuidv7, uuidv7Time };

package/dist/index.mjs

@@ -217,8 +217,34 @@ function scrubText(s2, capturePII = false) {
   return s2;
 }
 
+// src/uid.ts
+var HEX = Array.from({ length: 256 }, (_, i) => (i + 256).toString(16).slice(1));
+function fill(b) {
+  const c = typeof crypto !== "undefined" ? crypto : void 0;
+  if (c && typeof c.getRandomValues === "function") {
+    c.getRandomValues(b);
+    return b;
+  }
+  for (let i = 0; i < b.length; i++) b[i] = Math.random() * 256 | 0;
+  return b;
+}
+function uuidv7(now = Date.now()) {
+  const b = fill(new Uint8Array(16));
+  let t = Math.floor(now);
+  for (let i = 5; i >= 0; i--) {
+    b[i] = t % 256;
+    t = Math.floor(t / 256);
+  }
+  b[6] = 112 | b[6] & 15;
+  b[8] = 128 | b[8] & 63;
+  return HEX[b[0]] + HEX[b[1]] + HEX[b[2]] + HEX[b[3]] + "-" + HEX[b[4]] + HEX[b[5]] + "-" + HEX[b[6]] + HEX[b[7]] + "-" + HEX[b[8]] + HEX[b[9]] + "-" + HEX[b[10]] + HEX[b[11]] + HEX[b[12]] + HEX[b[13]] + HEX[b[14]] + HEX[b[15]];
+}
+function uuidv7Time(id) {
+  return parseInt(id.slice(0, 8) + id.slice(9, 13), 16);
+}
+
 // src/version.ts
-var VERSION = "0.3.8";
+var VERSION = "0.3.9";
 
 // src/sentry.ts
 var MAX_FRAMES = 50;
@@ -227,11 +253,7 @@ var MAX_LINE_LEN = 2048;
 var MAX_TAG_LEN = 1024;
 var MAX_TAGS = 50;
 function eventId() {
-  const c = typeof crypto !== "undefined" ? crypto : void 0;
-  if (c && "randomUUID" in c) return c.randomUUID().replace(/-/g, "");
-  let s2 = "";
-  for (let i = 0; i < 32; i++) s2 += Math.floor(Math.random() * 16).toString(16);
-  return s2;
+  return uuidv7().replace(/-/g, "");
 }
 function byteLen(s2) {
   if (typeof TextEncoder !== "undefined") return new TextEncoder().encode(s2).length;
@@ -431,17 +453,12 @@ function ls() {
     return void 0;
   }
 }
-function uid() {
-  const c = typeof crypto !== "undefined" ? crypto : void 0;
-  if (c && "randomUUID" in c) return c.randomUUID();
-  return "a-" + Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
-}
 function anonId() {
   const s2 = ls();
   if (!s2) return void 0;
   let v = s2.getItem(KEY.anon);
   if (!v) {
-    v = uid();
+    v = uuidv7();
     s2.setItem(KEY.anon, v);
   }
   return v;
@@ -456,7 +473,7 @@ function sessionId(now = Date.now()) {
     state = null;
   }
   if (!state || now - state.last > SESSION_TTL_MS) {
-    state = { id: uid(), last: now };
+    state = { id: uuidv7(now), last: now };
   } else {
     state.last = now;
   }
@@ -525,11 +542,6 @@ function readEnv(name) {
 function appendQuery(url, key, value) {
   return url + (url.includes("?") ? "&" : "?") + key + "=" + encodeURIComponent(value);
 }
-function uid2() {
-  const c = typeof crypto !== "undefined" ? crypto : void 0;
-  if (c && "randomUUID" in c) return c.randomUUID();
-  return "m-" + Date.now().toString(36) + Math.random().toString(36).slice(2, 10);
-}
 function normalizeError2(err) {
   const n = normalizeError(err);
   return { type: n.name, message: n.message, stack: n.stack };
@@ -781,7 +793,7 @@ var Analytics = class {
   build(kind, event, extra) {
     const anon = anonId();
     const wire = {
-      messageId: uid2(),
+      messageId: uuidv7(),
       type: kind,
       event,
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -978,6 +990,6 @@ var COHORTS = {
   refCode: { field: "ref_code", label: "Referral code" }
 };
 
-export { Analytics, COHORTS, EVENTS, FUNNELS, GOALS, PAGEVIEW, PRODUCTS, PRODUCT_DSN, VERSION, buildEnvelope, buildSentryEvent, createAnalytics, deriveChannel, dsnForProduct, eventsOf, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText };
+export { Analytics, COHORTS, EVENTS, FUNNELS, GOALS, PAGEVIEW, PRODUCTS, PRODUCT_DSN, VERSION, buildEnvelope, buildSentryEvent, createAnalytics, deriveChannel, dsnForProduct, eventsOf, framesFromStack, getCohort, getFirstTouch, hasAttribution, hostOf, isoWeek, parseAttribution, parseDsn, redactSecrets, scrubPII, scrubText, uuidv7, uuidv7Time };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map