dragonflight/services/web-ui/public/js/api.js
Zac 72545126c4 fix: delete asset actually deletes
Trash icon in the library was firing PATCH /assets/:id with {status:"deleted"}. The PATCH route only accepts display_name/tags/notes so it returned "No fields to update" and the asset stayed put.

* api.js: add deleteAsset(id, {hard}) helper hitting the real DELETE route.
* index.html: deleteAssetPrompt now calls deleteAsset (soft archive). Confirm dialog reworded to match.
* mam-api/routes/assets.js: list endpoint hides status=archived by default. Pass ?include_archived=true to see them in a future restore-from-trash view. Filtering by ?status=archived still works for power users.
* All HTML: bump api.js cache-buster v=4 -> v=5 so the new helper is fetched.
2026-05-17 12:55:55 -04:00

442 lines
13 KiB
JavaScript

// Wild Dragon MAM - API Helper Module
const API_BASE = '/api/v1';
const CAPTURE_BASE = '/capture';
// Session ID for the active capture — set on start, cleared on stop
let _captureSessionId = null;
/**
* Wrapper around fetch with JSON parsing and error handling
*/
async function api(path, options = {}) {
const url = `${API_BASE}${path}`;
const config = {
credentials: 'include',
headers: {
'Content-Type': 'application/json',
...options.headers,
},
...options,
};
try {
const response = await fetch(url, config);
if (!response.ok) {
const error = await response.json().catch(() => ({ message: response.statusText }));
throw new Error(error.message || `API Error: ${response.status}`);
}
const data = await response.json();
return { success: true, data };
} catch (error) {
console.error(`API Error on ${path}:`, error);
return { success: false, error: error.message };
}
}
/**
* Wrapper around fetch for capture endpoints (goes directly to capture service via nginx)
*/
async function captureApi(path, options = {}) {
const url = `${CAPTURE_BASE}${path}`;
const config = {
credentials: 'include',
headers: {
'Content-Type': 'application/json',
...options.headers,
},
...options,
};
try {
const response = await fetch(url, config);
if (!response.ok) {
const error = await response.json().catch(() => ({ message: response.statusText }));
throw new Error(error.message || `Capture API Error: ${response.status}`);
}
const data = await response.json();
return { success: true, data };
} catch (error) {
console.error(`Capture API Error on ${path}:`, error);
return { success: false, error: error.message };
}
}
// ============================================================
// ASSET API CALLS
// ============================================================
async function getAssets(filters = {}) {
const params = new URLSearchParams(filters);
const path = `/assets${params.toString() ? '?' + params.toString() : ''}`;
const r = await api(path);
// API returns { assets, total }. Callers expect r.data to be the array,
// so unwrap here — but preserve total as a sibling for any caller that wants it.
if (r.success && r.data && typeof r.data === 'object' && Array.isArray(r.data.assets)) {
r.total = r.data.total;
r.data = r.data.assets;
}
return r;
}
async function getAsset(assetId) {
return api(`/assets/${assetId}`);
}
async function getAssetStreamUrl(assetId) {
return api(`/assets/${assetId}/stream`);
}
async function updateAsset(assetId, data) {
return api(`/assets/${assetId}`, {
method: 'PATCH',
body: JSON.stringify(data),
});
}
async function searchAssets(query) {
return api(`/assets?q=${encodeURIComponent(query)}`);
}
async function getAssetMetadata(assetId) {
return api(`/assets/${assetId}`);
}
async function deleteAsset(assetId, { hard = false } = {}) {
const qs = hard ? '?hard=true' : '';
return api(`/assets/${assetId}${qs}`, { method: 'DELETE' });
}
// ============================================================
// PROJECT API CALLS
// ============================================================
async function getProjects() {
return api('/projects');
}
async function getProject(projectId) {
return api(`/projects/${projectId}`);
}
async function createProject(name, description = '') {
return api('/projects', {
method: 'POST',
body: JSON.stringify({ name, description }),
});
}
async function updateProject(projectId, data) {
return api(`/projects/${projectId}`, {
method: 'PATCH',
body: JSON.stringify(data),
});
}
async function deleteProject(projectId) {
return api(`/projects/${projectId}`, {
method: 'DELETE',
});
}
// ============================================================
// BIN API CALLS
// Bins are mounted at /api/v1/bins with project_id as query param
// ============================================================
async function getBins(projectId) {
return api(`/bins?project_id=${projectId}`);
}
async function getBin(projectId, binId) {
return api(`/bins/${binId}`);
}
async function createBin(projectId, name, description = '') {
return api('/bins', {
method: 'POST',
body: JSON.stringify({ project_id: projectId, name }),
});
}
async function updateBin(projectId, binId, data) {
return api(`/bins/${binId}`, {
method: 'PATCH',
body: JSON.stringify(data),
});
}
async function deleteBin(projectId, binId) {
return api(`/bins/${binId}`, {
method: 'DELETE',
});
}
// ============================================================
// CAPTURE API CALLS
// Routes: GET /capture/devices, GET /capture/status,
// POST /capture/start, POST /capture/stop
// ============================================================
/**
* Get list of available capture devices.
* Normalises capture service response ({index, name}) to {id, name, interface}.
*/
async function getCaptureDevices() {
const result = await captureApi('/devices');
if (result.success && result.data) {
const raw = Array.isArray(result.data)
? result.data
: (result.data.devices || []);
result.data = raw.map(d => ({
id: d.index !== undefined ? d.index : d.id,
name: d.name,
interface: d.interface || 'DeckLink',
}));
}
return result;
}
/** Get overall capture service status */
async function getCaptureStatus() {
return captureApi('/status');
}
/** Get current recording state (alias for getCaptureStatus) */
async function getRecordingStatus() {
return captureApi('/status');
}
/**
* Start recording.
* @param {number} deviceIndex - Device index from getCaptureDevices
* @param {string} projectId
* @param {string|null} binId
* @param {string} clipName
*/
async function startRecording(deviceIndex, projectId, binId, clipName) {
const result = await captureApi('/start', {
method: 'POST',
body: JSON.stringify({
device: parseInt(deviceIndex, 10),
project_id: projectId,
bin_id: binId || null,
clip_name: clipName,
}),
});
if (result.success && result.data && result.data.sessionId) {
_captureSessionId = result.data.sessionId;
}
return result;
}
/**
* Stop the active recording.
* Uses the session ID stored from the most recent startRecording call,
* falling back to the current status if no local state exists.
*/
async function stopRecording() {
let sessionId = _captureSessionId;
if (!sessionId) {
// Try to recover session_id from live status
const statusResult = await captureApi('/status');
if (statusResult.success && statusResult.data && statusResult.data.sessionId) {
sessionId = statusResult.data.sessionId;
}
}
const result = await captureApi('/stop', {
method: 'POST',
body: JSON.stringify({ session_id: sessionId }),
});
if (result.success) {
_captureSessionId = null;
}
return result;
}
/**
* Get recent captures — uses assets API ordered by created_at desc.
*/
async function getRecentCaptures(limit = 10) {
const r = await api(`/assets?limit=${limit}`);
if (r.success && r.data && typeof r.data === 'object' && Array.isArray(r.data.assets)) {
r.total = r.data.total;
r.data = r.data.assets;
}
return r;
}
/** Not available in current capture service — returns empty */
async function getRecordingTimecode() {
return { success: true, data: { timecode: null } };
}
// ============================================================
// UTILITY FUNCTIONS
// ============================================================
function formatFileSize(bytes) {
if (bytes === 0) return '0 B';
const k = 1024;
const sizes = ['B', 'KB', 'MB', 'GB', 'TB'];
const i = Math.floor(Math.log(bytes) / Math.log(k));
return Math.round((bytes / Math.pow(k, i)) * 100) / 100 + ' ' + sizes[i];
}
function formatDuration(seconds) {
if (!seconds || seconds < 0) return '00:00:00';
const hours = Math.floor(seconds / 3600);
const minutes = Math.floor((seconds % 3600) / 60);
const secs = Math.floor(seconds % 60);
return [hours, minutes, secs].map(v => v.toString().padStart(2, '0')).join(':');
}
function getStatusLabel(status) {
const labels = {
ingesting: 'Ingesting',
processing: 'Processing',
ready: 'Ready',
error: 'Error',
archived: 'Archived',
};
return labels[status] || status;
}
function getStatusBadgeClass(status) {
return `badge-${status}`;
}
function debounce(func, wait) {
let timeout;
return function executedFunction(...args) {
const later = () => { clearTimeout(timeout); func(...args); };
clearTimeout(timeout);
timeout = setTimeout(later, wait);
};
}
function throttle(func, limit) {
let inThrottle;
return function(...args) {
if (!inThrottle) {
func.apply(this, args);
inThrottle = true;
setTimeout(() => inThrottle = false, limit);
}
};
}
// ============================================================
// UPLOAD API CALLS
// Routes expect camelCase field names
// ============================================================
/**
* Initialize a multipart upload.
* Returns { assetId, uploadId, key }
*/
async function initUpload(data) {
const body = {
filename: data.filename,
fileSize: data.file_size || data.fileSize,
contentType: data.content_type || data.contentType,
projectId: data.project_id || data.projectId,
binId: data.bin_id || data.binId || null,
tags: data.tags || null,
};
return api('/upload/init', { method: 'POST', body: JSON.stringify(body) });
}
/**
* Complete a multipart upload.
* @param {object} data - { uploadId, key, assetId, parts: [{partNumber, ETag}] }
*/
async function completeUpload(data) {
const body = {
uploadId: data.upload_id || data.uploadId,
key: data.key,
assetId: data.asset_id || data.assetId,
parts: (data.parts || []).map(p => ({
partNumber: p.part_number || p.partNumber,
ETag: p.etag || p.ETag,
})),
};
return api('/upload/complete', { method: 'POST', body: JSON.stringify(body) });
}
/** Abort an ongoing multipart upload */
async function abortUpload(data) {
const body = {
uploadId: data.upload_id || data.uploadId,
key: data.key,
assetId: data.asset_id || data.assetId,
};
return api('/upload/abort', { method: 'POST', body: JSON.stringify(body) });
}
/** Upload a file part (FormData, no JSON content-type) */
async function uploadPart(formData) {
try {
const response = await fetch('/api/v1/upload/part', {
method: 'POST',
credentials: 'include',
body: formData,
});
if (!response.ok) throw new Error(`Upload part failed: ${response.status}`);
const data = await response.json();
return { success: true, data };
} catch (error) {
return { success: false, error: error.message };
}
}
/** Simple upload for small files (under 50MB) */
async function simpleUpload(formData) {
try {
const response = await fetch('/api/v1/upload/simple', {
method: 'POST',
credentials: 'include',
body: formData,
});
if (!response.ok) throw new Error(`Upload failed: ${response.status}`);
const data = await response.json();
return { success: true, data };
} catch (error) {
return { success: false, error: error.message };
}
}
// ============================================================
// RECORDER API CALLS
// ============================================================
async function getRecorders() {
return api('/recorders');
}
async function createRecorder(data) {
return api('/recorders', { method: 'POST', body: JSON.stringify(data) });
}
async function startRecorder(id) {
return api(`/recorders/${id}/start`, { method: 'POST' });
}
async function stopRecorder(id) {
return api(`/recorders/${id}/stop`, { method: 'POST' });
}
async function deleteRecorder(id) {
return api(`/recorders/${id}`, { method: 'DELETE' });
}
async function getRecorderStatus(id) {
return api(`/recorders/${id}/status`);
}