@waniwani/sdk 0.17.1 → 0.17.2

package/dist/legacy/index.d.ts

@@ -1451,6 +1451,14 @@ type DeepPartial<T> = T extends (...args: never[]) => unknown ? T : T extends ob
 } : T;
 type MessageOverrides = DeepPartial<Messages>;
 
+/**
+ * A visitor id to apply, or a resolver that produces one. The resolver may be
+ * sync (`() => posthog.get_distinct_id()`) or async
+ * (`async () => (await sdk.ready()).id`), for analytics SDKs whose id is only
+ * available after they bootstrap.
+ */
+type VisitorIdInput = string | (() => string | undefined | null | Promise<string | undefined | null>);
+
 /**
  * Built-in theme presets. `auto` follows the host's `prefers-color-scheme`
  * and switches at runtime without re-rendering.
@@ -1609,6 +1617,21 @@ interface ChatBaseProps {
     appearance?: ChatAppearance;
     /** Per-slot class name overrides. See {@link ChatClassNames}. */
     classNames?: ChatClassNames;
+    /**
+     * Override the anonymous visitor id the widget generates with one you
+     * already track (a PostHog / Amplitude / Segment distinct id, your own
+     * cookie, etc.). The chat sends it on every request, so Waniwani sessions
+     * and events correlate to the same visitor, and server-side MCP tools and
+     * flows read it back as `context.waniwani.visitorId`.
+     *
+     * A string, or a resolver that returns one — sync
+     * (`() => posthog.get_distinct_id()`) or async
+     * (`async () => (await sdk.ready()).id`), for analytics SDKs whose id is
+     * only ready after they bootstrap. A blank / failed result is ignored, so
+     * the auto-generated, `localStorage`-persisted id is kept. Leave unset to
+     * always use the auto id.
+     */
+    visitorId?: VisitorIdInput;
     /** Additional headers to send with chat API requests */
     headers?: Record<string, string>;
     /** Additional body fields to send with each chat request */