@morscherlab/mint-sdk 1.2.0-beta.2 → 1.2.0-beta.3

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

@@ -1,93 +0,0 @@
-import { effectScope, nextTick, ref } from 'vue'
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
-import { useDebouncedWatch } from '../../composables/useDebouncedWatch'
-
-describe('useDebouncedWatch', () => {
-  beforeEach(() => {
-    vi.useFakeTimers()
-  })
-
-  afterEach(() => {
-    vi.useRealTimers()
-  })
-
-  it('debounces source changes and runs the latest callback value', async () => {
-    const query = ref('')
-    const calls: string[] = []
-
-    const watcher = useDebouncedWatch(query, value => {
-      calls.push(value)
-    }, { delay: 200 })
-
-    query.value = 'glu'
-    await nextTick()
-    query.value = 'glucose'
-    await nextTick()
-
-    expect(watcher.isPending.value).toBe(true)
-    vi.advanceTimersByTime(199)
-    expect(calls).toEqual([])
-
-    vi.advanceTimersByTime(1)
-    expect(calls).toEqual(['glucose'])
-    expect(watcher.isPending.value).toBe(false)
-  })
-
-  it('can cancel and flush pending callbacks without stopping the watcher', async () => {
-    const query = ref('')
-    const calls: string[] = []
-    const watcher = useDebouncedWatch(query, value => {
-      calls.push(value)
-    })
-
-    query.value = 'first'
-    await nextTick()
-    watcher.cancel()
-    vi.runAllTimers()
-    expect(calls).toEqual([])
-
-    query.value = 'second'
-    await nextTick()
-    watcher.flush()
-    expect(calls).toEqual(['second'])
-  })
-
-  it('runs callback cleanup when stopped or invalidated', async () => {
-    const query = ref('')
-    const cleanup = vi.fn()
-    const watcher = useDebouncedWatch(query, (_value, _oldValue, onCleanup) => {
-      onCleanup(cleanup)
-    }, { delay: 100 })
-
-    query.value = 'first'
-    await nextTick()
-    vi.advanceTimersByTime(100)
-
-    query.value = 'second'
-    await nextTick()
-    expect(cleanup).toHaveBeenCalledTimes(1)
-
-    vi.advanceTimersByTime(100)
-    watcher.stop()
-    expect(cleanup).toHaveBeenCalledTimes(2)
-  })
-
-  it('clears pending callbacks when the current effect scope disposes', async () => {
-    const query = ref('')
-    const calls: string[] = []
-    const scope = effectScope()
-
-    scope.run(() => {
-      useDebouncedWatch(query, value => {
-        calls.push(value)
-      })
-    })
-
-    query.value = 'pending'
-    await nextTick()
-    scope.stop()
-    vi.runAllTimers()
-
-    expect(calls).toEqual([])
-  })
-})

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

@@ -1,95 +0,0 @@
-import { mount } from '@vue/test-utils'
-import { defineComponent, nextTick } from 'vue'
-import { afterEach, describe, expect, it, vi } from 'vitest'
-import {
-  useDropdownState,
-  type UseDropdownStateOptions,
-  type UseDropdownStateReturn,
-} from '../../composables/useDropdownState'
-
-function mountHarness(options: UseDropdownStateOptions = {}) {
-  let state: UseDropdownStateReturn | undefined
-  const wrapper = mount(defineComponent({
-    setup() {
-      state = useDropdownState(options)
-      return state
-    },
-    template: '<div ref="rootRef" class="dropdown-root"><button class="inside">Inside</button></div>',
-  }), { attachTo: document.body })
-
-  if (!state) {
-    throw new Error('Dropdown harness did not initialize.')
-  }
-
-  return { wrapper, state }
-}
-
-describe('useDropdownState', () => {
-  afterEach(() => {
-    document.body.innerHTML = ''
-  })
-
-  it('opens, closes, and toggles with callbacks only on state changes', () => {
-    const onOpen = vi.fn()
-    const onClose = vi.fn()
-    const { wrapper, state } = mountHarness({ onOpen, onClose })
-
-    state.open()
-    state.open()
-    expect(state.isOpen.value).toBe(true)
-    expect(onOpen).toHaveBeenCalledTimes(1)
-
-    state.toggle()
-    state.close()
-    expect(state.isOpen.value).toBe(false)
-    expect(onClose).toHaveBeenCalledTimes(1)
-
-    state.toggle()
-    expect(state.isOpen.value).toBe(true)
-    expect(onOpen).toHaveBeenCalledTimes(2)
-
-    wrapper.unmount()
-  })
-
-  it('closes on outside click but keeps inside clicks open', async () => {
-    const { wrapper, state } = mountHarness()
-
-    state.open()
-    await nextTick()
-    await wrapper.find('.inside').trigger('click')
-    await nextTick()
-    expect(state.isOpen.value).toBe(true)
-
-    document.body.click()
-    await nextTick()
-    expect(state.isOpen.value).toBe(false)
-
-    wrapper.unmount()
-  })
-
-  it('closes on Escape by default', async () => {
-    const { wrapper, state } = mountHarness()
-
-    state.open()
-    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape' }))
-    await nextTick()
-
-    expect(state.isOpen.value).toBe(false)
-    wrapper.unmount()
-  })
-
-  it('can opt out of outside-click and Escape closing', async () => {
-    const { wrapper, state } = mountHarness({
-      closeOnOutsideClick: false,
-      closeOnEscape: false,
-    })
-
-    state.open()
-    document.body.click()
-    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'Escape' }))
-    await nextTick()
-
-    expect(state.isOpen.value).toBe(true)
-    wrapper.unmount()
-  })
-})

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

@@ -1,116 +0,0 @@
-import { mount } from '@vue/test-utils'
-import { defineComponent, nextTick, ref, type Ref } from 'vue'
-import { afterEach, describe, expect, it, vi } from 'vitest'
-import {
-  useEventListener,
-  type EventListenerStop,
-} from '../../composables/useEventListener'
-
-describe('useEventListener', () => {
-  afterEach(() => {
-    document.body.innerHTML = ''
-  })
-
-  it('binds on mount and removes the listener on unmount', async () => {
-    const listener = vi.fn()
-    const wrapper = mount(defineComponent({
-      setup() {
-        useEventListener(() => document, 'click', listener)
-      },
-      template: '<div />',
-    }))
-
-    document.body.click()
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(1)
-
-    wrapper.unmount()
-    document.body.click()
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(1)
-  })
-
-  it('returns a stop function for manual cleanup', async () => {
-    const listener = vi.fn()
-    let stop: EventListenerStop | undefined
-    const wrapper = mount(defineComponent({
-      setup() {
-        stop = useEventListener(() => document, 'keydown', listener)
-      },
-      template: '<div />',
-    }))
-
-    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'A' }))
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(1)
-
-    stop?.()
-    document.dispatchEvent(new KeyboardEvent('keydown', { key: 'B' }))
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(1)
-
-    wrapper.unmount()
-  })
-
-  it('moves listeners when a ref target changes', async () => {
-    const listener = vi.fn()
-    const first = document.createElement('button')
-    const second = document.createElement('button')
-    let target: Ref<HTMLElement | null> | undefined
-
-    const wrapper = mount(defineComponent({
-      setup() {
-        target = ref(first)
-        useEventListener(target, 'click', listener)
-      },
-      template: '<div />',
-    }))
-
-    first.click()
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(1)
-
-    if (!target) throw new Error('Target ref did not initialize.')
-    target.value = second
-    await nextTick()
-
-    first.click()
-    second.click()
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(2)
-
-    wrapper.unmount()
-    second.click()
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(2)
-  })
-
-  it('binds and removes listeners from a reactive enabled option', async () => {
-    const enabled = ref(false)
-    const listener = vi.fn()
-    const wrapper = mount(defineComponent({
-      setup() {
-        useEventListener(() => document, 'click', listener, { enabled })
-      },
-      template: '<div />',
-    }))
-
-    document.body.click()
-    await nextTick()
-    expect(listener).not.toHaveBeenCalled()
-
-    enabled.value = true
-    await nextTick()
-    document.body.click()
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(1)
-
-    enabled.value = false
-    await nextTick()
-    document.body.click()
-    await nextTick()
-    expect(listener).toHaveBeenCalledTimes(1)
-
-    wrapper.unmount()
-  })
-})

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

@@ -1,140 +0,0 @@
-import { effectScope } from 'vue'
-import { afterEach, describe, expect, it, vi } from 'vitest'
-
-import { useEventStream } from '../../composables/useEventStream'
-
-function pendingStreamResponse(): {
-  response: Response
-  close: () => void
-} {
-  let close!: () => void
-  const body = new ReadableStream<Uint8Array>({
-    start(controller) {
-      close = () => {
-        try {
-          controller.close()
-        } catch {
-          // stop() may already have cancelled the reader.
-        }
-      }
-    },
-  })
-  return { response: new Response(body), close }
-}
-
-describe('useEventStream', () => {
-  afterEach(() => {
-    vi.useRealTimers()
-  })
-
-  it('should decode chunked UTF-8 and dispatch an unterminated multiline tail frame', async () => {
-    const encoded = new TextEncoder().encode(
-      ': keepalive\nevent: result\nid: event-7\ndata: first\ndata: 2 µmol',
-    )
-    const split = encoded.indexOf(0xc2) + 1
-    const body = new ReadableStream<Uint8Array>({
-      start(controller) {
-        controller.enqueue(encoded.slice(0, split))
-        controller.enqueue(encoded.slice(split))
-        controller.close()
-      },
-    })
-    const onMessage = vi.fn()
-    const scope = effectScope()
-    const stream = scope.run(() => useEventStream('/events', {
-      transport: vi.fn(async () => new Response(body)),
-      reconnect: false,
-      onMessage,
-    }))!
-
-    await vi.waitFor(() => expect(onMessage).toHaveBeenCalledOnce())
-
-    expect(stream.lastMessage.value).toEqual({
-      event: 'result',
-      data: 'first\n2 µmol',
-      id: 'event-7',
-      retry: undefined,
-      raw: ': keepalive\nevent: result\nid: event-7\ndata: first\ndata: 2 µmol',
-    })
-    scope.stop()
-  })
-
-  it('should keep server retry delay local and send Last-Event-ID on reconnect', async () => {
-    vi.useFakeTimers()
-    const first = new Response('id: event-1\nretry: 7\ndata: first\n\n')
-    const second = pendingStreamResponse()
-    const transport = vi.fn()
-      .mockResolvedValueOnce(first)
-      .mockResolvedValueOnce(second.response)
-    const options = {
-      transport,
-      reconnectDelayMs: 1_000,
-    }
-    const scope = effectScope()
-    const stream = scope.run(() => useEventStream('/events', options))!
-
-    await vi.waitFor(() => expect(stream.lastEventId.value).toBe('event-1'))
-    await vi.advanceTimersByTimeAsync(7)
-
-    const secondHeaders = new Headers(transport.mock.calls[1]?.[1]?.headers)
-    expect({
-      attempts: transport.mock.calls.length,
-      lastEventId: secondHeaders.get('Last-Event-ID'),
-      configuredDelay: options.reconnectDelayMs,
-    }).toEqual({
-      attempts: 2,
-      lastEventId: 'event-1',
-      configuredDelay: 1_000,
-    })
-    stream.stop()
-    second.close()
-    scope.stop()
-  })
-
-  it('should apply control-only frames without dispatching a data message', async () => {
-    vi.useFakeTimers()
-    const second = pendingStreamResponse()
-    const transport = vi.fn()
-      .mockResolvedValueOnce(new Response('id: event-2\nretry: 7\n\n'))
-      .mockResolvedValueOnce(second.response)
-    const onMessage = vi.fn()
-    const scope = effectScope()
-    const stream = scope.run(() => useEventStream('/events', {
-      transport,
-      reconnectDelayMs: 1_000,
-      onMessage,
-    }))!
-
-    await vi.waitFor(() => expect(stream.lastEventId.value).toBe('event-2'))
-    await vi.advanceTimersByTimeAsync(7)
-
-    expect({
-      messages: onMessage.mock.calls.length,
-      reconnectCursor: new Headers(transport.mock.calls[1]?.[1]?.headers).get('Last-Event-ID'),
-    }).toEqual({ messages: 0, reconnectCursor: 'event-2' })
-    stream.stop()
-    second.close()
-    scope.stop()
-  })
-
-  it('should reconnect after an ordinary stream close', async () => {
-    vi.useFakeTimers()
-    const second = pendingStreamResponse()
-    const transport = vi.fn()
-      .mockResolvedValueOnce(new Response('data: first\n\n'))
-      .mockResolvedValueOnce(second.response)
-    const scope = effectScope()
-    const stream = scope.run(() => useEventStream('/events', {
-      transport,
-      reconnectDelayMs: 5,
-    }))!
-
-    await vi.waitFor(() => expect(stream.lastMessage.value?.data).toBe('first'))
-    await vi.advanceTimersByTimeAsync(5)
-
-    expect(transport).toHaveBeenCalledTimes(2)
-    stream.stop()
-    second.close()
-    scope.stop()
-  })
-})

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

@@ -1,62 +0,0 @@
-import { describe, expect, it } from 'vitest'
-import { nextTick, ref } from 'vue'
-import { useExpansionSet } from '../../composables/useExpansionSet'
-
-describe('useExpansionSet', () => {
-  it('tracks expanded ids without mutating defaults', () => {
-    const defaults = ['study', 'plate', 'plate']
-    const expansion = useExpansionSet({ defaultIds: defaults })
-
-    expect(expansion.expandedList.value).toEqual(['study', 'plate'])
-    expect(expansion.isExpanded('study')).toBe(true)
-    expect(expansion.toggle('study')).toBe(false)
-    expect(expansion.isExpanded('study')).toBe(false)
-    expect(expansion.toggle('sample')).toBe(true)
-    expect(expansion.expandedList.value).toEqual(['plate', 'sample'])
-
-    expansion.reset()
-    expect(expansion.expandedList.value).toEqual(['study', 'plate'])
-    expect(defaults).toEqual(['study', 'plate', 'plate'])
-  })
-
-  it('supports bulk expansion and collapse helpers', () => {
-    const expansion = useExpansionSet()
-
-    expansion.expand('study')
-    expansion.expandMany(['plate', 'sample', 'plate'])
-    expect(expansion.expandedList.value).toEqual(['study', 'plate', 'sample'])
-
-    expansion.collapse('plate')
-    expect(expansion.expandedList.value).toEqual(['study', 'sample'])
-
-    expansion.setExpanded(['treatment'])
-    expect(expansion.expandedList.value).toEqual(['treatment'])
-
-    expansion.collapseAll()
-    expect(expansion.expandedList.value).toEqual([])
-  })
-
-  it('reacts to expand-all and all-id sources', async () => {
-    const expandAll = ref(false)
-    const allIds = ref(['study', 'plate'])
-    const expansion = useExpansionSet({
-      defaultIds: ['study'],
-      allIds,
-      expandAll,
-    })
-
-    expect(expansion.expandedList.value).toEqual(['study'])
-
-    expandAll.value = true
-    await nextTick()
-    expect(expansion.expandedList.value).toEqual(['study', 'plate'])
-
-    allIds.value = ['study', 'plate', 'sample']
-    await nextTick()
-    expect(expansion.expandedList.value).toEqual(['study', 'plate', 'sample'])
-
-    expandAll.value = false
-    await nextTick()
-    expect(expansion.expandedList.value).toEqual(['study'])
-  })
-})

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

@@ -1,154 +0,0 @@
-/**
- * Tests for useExperimentData.
- *
- * Covers the derived computeds plugins rely on when rendering plugin
- * data that was saved via the platform's /api/experiments/{id}/data
- * endpoint:
- *
- * - tree_data / treeData snake-or-camel case handling
- * - table_data / tableData
- * - summary_data validation (must have a `metadata` key)
- * - load / refresh / error paths
- * - lastLoadedAt tracks successful syncs
- */
-
-import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'
-import { createPinia, setActivePinia } from 'pinia'
-import axios, { type AxiosRequestConfig } from 'axios'
-
-import { useExperimentData } from '../../composables/useExperimentData'
-
-let fakeResponse: unknown = null
-let fakeError: Error | null = null
-let recordedUrls: string[] = []
-
-describe('useExperimentData', () => {
-  beforeEach(() => {
-    setActivePinia(createPinia())
-    fakeResponse = {}
-    fakeError = null
-    recordedUrls = []
-    vi.spyOn(axios.Axios.prototype, 'get').mockImplementation(async function (
-      this: unknown,
-      url: string,
-      _config?: AxiosRequestConfig,
-    ) {
-      recordedUrls.push(url)
-      if (fakeError) throw fakeError
-      return { data: fakeResponse }
-    })
-  })
-
-  afterEach(() => {
-    vi.restoreAllMocks()
-  })
-
-  it('fetch resolves data and flips isLoading', async () => {
-    fakeResponse = { tree_data: [{ id: 'a', label: 'A' }] }
-    const hook = useExperimentData()
-
-    expect(hook.isLoading.value).toBe(false)
-    expect(hook.lastLoadedAt.value).toBeNull()
-    const p = hook.fetch(42)
-    expect(hook.isLoading.value).toBe(true)
-    await p
-    expect(hook.isLoading.value).toBe(false)
-    expect(hook.data.value).toEqual({ tree_data: [{ id: 'a', label: 'A' }] })
-    expect(hook.lastLoadedAt.value).toBeInstanceOf(Date)
-    expect(recordedUrls[0]).toBe('/experiments/42/data')
-  })
-
-  it('exposes tree_data via treeData regardless of snake vs camel', async () => {
-    fakeResponse = { tree_data: [{ id: '1' }] }
-    const hook1 = useExperimentData()
-    await hook1.fetch(1)
-    expect(hook1.treeData.value).toEqual([{ id: '1' }])
-
-    fakeResponse = { treeData: [{ id: '2' }] }
-    const hook2 = useExperimentData()
-    await hook2.fetch(2)
-    expect(hook2.treeData.value).toEqual([{ id: '2' }])
-  })
-
-  it('unwraps platform design-data responses and exposes sample helpers', async () => {
-    const response = {
-      experiment_id: 42,
-      plugin_id: 'ms-designer',
-      schema_version: '1.0',
-      data: {
-        tree_data: [{ id: 'design' }],
-        samples: [
-          { sample_name: 'S1', sample_type: 'sample', conditions: { group: 'A' } },
-          { sample_name: 'Blank', sample_type: 'blank', conditions: { group: 'QC' } },
-        ],
-      },
-    }
-    fakeResponse = response
-    const hook = useExperimentData()
-    await hook.fetch(42)
-
-    expect(hook.designData.value).toEqual(response.data)
-    expect(hook.treeData.value).toEqual([{ id: 'design' }])
-    expect(hook.sampleNames.value).toEqual(['S1'])
-    expect(hook.sampleOptions.value).toEqual([{ value: 'S1', label: 'S1' }])
-  })
-
-  it('tableData falls back to empty array when absent', async () => {
-    fakeResponse = {}
-    const hook = useExperimentData()
-    await hook.fetch(1)
-    expect(hook.tableData.value).toEqual([])
-  })
-
-  it('summaryData requires a metadata key', async () => {
-    fakeResponse = { summary_data: { metadata: { n: 1 }, sections: [] } }
-    const hook = useExperimentData()
-    await hook.fetch(1)
-    expect(hook.summaryData.value).toEqual({
-      metadata: { n: 1 },
-      sections: [],
-    })
-
-    // Invalid summary shape -> returns null
-    fakeResponse = { summary_data: { notmeta: true } }
-    const hook2 = useExperimentData()
-    await hook2.fetch(2)
-    expect(hook2.summaryData.value).toBeNull()
-  })
-
-  it('refresh reuses the last experimentId', async () => {
-    fakeResponse = { tree_data: [] }
-    const hook = useExperimentData()
-    await hook.fetch(99)
-    recordedUrls.length = 0
-
-    await hook.refresh()
-    expect(recordedUrls).toEqual(['/experiments/99/data'])
-  })
-
-  it('refresh before any fetch is a noop', async () => {
-    const hook = useExperimentData()
-    await hook.refresh()
-    expect(recordedUrls).toEqual([])
-  })
-
-  it('sets error and clears data on network failure', async () => {
-    fakeError = new Error('boom')
-    const hook = useExperimentData()
-    await hook.fetch(1)
-    expect(hook.error.value).toBe('boom')
-    expect(hook.data.value).toBeNull()
-    expect(hook.isLoading.value).toBe(false)
-    expect(hook.lastLoadedAt.value).toBeNull()
-  })
-
-  it('apiBaseUrl option is honoured', async () => {
-    fakeResponse = {}
-    const hook = useExperimentData({ apiBaseUrl: '/api/plugin' })
-    await hook.fetch(5)
-    // useApi attaches baseURL to the request config; the mocked axios
-    // call records it in recordedUrls as the relative URL only, so we
-    // can't observe baseURL directly here — assert the URL shape.
-    expect(recordedUrls[0]).toBe('/experiments/5/data')
-  })
-})