@morscherlab/mint-sdk 1.0.51 → 1.0.53

package/dist/types/index.d.ts

@@ -1,4 +1,5 @@
 export type { ContainerDirection, ButtonVariant, ButtonSize, InputType, ModalSize, ModalVariant, AlertType, Toast, TabItem, TabItemInput, OptionPrimitive, SelectOption, SelectOptionInput, RadioOption, RadioOptionInput, FormFieldProps, SidebarBadgeTone, SidebarToolSection, SidebarToolSectionAction, CollapsibleState, TopBarVariant, TopBarSettingsConfig, PillNavOption, PillNavOptionInput, PillNavItem, PillNavItemInput, PageSelectorItem, PageSelectorItemInput, PluginSwitcherPlugin, PluginSwitcherInfo, AccountMenuItem, WellPlateFormat, WellState, WellPlateSelectionMode, WellPlateSize, WellShape, Well, HeatmapColorScale, HeatmapConfig, SlotPosition, WellExtendedData, WellEditData, WellEditField, WellSampleDropData, WellSampleDropContext, WellSampleDropParser, WellLegendItem, PlateCondition, ColumnCondition, RowCondition, Rack, RackSampleDropContext, RackSampleDropMapper, SampleType, PlateMap, PlateMapEditorState, ProtocolStepType, ProtocolStepStatus, ProtocolStep, SampleGroup, GroupItem, FileUploaderMode, SegmentedOption, SegmentedOptionInput, SegmentedControlVariant, SegmentedControlSize, MultiSelectOption, MultiSelectOptionInput, MultiSelectSize, PillVariant, PillColor, PillSize, CalendarSelectionMode, CalendarMarker, CalendarDayContext, SortDirection, SortState, DataFrameColumn, PaginationState, SpinnerSize, SpinnerVariant, DividerSpacing, StatusType, ProgressVariant, ProgressSize, AvatarSize, EmptyStateColor, EmptyStateSize, BreadcrumbItem, BreadcrumbItemInput, TooltipPosition, ConfirmVariant, SettingsTab, SettingsTabInput, SettingsModalLayout, SettingsGroup, SettingsModalSchema, SettingsUserType, SettingsAudience, SettingsAudienceInput, NumberNotation, UnitOption, WizardStep, WizardStepState, AuditEntryType, AuditEntry, BatchItemStatus, BatchItem, BatchSummary, TimePickerFormat, TimeRange, ScheduleView, ScheduleEventStatus, ScheduleEvent, ScheduleBlockedSlot, ScheduleSlotContext, ScheduleEventCreateContext, ScheduleEventUpdateContext, SummarySectionItem, SummarySection, SummaryData, ResourceStatus, ResourceSpec, MoleculeData, ExperimentStatus, DatePreset, ExperimentSortField, ExperimentTypeOption, ExperimentSummary, ExperimentListResponse, ExperimentFilters, FitState, FitResultSummary, StorageCondition, ReagentColumn, Reagent, TreeNodeType, BadgeVariant, TreeNode, } from './components';
+export type { JobListPayload, JobProgress, JobSnapshotPayload, JobState, JobStateInput, JobStatus, JobStreamData, } from './jobs';
 export type { InstrumentAlert, InstrumentAlertBody, InstrumentAlertLevel, InstrumentState, InstrumentStatus, SampleInfo, SampleInfo as InstrumentSampleInfo, SequenceProgress, } from './instrument';
 export type { LcmsContainerType, LcmsPolarity, LcmsSequenceItem, LcmsSequenceTableColumn, } from '../lcms';
 export type { AccessAudience, AccessAudienceInput, AccessPolicy, AccessControlled, PermissionUser, RoleInfo, } from '../permissions';

package/dist/types/jobs.d.ts

@@ -0,0 +1,49 @@
+/** Canonical lifecycle values emitted by the MINT Python SDK job contract. */
+export type JobStatus = 'awaiting_input' | 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+export interface JobProgress {
+    current_file: number;
+    total_files: number;
+    current_filename: string | null;
+    percent: number;
+    message: string;
+    stage: string;
+}
+/** Normalized job state used by SDK job UI. */
+export interface JobState {
+    id: string;
+    job_id: string;
+    kind: string;
+    name: string;
+    status: JobStatus;
+    progress: JobProgress;
+    queue_position: number;
+    warnings: string[];
+    error: string | null;
+    output_path: string | null;
+    save_path: string | null;
+    session_id: string | null;
+    folders: string[];
+    folder_path: string | null;
+    user_id: string | null;
+    owner_user_id: string | null;
+    experiment_id: string | null;
+    extraction_result_id: string | null;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    started_at: string | null;
+    completed_at: string | null;
+    can_cancel: boolean;
+    can_delete: boolean;
+}
+/** Backward-compatible transport shape accepted from pre-capability backends. */
+export type JobStateInput = Omit<JobState, 'can_cancel' | 'can_delete'> & {
+    can_cancel?: boolean | null;
+    can_delete?: boolean | null;
+};
+export interface JobListPayload {
+    jobs: JobStateInput[];
+}
+export interface JobSnapshotPayload {
+    jobs: JobStateInput[];
+}
+export type JobStreamData = JobStateInput | JobSnapshotPayload;

package/dist/{useProtocolTemplates-C8-YlHj1.js → useJobsStatusTray-DAH999_N.js}

@@ -4488,6 +4488,254 @@ function useProtocolTemplates() {
 	};
 }
 //#endregion
-export { readFileAsText as A, useWellPlateEditor as B, useExpansionSet as C, hslToHex as D, hexToHsl as E, parseCSV as F, useAppExperiment as G, DEFAULT_MOBILE_VIEWPORT_QUERY as H, extractSampleNamesFromDesignData as I, candidateMatchesSearch as J, useTheme as K, extractSampleOptionsFromDesignData as L, validateImportFile as M, extractSamplesFromDesignData as N, detectDelimiter as O, useAutoGroup as P, useSortedItems as Q, unwrapExperimentDesignData as R, resolveCurrentExperimentId as S, deriveShade as T, useMobileSupportGate as U, useDoseCalculator as V, APP_EXPERIMENT_KEY as W, useTextSearch as X, normalizeSearchQuery as Y, compareSortValues as Z, useScheduleDrag as _, useReagentSeries as a, currentExperimentFromContext as b, useBioTemplatePresetWorkspace as c, getBioTemplateComponentProps as d, toBioTemplateComponentPropsByComponent as f, useExperimentSave as g, useTemplateCollection as h, generateDilutionSeries as i, useFileImport as j, parseDelimitedText as k, useBioTemplatePackWorkspace as l, useBioTemplateControls as m, DEFAULT_PRESETS as n, useGroupAssignment as o, useBioTemplateComponents as p, useToast as q, DEFAULT_UNITS as r, useRackEditor as s, useProtocolTemplates as t, useBioTemplateWorkspace as u, useExperimentSamples as v, useSampleGroups as w, getInjectedPlatformContext as x, useExperimentData as y, DEFAULT_COLORS as z };
+//#region src/jobs.ts
+var ACTIVE_JOB_STATUSES = new Set([
+	"awaiting_input",
+	"queued",
+	"running"
+]);
+var TERMINAL_JOB_STATUSES = new Set([
+	"completed",
+	"failed",
+	"cancelled"
+]);
+/** Resolve action support while retaining one-cycle legacy status inference. */
+function resolveJobCapabilities(job) {
+	const legacyCanCancel = job.status === "queued" || job.status === "running";
+	const legacyCanDelete = TERMINAL_JOB_STATUSES.has(job.status);
+	return {
+		can_cancel: typeof job.can_cancel === "boolean" ? job.can_cancel : legacyCanCancel,
+		can_delete: typeof job.can_delete === "boolean" ? job.can_delete : legacyCanDelete
+	};
+}
+/** Clamp invalid or out-of-range progress values for safe display. */
+function normalizeJobPercent(value) {
+	if (!Number.isFinite(value)) return 0;
+	return Math.min(100, Math.max(0, value));
+}
+/** Create a detached canonical state without changing the transport input. */
+function normalizeJobState(job) {
+	const capabilities = resolveJobCapabilities(job);
+	return {
+		...job,
+		progress: {
+			...job.progress,
+			percent: normalizeJobPercent(job.progress.percent)
+		},
+		warnings: [...job.warnings],
+		folders: [...job.folders],
+		metadata: { ...job.metadata },
+		...capabilities
+	};
+}
+function isActiveJobStatus(status) {
+	return ACTIVE_JOB_STATUSES.has(status);
+}
+function isTerminalJobStatus(status) {
+	return TERMINAL_JOB_STATUSES.has(status);
+}
+function jobStatusLabel(status) {
+	return {
+		awaiting_input: "Waiting for input",
+		queued: "Queued",
+		running: "Running",
+		completed: "Completed",
+		failed: "Failed",
+		cancelled: "Cancelled"
+	}[status];
+}
+//#endregion
+//#region src/composables/useJobsStatusTray.ts
+function responseJobs(response) {
+	return "jobs" in response ? response.jobs : response;
+}
+function isSnapshotPayload(data) {
+	return "jobs" in data && Array.isArray(data.jobs);
+}
+function errorMessage(error, fallback) {
+	return error instanceof Error ? error.message : fallback;
+}
+/** Headless state and action controller for the standard SDK jobs tray. */
+function useJobsStatusTray(options = {}) {
+	const jobs = shallowRef([]);
+	const isOpen = ref(false);
+	const activeTab = ref("active");
+	const isLoading = ref(false);
+	const error = shallowRef(null);
+	const pendingJobIds = ref(/* @__PURE__ */ new Set());
+	const jobRevisions = /* @__PURE__ */ new Map();
+	let stateRevision = 0;
+	let requestGeneration = 0;
+	let active = true;
+	const adapter = computed(() => toValue(options.adapter));
+	const activeJobs = computed(() => jobs.value.filter((job) => isActiveJobStatus(job.status)));
+	const historyJobs = computed(() => jobs.value.filter((job) => !isActiveJobStatus(job.status)));
+	const deletableJobs = computed(() => historyJobs.value.filter((job) => job.can_delete));
+	const featuredJob = computed(() => activeJobs.value[0] ?? historyJobs.value[0] ?? null);
+	function bumpJobRevision(jobId) {
+		jobRevisions.set(jobId, (jobRevisions.get(jobId) ?? 0) + 1);
+	}
+	function replaceJobs(nextJobs) {
+		const normalized = nextJobs.map(normalizeJobState);
+		new Set([...jobs.value.map((job) => job.job_id), ...normalized.map((job) => job.job_id)]).forEach(bumpJobRevision);
+		jobs.value = normalized;
+		stateRevision += 1;
+	}
+	function upsertJob(nextJob) {
+		const normalized = normalizeJobState(nextJob);
+		const existingIndex = jobs.value.findIndex((job) => job.job_id === normalized.job_id);
+		if (existingIndex === -1) jobs.value = [normalized, ...jobs.value];
+		else {
+			const nextJobs = [...jobs.value];
+			nextJobs[existingIndex] = normalized;
+			jobs.value = nextJobs;
+		}
+		bumpJobRevision(normalized.job_id);
+		stateRevision += 1;
+	}
+	function removeJobs(jobIds) {
+		jobs.value = jobs.value.filter((job) => !jobIds.has(job.job_id));
+		jobIds.forEach(bumpJobRevision);
+		stateRevision += 1;
+	}
+	function setPending(jobId, pending) {
+		const next = new Set(pendingJobIds.value);
+		if (pending) next.add(jobId);
+		else next.delete(jobId);
+		pendingJobIds.value = next;
+	}
+	function applyStreamMessage(message) {
+		if (!active) return;
+		if (message.event === "snapshot" && isSnapshotPayload(message.data)) {
+			replaceJobs(message.data.jobs);
+			return;
+		}
+		if ((message.event === "job" || message.event === "terminal") && !isSnapshotPayload(message.data)) upsertJob(message.data);
+	}
+	async function refresh() {
+		const listJobs = adapter.value?.listJobs;
+		if (!listJobs) return false;
+		const generation = ++requestGeneration;
+		const revision = stateRevision;
+		isLoading.value = true;
+		error.value = null;
+		try {
+			const response = await listJobs();
+			if (!active || generation !== requestGeneration || revision !== stateRevision) return false;
+			replaceJobs(responseJobs(response));
+			return true;
+		} catch (cause) {
+			if (active && generation === requestGeneration) error.value = errorMessage(cause, "Failed to load jobs");
+			return false;
+		} finally {
+			if (active && generation === requestGeneration) isLoading.value = false;
+		}
+	}
+	async function cancelJob(job) {
+		const cancel = adapter.value?.cancelJob;
+		if (!job.can_cancel || !cancel || pendingJobIds.value.has(job.job_id)) return false;
+		const revision = jobRevisions.get(job.job_id) ?? 0;
+		setPending(job.job_id, true);
+		error.value = null;
+		try {
+			const updated = await cancel(job);
+			if (!active) return false;
+			if (revision === (jobRevisions.get(job.job_id) ?? 0)) if (updated) upsertJob(updated);
+			else await refresh();
+			return true;
+		} catch (cause) {
+			if (active) error.value = errorMessage(cause, "Failed to cancel job");
+			return false;
+		} finally {
+			if (active) setPending(job.job_id, false);
+		}
+	}
+	async function deleteJob(job) {
+		const deleteJobWithAdapter = adapter.value?.deleteJob;
+		if (!job.can_delete || !deleteJobWithAdapter || pendingJobIds.value.has(job.job_id)) return false;
+		setPending(job.job_id, true);
+		error.value = null;
+		try {
+			const deleted = await deleteJobWithAdapter(job);
+			if (!active) return false;
+			if (deleted === false) await refresh();
+			else removeJobs(new Set([job.job_id]));
+			return deleted !== false;
+		} catch (cause) {
+			if (active) error.value = errorMessage(cause, "Failed to delete job");
+			return false;
+		} finally {
+			if (active) setPending(job.job_id, false);
+		}
+	}
+	async function clearFinished() {
+		const targets = deletableJobs.value;
+		if (targets.length === 0) return false;
+		error.value = null;
+		try {
+			const currentAdapter = adapter.value;
+			if (currentAdapter?.clearFinishedJobs) {
+				const deleted = await currentAdapter.clearFinishedJobs(targets);
+				if (!active) return false;
+				if (typeof deleted === "number" && deleted !== targets.length) {
+					await refresh();
+					return false;
+				}
+				removeJobs(new Set(targets.map((job) => job.job_id)));
+				return true;
+			}
+			if (!currentAdapter?.deleteJob) return false;
+			return (await Promise.all(targets.map((job) => deleteJob(job)))).every(Boolean);
+		} catch (cause) {
+			if (active) error.value = errorMessage(cause, "Failed to clear jobs");
+			return false;
+		}
+	}
+	if (options.jobs !== void 0) watch(() => toValue(options.jobs), (value) => {
+		if (value) replaceJobs(value);
+	}, {
+		immediate: true,
+		deep: true
+	});
+	if (options.eventStream !== void 0) watch(() => toValue(options.eventStream)?.lastMessage.value ?? null, (message) => {
+		if (message) applyStreamMessage(message);
+	}, { immediate: true });
+	onMounted(() => {
+		if (options.loadOnMount !== false) refresh();
+	});
+	onUnmounted(() => {
+		active = false;
+		requestGeneration += 1;
+	});
+	return {
+		jobs,
+		activeJobs,
+		historyJobs,
+		deletableJobs,
+		featuredJob,
+		isOpen,
+		activeTab,
+		isLoading,
+		error,
+		pendingJobIds,
+		open: () => {
+			isOpen.value = true;
+		},
+		close: () => {
+			isOpen.value = false;
+		},
+		toggle: () => {
+			isOpen.value = !isOpen.value;
+		},
+		refresh,
+		applyStreamMessage,
+		cancelJob,
+		deleteJob,
+		clearFinished,
+		isPending: (job) => pendingJobIds.value.has(job.job_id)
+	};
+}
+//#endregion
+export { useTheme as $, useExpansionSet as A, extractSamplesFromDesignData as B, useExperimentSave as C, currentExperimentFromContext as D, useExperimentData as E, detectDelimiter as F, unwrapExperimentDesignData as G, parseCSV as H, parseDelimitedText as I, useDoseCalculator as J, DEFAULT_COLORS as K, readFileAsText as L, deriveShade as M, hexToHsl as N, getInjectedPlatformContext as O, hslToHex as P, useAppExperiment as Q, useFileImport as R, useTemplateCollection as S, useExperimentSamples as T, extractSampleNamesFromDesignData as U, useAutoGroup as V, extractSampleOptionsFromDesignData as W, useMobileSupportGate as X, DEFAULT_MOBILE_VIEWPORT_QUERY as Y, APP_EXPERIMENT_KEY as Z, useBioTemplateWorkspace as _, normalizeJobPercent as a, useSortedItems as at, useBioTemplateComponents as b, useProtocolTemplates as c, generateDilutionSeries as d, useToast as et, useReagentSeries as f, useBioTemplatePackWorkspace as g, useBioTemplatePresetWorkspace as h, jobStatusLabel as i, compareSortValues as it, useSampleGroups as j, resolveCurrentExperimentId as k, DEFAULT_PRESETS as l, useRackEditor as m, isActiveJobStatus as n, normalizeSearchQuery as nt, normalizeJobState as o, useGroupAssignment as p, useWellPlateEditor as q, isTerminalJobStatus as r, useTextSearch as rt, resolveJobCapabilities as s, useJobsStatusTray as t, candidateMatchesSearch as tt, DEFAULT_UNITS as u, getBioTemplateComponentProps as v, useScheduleDrag as w, useBioTemplateControls as x, toBioTemplateComponentPropsByComponent as y, validateImportFile as z };
 
-//# sourceMappingURL=useProtocolTemplates-C8-YlHj1.js.map
+//# sourceMappingURL=useJobsStatusTray-DAH999_N.js.map