@morscherlab/mint-sdk 1.1.24 → 1.2.0-beta.1

package/src/__tests__/composables/useJobsStatusTray.test.ts

@@ -1,14 +1,13 @@
 import { mount } from '@vue/test-utils'
-import { defineComponent, nextTick, ref, shallowRef } from 'vue'
+import { defineComponent, nextTick, shallowRef } from 'vue'
 import { describe, expect, it, vi } from 'vitest'
 
 import {
   combinePluginJobSources,
-  useJobsStatusTray,
   usePluginJobCenter,
-  type UseJobsStatusTrayOptions,
+  type UsePluginJobCenterOptions,
 } from '../../composables/useJobsStatusTray'
-import type { JobState, JobStateInput, JobStatus } from '../../types/jobs'
+import type { JobStateInput, JobStatus } from '../../types/jobs'
 
 function job(status: JobStatus, id: string = status): JobStateInput {
   return {
@@ -44,29 +43,18 @@ function job(status: JobStatus, id: string = status): JobStateInput {
   }
 }
 
-function mountComposable(options: UseJobsStatusTrayOptions) {
-  let tray!: ReturnType<typeof useJobsStatusTray>
+function mountComposable(options: UsePluginJobCenterOptions) {
+  let tray!: ReturnType<typeof usePluginJobCenter>
   const wrapper = mount(defineComponent({
     setup() {
-      tray = useJobsStatusTray(options)
+      tray = usePluginJobCenter(options)
       return () => null
     },
   }))
   return { tray, wrapper }
 }
 
-function deferred<T>(): {
-  promise: Promise<T>
-  resolve: (value: T) => void
-} {
-  let resolve!: (value: T) => void
-  const promise = new Promise<T>((done) => {
-    resolve = done
-  })
-  return { promise, resolve }
-}
-
-describe('useJobsStatusTray', () => {
+describe('usePluginJobCenter', () => {
   it('combines live source jobs and fans out or routes source actions', async () => {
     const firstJobs = shallowRef([job('running', 'first')])
     const secondJobs = shallowRef([job('completed', 'second')])
@@ -242,37 +230,20 @@ describe('useJobsStatusTray', () => {
 
   it('keeps awaiting input jobs in the active group', () => {
     const { tray } = mountComposable({
-      jobs: [job('awaiting_input')],
+      source: { jobs: [job('awaiting_input')] },
       loadOnMount: false,
     })
 
     expect(tray.activeJobs.value.map(item => item.job_id)).toEqual(['awaiting_input'])
   })
 
-  it('replaces stale jobs when an SSE snapshot arrives', () => {
-    const { tray } = mountComposable({ jobs: [job('running', 'old')], loadOnMount: false })
-
-    tray.applyStreamMessage({
-      event: 'snapshot',
-      data: { jobs: [job('queued', 'new')] },
-    })
-
-    expect(tray.jobs.value.map(item => item.job_id)).toEqual(['new'])
-  })
-
-  it('moves an SSE terminal update into history', () => {
-    const { tray } = mountComposable({ jobs: [job('running', 'fit')], loadOnMount: false })
-
-    tray.applyStreamMessage({ event: 'terminal', data: job('completed', 'fit') })
-
-    expect(tray.historyJobs.value.map(item => item.job_id)).toEqual(['fit'])
-  })
-
-  it('does not call a cancel adapter when the capability is disabled', async () => {
+  it('does not call a source cancel action when the capability is disabled', async () => {
     const cancelJob = vi.fn()
     const { tray } = mountComposable({
-      jobs: [{ ...job('running'), can_cancel: false }],
-      adapter: { cancelJob },
+      source: {
+        jobs: [{ ...job('running'), can_cancel: false }],
+        cancelJob,
+      },
       loadOnMount: false,
     })
 
@@ -281,139 +252,32 @@ describe('useJobsStatusTray', () => {
     expect(cancelJob).not.toHaveBeenCalled()
   })
 
-  it('does not let a stale list response overwrite an SSE update', async () => {
-    let resolveList!: (jobs: JobStateInput[]) => void
-    const listJobs = vi.fn(() => new Promise<JobStateInput[]>((resolve) => {
-      resolveList = resolve
-    }))
-    const { tray } = mountComposable({
-      adapter: { listJobs },
-      loadOnMount: false,
+  it('refreshes through the source without mirroring its jobs', async () => {
+    const sourceJobs = shallowRef([job('running', 'old')])
+    const refreshJobs = vi.fn(async () => {
+      sourceJobs.value = [job('queued', 'new')]
+      return sourceJobs.value
     })
-
-    const refresh = tray.refresh()
-    tray.applyStreamMessage({ event: 'job', data: job('running', 'live') })
-    resolveList([job('queued', 'stale')])
-    await refresh
-    await nextTick()
-
-    expect(tray.jobs.value.map(item => item.job_id)).toEqual(['live'])
-  })
-
-  it('passes only explicitly deletable jobs to the bulk clear adapter', async () => {
-    const clearFinishedJobs = vi.fn(async (_jobs: readonly JobState[]) => undefined)
     const { tray } = mountComposable({
-      jobs: [
-        job('completed', 'legacy-deletable'),
-        { ...job('failed', 'retained'), can_delete: false },
-      ],
-      adapter: { clearFinishedJobs },
+      source: { jobs: sourceJobs, refreshJobs },
       loadOnMount: false,
     })
 
-    await tray.clearFinished()
+    await tray.refresh()
+    await nextTick()
 
-    expect(clearFinishedJobs.mock.calls[0]![0].map(item => item.job_id)).toEqual([
-      'legacy-deletable',
+    expect([refreshJobs.mock.calls.length, tray.jobs.value.map(item => item.job_id)]).toEqual([
+      1,
+      ['new'],
     ])
   })
 
   it('does not include active deletable jobs in bulk clear targets', () => {
     const { tray } = mountComposable({
-      jobs: [{ ...job('awaiting_input'), can_delete: true }],
+      source: { jobs: [{ ...job('awaiting_input'), can_delete: true }] },
       loadOnMount: false,
     })
 
     expect(tray.deletableJobs.value).toEqual([])
   })
-
-  it('does not let a late cancel response overwrite a newer SSE state', async () => {
-    const pending = deferred<JobStateInput>()
-    const { tray } = mountComposable({
-      jobs: [job('running', 'fit')],
-      adapter: { cancelJob: async () => pending.promise },
-      loadOnMount: false,
-    })
-
-    const cancellation = tray.cancelJob(tray.jobs.value[0]!)
-    tray.applyStreamMessage({ event: 'terminal', data: job('completed', 'fit') })
-    pending.resolve(job('cancelled', 'fit'))
-    await cancellation
-
-    expect(tray.jobs.value[0]!.status).toBe('completed')
-  })
-
-  it('applies a cancel response after an unrelated job update', async () => {
-    const pending = deferred<JobStateInput>()
-    const { tray } = mountComposable({
-      jobs: [job('running', 'fit'), job('running', 'export')],
-      adapter: { cancelJob: async () => pending.promise },
-      loadOnMount: false,
-    })
-
-    const cancellation = tray.cancelJob(tray.jobs.value[0]!)
-    tray.applyStreamMessage({ event: 'job', data: job('running', 'export') })
-    pending.resolve(job('cancelled', 'fit'))
-    await cancellation
-
-    expect(tray.jobs.value.find(item => item.job_id === 'fit')?.status).toBe('cancelled')
-  })
-
-  it('refreshes instead of removing every target after a partial bulk clear', async () => {
-    const listJobs = vi.fn(async () => [job('completed', 'retained')])
-    const clearFinishedJobs = vi.fn(async () => 1)
-    const { tray } = mountComposable({
-      jobs: [job('completed', 'deleted'), job('completed', 'retained')],
-      adapter: { listJobs, clearFinishedJobs },
-      loadOnMount: false,
-    })
-
-    const cleared = await tray.clearFinished()
-
-    expect([
-      cleared,
-      listJobs.mock.calls.length,
-      tray.jobs.value.map(item => item.job_id),
-    ]).toEqual([false, 1, ['retained']])
-  })
-
-  it('uses a replacement reactive adapter for later actions', async () => {
-    const first = vi.fn(async () => undefined)
-    const second = vi.fn(async () => undefined)
-    const adapter = shallowRef({ cancelJob: first })
-    const { tray } = mountComposable({
-      jobs: [job('running')],
-      adapter,
-      loadOnMount: false,
-    })
-    adapter.value = { cancelJob: second }
-
-    await tray.cancelJob(tray.jobs.value[0]!)
-
-    expect([first.mock.calls.length, second.mock.calls.length]).toEqual([0, 1])
-  })
-
-  it('applies the latest message from a replacement stream immediately', async () => {
-    const eventStream = shallowRef({
-      isConnected: ref(true),
-      isConnecting: ref(false),
-      error: ref<string | null>(null),
-      lastMessage: shallowRef({
-        event: 'snapshot',
-        data: { jobs: [job('queued', 'replacement')] },
-        raw: '',
-      }),
-      lastEventId: ref<string | null>(null),
-      start: vi.fn(),
-      stop: vi.fn(),
-    })
-
-    const { tray } = mountComposable({
-      eventStream,
-      loadOnMount: false,
-    })
-    await nextTick()
-
-    expect(tray.jobs.value.map(item => item.job_id)).toEqual(['replacement'])
-  })
 })

package/src/__tests__/composables/usePluginClient.test.ts

@@ -14,7 +14,6 @@ import {
   uploadPluginEndpoint,
   useCurrentExperiment,
   usePluginEventStream,
-  usePluginClient,
   usePluginSettings,
   type PluginContract,
 } from '../../composables/usePluginClient'
@@ -80,7 +79,13 @@ function pendingEventStreamResponse(): {
   })
   return {
     response: new Response(body, { status: 200 }),
-    close: () => streamController.close(),
+    close: () => {
+      try {
+        streamController.close()
+      } catch {
+        // stop() may already have cancelled the reader.
+      }
+    },
   }
 }
 
@@ -1396,11 +1401,7 @@ describe('usePluginClient', () => {
 
     try {
       stream.start()
-      await Promise.resolve()
-      await Promise.resolve()
-      await Promise.resolve()
-
-      expect(onOpen).toHaveBeenCalledOnce()
+      await vi.waitFor(() => expect(onOpen).toHaveBeenCalledOnce())
     } finally {
       stopWatching()
       stream.stop()
@@ -1684,12 +1685,6 @@ describe('usePluginClient', () => {
     expect(requestConfigs).toHaveLength(0)
   })
 
-  it('returns the provided client identity from usePluginClient', () => {
-    const client = createPluginClient(contract, { endpoints: {} })
-
-    expect(usePluginClient(client)).toBe(client)
-  })
-
   it('loads the current experiment from URL conventions', async () => {
     window.history.replaceState({}, '', '/analysis?experimentId=42')
     const current = useCurrentExperiment<{ called: string }>({ immediate: false })

package/src/__tests__/docs/frontendDocsCatalog.test.ts

@@ -271,6 +271,18 @@ describe('frontend docs catalog coverage', () => {
     })
   })
 
+  it('documents only the source-driven JobsStatusTray props', () => {
+    const manifest = extractFrontendManifest()
+    const jobsStatusTray = manifest.categories.components.find(item => item.name === 'JobsStatusTray')
+
+    expect(jobsStatusTray?.props?.map(prop => prop.name).sort()).toEqual([
+      'loadOnMount',
+      'source',
+      'teleportTo',
+      'title',
+    ])
+  })
+
   it('re-exports every public component from the root SDK entrypoint', () => {
     const publicComponents = parseComponentExports()
     const rootComponents = parseRootComponentExports()
@@ -295,6 +307,7 @@ describe('frontend docs catalog coverage', () => {
     const rootIndex = readFileSync(join(SDK_ROOT, 'src', 'index.ts'), 'utf8')
     const componentsIndex = readFileSync(join(SDK_ROOT, 'src', 'components', 'index.ts'), 'utf8')
     const composablesIndex = readFileSync(join(SDK_ROOT, 'src', 'composables', 'index.ts'), 'utf8')
+    const composableExports = composablesIndex.replace(/from\s+['"][^'"]+['"]/g, '')
 
     const retiredNames = [
       'ToastNotification',
@@ -306,12 +319,20 @@ describe('frontend docs catalog coverage', () => {
       'AppPillNav',
       'usePluginApi',
       'UsePluginApiOptions',
+      'useJobsStatusTray',
+      'UseJobsStatusTrayOptions',
+      'UseJobsStatusTrayReturn',
+      'JobsStatusTrayAdapter',
+      'JobStreamMessage',
+      'usePluginConfig',
+      'UsePluginConfigReturn',
+      'usePluginClient',
     ]
 
     for (const name of retiredNames) {
       expect(rootIndex).not.toMatch(new RegExp(`\\b${name}\\b`))
       expect(componentsIndex).not.toMatch(new RegExp(`\\b${name}\\b`))
-      expect(composablesIndex).not.toMatch(new RegExp(`\\b${name}\\b`))
+      expect(composableExports).not.toMatch(new RegExp(`\\b${name}\\b`))
     }
   })
 

package/src/components/JobsStatusTray.story.vue

@@ -54,9 +54,11 @@ const explicitActionJobs = [
   job('awaiting_input', 'J-201', { can_cancel: true }),
   job('completed', 'J-200', { can_delete: false }),
 ]
-const adapter = {
-  cancelJob: async () => undefined,
-  deleteJob: async () => true,
+const cancelJob = async () => undefined
+const deleteJob = async () => true
+
+function openJob(jobId: string) {
+  console.info('open', jobId)
 }
 
 function initState() {
@@ -74,11 +76,16 @@ function initState() {
         <div style="padding: 2rem; min-height: 520px;">
           <JobsStatusTray
             :title="state.title"
-            :jobs="state.jobs"
-            :adapter="adapter"
+            :source="{ jobs: state.jobs, cancelJob, deleteJob }"
             :load-on-mount="false"
             :teleport-to="false"
-          />
+          >
+            <template #job-actions="{ job }">
+              <button type="button" class="mint-jobs-tray__action" @click="() => openJob(job.job_id)">
+                Open
+              </button>
+            </template>
+          </JobsStatusTray>
         </div>
       </template>
       <template #controls="{ state }">
@@ -89,7 +96,7 @@ function initState() {
     <Variant title="Awaiting input">
       <div style="padding: 2rem; min-height: 520px;">
         <JobsStatusTray
-          :jobs="[job('awaiting_input', 'J-301')]"
+          :source="{ jobs: [job('awaiting_input', 'J-301')] }"
           :load-on-mount="false"
           :teleport-to="false"
         />
@@ -99,8 +106,7 @@ function initState() {
     <Variant title="Explicit actions">
       <div style="padding: 2rem; min-height: 520px;">
         <JobsStatusTray
-          :jobs="explicitActionJobs"
-          :adapter="adapter"
+          :source="{ jobs: explicitActionJobs, cancelJob, deleteJob }"
           :load-on-mount="false"
           :teleport-to="false"
         />
@@ -110,7 +116,7 @@ function initState() {
     <Variant title="Empty">
       <div style="padding: 2rem; min-height: 520px;">
         <JobsStatusTray
-          :jobs="[]"
+          :source="{ jobs: [] }"
           :load-on-mount="false"
           :teleport-to="false"
         />

package/src/components/JobsStatusTray.vue

@@ -15,24 +15,12 @@ import {
 } from '../jobs'
 import {
   usePluginJobCenter,
-  type JobsStatusTrayAdapter,
   type PluginJobCenterSource,
 } from '../composables/useJobsStatusTray'
-import type { UsePluginEventStreamReturn } from '../composables/usePluginClient'
-import type {
-  JobState,
-  JobStateInput,
-  JobStreamData,
-} from '../types/jobs'
+import type { JobState } from '../types/jobs'
 
 interface Props {
   source?: PluginJobCenterSource
-  /** @deprecated Pass a source instead. */
-  jobs?: readonly JobStateInput[]
-  /** @deprecated Pass source actions instead. */
-  adapter?: JobsStatusTrayAdapter
-  /** @deprecated Event streams belong to the source runtime. */
-  eventStream?: UsePluginEventStreamReturn<JobStreamData>
   loadOnMount?: boolean
   title?: string
   teleportTo?: string | HTMLElement | false
@@ -49,6 +37,11 @@ const emit = defineEmits<{
   error: [message: string]
 }>()
 
+defineSlots<{
+  /** Extra per-row actions, rendered before the built-in Cancel / Delete. */
+  'job-actions'?: (props: { job: JobState }) => unknown
+}>()
+
 const panelId = `mint-jobs-tray-${useId().replace(/:/g, '')}`
 const titleId = `${panelId}-title`
 const triggerRef = ref<HTMLButtonElement | null>(null)
@@ -56,9 +49,6 @@ const panelRef = ref<HTMLElement | null>(null)
 const teleportTarget = computed(() => props.teleportTo || 'body')
 const tray = usePluginJobCenter({
   source: toRef(props, 'source'),
-  jobs: toRef(props, 'jobs'),
-  adapter: toRef(props, 'adapter'),
-  eventStream: toRef(props, 'eventStream'),
   loadOnMount: props.loadOnMount,
 })
 const canClear = computed(() => (
@@ -309,6 +299,7 @@ async function clearFinished(): Promise<void> {
                 <div class="mint-jobs-tray__job-footer">
                   <span>{{ progressText(job) }}</span>
                   <div class="mint-jobs-tray__job-actions">
+                    <slot name="job-actions" :job="job" />
                     <button
                       v-if="job.can_cancel && tray.canCancel.value"
                       type="button"
@@ -371,18 +362,21 @@ async function clearFinished(): Promise<void> {
                 </div>
                 <div class="mint-jobs-tray__job-footer">
                   <span>{{ formatTimestamp(job.completed_at || job.created_at) }}</span>
-                  <button
-                    v-if="job.can_delete && tray.canDelete.value"
-                    type="button"
-                    class="mint-jobs-tray__icon-button mint-jobs-tray__icon-button--danger"
-                    aria-label="Delete job"
-                    :disabled="tray.isPending(job)"
-                    @click="deleteJob(job)"
-                  >
-                    <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" aria-hidden="true">
-                      <path d="M4 7h16M9 7V4h6v3m-8 0 1 13h8l1-13M10 11v5M14 11v5" />
-                    </svg>
-                  </button>
+                  <div class="mint-jobs-tray__job-actions">
+                    <slot name="job-actions" :job="job" />
+                    <button
+                      v-if="job.can_delete && tray.canDelete.value"
+                      type="button"
+                      class="mint-jobs-tray__icon-button mint-jobs-tray__icon-button--danger"
+                      aria-label="Delete job"
+                      :disabled="tray.isPending(job)"
+                      @click="deleteJob(job)"
+                    >
+                      <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" aria-hidden="true">
+                        <path d="M4 7h16M9 7V4h6v3m-8 0 1 13h8l1-13M10 11v5M14 11v5" />
+                      </svg>
+                    </button>
+                  </div>
                 </div>
               </article>
             </template>

package/src/components/SettingsModal.schema.ts

@@ -14,6 +14,9 @@ export const APPEARANCE_TAB_ID = 'appearance'
 export const APPEARANCE_TAB: SettingsTab = {
   id: APPEARANCE_TAB_ID,
   label: 'Appearance',
+  // Heroicons "swatch" — the built-in tab sits beside plugin tabs that all
+  // carry icons, so it needs one of its own to keep the rail consistent.
+  icon: '<svg fill="none" viewBox="0 0 24 24" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><path d="M4.098 19.902a3.75 3.75 0 0 0 5.304 0l6.401-6.402M6.75 21A3.75 3.75 0 0 1 3 17.25V4.125C3 3.504 3.504 3 4.125 3h5.25c.621 0 1.125.504 1.125 1.125v4.072M6.75 21a3.75 3.75 0 0 0 3.75-3.75V8.197M6.75 21h13.125c.621 0 1.125-.504 1.125-1.125v-5.25c0-.621-.504-1.125-1.125-1.125h-4.072M10.5 8.197l2.88-2.88c.438-.439 1.15-.439 1.59 0l3.712 3.713c.44.44.44 1.152 0 1.59l-2.879 2.88M6.75 17.25h.008v.008H6.75v-.008Z"></path></svg>',
   description: 'Theme, color palette, and table density',
 }
 

package/src/composables/index.ts

@@ -162,7 +162,6 @@ export {
   type DilutionPreset,
   type UseReagentSeriesReturn,
 } from './useReagentSeries'
-export { usePluginConfig, type UsePluginConfigReturn } from './usePluginConfig'
 export {
   useExperimentSelector,
   type UseExperimentSelectorOptions,
@@ -488,7 +487,6 @@ export {
   pluginFormDataFromPayload,
   resolvePluginBaseUrl,
   uploadPluginEndpoint,
-  usePluginClient,
   usePluginEventStream,
   usePluginSettings,
   useCurrentExperiment,
@@ -517,14 +515,9 @@ export {
 export {
   combinePluginJobSources,
   usePluginJobCenter,
-  useJobsStatusTray,
   type CombinedPluginJobCenterSource,
   type PluginJobCenterSource,
-  type JobsStatusTrayAdapter,
   type JobsStatusTrayTab,
-  type JobStreamMessage,
   type UsePluginJobCenterOptions,
   type UsePluginJobCenterReturn,
-  type UseJobsStatusTrayOptions,
-  type UseJobsStatusTrayReturn,
 } from './useJobsStatusTray'

package/src/composables/useAuth.ts

@@ -93,7 +93,6 @@ export function useAuth(): UseAuthReturn {
         passkey_enabled: boolean
         passkey_registered?: boolean
         registration_enabled?: boolean
-        database_mode?: string
         access?: {
           experiment_visibility_mode?: 'open' | 'restricted'
           experimentVisibilityMode?: 'open' | 'restricted'
@@ -105,7 +104,6 @@ export function useAuth(): UseAuthReturn {
         passkeyEnabled: response.data.passkey_enabled,
         passkeyRegistered: response.data.passkey_registered ?? false,
         registrationEnabled: response.data.registration_enabled ?? false,
-        databaseMode: response.data.database_mode ?? 'none',
         experimentVisibilityMode:
           response.data.access?.experiment_visibility_mode
           ?? response.data.access?.experimentVisibilityMode
@@ -121,7 +119,6 @@ export function useAuth(): UseAuthReturn {
         passkeyEnabled: false,
         passkeyRegistered: false,
         registrationEnabled: false,
-        databaseMode: 'none',
         experimentVisibilityMode: 'open',
       }
     }