diff --git a/packages/sdk/index.html b/packages/sdk/index.html index f32cbdc..0b04e38 100644 --- a/packages/sdk/index.html +++ b/packages/sdk/index.html @@ -324,6 +324,11 @@

Configuration

+
@@ -635,6 +640,9 @@

Console Logs

apiKey: document.getElementById('api-key'), modelSelect: document.getElementById('model-select'), realtimeBaseUrl: document.getElementById('realtime-base-url'), + endpointPresetGroup: document.getElementById('endpoint-preset-group'), + endpointPreset: document.getElementById('endpoint-preset'), + endpointPresetNote: document.getElementById('endpoint-preset-note'), queryParams: document.getElementById('query-params'), customModelGroup: document.getElementById('custom-model-group'), customModelName: document.getElementById('custom-model-name'), @@ -747,16 +755,18 @@

Console Logs

// doesn't list. The object matches the SDK's model definition schema (name, urlPath, // fps, width, height), so connect() accepts it and the API decides whether the name exists. const CUSTOM_MODEL_OPTION = '__custom__'; + // Models the deployment lists in VITE_EXTRA_REALTIME_MODELS ride the same path, by name. + const EXTRA_MODEL_PREFIX = '__extra__:'; function isCustomModelSelected() { return elements.modelSelect.value === CUSTOM_MODEL_OPTION; } - function buildCustomModel() { + function buildCustomModel(name = elements.customModelName.value.trim()) { const width = Number.parseInt(elements.customModelWidth.value, 10); const height = Number.parseInt(elements.customModelHeight.value, 10); return { - name: elements.customModelName.value.trim(), + name, urlPath: '/v1/stream', fps: { ideal: 30, max: 30 }, width: Number.isFinite(width) && width > 0 ? width : 1280, @@ -765,7 +775,78 @@

Console Logs

} function resolveSelectedModel() { - return isCustomModelSelected() ? buildCustomModel() : models.realtime(elements.modelSelect.value); + const value = elements.modelSelect.value; + if (value === CUSTOM_MODEL_OPTION) return buildCustomModel(); + if (value.startsWith(EXTRA_MODEL_PREFIX)) return buildCustomModel(value.slice(EXTRA_MODEL_PREFIX.length)); + return models.realtime(value); + } + + // The SDK rejects a base URL without a scheme; read a bare host ("api.example.com") as wss://. + function readRealtimeBaseUrl() { + const raw = elements.realtimeBaseUrl.value.trim(); + if (!raw) return ''; + return /^[a-z][a-z0-9+.-]*:\/\//i.test(raw) ? raw : `wss://${raw}`; + } + + // Presets a deployment can provide (e.g. staging), so the page never hardcodes hosts: + // VITE_REALTIME_BASE_URLS='[{"label":"Staging","url":"wss://api.example.com","note":"Needs a staging key"}]' + // VITE_EXTRA_REALTIME_MODELS=name-a,name-b (server-side models this SDK build does not list) + const CUSTOM_ENDPOINT_OPTION = '__custom__'; + const endpointPresets = parseEndpointPresets(import.meta.env.VITE_REALTIME_BASE_URLS); + + function parseEndpointPresets(raw) { + if (!raw) return []; + try { + const presets = JSON.parse(raw); + if (Array.isArray(presets) && presets.every((p) => p && typeof p.label === 'string' && typeof p.url === 'string')) { + return presets; + } + } catch {} + addLog('Ignoring VITE_REALTIME_BASE_URLS: expected a JSON array of {label, url, note?}', 'error'); + return []; + } + + // Select the preset whose URL is in the field, else "Custom", and show its note. + function syncEndpointPreset() { + const url = readRealtimeBaseUrl(); + const known = url === '' || endpointPresets.some((p) => p.url === url); + elements.endpointPreset.value = known ? url : CUSTOM_ENDPOINT_OPTION; + const preset = endpointPresets.find((p) => p.url === elements.endpointPreset.value); + elements.endpointPresetNote.textContent = preset?.note ?? ''; + } + + if (endpointPresets.length > 0) { + elements.endpointPreset.add(new Option('SDK default', '')); + for (const { label, url } of endpointPresets) elements.endpointPreset.add(new Option(label, url)); + elements.endpointPreset.add(new Option('Custom (type below)', CUSTOM_ENDPOINT_OPTION)); + elements.endpointPresetGroup.style.display = ''; + syncEndpointPreset(); + elements.endpointPreset.addEventListener('change', () => { + const url = elements.endpointPreset.value; + if (url === CUSTOM_ENDPOINT_OPTION) { + elements.endpointPresetNote.textContent = ''; + elements.realtimeBaseUrl.focus(); + return; + } + elements.realtimeBaseUrl.value = url; + syncEndpointPreset(); + addLog(`API endpoint: ${url || 'SDK default'}`, 'info'); + // Ephemeral/JWT credentials are minted through the endpoint in the field. + const authMode = document.querySelector('input[name="auth-mode"]:checked').value; + if (authMode !== 'parent' && model.name) mintCredential(authMode); + }); + elements.realtimeBaseUrl.addEventListener('input', syncEndpointPreset); + } + + const extraModels = (import.meta.env.VITE_EXTRA_REALTIME_MODELS ?? '') + .split(',') + .map((name) => name.trim()) + .filter(Boolean); + if (extraModels.length > 0) { + const group = document.createElement('optgroup'); + group.label = 'This deployment'; + for (const name of extraModels) group.append(new Option(name, EXTRA_MODEL_PREFIX + name)); + elements.modelSelect.insertBefore(group, elements.modelSelect.querySelector('optgroup[label="Override"]')); } // "pool=moderation-eval&foo=bar" -> { pool: "moderation-eval", foo: "bar" }; passed to @@ -1007,7 +1088,7 @@

Console Logs

mintedCredential = null; const parentKey = elements.apiKey.value.trim(); if (!parentKey) { addLog('Please enter an API key first', 'error'); return; } - const wsBase = elements.realtimeBaseUrl.value.trim(); + const wsBase = readRealtimeBaseUrl(); const baseUrl = wsBase ? wsBase.replace(/^wss?:/i, 'https:') : undefined; try { const minter = createDecartClient({ apiKey: parentKey, ...(baseUrl && { baseUrl }), logger: createDemoLogger('debug') }); @@ -1281,7 +1362,7 @@

Console Logs

addLog('Initializing Decart client...', 'info'); - const realtimeBaseUrl = elements.realtimeBaseUrl.value.trim(); + const realtimeBaseUrl = readRealtimeBaseUrl(); decartClient = createDecartClient({ apiKey, ...(realtimeBaseUrl && { realtimeBaseUrl }), @@ -1441,7 +1522,7 @@

Console Logs

elements.connectBtn.disabled = true; stopCameraResources(); - const realtimeBaseUrl = elements.realtimeBaseUrl.value.trim(); + const realtimeBaseUrl = readRealtimeBaseUrl(); decartClient = createDecartClient({ apiKey, ...(realtimeBaseUrl && { realtimeBaseUrl }), @@ -1724,7 +1805,7 @@

Console Logs

// Initialize client if not already done if (!decartClient) { - const realtimeBaseUrl = elements.realtimeBaseUrl.value.trim(); + const realtimeBaseUrl = readRealtimeBaseUrl(); decartClient = createDecartClient({ apiKey, ...(realtimeBaseUrl && { realtimeBaseUrl }), @@ -1808,7 +1889,7 @@

Console Logs

addLog('Please enter an API key', 'error'); return null; } - const realtimeBaseUrl = elements.realtimeBaseUrl.value.trim(); + const realtimeBaseUrl = readRealtimeBaseUrl(); decartClient = createDecartClient({ apiKey, ...(realtimeBaseUrl && { realtimeBaseUrl }),