@useknest/widget-core 0.1.0-beta.9 → 0.1.1

package/dist/attachments.d.ts

@@ -0,0 +1,44 @@
+import { Attachment } from './types';
+/** Client-side validation before attempting upload. Returns an error message or null. */
+export declare function validateAttachment(file: File): string | null;
+/**
+ * Requests a presigned upload URL from the server.
+ * The server validates the request and generates a short-lived signed URL via the service role key.
+ */
+export declare function requestUploadUrl({ publishableApiKey, threadId, fileName, fileType, fileSize, baseUrl }: {
+    publishableApiKey: string;
+    threadId: string;
+    fileName: string;
+    fileType: string;
+    fileSize: number;
+    baseUrl?: string;
+}): Promise<{
+    uploadUrl: string;
+    token: string;
+    storagePath: string;
+}>;
+/**
+ * PUTs a file directly to Supabase Storage using a presigned upload URL.
+ * The server never touches the file bytes.
+ */
+export declare function uploadToStorage(uploadUrl: string, file: File): Promise<void>;
+/**
+ * Orchestrates the two-step upload: request presigned URL → PUT file to storage.
+ * Returns attachment metadata (without a signed download URL — resolved lazily at display time).
+ */
+export declare function uploadAttachment({ publishableApiKey, threadId, file, baseUrl }: {
+    publishableApiKey: string;
+    threadId: string;
+    file: File;
+    baseUrl?: string;
+}): Promise<Attachment>;
+/**
+ * Fetches a temporary signed download URL for an attachment via the widget API.
+ * Used for lazy URL resolution in the ChatMessage component.
+ */
+export declare function fetchSignedUrl({ publishableApiKey, storagePath, baseUrl }: {
+    publishableApiKey: string;
+    storagePath: string;
+    baseUrl?: string;
+}): Promise<string | null>;
+//# sourceMappingURL=attachments.d.ts.map

package/dist/attachments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attachments.d.ts","sourceRoot":"","sources":["../src/attachments.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAE1C,yFAAyF;AACzF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,GAAG,IAAI,CAQ5D;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACtC,iBAAiB,EACjB,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,EAAE;IACF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBrE;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,EACtC,iBAAiB,EACjB,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,EAAE;IACF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,UAAU,CAAC,CAatB;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,EACpC,iBAAiB,EACjB,WAAW,EACX,OAAO,EACP,EAAE;IACF,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAmBzB"}

package/dist/auth.d.ts

@@ -4,10 +4,10 @@ import { SupabaseClient } from '@supabase/supabase-js';
  * This must be called before sending chat messages.
  *
  * @param supabaseUrl - The Supabase project URL
- * @param supabaseAnonKey - The Supabase anonymous/public key
+ * @param supabasePublishableKey - The Supabase publishable key
  * @returns Promise resolving to true if auth succeeded, false otherwise
  */
-export declare function initWidgetAuth(supabaseUrl: string, supabaseAnonKey: string): Promise<boolean>;
+export declare function initWidgetAuth(supabaseUrl: string, supabasePublishableKey: string): Promise<boolean>;
 /**
  * Gets the current access token for API requests.
  * Returns null if not authenticated.

package/dist/auth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM1E;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,WAAW,EAAE,MAAM,EACnB,eAAe,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAmDlB;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU7D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAEzD"}
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAgB,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAM1E;;;;;;;GAOG;AACH,wBAAsB,cAAc,CACnC,WAAW,EAAE,MAAM,EACnB,sBAAsB,EAAE,MAAM,GAC5B,OAAO,CAAC,OAAO,CAAC,CAmDlB;AAED;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAU7D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,IAAI,CAEzD"}

package/dist/constants.d.ts

@@ -1,7 +1,7 @@
 export declare const DEFAULT_BASE_URL = "https://useknest.com";
 export declare const API_PATH = "/api/v1";
 export declare const PUBLIC_SUPABASE_URL = "https://lghrsugmhzpccpriqhrx.supabase.co";
-export declare const PUBLIC_SUPABASE_ANON_KEY = "sb_publishable_-KUwilDA78QM849gk662FA_kEzMezNS";
+export declare const PUBLIC_SUPABASE_PUBLISHABLE_KEY = "sb_publishable_-KUwilDA78QM849gk662FA_kEzMezNS";
 /** Builds the chat messages API URL from a base URL. */
 export declare function getChatApiUrl(baseUrl?: string): string;
 /** Builds the widget config API URL from a base URL. */
@@ -14,4 +14,21 @@ export declare const DEFAULT_AVATAR_URL = "https://useknest.com/default-avatar.s
 export declare const DEFAULT_BRAND_COLOR = "#3b82f6";
 export declare const DEFAULT_WELCOME_MESSAGE = "Hi! I'm your AI assistant. I'm trained to answer questions about your documentation. How can I help you today?";
 export declare const DEFAULT_EXAMPLE_QUESTIONS: string[];
+export declare const ALLOWED_IMAGE_TYPES: string[];
+export declare const ALLOWED_DOCUMENT_TYPES: string[];
+export declare const ALLOWED_ATTACHMENT_TYPES: string[];
+export declare const ACCEPTED_FILE_TYPES_STRING: string;
+export declare const MAX_ATTACHMENT_SIZE_BYTES: number;
+export declare const MAX_ATTACHMENTS_PER_MESSAGE = 5;
+/** Builds the attachment upload-URL endpoint from a base URL. */
+export declare function getAttachmentUploadUrl(baseUrl?: string): string;
+/** Builds the attachment signed-URL endpoint from a base URL. */
+export declare function getAttachmentSignedUrlEndpoint(baseUrl?: string): string;
+/** Returns true if the MIME type is a supported image type. */
+export declare function isImageType(fileType: string): boolean;
+export declare const WIDGET_Z_INDEX = 2147483647;
+export declare const WIDGET_CLOSE_BTN_Z_INDEX = 2147483646;
+export declare const HUMAN_TAKEOVER_CAPTION = "A human agent will get back to you shortly.";
+export declare const PRESENCE_LABEL_WIDGET = "We are online";
+export declare const PRESENCE_LABEL_DASHBOARD = "Customer online";
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,QAAQ,YAAY,CAAC;AAIlC,eAAO,MAAM,mBAAmB,6CAA6C,CAAC;AAC9E,eAAO,MAAM,wBAAwB,mDAAmD,CAAC;AAEzF,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAExE;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAE1E;AAED,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AACxE,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,kBAAkB,iGACgE,CAAC;AAChG,eAAO,MAAM,mBAAmB,mGACiE,CAAC;AAClG,eAAO,MAAM,kBAAkB,4CAA4C,CAAC;AAC5E,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,uBAAuB,mHAC6E,CAAC;AAClH,eAAO,MAAM,yBAAyB,UAIrC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,gBAAgB,yBAAyB,CAAC;AACvD,eAAO,MAAM,QAAQ,YAAY,CAAC;AAIlC,eAAO,MAAM,mBAAmB,6CAA6C,CAAC;AAC9E,eAAO,MAAM,+BAA+B,mDAAmD,CAAC;AAEhG,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAExE;AAED,wDAAwD;AACxD,wBAAgB,eAAe,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAE1E;AAED,eAAO,MAAM,sBAAsB,oCAAoC,CAAC;AACxE,eAAO,MAAM,qBAAqB,2BAA2B,CAAC;AAC9D,eAAO,MAAM,kBAAkB,iGACgE,CAAC;AAChG,eAAO,MAAM,mBAAmB,mGACiE,CAAC;AAClG,eAAO,MAAM,kBAAkB,4CAA4C,CAAC;AAC5E,eAAO,MAAM,mBAAmB,YAAY,CAAC;AAC7C,eAAO,MAAM,uBAAuB,mHAC6E,CAAC;AAClH,eAAO,MAAM,yBAAyB,UAIrC,CAAC;AAEF,eAAO,MAAM,mBAAmB,UAAyD,CAAC;AAC1F,eAAO,MAAM,sBAAsB,UAIlC,CAAC;AACF,eAAO,MAAM,wBAAwB,UAAsD,CAAC;AAC5F,eAAO,MAAM,0BAA0B,QAAqC,CAAC;AAC7E,eAAO,MAAM,yBAAyB,QAAmB,CAAC;AAC1D,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,iEAAiE;AACjE,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAEjF;AAED,iEAAiE;AACjE,wBAAgB,8BAA8B,CAAC,OAAO,GAAE,MAAyB,GAAG,MAAM,CAEzF;AAED,+DAA+D;AAC/D,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAErD;AAID,eAAO,MAAM,cAAc,aAAa,CAAC;AACzC,eAAO,MAAM,wBAAwB,aAAa,CAAC;AAEnD,eAAO,MAAM,sBAAsB,gDAAgD,CAAC;AACpF,eAAO,MAAM,qBAAqB,kBAAkB,CAAC;AACrD,eAAO,MAAM,wBAAwB,oBAAoB,CAAC"}

package/dist/index.d.ts

@@ -1,10 +1,16 @@
-export type { WidgetMode, MessageRole, Source, Message, ChatMessageRequest, ChatMessageResponse, ChatApiError, WidgetConfig, SSEEvent } from './types';
-export { DEFAULT_BASE_URL, API_PATH, getChatApiUrl, getConfigApiUrl, FALLBACK_ERROR_MESSAGE, DEFAULT_ERROR_MESSAGE, AUTH_ERROR_MESSAGE, USAGE_LIMIT_MESSAGE, DEFAULT_AVATAR_URL, DEFAULT_BRAND_COLOR, DEFAULT_WELCOME_MESSAGE, DEFAULT_EXAMPLE_QUESTIONS, PUBLIC_SUPABASE_URL, PUBLIC_SUPABASE_ANON_KEY } from './constants';
+export type { WidgetMode, MessageRole, Source, Attachment, Message, ChatMessageRequest, ChatMessageResponse, ChatApiError, WidgetConfig, SSEEvent, WidgetUser } from './types';
+export { DEFAULT_BASE_URL, API_PATH, getChatApiUrl, getConfigApiUrl, FALLBACK_ERROR_MESSAGE, DEFAULT_ERROR_MESSAGE, AUTH_ERROR_MESSAGE, USAGE_LIMIT_MESSAGE, DEFAULT_AVATAR_URL, DEFAULT_BRAND_COLOR, DEFAULT_WELCOME_MESSAGE, DEFAULT_EXAMPLE_QUESTIONS, PUBLIC_SUPABASE_URL, PUBLIC_SUPABASE_PUBLISHABLE_KEY, ALLOWED_IMAGE_TYPES, ALLOWED_DOCUMENT_TYPES, ALLOWED_ATTACHMENT_TYPES, ACCEPTED_FILE_TYPES_STRING, MAX_ATTACHMENT_SIZE_BYTES, MAX_ATTACHMENTS_PER_MESSAGE, getAttachmentUploadUrl, getAttachmentSignedUrlEndpoint, isImageType, HUMAN_TAKEOVER_CAPTION, PRESENCE_LABEL_WIDGET, PRESENCE_LABEL_DASHBOARD } from './constants';
 export { fetchWidgetConfig } from './config';
 export type { ConfigResult, ConfigErrorType } from './config';
 export { streamChatMessage } from './streaming';
 export type { StreamCallbacks, StreamMessageOptions } from './streaming';
-export { formatContent } from './utils';
+export { formatContent, formatFileSize } from './utils';
+export { validateAttachment, requestUploadUrl, uploadToStorage, uploadAttachment, fetchSignedUrl } from './attachments';
 export { initWidgetAuth, getAccessToken, isAuthenticated, getSupabaseClient } from './auth';
 export { initWidgetSentry, captureWidgetException } from './sentry';
+export { subscribeToThread } from './realtime';
+export type { BroadcastMessage, PresenceOptions } from './realtime';
+export { loadChatState, saveChatState, saveChatStateDebounced, clearChatState } from './persistence';
+export type { PersistedChatState } from './persistence';
+export { lockBodyScroll, unlockBodyScroll, MOBILE_BREAKPOINT_PX } from './scroll-lock';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,UAAU,EACV,WAAW,EACX,MAAM,EACN,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,mBAAmB,EACnB,wBAAwB,EACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGxC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAG5F,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,YAAY,EACX,UAAU,EACV,WAAW,EACX,MAAM,EACN,UAAU,EACV,OAAO,EACP,kBAAkB,EAClB,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,UAAU,EACV,MAAM,SAAS,CAAC;AAGjB,OAAO,EACN,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,eAAe,EACf,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,yBAAyB,EACzB,mBAAmB,EACnB,+BAA+B,EAC/B,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,2BAA2B,EAC3B,sBAAsB,EACtB,8BAA8B,EAC9B,WAAW,EACX,sBAAsB,EACtB,qBAAqB,EACrB,wBAAwB,EACxB,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAG9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGzE,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAGxD,OAAO,EACN,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,MAAM,eAAe,CAAC;AAGvB,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,QAAQ,CAAC;AAG5F,OAAO,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAGpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAC/C,YAAY,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGpE,OAAO,EACN,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,cAAc,EACd,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGxD,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC"}