@cossistant/core 0.0.26 → 0.0.29

package/typing-reporter.js

@@ -0,0 +1,145 @@
+//#region src/typing-reporter.ts
+/**
+* Shared typing reporter logic for throttling and scheduling typing events.
+* This is a framework-agnostic utility used by both React widget and dashboard hooks.
+*/
+/** Minimum interval between typing event sends (ms) */
+const TYPING_SEND_INTERVAL_MS = 800;
+/** Keep-alive interval for typing events (ms) */
+const TYPING_KEEP_ALIVE_MS = 4e3;
+/** Delay before auto-stop typing on inactivity (ms) */
+const TYPING_STOP_DELAY_MS = 2e3;
+/** Maximum length for typing preview text */
+const TYPING_PREVIEW_MAX_LENGTH = 2e3;
+/**
+* Creates a typing reporter instance that handles throttling and scheduling
+* of typing events.
+*
+* @example
+* ```ts
+* const reporter = createTypingReporter({
+*   send: async (isTyping, preview) => {
+*     await api.sendTypingEvent({ isTyping, preview });
+*   },
+* });
+*
+* // On input change
+* reporter.handleInputChange(inputValue);
+*
+* // On submit
+* reporter.handleSubmit();
+*
+* // On unmount
+* reporter.dispose();
+* ```
+*/
+function createTypingReporter(config) {
+	const { send, sendIntervalMs = TYPING_SEND_INTERVAL_MS, keepAliveMs = TYPING_KEEP_ALIVE_MS, stopDelayMs = TYPING_STOP_DELAY_MS, previewMaxLength = TYPING_PREVIEW_MAX_LENGTH, includePreview = true } = config;
+	const state = {
+		isActive: false,
+		lastSentAt: 0,
+		latestPreview: ""
+	};
+	const timers = {
+		keepAlive: null,
+		stopTyping: null
+	};
+	const clearKeepAlive = () => {
+		if (timers.keepAlive) {
+			clearTimeout(timers.keepAlive);
+			timers.keepAlive = null;
+		}
+	};
+	const clearStopTypingTimeout = () => {
+		if (timers.stopTyping) {
+			clearTimeout(timers.stopTyping);
+			timers.stopTyping = null;
+		}
+	};
+	const sendTyping = (isTyping) => {
+		const preview = includePreview && isTyping ? state.latestPreview : null;
+		Promise.resolve(send(isTyping, preview)).catch((error) => {
+			console.error("[TypingReporter] Failed to send typing event", error);
+		});
+	};
+	const scheduleKeepAlive = () => {
+		clearKeepAlive();
+		timers.keepAlive = setTimeout(() => {
+			if (state.isActive) {
+				sendTyping(true);
+				scheduleKeepAlive();
+			}
+		}, keepAliveMs);
+	};
+	const scheduleStopTyping = () => {
+		clearStopTypingTimeout();
+		timers.stopTyping = setTimeout(() => {
+			if (state.isActive) {
+				state.isActive = false;
+				clearKeepAlive();
+				sendTyping(false);
+			}
+		}, stopDelayMs);
+	};
+	const handleInputChange = (value) => {
+		const trimmed = value.trim();
+		state.latestPreview = trimmed.slice(0, previewMaxLength);
+		const now = typeof globalThis !== "undefined" && "Date" in globalThis ? Date.now() : 0;
+		if (trimmed.length === 0) {
+			if (state.isActive) {
+				state.isActive = false;
+				state.lastSentAt = now;
+				clearKeepAlive();
+				clearStopTypingTimeout();
+				sendTyping(false);
+			}
+			return;
+		}
+		scheduleStopTyping();
+		if (!state.isActive) {
+			state.isActive = true;
+			state.lastSentAt = now;
+			sendTyping(true);
+			scheduleKeepAlive();
+			return;
+		}
+		if (now - state.lastSentAt >= sendIntervalMs) {
+			state.lastSentAt = now;
+			sendTyping(true);
+			scheduleKeepAlive();
+		}
+	};
+	const handleSubmit = () => {
+		if (!state.isActive) return;
+		state.isActive = false;
+		state.lastSentAt = typeof globalThis !== "undefined" && "Date" in globalThis ? Date.now() : 0;
+		clearKeepAlive();
+		clearStopTypingTimeout();
+		sendTyping(false);
+	};
+	const stop = () => {
+		if (!state.isActive) return;
+		state.isActive = false;
+		state.lastSentAt = typeof globalThis !== "undefined" && "Date" in globalThis ? Date.now() : 0;
+		clearKeepAlive();
+		clearStopTypingTimeout();
+		sendTyping(false);
+	};
+	const dispose = () => {
+		if (state.isActive) sendTyping(false);
+		clearKeepAlive();
+		clearStopTypingTimeout();
+	};
+	const getState = () => ({ ...state });
+	return {
+		handleInputChange,
+		handleSubmit,
+		stop,
+		dispose,
+		getState
+	};
+}
+
+//#endregion
+export { TYPING_KEEP_ALIVE_MS, TYPING_PREVIEW_MAX_LENGTH, TYPING_SEND_INTERVAL_MS, TYPING_STOP_DELAY_MS, createTypingReporter };
+//# sourceMappingURL=typing-reporter.js.map

package/typing-reporter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typing-reporter.js","names":["state: TypingReporterState","timers: TypingReporterTimers"],"sources":["../src/typing-reporter.ts"],"sourcesContent":["/**\n * Shared typing reporter logic for throttling and scheduling typing events.\n * This is a framework-agnostic utility used by both React widget and dashboard hooks.\n */\n\n/** Minimum interval between typing event sends (ms) */\nexport const TYPING_SEND_INTERVAL_MS = 800;\n\n/** Keep-alive interval for typing events (ms) */\nexport const TYPING_KEEP_ALIVE_MS = 4000;\n\n/** Delay before auto-stop typing on inactivity (ms) */\nexport const TYPING_STOP_DELAY_MS = 2000;\n\n/** Maximum length for typing preview text */\nexport const TYPING_PREVIEW_MAX_LENGTH = 2000;\n\ntype TypingReporterState = {\n\tisActive: boolean;\n\tlastSentAt: number;\n\tlatestPreview: string;\n};\n\ntype TypingReporterTimers = {\n\tkeepAlive: ReturnType<typeof setTimeout> | null;\n\tstopTyping: ReturnType<typeof setTimeout> | null;\n};\n\ntype TypingReporterSendFn = (\n\tisTyping: boolean,\n\tpreview?: string | null\n) => void | Promise<void>;\n\nexport type TypingReporterConfig = {\n\t/** Function to send the typing event */\n\tsend: TypingReporterSendFn;\n\t/** Custom send interval (default: 800ms) */\n\tsendIntervalMs?: number;\n\t/** Custom keep-alive interval (default: 4000ms) */\n\tkeepAliveMs?: number;\n\t/** Custom stop delay (default: 2000ms) */\n\tstopDelayMs?: number;\n\t/** Maximum preview length (default: 2000) */\n\tpreviewMaxLength?: number;\n\t/** Whether to include preview text (default: true) */\n\tincludePreview?: boolean;\n};\n\nexport type TypingReporter = {\n\t/** Call when input value changes */\n\thandleInputChange: (value: string) => void;\n\t/** Call when message is submitted */\n\thandleSubmit: () => void;\n\t/** Force stop typing indicator */\n\tstop: () => void;\n\t/** Clean up timers (call on unmount) */\n\tdispose: () => void;\n\t/** Get current state (for testing) */\n\tgetState: () => TypingReporterState;\n};\n\n/**\n * Creates a typing reporter instance that handles throttling and scheduling\n * of typing events.\n *\n * @example\n * ```ts\n * const reporter = createTypingReporter({\n *   send: async (isTyping, preview) => {\n *     await api.sendTypingEvent({ isTyping, preview });\n *   },\n * });\n *\n * // On input change\n * reporter.handleInputChange(inputValue);\n *\n * // On submit\n * reporter.handleSubmit();\n *\n * // On unmount\n * reporter.dispose();\n * ```\n */\nexport function createTypingReporter(\n\tconfig: TypingReporterConfig\n): TypingReporter {\n\tconst {\n\t\tsend,\n\t\tsendIntervalMs = TYPING_SEND_INTERVAL_MS,\n\t\tkeepAliveMs = TYPING_KEEP_ALIVE_MS,\n\t\tstopDelayMs = TYPING_STOP_DELAY_MS,\n\t\tpreviewMaxLength = TYPING_PREVIEW_MAX_LENGTH,\n\t\tincludePreview = true,\n\t} = config;\n\n\tconst state: TypingReporterState = {\n\t\tisActive: false,\n\t\tlastSentAt: 0,\n\t\tlatestPreview: \"\",\n\t};\n\n\tconst timers: TypingReporterTimers = {\n\t\tkeepAlive: null,\n\t\tstopTyping: null,\n\t};\n\n\tconst clearKeepAlive = () => {\n\t\tif (timers.keepAlive) {\n\t\t\tclearTimeout(timers.keepAlive);\n\t\t\ttimers.keepAlive = null;\n\t\t}\n\t};\n\n\tconst clearStopTypingTimeout = () => {\n\t\tif (timers.stopTyping) {\n\t\t\tclearTimeout(timers.stopTyping);\n\t\t\ttimers.stopTyping = null;\n\t\t}\n\t};\n\n\tconst sendTyping = (isTyping: boolean) => {\n\t\tconst preview = includePreview && isTyping ? state.latestPreview : null;\n\t\tvoid Promise.resolve(send(isTyping, preview)).catch((error) => {\n\t\t\tconsole.error(\"[TypingReporter] Failed to send typing event\", error);\n\t\t});\n\t};\n\n\tconst scheduleKeepAlive = () => {\n\t\tclearKeepAlive();\n\t\ttimers.keepAlive = setTimeout(() => {\n\t\t\tif (state.isActive) {\n\t\t\t\tsendTyping(true);\n\t\t\t\tscheduleKeepAlive();\n\t\t\t}\n\t\t}, keepAliveMs);\n\t};\n\n\tconst scheduleStopTyping = () => {\n\t\tclearStopTypingTimeout();\n\t\ttimers.stopTyping = setTimeout(() => {\n\t\t\tif (state.isActive) {\n\t\t\t\tstate.isActive = false;\n\t\t\t\tclearKeepAlive();\n\t\t\t\tsendTyping(false);\n\t\t\t}\n\t\t}, stopDelayMs);\n\t};\n\n\tconst handleInputChange = (value: string) => {\n\t\tconst trimmed = value.trim();\n\t\tstate.latestPreview = trimmed.slice(0, previewMaxLength);\n\t\tconst now =\n\t\t\ttypeof globalThis !== \"undefined\" && \"Date\" in globalThis\n\t\t\t\t? Date.now()\n\t\t\t\t: 0;\n\n\t\tif (trimmed.length === 0) {\n\t\t\tif (state.isActive) {\n\t\t\t\tstate.isActive = false;\n\t\t\t\tstate.lastSentAt = now;\n\t\t\t\tclearKeepAlive();\n\t\t\t\tclearStopTypingTimeout();\n\t\t\t\tsendTyping(false);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Schedule auto-stop after inactivity\n\t\tscheduleStopTyping();\n\n\t\tif (!state.isActive) {\n\t\t\tstate.isActive = true;\n\t\t\tstate.lastSentAt = now;\n\t\t\tsendTyping(true);\n\t\t\tscheduleKeepAlive();\n\t\t\treturn;\n\t\t}\n\n\t\tif (now - state.lastSentAt >= sendIntervalMs) {\n\t\t\tstate.lastSentAt = now;\n\t\t\tsendTyping(true);\n\t\t\tscheduleKeepAlive();\n\t\t}\n\t};\n\n\tconst handleSubmit = () => {\n\t\tif (!state.isActive) {\n\t\t\treturn;\n\t\t}\n\n\t\tstate.isActive = false;\n\t\tstate.lastSentAt =\n\t\t\ttypeof globalThis !== \"undefined\" && \"Date\" in globalThis\n\t\t\t\t? Date.now()\n\t\t\t\t: 0;\n\t\tclearKeepAlive();\n\t\tclearStopTypingTimeout();\n\t\tsendTyping(false);\n\t};\n\n\tconst stop = () => {\n\t\tif (!state.isActive) {\n\t\t\treturn;\n\t\t}\n\n\t\tstate.isActive = false;\n\t\tstate.lastSentAt =\n\t\t\ttypeof globalThis !== \"undefined\" && \"Date\" in globalThis\n\t\t\t\t? Date.now()\n\t\t\t\t: 0;\n\t\tclearKeepAlive();\n\t\tclearStopTypingTimeout();\n\t\tsendTyping(false);\n\t};\n\n\tconst dispose = () => {\n\t\tif (state.isActive) {\n\t\t\tsendTyping(false);\n\t\t}\n\t\tclearKeepAlive();\n\t\tclearStopTypingTimeout();\n\t};\n\n\tconst getState = () => ({ ...state });\n\n\treturn {\n\t\thandleInputChange,\n\t\thandleSubmit,\n\t\tstop,\n\t\tdispose,\n\t\tgetState,\n\t};\n}\n"],"mappings":";;;;;;AAMA,MAAa,0BAA0B;;AAGvC,MAAa,uBAAuB;;AAGpC,MAAa,uBAAuB;;AAGpC,MAAa,4BAA4B;;;;;;;;;;;;;;;;;;;;;;;AAoEzC,SAAgB,qBACf,QACiB;CACjB,MAAM,EACL,MACA,iBAAiB,yBACjB,cAAc,sBACd,cAAc,sBACd,mBAAmB,2BACnB,iBAAiB,SACd;CAEJ,MAAMA,QAA6B;EAClC,UAAU;EACV,YAAY;EACZ,eAAe;EACf;CAED,MAAMC,SAA+B;EACpC,WAAW;EACX,YAAY;EACZ;CAED,MAAM,uBAAuB;AAC5B,MAAI,OAAO,WAAW;AACrB,gBAAa,OAAO,UAAU;AAC9B,UAAO,YAAY;;;CAIrB,MAAM,+BAA+B;AACpC,MAAI,OAAO,YAAY;AACtB,gBAAa,OAAO,WAAW;AAC/B,UAAO,aAAa;;;CAItB,MAAM,cAAc,aAAsB;EACzC,MAAM,UAAU,kBAAkB,WAAW,MAAM,gBAAgB;AACnE,EAAK,QAAQ,QAAQ,KAAK,UAAU,QAAQ,CAAC,CAAC,OAAO,UAAU;AAC9D,WAAQ,MAAM,gDAAgD,MAAM;IACnE;;CAGH,MAAM,0BAA0B;AAC/B,kBAAgB;AAChB,SAAO,YAAY,iBAAiB;AACnC,OAAI,MAAM,UAAU;AACnB,eAAW,KAAK;AAChB,uBAAmB;;KAElB,YAAY;;CAGhB,MAAM,2BAA2B;AAChC,0BAAwB;AACxB,SAAO,aAAa,iBAAiB;AACpC,OAAI,MAAM,UAAU;AACnB,UAAM,WAAW;AACjB,oBAAgB;AAChB,eAAW,MAAM;;KAEhB,YAAY;;CAGhB,MAAM,qBAAqB,UAAkB;EAC5C,MAAM,UAAU,MAAM,MAAM;AAC5B,QAAM,gBAAgB,QAAQ,MAAM,GAAG,iBAAiB;EACxD,MAAM,MACL,OAAO,eAAe,eAAe,UAAU,aAC5C,KAAK,KAAK,GACV;AAEJ,MAAI,QAAQ,WAAW,GAAG;AACzB,OAAI,MAAM,UAAU;AACnB,UAAM,WAAW;AACjB,UAAM,aAAa;AACnB,oBAAgB;AAChB,4BAAwB;AACxB,eAAW,MAAM;;AAElB;;AAID,sBAAoB;AAEpB,MAAI,CAAC,MAAM,UAAU;AACpB,SAAM,WAAW;AACjB,SAAM,aAAa;AACnB,cAAW,KAAK;AAChB,sBAAmB;AACnB;;AAGD,MAAI,MAAM,MAAM,cAAc,gBAAgB;AAC7C,SAAM,aAAa;AACnB,cAAW,KAAK;AAChB,sBAAmB;;;CAIrB,MAAM,qBAAqB;AAC1B,MAAI,CAAC,MAAM,SACV;AAGD,QAAM,WAAW;AACjB,QAAM,aACL,OAAO,eAAe,eAAe,UAAU,aAC5C,KAAK,KAAK,GACV;AACJ,kBAAgB;AAChB,0BAAwB;AACxB,aAAW,MAAM;;CAGlB,MAAM,aAAa;AAClB,MAAI,CAAC,MAAM,SACV;AAGD,QAAM,WAAW;AACjB,QAAM,aACL,OAAO,eAAe,eAAe,UAAU,aAC5C,KAAK,KAAK,GACV;AACJ,kBAAgB;AAChB,0BAAwB;AACxB,aAAW,MAAM;;CAGlB,MAAM,gBAAgB;AACrB,MAAI,MAAM,SACT,YAAW,MAAM;AAElB,kBAAgB;AAChB,0BAAwB;;CAGzB,MAAM,kBAAkB,EAAE,GAAG,OAAO;AAEpC,QAAO;EACN;EACA;EACA;EACA;EACA;EACA"}

package/upload-constants.d.ts

@@ -0,0 +1,40 @@
+//#region src/upload-constants.d.ts
+/**
+ * File upload constants for cost/API protection.
+ * These limits are enforced on both client and server side.
+ */
+/** Maximum file size in bytes (5 MB) */
+declare const MAX_FILE_SIZE: number;
+/** Maximum number of files per message */
+declare const MAX_FILES_PER_MESSAGE = 3;
+/** Allowed MIME types for file uploads */
+declare const ALLOWED_MIME_TYPES: readonly ["image/jpeg", "image/png", "image/gif", "image/webp", "application/pdf", "text/plain", "text/csv", "text/markdown", "application/zip"];
+/** Human-readable file type descriptions for error messages */
+declare const ALLOWED_FILE_TYPES_DESCRIPTION = "images (JPEG, PNG, GIF, WebP), PDF, text files (TXT, CSV, MD), and ZIP archives";
+/** Accept string for file input elements */
+declare const FILE_INPUT_ACCEPT: string;
+/**
+ * Check if a MIME type is allowed for upload
+ */
+declare function isAllowedMimeType(mimeType: string): boolean;
+/**
+ * Check if a file is an image based on MIME type
+ */
+declare function isImageMimeType(mimeType: string): boolean;
+/**
+ * Format file size for display
+ */
+declare function formatFileSize(bytes: number): string;
+/**
+ * Validate a file against upload constraints
+ * @returns null if valid, error message if invalid
+ */
+declare function validateFile(file: File): string | null;
+/**
+ * Validate multiple files against upload constraints
+ * @returns null if all valid, error message if any invalid
+ */
+declare function validateFiles(files: File[]): string | null;
+//#endregion
+export { ALLOWED_FILE_TYPES_DESCRIPTION, ALLOWED_MIME_TYPES, FILE_INPUT_ACCEPT, MAX_FILES_PER_MESSAGE, MAX_FILE_SIZE, formatFileSize, isAllowedMimeType, isImageMimeType, validateFile, validateFiles };
+//# sourceMappingURL=upload-constants.d.ts.map

package/upload-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-constants.d.ts","names":[],"sources":["../src/upload-constants.ts"],"sourcesContent":[],"mappings":";;AAMA;AAGA;AAGA;AAiBA;AAIa,cA3BA,aA2BgD,EAAA,MAAA;AAK7D;AAOgB,cApCH,qBAAA,GAoCkB,CAAA;AAO/B;AAcgB,cAtDH,kBAsD0B,EAAA,SAAA,CAAA,YAAA,EAAA,WAAA,EAAA,WAAA,EAAA,YAAA,EAAA,iBAAA,EAAA,YAAA,EAAA,UAAA,EAAA,eAAA,EAAA,iBAAA,CAAA;AAgBvC;cArDa,8BAAA;;cAIA;;;;iBAKG,iBAAA;;;;iBAOA,eAAA;;;;iBAOA,cAAA;;;;;iBAcA,YAAA,OAAmB;;;;;iBAgBnB,aAAA,QAAqB"}

package/upload-constants.js

@@ -0,0 +1,70 @@
+//#region src/upload-constants.ts
+/**
+* File upload constants for cost/API protection.
+* These limits are enforced on both client and server side.
+*/
+/** Maximum file size in bytes (5 MB) */
+const MAX_FILE_SIZE = 5 * 1024 * 1024;
+/** Maximum number of files per message */
+const MAX_FILES_PER_MESSAGE = 3;
+/** Allowed MIME types for file uploads */
+const ALLOWED_MIME_TYPES = [
+	"image/jpeg",
+	"image/png",
+	"image/gif",
+	"image/webp",
+	"application/pdf",
+	"text/plain",
+	"text/csv",
+	"text/markdown",
+	"application/zip"
+];
+/** Human-readable file type descriptions for error messages */
+const ALLOWED_FILE_TYPES_DESCRIPTION = "images (JPEG, PNG, GIF, WebP), PDF, text files (TXT, CSV, MD), and ZIP archives";
+/** Accept string for file input elements */
+const FILE_INPUT_ACCEPT = ALLOWED_MIME_TYPES.join(",");
+/**
+* Check if a MIME type is allowed for upload
+*/
+function isAllowedMimeType(mimeType) {
+	return ALLOWED_MIME_TYPES.includes(mimeType);
+}
+/**
+* Check if a file is an image based on MIME type
+*/
+function isImageMimeType(mimeType) {
+	return mimeType.startsWith("image/");
+}
+/**
+* Format file size for display
+*/
+function formatFileSize(bytes) {
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+	return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/**
+* Validate a file against upload constraints
+* @returns null if valid, error message if invalid
+*/
+function validateFile(file) {
+	if (file.size > MAX_FILE_SIZE) return `File "${file.name}" exceeds maximum size of ${formatFileSize(MAX_FILE_SIZE)}`;
+	if (!isAllowedMimeType(file.type)) return `File type "${file.type || "unknown"}" is not allowed. Allowed types: ${ALLOWED_FILE_TYPES_DESCRIPTION}`;
+	return null;
+}
+/**
+* Validate multiple files against upload constraints
+* @returns null if all valid, error message if any invalid
+*/
+function validateFiles(files) {
+	if (files.length > MAX_FILES_PER_MESSAGE) return `Cannot attach more than ${MAX_FILES_PER_MESSAGE} files per message`;
+	for (const file of files) {
+		const error = validateFile(file);
+		if (error) return error;
+	}
+	return null;
+}
+
+//#endregion
+export { ALLOWED_FILE_TYPES_DESCRIPTION, ALLOWED_MIME_TYPES, FILE_INPUT_ACCEPT, MAX_FILES_PER_MESSAGE, MAX_FILE_SIZE, formatFileSize, isAllowedMimeType, isImageMimeType, validateFile, validateFiles };
+//# sourceMappingURL=upload-constants.js.map

package/upload-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload-constants.js","names":[],"sources":["../src/upload-constants.ts"],"sourcesContent":["/**\n * File upload constants for cost/API protection.\n * These limits are enforced on both client and server side.\n */\n\n/** Maximum file size in bytes (5 MB) */\nexport const MAX_FILE_SIZE = 5 * 1024 * 1024;\n\n/** Maximum number of files per message */\nexport const MAX_FILES_PER_MESSAGE = 3;\n\n/** Allowed MIME types for file uploads */\nexport const ALLOWED_MIME_TYPES = [\n\t// Images\n\t\"image/jpeg\",\n\t\"image/png\",\n\t\"image/gif\",\n\t\"image/webp\",\n\t// Documents\n\t\"application/pdf\",\n\t// Text files\n\t\"text/plain\",\n\t\"text/csv\",\n\t\"text/markdown\",\n\t// Archives\n\t\"application/zip\",\n] as const;\n\n/** Human-readable file type descriptions for error messages */\nexport const ALLOWED_FILE_TYPES_DESCRIPTION =\n\t\"images (JPEG, PNG, GIF, WebP), PDF, text files (TXT, CSV, MD), and ZIP archives\";\n\n/** Accept string for file input elements */\nexport const FILE_INPUT_ACCEPT = ALLOWED_MIME_TYPES.join(\",\");\n\n/**\n * Check if a MIME type is allowed for upload\n */\nexport function isAllowedMimeType(mimeType: string): boolean {\n\treturn (ALLOWED_MIME_TYPES as readonly string[]).includes(mimeType);\n}\n\n/**\n * Check if a file is an image based on MIME type\n */\nexport function isImageMimeType(mimeType: string): boolean {\n\treturn mimeType.startsWith(\"image/\");\n}\n\n/**\n * Format file size for display\n */\nexport function formatFileSize(bytes: number): string {\n\tif (bytes < 1024) {\n\t\treturn `${bytes} B`;\n\t}\n\tif (bytes < 1024 * 1024) {\n\t\treturn `${(bytes / 1024).toFixed(1)} KB`;\n\t}\n\treturn `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n}\n\n/**\n * Validate a file against upload constraints\n * @returns null if valid, error message if invalid\n */\nexport function validateFile(file: File): string | null {\n\tif (file.size > MAX_FILE_SIZE) {\n\t\treturn `File \"${file.name}\" exceeds maximum size of ${formatFileSize(MAX_FILE_SIZE)}`;\n\t}\n\n\tif (!isAllowedMimeType(file.type)) {\n\t\treturn `File type \"${file.type || \"unknown\"}\" is not allowed. Allowed types: ${ALLOWED_FILE_TYPES_DESCRIPTION}`;\n\t}\n\n\treturn null;\n}\n\n/**\n * Validate multiple files against upload constraints\n * @returns null if all valid, error message if any invalid\n */\nexport function validateFiles(files: File[]): string | null {\n\tif (files.length > MAX_FILES_PER_MESSAGE) {\n\t\treturn `Cannot attach more than ${MAX_FILES_PER_MESSAGE} files per message`;\n\t}\n\n\tfor (const file of files) {\n\t\tconst error = validateFile(file);\n\t\tif (error) {\n\t\t\treturn error;\n\t\t}\n\t}\n\n\treturn null;\n}\n"],"mappings":";;;;;;AAMA,MAAa,gBAAgB,IAAI,OAAO;;AAGxC,MAAa,wBAAwB;;AAGrC,MAAa,qBAAqB;CAEjC;CACA;CACA;CACA;CAEA;CAEA;CACA;CACA;CAEA;CACA;;AAGD,MAAa,iCACZ;;AAGD,MAAa,oBAAoB,mBAAmB,KAAK,IAAI;;;;AAK7D,SAAgB,kBAAkB,UAA2B;AAC5D,QAAQ,mBAAyC,SAAS,SAAS;;;;;AAMpE,SAAgB,gBAAgB,UAA2B;AAC1D,QAAO,SAAS,WAAW,SAAS;;;;;AAMrC,SAAgB,eAAe,OAAuB;AACrD,KAAI,QAAQ,KACX,QAAO,GAAG,MAAM;AAEjB,KAAI,QAAQ,OAAO,KAClB,QAAO,IAAI,QAAQ,MAAM,QAAQ,EAAE,CAAC;AAErC,QAAO,IAAI,SAAS,OAAO,OAAO,QAAQ,EAAE,CAAC;;;;;;AAO9C,SAAgB,aAAa,MAA2B;AACvD,KAAI,KAAK,OAAO,cACf,QAAO,SAAS,KAAK,KAAK,4BAA4B,eAAe,cAAc;AAGpF,KAAI,CAAC,kBAAkB,KAAK,KAAK,CAChC,QAAO,cAAc,KAAK,QAAQ,UAAU,mCAAmC;AAGhF,QAAO;;;;;;AAOR,SAAgB,cAAc,OAA8B;AAC3D,KAAI,MAAM,SAAS,sBAClB,QAAO,2BAA2B,sBAAsB;AAGzD,MAAK,MAAM,QAAQ,OAAO;EACzB,MAAM,QAAQ,aAAa,KAAK;AAChC,MAAI,MACH,QAAO;;AAIT,QAAO"}

package/upload.d.ts

@@ -0,0 +1,47 @@
+import { z } from "@hono/zod-openapi";
+
+//#region ../types/src/api/upload.d.ts
+
+declare const generateUploadUrlRequestSchema: z.ZodObject<{
+  contentType: z.ZodString;
+  websiteId: z.ZodString;
+  scope: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"conversation">;
+    conversationId: z.ZodString;
+    organizationId: z.ZodString;
+    websiteId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"user">;
+    userId: z.ZodString;
+    organizationId: z.ZodString;
+    websiteId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"contact">;
+    contactId: z.ZodString;
+    organizationId: z.ZodString;
+    websiteId: z.ZodString;
+  }, z.core.$strip>, z.ZodObject<{
+    type: z.ZodLiteral<"visitor">;
+    visitorId: z.ZodString;
+    organizationId: z.ZodString;
+    websiteId: z.ZodString;
+  }, z.core.$strip>], "type">;
+  path: z.ZodOptional<z.ZodString>;
+  fileName: z.ZodOptional<z.ZodString>;
+  fileExtension: z.ZodOptional<z.ZodString>;
+  useCdn: z.ZodOptional<z.ZodBoolean>;
+  expiresInSeconds: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type GenerateUploadUrlRequest = z.infer<typeof generateUploadUrlRequestSchema>;
+declare const generateUploadUrlResponseSchema: z.ZodObject<{
+  uploadUrl: z.ZodURL;
+  key: z.ZodString;
+  bucket: z.ZodString;
+  expiresAt: z.ZodString;
+  contentType: z.ZodString;
+  publicUrl: z.ZodURL;
+}, z.core.$strip>;
+type GenerateUploadUrlResponse = z.infer<typeof generateUploadUrlResponseSchema>;
+//#endregion
+export { GenerateUploadUrlRequest, GenerateUploadUrlResponse };
+//# sourceMappingURL=upload.d.ts.map

package/upload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upload.d.ts","names":[],"sources":["../../types/src/api/upload.ts"],"sourcesContent":[],"mappings":";;;;AAkMY,cAvEC,8BAwEL,EAxEmC,CAAA,CAAA,SAwEnC,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAxCI,wBAAA,GAA2B,CAAA,CAAE,aACjC;cAGK,iCAA+B,CAAA,CAAA;;;;;;;;KAmChC,yBAAA,GAA4B,CAAA,CAAE,aAClC"}