@sapia-ai/chatbot-v3 1.0.0

package/dist/core/media/mimeTypes.d.ts

@@ -0,0 +1,10 @@
+/** Preferred recording mimeTypes, best first (vp8/opus webm, then mp4 for Safari). */
+export declare const VIDEO_MIME_CANDIDATES: readonly ["video/webm;codecs=vp8,opus", "video/webm;codecs=vp9,opus", "video/webm", "video/mp4"];
+export declare const AUDIO_MIME_CANDIDATES: readonly ["audio/webm;codecs=opus", "audio/webm", "audio/mp4"];
+export type MimeSupportCheck = (mimeType: string) => boolean;
+/** First supported candidate, or undefined to let the browser pick its default. */
+export declare const negotiateMimeType: (candidates: readonly string[], isSupported: MimeSupportCheck) => string | undefined;
+/** File extension for a recorded blob's mimeType (mp4 vs webm). */
+export declare const extensionForMimeType: (mimeType: string | undefined) => string;
+/** webm duration metadata needs the fix-webm-duration patch; mp4 does not. */
+export declare const needsWebmDurationFix: (mimeType: string | undefined) => boolean;

package/dist/core/media/recorder.d.ts

@@ -0,0 +1,61 @@
+import { MimeSupportCheck } from './mimeTypes';
+export type RecorderPhase = 'idle' | 'preview' | 'recording' | 'review' | 'error';
+export type RecorderState = {
+    phase: RecorderPhase;
+    /** Seconds elapsed in the current recording. */
+    elapsedSeconds: number;
+    /** Recorded result, available in the review phase. */
+    result?: {
+        blob: Blob;
+        extension: string;
+        durationSeconds: number;
+    };
+    error?: string;
+};
+export type RecorderMedia = 'video' | 'audio';
+export type RecorderDeps = {
+    /** Max recording length in seconds; auto-stops when reached. */
+    maxSeconds: number;
+    media?: RecorderMedia;
+    /** Resolves a camera/mic stream (navigator.mediaDevices.getUserMedia). */
+    getStream: (constraints: MediaStreamConstraints) => Promise<MediaStream>;
+    /** Constructs a MediaRecorder (injected for tests). */
+    createRecorder: (stream: MediaStream, options: MediaRecorderOptions) => MediaRecorder;
+    isTypeSupported: MimeSupportCheck;
+    /** Repairs webm duration metadata; defaults to fix-webm-duration (lazy). */
+    fixWebmDuration?: (blob: Blob, durationMs: number) => Promise<Blob>;
+    /** Wall-clock source (injected for deterministic tests). */
+    now?: () => number;
+    onChange?: (state: RecorderState) => void;
+};
+/** Legacy bitrates (App.tsx monkey-patch): 240p-ish video, 64 kbps audio. */
+export declare const VIDEO_BITS_PER_SECOND = 400000;
+export declare const AUDIO_BITS_PER_SECOND = 64000;
+export declare class MediaRecorderController {
+    private readonly deps;
+    private state;
+    private stream?;
+    private recorder?;
+    private chunks;
+    private mimeType?;
+    private startedAt;
+    private timer?;
+    private readonly media;
+    private readonly now;
+    private readonly fixWebmDuration;
+    constructor(deps: RecorderDeps);
+    getState(): RecorderState;
+    getStream(): MediaStream | undefined;
+    /** Request camera/mic and enter preview. */
+    openCamera(): Promise<void>;
+    startRecording(): void;
+    stopRecording(): void;
+    /** Discard the recording and return to preview to re-record. */
+    reset(): void;
+    /** Stop tracks and release the camera/mic. */
+    dispose(): void;
+    private tick;
+    private finalize;
+    private clearTimer;
+    private setState;
+}

package/dist/core/persistence.d.ts

@@ -0,0 +1,4 @@
+/** Returns a still-valid verified email for the assessment, or undefined. */
+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;

package/dist/core/store.d.ts

@@ -0,0 +1,49 @@
+import { StoreApi } from 'zustand/vanilla';
+import { AssessmentStatus } from '../api/types/messages';
+import { Branding } from '../api/types/branding';
+import { MessageBubble } from './bubbles/types';
+export type InterviewPhase = 'idle' | 'verifying' | 'access-required' | 'starting' | 'welcome' | 'active' | 'ended' | 'failed';
+export type InterviewState = {
+    phase: InterviewPhase;
+    assessmentStatus?: AssessmentStatus;
+    bubbles: MessageBubble[];
+    /** Agent typing animation visible. */
+    typing: boolean;
+    /** Id of the agent bubble currently streaming in (drives the live caret); undefined when idle. */
+    streamingBubbleId?: string;
+    /** An answer submission is in flight. */
+    sendingAnswer: boolean;
+    numOfNormalQuestion: number;
+    numOfNormalAnswer: number;
+    branding?: Branding;
+    /** Candidate display name for the welcome/done screens (optional; from /start/ats). */
+    candidateName?: string;
+    /** Role/position title for the welcome + header (optional; falls back to branding.title). */
+    roleTitle?: string;
+    /** Candidate's detected ISO country code; seeds the phone PII default. */
+    candidateCountryCode?: string;
+    /** Question whose previously-submitted answer is being re-edited (null = not editing). */
+    editingQuestionId?: string;
+    /** Masked email shown on the access-verification gate. */
+    emailHint?: string;
+    /** Whether to show "email does not match" on the access gate. */
+    accessEmailMismatch?: boolean;
+    /** Access verification request in flight. */
+    verifyingAccess?: boolean;
+    /** AGC (automated-content) detection attempt count + whether another check is allowed. */
+    agcAttempt?: number;
+    allowNextAgcDetection?: boolean;
+    /** Show the AGC warning modal (automated content suspected on submit). */
+    showAgcWarning?: boolean;
+    /** Interview language (resolved); drives translations + text direction. */
+    language?: string;
+    /** Fetched translation file (flat key/value); undefined → bundled fallback only. */
+    translations?: Record<string, string>;
+    lastError?: {
+        type: string;
+        message: string;
+    };
+};
+export type InterviewStore = StoreApi<InterviewState>;
+export declare const INITIAL_INTERVIEW_STATE: InterviewState;
+export declare const createInterviewStore: () => InterviewStore;

package/dist/core/theme/branding.d.ts

@@ -0,0 +1,6 @@
+import { Branding } from '../../api/types/branding';
+import { Theme } from './types';
+/** Converts the branding payload (theme array + font) into a Theme object. */
+export declare const brandingToTheme: (branding?: Branding) => Theme;
+/** Merge two themes; `override` (host setTheme) wins per field over `base` (branding). */
+export declare const mergeThemes: (base: Theme | undefined, override: Theme | undefined) => Theme;

package/dist/core/theme/cssVariables.d.ts

@@ -0,0 +1,16 @@
+import { Theme } from './types';
+export declare const CSS_VAR_HEADER_BG = "--sc-header-bg";
+export declare const CSS_VAR_HEADER_FG = "--sc-header-fg";
+export declare const CSS_VAR_QUESTION_BG = "--sc-question-bg";
+export declare const CSS_VAR_QUESTION_FG = "--sc-question-fg";
+export declare const CSS_VAR_RESPONSE_BG = "--sc-response-bg";
+export declare const CSS_VAR_RESPONSE_FG = "--sc-response-fg";
+export declare const CSS_VAR_BUTTON_BG = "--sc-button-bg";
+export declare const CSS_VAR_BUTTON_FG = "--sc-button-fg";
+export declare const CSS_VAR_FONT_FAMILY = "--sc-font-family";
+export type CssVariableMap = Record<string, string>;
+/**
+ * Converts a host/branding Theme into CSS custom properties applied on the
+ * widget root. Pure function — testable without DOM.
+ */
+export declare const themeToCssVariables: (theme: Theme | undefined) => CssVariableMap;

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

@@ -0,0 +1,11 @@
+export type ThemeSection = {
+    backgroundColor?: string;
+    fontColor?: string;
+};
+export type Theme = {
+    header?: ThemeSection;
+    question?: ThemeSection;
+    response?: ThemeSection;
+    button?: ThemeSection;
+    fontFamily?: string;
+};

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

@@ -0,0 +1,21 @@
+import { Region } from '../../api/config';
+export type PhoneCountry = {
+    /** ISO 3166-1 alpha-2, e.g. "AU". */
+    code: string;
+    /** Calling code without "+", e.g. "61". */
+    callingCode: string;
+    /** Localized display name, e.g. "Australia". */
+    name: string;
+    /** Flag emoji derived from the country code. */
+    flag: string;
+};
+/** Legacy REGION_AREA_MAP: default phone country per backend region. */
+export declare const DEFAULT_COUNTRY_BY_REGION: Record<Region, string>;
+export declare const DEFAULT_PHONE_COUNTRY = "AU";
+/** Loads libphonenumber metadata on demand and builds the sorted country list. */
+export declare const loadPhoneCountries: (locale?: string) => Promise<PhoneCountry[]>;
+/** Initial country: candidate's detected country, else the region default. */
+export declare const resolveDefaultPhoneCountry: ({ candidateCountryCode, region, }: {
+    candidateCountryCode?: string;
+    region?: Region;
+}) => string;

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

@@ -0,0 +1,30 @@
+import { PiiQuestionType } from '../../api/types/messages';
+import { ExtractHumanNameType } from '../../api/types/responses';
+export declare const PII_ERROR_KEYS: {
+    readonly email: "fi_error_piiEmail";
+    readonly fullName: "fi_error_piiFullName";
+    readonly firstName: "fi_error_piiFirstName";
+    readonly lastName: "fi_error_piiLastName";
+    readonly phoneNumber: "fi_error_piiPhoneNumber";
+};
+export type PiiErrorKey = (typeof PII_ERROR_KEYS)[keyof typeof PII_ERROR_KEYS];
+export type PiiValidationResult = {
+    ok: true;
+    text: string;
+} | {
+    ok: false;
+    errorKey: PiiErrorKey;
+    possiblePhoneNumber?: boolean;
+};
+export declare const EXTRACT_TYPE_BY_PII: Partial<Record<PiiQuestionType, ExtractHumanNameType>>;
+export declare const validateEmail: (text: string) => PiiValidationResult;
+export declare const validateName: (piiType: PiiQuestionType, text: string) => PiiValidationResult;
+/** True when the answer likely contains more than the asked-for name part. */
+export declare const needsNameExtraction: (piiType: PiiQuestionType, text: string) => boolean;
+/**
+ * Validates a national phone number against the selected country and
+ * normalizes to E.164 (legacy submits phoneNumber.number). `possiblePhoneNumber`
+ * mirrors the legacy INVALID_PHONE_NUMBER log trigger (possible but invalid).
+ */
+export declare const validatePhone: (text: string, countryCode: string) => Promise<PiiValidationResult>;
+export declare const isNamePiiType: (piiType?: PiiQuestionType) => boolean;