@morscherlab/mint-sdk 1.2.0-beta.9 → 1.2.0

package/src/composables/useGeneratedAnalysis.ts

@@ -14,6 +14,7 @@ import type {
 } from './useJobsStatusTray'
 import { useEventStream, type EventStreamMessage } from './useEventStream'
 import { isActiveJobStatus, normalizeJobState } from '../jobs'
+import { MintApiError, mintApiErrorFromResponse } from '../apiErrors'
 import type {
   GeneratedAnalysisJob,
   GeneratedAnalysisJobInput,
@@ -129,16 +130,6 @@ type PluginJobStreamData = GeneratedAnalysisJobInput | {
   jobs: GeneratedAnalysisJobInput[]
 }
 
-class GeneratedAnalysisRequestError extends Error {
-  constructor(
-    readonly status: number,
-    readonly detail: unknown,
-  ) {
-    super(typeof detail === 'string' ? detail : `Request failed (${status})`)
-    this.name = 'GeneratedAnalysisRequestError'
-  }
-}
-
 export function createGeneratedAnalysisTransport(
   options: GeneratedAnalysisTransportOptions = {},
 ): GeneratedAnalysisTransport {
@@ -838,7 +829,7 @@ function createPluginJobs(
     job: GeneratedAnalysisJob,
     cause: unknown,
   ): void {
-    if (cause instanceof GeneratedAnalysisRequestError) {
+    if (cause instanceof MintApiError) {
       if (cause.status === 404 || cause.status === 410) {
         discardCachedResult(job.job_id)
         jobs.value = jobs.value.map(candidate => (
@@ -1037,8 +1028,10 @@ function createPluginJobs(
       },
     })
     if (!response.ok) {
-      const payload = await response.json().catch(() => null) as { detail?: unknown } | null
-      throw new GeneratedAnalysisRequestError(response.status, payload?.detail)
+      const payload: unknown = await response.json().catch(() => null)
+      throw mintApiErrorFromResponse(response.status, payload, {
+        requestId: response.headers.get('X-Request-ID'),
+      })
     }
     return await response.json() as T
   }
@@ -1177,20 +1170,20 @@ function createGeneratedSessionStorage(candidate?: Storage): GeneratedSessionSto
 }
 
 function isSessionNotFoundError(error: unknown): boolean {
-  return error instanceof GeneratedAnalysisRequestError
+  return error instanceof MintApiError
     && error.status === 404
-    && error.detail === SESSION_NOT_FOUND_DETAIL
+    && (error.detail === SESSION_NOT_FOUND_DETAIL || error.message === SESSION_NOT_FOUND_DETAIL)
 }
 
 function isRetryableResultError(error: unknown): boolean {
-  return !(error instanceof GeneratedAnalysisRequestError)
+  return !(error instanceof MintApiError)
     || error.status === 409
     || error.status === 429
     || error.status >= 500
 }
 
 function isRetryableJobLookupError(error: unknown): boolean {
-  return !(error instanceof GeneratedAnalysisRequestError)
+  return !(error instanceof MintApiError)
     || error.status === 408
     || error.status === 429
     || error.status >= 500

package/src/composables/usePlatformFilePickerAdapter.ts

@@ -0,0 +1,104 @@
+import type { PickerAdapter, PickerNode, PickerRequest } from '../types/filePicker'
+import type { FileDirectoryListing, ServerMount } from '../types/fileBrowserTypes'
+import { useApi } from './useApi'
+import { getInjectedPlatformContext } from './platformContextHelpers'
+import { pickerFormat } from './filePicker/validation'
+
+/** Opaque picker identity; decode before passing a selection to a mount-scoped API. */
+export function encodePlatformPickerPath(mountId: string, path = ''): string {
+  return JSON.stringify([mountId, path])
+}
+export function decodePlatformPickerPath(path: string): { mountId: string; path: string } {
+  const decoded: unknown = JSON.parse(path)
+  if (
+    !Array.isArray(decoded) ||
+    decoded.length !== 2 ||
+    !decoded.every((item) => typeof item === 'string') ||
+    !decoded[0]
+  ) {
+    throw new Error('Invalid platform picker path.')
+  }
+  return { mountId: decoded[0], path: decoded[1] }
+}
+
+/** Adapt the authenticated MINT mount API without exposing absolute host paths. */
+export function usePlatformFilePickerAdapter(options: { apiBaseUrl?: string } = {}): PickerAdapter {
+  const api = useApi({
+    baseUrl: options.apiBaseUrl ?? getInjectedPlatformContext()?.platformApiUrl,
+  })
+  const mountLabels = new Map<string, string>()
+  async function listRoot(request?: PickerRequest): Promise<PickerNode[]> {
+    try {
+      const { mounts } = await api.get<{ mounts: ServerMount[] }>('/filesystem/mounts', {
+        signal: request?.signal,
+      })
+      return mounts.map((mount) => {
+        mountLabels.set(mount.id, mount.label)
+        return {
+          kind: 'folder',
+          path: encodePlatformPickerPath(mount.id),
+          name: mount.label,
+          parentPath: null,
+          parentName: 'Server mounts',
+          unavailableReason: mount.available === false ? 'This mount is offline.' : undefined,
+        }
+      })
+    } catch (cause) {
+      if ((cause as { response?: { status?: number } }).response?.status === 404) return []
+      throw cause
+    }
+  }
+  async function listChildren(path: string, request?: PickerRequest): Promise<PickerNode[]> {
+    const location = decodePlatformPickerPath(path)
+    const query = new URLSearchParams({ mount_id: location.mountId, path: location.path })
+    const listing = await api.get<FileDirectoryListing>(`/filesystem/browse?${query}`, {
+      signal: request?.signal,
+    })
+    if (listing.truncated)
+      throw new Error(
+        'This directory exceeds the server listing limit. Choose a smaller data directory.',
+      )
+    return (listing.entries ?? []).map(
+      (entry) =>
+        ({
+          kind: entry.kind === 'directory' ? 'folder' : 'file',
+          path: encodePlatformPickerPath(location.mountId, entry.path),
+          parentPath: path,
+          parentName: `${mountLabels.get(location.mountId) ?? location.mountId}${location.path ? ` / ${location.path}` : ''}`,
+          name: entry.name,
+          bytes: entry.size_bytes,
+          ...(entry.kind === 'directory'
+            ? { hasChildren: entry.child_count !== 0 }
+            : { format: pickerFormat(entry.name) }),
+        }) as PickerNode,
+    )
+  }
+  return {
+    listRoot,
+    listChildren,
+    async search(query, scope, request) {
+      const matches: PickerNode[] = []
+      const queue = [scope.path]
+      const visited = new Set<string>()
+      while (queue.length) {
+        request?.signal?.throwIfAborted()
+        const path = queue.shift()!
+        if (visited.has(path)) continue
+        visited.add(path)
+        if (visited.size > 500)
+          throw new Error(
+            'Search reached its folder limit. Search a smaller location or turn off Subfolders.',
+          )
+        const nodes = path ? await listChildren(path, request) : await listRoot(request)
+        for (const node of nodes) {
+          if (node.name.toLowerCase().includes(query.toLowerCase())) matches.push(node)
+          if (scope.recursive && node.kind === 'folder' && !node.unavailableReason)
+            queue.push(node.path)
+        }
+        if (matches.length > 10000)
+          throw new Error('Too many search results. Use a more specific search.')
+      }
+      return matches
+    },
+  }
+}

package/src/composables/usePluginClient.ts

@@ -423,6 +423,7 @@ 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)
 
@@ -469,6 +470,7 @@ 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)
@@ -507,6 +509,7 @@ 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 }) ?? {}),

package/src/index.ts

@@ -1,6 +1,9 @@
 // Styles (import to ensure bundling)
 import './styles/index.css'
 
+// Typed API errors
+export * from './apiErrors'
+
 // Vue Plugin for global component registration
 export { MINTSdk, default } from './install'
 

package/src/styles/components/file-browser-modal.css

@@ -0,0 +1,489 @@
+.mint-file-browser-dialog,
+.mint-file-browser-dialog * {
+  box-sizing: border-box;
+}
+
+/* File browser workspace. Actions use BaseButton/IconButton; these rules own layout. */
+.mint-file-browser-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 50;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 24px;
+  background: rgb(15 23 42 / 45%);
+}
+
+.mint-file-browser-dialog {
+  display: flex;
+  flex-direction: column;
+  width: 880px;
+  max-width: 100%;
+  max-height: calc(100dvh - 48px);
+  overflow: hidden;
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-lg);
+  background: var(--bg-secondary);
+  color: var(--text-primary);
+  box-shadow: var(--shadow-lg);
+}
+
+.mint-file-browser-dialog--sm {
+  width: 520px;
+}
+.mint-file-browser-dialog--md {
+  width: 640px;
+}
+.mint-file-browser-dialog--lg {
+  width: 760px;
+}
+.mint-file-browser-dialog--xl {
+  width: 840px;
+}
+
+.mint-file-browser-dialog__header {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  flex-shrink: 0;
+  padding: 16px 20px;
+  border-bottom: 1px solid var(--border-color);
+}
+
+.mint-file-browser__heading {
+  flex: 1;
+  min-width: 0;
+}
+.mint-file-browser__title {
+  margin: 0;
+  font-size: 17px;
+  font-weight: 600;
+}
+.mint-file-browser__context {
+  margin: 3px 0 0;
+  color: var(--text-secondary);
+  font-size: 12px;
+  overflow-wrap: anywhere;
+}
+
+.mint-file-browser {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+  font-size: 13px;
+}
+
+.mint-file-browser__mounts {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 10px 20px 0;
+  flex-shrink: 0;
+  min-width: 0;
+}
+
+.mint-file-browser__mounts-label {
+  font-size: 12px;
+  color: var(--text-muted);
+}
+
+.mint-file-browser__mount-options {
+  display: flex;
+  gap: 6px;
+  min-width: 0;
+  overflow-x: auto;
+  padding: 2px;
+}
+
+.mint-file-browser__mount {
+  flex-shrink: 0;
+  max-width: 260px;
+}
+.mint-file-browser__mount-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.mint-file-browser__mount-count {
+  font-size: 11px;
+  color: var(--text-muted);
+}
+
+.mint-file-browser__toolbar {
+  padding: 8px 20px 12px;
+  flex-shrink: 0;
+}
+.mint-file-browser__pathbar,
+.mint-file-browser__tools {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+.mint-file-browser__pathbar {
+  margin-bottom: 8px;
+}
+.mint-file-browser__crumbs {
+  display: flex;
+  align-items: center;
+  flex: 1;
+  min-width: 0;
+  overflow-x: auto;
+}
+.mint-file-browser__crumb {
+  flex-shrink: 0;
+}
+.mint-file-browser__crumb--current {
+  font-weight: 600;
+}
+.mint-file-browser__crumb-sep {
+  color: var(--text-muted);
+}
+.mint-file-browser__search {
+  flex: 1;
+  min-width: 100px;
+}
+.mint-file-browser__rules {
+  color: var(--text-muted);
+  font-family: var(--font-mono);
+  font-size: 11px;
+  max-width: 160px;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.mint-file-browser__select-folder {
+  flex-shrink: 0;
+}
+
+.mint-file-browser__listing {
+  display: flex;
+  flex-direction: column;
+  min-height: 0;
+}
+.mint-file-browser__head,
+.mint-file-browser__row {
+  display: grid;
+  grid-template-columns: 16px 24px minmax(0, 1fr) 80px 72px 32px;
+  align-items: center;
+  gap: 10px;
+  padding: 4px 20px;
+}
+.mint-file-browser__head {
+  min-height: 32px;
+  border-block: 1px solid var(--border-color);
+  background: var(--bg-primary);
+  color: var(--text-secondary);
+  font-size: 11px;
+  font-weight: 500;
+}
+.mint-file-browser__col-size,
+.mint-file-browser__col-type,
+.mint-file-browser__size,
+.mint-file-browser__type {
+  text-align: right;
+}
+.mint-file-browser__rows {
+  overflow-y: auto;
+  max-height: min(46dvh, 440px);
+  min-height: 0;
+}
+.mint-file-browser__row {
+  min-height: 42px;
+  border-bottom: 1px solid var(--border-light);
+}
+.mint-file-browser__row--dir {
+  cursor: pointer;
+}
+.mint-file-browser__row:hover {
+  background: var(--bg-hover);
+}
+.mint-file-browser__row--selected,
+.mint-file-browser__row--selected:hover {
+  background: var(--color-primary-soft);
+}
+.mint-file-browser__name-cell {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  min-width: 0;
+}
+.mint-file-browser__name {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.mint-file-browser__row--dir .mint-file-browser__name {
+  font-weight: 500;
+}
+.mint-file-browser__note-pill {
+  flex-shrink: 0;
+  color: var(--color-primary);
+  font-size: 11px;
+}
+.mint-file-browser__size,
+.mint-file-browser__type {
+  font-size: 12px;
+  color: var(--text-secondary);
+}
+.mint-file-browser__row--dimmed .mint-file-browser__name,
+.mint-file-browser__row--dimmed .mint-file-browser__size,
+.mint-file-browser__row--dimmed .mint-file-browser__type {
+  color: var(--text-muted);
+}
+.mint-file-browser__row--dimmed .mint-file-browser__row-icon {
+  filter: grayscale(1);
+  opacity: 0.6;
+}
+.mint-file-browser__checkbox {
+  width: 16px;
+  height: 16px;
+  margin: 0;
+  accent-color: var(--color-primary);
+  cursor: pointer;
+}
+.mint-file-browser__checkbox:focus-visible {
+  outline: none;
+  box-shadow: var(--focus-ring);
+}
+.mint-file-browser__row-icon {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  color: var(--text-secondary);
+}
+.mint-file-browser__row-icon--directory {
+  color: var(--mint-info);
+}
+.mint-file-browser__icon {
+  width: 16px;
+  height: 16px;
+  flex-shrink: 0;
+}
+.mint-file-browser__skeleton {
+  padding: 16px 20px;
+  overflow: auto;
+}
+.mint-file-browser__skeleton-row {
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+  padding: 10px 0;
+}
+.mint-file-browser__error {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 16px;
+  padding: 24px 20px;
+  color: var(--mint-error);
+  overflow: auto;
+}
+.mint-file-browser__listing > .mint-empty-state {
+  padding: 32px 20px;
+  overflow: auto;
+}
+.mint-file-browser__status {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  padding: 8px 20px;
+  font-size: 11px;
+  color: var(--text-muted);
+  flex-wrap: wrap;
+  flex-shrink: 0;
+}
+.mint-file-browser__status-spacer {
+  flex: 1;
+}
+
+.mint-file-browser-dialog__footer {
+  padding: 12px 20px;
+  border-top: 1px solid var(--border-color);
+  flex-shrink: 0;
+}
+.mint-file-browser__tray {
+  display: flex;
+  align-items: center;
+  gap: 20px;
+  min-width: 0;
+}
+.mint-file-browser__tray-main {
+  flex: 1;
+  min-width: 0;
+}
+.mint-file-browser__tray-head {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+  min-height: 32px;
+}
+.mint-file-browser__tray-count {
+  font-size: 13px;
+  font-weight: 600;
+}
+.mint-file-browser__tray-summary,
+.mint-file-browser__selection-hint {
+  font-size: 12px;
+  color: var(--text-muted);
+}
+.mint-file-browser__chips {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 6px;
+  max-height: 84px;
+  overflow-y: auto;
+  margin-top: 4px;
+}
+.mint-file-browser__chip {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  max-width: 100%;
+  padding-left: 8px;
+  background: var(--bg-primary);
+  border: 1px solid var(--border-color);
+  border-radius: var(--radius-md);
+  font-size: 12px;
+}
+.mint-file-browser__chip-label {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.mint-file-browser__chip-remove {
+  flex-shrink: 0;
+}
+.mint-file-browser__actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-shrink: 0;
+}
+
+@media (max-width: 600px) {
+  .mint-file-browser-overlay {
+    padding: 8px;
+  }
+  .mint-file-browser-dialog {
+    max-height: calc(100dvh - 16px);
+  }
+  .mint-file-browser-dialog__header {
+    padding: 12px;
+    gap: 8px;
+    flex-wrap: wrap;
+  }
+  .mint-file-browser__title {
+    font-size: 15px;
+  }
+  .mint-file-browser__local {
+    order: 3;
+  }
+  .mint-file-browser__mounts {
+    padding: 8px 12px 0;
+  }
+  .mint-file-browser__mounts-label {
+    display: none;
+  }
+  .mint-file-browser__toolbar {
+    padding: 6px 12px 10px;
+  }
+  .mint-file-browser__tools {
+    flex-wrap: wrap;
+    gap: 6px;
+  }
+  .mint-file-browser__search {
+    flex-basis: calc(100% - 42px);
+  }
+  .mint-file-browser__rules {
+    order: 2;
+    flex: 1;
+    max-width: none;
+  }
+  .mint-file-browser__select-folder {
+    order: 3;
+    margin-left: auto;
+  }
+  .mint-file-browser__head,
+  .mint-file-browser__row {
+    grid-template-columns: 16px 20px minmax(0, 1fr) 64px 32px;
+    gap: 6px;
+    padding-inline: 12px;
+  }
+  .mint-file-browser__col-type,
+  .mint-file-browser__type {
+    display: none;
+  }
+  .mint-file-browser__name-cell {
+    flex-direction: column;
+    align-items: flex-start;
+    gap: 0;
+  }
+  .mint-file-browser__name {
+    max-width: 100%;
+  }
+  .mint-file-browser__status {
+    padding-inline: 12px;
+  }
+  .mint-file-browser__legend {
+    display: none;
+  }
+  .mint-file-browser-dialog__footer {
+    padding: 10px 12px;
+  }
+  .mint-file-browser__tray {
+    flex-direction: column;
+    align-items: stretch;
+    gap: 10px;
+  }
+  .mint-file-browser__actions {
+    justify-content: flex-end;
+  }
+  .mint-file-browser__chips {
+    max-height: 80px;
+  }
+}
+
+/* Short windows scroll the workspace while keeping confirmation reachable. */
+@media (max-height: 600px) {
+  .mint-file-browser {
+    overflow-y: auto;
+  }
+  .mint-file-browser__listing {
+    flex-shrink: 0;
+  }
+  .mint-file-browser__rows {
+    max-height: none;
+  }
+  .mint-file-browser__chips {
+    max-height: 40px;
+  }
+}
+
+@media (max-height: 600px) and (min-width: 601px) {
+  .mint-file-browser-overlay {
+    padding: 8px;
+  }
+  .mint-file-browser-dialog {
+    max-height: calc(100dvh - 16px);
+  }
+  .mint-file-browser-dialog__header {
+    padding-block: 8px;
+  }
+  .mint-file-browser__context {
+    display: none;
+  }
+  .mint-file-browser__toolbar {
+    display: grid;
+    grid-template-columns: minmax(0, 1fr) minmax(0, 1.5fr);
+    gap: 8px;
+    padding-block: 6px;
+  }
+  .mint-file-browser__pathbar {
+    margin: 0;
+  }
+  .mint-file-browser__rules {
+    display: none;
+  }
+}