@morscherlab/mint-sdk 1.0.54 → 1.0.55

package/dist/composables/index.d.ts

@@ -1,4 +1,4 @@
-export { useApi, type ApiClientOptions } from './useApi';
+export { AuthenticationRequiredError, useApi, type ApiClientOptions, type UseApiReturn, } from './useApi';
 export { useAuth } from './useAuth';
 export { usePasskey } from './usePasskey';
 export { useTheme } from './useTheme';
@@ -53,5 +53,5 @@ 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, 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';
+export { buildPluginEndpointUrl, createPluginClient, downloadBlob, downloadPluginEndpoint, getPluginPageSelectorItems, pluginFormDataFromPayload, resolvePluginBaseUrl, uploadPluginEndpoint, usePluginClient, usePluginEventStream, usePluginSettings, useCurrentExperiment, type BuildPluginEndpointUrlOptions, type DownloadBlobOptions, type DownloadPluginEndpointOptions, type PluginContract, type PluginClientRequestOptions, 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';
 export { useJobsStatusTray, type JobsStatusTrayAdapter, type JobsStatusTrayTab, type JobStreamMessage, type UseJobsStatusTrayOptions, type UseJobsStatusTrayReturn, } from './useJobsStatusTray';

package/dist/composables/index.js

@@ -1,10 +1,10 @@
 import "../BaseSelect-ekgr9fDo.js";
 import { $ as parseTime, A as useConcentrationUnits, C as controlsToViewIds, D as getTypeDefault, E as getFieldRegistryEntry, F as ATOMIC_WEIGHTS, G as findAvailableSlots, H as addMinutes, I as useChemicalFormula, J as formatTime, K as findNearestTimeSlotIndex, N as useSequenceUtils, Q as isTimeInRange, S as controlsToTopBarSettingsConfig, T as getDefaultControlView, U as compareTime, W as durationMinutes, X as fromMinutes, Y as formatTimeSlot, Z as generateTimeSlots, _ as controlsToFormSchema, a as defineDoseCalculatorControlProps, b as controlsToSettingsSchema, c as defineWellPlateDoseComponentBindings, d as defineControlModel, et as rangesOverlap, h as controlValuesToComponentProps, i as useControlSchema, l as defineWellPlateDoseControlProps, m as controlValuesToComponentBindingsById, n as defineControls, nt as toMinutes, o as defineDoseDesignControlModel, ot as useListSelection, p as controlValuesToComponentBindings, q as formatDuration, r as getControlDefaults, rt as useTimeUtils, s as defineWellPlateControlProps, st as useSelectionLimit, t as defineControlComponentBindings, tt as snapToSlot, u as useControlWorkspace, v as controlsToSectionFormSchema, w as controlsToViewItems, x as controlsToSidebarPanels, y as controlsToSectionFormSchemas } from "../useControlSchema-BZNdalmL.js";
 import { t as useEventListener } from "../useEventListener-CfVkP9Xz.js";
-import { $ as useTheme, A as useExpansionSet, B as extractSamplesFromDesignData, C as useExperimentSave, E as useExperimentData, F as detectDelimiter, G as unwrapExperimentDesignData, I as parseDelimitedText, J as useDoseCalculator, K as DEFAULT_COLORS, L as readFileAsText, Q as useAppExperiment, R as useFileImport, S as useTemplateCollection, T as useExperimentSamples, U as extractSampleNamesFromDesignData, V as useAutoGroup, W as extractSampleOptionsFromDesignData, X as useMobileSupportGate, Y as DEFAULT_MOBILE_VIEWPORT_QUERY, Z as APP_EXPERIMENT_KEY, _ as useBioTemplateWorkspace, at as useSortedItems, b as useBioTemplateComponents, c as useProtocolTemplates, d as generateDilutionSeries, et as useToast, f as useReagentSeries, g as useBioTemplatePackWorkspace, h as useBioTemplatePresetWorkspace, it as compareSortValues, j as useSampleGroups, l as DEFAULT_PRESETS, m as useRackEditor, nt as normalizeSearchQuery, p as useGroupAssignment, q as useWellPlateEditor, rt as useTextSearch, t as useJobsStatusTray, tt as candidateMatchesSearch, u as DEFAULT_UNITS, v as getBioTemplateComponentProps, w as useScheduleDrag, x as useBioTemplateControls, y as toBioTemplateComponentPropsByComponent, z as validateImportFile } from "../useJobsStatusTray-DAH999_N.js";
+import { $ as useTheme, A as useExpansionSet, B as extractSamplesFromDesignData, C as useExperimentSave, E as useExperimentData, F as detectDelimiter, G as unwrapExperimentDesignData, I as parseDelimitedText, J as useDoseCalculator, K as DEFAULT_COLORS, L as readFileAsText, Q as useAppExperiment, R as useFileImport, S as useTemplateCollection, T as useExperimentSamples, U as extractSampleNamesFromDesignData, V as useAutoGroup, W as extractSampleOptionsFromDesignData, X as useMobileSupportGate, Y as DEFAULT_MOBILE_VIEWPORT_QUERY, Z as APP_EXPERIMENT_KEY, _ as useBioTemplateWorkspace, at as useSortedItems, b as useBioTemplateComponents, c as useProtocolTemplates, d as generateDilutionSeries, et as useToast, f as useReagentSeries, g as useBioTemplatePackWorkspace, h as useBioTemplatePresetWorkspace, it as compareSortValues, j as useSampleGroups, l as DEFAULT_PRESETS, m as useRackEditor, nt as normalizeSearchQuery, p as useGroupAssignment, q as useWellPlateEditor, rt as useTextSearch, t as useJobsStatusTray, tt as candidateMatchesSearch, u as DEFAULT_UNITS, v as getBioTemplateComponentProps, w as useScheduleDrag, x as useBioTemplateControls, y as toBioTemplateComponentPropsByComponent, z as validateImportFile } from "../useJobsStatusTray-CVecN6Ao.js";
 import { i as usePlatformContext, n as evaluateCondition, r as useForm, t as useFormBuilder } from "../useFormBuilder-DKekvXRs.js";
 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 { i as AuthenticationRequiredError, n as useDebouncedWatch, o as useApi, r as useRequestSyncState, t as useExperimentSelector } from "../useExperimentSelector-DRbj6vse.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 resolvePluginFrontendBase, C as createPluginResourceClient, D as usePluginConfig, E as useCommandHistory, M as useAuth, O as useAsync, S as wellIdsInRectangle, T as useOptimisticMutation, _ 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 usePasskey, k as useAsyncBatch, 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 useResourceCrud, x as wellIdToCoordinate, y as coordinateToWellId } from "../composables-GosFS8fM.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, resolvePluginFrontendBase, 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, useJobsStatusTray, 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 };
+import { A as resolvePluginFrontendBase, C as createPluginResourceClient, D as usePluginConfig, E as useCommandHistory, M as useAuth, O as useAsync, S as wellIdsInRectangle, T as useOptimisticMutation, _ 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 usePasskey, k as useAsyncBatch, 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 useResourceCrud, x as wellIdToCoordinate, y as coordinateToWellId } from "../composables-TpXyhRZZ.js";
+export { APP_EXPERIMENT_KEY, ATOMIC_WEIGHTS, AuthenticationRequiredError, 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, resolvePluginFrontendBase, 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, useJobsStatusTray, 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/useApi.d.ts

@@ -1,4 +1,13 @@
 import { AxiosInstance, AxiosRequestConfig } from 'axios';
+/** Raised when an authenticated SDK request is rejected because the login is no longer valid. */
+export declare class AuthenticationRequiredError extends Error {
+    readonly cause?: unknown | undefined;
+    readonly code = "AUTHENTICATION_REQUIRED";
+    readonly status = 401;
+    constructor(cause?: unknown | undefined);
+}
+/** @internal Convert a rejected authenticated request into the SDK's public auth error. */
+export declare function authenticationRequiredError(cause: unknown, rejectedToken?: string): AuthenticationRequiredError;
 export interface ApiClientOptions {
     baseUrl?: string;
     timeout?: number;

package/dist/composables/usePluginClient.d.ts

@@ -9,7 +9,9 @@ export interface PluginEndpointContract {
     pathParams?: PluginEndpointParamContract[];
     queryParams?: PluginEndpointParamContract[];
     requestType?: string | null;
+    requestContentType?: string | null;
     responseType?: string | null;
+    responseContentType?: string | null;
     eventStream?: boolean;
 }
 export interface PluginEndpointParamContract {
@@ -58,8 +60,10 @@ export interface PluginEndpointDefinition {
     pathParams?: PluginEndpointParamDefinition[];
     queryParams?: PluginEndpointParamDefinition[];
     hasBody?: boolean;
+    requestContentType?: string | null;
     eventStream?: boolean;
     responseType?: string | null;
+    responseContentType?: string | null;
 }
 export type PluginEndpointParamDefinition = string | {
     name: string;
@@ -80,6 +84,12 @@ export interface BuildPluginEndpointUrlOptions {
 export interface PluginEndpointRequestOptions {
     /** Override the generated or platform-injected API base URL. */
     baseUrl?: string;
+    /** Cancel the request without changing its endpoint or authentication behavior. */
+    signal?: AbortSignal;
+}
+export interface PluginClientRequestOptions {
+    /** Cancel the generated endpoint request. */
+    signal?: AbortSignal;
 }
 export interface DownloadPluginEndpointOptions extends PluginEndpointRequestOptions {
     /** Browser download filename. When omitted, the blob is returned without triggering a download. */
@@ -189,7 +199,7 @@ export interface UseCurrentExperimentReturn<TExperiment = ExperimentSummary> {
     /** Refetch the currently resolved experiment id. */
     refresh: () => Promise<TExperiment | undefined>;
 }
-export type PluginEndpointCaller = (payload?: unknown) => Promise<unknown>;
+export type PluginEndpointCaller = (payloadOrOptions?: unknown, options?: PluginClientRequestOptions) => Promise<unknown>;
 export type GeneratedPluginClient = Record<string, (...args: any[]) => Promise<any>>;
 /** Convert plain upload payloads into FormData using the same encoding across generated plugin clients. */
 export declare function pluginFormDataFromPayload(payload: unknown): FormData;
@@ -199,7 +209,7 @@ export declare function downloadBlob(blob: Blob, filename: string, options?: Dow
 export declare function getPluginPageSelectorItems(contract: PluginContract): PageSelectorItem[];
 /** Create a typed plugin API client from a generated MINT plugin contract. */
 export declare function createPluginClient<TClient extends object = GeneratedPluginClient>(contract: PluginContract, options: CreatePluginClientOptions): TClient;
-/** Send multipart form data to a generated plugin endpoint while reusing contract URL, query, and auth handling. */
+/** Send multipart or raw binary data to a generated endpoint with contract URL, cancellation, and auth handling. */
 export declare function uploadPluginEndpoint<TResponse = unknown>(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: PluginEndpointRequestOptions): Promise<TResponse>;
 /** Fetch a generated plugin endpoint as a Blob and optionally trigger a browser download. */
 export declare function downloadPluginEndpoint(contract: PluginContract, endpoint: PluginEndpointDefinition, payload?: unknown, options?: DownloadPluginEndpointOptions): Promise<Blob>;

package/dist/{composables-GosFS8fM.js → composables-TpXyhRZZ.js}

@@ -1,7 +1,7 @@
-import { D as currentExperimentFromContext, O as getInjectedPlatformContext, k as resolveCurrentExperimentId } from "./useJobsStatusTray-DAH999_N.js";
+import { D as currentExperimentFromContext, O as getInjectedPlatformContext, k as resolveCurrentExperimentId } from "./useJobsStatusTray-CVecN6Ao.js";
 import { r as useSettingsStore, t as useAuthStore } from "./auth-DZAwEeis.js";
 import { i as usePlatformContext } from "./useFormBuilder-DKekvXRs.js";
-import { i as useApi, r as useRequestSyncState } from "./useExperimentSelector-DdCy5VNv.js";
+import { a as authenticationRequiredError, i as AuthenticationRequiredError, o as useApi, r as useRequestSyncState } from "./useExperimentSelector-DRbj6vse.js";
 import { computed, getCurrentInstance, onMounted, onUnmounted, ref, shallowRef, toValue, watch } from "vue";
 import axios from "axios";
 //#region src/composables/useAuth.ts
@@ -1225,6 +1225,13 @@ function endpointParamName(param) {
 function endpointParamFieldName(param) {
 	return typeof param === "string" ? param : param.fieldName ?? param.name;
 }
+function escapeRegExp(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function replacePathParam(path, name, encoded) {
+	const escapedName = escapeRegExp(name);
+	return path.replace(new RegExp(`\\{${escapedName}(?::[^{}]+)?\\}`, "g"), () => encoded).replace(new RegExp(`:${escapedName}(?=/|$)`, "g"), () => encoded);
+}
 /** Resolve the runtime plugin API base URL from env, explicit options, platform injection, or contract metadata. */
 function resolvePluginBaseUrl(contract, explicitBaseUrl) {
 	if (explicitBaseUrl) return normalizeApiBaseUrl(explicitBaseUrl) ?? explicitBaseUrl;
@@ -1241,12 +1248,8 @@ function encodePath(path, payload, pathParams) {
 		const value = payload[fieldName] ?? payload[name];
 		if (value === void 0 || value === null) throw new Error(`[MINT SDK] Missing path parameter '${fieldName}' for plugin endpoint ${path}`);
 		const encoded = encodeURIComponent(String(value));
-		nextPath = nextPath.replace(`{${name}}`, encoded);
-		nextPath = nextPath.replace(`:${name}`, encoded);
-		if (fieldName !== name) {
-			nextPath = nextPath.replace(`{${fieldName}}`, encoded);
-			nextPath = nextPath.replace(`:${fieldName}`, encoded);
-		}
+		nextPath = replacePathParam(nextPath, name, encoded);
+		if (fieldName !== name) nextPath = replacePathParam(nextPath, fieldName, encoded);
 	}
 	return nextPath;
 }
@@ -1366,9 +1369,26 @@ function buildPluginEndpointUrl(contract, endpoint, payload, options = {}) {
 function queryConfig(query) {
 	return hasKeys(query) ? { params: query } : void 0;
 }
+var OCTET_STREAM = "application/octet-stream";
+var MULTIPART_FORM_DATA = "multipart/form-data";
+function endpointRequestConfig(endpoint, query, options) {
+	const config = {};
+	if (hasKeys(query)) config.params = query;
+	if (endpoint.requestContentType === OCTET_STREAM) config.headers = { "Content-Type": OCTET_STREAM };
+	if (endpoint.requestContentType === MULTIPART_FORM_DATA) config.headers = { "Content-Type": void 0 };
+	if (endpoint.responseContentType === OCTET_STREAM) config.responseType = "blob";
+	if (options?.signal) config.signal = options.signal;
+	return hasKeys(config) ? config : void 0;
+}
 function isFormData(value) {
 	return typeof FormData !== "undefined" && value instanceof FormData;
 }
+function endpointRequestBody(endpoint, body) {
+	return endpoint.requestContentType === MULTIPART_FORM_DATA ? pluginFormDataFromPayload(body) : body;
+}
+function endpointHasPayload(endpoint) {
+	return Boolean(endpoint.hasBody || endpoint.pathParams?.length || endpoint.queryParams?.length);
+}
 function isBlob(value) {
 	return typeof Blob !== "undefined" && value instanceof Blob;
 }
@@ -1430,28 +1450,32 @@ function getPluginPageSelectorItems(contract) {
 /** Create a typed plugin API client from a generated MINT plugin contract. */
 function createPluginClient(contract, options) {
 	const client = {};
-	for (const [name, endpoint] of Object.entries(options.endpoints)) client[name] = async (payload) => {
+	for (const [name, endpoint] of Object.entries(options.endpoints)) client[name] = async (payloadOrOptions, explicitOptions) => {
+		const hasPayload = endpointHasPayload(endpoint);
+		const payload = hasPayload ? payloadOrOptions : void 0;
+		const callOptions = hasPayload ? explicitOptions : payloadOrOptions ?? explicitOptions;
 		const parts = pluginEndpointRequestParts(contract, endpoint, payload, options.baseUrl);
 		const api = useApi({ baseUrl: parts.baseUrl });
-		const queryConfig = hasKeys(parts.query) ? { params: parts.query } : void 0;
-		if (endpoint.method === "get") return api.get(parts.path, queryConfig);
+		const config = endpointRequestConfig(endpoint, parts.query, callOptions);
+		if (endpoint.method === "get") return api.get(parts.path, config);
 		if (endpoint.method === "delete") {
-			const body = requestBodyFromPayload(payload, parts.requestPayload, endpoint);
-			const config = body === void 0 ? queryConfig : {
-				...queryConfig,
+			const rawBody = requestBodyFromPayload(payload, parts.requestPayload, endpoint);
+			const body = rawBody === void 0 ? void 0 : endpointRequestBody(endpoint, rawBody);
+			const config = body === void 0 ? endpointRequestConfig(endpoint, parts.query, callOptions) : {
+				...endpointRequestConfig(endpoint, parts.query, callOptions),
 				data: body
 			};
 			return api.delete(parts.path, config);
 		}
-		const body = requestBodyFromPayload(payload, parts.requestPayload, endpoint);
-		if (endpoint.method === "post") return api.post(parts.path, body, queryConfig);
-		if (endpoint.method === "put") return api.put(parts.path, body, queryConfig);
-		if (endpoint.method === "patch") return api.patch(parts.path, body, queryConfig);
+		const body = endpointRequestBody(endpoint, requestBodyFromPayload(payload, parts.requestPayload, endpoint));
+		if (endpoint.method === "post") return api.post(parts.path, body, config);
+		if (endpoint.method === "put") return api.put(parts.path, body, config);
+		if (endpoint.method === "patch") return api.patch(parts.path, body, config);
 		throw new Error(`[MINT SDK] Unsupported plugin endpoint method: ${endpoint.method}`);
 	};
 	return client;
 }
-/** Send multipart form data to a generated plugin endpoint while reusing contract URL, query, and auth handling. */
+/** Send multipart or raw binary data to a generated endpoint with contract URL, cancellation, and auth handling. */
 async function uploadPluginEndpoint(contract, endpoint, payload, options = {}) {
 	if (![
 		"post",
@@ -1460,9 +1484,17 @@ async function uploadPluginEndpoint(contract, endpoint, payload, options = {}) {
 	].includes(endpoint.method)) throw new Error(`[MINT SDK] Plugin upload endpoints must use POST, PUT, or PATCH; got ${endpoint.method}`);
 	const parts = pluginEndpointRequestParts(contract, endpoint, payload, options.baseUrl);
 	const api = useApi({ baseUrl: parts.baseUrl });
-	const formData = pluginFormDataFromPayload(endpoint.hasBody ? requestBodyFromPayload(payload, parts.requestPayload, endpoint) : payload);
+	const body = endpoint.hasBody ? requestBodyFromPayload(payload, parts.requestPayload, endpoint) : payload;
+	if (endpoint.requestContentType === OCTET_STREAM) {
+		const config = endpointRequestConfig(endpoint, parts.query, { signal: options.signal });
+		if (endpoint.method === "post") return api.post(parts.path, body, config);
+		if (endpoint.method === "put") return api.put(parts.path, body, config);
+		return api.patch(parts.path, body, config);
+	}
+	const formData = pluginFormDataFromPayload(body);
 	const config = {
 		...queryConfig(parts.query) ?? {},
+		...options.signal ? { signal: options.signal } : {},
 		headers: { "Content-Type": void 0 }
 	};
 	if (endpoint.method === "post") return api.post(parts.path, formData, config);
@@ -1474,6 +1506,7 @@ async function downloadPluginEndpoint(contract, endpoint, payload, options = {})
 	const parts = pluginEndpointRequestParts(contract, endpoint, payload, options.baseUrl);
 	const blob = await useApi({ baseUrl: parts.baseUrl }).get(parts.path, {
 		...queryConfig(parts.query) ?? {},
+		...options.signal ? { signal: options.signal } : {},
 		responseType: "blob"
 	});
 	if (options.filename) downloadBlob(blob, options.filename, { revokeObjectUrlDelayMs: options.revokeObjectUrlDelayMs });
@@ -1583,13 +1616,17 @@ function usePluginSettings(options = {}) {
 		reset
 	};
 }
-function streamHeaders(options) {
+function streamRequestAuth(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;
+	const token = authStore.token;
+	return {
+		headers,
+		token: token && headers.get("Authorization") === `Bearer ${token}` ? token : void 0
+	};
 }
 function parseSseEvent(block, parseJson) {
 	let event = "message";
@@ -1678,16 +1715,24 @@ function usePluginEventStream(contract, endpoint, payloadOrOptions, maybeOptions
 		if (!ownsConnection(connectionGeneration, connectionController)) return;
 		error.value = null;
 		if (!ownsConnection(connectionGeneration, connectionController)) return;
+		let authenticationFailed = false;
 		try {
 			const url = buildPluginEndpointUrl(contract, endpoint, payload, { baseUrl: options.baseUrl });
+			const requestAuth = streamRequestAuth(options);
 			const response = await fetch(url, {
 				method: "GET",
-				headers: streamHeaders(options),
+				headers: requestAuth.headers,
 				credentials: options.credentials ?? "same-origin",
 				signal: connectionController.signal
 			});
 			if (!ownsConnection(connectionGeneration, connectionController)) return;
-			if (!response.ok) throw new Error(`Plugin event stream failed with HTTP ${response.status}`);
+			if (!response.ok) {
+				if (response.status === 401) {
+					authenticationFailed = true;
+					throw authenticationRequiredError(response, requestAuth.token);
+				}
+				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.");
 			isConnected.value = true;
 			if (!ownsConnection(connectionGeneration, connectionController)) return;
@@ -1722,6 +1767,7 @@ function usePluginEventStream(contract, endpoint, payloadOrOptions, maybeOptions
 				}
 			}
 		} catch (err) {
+			if (err instanceof AuthenticationRequiredError) authenticationFailed = true;
 			if (ownsConnection(connectionGeneration, connectionController) && !(err instanceof DOMException && err.name === "AbortError")) {
 				error.value = err instanceof Error ? err.message : "Plugin event stream failed";
 				if (ownsConnection(connectionGeneration, connectionController)) options.onError?.(err);
@@ -1733,7 +1779,8 @@ function usePluginEventStream(contract, endpoint, payloadOrOptions, maybeOptions
 					isConnected.value = false;
 					if (ownsConnection(connectionGeneration, connectionController)) {
 						controller = null;
-						scheduleReconnect(connectionGeneration);
+						if (authenticationFailed) stopped = true;
+						else scheduleReconnect(connectionGeneration);
 					}
 				}
 			}
@@ -1756,9 +1803,10 @@ function usePluginEventStream(contract, endpoint, payloadOrOptions, maybeOptions
 		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();
+	const currentInstance = getCurrentInstance();
+	if (currentInstance && options.immediate !== false && typeof window === "undefined") onMounted(start);
+	if (currentInstance) onUnmounted(stop);
+	if (options.immediate !== false && (typeof window !== "undefined" || !currentInstance)) start();
 	return {
 		isConnected,
 		isConnecting,
@@ -1829,4 +1877,4 @@ function useCurrentExperiment(options = {}) {
 //#endregion
 export { resolvePluginFrontendBase as A, createPluginResourceClient as C, usePluginConfig as D, useCommandHistory as E, useAuth as M, useAsync as O, wellIdsInRectangle as S, useOptimisticMutation 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, usePasskey as j, useAsyncBatch 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, useResourceCrud as w, wellIdToCoordinate as x, coordinateToWellId as y };
 
-//# sourceMappingURL=composables-GosFS8fM.js.map
+//# sourceMappingURL=composables-TpXyhRZZ.js.map