@sapia-ai/chatbot-v3 1.1.0 → 1.2.0

package/dist/{Preview-wPnYtccF.js → Preview-CbNUoib5.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 //#region ../../node_modules/.pnpm/react-player@3.4.0_@svta+cml-cta@1.0.6_@svta+cml-structured-field-values@1.1.3_@svta+cm_a4f64f295cc2a316f39ce360b0a6e480/node_modules/react-player/dist/Preview.js
 var n = /* @__PURE__ */ e(t(), 1), r = "64px", i = {}, a = ({ src: e, light: t, oEmbedUrl: a, onClickPreview: o, playIcon: s, previewTabIndex: c, previewAriaLabel: l }) => {
 	let [u, d] = (0, n.useState)(null);
@@ -81,4 +81,4 @@ var n = /* @__PURE__ */ e(t(), 1), r = "64px", i = {}, a = ({ src: e, light: t,
 //#endregion
 export { a as default };
 
-//# sourceMappingURL=Preview-wPnYtccF.js.map
+//# sourceMappingURL=Preview-CbNUoib5.js.map

package/dist/api/types/messages.d.ts

@@ -65,7 +65,15 @@ export declare enum AssessmentStatus {
     FI_PREDICTION_COMPLETED = "FI_PREDICTION_COMPLETED",
     FI_ASSESSMENT_DUPLICATED = "FI_ASSESSMENT_DUPLICATED"
 }
-export type MessageIdentifier = string;
+/**
+ * Backend message identifiers the widget branches on. The wire carries many more; only the ones
+ * with FE behaviour are enumerated, and the bubble field stays widened to `string` so unknown
+ * identifiers pass through untouched.
+ */
+export declare enum MessageIdentifier {
+    SUBMIT_QUESTION = "SUBMIT_QUESTION_MESSAGE",
+    FEEDBACK_CUSTOMER_SATISFACTION_QUESTION = "FEEDBACK_CUSTOMER_SATISFACTION_QUESTION_MESSAGE"
+}
 export type Trigger = {
     action: string;
 };
@@ -146,7 +154,7 @@ export type Answer = {
 export interface Message<T> {
     id: string;
     sender: MessageSender;
-    messageIdentifier?: MessageIdentifier;
+    messageIdentifier?: MessageIdentifier | string;
     data: T;
 }
 export type CandidateResponse = Message<Answer>;

package/dist/api/types/responses.d.ts

@@ -65,6 +65,7 @@ export type VideoSignedUrlResponse = {
 export type AccessManagementResponse = {
     shouldAuthenticate: boolean;
     emailHint?: string;
+    /** Assessment language; the gate renders before /start/ats, so this is its only source. */
     language?: string;
 };
 /** POST verify-access — whether the candidate email matches. */

package/dist/api.js

@@ -1,2 +1,2 @@
-import { _ as e, a as t, b as n, c as r, d as i, f as a, g as o, h as s, i as c, l, m as u, n as d, o as f, p, r as m, s as h, t as g, u as _, v, x as y, y as b } from "./messages-DCvBcspv.js";
-export { s as API_ORIGIN_BY_ENV, p as AgUiEventType, g as AssessmentStatus, d as ButtonType, o as CHATBOT_API_PATH, a as ChatbotApiClient, m as ContentComponent, c as ContentType, e as DEFAULT_LOCAL_API_ORIGIN, v as ENVIRONMENTS, t as MessageKind, f as MessageSender, h as PHService, r as PiiQuestionType, l as QuestionType, b as REGIONS, _ as RuleName, u as SummaryActionStatus, i as VideoQuestionType, n as buildChatbotBaseUrl, y as resolveApiOrigin };
+import { S as e, _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, v as y, x as b, y as x } from "./messages-t5h3u6nr.js";
+export { s as API_ORIGIN_BY_ENV, d as AgUiEventType, _ as AssessmentStatus, f as ButtonType, t as CHATBOT_API_PATH, m as ChatbotApiClient, h as ContentComponent, l as ContentType, y as DEFAULT_LOCAL_API_ORIGIN, x as ENVIRONMENTS, n as MessageIdentifier, p as MessageKind, g as MessageSender, i as PHService, u as PiiQuestionType, v as QuestionType, r as REGIONS, a as RuleName, c as SummaryActionStatus, o as VideoQuestionType, b as buildChatbotBaseUrl, e as resolveApiOrigin };

package/dist/core/bubbles/convert.d.ts

@@ -2,6 +2,16 @@ import { PiiQuestionType, VideoQuestionType, AgentResponse, CandidateResponse, T
 import { MessageBubble } from './types';
 export declare const piiQuestionTypeFromQuestionTags: (tags?: Tag[]) => PiiQuestionType | undefined;
 export declare const videoQuestionTypeFromQuestionTags: (tags?: Tag[]) => VideoQuestionType | undefined;
+/**
+ * Whether this question opts out of the paste block. An absent tag means blocked: the default is
+ * the restrictive one, so a question only becomes pasteable when the BE says so explicitly.
+ */
+export declare const questionTagsAllowPaste: (tags?: Tag[]) => boolean;
+/**
+ * Whether this question is the SMS-consent prompt. The BE marks it with a button-type tag rather
+ * than a dedicated message identifier, and the tag rides along on the answer bubble too.
+ */
+export declare const questionTagsAreSmsConsent: (tags?: Tag[]) => boolean;
 export declare const convertRawCandidateResponseToMessageBubble: (response: CandidateResponse) => MessageBubble;
 export declare const convertRawAgentResponseToMessageBubble: (response: AgentResponse, hasNext?: boolean) => MessageBubble;
 export declare const convertRawResponseToMessageBubble: (response: CandidateResponse | AgentResponse, hasNext?: boolean) => MessageBubble | undefined;

package/dist/core/bubbles/types.d.ts

@@ -32,7 +32,7 @@ export type MessageBubbleData = {
 export type MessageBubble = {
     status: BubbleStatus;
     sender: MessageSender;
-    messageIdentifier?: MessageIdentifier;
+    messageIdentifier?: MessageIdentifier | string;
     id: string;
     types: QuestionType[];
     usageWhitelist?: PHService[];

package/dist/core/constants.d.ts

@@ -1,3 +1,4 @@
+import { AssessmentStatus } from '../api/types/messages';
 /** Streaming reveal cadence: ms per char-step (React passes 0 under prefers-reduced-motion). */
 export declare const STREAM_REVEAL_MS = 12;
 /** Chars revealed per reveal tick — bounds store writes to ~60/s at the default cadence. */
@@ -6,9 +7,26 @@ export declare const STREAM_CHARS_PER_TICK = 2;
 export declare const STREAM_BUBBLE_ID_PREFIX = "stream-live";
 export declare const QUESTION_TAG_PII_TYPE = "PII_TYPE";
 export declare const QUESTION_TAG_VIDEO_TYPE = "VIDEO_TYPE";
+export declare const QUESTION_TAG_PH_BUTTON_TYPE = "PH_BUTTON_TYPE";
+/** Question tag opting a single question out of the paste block. */
+export declare const QUESTION_TAG_ALLOW_PASTE = "ALLOW_PASTE";
+/** PH_BUTTON_TYPE value marking the SMS-consent prompt and its answer. */
+export declare const QUESTION_TAG_VALUE_SMS_CONSENT = "ph_sms_consent";
+/** Tag values are wire strings, not booleans; only the exact string counts as opt-in. */
+export declare const QUESTION_TAG_VALUE_TRUE = "true";
+/**
+ * Statuses the assessment reaches once the candidate has pressed the final submit. Every answer
+ * is final from that point, so the chat log drops its Edit affordances.
+ */
+export declare const SUBMITTED_ASSESSMENT_STATUSES: readonly AssessmentStatus[];
 /** Experience-rating slider range and starting position (legacy defaultSliderValue). */
 export declare const SLIDER_MIN = 1;
 export declare const SLIDER_MAX = 10;
 export declare const SLIDER_DEFAULT_VALUE = 8;
 /** Default video answer length when the question carries no max-seconds rule. */
 export declare const MAX_VIDEO_SECONDS_DEFAULT = 60;
+/**
+ * Answer text the backend reads as "the candidate skipped the optional feedback comment". Sending
+ * nothing is a valid answer there, so an empty composer submits this sentinel rather than ''.
+ */
+export declare const SKIP_FEEDBACK_COMMENT_TEXT = "SAPIA_SKIP_FEEDBACK";

package/dist/core/events.d.ts

@@ -12,8 +12,15 @@ export type ChatbotEventMap = {
     [CHATBOT_EVENTS.ASSESSMENT_STARTED]: {
         assessmentId: string;
     };
+    /**
+     * `justCompleted` is true only when the interview finished during this session — the legacy
+     * FI_ASSESSMENT_ENDED semantics (fired off a /next with no next question). It is false when the
+     * assessment was already over on load, or ended on a terminal message, where legacy stayed
+     * silent. A host acting on the end of an interview (an auto-redirect, analytics) must gate on it.
+     */
     [CHATBOT_EVENTS.ASSESSMENT_ENDED]: {
         assessmentId: string;
+        justCompleted: boolean;
     };
     [CHATBOT_EVENTS.ASSESSMENT_DUPLICATED]: {
         assessmentId: string;

package/dist/core/internalUser.d.ts

@@ -0,0 +1,13 @@
+/** Query params the widget honours on the hosting page. Mirrors legacy src/types/UrlParamKey.ts. */
+export declare enum UrlParamKey {
+    /** Legacy internal-tester flag; bypasses the paste block. */
+    INTERNAL_USER = "internalUser",
+    /** Sapia-staff flag; same bypass, kept separate so hosts can tell the two audiences apart. */
+    SAPIAN = "sapian"
+}
+/**
+ * Reads the internal-session flags off the host page URL. Either param unlocks paste, so a tester
+ * can re-enable it from the address bar without a host redeploy — the block is an integrity signal
+ * aimed at candidates, not a security boundary.
+ */
+export declare const isInternalUserFromUrl: () => boolean;

package/dist/core/interview.d.ts

@@ -12,6 +12,7 @@ export declare const ERROR_TYPE_VERIFY_ACCESS_FAILED = "FI_VERIFY_ACCESS_FAILED"
 export declare const ERROR_TYPE_DETECT_AGC_FAILED = "FI_DETECT_AGC_FAILED";
 export declare const LOG_TYPE_INVALID_PHONE_NUMBER = "INVALID_PHONE_NUMBER";
 export declare const LOG_TYPE_INVALID_PASTE_ANSWER_ACTION = "INVALID_PASTE_ANSWER_ACTION";
+export declare const LOG_TYPE_INVALID_REDIRECT_URL = "INVALID_REDIRECT_URL";
 /** Outcome of a validated PII submission (drives the UI error/confirm modals). */
 export declare enum PiiSubmitStatus {
     SUBMITTED = "submitted",
@@ -48,7 +49,8 @@ export declare class InterviewEngine {
     private readonly emitter;
     private readonly assessmentId;
     private readonly userAgent;
-    private readonly language;
+    /** Reassigned when /access-management names the assessment language before the gate. */
+    private language;
     private readonly welcomeGate;
     private readonly streamRevealMs;
     /** Aborts the in-flight stream when a new load starts. */
@@ -163,7 +165,9 @@ export declare class InterviewEngine {
     continueAfterAgcWarning(): Promise<void>;
     /** Dismiss the AGC warning to edit the answer (legacy "Edit"). */
     dismissAgcWarning(): void;
-    /** Emits the legacy INVALID_PASTE_ANSWER_ACTION log when paste is disallowed. */
+    /** Dismiss the edit-failure dialog; the composer reopens on the edit, so send retries it. */
+    dismissEditFailure(): void;
+    /** Emits the legacy INVALID_PASTE_ANSWER_ACTION log; fires only once a paste has been refused. */
     reportPaste(): void;
     /** Submit the experience-rating slider score (legacy handleSubmitRating). */
     submitSliderAnswer(score: number): Promise<void>;

package/dist/core/persistence.d.ts

@@ -2,3 +2,6 @@
 export declare const getVerifiedEmail: (assessmentId: string, now?: number) => string | undefined;
 /** Persist a verified email for the assessment with the 30-minute legacy TTL. */
 export declare const saveVerifiedEmail: (assessmentId: string, candidateEmail: string, now?: number) => void;
+/** Whether the candidate opted out of the below-minimum word-count warning for this assessment. */
+export declare const getSkipShortAnswerWarning: (assessmentId: string) => boolean;
+export declare const setSkipShortAnswerWarning: (assessmentId: string, skip: boolean) => void;

package/dist/core/redirect.d.ts

@@ -0,0 +1,2 @@
+/** Only absolute http(s) URLs are offered; anything else is host misconfiguration, not a link. */
+export declare const validRedirectUrl: (url?: string) => string | undefined;

package/dist/core/store.d.ts

@@ -12,7 +12,15 @@ export declare enum InterviewPhase {
     WELCOME = "welcome",
     ACTIVE = "active",
     ENDED = "ended",
-    FAILED = "failed"
+    FAILED = "failed",
+    /** The cohort behind this assessment is closed; the interview can never be taken. */
+    COHORT_CLOSED = "cohort-closed",
+    /**
+     * The backend ended the interview with an explanatory message (archived cohort / reused
+     * assessment) rather than a completion. Distinct from ENDED so the shell shows the message
+     * instead of the completion screen.
+     */
+    TERMINAL_MESSAGE = "terminal-message"
 }
 export type InterviewState = {
     phase: InterviewPhase;
@@ -53,12 +61,18 @@ export type InterviewState = {
     /** AGC (automated-content) detection attempt count + whether another check is allowed. */
     agcAttempt?: number;
     allowNextAgcDetection?: boolean;
+    /** Terms accepted for this assessment; locks PII and SMS-consent answers against re-editing. */
+    termsAccepted?: boolean;
     /** Show the AGC warning modal (automated content suspected on submit). */
     showAgcWarning?: boolean;
+    /** Question whose edited answer failed to save; drives the retry dialog. */
+    editFailedQuestionId?: string;
     /** Interview language (resolved); drives translations + text direction. */
     language?: string;
     /** Fetched translation file (flat key/value); undefined → bundled fallback only. */
     translations?: Record<string, string>;
+    /** Backend copy for TERMINAL_MESSAGE (archived cohort / reused assessment), as markdown. */
+    terminalMessage?: string;
     lastError?: {
         type: string;
         message: string;

package/dist/core/validation/wordCount.d.ts

@@ -0,0 +1 @@
+export declare const countWords: (text: string) => number;

package/dist/{dist-Bwlks_W8.js → dist-7zan-9V3.js}

@@ -1,5 +1,5 @@
-import { w as e } from "./messages-DCvBcspv.js";
-import { t } from "./react-DOgLiyZi.js";
+import { T as e } from "./messages-t5h3u6nr.js";
+import { t } from "./react-BtFG4mMU.js";
 import { t as n } from "./defineProperty-DiFpLzd2.js";
 import { n as r, t as i } from "./hls-mBncGwsE.js";
 import { a, i as o, n as s, r as c, t as l } from "./classPrivateFieldSet2-DtQPURVD.js";
@@ -14324,4 +14324,4 @@ var Kw = Object.prototype.hasOwnProperty, qw = (e, t) => {
 //#endregion
 export { Or as MaxResolution, C as MediaError, kr as MinResolution, Ar as RenditionOrder, rT as default, ha as generatePlayerInitTime, nT as playerSoftwareName, tT as playerSoftwareVersion };
 
-//# sourceMappingURL=dist-Bwlks_W8.js.map
+//# sourceMappingURL=dist-7zan-9V3.js.map

package/dist/embed/compat.d.ts

@@ -58,7 +58,7 @@ export type PHChatBotOptions = {
     jobRequisitionShortcode?: string;
     applicationShortcode?: string;
     showHeader?: boolean;
-    /** Accepted for source compatibility; the widget does not order assessments. */
+    /** Internal session (Sapia staff / QA): permits paste on every question. */
     isInternalUser?: boolean;
     apiOrigin?: string;
 };

package/dist/embed/createChatbot.d.ts

@@ -9,8 +9,12 @@ export type CreateChatbotOptions = {
     apiOrigin?: string;
     theme?: Theme;
     showHeader?: boolean;
+    /** Internal session (Sapia staff / QA): permits paste on every question. */
+    isInternalUser?: boolean;
     /** Interview language override (e.g. "fr"); defaults to the browser language. */
     language?: string;
+    /** Absolute http(s) URL offered as a "continue" CTA once the interview ends. */
+    redirectUrl?: string;
     /** Custom fetch (e.g. a mocked SSE stream for demos/tests). */
     fetchImpl?: typeof fetch;
 };

package/dist/{fix-webm-duration-QAy9T6AR.js → fix-webm-duration-CJ-IsmuV.js}

@@ -1,4 +1,4 @@
-import { S as e } from "./messages-DCvBcspv.js";
+import { C as e } from "./messages-t5h3u6nr.js";
 //#region ../../node_modules/.pnpm/fix-webm-duration@1.0.6/node_modules/fix-webm-duration/fix-webm-duration.js
 var t = /* @__PURE__ */ e(((e, t) => {
 	(function(e, n) {
@@ -1054,4 +1054,4 @@ var t = /* @__PURE__ */ e(((e, t) => {
 //#endregion
 export default t();
 
-//# sourceMappingURL=fix-webm-duration-QAy9T6AR.js.map
+//# sourceMappingURL=fix-webm-duration-CJ-IsmuV.js.map

package/dist/index.d.ts

@@ -2,5 +2,6 @@ export { createChatbot, type Chatbot, type CreateChatbotOptions } from './embed/
 export { DEFAULT_CONTAINER_ID } from './embed/constants';
 export { PHChatBot, PHChatBotCallbackFunction, CHATBOT_CONTAINER_ID, type PHChatBotCallback, type PHChatBotOptions, type PHChatBotTheme, } from './embed/compat';
 export { CHATBOT_EVENTS, type ChatbotEventName, type ChatbotEventMap, } from './core/events';
+export { validRedirectUrl } from './core/redirect';
 export type { Theme, ThemeSection } from './core/theme/types';
 export { ENVIRONMENTS, REGIONS, type Env, type Region } from './api/config';