@morscherlab/mint-sdk 1.3.8 → 1.4.0-beta.1

package/src/composables/controlSchemaModel.ts

@@ -34,7 +34,7 @@ export function resolveControlModel(
 }
 
 /**
- * Create a complete workspace component binding from a simple controls data model for ControlWorkspaceView, generated forms, and sidebars.
+ * Create a complete control model binding for FormBuilder, SettingsModal and the PluginWorkspaceView sidebar from a simple controls data model.
  *
  * @example Recommended
  * ```ts

package/src/composables/controlSchemaTypes.ts

@@ -4,23 +4,24 @@ import type {
 } from 'vue'
 import type {
   PillNavItem,
-  SidebarBadgeTone,
   SidebarToolSection,
   SidebarToolSectionAction,
   SelectOption,
   SettingsModalSchema,
   TopBarSettingsConfig,
+  Tone,
 } from '../types'
 import type { AccessPolicy } from '../permissions'
 import type {
   FieldCondition,
   FieldValidation,
+  FormEnhancements,
   FormFieldSchema,
   FormFieldType,
   FormSchema,
   FormSectionSchema,
 } from '../types/form-builder'
-import type { WellConcentration } from './useDoseCalculator'
+import type { WellConcentration } from '../utils/dose'
 
 export type ControlOptionValue = string | number | boolean
 export type ControlOption = ControlOptionValue | SelectOption<unknown>
@@ -38,7 +39,7 @@ export interface ControlSectionConfig {
   iconColor?: string
   iconBg?: string
   badge?: string | number
-  badgeTone?: SidebarBadgeTone
+  badgeTone?: Tone
   actions?: SidebarToolSectionAction[]
   columns?: 1 | 2 | 3
   condition?: FieldCondition
@@ -107,6 +108,12 @@ export interface ControlSchemaOptions {
   sectionLabel?: string
   sections?: Record<string, ControlSectionConfig>
   columns?: 1 | 2 | 3
+  /** Submit / cancel bar of the generated form; unset or `false` hides it. */
+  actions?: boolean | ControlFormActions
+}
+
+/** Labels of the generated form's submit / cancel bar. */
+export interface ControlFormActions {
   submitLabel?: string
   cancelLabel?: string
   showCancel?: boolean
@@ -114,7 +121,9 @@ export interface ControlSchemaOptions {
 
 export interface ControlWorkspaceOptions extends ControlSchemaOptions {
   initialValues?: Record<string, unknown>
-  topBarSettings?: Omit<TopBarSettingsConfig, 'schema' | 'controls' | 'controlOptions' | 'values'>
+  /** Validators, dynamic options, a submit handler and field callbacks that JSON cannot express. */
+  enhancements?: FormEnhancements<Record<string, unknown>>
+  topBarSettings?: Omit<TopBarSettingsConfig, 'spec' | 'values'>
 }
 
 export interface ControlModelSectionConfig extends ControlSectionConfig {
@@ -138,7 +147,7 @@ export interface ControlModel extends Omit<ControlWorkspaceOptions, 'sections' |
   componentBindings?: ControlComponentBindingsConfig
   /** Alias for componentBindings in raw control models. */
   components?: ControlComponentBindingsConfig
-  /** Optional ControlWorkspaceView componentProps mapping returned with the generated controls/options. */
+  /** Optional componentProps mapping returned with the generated controls/options. */
   componentProps?: ControlComponentPropsMap
   /** Optional named componentProps mappings returned for multiple SDK components. */
   componentPropsById?: ControlComponentPropsByIdMap
@@ -152,25 +161,28 @@ export interface ControlModelBinding {
   componentPropsById?: ControlComponentPropsByIdMap
 }
 
+/** AppSidebar props (`v-bind`) for the generated sections and forms. */
 export interface ControlSidebarBinding {
-  panels: Record<string, SidebarToolSection[]>
-  forms: Record<string, ControlFormSchema>
-  viewIds: string[]
-  viewItems: PillNavItem[]
-  defaultView: string
+  spec: {
+    panels: Record<string, SidebarToolSection[]>
+    forms: Record<string, ControlFormSchema>
+  }
+  activeView: string
 }
 
+/** FormBuilder props (`v-bind`) for the generated form. */
 export interface ControlFormBinding {
-  schema: ControlFormSchema
+  spec: ControlModelBinding
 }
 
+/** SettingsModal props (`v-bind`) for the generated settings. */
 export interface ControlSettingsBinding {
-  schema: SettingsModalSchema
+  spec: SettingsModalSchema
 }
 
+/** AppTopBar props (`v-bind`) for the generated settings button. */
 export interface ControlTopBarSettingsBinding {
-  showSettings: true
-  settingsConfig: TopBarSettingsConfig
+  spec: { settings: TopBarSettingsConfig }
 }
 
 export interface ControlWorkspaceFormBinding extends ControlFormBinding {
@@ -179,9 +191,6 @@ export interface ControlWorkspaceFormBinding extends ControlFormBinding {
 }
 
 export interface ControlWorkspaceSidebarBinding extends ControlSidebarBinding {
-  activeView: string
-  modelValue: Record<string, unknown>
-  'onUpdate:modelValue': (values: Record<string, unknown>) => void
   values: Record<string, unknown>
   'onUpdate:values': (values: Record<string, unknown>) => void
 }
@@ -196,10 +205,12 @@ export interface ControlWorkspacePillNavBinding {
   onSelect: (item: PillNavItem) => void
 }
 
-export interface ControlWorkspaceTopBarBinding extends ControlWorkspaceTopBarSettingsBinding {
-  pillNav: PillNavItem[]
-  currentPillId: string
+/** AppTopBar props (`v-bind`) for the generated view pills and settings button. */
+export interface ControlWorkspaceTopBarBinding {
+  spec: { pills: PillNavItem[]; settings: TopBarSettingsConfig }
+  pill: string
   onPillSelect: (item: PillNavItem) => void
+  onSettingsValuesChange: (values: Record<string, unknown>) => void
 }
 
 export type ControlWorkspaceAppTopBarPillBinding = ControlWorkspaceTopBarBinding
@@ -257,8 +268,6 @@ export interface WellPlateControlPropsOptions<TValues extends Record<string, unk
   disabled?: ControlComponentPropSource<TValues>
   readonly?: ControlComponentPropSource<TValues>
   showLegend?: ControlComponentPropSource<TValues>
-  /** @deprecated WellPlate `showSampleTypeIndicator` is a no-op since MINT 1.3; removed in MINT 1.4. */
-  showSampleTypeIndicator?: ControlComponentPropSource<TValues>
   /** Listener for WellPlate v-model updates. Set false to keep generated props one-way. */
   onUpdateModelValue?: ((values: TValues) => (wellIds: string[]) => void) | false
 }

package/src/composables/{usePluginClient.ts → createClient.ts}

@@ -3,7 +3,6 @@ import {
   onMounted,
   ref,
   shallowRef,
-  watch,
   type ComputedRef,
   type Ref,
 } from 'vue'
@@ -12,37 +11,31 @@ import {
   authenticationRequiredError,
   useApi,
 } from './useApi'
-import { usePlatformContext } from './usePlatformContext'
-import { useRequestSyncState } from './useRequestSyncState'
+import { usePlatform } from './usePlatform'
+import { useRequest } from './useRequest'
 import { useAuthStore } from '../stores/auth'
-import { PLUGIN_SECRET_FORMAT_KEY } from '../utils/pluginSecrets'
+import * as pluginSecret from '../utils/pluginSecrets'
+import { getInjectedPlatformContext } from './platformContextHelpers'
 import {
-  currentExperimentFromContext,
-  getInjectedPlatformContext,
-  resolveCurrentExperimentId,
-} from './platformContextHelpers'
-import {
-  buildPluginEndpointUrl,
+  buildEndpointUrl,
   hasKeys,
   pluginEndpointRequestParts,
   requestBodyFromPayload,
 } from './pluginEndpointBuilder'
 import {
-  useEventStream,
+  createEventStream,
   type EventStreamMessage,
   type EventStreamTransport,
   type UseEventStreamReturn,
-} from './useEventStream'
+} from './eventStream'
 import type {
-  ExperimentSummary,
   GeneratedJobDefinition,
-  PageSelectorItem,
   SettingsModalSchema,
   TopBarSettingsConfig,
 } from '../types'
 
 export {
-  buildPluginEndpointUrl,
+  buildEndpointUrl,
   resolvePluginBaseUrl,
 } from './pluginEndpointBuilder'
 
@@ -77,7 +70,7 @@ export interface PluginNavItemContract {
   icon?: string
   description?: string
   requiresAuth?: boolean
-  requiresAdmin?: boolean
+  access?: 'use' | 'configure' | 'admin'
   requiresFeature?: string
 }
 
@@ -134,12 +127,12 @@ export type PluginEndpointParamDefinition = string | {
   required?: boolean
 }
 
-export interface CreatePluginClientOptions {
+export interface CreateClientOptions {
   endpoints: Record<string, PluginEndpointDefinition>
   baseUrl?: string
 }
 
-export interface BuildPluginEndpointUrlOptions {
+export interface BuildEndpointUrlOptions {
   /** Override the generated or platform-injected API base URL. */
   baseUrl?: string
   /** Return only the endpoint path and query string instead of base URL + path. */
@@ -158,9 +151,11 @@ export interface PluginClientRequestOptions {
   signal?: AbortSignal
 }
 
-export interface DownloadPluginEndpointOptions extends PluginEndpointRequestOptions {
+export interface DownloadEndpointOptions extends PluginEndpointRequestOptions {
   /** Browser download filename. When omitted, the blob is returned without triggering a download. */
   filename?: string
+  /** Save the blob as `filename` in the browser. Default true; `false` only returns the blob. */
+  save?: boolean
   /** Delay before revoking the object URL after a browser download is triggered. */
   revokeObjectUrlDelayMs?: number
 }
@@ -172,7 +167,7 @@ export interface DownloadBlobOptions {
 
 export type PluginSettingsValues<TSettings> = Partial<TSettings> & Record<string, unknown>
 
-export interface UsePluginSettingsOptions {
+export interface UseSettingsEndpointOptions {
   /** 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. */
@@ -189,7 +184,7 @@ export interface UsePluginSettingsOptions {
   loadOnMount?: boolean
 }
 
-export interface UsePluginSettingsReturn<TSettings = Record<string, unknown>> {
+export interface UseSettingsEndpointReturn<TSettings = Record<string, unknown>> {
   /** Current typed settings values. */
   settings: ComputedRef<PluginSettingsValues<TSettings>>
   /** Editable settings values for SettingsModal. */
@@ -210,9 +205,9 @@ export interface UsePluginSettingsReturn<TSettings = Record<string, unknown>> {
   reset: () => void
 }
 
-export type PluginEventStreamMessage<TData = string> = EventStreamMessage<TData>
+export type { EventStreamMessage, UseEventStreamReturn } from './eventStream'
 
-export interface PluginEventStreamOptions<TData = string> {
+export interface StreamOptions<TData = string> {
   /** Override the generated or platform-injected API base URL. */
   baseUrl?: string
   /** Start the stream immediately. Defaults to true. */
@@ -228,12 +223,10 @@ export interface PluginEventStreamOptions<TData = string> {
   /** Extra request headers. Authorization is injected unless already supplied. */
   headers?: Record<string, string>
   onOpen?: () => void
-  onMessage?: (message: PluginEventStreamMessage<TData>) => void
+  onMessage?: (message: EventStreamMessage<TData>) => void
   onError?: (error: unknown) => void
 }
 
-export type UsePluginEventStreamReturn<TData = string> = UseEventStreamReturn<TData>
-
 export type PluginFormDataValue =
   | string
   | number
@@ -245,32 +238,6 @@ export type PluginFormDataValue =
 
 export type PluginFormDataPayload = Record<string, PluginFormDataValue | PluginFormDataValue[]>
 
-export interface UseCurrentExperimentOptions {
-  apiBaseUrl?: string
-  immediate?: boolean
-}
-
-export interface UseCurrentExperimentReturn<TExperiment = ExperimentSummary> {
-  /** Current experiment id resolved from platform injection or URL conventions. */
-  experimentId: ComputedRef<number | undefined>
-  /** Whether a current experiment id is available. */
-  hasExperiment: ComputedRef<boolean>
-  /** Current experiment payload, if injected or successfully fetched. */
-  experiment: Ref<TExperiment | undefined>
-  /** Whether the current experiment is currently loading. */
-  isLoading: Ref<boolean>
-  /** Error message from the last failed current-experiment fetch, or null. */
-  error: Ref<string | null>
-  /** Timestamp of the last successful current-experiment fetch, or null. */
-  lastLoadedAt: Ref<Date | null>
-  /** Return the current experiment id or throw a clear SDK error when absent. */
-  requireExperimentId: () => number
-  /** Fetch a specific experiment id, defaulting to the current experiment id. */
-  fetch: (experimentId?: number) => Promise<TExperiment | undefined>
-  /** Refetch the currently resolved experiment id. */
-  refresh: () => Promise<TExperiment | undefined>
-}
-
 export type PluginEndpointCaller = (
   payloadOrOptions?: unknown,
   options?: PluginClientRequestOptions,
@@ -379,34 +346,10 @@ export function downloadBlob(blob: Blob, filename: string, options: DownloadBlob
   setTimeout(() => URL.revokeObjectURL(blobUrl), options.revokeObjectUrlDelayMs ?? 100)
 }
 
-function normalizePluginNavPath(path: string): string {
-  const raw = path.trim() || '/'
-  const prefixed = raw.startsWith('/') ? raw : `/${raw}`
-  return prefixed.replace(/\/+$/, '') || '/'
-}
-
-function pluginPageIdFromPath(path: string, fallbackIndex: number): string {
-  const normalizedPath = normalizePluginNavPath(path)
-  if (normalizedPath === '/') return 'dashboard'
-  return normalizedPath.replace(/^\/+/, '').replace(/\/+/g, '-') || `page-${fallbackIndex + 1}`
-}
-
-/** Convert resolved @mint_plugin nav_items into page selectors for the topbar and homepage PluginCards. */
-export function getPluginPageSelectorItems(contract: PluginContract): PageSelectorItem[] {
-  const pluginIcon = contract.plugin.icon ?? ''
-  const navItems = contract.plugin.navItems ?? []
-  return navItems.map((item, index) => ({
-    id: item.id || pluginPageIdFromPath(item.path, index),
-    label: item.label,
-    to: normalizePluginNavPath(item.path),
-    icon: item.icon || pluginIcon || undefined,
-  }))
-}
-
 /** Create a typed plugin API client from a generated MINT plugin contract. */
-export function createPluginClient<TClient extends object = GeneratedPluginClient>(
+export function createClient<TClient extends object = GeneratedPluginClient>(
   contract: PluginContract,
-  options: CreatePluginClientOptions,
+  options: CreateClientOptions,
 ): TClient {
   const client: Record<string, PluginEndpointCaller> = {}
 
@@ -424,7 +367,6 @@ export function createPluginClient<TClient extends object = GeneratedPluginClien
       const api = useApi({
         baseUrl: parts.baseUrl,
         withAuth: endpoint.requiresAuth !== false,
-        typedErrors: true,
       })
       const config = endpointRequestConfig(endpoint, parts.query, callOptions)
 
@@ -457,7 +399,7 @@ export function createPluginClient<TClient extends object = GeneratedPluginClien
 }
 
 /** Send multipart or raw binary data to a generated endpoint with contract URL, cancellation, and auth handling. */
-export async function uploadPluginEndpoint<TResponse = unknown>(
+export async function uploadEndpoint<TResponse = unknown>(
   contract: PluginContract,
   endpoint: PluginEndpointDefinition,
   payload?: unknown,
@@ -471,7 +413,6 @@ export async function uploadPluginEndpoint<TResponse = unknown>(
   const api = useApi({
     baseUrl: parts.baseUrl,
     withAuth: endpoint.requiresAuth !== false,
-    typedErrors: true,
   })
   const body = endpoint.hasBody
     ? requestBodyFromPayload(payload, parts.requestPayload, endpoint)
@@ -496,11 +437,11 @@ export async function uploadPluginEndpoint<TResponse = unknown>(
 }
 
 /** Fetch a generated plugin endpoint as a Blob and optionally trigger a browser download. */
-export async function downloadPluginEndpoint(
+export async function downloadEndpoint(
   contract: PluginContract,
   endpoint: PluginEndpointDefinition,
   payload?: unknown,
-  options: DownloadPluginEndpointOptions = {},
+  options: DownloadEndpointOptions = {},
 ): Promise<Blob> {
   if (endpoint.requestContentType === MULTIPART_FORM_DATA) {
     throw new Error('[MINT SDK] Plugin download endpoints do not support multipart request bodies')
@@ -510,7 +451,6 @@ export async function downloadPluginEndpoint(
   const api = useApi({
     baseUrl: parts.baseUrl,
     withAuth: endpoint.requiresAuth !== false,
-    typedErrors: true,
   })
   const config = {
     ...(endpointRequestConfig(endpoint, parts.query, { signal: options.signal }) ?? {}),
@@ -530,7 +470,7 @@ export async function downloadPluginEndpoint(
     throw new Error(`[MINT SDK] Unsupported plugin endpoint method: ${endpoint.method}`)
   }
 
-  if (options.filename) {
+  if (options.filename && options.save !== false) {
     downloadBlob(blob, options.filename, {
       revokeObjectUrlDelayMs: options.revokeObjectUrlDelayMs,
     })
@@ -539,15 +479,10 @@ export async function downloadPluginEndpoint(
   return blob
 }
 
-function normalizePluginSettingsOptions(options: UsePluginSettingsOptions | string = {}): UsePluginSettingsOptions {
+function normalizePluginSettingsOptions(options: UseSettingsEndpointOptions | string = {}): UseSettingsEndpointOptions {
   return typeof options === 'string' ? { pluginName: options } : options
 }
 
-/** @deprecated Removed in MINT 1.4; use `useGeneratedPluginClient()` for generated clients. */
-export function usePluginClient<TClient>(client: TClient): TClient {
-  return client
-}
-
 const PLATFORM_OWNED_SETTINGS_KEY = 'allowed_experiment_types'
 
 /**
@@ -561,12 +496,12 @@ function withSecretFormat(
   secretFormat: string | null,
 ): Record<string, unknown> {
   if (!secretFormat) return payload
-  return { ...payload, [PLUGIN_SECRET_FORMAT_KEY]: secretFormat }
+  return { ...payload, [pluginSecret.FORMAT_KEY]: secretFormat }
 }
 
 function responseSecretFormat(response: unknown): string | null {
   if (!response || typeof response !== 'object') return null
-  const format = (response as Record<string, unknown>)[PLUGIN_SECRET_FORMAT_KEY]
+  const format = (response as Record<string, unknown>)[pluginSecret.FORMAT_KEY]
   return typeof format === 'string' && format ? format : null
 }
 
@@ -631,12 +566,12 @@ function platformOwnedSettingsPatch(settings: Record<string, unknown>): Record<s
 }
 
 /** Load, edit, and persist plugin settings from platform config or the plugin-local settings router. */
-export function usePluginSettings<TSettings = Record<string, unknown>>(
-  options: UsePluginSettingsOptions | string = {},
-): UsePluginSettingsReturn<TSettings> {
+export function useSettingsEndpoint<TSettings = Record<string, unknown>>(
+  options: UseSettingsEndpointOptions | string = {},
+): UseSettingsEndpointReturn<TSettings> {
   const resolvedOptions = normalizePluginSettingsOptions(options)
   const injectedContext = getInjectedPlatformContext()
-  const { plugin, isIntegrated } = usePlatformContext()
+  const { plugin, integrated: isIntegrated } = usePlatform()
   const platformApi = useApi({ baseUrl: resolvedOptions.platformApiBaseUrl ?? injectedContext?.platformApiUrl })
   const pluginApi = useApi({ baseUrl: resolvedOptions.apiBaseUrl ?? injectedContext?.plugin?.api_prefix })
 
@@ -644,7 +579,7 @@ export function usePluginSettings<TSettings = Record<string, unknown>>(
   const savedValues = shallowRef<Record<string, unknown>>({})
   const revision = ref<string | null>(null)
   const secretFormat = ref<string | null>(null)
-  const request = useRequestSyncState('Plugin settings request failed.')
+  const request = useRequest('Plugin settings request failed.')
   const isLoading = ref(false)
   const isSaving = ref(false)
 
@@ -667,7 +602,7 @@ export function usePluginSettings<TSettings = Record<string, unknown>>(
   const isDirty = computed(() => JSON.stringify(values.value) !== JSON.stringify(savedValues.value))
   const settingsConfig = computed<TopBarSettingsConfig>(() => ({
     title: resolvedOptions.title,
-    schema: resolvedOptions.schema ?? undefined,
+    spec: resolvedOptions.schema ?? undefined,
     showAppearance: resolvedOptions.showAppearance,
     values: values.value,
   }))
@@ -696,11 +631,11 @@ export function usePluginSettings<TSettings = Record<string, unknown>>(
           () => platformApi.get<{ plugin_name: string; config: Record<string, unknown> }>(
             `/plugins/${encodeURIComponent(resolvedPluginName.value)}/config`,
           ),
-          { success: 'load', errorMessage: 'Failed to load plugin settings' },
+          { kind: 'load', errorMessage: 'Failed to load plugin settings' },
         )
         : await request.run(
           () => pluginApi.get<{ settings: Record<string, unknown>; mode?: string }>('/settings'),
-          { success: 'load', errorMessage: 'Failed to load plugin settings' },
+          { kind: 'load', errorMessage: 'Failed to load plugin settings' },
         )
       applyLoaded(
         responseSettingsPayload(response),
@@ -746,7 +681,7 @@ export function usePluginSettings<TSettings = Record<string, unknown>>(
                 ),
               },
             ),
-            { success: 'save', errorMessage: 'Failed to save plugin settings' },
+            { kind: 'save', errorMessage: 'Failed to save plugin settings' },
           )
           nextRevision = responseSettingsRevision(response) ?? nextRevision
         }
@@ -761,7 +696,7 @@ export function usePluginSettings<TSettings = Record<string, unknown>>(
               `/plugins/${encodeURIComponent(resolvedPluginName.value)}/config`,
               { config: platformOwnedSettingsPatch(payload) },
             ),
-            { success: 'save', errorMessage: 'Failed to save plugin settings' },
+            { kind: 'save', errorMessage: 'Failed to save plugin settings' },
           )
           nextRevision = responseSettingsRevision(response) ?? nextRevision
         }
@@ -783,7 +718,7 @@ export function usePluginSettings<TSettings = Record<string, unknown>>(
             mode?: string
             revision?: string
           }>('/settings', withSecretFormat(payload, secretFormat.value), ifMatch),
-          { success: 'save', errorMessage: 'Failed to save plugin settings' },
+          { kind: 'save', errorMessage: 'Failed to save plugin settings' },
         )
       }
       applyLoaded(
@@ -869,7 +804,7 @@ function pluginEventStreamTransport(
   }
 }
 
-function looksLikeEventStreamOptions(value: unknown): value is PluginEventStreamOptions {
+function looksLikeEventStreamOptions(value: unknown): value is StreamOptions {
   if (!value || typeof value !== 'object') return false
   const candidate = value as Record<string, unknown>
   return [
@@ -887,23 +822,23 @@ function looksLikeEventStreamOptions(value: unknown): value is PluginEventStream
 }
 
 /** Consume a generated plugin SSE endpoint with auth headers, reconnect, and teardown. */
-export function usePluginEventStream<TData = string>(
+export function useEventStream<TData = string>(
   contract: PluginContract,
   endpoint: PluginEndpointDefinition,
-  options?: PluginEventStreamOptions<TData>,
-): UsePluginEventStreamReturn<TData>
-export function usePluginEventStream<TData = string>(
+  options?: StreamOptions<TData>,
+): UseEventStreamReturn<TData>
+export function useEventStream<TData = string>(
   contract: PluginContract,
   endpoint: PluginEndpointDefinition,
   payload?: unknown,
-  options?: PluginEventStreamOptions<TData>,
-): UsePluginEventStreamReturn<TData>
-export function usePluginEventStream<TData = string>(
+  options?: StreamOptions<TData>,
+): UseEventStreamReturn<TData>
+export function useEventStream<TData = string>(
   contract: PluginContract,
   endpoint: PluginEndpointDefinition,
   payloadOrOptions?: unknown,
-  maybeOptions?: PluginEventStreamOptions<TData>,
-): UsePluginEventStreamReturn<TData> {
+  maybeOptions?: StreamOptions<TData>,
+): UseEventStreamReturn<TData> {
   if (endpoint.method !== 'get') {
     throw new Error(`[MINT SDK] Plugin event streams must use GET; got ${endpoint.method}`)
   }
@@ -914,11 +849,11 @@ export function usePluginEventStream<TData = string>(
     maybeOptions === undefined && looksLikeEventStreamOptions(payloadOrOptions)
       ? payloadOrOptions
       : maybeOptions ?? {}
-  ) as PluginEventStreamOptions<TData>
+  ) as StreamOptions<TData>
   const responseType = endpoint.responseType?.trim()
   const parseJson = options.parseJson ?? Boolean(responseType && responseType !== 'string')
-  return useEventStream<TData>(
-    () => buildPluginEndpointUrl(contract, endpoint, payload, { baseUrl: options.baseUrl }),
+  return createEventStream<TData>(
+    () => buildEndpointUrl(contract, endpoint, payload, { baseUrl: options.baseUrl }),
     {
       transport: pluginEventStreamTransport(endpoint),
       immediate: options.immediate,
@@ -935,76 +870,3 @@ export function usePluginEventStream<TData = string>(
     },
   )
 }
-
-/** Read and optionally load the current platform experiment for integrated plugin views. */
-export function useCurrentExperiment<TExperiment = ExperimentSummary>(
-  options: UseCurrentExperimentOptions = {},
-): UseCurrentExperimentReturn<TExperiment> {
-  const api = useApi({ baseUrl: options.apiBaseUrl ?? getInjectedPlatformContext()?.platformApiUrl })
-  const experiment = shallowRef<TExperiment | undefined>(currentExperimentFromContext<TExperiment>())
-  const request = useRequestSyncState('Failed to load current experiment')
-  const isLoading = request.loading
-  const error = request.error
-  const lastLoadedAt = request.lastLoadedAt
-
-  const experimentId = computed<number | undefined>(() => {
-    return resolveCurrentExperimentId()
-  })
-  const hasExperiment = computed(() => experimentId.value !== undefined)
-
-  function requireExperimentId(): number {
-    const id = experimentId.value
-    if (id === undefined) {
-      throw new Error('[MINT SDK] No current experiment is selected.')
-    }
-    return id
-  }
-
-  async function fetchExperiment(id = experimentId.value): Promise<TExperiment | undefined> {
-    if (id === undefined) {
-      experiment.value = currentExperimentFromContext<TExperiment>()
-      return experiment.value
-    }
-
-    try {
-      const result = await request.run(
-        () => api.get<TExperiment>(`/experiments/${id}`),
-        { success: 'load', errorMessage: 'Failed to load current experiment' },
-      )
-      experiment.value = result
-      return result
-    } catch (e) {
-      experiment.value = undefined
-      return undefined
-    }
-  }
-
-  async function refresh(): Promise<TExperiment | undefined> {
-    return fetchExperiment()
-  }
-
-  watch(
-    experimentId,
-    (id) => {
-      if (options.immediate === false) return
-      if (id === undefined) {
-        experiment.value = currentExperimentFromContext<TExperiment>()
-        return
-      }
-      void fetchExperiment(id)
-    },
-    { immediate: options.immediate !== false },
-  )
-
-  return {
-    experimentId,
-    hasExperiment,
-    experiment,
-    isLoading,
-    error,
-    lastLoadedAt,
-    requireExperimentId,
-    fetch: fetchExperiment,
-    refresh,
-  }
-}

package/src/composables/{useEventStream.ts → eventStream.ts}

@@ -22,7 +22,7 @@ export interface EventStreamMessage<TData = string> {
   raw: string
 }
 
-export interface EventStreamOptions<TData = string> {
+export interface CreateEventStreamOptions<TData = string> {
   transport?: EventStreamTransport
   headers?: HeadersInit
   credentials?: RequestCredentials
@@ -112,9 +112,9 @@ export function parseEventStreamBlock<TData>(
 }
 
 /** Shared fetch-based SSE lifecycle with cancellation and reconnect safety. */
-export function useEventStream<TData = string>(
+export function createEventStream<TData = string>(
   url: string | (() => string),
-  options: EventStreamOptions<TData> = {},
+  options: CreateEventStreamOptions<TData> = {},
 ): UseEventStreamReturn<TData> {
   const isConnected = ref(false)
   const isConnecting = ref(false)