@bicharts/chart-host 0.5.121 → 0.5.122

package/dist/index.mjs

@@ -2376,6 +2376,34 @@ function reconcileChartPick(pick, offered, autoLabel) {
   };
 }
 
+// src/clientIdentity.ts
+function stableFingerprintOptions() {
+  return { exclude: ["fonts", "system.useragent", "system.browser.version"], logging: false };
+}
+function fnv1a(text) {
+  let h2 = 2166136261;
+  for (let i2 = 0; i2 < text.length; i2++) {
+    h2 ^= text.charCodeAt(i2);
+    h2 = Math.imul(h2, 16777619) >>> 0;
+  }
+  return h2 >>> 0;
+}
+function fingerprintComponentDigest(components) {
+  if (!components || typeof components !== "object") return "";
+  const parts = [];
+  for (const [name2, value] of Object.entries(components)) {
+    const timedOut = !!value && typeof value === "object" && value.timeout === "true";
+    let text;
+    try {
+      text = JSON.stringify(value) ?? "undefined";
+    } catch {
+      text = String(value);
+    }
+    parts.push(`${name2}:${timedOut ? "timeout" : (fnv1a(text) >>> 16).toString(16).padStart(4, "0")}`);
+  }
+  return parts.join(",");
+}
+
 // src/index.ts
 function registerCityTable(packed) {
   L3(packed);
@@ -2511,6 +2539,7 @@ export {
   explainRenderFailure,
   filterFitsChooser,
   filterQualifyRows,
+  fingerprintComponentDigest,
   fitReadingFor,
   fitRenderedChart,
   formatSourceDate,
@@ -2592,6 +2621,7 @@ export {
   shouldOpenChooserOnGenerate,
   shouldOpenInlineChooserOnGenerate,
   shouldReview,
+  stableFingerprintOptions,
   stripEsmExports,
   stripJsComments,
   svgInkReach,

package/dist/types/clientIdentity.d.ts

@@ -0,0 +1,16 @@
+/** Where a host's client id came from, reported on every request so identity durability is measured, not guessed.
+ *  `persisted`: a minted id the host keeps; `fingerprint`: derived from the browser; `session`: neither was available,
+ *  so the id lives for this session only. */
+export type ClientIdSource = "persisted" | "fingerprint" | "session";
+/** ThumbmarkJS options shared by every browser host. A fresh object each call, so no host can mutate another's. */
+export declare function stableFingerprintOptions(): {
+    exclude: string[];
+    logging: boolean;
+};
+/**
+ * A short digest of each fingerprint component - `name:xxxx` joined by commas, in the library's own order - so a log
+ * line can say WHICH input moved when a host's fingerprint changes (the id alone cannot). A component the library gave
+ * up on (it times out after a few seconds and reports `{timeout: "true"}`) reads `name:timeout`, because a timed-out
+ * component alone changes the fingerprint. Opaque to every source value: 16 bits of a hash per component.
+ */
+export declare function fingerprintComponentDigest(components: Record<string, unknown> | null | undefined): string;

package/dist/types/index.d.ts

@@ -37,3 +37,4 @@ export { resolveAutoColorScale, autoRampMinStep, autoRampCanvas, AUTO_RAMP_CLASS
 export { PENDING_RECOVERY_WINDOW_MS, PENDING_RECOVERY_POLL_MS, PENDING_RECOVERY_FIRST_POLL_MS, PENDING_RECOVERY_FAST_PHASE_MS, PENDING_RECOVERY_MID_POLL_MS, PENDING_RECOVERY_SLOW_PHASE_MS, PENDING_RECOVERY_SLOW_POLL_MS, pendingRecoveryNextDelayMs, encodePendingGenerate, parsePendingGenerate, markerArmedBlind, isBlindMarker, servedCorrelationProves, sameMarker, decidePendingRecovery, recoveryPollRunning, recoveryOwnsTheSentence, latePickupAction, latePickupKeepsMarker, pollGiveUpKeepsMarker, pendingRecoveryRemainingMs, transportFailureShouldRecover, TRANSPORT_LOST_CHECKING_MESSAGE, GENERATION_CANCELLED_MESSAGE, recoveryAnswerIsCancelled, generationCancelledMessage, type PendingGenerateMarker, type PendingRecoveryDecision, type LatePickupAction, } from "./pendingGenerate";
 export { stripJsComments } from "./codeComments";
 export { reconcileChartPick, type ChartPickReconciliation } from "./chartPick";
+export { stableFingerprintOptions, fingerprintComponentDigest, type ClientIdSource } from "./clientIdentity";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bicharts/chart-host",
-  "version": "0.5.121",
+  "version": "0.5.122",
   "description": "Run a BIC-generated D3 chart in any web host: compiles the generated render() function, applies the shared option defaults, resolves mark clicks (through tooltip overlays), owns the selection affordance, and translates row indices between cross-filtered charts. The same contract the BIC Power BI visual implements, minus Power BI. React bindings at @bicharts/chart-host/react.",
   "license": "Apache-2.0",
   "type": "module",