@saar-ai/web-widget 0.7.0 → 0.9.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.
- package/dist/chunks/{chat-tMKkYmTC.js → chat-DAgqVvIS.js} +338 -26
- package/dist/chunks/{host-widget-B97T89b7.js → host-widget-CTK7C95y.js} +1326 -21
- package/dist/chunks/{schemas-Bl_6mxe4.js → schemas-D-uDc-9q.js} +164 -1
- package/dist/chunks/{telemetry-BI_SEWTb.js → telemetry-DQUulENJ.js} +16 -1
- package/dist/dock/dock-motion.d.ts +14 -0
- package/dist/dock/dock-motion.d.ts.map +1 -1
- package/dist/dock/dock.d.ts +71 -8
- package/dist/dock/dock.d.ts.map +1 -1
- package/dist/host-routes.d.ts +187 -0
- package/dist/host-routes.d.ts.map +1 -0
- package/dist/host-widget.d.ts +31 -2
- package/dist/host-widget.d.ts.map +1 -1
- package/dist/index.js +2 -2
- package/dist/mount.d.ts +10 -1
- package/dist/mount.d.ts.map +1 -1
- package/dist/next/index.js +1 -1
- package/dist/use-chat-session.d.ts +99 -33
- package/dist/use-chat-session.d.ts.map +1 -1
- package/dist/use-voice-session.d.ts +46 -8
- package/dist/use-voice-session.d.ts.map +1 -1
- package/package.json +3 -3
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"host-widget.d.ts","sourceRoot":"","sources":["../src/host-widget.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,
|
|
1
|
+
{"version":3,"file":"host-widget.d.ts","sourceRoot":"","sources":["../src/host-widget.tsx"],"names":[],"mappings":"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"}
|
package/dist/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { $ as
|
|
1
|
+
import { $ as RADII, A as latencyBetween, At as linearToSrgb, B as CONTROL, Bt as srgbToLinear, C as parseBlocks, Ct as themeToCss, D as SESSION_EVENTS, Dt as hexToOklab, E as SseFrameParser, Et as formatHex, F as idleDockInput, Ft as oklchToHex, G as DOCK_ALIGN_STORAGE_KEY, Gt as widgetMessagesFromCopy, H as DESKTOP_BREAKPOINT, Ht as defaultWidgetMessages, I as latestExchangeStart, It as oklchToOklab, J as MARK, K as DOCK_MINIMISED_STORAGE_KEY, L as formatMoney, Lt as parseHex, M as DOCK_STATES, Mt as oklabToHex, N as deriveDockState, Nt as oklabToLinearRgb, O as SessionLog, Ot as hexToOklch, P as exchangeCount, Pt as oklabToOklch, Q as PROACTIVE_NUDGE_MS, R as ACTIVITY_W, Rt as relativeLuminance, S as WidgetMarkdown, St as deriveTheme, T as botStateFor, Tt as contrastRatio, U as DESKTOP_GUTTER, Ut as formatMessage, V as DESKTOP_BOTTOM, Vt as withAlpha, W as DESKTOP_WIDTHS, Wt as resolveWidgetMessages, X as PILL_H, Y as MOBILE_MARGIN, Z as PILL_MARK, _ as readsAsCartViewIntent, _t as writeStored, a as mergeAddedCartLine, at as SHEET_TOP_CLEARANCE, b as WidgetCartSummary, bt as SYSTEM_FONT_STACK, c as toChatCart, ct as bottomLen, d as useVoiceSession, dt as pillAnchor, et as ROW_H, f as isSameOriginPath, ft as readStored, g as basketIntentFromTurns, gt as snapAlign, h as VoiceWidget, ht as sheetMaxHeightLen, i as deriveCallPhase, it as SHEET_PEEK_MAX, j as Dock, jt as mixToward, k as formatMs, kt as linearRgbToOklab, l as ROOM_EVENTS, lt as geometryVars, mt as rowWidthLen, n as MAX_REPORTED_CART_LINES, nt as SHEET_EXPANDED_VH, o as resolveAddToCartHandler, ot as SHORT_VIEWPORT, p as useChatSession, pt as readStoredAlign, q as DRAG_TAP_SLOP_PX, r as cartLinesFromSnapshot, rt as SHEET_GAP, s as resolveCheckoutUrl, st as Z_INDEX, t as ConciergeWidget, tt as SHEET_EXPANDED_DESKTOP_MAX, u as createWidgetVoiceTokenFetcher, ut as persistAlign, v as readsAsCheckoutIntent, vt as CARD_RADIUS_MAX_PX, w as IDLE_SNAPSHOT, wt as themeToInlineStyle, x as WidgetCardList, xt as WIDGET_THEME_TOKENS, y as textDirectionFor, yt as SHEET_RADIUS_MAX_PX, z as BOTTOM_FLOOR, zt as rotateHue } from "./chunks/host-widget-CTK7C95y.js";
|
|
2
2
|
import { jsx, jsxs } from "react/jsx-runtime";
|
|
3
3
|
import { Component, createElement, useEffect, useId, useRef, useState } from "react";
|
|
4
4
|
import { createRoot } from "react-dom/client";
|
|
@@ -4602,4 +4602,4 @@ function adoptWidgetStylesheet(shadow) {
|
|
|
4602
4602
|
shadow.appendChild(style);
|
|
4603
4603
|
}
|
|
4604
4604
|
//#endregion
|
|
4605
|
-
export { ACTIVITY_W, BOTTOM_FLOOR, BOT_STATES, BotAvatar, BotFace, CARD_RADIUS_MAX_PX, CONTROL, ConciergeWidget, DEFAULT_WIDGET_AVATAR, DESKTOP_BOTTOM, DESKTOP_BREAKPOINT, DESKTOP_GUTTER, DESKTOP_WIDTHS, DOCK_ALIGN_STORAGE_KEY, DOCK_MINIMISED_STORAGE_KEY, DOCK_STATES, DRAG_TAP_SLOP_PX, Dock, IDLE_SNAPSHOT, MARK, MAX_REPORTED_CART_LINES, MOBILE_MARGIN, MorphingLoader, PILL_H, PILL_MARK, PROACTIVE_NUDGE_MS, RADII, ROOM_EVENTS, ROW_H, RopeKnot, SESSION_EVENTS, SHEET_EXPANDED_DESKTOP_MAX, SHEET_EXPANDED_VH, SHEET_GAP, SHEET_PEEK_MAX, SHEET_RADIUS_MAX_PX, SHEET_TOP_CLEARANCE, SHORT_VIEWPORT, SYSTEM_FONT_STACK, SessionLog, SessionPanel, SseFrameParser, VoiceWidget, WIDGET_AVATARS, WIDGET_CSS, WIDGET_THEME_TOKENS, WidgetCardList, WidgetCartSummary, WidgetErrorBoundary, WidgetMarkdown, Z_INDEX, adoptWidgetStylesheet, basketIntentFromTurns, botStateFor, bottomLen, cartLinesFromSnapshot, cn, contrastRatio, createWidgetVoiceTokenFetcher, defaultWidgetMessages, deriveCallPhase, deriveDockState, deriveTheme, exchangeCount, formatHex, formatMessage, formatMoney, formatMs, geometryVars, hexToOklab, hexToOklch, idleDockInput, isBotState, isWidgetAvatar, labelKeyFor, labelProps, latencyBetween, latestExchangeStart, linearRgbToOklab, linearToSrgb, mergeAddedCartLine, mixToward, mountConciergeWidget, oklabToHex, oklabToLinearRgb, oklabToOklch, oklchToHex, oklchToOklab, parseBlocks, parseHex, persistAlign, pillAnchor, readStored, readStoredAlign, readsAsCartViewIntent, readsAsCheckoutIntent, relativeLuminance, resolveAddToCartHandler, resolveCheckoutUrl, resolveWidgetMessages, rotateHue, rowWidthLen, sheetMaxHeightLen, snapAlign, srgbToLinear, textDirectionFor, themeToCss, themeToInlineStyle, toChatCart, useChatSession, useVoiceSession, visualsFor, widgetMessagesFromCopy, withAlpha, writeStored };
|
|
4605
|
+
export { ACTIVITY_W, BOTTOM_FLOOR, BOT_STATES, BotAvatar, BotFace, CARD_RADIUS_MAX_PX, CONTROL, ConciergeWidget, DEFAULT_WIDGET_AVATAR, DESKTOP_BOTTOM, DESKTOP_BREAKPOINT, DESKTOP_GUTTER, DESKTOP_WIDTHS, DOCK_ALIGN_STORAGE_KEY, DOCK_MINIMISED_STORAGE_KEY, DOCK_STATES, DRAG_TAP_SLOP_PX, Dock, IDLE_SNAPSHOT, MARK, MAX_REPORTED_CART_LINES, MOBILE_MARGIN, MorphingLoader, PILL_H, PILL_MARK, PROACTIVE_NUDGE_MS, RADII, ROOM_EVENTS, ROW_H, RopeKnot, SESSION_EVENTS, SHEET_EXPANDED_DESKTOP_MAX, SHEET_EXPANDED_VH, SHEET_GAP, SHEET_PEEK_MAX, SHEET_RADIUS_MAX_PX, SHEET_TOP_CLEARANCE, SHORT_VIEWPORT, SYSTEM_FONT_STACK, SessionLog, SessionPanel, SseFrameParser, VoiceWidget, WIDGET_AVATARS, WIDGET_CSS, WIDGET_THEME_TOKENS, WidgetCardList, WidgetCartSummary, WidgetErrorBoundary, WidgetMarkdown, Z_INDEX, adoptWidgetStylesheet, basketIntentFromTurns, botStateFor, bottomLen, cartLinesFromSnapshot, cn, contrastRatio, createWidgetVoiceTokenFetcher, defaultWidgetMessages, deriveCallPhase, deriveDockState, deriveTheme, exchangeCount, formatHex, formatMessage, formatMoney, formatMs, geometryVars, hexToOklab, hexToOklch, idleDockInput, isBotState, isSameOriginPath, isWidgetAvatar, labelKeyFor, labelProps, latencyBetween, latestExchangeStart, linearRgbToOklab, linearToSrgb, mergeAddedCartLine, mixToward, mountConciergeWidget, oklabToHex, oklabToLinearRgb, oklabToOklch, oklchToHex, oklchToOklab, parseBlocks, parseHex, persistAlign, pillAnchor, readStored, readStoredAlign, readsAsCartViewIntent, readsAsCheckoutIntent, relativeLuminance, resolveAddToCartHandler, resolveCheckoutUrl, resolveWidgetMessages, rotateHue, rowWidthLen, sheetMaxHeightLen, snapAlign, srgbToLinear, textDirectionFor, themeToCss, themeToInlineStyle, toChatCart, useChatSession, useVoiceSession, visualsFor, widgetMessagesFromCopy, withAlpha, writeStored };
|
package/dist/mount.d.ts
CHANGED
|
@@ -1,6 +1,15 @@
|
|
|
1
1
|
import { type ConciergeWidgetProps } from './host-widget.js';
|
|
2
2
|
export interface MountedWidget {
|
|
3
|
-
/**
|
|
3
|
+
/**
|
|
4
|
+
* Unmounts the React tree and detaches nothing else — the shadow root stays
|
|
5
|
+
* on `host` (removing it is the caller's own DOM to own).
|
|
6
|
+
*
|
|
7
|
+
* CALL IT. Removing `host` from the document is NOT equivalent: detaching
|
|
8
|
+
* leaves the tree mounted, so `useChatSession`'s refresh timer, its polling
|
|
9
|
+
* loop, its desk socket and every listener the dock attached keep running
|
|
10
|
+
* for the life of the page. A host that mounts and removes the widget across
|
|
11
|
+
* route changes accumulates one live widget per route.
|
|
12
|
+
*/
|
|
4
13
|
unmount(): void;
|
|
5
14
|
}
|
|
6
15
|
/**
|
package/dist/mount.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,MAAM,WAAW,aAAa;IAC5B
|
|
1
|
+
{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAIA,OAAO,EAAmB,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG9E,MAAM,WAAW,aAAa;IAC5B;;;;;;;;;OASG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,WAAW,EACjB,KAAK,EAAE,oBAAoB,GAC1B,aAAa,CAqCf;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAiB9D"}
|
package/dist/next/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { m as detectPage, t as ConciergeWidget } from "../chunks/host-widget-CTK7C95y.js";
|
|
2
2
|
import { useCallback, useEffect, useMemo, useRef } from "react";
|
|
3
3
|
import { usePathname, useRouter } from "next/navigation";
|
|
4
4
|
//#region src/next/use-next-bridge.ts
|
|
@@ -1,5 +1,16 @@
|
|
|
1
|
-
import type { VisitorEventCollector } from '@saar-ai/widget-bridge';
|
|
2
|
-
import type { WidgetChatCart, WidgetChatReport } from '@saar-ai/widget-protocol/chat';
|
|
1
|
+
import type { PageContext, VisitorEventCollector } from '@saar-ai/widget-bridge';
|
|
2
|
+
import type { WidgetChatCard, WidgetChatCart, WidgetChatReport } from '@saar-ai/widget-protocol/chat';
|
|
3
|
+
import type { WidgetActEvent } from '@saar-ai/widget-protocol/act';
|
|
4
|
+
/**
|
|
5
|
+
* Is `value` a root-relative, same-origin storefront path?
|
|
6
|
+
*
|
|
7
|
+
* Exported so `host-widget.tsx` re-checks at the POINT OF USE as well — the
|
|
8
|
+
* two act events that carry a navigable field arrive on two different
|
|
9
|
+
* transports (this hook's SSE stream, and `use-voice-session.ts`'s data
|
|
10
|
+
* channel), and a check that lived only here would cover one of them. The
|
|
11
|
+
* bytes are one regex either way.
|
|
12
|
+
*/
|
|
13
|
+
export declare function isSameOriginPath(value: unknown): value is string;
|
|
3
14
|
/**
|
|
4
15
|
* Text chat transport for the end-user widget: boots a session, sends typed
|
|
5
16
|
* turns over `POST /widget/chat` (SSE), and receives a human desk reply over
|
|
@@ -117,37 +128,42 @@ export type ChatStatus = 'idle' | 'streaming' | 'escalated' | 'error';
|
|
|
117
128
|
* or the handshake was refused); poll restores to its normal cadence.
|
|
118
129
|
*/
|
|
119
130
|
export type ChatConnectionState = 'idle' | 'connecting' | 'connected' | 'disconnected';
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
135
|
-
|
|
136
|
-
|
|
137
|
-
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
131
|
+
/**
|
|
132
|
+
* The UI's own name for one product/curation card, as it renders it.
|
|
133
|
+
*
|
|
134
|
+
* An ALIAS of `@saar-ai/widget-protocol/chat`'s `WidgetChatCard` — the wire
|
|
135
|
+
* shape the server already validated before this ever reaches the widget —
|
|
136
|
+
* not a hand-maintained retyping. The two used to drift silently: a field
|
|
137
|
+
* added to the wire schema (`WidgetChatCardSchema`) would type-check here
|
|
138
|
+
* with no error, and the card renderer would just never see it. `variantId`
|
|
139
|
+
* is the INTERNAL catalog UUID (`curation_items.variant_id`) — never a
|
|
140
|
+
* platform id; see `platformVariantId` for what `addToCart` actually needs.
|
|
141
|
+
*
|
|
142
|
+
* `platformVariantId` is the PLATFORM-NATIVE variant id (e.g. Shopify's
|
|
143
|
+
* numeric `/cart/add.js` id, extracted server-side from the variant's
|
|
144
|
+
* provider GID via `apps/api/src/catalog/checkout-permalink.ts`'s
|
|
145
|
+
* `parseShopifyVariantNumericId` — the SAME parser the checkout permalink
|
|
146
|
+
* uses, never a client-side string-slice of `variantId`).
|
|
147
|
+
* `resolveAddToCartHandler` (`host-widget.tsx`) calls `bridge.addToCart` with
|
|
148
|
+
* THIS field, never `variantId` — adversarial-review finding #2: the
|
|
149
|
+
* internal UUID is meaningless to `ShopifyBridge`'s `POST /cart/add.js`,
|
|
150
|
+
* which needs Shopify's own numeric id. Absent whenever the underlying
|
|
151
|
+
* variant's external id isn't a recognised platform GID (§5.3's "degrade,
|
|
152
|
+
* never fabricate" — never guessed from `variantId`) — in that case the
|
|
153
|
+
* widget offers no add-to-cart action for this card and falls back to a PDP
|
|
154
|
+
* navigation instead, same as a card with no `handle` at all falling back to
|
|
155
|
+
* nothing.
|
|
156
|
+
*
|
|
157
|
+
* `Readonly<...>`, not the bare alias — `WidgetChatCard` is `z.infer<...>`
|
|
158
|
+
* and carries no `readonly` modifiers (zod does not emit them), but the
|
|
159
|
+
* interface this replaced marked every field `readonly` and callers hold
|
|
160
|
+
* `ChatCardItem[]` buffers (`host-widget.tsx`'s pending-cart-add and
|
|
161
|
+
* cards-by-turn maps) that were never meant to be mutated in place. Dropping
|
|
162
|
+
* that annotation silently was caught by adversarial review, not intended —
|
|
163
|
+
* `Readonly<WidgetChatCard>` restores it while staying a real alias: any
|
|
164
|
+
* field the wire schema adds still flows through with no edit here.
|
|
165
|
+
*/
|
|
166
|
+
export type ChatCardItem = Readonly<WidgetChatCard>;
|
|
151
167
|
export interface ChatCards {
|
|
152
168
|
readonly curationId?: string;
|
|
153
169
|
readonly items: readonly ChatCardItem[];
|
|
@@ -287,6 +303,23 @@ export interface UseChatSessionOptions {
|
|
|
287
303
|
* this option is purely additive.
|
|
288
304
|
*/
|
|
289
305
|
readonly collector?: VisitorEventCollector;
|
|
306
|
+
/**
|
|
307
|
+
* Which navigation targets THIS host page can actually resolve, sent once on
|
|
308
|
+
* `POST /widget/session` — see `./host-routes.ts` for the defect and
|
|
309
|
+
* `@saar-ai/widget-protocol`'s `host-routes.ts` for the wire contract.
|
|
310
|
+
*
|
|
311
|
+
* Absent ⇒ the field is omitted from the boot body entirely and the server
|
|
312
|
+
* keeps its storefront assumption, which is what every host did before this
|
|
313
|
+
* existed. An EMPTY array is a real declaration ("I can serve none of
|
|
314
|
+
* these") and is sent as one.
|
|
315
|
+
*
|
|
316
|
+
* Re-sent on a RECOVERY boot as well as a mount boot, unlike the tenant
|
|
317
|
+
* config this hook deliberately does not re-apply: a recovery mints a new
|
|
318
|
+
* session row server-side, and a capability omitted from that boot would
|
|
319
|
+
* leave the new session assuming a Shopify storefront on a host that is not
|
|
320
|
+
* one — the original bug, arriving thirty minutes in.
|
|
321
|
+
*/
|
|
322
|
+
readonly hostRoutes?: readonly ('product' | 'collection' | 'search' | 'cart' | 'url')[];
|
|
290
323
|
/**
|
|
291
324
|
* Overridable for tests; defaults to `Date.now`.
|
|
292
325
|
*
|
|
@@ -342,6 +375,20 @@ export interface UseChatSessionResult {
|
|
|
342
375
|
* one" exact across re-renders.
|
|
343
376
|
*/
|
|
344
377
|
readonly cartAdds: readonly ChatCartAdd[];
|
|
378
|
+
/**
|
|
379
|
+
* Every ACT event received this session, oldest first — `navigate`,
|
|
380
|
+
* `filter`, `spotlight` (`@saar-ai/widget-protocol`'s `act.ts`): the
|
|
381
|
+
* concierge asking the widget to DRIVE the host page rather than describe
|
|
382
|
+
* it.
|
|
383
|
+
*
|
|
384
|
+
* Collected here and performed nowhere: the page belongs to a `HostBridge`
|
|
385
|
+
* this hook has no handle on. `ConciergeWidget` (`host-widget.tsx`) is the
|
|
386
|
+
* consumer, and — exactly as with {@link cartAdds} — it must consume these
|
|
387
|
+
* **by object identity**: each entry is a distinct object, one per SSE
|
|
388
|
+
* frame, so "have I already performed THIS one" survives a re-render and a
|
|
389
|
+
* repeated instruction ("no, the OTHER blue one") is still two spotlights.
|
|
390
|
+
*/
|
|
391
|
+
readonly actEvents: readonly WidgetActEvent[];
|
|
345
392
|
readonly status: ChatStatus;
|
|
346
393
|
readonly error?: string;
|
|
347
394
|
/** `true` once `POST /widget/session` has resolved (success or failure). */
|
|
@@ -518,6 +565,25 @@ export interface UseChatSessionResult {
|
|
|
518
565
|
* about.
|
|
519
566
|
*/
|
|
520
567
|
readonly pushCart: (cart: WidgetChatCart) => Promise<boolean>;
|
|
568
|
+
/**
|
|
569
|
+
* `POST /widget/context` — push where the shopper is standing, so the
|
|
570
|
+
* concierge can ground a sentence on it (ADR 0014).
|
|
571
|
+
*
|
|
572
|
+
* NOT a chat turn. It changes nothing on screen, adds nothing to the
|
|
573
|
+
* transcript, and does not start a conversation: a push before the session
|
|
574
|
+
* has a token resolves `false` and is dropped, the same gate `pushCart`
|
|
575
|
+
* applies.
|
|
576
|
+
*
|
|
577
|
+
* THE GATES ARE NOT HERE. `PageContextTracker` (`@saar-ai/widget-bridge`)
|
|
578
|
+
* decides whether a context may leave the page at all — consent, plus the
|
|
579
|
+
* tenant's tracking toggle — and is the only caller. This function is the
|
|
580
|
+
* transport, and the server re-checks both gates regardless.
|
|
581
|
+
*
|
|
582
|
+
* Resolves `false` on a refusal (204), a rejection, or a network failure,
|
|
583
|
+
* and never throws: a page context that does not arrive costs the shopper a
|
|
584
|
+
* grounded phrase and nothing else.
|
|
585
|
+
*/
|
|
586
|
+
readonly pushPageContext: (context: PageContext) => Promise<boolean>;
|
|
521
587
|
/**
|
|
522
588
|
* `POST /widget/event` with the session's chatToken. Resolves `false` (never
|
|
523
589
|
* throws) with no session or on a network/HTTP failure — browsing telemetry
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"use-chat-session.d.ts","sourceRoot":"","sources":["../src/use-chat-session.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;
|
|
1
|
+
{"version":3,"file":"use-chat-session.d.ts","sourceRoot":"","sources":["../src/use-chat-session.ts"],"names":[],"mappings":"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"}
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import type { BotState } from './bot-state.js';
|
|
2
|
-
import type { SessionConfigPayload, TranscriptPayload, TurnCostPayload, TurnLatencyPayload } from '@saar-ai/widget-protocol/telemetry';
|
|
2
|
+
import type { CallerInterruptReason, SessionConfigPayload, TranscriptPayload, TurnCostPayload, TurnLatencyPayload } from '@saar-ai/widget-protocol/telemetry';
|
|
3
3
|
import type { SessionTuning } from '@saar-ai/widget-protocol/tuning';
|
|
4
4
|
import type { WidgetToolEvent } from '@saar-ai/widget-protocol/chat';
|
|
5
5
|
import { type SessionLogEntry } from './session-log.js';
|
|
@@ -160,19 +160,44 @@ declare function loadVoiceProtocol(): Promise<{
|
|
|
160
160
|
available: import("zod").ZodBoolean;
|
|
161
161
|
reason: import("zod").ZodOptional<import("zod").ZodString>;
|
|
162
162
|
}, import("zod/v4/core").$strip>;
|
|
163
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
164
|
+
type: import("zod").ZodLiteral<"navigate">;
|
|
165
|
+
url: import("zod").ZodString;
|
|
166
|
+
target: import("zod").ZodEnum<{
|
|
167
|
+
cart: "cart";
|
|
168
|
+
collection: "collection";
|
|
169
|
+
product: "product";
|
|
170
|
+
search: "search";
|
|
171
|
+
url: "url";
|
|
172
|
+
}>;
|
|
173
|
+
reason: import("zod").ZodString;
|
|
174
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
175
|
+
type: import("zod").ZodLiteral<"filter">;
|
|
176
|
+
collectionUrl: import("zod").ZodOptional<import("zod").ZodString>;
|
|
177
|
+
filters: import("zod").ZodRecord<import("zod").ZodString, import("zod").ZodArray<import("zod").ZodString>>;
|
|
178
|
+
}, import("zod/v4/core").$strip>, import("zod").ZodObject<{
|
|
179
|
+
type: import("zod").ZodLiteral<"spotlight">;
|
|
180
|
+
productId: import("zod").ZodString;
|
|
181
|
+
handle: import("zod").ZodOptional<import("zod").ZodString>;
|
|
182
|
+
platformProductId: import("zod").ZodOptional<import("zod").ZodString>;
|
|
183
|
+
title: import("zod").ZodOptional<import("zod").ZodString>;
|
|
163
184
|
}, import("zod/v4/core").$strip>], "type">;
|
|
164
185
|
}>;
|
|
165
186
|
export type VoiceProtocol = Awaited<ReturnType<typeof loadVoiceProtocol>>;
|
|
166
187
|
/**
|
|
167
188
|
* Why the shopper cut the agent off, when they did it without speaking.
|
|
168
189
|
*
|
|
169
|
-
*
|
|
170
|
-
* `
|
|
171
|
-
*
|
|
172
|
-
*
|
|
173
|
-
* text mid-reply.
|
|
190
|
+
* Re-exported (not retyped) from `@saar-ai/widget-protocol/telemetry`'s
|
|
191
|
+
* `CallerInterruptReason` — the type derived from `CALLER_INTERRUPT_REASONS`,
|
|
192
|
+
* the same names `apps/voice`'s `handleCallerControl` records on the turn:
|
|
193
|
+
* `'look'` is §5.1's duck (the shopper turned to the page), `'tap'` the
|
|
194
|
+
* explicit interrupt control, `'keyboard'` a switch to text mid-reply. A
|
|
195
|
+
* TYPE-only import — this file already imports payload types from the same
|
|
196
|
+
* subpath above — so a fourth reason added to the wire enum reaches this
|
|
197
|
+
* hook's `interrupt()` signature with no edit here, rather than silently
|
|
198
|
+
* type-checking against a stale three-value union.
|
|
174
199
|
*/
|
|
175
|
-
export type CallerInterruptReason
|
|
200
|
+
export type { CallerInterruptReason };
|
|
176
201
|
/**
|
|
177
202
|
* `RoomEvent` values, as literals.
|
|
178
203
|
*
|
|
@@ -334,6 +359,20 @@ export interface VoiceSession {
|
|
|
334
359
|
* Same "resolves false rather than throwing" contract as `sendText`.
|
|
335
360
|
*/
|
|
336
361
|
interrupt(reason: CallerInterruptReason): Promise<boolean>;
|
|
362
|
+
/**
|
|
363
|
+
* DOCK_SPEC §8.6 — "this page is about to go, and it is not a hangup."
|
|
364
|
+
*
|
|
365
|
+
* Sent by the widget just before it performs a concierge-driven `navigate`
|
|
366
|
+
* (`@saar-ai/widget-protocol`'s act events). The `pagehide` handler inside
|
|
367
|
+
* this hook already sends the same frame for a shopper's own click and for
|
|
368
|
+
* a full-document navigation, and it still does — this is the SOFT
|
|
369
|
+
* navigation it cannot see, where no `pagehide` fires and the caller's
|
|
370
|
+
* participant would simply vanish.
|
|
371
|
+
*
|
|
372
|
+
* Same "resolves false rather than throwing" contract as `sendText`, so a
|
|
373
|
+
* caller with no live call pays one function call.
|
|
374
|
+
*/
|
|
375
|
+
notifyNavigating(): Promise<boolean>;
|
|
337
376
|
}
|
|
338
377
|
export interface WidgetVoiceTokenFetcherOptions {
|
|
339
378
|
/**
|
|
@@ -385,5 +424,4 @@ export interface WidgetVoiceTokenFetcherOptions {
|
|
|
385
424
|
*/
|
|
386
425
|
export declare function createWidgetVoiceTokenFetcher(options: WidgetVoiceTokenFetcherOptions): (tuning: SessionTuning) => Promise<CallerSession>;
|
|
387
426
|
export declare function useVoiceSession(options?: UseVoiceSessionOptions): VoiceSession;
|
|
388
|
-
export {};
|
|
389
427
|
//# sourceMappingURL=use-voice-session.d.ts.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"use-voice-session.d.ts","sourceRoot":"","sources":["../src/use-voice-session.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACrE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE,OAAO,EAAqC,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC3F,OAAO,EAGL,KAAK,UAAU,EACf,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAC;AAElC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmEG;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,MAAM,IAAI,gBAAgB,CAAC;IAC3B,MAAM,IAAI,gBAAgB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IACjE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC;IAClE,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,6EAA6E;IAC7E,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,gBAAgB,EAAE;QAChB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;QACzD;;;;WAIG;QACH,WAAW,CAAC,CACV,OAAO,EAAE,UAAU,EACnB,OAAO,EAAE;YAAE,QAAQ,EAAE,OAAO,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,GAC5C,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,kBAAkB,EAAE,WAAW,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;CAC/D;AAED;;;;;;;;GAQG;AACH,iBAAe,iBAAiB
|
|
1
|
+
{"version":3,"file":"use-voice-session.d.ts","sourceRoot":"","sources":["../src/use-voice-session.ts"],"names":[],"mappings":"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"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@saar-ai/web-widget",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.9.0",
|
|
4
4
|
"saar:distribution": "publishable",
|
|
5
5
|
"description": "The concierge widget's React UI — ConciergeShell chrome plus the full end-user conversation (VoiceWidget, useChatSession, useVoiceSession) — de-Nexted for the merchant-site embed (docs/WIDGET_EMBED_PLAN.md §4 Phase 3). Publishes PUBLICLY to npmjs (docs/WIDGET_EMBED_PLAN.md §5.1) — every workspace and third-party runtime dependency is bundled into dist/ at build time, so \"dependencies\" is empty. React and react-dom are peer dependencies only; next is an optional peer, needed only by the ./next subpath (Phase 5).",
|
|
6
6
|
"type": "module",
|
|
@@ -70,8 +70,8 @@
|
|
|
70
70
|
"typescript": "^7.0.2",
|
|
71
71
|
"vite": "8.0.16",
|
|
72
72
|
"vitest": "4.1.10",
|
|
73
|
-
"@saar-ai/widget-bridge": "0.
|
|
74
|
-
"@saar-ai/widget-protocol": "0.
|
|
73
|
+
"@saar-ai/widget-bridge": "0.6.0",
|
|
74
|
+
"@saar-ai/widget-protocol": "0.7.0",
|
|
75
75
|
"@wesence/branding": "0.0.1",
|
|
76
76
|
"@wesence/vitest-presets": "0.0.1"
|
|
77
77
|
},
|