@searchia-widget-test/widget 0.0.0-stage → 0.1.0-test.0

package/dist/index.d.cts

@@ -0,0 +1,397 @@
+//#region src/searchia/algolia-adapter.d.ts
+interface AlgoliaChatConfig {
+  applicationId: string;
+  /** Public, restricted search/agent key only. Never use an admin key. */
+  apiKey: string;
+  indexName: string;
+  assistantId: string;
+  agentStudio?: boolean;
+  askaiBaseUrl?: string;
+  agentStudioBaseUrl?: string;
+}
+/** Keeps Algolia's full AI SDK message parts and conversation IDs outside the UI. */
+declare class AlgoliaChatAdapter implements SearchiaChatAdapter {
+  private readonly config;
+  readonly name = "AlgoliaChatAdapter";
+  readonly isMock = false;
+  private chat;
+  private token;
+  private tokenExpiresAt;
+  private tokenRequest;
+  private feedbackIds;
+  private readonly askaiUrl;
+  private readonly agentUrl;
+  constructor(config: AlgoliaChatConfig);
+  private getToken;
+  private headers;
+  resetConversation(): void;
+  sendMessage(options: SendMessageOptions): Promise<string>;
+  getSuggestedQuestions(): Promise<SuggestedQuestionItem[]>;
+  sendFeedback(messageId: string, vote: 0 | 1): Promise<void>;
+}
+//#endregion
+//#region src/searchia/completion-adapter.d.ts
+interface SearchiaAgentConfiguration {
+  id: string;
+  tools: Record<string, unknown>[];
+  name?: string;
+  status?: string;
+  providerId?: string | null;
+  model?: string | null;
+  instructions?: string;
+  systemPrompt?: string | null;
+  config?: Record<string, unknown>;
+  [key: string]: unknown;
+}
+interface SearchiaApiConfig {
+  endpoint?: string;
+  apiKey?: string;
+  configuration?: SearchiaAgentConfiguration | (() => SearchiaAgentConfiguration | Promise<SearchiaAgentConfiguration>);
+}
+declare class SearchiaApiAdapter implements SearchiaChatAdapter {
+  private readonly config;
+  readonly name = "SearchiaApiAdapter";
+  readonly isMock = false;
+  private conversationId;
+  private active;
+  constructor(config?: SearchiaApiConfig);
+  resetConversation(): void;
+  sendMessage(options: SendMessageOptions): Promise<string>;
+}
+//#endregion
+//#region src/searchia/i18n.d.ts
+/** Centralized customer-facing copy. Custom configuration strings remain caller-owned. */
+declare const translations: {
+  readonly en: {
+    readonly searching: "Searching...";
+    readonly results: "Results";
+    readonly toolError: "Tool failed";
+    readonly toolComplete: "Tool completed";
+    readonly toolDetails: "Tool details (JSON)";
+    readonly toolInput: "Input";
+    readonly toolOutput: "Output";
+    readonly currency: "Toman";
+    readonly discount: "discount";
+    readonly searchPlaceholder: "Ask a question about Searchia...";
+    readonly searchLabel: "Ask the AI assistant";
+    readonly searchSubmit: "Ask AI";
+    readonly suggestedLabel: "Suggested prompts";
+    readonly button: "Ask Searchia";
+    readonly title: "Searchia AI";
+    readonly placeholder: "Ask Searchia anything...";
+    readonly answering: "Answering...";
+    readonly newChat: "New conversation";
+    readonly close: "Close";
+    readonly back: "Back to page";
+    readonly clear: "Clear";
+    readonly send: "Send message";
+    readonly language: "Change language";
+    readonly mock: "Demo";
+    readonly mockTitle: "Using simulated responses";
+    readonly disclaimer: "AI-generated answers may contain mistakes.";
+    readonly poweredBy: "Powered by";
+    readonly welcomeTitle: "How can I help you today?";
+    readonly welcomeSubtitle: "Ask a question to start a conversation with Searchia.";
+    readonly thinking: "Thinking...";
+    readonly reasoning: "Reasoning...";
+    readonly feedbackThanks: "Thanks for your feedback!";
+    readonly submitting: "Submitting...";
+    readonly like: "Helpful answer";
+    readonly dislike: "Unhelpful answer";
+    readonly copied: "Copied";
+    readonly copyAnswer: "Copy answer";
+    readonly copyCode: "Copy code";
+    readonly copy: "Copy";
+    readonly error: "Unable to answer. Please try again.";
+    readonly feedbackError: "Could not send feedback. Please try again.";
+    readonly copyError: "Could not copy. Please try again.";
+  };
+  readonly fa: {
+    readonly searching: "در حال جست‌وجو...";
+    readonly results: "نتایج";
+    readonly toolError: "اجرای ابزار ناموفق بود";
+    readonly toolComplete: "اجرای ابزار کامل شد";
+    readonly toolDetails: "جزئیات ابزار (JSON)";
+    readonly toolInput: "ورودی";
+    readonly toolOutput: "خروجی";
+    readonly currency: "تومان";
+    readonly discount: "تخفیف";
+    readonly searchPlaceholder: "دربارهٔ سرچیا سؤال بپرسید...";
+    readonly searchLabel: "پرسش از دستیار هوشمند";
+    readonly searchSubmit: "پرسش از AI";
+    readonly suggestedLabel: "پیشنهادهای پرسش";
+    readonly button: "پرسش از هوش مصنوعی";
+    readonly title: "دستیار هوشمند سرچیا";
+    readonly placeholder: "سؤال خود را از سرچیا بپرسید...";
+    readonly answering: "در حال پاسخ‌گویی...";
+    readonly newChat: "گفت‌وگوی جدید";
+    readonly close: "بستن";
+    readonly back: "بازگشت به صفحه";
+    readonly clear: "پاک کردن";
+    readonly send: "ارسال پیام";
+    readonly language: "تغییر زبان";
+    readonly mock: "نمایشی";
+    readonly mockTitle: "پاسخ‌ها شبیه‌سازی شده‌اند";
+    readonly disclaimer: "پاسخ‌های هوش مصنوعی ممکن است اشتباه باشند.";
+    readonly poweredBy: "با پشتیبانی";
+    readonly welcomeTitle: "چطور می‌توانم به شما کمک کنم؟";
+    readonly welcomeSubtitle: "برای شروع گفت‌وگو با سرچیا، سؤال خود را بپرسید.";
+    readonly thinking: "در حال فکر کردن...";
+    readonly reasoning: "در حال بررسی...";
+    readonly feedbackThanks: "از بازخورد شما سپاسگزاریم!";
+    readonly submitting: "در حال ارسال...";
+    readonly like: "پاسخ مفید بود";
+    readonly dislike: "پاسخ مفید نبود";
+    readonly copied: "کپی شد";
+    readonly copyAnswer: "کپی پاسخ";
+    readonly copyCode: "کپی کد";
+    readonly copy: "کپی";
+    readonly error: "دریافت پاسخ ممکن نشد. دوباره تلاش کنید.";
+    readonly feedbackError: "ارسال بازخورد ممکن نشد. دوباره تلاش کنید.";
+    readonly copyError: "کپی ممکن نشد. دوباره تلاش کنید.";
+  };
+};
+type SearchiaLanguage = keyof typeof translations;
+/** Copy for the single vanilla showcase; all page language changes use this dictionary. */
+declare const showcaseTranslations: {
+  readonly fa: {
+    readonly documentTitle: "سرچیا | تجربه‌های هوشمند";
+    readonly brand: "سرچیا";
+    readonly subtitle: "تجربه‌های هوشمند برای وب‌سایت شما";
+    readonly reference: "نمونه‌های مرجع Algolia";
+    readonly language: "زبان نمایش";
+    readonly eyebrow: "تجربه‌های تعبیه‌پذیر سرچیا";
+    readonly heading: "از یک سؤال، به یک گفت‌وگو برسید.";
+    readonly intro: "دو حالت پرسش هوشمند و چت‌بات را امتحان کنید؛ هر دو به یک دستیار و یک تاریخچه متصل‌اند.";
+    readonly experienceLabel: "انتخاب تجربه";
+    readonly search: "پرسش هوشمند";
+    readonly chat: "گفت‌وگو";
+    readonly prompts: "پیشنهادهای پرسش";
+    readonly searchTitle: "سؤال خود را بپرسید";
+    readonly searchDescription: "سؤال را بنویسید؛ پاسخ در مودال مستقل پرسش نمایش داده می‌شود و می‌توانید همان‌جا ادامه دهید.";
+    readonly chatTitle: "گفت‌وگو را ادامه دهید";
+    readonly chatDescription: "پنل را باز کنید. سؤال‌های قبلی و پاسخ‌ها تا زمانی که این صفحه باز است، همراه شما می‌مانند.";
+    readonly promptsTitle: "با یک پیشنهاد شروع کنید";
+    readonly promptsDescription: "یک پیشنهاد را انتخاب کنید؛ این پرسش هم وارد همان گفت‌وگوی مشترک می‌شود.";
+    readonly openChat: "باز کردن گفت‌وگو";
+    readonly shared: "یک دستیار، یک گفت‌وگو";
+    readonly sharedDescription: "بین تجربه‌ها جابه‌جا شوید؛ تاریخچهٔ گفت‌وگو حفظ می‌شود.";
+    readonly stepOne: "از نوار پرسش یا یک پیشنهاد شروع کنید.";
+    readonly stepTwo: "پاسخ را ببینید و سؤال بعدی را در همان تجربه بپرسید.";
+    readonly stepThree: "پنل را ببندید و دوباره باز کنید؛ گفت‌وگو باقی می‌ماند.";
+    readonly demo: "نسخهٔ نمایشی";
+    readonly demoNotice: "پاسخ‌ها و پیشنهادها شبیه‌سازی شده‌اند؛ این نسخه به سرویس واقعی سرچیا متصل نیست.";
+    readonly features: "امکانات این تجربه";
+    readonly featureOne: "نمایش تدریجی پاسخ‌ها";
+    readonly featureTwo: "متن، Markdown و کپی کد";
+    readonly featureThree: "فارسی و انگلیسی، با تاریخچهٔ مشترک";
+    readonly developer: "راهنمای تعبیه برای توسعه‌دهندگان";
+    readonly developerIntro: "این دو فایل را روی وب‌سایت خود قرار دهید. زبان را از صفحهٔ میزبان تنظیم کنید.";
+    readonly embedNote: "بدون iframe یا نیاز به نصب React روی وب‌سایت میزبان. برای نمایش فقط چت، showSearch را حذف کنید.";
+    readonly footer: "تجربه‌های هوشمند سرچیا";
+    readonly referenceNote: "نمونه‌های Algolia فقط برای مقایسه‌اند و اتصال سرچیا را نمایش نمی‌دهند.";
+    readonly loadError: "بارگذاری ویجت ممکن نشد. ابتدا بستهٔ standalone را بسازید و صفحه را دوباره باز کنید.";
+  };
+  readonly en: {
+    readonly documentTitle: "Searchia | AI experiences";
+    readonly brand: "Searchia";
+    readonly subtitle: "AI experiences for your website";
+    readonly reference: "Algolia reference examples";
+    readonly language: "Display language";
+    readonly eyebrow: "Embeddable Searchia experiences";
+    readonly heading: "From a question to a conversation.";
+    readonly intro: "Try AI Search and the chatbot. Both connect to one assistant and one history.";
+    readonly experienceLabel: "Choose an experience";
+    readonly search: "AI Search";
+    readonly chat: "Conversation";
+    readonly prompts: "Suggested prompts";
+    readonly searchTitle: "Ask your question";
+    readonly searchDescription: "Type a question. The answer opens in its own AI Search modal, where you can keep going.";
+    readonly chatTitle: "Continue the conversation";
+    readonly chatDescription: "Open the panel. Your earlier questions and answers stay with you while this page is open.";
+    readonly promptsTitle: "Start with a suggestion";
+    readonly promptsDescription: "Choose a prompt. It joins the same shared conversation.";
+    readonly openChat: "Open conversation";
+    readonly shared: "One assistant, one conversation";
+    readonly sharedDescription: "Switch between experiences. Your conversation stays together.";
+    readonly stepOne: "Start from the question input or a suggested prompt.";
+    readonly stepTwo: "Read the answer and ask a follow-up in the same experience.";
+    readonly stepThree: "Close and reopen the panel. Your conversation is still there.";
+    readonly demo: "Simulated demo";
+    readonly demoNotice: "Answers and prompts are simulated. This prototype is not connected to a real Searchia service.";
+    readonly features: "What you can try";
+    readonly featureOne: "Responses that stream as you read";
+    readonly featureTwo: "Text, Markdown, and code copying";
+    readonly featureThree: "Persian and English with shared history";
+    readonly developer: "Embedding guide for developers";
+    readonly developerIntro: "Host these two files on your website. Set the language from the host page.";
+    readonly embedNote: "No iframe or host React installation required. Omit showSearch to display only the chat entry point.";
+    readonly footer: "Searchia AI experiences";
+    readonly referenceNote: "Algolia examples are for comparison only. They do not demonstrate a Searchia integration.";
+    readonly loadError: "The widget could not load. Build the standalone bundle, then reload this page.";
+  };
+};
+//#endregion
+//#region src/searchia/types.d.ts
+interface SearchiaChatPart {
+  type: string;
+  text?: string;
+  [key: string]: unknown;
+}
+interface SearchiaStreamMessage {
+  id: string;
+  parts: SearchiaChatPart[];
+  metadata?: Record<string, unknown>;
+}
+/**
+ * Searchia Chat Types & Adapter Interfaces
+ * -----------------------------------------
+ * Framework-independent definitions for Searchia's Agent Studio chat widget.
+ */
+interface SearchiaChatMessage {
+  id: string;
+  role: "user" | "assistant" | "system";
+  content: string;
+  createdAt?: Date;
+}
+interface SuggestedQuestionItem {
+  id: string;
+  question: string;
+}
+interface SendMessageOptions {
+  onMessage?: (message: SearchiaStreamMessage) => void;
+  /** The current message prompt sent by the user */
+  prompt: string;
+  /** Local response ID used to map feedback to the backend message. */
+  assistantMessageId?: string;
+  /** UI locale hint; adapters decide response language independently. */
+  language?: SearchiaLanguage;
+  /** Full conversation history leading up to this message */
+  history: SearchiaChatMessage[];
+  /** Callback invoked incrementally when streaming tokens are received */
+  onChunk?: (chunk: string, fullText: string) => void;
+  /** Signal used to abort / cancel generation if the user resets or stops */
+  signal?: AbortSignal;
+}
+interface SearchiaChatAdapter {
+  /** Identifying name of the adapter implementation */
+  readonly name: string;
+  /** True if this is a simulated/mock adapter; false if communicating with a real backend */
+  readonly isMock: boolean;
+  /**
+   * Sends a user query to the Searchia Agent API or mock engine.
+   * Returns the final completed text response.
+   */
+  sendMessage(options: SendMessageOptions): Promise<string>;
+  /**
+   * Retrieves suggested starter questions for the empty state.
+   */
+  getSuggestedQuestions?(language?: SearchiaLanguage): Promise<SuggestedQuestionItem[]>;
+  /**
+   * Submits user feedback (thumbs up / thumbs down) for an assistant response.
+   */
+  resetConversation?(): void;
+  sendFeedback?(messageId: string, vote: 1 | 0): Promise<void>;
+}
+interface SearchiaChatConfig {
+  /** Real Searchia SSE completion connection. */
+  searchia?: SearchiaApiConfig;
+  /** Backward-compatible alias for locale. Defaults to Persian. */
+  language?: SearchiaLanguage;
+  /** Page-owned UI locale; takes precedence over language. */
+  locale?: SearchiaLanguage;
+  /** Display an AI question input in the mount container. Defaults to false. */
+  showSearch?: boolean;
+  /** Display starter prompts below the question input. Defaults to false. */
+  showSuggestedPrompts?: boolean;
+  /** Show the conversation trigger. Defaults to true. */
+  showChatTrigger?: boolean;
+  /** Optional customer-owned welcome copy. */
+  welcomeTitle?: string;
+  welcomeMessage?: string;
+  /** Optional identifier supplied by the host; no backend contract is implied. */
+  agentId?: string;
+  /**
+   * Custom chat adapter instance. Takes precedence over searchia and algolia configuration.
+   */
+  adapter?: SearchiaChatAdapter;
+  /** Temporary Algolia connection. A custom adapter takes precedence. */
+  algolia?: AlgoliaChatConfig;
+  /**
+   * Trigger button display text (defaults to localized "Ask Searchia")
+   */
+  buttonText?: string;
+  /**
+   * Header title display text (defaults to localized "Searchia AI")
+   */
+  title?: string;
+  /**
+   * Input placeholder text (defaults to localized "Ask Searchia anything...")
+   */
+  placeholder?: string;
+  /**
+   * Positioning of the trigger button: "fixed" (bottom-right viewport) or "inline" (inside container)
+   * Defaults to "fixed".
+   */
+  triggerPosition?: "fixed" | "inline";
+  /**
+   * Explicit dark mode setting. If undefined, follows HTML class or system preference.
+   */
+  darkMode?: boolean;
+  /**
+   * Whether to show suggested questions in the welcome state (defaults to true)
+   */
+  suggestedQuestionsEnabled?: boolean;
+  /**
+   * Optional custom static suggested questions to override adapter suggestions
+   */
+  customSuggestedQuestions?: string[];
+}
+//#endregion
+//#region src/searchia/mock-adapter.d.ts
+/**
+ * EXPLICITLY LABELED MOCK ADAPTER
+ * --------------------------------
+ * Simulates a conversational AI search assistant for Searchia Agent Studio.
+ * Does not make external network requests or invent fake API endpoints/tokens.
+ */
+declare class MockSearchiaAdapter implements SearchiaChatAdapter {
+  readonly name = "MockSearchiaAdapter";
+  readonly isMock = true;
+  private delayMs;
+  constructor(options?: {
+    delayMs?: number;
+  });
+  getSuggestedQuestions(language?: SearchiaLanguage): Promise<SuggestedQuestionItem[]>;
+  sendMessage(options: SendMessageOptions): Promise<string>;
+  sendFeedback(messageId: string, vote: 1 | 0): Promise<void>;
+  private generateResponse;
+}
+//#endregion
+//#region src/vanilla/searchia-chat.d.ts
+type SearchiaChatInitOptions = SearchiaChatConfig & {
+  container?: string | HTMLElement;
+};
+/** Existing init API, with opt-in AI search and a page-owned locale. */
+declare function init({
+  container,
+  ...config
+}?: SearchiaChatInitOptions): void;
+/** Without a container, update every active instance without remounting it. */
+declare function setLocale(locale: SearchiaLanguage, container?: string | HTMLElement): void;
+declare function open(container?: string | HTMLElement): void;
+declare function openSearch(container?: string | HTMLElement): void;
+declare function ask(question: string, container?: string | HTMLElement): Promise<void>;
+declare function destroy(container?: string | HTMLElement): void;
+declare const _default: {
+  init: typeof init;
+  destroy: typeof destroy;
+  setLocale: typeof setLocale;
+  open: typeof open;
+  openSearch: typeof openSearch;
+  ask: typeof ask;
+  MockSearchiaAdapter: typeof MockSearchiaAdapter;
+  SearchiaApiAdapter: typeof SearchiaApiAdapter;
+};
+//#endregion
+export { AlgoliaChatAdapter, type AlgoliaChatConfig, MockSearchiaAdapter, type SearchiaAgentConfiguration, SearchiaApiAdapter, type SearchiaApiConfig, type SearchiaChatAdapter, type SearchiaChatConfig, SearchiaChatInitOptions, type SearchiaChatMessage, type SearchiaChatPart, type SearchiaLanguage, type SearchiaStreamMessage, type SendMessageOptions, type SuggestedQuestionItem, ask, _default as default, destroy, init, open, openSearch, setLocale, showcaseTranslations };