@sentientui/core 0.42.0 → 0.44.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.
@@ -171,7 +171,7 @@ declare function exposedStage(stage: unknown, mode: StageAttributes | undefined)
171
171
  */
172
172
  declare function setStageAttribute(value: string | null, doc?: Document): void;
173
173
 
174
- declare const PROD_KEYLESS_ERROR = "[sentient] No API key configured \u2014 nothing is being learned. Set NEXT_PUBLIC_SENTIENT_API_KEY or pass localMode: true for local development.";
174
+ declare const PROD_KEYLESS_ERROR = "[sentient] No API key configured \u2014 nothing is being learned. Set NEXT_PUBLIC_SENTIENT_API_KEY (Vite: VITE_SENTIENT_API_KEY) or localMode: true.";
175
175
  declare const LOCAL_MODE_BANNER = "[sentient] Local mode \u2014 decisions are simulated on-device and nothing is sent over the network. Add an API key to learn from real traffic.";
176
176
 
177
177
  /**
@@ -374,7 +374,15 @@ type SentientConfig = {
374
374
  * will not upgrade it. Set `false` to make your own consent gate authoritative.
375
375
  */
376
376
  respectDoNotTrack?: boolean;
377
+ /**
378
+ * Your own id for this visitor, when the page already knows it at start-up
379
+ * (a signed-in user). Same effect as calling `identify(userId)` after init:
380
+ * it links their devices and lets a person who already reached your main
381
+ * goal be recognised as such. Never an email address.
382
+ */
377
383
  userId?: string;
384
+ /** `signUserId(userId, secretKey)` from your server, making `userId` a VERIFIED identify. */
385
+ userHash?: string;
378
386
  /**
379
387
  * Marks this visit as your own team's or a test site's, so it is left out of
380
388
  * every report and out of learning (it is still served versions, so QA keeps
@@ -388,7 +396,7 @@ type SentientConfig = {
388
396
  /**
389
397
  * Declared persona — the role your app already knows for this visitor
390
398
  * (e.g. 'admin', 'evaluator'). Must be a key in the project's persona
391
- * vocabulary (dashboard → Matrix → Audiences); unrecognized values are
399
+ * vocabulary (dashboard → Audiences); unrecognized values are
392
400
  * ignored server-side and surfaced in the dashboard so you can add them.
393
401
  * Declared personas are served at full confidence, overriding the inferred
394
402
  * one. Keep it a low-cardinality role label — never a user id or email.