@morscherlab/mint-sdk 1.0.41 → 1.0.42

package/dist/composables/index.d.ts

@@ -52,4 +52,4 @@ export { getBioTemplateComponentProps, getBioTemplateComponentBindings, toBioTem
 export { useBioTemplateWorkspace, type BioTemplateRendererBinding, type BioTemplateWorkspaceBindings, type BioTemplateWorkspaceTarget, type UseBioTemplateWorkspaceReturn, } from './useBioTemplateWorkspace';
 export { useBioTemplatePresetWorkspace, type BioTemplatePresetWorkspaceBindings, type UseBioTemplatePresetWorkspaceOptions, type UseBioTemplatePresetWorkspaceReturn, } from './useBioTemplatePresetWorkspace';
 export { useBioTemplatePackWorkspace, type UseBioTemplatePackWorkspaceOptions, type UseBioTemplatePackWorkspaceReturn, } from './useBioTemplatePackWorkspace';
-export { buildPluginEndpointUrl, createPluginClient, downloadBlob, downloadPluginEndpoint, getPluginPageSelectorItems, pluginFormDataFromPayload, resolvePluginBaseUrl, uploadPluginEndpoint, usePluginClient, usePluginSettings, useCurrentExperiment, type BuildPluginEndpointUrlOptions, type DownloadBlobOptions, type DownloadPluginEndpointOptions, type PluginContract, type PluginEndpointContract, type PluginEndpointDefinition, type PluginHttpMethod, type PluginNavItemContract, type PluginEndpointRequestOptions, type PluginFormDataPayload, type PluginFormDataValue, type CreatePluginClientOptions, type UseCurrentExperimentOptions, type UseCurrentExperimentReturn, } from './usePluginClient';
+export { buildPluginEndpointUrl, createPluginClient, downloadBlob, downloadPluginEndpoint, getPluginPageSelectorItems, pluginFormDataFromPayload, resolvePluginBaseUrl, uploadPluginEndpoint, usePluginClient, usePluginEventStream, usePluginSettings, useCurrentExperiment, type BuildPluginEndpointUrlOptions, type DownloadBlobOptions, type DownloadPluginEndpointOptions, type PluginContract, type PluginEndpointContract, type PluginEndpointDefinition, type PluginHttpMethod, type PluginNavItemContract, type PluginEndpointRequestOptions, type PluginEventStreamMessage, type PluginEventStreamOptions, type PluginFormDataPayload, type PluginFormDataValue, type CreatePluginClientOptions, type UseCurrentExperimentOptions, type UseCurrentExperimentReturn, type UsePluginEventStreamReturn, type UsePluginSettingsOptions, type UsePluginSettingsReturn, } from './usePluginClient';

package/dist/composables/index.js

@@ -6,5 +6,5 @@ import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as use
 import { a as SORT_OPTIONS, c as formatExperimentStatus, i as EXPERIMENT_STATUS_VARIANT_MAP, l as getExperimentStatusVariant, n as EXPERIMENT_STATUS_LABELS, o as datePresetToISO, r as EXPERIMENT_STATUS_OPTIONS, s as formatExperimentDate, t as DATE_PRESET_OPTIONS, u as resolveExperimentCode } from "../experiment-utils-Bfa7CwPU.js";
 import { i as useApi, n as useDebouncedWatch, r as useRequestSyncState, t as useExperimentSelector } from "../useExperimentSelector-DdCy5VNv.js";
 import { B as toBioTemplateComponentProps, H as toBioTemplateComponentPropsById, L as toBioTemplateComponentBindings, P as getBioTemplateComponentBindings, R as toBioTemplateComponentBindingsById, l as requireBioTemplateControlSchema, o as getBioTemplateControlSchema } from "../templates-CNbPQNID.js";
-import { A as useCommandHistory, C as parseDelimitedText, D as createPluginResourceClient, E as validateImportFile, F as useAuth, M as useAsync, N as useAsyncBatch, O as useResourceCrud, P as usePasskey, S as detectDelimiter, T as useFileImport, _ as useWellPlateAdapter, a as pluginFormDataFromPayload, b as wellIdToCoordinate, c as usePluginClient, d as resolvePluginBaseUrl, f as runWellPlateValidation, g as createWellPlateWells, h as createRowConditions, i as getPluginPageSelectorItems, j as usePluginConfig, k as useOptimisticMutation, l as usePluginSettings, m as createColumnConditions, n as downloadBlob, o as uploadPluginEndpoint, p as useWellPlateValidation, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as buildPluginEndpointUrl, v as coordinateToWellId, w as readFileAsText, x as wellIdsInRectangle, y as useWellPainting } from "../composables-DrE6OcZZ.js";
-export { APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_MOBILE_VIEWPORT_QUERY, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildPluginEndpointUrl, candidateMatchesSearch, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, coordinateToWellId, createColumnConditions, createPluginClient, createPluginResourceClient, createRowConditions, createWellPlateWells, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, detectDelimiter, downloadBlob, downloadPluginEndpoint, durationMinutes, evaluateCondition, extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getPluginPageSelectorItems, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseDelimitedText, parseTime, pluginFormDataFromPayload, rangesOverlap, readFileAsText, requireBioTemplateControlSchema, resolveExperimentCode, resolvePluginBaseUrl, runWellPlateValidation, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, unwrapExperimentDesignData, uploadPluginEndpoint, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useCommandHistory, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSamples, useExperimentSave, useExperimentSelector, useFileImport, useForm, useFormBuilder, useGroupAssignment, useListSelection, useMobileSupportGate, useOptimisticMutation, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginSettings, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useResourceCrud, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPainting, useWellPlateAdapter, useWellPlateEditor, useWellPlateValidation, validateImportFile, wellIdToCoordinate, wellIdsInRectangle };
+import { A as useOptimisticMutation, C as detectDelimiter, D as validateImportFile, E as useFileImport, F as usePasskey, I as useAuth, M as usePluginConfig, N as useAsync, O as createPluginResourceClient, P as useAsyncBatch, S as wellIdsInRectangle, T as readFileAsText, _ as createWellPlateWells, a as pluginFormDataFromPayload, b as useWellPainting, c as usePluginClient, d as buildPluginEndpointUrl, f as resolvePluginBaseUrl, g as createRowConditions, h as createColumnConditions, i as getPluginPageSelectorItems, j as useCommandHistory, k as useResourceCrud, l as usePluginEventStream, m as useWellPlateValidation, n as downloadBlob, o as uploadPluginEndpoint, p as runWellPlateValidation, r as downloadPluginEndpoint, s as useCurrentExperiment, t as createPluginClient, u as usePluginSettings, v as useWellPlateAdapter, w as parseDelimitedText, x as wellIdToCoordinate, y as coordinateToWellId } from "../composables-C_hPF0Gn.js";
+export { APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, DATE_PRESET_OPTIONS, DEFAULT_COLORS, DEFAULT_MOBILE_VIEWPORT_QUERY, DEFAULT_PRESETS, DEFAULT_UNITS, EXPERIMENT_STATUS_LABELS, EXPERIMENT_STATUS_OPTIONS, EXPERIMENT_STATUS_VARIANT_MAP, SORT_OPTIONS, addMinutes, buildPluginEndpointUrl, candidateMatchesSearch, compareSortValues, compareTime, controlValuesToComponentBindings, controlValuesToComponentBindingsById, controlValuesToComponentProps, controlsToFormSchema, controlsToSectionFormSchema, controlsToSectionFormSchemas, controlsToSettingsSchema, controlsToSidebarPanels, controlsToTopBarSettingsConfig, controlsToViewIds, controlsToViewItems, coordinateToWellId, createColumnConditions, createPluginClient, createPluginResourceClient, createRowConditions, createWellPlateWells, datePresetToISO, defineControlComponentBindings, defineControlModel, defineControls, defineDoseCalculatorControlProps, defineDoseDesignControlModel, defineWellPlateControlProps, defineWellPlateDoseComponentBindings, defineWellPlateDoseControlProps, detectDelimiter, downloadBlob, downloadPluginEndpoint, durationMinutes, evaluateCondition, extractSampleNamesFromDesignData, extractSampleOptionsFromDesignData, extractSamplesFromDesignData, findAvailableSlots, findNearestTimeSlotIndex, formatDuration, formatExperimentDate, formatExperimentStatus, formatTime, formatTimeSlot, fromMinutes, generateDilutionSeries, generateTimeSlots, getBioTemplateComponentBindings, getBioTemplateComponentProps, getBioTemplateControlSchema, getControlDefaults, getDefaultControlView, getExperimentStatusVariant, getFieldRegistryEntry, getPluginPageSelectorItems, getTypeDefault, isTimeInRange, normalizeSearchQuery, parseDelimitedText, parseTime, pluginFormDataFromPayload, rangesOverlap, readFileAsText, requireBioTemplateControlSchema, resolveExperimentCode, resolvePluginBaseUrl, runWellPlateValidation, snapToSlot, toBioTemplateComponentBindings, toBioTemplateComponentBindingsById, toBioTemplateComponentProps, toBioTemplateComponentPropsByComponent, toBioTemplateComponentPropsById, toMinutes, unwrapExperimentDesignData, uploadPluginEndpoint, useApi, useAppExperiment, useAsync, useAsyncBatch, useAuth, useAutoGroup, useBioTemplateComponents, useBioTemplateControls, useBioTemplatePackWorkspace, useBioTemplatePresetWorkspace, useBioTemplateWorkspace, useChemicalFormula, useCommandHistory, useConcentrationUnits, useControlSchema, useControlWorkspace, useCurrentExperiment, useDebouncedWatch, useDoseCalculator, useEventListener, useExpansionSet, useExperimentData, useExperimentSamples, useExperimentSave, useExperimentSelector, useFileImport, useForm, useFormBuilder, useGroupAssignment, useListSelection, useMobileSupportGate, useOptimisticMutation, usePasskey, usePlatformContext, usePluginClient, usePluginConfig, usePluginEventStream, usePluginSettings, useProtocolTemplates, useRackEditor, useReagentSeries, useRequestSyncState, useResourceCrud, useSampleGroups, useScheduleDrag, useSelectionLimit, useSequenceUtils, useSortedItems, useTemplateCollection, useTextSearch, useTheme, useTimeUtils, useToast, useWellPainting, useWellPlateAdapter, useWellPlateEditor, useWellPlateValidation, validateImportFile, wellIdToCoordinate, wellIdsInRectangle };

package/dist/composables/usePluginClient.d.ts

@@ -1,5 +1,5 @@
 import { ComputedRef, Ref } from 'vue';
-import { ExperimentSummary, PageSelectorItem } from '../types';
+import { ExperimentSummary, PageSelectorItem, SettingsModalSchema, TopBarSettingsConfig } from '../types';
 export { buildPluginEndpointUrl, resolvePluginBaseUrl, } from './pluginEndpointBuilder';
 export type PluginHttpMethod = 'get' | 'post' | 'put' | 'patch' | 'delete';
 export interface PluginEndpointContract {
@@ -44,6 +44,10 @@ export interface PluginContract {
         analysisResultReaders?: string[];
         capabilities?: Record<string, unknown>;
     };
+    settings?: {
+        modelName?: string | null;
+        schema?: SettingsModalSchema | null;
+    };
     endpoints: PluginEndpointContract[];
     hash: string;
 }
@@ -84,6 +88,78 @@ export interface DownloadBlobOptions {
     /** Delay before revoking the object URL after a browser download is triggered. */
     revokeObjectUrlDelayMs?: number;
 }
+export type PluginSettingsValues<TSettings> = Partial<TSettings> & Record<string, unknown>;
+export interface UsePluginSettingsOptions {
+    /** Plugin name for platform persistence. Defaults to the integrated platform plugin name. */
+    pluginName?: string;
+    /** Plugin API base URL for standalone/local settings routes. Generated clients pass pluginApiPrefix. */
+    apiBaseUrl?: string;
+    /** Platform API base URL for /plugins/{name}/config. Defaults to the injected platform API URL. */
+    platformApiBaseUrl?: string;
+    /** SettingsModal schema generated from the backend settings_model. */
+    schema?: SettingsModalSchema | null;
+    /** SettingsModal title when using settingsConfig. */
+    title?: string;
+    /** Whether SettingsModal should include SDK appearance controls. */
+    showAppearance?: boolean;
+    /** Load persisted values on component mount. */
+    loadOnMount?: boolean;
+}
+export interface UsePluginSettingsReturn<TSettings = Record<string, unknown>> {
+    /** Current typed settings values. */
+    settings: ComputedRef<PluginSettingsValues<TSettings>>;
+    /** Editable settings values for SettingsModal. */
+    values: Ref<PluginSettingsValues<TSettings>>;
+    /** Alias for values, kept for callers that think in platform config terms. */
+    config: Ref<PluginSettingsValues<TSettings>>;
+    /** Ready-to-pass AppTopBar/PluginWorkspaceView settingsConfig. */
+    settingsConfig: ComputedRef<TopBarSettingsConfig>;
+    isLoading: Ref<boolean>;
+    isSaving: Ref<boolean>;
+    error: Ref<string | null>;
+    lastLoadedAt: Ref<Date | null>;
+    lastSavedAt: Ref<Date | null>;
+    isDirty: ComputedRef<boolean>;
+    setValues: (values: Record<string, unknown>) => void;
+    load: () => Promise<void>;
+    save: (values?: Record<string, unknown>) => Promise<boolean>;
+    reset: () => void;
+}
+export interface PluginEventStreamMessage<TData = string> {
+    event: string;
+    data: TData;
+    id?: string;
+    retry?: number;
+    raw: string;
+}
+export interface PluginEventStreamOptions<TData = string> {
+    /** Override the generated or platform-injected API base URL. */
+    baseUrl?: string;
+    /** Start the stream immediately. Defaults to true. */
+    immediate?: boolean;
+    /** Reconnect after errors or server closes. Defaults to true. */
+    reconnect?: boolean;
+    /** Delay before reconnecting after a stream failure or close. Defaults to 2000ms. */
+    reconnectDelayMs?: number;
+    /** Parse `data:` as JSON before calling onMessage. */
+    parseJson?: boolean;
+    /** Fetch credentials mode. Defaults to same-origin. */
+    credentials?: RequestCredentials;
+    /** Extra request headers. Authorization is injected unless already supplied. */
+    headers?: Record<string, string>;
+    onOpen?: () => void;
+    onMessage?: (message: PluginEventStreamMessage<TData>) => void;
+    onError?: (error: unknown) => void;
+}
+export interface UsePluginEventStreamReturn<TData = string> {
+    isConnected: Ref<boolean>;
+    isConnecting: Ref<boolean>;
+    error: Ref<string | null>;
+    lastMessage: Ref<PluginEventStreamMessage<TData> | null>;
+    lastEventId: Ref<string | null>;
+    start: () => void;
+    stop: () => void;
+}
 export type PluginFormDataValue = string | number | boolean | Blob | null | undefined | Record<string, unknown>;
 export type PluginFormDataPayload = Record<string, PluginFormDataValue | PluginFormDataValue[]>;
 export interface UseCurrentExperimentOptions {
@@ -126,9 +202,10 @@ export declare function uploadPluginEndpoint<TResponse = unknown>(contract: Plug
 export declare function downloadPluginEndpoint(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: DownloadPluginEndpointOptions): Promise<Blob>;
 /** Return a generated plugin client from setup code with a stable typed identity. */
 export declare function usePluginClient<TClient>(client: TClient): TClient;
-/** Read plugin settings exposed through the platform context. */
-export declare function usePluginSettings<TSettings = Record<string, unknown>>(): {
-    settings: ComputedRef<TSettings | undefined>;
-};
+/** Load, edit, and persist plugin settings from platform config or the plugin-local settings router. */
+export declare function usePluginSettings<TSettings = Record<string, unknown>>(options?: UsePluginSettingsOptions | string): UsePluginSettingsReturn<TSettings>;
+/** Consume a generated plugin SSE endpoint with auth headers, reconnect, and teardown. */
+export declare function usePluginEventStream<TData = string>(contract: PluginContract, endpoint: PluginEndpointDefinition, options?: PluginEventStreamOptions<TData>): UsePluginEventStreamReturn<TData>;
+export declare function usePluginEventStream<TData = string>(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: PluginEventStreamOptions<TData>): UsePluginEventStreamReturn<TData>;
 /** Read and optionally load the current platform experiment for integrated plugin views. */
 export declare function useCurrentExperiment<TExperiment = ExperimentSummary>(options?: UseCurrentExperimentOptions): UseCurrentExperimentReturn<TExperiment>;

package/dist/{composables-DrE6OcZZ.js → composables-C_hPF0Gn.js}

@@ -1545,8 +1545,7 @@ function getPluginPageSelectorItems(contract) {
 		id: item.id || pluginPageIdFromPath(item.path, index),
 		label: item.label,
 		to: normalizePluginNavPath(item.path),
-		icon: item.icon || pluginIcon || void 0,
-		hint: item.description || contract.plugin.name
+		icon: item.icon || pluginIcon || void 0
 	}));
 }
 /** Create a typed plugin API client from a generated MINT plugin contract. */
@@ -1605,10 +1604,258 @@ async function downloadPluginEndpoint(contract, endpoint, payload, options = {})
 function usePluginClient(client) {
 	return client;
 }
-/** Read plugin settings exposed through the platform context. */
-function usePluginSettings() {
-	const { plugin } = usePlatformContext();
-	return { settings: computed(() => plugin.value?.settings) };
+function normalizePluginSettingsOptions(options = {}) {
+	return typeof options === "string" ? { pluginName: options } : options;
+}
+function cloneRecord(value) {
+	return { ...value };
+}
+function responseSettingsPayload(response) {
+	if (!response || typeof response !== "object") return {};
+	const data = response;
+	if (data.config && typeof data.config === "object") return cloneRecord(data.config);
+	if (data.settings && typeof data.settings === "object") return cloneRecord(data.settings);
+	return {};
+}
+/** Load, edit, and persist plugin settings from platform config or the plugin-local settings router. */
+function usePluginSettings(options = {}) {
+	const resolvedOptions = normalizePluginSettingsOptions(options);
+	const injectedContext = getInjectedPlatformContext();
+	const { plugin, isIntegrated } = usePlatformContext();
+	const platformApi = useApi({ baseUrl: resolvedOptions.platformApiBaseUrl ?? injectedContext?.platformApiUrl });
+	const pluginApi = useApi({ baseUrl: resolvedOptions.apiBaseUrl ?? injectedContext?.plugin?.api_prefix });
+	const values = shallowRef({});
+	const savedValues = shallowRef({});
+	const request = useRequestSyncState("Plugin settings request failed.");
+	const isLoading = ref(false);
+	const isSaving = ref(false);
+	const resolvedPluginName = computed(() => resolvedOptions.pluginName ?? plugin.value?.name ?? injectedContext?.plugin?.name ?? "");
+	const usesPlatformConfig = computed(() => Boolean((isIntegrated.value || injectedContext?.isIntegrated) && resolvedPluginName.value));
+	const settings = computed(() => values.value);
+	const isDirty = computed(() => JSON.stringify(values.value) !== JSON.stringify(savedValues.value));
+	const settingsConfig = computed(() => ({
+		title: resolvedOptions.title,
+		schema: resolvedOptions.schema ?? void 0,
+		showAppearance: resolvedOptions.showAppearance,
+		values: values.value
+	}));
+	function setValues(nextValues) {
+		values.value = cloneRecord(nextValues);
+	}
+	function applyLoaded(nextValues) {
+		const cloned = cloneRecord(nextValues);
+		values.value = cloned;
+		savedValues.value = cloneRecord(cloned);
+	}
+	async function load() {
+		isLoading.value = true;
+		try {
+			applyLoaded(responseSettingsPayload(usesPlatformConfig.value ? await request.run(() => platformApi.get(`/plugins/${encodeURIComponent(resolvedPluginName.value)}/config`), {
+				success: "load",
+				errorMessage: "Failed to load plugin settings"
+			}) : await request.run(() => pluginApi.get("/settings"), {
+				success: "load",
+				errorMessage: "Failed to load plugin settings"
+			})));
+		} catch {} finally {
+			isLoading.value = false;
+		}
+	}
+	async function save(nextValues) {
+		if (nextValues) setValues(nextValues);
+		isSaving.value = true;
+		try {
+			const payload = cloneRecord(values.value);
+			applyLoaded(responseSettingsPayload(usesPlatformConfig.value ? await request.run(() => platformApi.patch(`/plugins/${encodeURIComponent(resolvedPluginName.value)}/config`, { config: payload }), {
+				success: "save",
+				errorMessage: "Failed to save plugin settings"
+			}) : await request.run(() => pluginApi.put("/settings", payload), {
+				success: "save",
+				errorMessage: "Failed to save plugin settings"
+			})));
+			return true;
+		} catch {
+			return false;
+		} finally {
+			isSaving.value = false;
+		}
+	}
+	function reset() {
+		values.value = cloneRecord(savedValues.value);
+		request.clearError();
+	}
+	onMounted(() => {
+		if (resolvedOptions.loadOnMount !== false) load();
+	});
+	return {
+		settings,
+		values,
+		config: values,
+		settingsConfig,
+		isLoading,
+		isSaving,
+		error: request.error,
+		lastLoadedAt: request.lastLoadedAt,
+		lastSavedAt: request.lastSavedAt,
+		isDirty,
+		setValues,
+		load,
+		save,
+		reset
+	};
+}
+function streamHeaders(options) {
+	const headers = new Headers(options.headers);
+	const authStore = useAuthStore();
+	if (!authStore.isInitialized) authStore.initialize();
+	if (authStore.token && !headers.has("Authorization")) headers.set("Authorization", `Bearer ${authStore.token}`);
+	headers.set("Accept", "text/event-stream");
+	return headers;
+}
+function parseSseEvent(block, parseJson) {
+	let event = "message";
+	let id;
+	let retry;
+	const dataLines = [];
+	for (const line of block.split(/\r?\n/)) {
+		if (!line || line.startsWith(":")) continue;
+		const separator = line.indexOf(":");
+		const field = separator === -1 ? line : line.slice(0, separator);
+		const value = separator === -1 ? "" : line.slice(separator + 1).replace(/^ /, "");
+		if (field === "event") event = value || "message";
+		if (field === "data") dataLines.push(value);
+		if (field === "id") id = value;
+		if (field === "retry") {
+			const parsed = Number(value);
+			if (Number.isFinite(parsed)) retry = parsed;
+		}
+	}
+	if (!dataLines.length && !id && retry === void 0) return null;
+	const data = dataLines.join("\n");
+	return {
+		event,
+		data: parseJson && data ? JSON.parse(data) : data,
+		id,
+		retry,
+		raw: block
+	};
+}
+function looksLikeEventStreamOptions(value) {
+	if (!value || typeof value !== "object") return false;
+	const candidate = value;
+	return [
+		"baseUrl",
+		"immediate",
+		"reconnect",
+		"reconnectDelayMs",
+		"parseJson",
+		"credentials",
+		"headers",
+		"onOpen",
+		"onMessage",
+		"onError"
+	].some((key) => key in candidate);
+}
+function usePluginEventStream(contract, endpoint, payloadOrOptions, maybeOptions) {
+	const payload = maybeOptions === void 0 && looksLikeEventStreamOptions(payloadOrOptions) ? void 0 : payloadOrOptions;
+	const options = maybeOptions === void 0 && looksLikeEventStreamOptions(payloadOrOptions) ? payloadOrOptions : maybeOptions ?? {};
+	const isConnected = ref(false);
+	const isConnecting = ref(false);
+	const error = ref(null);
+	const lastMessage = shallowRef(null);
+	const lastEventId = ref(null);
+	let controller = null;
+	let reconnectTimer = null;
+	let stopped = true;
+	function clearReconnectTimer() {
+		if (reconnectTimer !== null) {
+			clearTimeout(reconnectTimer);
+			reconnectTimer = null;
+		}
+	}
+	function scheduleReconnect() {
+		if (stopped || options.reconnect === false) return;
+		clearReconnectTimer();
+		reconnectTimer = setTimeout(() => {
+			connect();
+		}, options.reconnectDelayMs ?? 2e3);
+	}
+	async function connect() {
+		if (endpoint.method !== "get") throw new Error(`[MINT SDK] Plugin event streams must use GET; got ${endpoint.method}`);
+		if (typeof fetch !== "function") throw new Error("[MINT SDK] fetch is required for plugin event streams.");
+		controller?.abort();
+		controller = new AbortController();
+		isConnecting.value = true;
+		error.value = null;
+		try {
+			const url = buildPluginEndpointUrl(contract, endpoint, payload, { baseUrl: options.baseUrl });
+			const response = await fetch(url, {
+				method: "GET",
+				headers: streamHeaders(options),
+				credentials: options.credentials ?? "same-origin",
+				signal: controller.signal
+			});
+			if (!response.ok) throw new Error(`Plugin event stream failed with HTTP ${response.status}`);
+			if (!response.body) throw new Error("Plugin event stream response did not include a readable body.");
+			options.onOpen?.();
+			isConnected.value = true;
+			const reader = response.body.getReader();
+			const decoder = new TextDecoder();
+			let buffer = "";
+			for (;;) {
+				const { value, done } = await reader.read();
+				if (done) break;
+				buffer += decoder.decode(value, { stream: true });
+				let boundary = buffer.search(/\r?\n\r?\n/);
+				while (boundary !== -1) {
+					const block = buffer.slice(0, boundary);
+					buffer = buffer.slice(buffer[boundary] === "\r" ? boundary + 4 : boundary + 2);
+					const message = parseSseEvent(block, options.parseJson === true);
+					if (message) {
+						lastMessage.value = message;
+						if (message.id !== void 0) lastEventId.value = message.id;
+						if (message.retry !== void 0) options.reconnectDelayMs = message.retry;
+						options.onMessage?.(message);
+					}
+					boundary = buffer.search(/\r?\n\r?\n/);
+				}
+			}
+		} catch (err) {
+			if (!stopped && !(err instanceof DOMException && err.name === "AbortError")) {
+				error.value = err instanceof Error ? err.message : "Plugin event stream failed";
+				options.onError?.(err);
+			}
+		} finally {
+			isConnecting.value = false;
+			isConnected.value = false;
+			scheduleReconnect();
+		}
+	}
+	function start() {
+		stopped = false;
+		clearReconnectTimer();
+		connect();
+	}
+	function stop() {
+		stopped = true;
+		clearReconnectTimer();
+		controller?.abort();
+		controller = null;
+		isConnecting.value = false;
+		isConnected.value = false;
+	}
+	if (options.immediate !== false && typeof window === "undefined") onMounted(start);
+	onUnmounted(stop);
+	if (options.immediate !== false && typeof window !== "undefined") start();
+	return {
+		isConnected,
+		isConnecting,
+		error,
+		lastMessage,
+		lastEventId,
+		start,
+		stop
+	};
 }
 /** Read and optionally load the current platform experiment for integrated plugin views. */
 function useCurrentExperiment(options = {}) {
@@ -1668,6 +1915,6 @@ function useCurrentExperiment(options = {}) {
 	};
 }
 //#endregion
-export { useCommandHistory as A, parseDelimitedText as C, createPluginResourceClient as D, validateImportFile as E, useAuth as F, useAsync as M, useAsyncBatch as N, useResourceCrud as O, usePasskey as P, detectDelimiter as S, useFileImport as T, useWellPlateAdapter as _, pluginFormDataFromPayload as a, wellIdToCoordinate as b, usePluginClient as c, resolvePluginBaseUrl as d, runWellPlateValidation as f, createWellPlateWells as g, createRowConditions as h, getPluginPageSelectorItems as i, usePluginConfig as j, useOptimisticMutation as k, usePluginSettings as l, createColumnConditions as m, downloadBlob as n, uploadPluginEndpoint as o, useWellPlateValidation as p, downloadPluginEndpoint as r, useCurrentExperiment as s, createPluginClient as t, buildPluginEndpointUrl as u, coordinateToWellId as v, readFileAsText as w, wellIdsInRectangle as x, useWellPainting as y };
+export { useOptimisticMutation as A, detectDelimiter as C, validateImportFile as D, useFileImport as E, usePasskey as F, useAuth as I, usePluginConfig as M, useAsync as N, createPluginResourceClient as O, useAsyncBatch as P, wellIdsInRectangle as S, readFileAsText as T, createWellPlateWells as _, pluginFormDataFromPayload as a, useWellPainting as b, usePluginClient as c, buildPluginEndpointUrl as d, resolvePluginBaseUrl as f, createRowConditions as g, createColumnConditions as h, getPluginPageSelectorItems as i, useCommandHistory as j, useResourceCrud as k, usePluginEventStream as l, useWellPlateValidation as m, downloadBlob as n, uploadPluginEndpoint as o, runWellPlateValidation as p, downloadPluginEndpoint as r, useCurrentExperiment as s, createPluginClient as t, usePluginSettings as u, useWellPlateAdapter as v, parseDelimitedText as w, wellIdToCoordinate as x, coordinateToWellId as y };
 
-//# sourceMappingURL=composables-DrE6OcZZ.js.map
+//# sourceMappingURL=composables-C_hPF0Gn.js.map