@firstflow/react 0.0.1 → 0.0.101

package/dist/events-DAiGBrYc.d.mts

@@ -0,0 +1,325 @@
+interface CreateFirstflowOptions {
+    agentId: string;
+    /** Optional Clerk API key used as `Authorization: Bearer ...` for protected SDK endpoints. */
+    apiKey?: string;
+    /** Optional identified user + traits used for audience targeting and analytics identify. */
+    user?: UserContext | null;
+    /** Auto-fetch audience membership map for identified users. Defaults to true. */
+    autoFetchAudienceMembership?: boolean;
+}
+interface UserContext {
+    /** Stable app-specific identifier (required for identified users). */
+    id: string;
+    /** Optional top-level identity fields. */
+    email?: string;
+    name?: string;
+    /** Arbitrary user attributes used in audience rules (e.g. plan, role, company). */
+    traits?: Record<string, unknown>;
+}
+/**
+ * Segment membership lookup map keyed by segment_id.
+ * Missing keys always evaluate to false in runtime eligibility checks.
+ */
+type AudienceMembershipMap = Record<string, boolean>;
+/**
+ * Public API for the issue module only (open, submit, getConfig, destroy).
+ * Internal wiring (setConfig, setOpenHandler) is not exposed.
+ */
+interface IssueModulePublic {
+    open(options?: OpenOptions): void;
+    submit(data: IssueReportData): Promise<void>;
+    getConfig(): NormalizedConfig;
+    destroy(): void;
+}
+/** Analytics API exposed on the platform instance. Used by all feature modules. */
+interface AnalyticsModulePublic {
+    track(eventName: string, properties?: Record<string, unknown>): void;
+    identify(userId?: string, traits?: Record<string, unknown>): void;
+    page(name?: string, properties?: Record<string, unknown>): void;
+}
+/**
+ * Root platform instance: agent identity, analytics, and feature modules.
+ * Represents the runtime context for this agent at this API.
+ */
+/** Subset of agent widget branding merged from public config (`widget_ui` / `primary_color`). */
+type FirstflowWidgetUi = Readonly<{
+    primaryColor?: string;
+}>;
+interface FirstflowInstance {
+    readonly agentId: string;
+    /** Fixed public API base URL used for config, audience, and overrides (see `FIRSTFLOW_PUBLIC_API_BASE_URL`). */
+    readonly apiUrl: string;
+    /**
+     * Brand color hints for embedded UI (e.g. announcement primary buttons).
+     * Populated from agent config when the API returns `widget_ui` or `primary_color`.
+     */
+    getWidgetUi(): FirstflowWidgetUi | null;
+    analytics: AnalyticsModulePublic;
+    issue: IssueModulePublic;
+    feedback: FeedbackModulePublic;
+    survey: SurveyModulePublic;
+    getUser(): UserContext | null;
+    setUser(user: UserContext | null): void;
+    /**
+     * Merge segment membership values into runtime state.
+     * Only `true` grants membership; missing IDs or non-true values are treated as not a member.
+     */
+    setAudienceMembership(map: AudienceMembershipMap): void;
+    getAudienceMembership(): AudienceMembershipMap;
+    refreshConfig(): Promise<void>;
+    reset(): void;
+}
+/**
+ * Raw issues config as received from API (e.g. agent.issues_config).
+ */
+interface RawIssueFieldConfig {
+    id?: string;
+    allowed?: boolean;
+    label?: string;
+    type?: "text" | "textarea" | "select";
+    required?: boolean;
+    options?: string[];
+}
+interface RawIssuesConfig {
+    enabled?: boolean;
+    title?: string;
+    triggerLabel?: string;
+    submitLabel?: string;
+    cancelLabel?: string;
+    cancelEnabled?: boolean;
+    promptText?: string;
+    fields?: RawIssueFieldConfig[];
+}
+interface RawFeedbackFormConfig {
+    tags?: string[];
+    placeholder?: string;
+    showTags?: boolean;
+    showComment?: boolean;
+    /** Message shown to the user after they submit feedback (or immediately when no form is shown). */
+    confirmationMessage?: string;
+}
+interface RawFeedbackConfig {
+    enabled?: boolean;
+    like?: RawFeedbackFormConfig;
+    dislike?: RawFeedbackFormConfig;
+}
+interface NormalizedFeedbackFormConfig {
+    tags: string[];
+    placeholder: string;
+    showTags: boolean;
+    showComment: boolean;
+    /** Message shown after feedback is given. */
+    confirmationMessage: string;
+}
+interface NormalizedFeedbackConfig {
+    enabled: boolean;
+    like: NormalizedFeedbackFormConfig;
+    dislike: NormalizedFeedbackFormConfig;
+}
+interface MessageFeedbackSubmitPayload {
+    conversationId: string;
+    messageId: string;
+    rating: "like" | "dislike";
+    /** Used by MessageFeedback UI only; not sent as analytics event fields. */
+    tags?: string[];
+    comment?: string;
+    /** Mirrors config: whether tags/comment were enabled for this sentiment at submit time. */
+    showTags?: boolean;
+    showComment?: boolean;
+    messagePreview?: string;
+    /**
+     * Arbitrary JSON-serializable key/value bag (e.g. locale, page_url, model, experiment_id).
+     * Sent on the analytics payload as property `metadata` after JSON round-trip (max ~32KB serialized).
+     */
+    metadata?: Record<string, unknown>;
+}
+interface FeedbackModulePublic {
+    submit(payload: MessageFeedbackSubmitPayload): Promise<void>;
+    getConfig(): NormalizedFeedbackConfig;
+    isEnabled(): boolean;
+}
+type SurveyQuestionType = 'nps' | 'multiple_choice' | 'slider' | 'opinion_scale' | 'open_question' | 'concept_test' | 'interview_prompt' | 'text_block' | 'thank_you';
+type SurveyScaleType = 'numbers' | 'stars' | 'emojis';
+type SurveyAnswerValue = string | number | string[] | null;
+interface SurveyQuestion {
+    id: string;
+    nodeId: string;
+    type: SurveyQuestionType;
+    questionText: string;
+    required: boolean;
+    options?: string[];
+    minValue?: number;
+    maxValue?: number;
+    minLabel?: string;
+    maxLabel?: string;
+    step?: number;
+    scaleType?: SurveyScaleType;
+    placeholder?: string;
+    multiline?: boolean;
+    /** thank_you: confetti when true or unset; set false to disable. */
+    showConfetti?: boolean;
+}
+interface SurveyExperience {
+    experienceId: string;
+    name?: string | null;
+    status?: string | null;
+    settings?: ExperienceSettings | null;
+    questions: SurveyQuestion[];
+}
+type ExperienceSettings = {
+    trigger: {
+        show_on: 'chat_opens' | 'after_user_message' | 'after_idle' | 'custom_event';
+        custom_event_name?: string;
+        /** Idle delay in seconds (when show_on is "after_idle"). 0-300. */
+        delay_seconds?: number;
+    };
+    device: 'all' | 'desktop' | 'mobile';
+    audience: AudienceConfig;
+    schedule: {
+        start_type: 'now' | 'scheduled';
+        starts_at?: string;
+        timezone?: string;
+        expiration_type: 'none' | 'scheduled';
+        expires_at?: string;
+    };
+    frequency: {
+        type: 'once' | 'limited' | 'always';
+        limit?: number;
+        period?: 'session' | 'day' | 'week' | 'lifetime';
+    };
+    priority: number;
+};
+type RuleOperator = 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'exists' | 'not_exists';
+interface AudienceRule {
+    trait: string;
+    operator: RuleOperator;
+    value?: unknown;
+}
+type AudienceConfig = {
+    type: 'all';
+} | {
+    type: 'segment';
+    segment_id?: string;
+} | {
+    type: 'rules';
+    operator: 'AND' | 'OR';
+    rules: AudienceRule[];
+};
+interface SurveySubmitPayload {
+    experienceId: string;
+    conversationId?: string;
+    answers: Record<string, SurveyAnswerValue>;
+    metadata?: Record<string, unknown>;
+}
+interface SurveyModulePublic {
+    getSurveys(): SurveyExperience[];
+    getSurvey(experienceId: string): SurveyExperience | null;
+    setExperiences(experiences: unknown[] | null | undefined): void;
+    isEnabled(experienceId?: string): boolean;
+    submit(payload: SurveySubmitPayload): Promise<void>;
+}
+/**
+ * Normalized field config used internally (after filtering allowed, defaulting type/label).
+ */
+interface NormalizedFieldConfig {
+    id: string;
+    type: "text" | "textarea" | "select";
+    label: string;
+    required: boolean;
+    options?: string[];
+}
+/**
+ * Normalized config: single source of truth for the SDK.
+ */
+interface NormalizedConfig {
+    agentId: string;
+    apiUrl: string;
+    enabled: boolean;
+    title: string;
+    triggerLabel: string;
+    submitLabel: string;
+    cancelLabel: string;
+    cancelEnabled: boolean;
+    promptText: string;
+    fields: NormalizedFieldConfig[];
+}
+/**
+ * Form field values only (keys = field ids). Validated before submit.
+ * Validation applies to this only.
+ */
+type IssueFormValues = Record<string, string | undefined>;
+/**
+ * Context metadata: set programmatically (e.g. open({ messageId })). Never validated.
+ * Merged with form values at submit time. Users can add arbitrary JSON-serializable keys/values.
+ */
+type IssueContextMetadata = {
+    conversationId?: string;
+    messageId?: string;
+    sessionId?: string;
+    agentId?: string;
+    model?: string;
+} & Record<string, unknown>;
+/**
+ * Options passed to open() (e.g. "Report this response").
+ */
+type OpenOptions = IssueContextMetadata;
+/**
+ * Final submission payload: form values + context metadata. Sent to transport.
+ * Values can be primitives (form fields) or arbitrary JSON-serializable metadata.
+ */
+type IssuePayload = Record<string, unknown>;
+/**
+ * Options for createIssueReporter. Config is optional; when omitted, defaults are used.
+ * When analytics is omitted, a default analytics instance is created (same default collector settings).
+ */
+interface CreateIssueReporterOptions {
+    agentId: string;
+    apiUrl: string;
+    config?: Partial<RawIssuesConfig>;
+    /** Platform analytics; issue module calls analytics.track('issue_submitted', payload). Defaults to createAnalytics({ agentId }) when omitted. */
+    analytics?: AnalyticsModulePublic;
+}
+/**
+ * Validation result.
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors?: Record<string, string>;
+}
+type IssueReportData = Record<string, unknown>;
+/**
+ * Instance returned by createIssueReporter.
+ * setConfig is used internally when config is loaded asynchronously.
+ */
+interface IssueReporterInstance {
+    getConfig(): NormalizedConfig;
+    setConfig(config: NormalizedConfig): void;
+    reportIssue(data: IssueReportData): Promise<void>;
+    open(options?: OpenOptions): void;
+    setOpenHandler(handler: ((options?: OpenOptions) => void) | undefined): void;
+    destroy(): void;
+}
+
+/**
+ * Platform event names. Feature modules use these when calling analytics.track().
+ * Do not rename existing events (e.g. issue_submitted) to avoid breaking pipelines.
+ */
+/** Issue module — backward compatible */
+declare const ISSUE_SUBMITTED = "issue_submitted";
+/** Future modules */
+declare const FEEDBACK_SUBMITTED = "feedback_submitted";
+declare const SURVEY_COMPLETED = "survey_completed";
+declare const EXPERIENCE_SHOWN = "experience_shown";
+declare const EXPERIENCE_CLICKED = "experience_clicked";
+declare const CHAT_MESSAGE_SENT = "chat_message_sent";
+/**
+ * `experience_type` on `experience_shown` / `experience_clicked` — stable for ClickHouse / dashboards.
+ * Surfaces which product surface fired the event alongside `experience_id` / `node_id`.
+ */
+declare const EXPERIENCE_ANALYTICS_TYPE: {
+    readonly FLOW_MESSAGE: "flow_message";
+    readonly FLOW_ANNOUNCEMENT: "flow_announcement";
+    readonly SURVEY: "survey";
+};
+
+export { type AudienceMembershipMap as A, ISSUE_SUBMITTED as B, type CreateFirstflowOptions as C, type IssueModulePublic as D, type ExperienceSettings as E, type FirstflowInstance as F, type IssueFormValues as I, type MessageFeedbackSubmitPayload as M, type NormalizedFeedbackConfig as N, type OpenOptions as O, type RawIssuesConfig as R, type SurveySubmitPayload as S, type UserContext as U, type ValidationResult as V, type RawFeedbackConfig as a, type SurveyQuestion as b, type SurveyAnswerValue as c, type SurveyModulePublic as d, type AnalyticsModulePublic as e, type AudienceConfig as f, type AudienceRule as g, CHAT_MESSAGE_SENT as h, EXPERIENCE_ANALYTICS_TYPE as i, EXPERIENCE_CLICKED as j, EXPERIENCE_SHOWN as k, type FirstflowWidgetUi as l, type RuleOperator as m, SURVEY_COMPLETED as n, type SurveyExperience as o, type NormalizedFeedbackFormConfig as p, type FeedbackModulePublic as q, type NormalizedConfig as r, type NormalizedFieldConfig as s, type IssueContextMetadata as t, type IssuePayload as u, type RawIssueFieldConfig as v, type IssueReporterInstance as w, type IssueReportData as x, type CreateIssueReporterOptions as y, FEEDBACK_SUBMITTED as z };

package/dist/events-DAiGBrYc.d.ts

@@ -0,0 +1,325 @@
+interface CreateFirstflowOptions {
+    agentId: string;
+    /** Optional Clerk API key used as `Authorization: Bearer ...` for protected SDK endpoints. */
+    apiKey?: string;
+    /** Optional identified user + traits used for audience targeting and analytics identify. */
+    user?: UserContext | null;
+    /** Auto-fetch audience membership map for identified users. Defaults to true. */
+    autoFetchAudienceMembership?: boolean;
+}
+interface UserContext {
+    /** Stable app-specific identifier (required for identified users). */
+    id: string;
+    /** Optional top-level identity fields. */
+    email?: string;
+    name?: string;
+    /** Arbitrary user attributes used in audience rules (e.g. plan, role, company). */
+    traits?: Record<string, unknown>;
+}
+/**
+ * Segment membership lookup map keyed by segment_id.
+ * Missing keys always evaluate to false in runtime eligibility checks.
+ */
+type AudienceMembershipMap = Record<string, boolean>;
+/**
+ * Public API for the issue module only (open, submit, getConfig, destroy).
+ * Internal wiring (setConfig, setOpenHandler) is not exposed.
+ */
+interface IssueModulePublic {
+    open(options?: OpenOptions): void;
+    submit(data: IssueReportData): Promise<void>;
+    getConfig(): NormalizedConfig;
+    destroy(): void;
+}
+/** Analytics API exposed on the platform instance. Used by all feature modules. */
+interface AnalyticsModulePublic {
+    track(eventName: string, properties?: Record<string, unknown>): void;
+    identify(userId?: string, traits?: Record<string, unknown>): void;
+    page(name?: string, properties?: Record<string, unknown>): void;
+}
+/**
+ * Root platform instance: agent identity, analytics, and feature modules.
+ * Represents the runtime context for this agent at this API.
+ */
+/** Subset of agent widget branding merged from public config (`widget_ui` / `primary_color`). */
+type FirstflowWidgetUi = Readonly<{
+    primaryColor?: string;
+}>;
+interface FirstflowInstance {
+    readonly agentId: string;
+    /** Fixed public API base URL used for config, audience, and overrides (see `FIRSTFLOW_PUBLIC_API_BASE_URL`). */
+    readonly apiUrl: string;
+    /**
+     * Brand color hints for embedded UI (e.g. announcement primary buttons).
+     * Populated from agent config when the API returns `widget_ui` or `primary_color`.
+     */
+    getWidgetUi(): FirstflowWidgetUi | null;
+    analytics: AnalyticsModulePublic;
+    issue: IssueModulePublic;
+    feedback: FeedbackModulePublic;
+    survey: SurveyModulePublic;
+    getUser(): UserContext | null;
+    setUser(user: UserContext | null): void;
+    /**
+     * Merge segment membership values into runtime state.
+     * Only `true` grants membership; missing IDs or non-true values are treated as not a member.
+     */
+    setAudienceMembership(map: AudienceMembershipMap): void;
+    getAudienceMembership(): AudienceMembershipMap;
+    refreshConfig(): Promise<void>;
+    reset(): void;
+}
+/**
+ * Raw issues config as received from API (e.g. agent.issues_config).
+ */
+interface RawIssueFieldConfig {
+    id?: string;
+    allowed?: boolean;
+    label?: string;
+    type?: "text" | "textarea" | "select";
+    required?: boolean;
+    options?: string[];
+}
+interface RawIssuesConfig {
+    enabled?: boolean;
+    title?: string;
+    triggerLabel?: string;
+    submitLabel?: string;
+    cancelLabel?: string;
+    cancelEnabled?: boolean;
+    promptText?: string;
+    fields?: RawIssueFieldConfig[];
+}
+interface RawFeedbackFormConfig {
+    tags?: string[];
+    placeholder?: string;
+    showTags?: boolean;
+    showComment?: boolean;
+    /** Message shown to the user after they submit feedback (or immediately when no form is shown). */
+    confirmationMessage?: string;
+}
+interface RawFeedbackConfig {
+    enabled?: boolean;
+    like?: RawFeedbackFormConfig;
+    dislike?: RawFeedbackFormConfig;
+}
+interface NormalizedFeedbackFormConfig {
+    tags: string[];
+    placeholder: string;
+    showTags: boolean;
+    showComment: boolean;
+    /** Message shown after feedback is given. */
+    confirmationMessage: string;
+}
+interface NormalizedFeedbackConfig {
+    enabled: boolean;
+    like: NormalizedFeedbackFormConfig;
+    dislike: NormalizedFeedbackFormConfig;
+}
+interface MessageFeedbackSubmitPayload {
+    conversationId: string;
+    messageId: string;
+    rating: "like" | "dislike";
+    /** Used by MessageFeedback UI only; not sent as analytics event fields. */
+    tags?: string[];
+    comment?: string;
+    /** Mirrors config: whether tags/comment were enabled for this sentiment at submit time. */
+    showTags?: boolean;
+    showComment?: boolean;
+    messagePreview?: string;
+    /**
+     * Arbitrary JSON-serializable key/value bag (e.g. locale, page_url, model, experiment_id).
+     * Sent on the analytics payload as property `metadata` after JSON round-trip (max ~32KB serialized).
+     */
+    metadata?: Record<string, unknown>;
+}
+interface FeedbackModulePublic {
+    submit(payload: MessageFeedbackSubmitPayload): Promise<void>;
+    getConfig(): NormalizedFeedbackConfig;
+    isEnabled(): boolean;
+}
+type SurveyQuestionType = 'nps' | 'multiple_choice' | 'slider' | 'opinion_scale' | 'open_question' | 'concept_test' | 'interview_prompt' | 'text_block' | 'thank_you';
+type SurveyScaleType = 'numbers' | 'stars' | 'emojis';
+type SurveyAnswerValue = string | number | string[] | null;
+interface SurveyQuestion {
+    id: string;
+    nodeId: string;
+    type: SurveyQuestionType;
+    questionText: string;
+    required: boolean;
+    options?: string[];
+    minValue?: number;
+    maxValue?: number;
+    minLabel?: string;
+    maxLabel?: string;
+    step?: number;
+    scaleType?: SurveyScaleType;
+    placeholder?: string;
+    multiline?: boolean;
+    /** thank_you: confetti when true or unset; set false to disable. */
+    showConfetti?: boolean;
+}
+interface SurveyExperience {
+    experienceId: string;
+    name?: string | null;
+    status?: string | null;
+    settings?: ExperienceSettings | null;
+    questions: SurveyQuestion[];
+}
+type ExperienceSettings = {
+    trigger: {
+        show_on: 'chat_opens' | 'after_user_message' | 'after_idle' | 'custom_event';
+        custom_event_name?: string;
+        /** Idle delay in seconds (when show_on is "after_idle"). 0-300. */
+        delay_seconds?: number;
+    };
+    device: 'all' | 'desktop' | 'mobile';
+    audience: AudienceConfig;
+    schedule: {
+        start_type: 'now' | 'scheduled';
+        starts_at?: string;
+        timezone?: string;
+        expiration_type: 'none' | 'scheduled';
+        expires_at?: string;
+    };
+    frequency: {
+        type: 'once' | 'limited' | 'always';
+        limit?: number;
+        period?: 'session' | 'day' | 'week' | 'lifetime';
+    };
+    priority: number;
+};
+type RuleOperator = 'equals' | 'not_equals' | 'contains' | 'not_contains' | 'in' | 'not_in' | 'gt' | 'gte' | 'lt' | 'lte' | 'exists' | 'not_exists';
+interface AudienceRule {
+    trait: string;
+    operator: RuleOperator;
+    value?: unknown;
+}
+type AudienceConfig = {
+    type: 'all';
+} | {
+    type: 'segment';
+    segment_id?: string;
+} | {
+    type: 'rules';
+    operator: 'AND' | 'OR';
+    rules: AudienceRule[];
+};
+interface SurveySubmitPayload {
+    experienceId: string;
+    conversationId?: string;
+    answers: Record<string, SurveyAnswerValue>;
+    metadata?: Record<string, unknown>;
+}
+interface SurveyModulePublic {
+    getSurveys(): SurveyExperience[];
+    getSurvey(experienceId: string): SurveyExperience | null;
+    setExperiences(experiences: unknown[] | null | undefined): void;
+    isEnabled(experienceId?: string): boolean;
+    submit(payload: SurveySubmitPayload): Promise<void>;
+}
+/**
+ * Normalized field config used internally (after filtering allowed, defaulting type/label).
+ */
+interface NormalizedFieldConfig {
+    id: string;
+    type: "text" | "textarea" | "select";
+    label: string;
+    required: boolean;
+    options?: string[];
+}
+/**
+ * Normalized config: single source of truth for the SDK.
+ */
+interface NormalizedConfig {
+    agentId: string;
+    apiUrl: string;
+    enabled: boolean;
+    title: string;
+    triggerLabel: string;
+    submitLabel: string;
+    cancelLabel: string;
+    cancelEnabled: boolean;
+    promptText: string;
+    fields: NormalizedFieldConfig[];
+}
+/**
+ * Form field values only (keys = field ids). Validated before submit.
+ * Validation applies to this only.
+ */
+type IssueFormValues = Record<string, string | undefined>;
+/**
+ * Context metadata: set programmatically (e.g. open({ messageId })). Never validated.
+ * Merged with form values at submit time. Users can add arbitrary JSON-serializable keys/values.
+ */
+type IssueContextMetadata = {
+    conversationId?: string;
+    messageId?: string;
+    sessionId?: string;
+    agentId?: string;
+    model?: string;
+} & Record<string, unknown>;
+/**
+ * Options passed to open() (e.g. "Report this response").
+ */
+type OpenOptions = IssueContextMetadata;
+/**
+ * Final submission payload: form values + context metadata. Sent to transport.
+ * Values can be primitives (form fields) or arbitrary JSON-serializable metadata.
+ */
+type IssuePayload = Record<string, unknown>;
+/**
+ * Options for createIssueReporter. Config is optional; when omitted, defaults are used.
+ * When analytics is omitted, a default analytics instance is created (same default collector settings).
+ */
+interface CreateIssueReporterOptions {
+    agentId: string;
+    apiUrl: string;
+    config?: Partial<RawIssuesConfig>;
+    /** Platform analytics; issue module calls analytics.track('issue_submitted', payload). Defaults to createAnalytics({ agentId }) when omitted. */
+    analytics?: AnalyticsModulePublic;
+}
+/**
+ * Validation result.
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors?: Record<string, string>;
+}
+type IssueReportData = Record<string, unknown>;
+/**
+ * Instance returned by createIssueReporter.
+ * setConfig is used internally when config is loaded asynchronously.
+ */
+interface IssueReporterInstance {
+    getConfig(): NormalizedConfig;
+    setConfig(config: NormalizedConfig): void;
+    reportIssue(data: IssueReportData): Promise<void>;
+    open(options?: OpenOptions): void;
+    setOpenHandler(handler: ((options?: OpenOptions) => void) | undefined): void;
+    destroy(): void;
+}
+
+/**
+ * Platform event names. Feature modules use these when calling analytics.track().
+ * Do not rename existing events (e.g. issue_submitted) to avoid breaking pipelines.
+ */
+/** Issue module — backward compatible */
+declare const ISSUE_SUBMITTED = "issue_submitted";
+/** Future modules */
+declare const FEEDBACK_SUBMITTED = "feedback_submitted";
+declare const SURVEY_COMPLETED = "survey_completed";
+declare const EXPERIENCE_SHOWN = "experience_shown";
+declare const EXPERIENCE_CLICKED = "experience_clicked";
+declare const CHAT_MESSAGE_SENT = "chat_message_sent";
+/**
+ * `experience_type` on `experience_shown` / `experience_clicked` — stable for ClickHouse / dashboards.
+ * Surfaces which product surface fired the event alongside `experience_id` / `node_id`.
+ */
+declare const EXPERIENCE_ANALYTICS_TYPE: {
+    readonly FLOW_MESSAGE: "flow_message";
+    readonly FLOW_ANNOUNCEMENT: "flow_announcement";
+    readonly SURVEY: "survey";
+};
+
+export { type AudienceMembershipMap as A, ISSUE_SUBMITTED as B, type CreateFirstflowOptions as C, type IssueModulePublic as D, type ExperienceSettings as E, type FirstflowInstance as F, type IssueFormValues as I, type MessageFeedbackSubmitPayload as M, type NormalizedFeedbackConfig as N, type OpenOptions as O, type RawIssuesConfig as R, type SurveySubmitPayload as S, type UserContext as U, type ValidationResult as V, type RawFeedbackConfig as a, type SurveyQuestion as b, type SurveyAnswerValue as c, type SurveyModulePublic as d, type AnalyticsModulePublic as e, type AudienceConfig as f, type AudienceRule as g, CHAT_MESSAGE_SENT as h, EXPERIENCE_ANALYTICS_TYPE as i, EXPERIENCE_CLICKED as j, EXPERIENCE_SHOWN as k, type FirstflowWidgetUi as l, type RuleOperator as m, SURVEY_COMPLETED as n, type SurveyExperience as o, type NormalizedFeedbackFormConfig as p, type FeedbackModulePublic as q, type NormalizedConfig as r, type NormalizedFieldConfig as s, type IssueContextMetadata as t, type IssuePayload as u, type RawIssueFieldConfig as v, type IssueReporterInstance as w, type IssueReportData as x, type CreateIssueReporterOptions as y, FEEDBACK_SUBMITTED as z };