@liforma/client 0.4.8 → 0.4.10

package/dist/svelte/Experience.svelte

@@ -59,11 +59,13 @@
 		startButton,
 		theme,
 		showFeedback,
+		interaction,
 		closeButton,
 		conversationProcessor,
 		speechOnly = false,
 		fit,
 		attribution,
+		alreadyConverted,
 		avatarId,
 		backdropId,
 		locationId,
@@ -114,6 +116,7 @@
 			conversationProcessor ? identityKey(conversationProcessor) : 0,
 			speechOnly,
 			attribution,
+			alreadyConverted,
 			avatarId,
 			backdropId,
 			locationId,
@@ -336,6 +339,7 @@
 				speechInputMode,
 				speechOnly,
 				attribution,
+				alreadyConverted,
 				conversationProcessor
 			};
 		}
@@ -356,6 +360,7 @@
 				speechInputMode,
 				speechOnly,
 				attribution,
+				alreadyConverted,
 				conversationProcessor
 			};
 		}
@@ -390,6 +395,7 @@
 				startButton: untrack(() => startButton),
 				theme: untrack(() => theme),
 				showFeedback: untrack(() => showFeedback),
+				interaction: untrack(() => interaction),
 				closeButton: untrack(() => closeButton),
 				returnUrl: untrack(() => returnUrl),
 				showClose: Boolean(onClose || returnUrl?.trim() || closeButton),

package/dist/svelte/experienceLoadError.js

@@ -5,6 +5,26 @@ function toErrorMessage(error) {
         return error.message;
     return String(error);
 }
+function readErrorMeta(error) {
+    if (!error || typeof error !== 'object')
+        return {};
+    const record = error;
+    const code = typeof record.code === 'string' && record.code.trim() && record.code.trim() !== 'UNKNOWN'
+        ? record.code.trim()
+        : undefined;
+    const requestId = typeof record.requestId === 'string' && record.requestId.trim()
+        ? record.requestId.trim()
+        : undefined;
+    return { code, requestId };
+}
+function formatTechnicalDetail(message, meta) {
+    const parts = [message];
+    if (meta.code)
+        parts.push(`Code: ${meta.code}`);
+    if (meta.requestId)
+        parts.push(`Request id: ${meta.requestId}`);
+    return parts.join('\n');
+}
 function currentPageOrigin() {
     try {
         if (typeof globalThis.location?.origin === 'string' && globalThis.location.origin) {
@@ -23,49 +43,51 @@ export function extractOriginFromMessage(message) {
     return ORIGIN_IN_MESSAGE.exec(message)?.[1];
 }
 export function presentExperienceLoadError(error, options) {
-    const technicalMessage = toErrorMessage(error).trim() || 'Unknown error';
+    const rawMessage = toErrorMessage(error).trim() || 'Unknown error';
+    const meta = readErrorMeta(error);
+    const technicalMessage = formatTechnicalDetail(rawMessage, meta);
     const experienceId = options?.experienceId?.trim() ||
-        extractExperienceIdFromMessage(technicalMessage) ||
+        extractExperienceIdFromMessage(rawMessage) ||
         undefined;
     const origin = options?.origin?.trim() ||
-        extractOriginFromMessage(technicalMessage) ||
+        extractOriginFromMessage(rawMessage) ||
         currentPageOrigin() ||
         undefined;
-    if (/No playable experience found/i.test(technicalMessage) ||
-        /^Experience is not available\.?$/i.test(technicalMessage) ||
-        /^Unknown experience\.?$/i.test(technicalMessage) ||
-        /experience_unavailable/i.test(technicalMessage)) {
+    if (/No playable experience found/i.test(rawMessage) ||
+        /^Experience is not available\.?$/i.test(rawMessage) ||
+        /^Unknown experience\.?$/i.test(rawMessage) ||
+        /experience_unavailable/i.test(rawMessage)) {
         const idLabel = experienceId ?? 'the requested experience';
         return {
             kind: 'not_found',
             title: 'The application tried to load an avatar experience that doesn’t exist.',
-            detail: `Experience with id ${idLabel} does not exist`,
+            detail: formatTechnicalDetail(`Experience with id ${idLabel} does not exist`, meta),
             technicalMessage,
             experienceId,
             origin
         };
     }
-    if (/origin_not_allowed/i.test(technicalMessage) ||
-        /is not an allowed origin/i.test(technicalMessage) ||
-        /^Origin not allowed/i.test(technicalMessage)) {
+    if (/origin_not_allowed/i.test(rawMessage) ||
+        /is not an allowed origin/i.test(rawMessage) ||
+        /^Origin not allowed/i.test(rawMessage)) {
         const originLabel = origin ?? 'this page';
         const idLabel = experienceId ?? 'the requested experience';
         return {
             kind: 'origin_not_allowed',
             title: 'The application tried to load an avatar experience from a website that isn’t allowed.',
-            detail: `Origin ${originLabel} is not allowed for experience ${idLabel}`,
+            detail: formatTechnicalDetail(`Origin ${originLabel} is not allowed for experience ${idLabel}`, meta),
             technicalMessage,
             experienceId,
             origin
         };
     }
-    if (/browser_embeds_disabled/i.test(technicalMessage) ||
-        /^Browser embeds are not enabled/i.test(technicalMessage)) {
+    if (/browser_embeds_disabled/i.test(rawMessage) ||
+        /^Browser embeds are not enabled/i.test(rawMessage)) {
         const idLabel = experienceId ?? 'the requested experience';
         return {
             kind: 'browser_embeds_disabled',
             title: 'The application tried to load an avatar experience that isn’t enabled for browser embeds.',
-            detail: `Browser embeds are not enabled for experience ${idLabel}`,
+            detail: formatTechnicalDetail(`Browser embeds are not enabled for experience ${idLabel}`, meta),
             technicalMessage,
             experienceId,
             origin

package/dist/svelte/experienceLoadError.test.js

@@ -1,5 +1,6 @@
 import { describe, expect, it } from 'vitest';
 import { presentExperienceLoadError } from './experienceLoadError';
+import { LiformaError } from '../v2/errors/LiformaError';
 describe('presentExperienceLoadError', () => {
     it('maps unavailable experiences to a friendly not-found presentation', () => {
         const presentation = presentExperienceLoadError(new Error('No playable experience found for “exp_01MISSING”. Check that the experience id is correct.'), { experienceId: 'exp_01MISSING' });
@@ -15,4 +16,11 @@ describe('presentExperienceLoadError', () => {
         expect(presentation.experienceId).toBe('exp_01DEMO');
         expect(presentation.origin).toBe('http://localhost:5173');
     });
+    it('includes code and request id in generic mint failure details', () => {
+        const presentation = presentExperienceLoadError(new LiformaError('API database schema is out of date (missing column actorLiformaUserId). Apply pending Prisma migrations on api.liforma.ai.', { code: 'SCHEMA_OUT_OF_DATE', requestId: 'req_abc', status: 502 }));
+        expect(presentation.kind).toBe('generic');
+        expect(presentation.detail).toContain('API database schema is out of date');
+        expect(presentation.detail).toContain('Code: SCHEMA_OUT_OF_DATE');
+        expect(presentation.detail).toContain('Request id: req_abc');
+    });
 });

package/dist/svelte/experienceLoadErrorOverlay.js

@@ -30,7 +30,7 @@ export function createExperienceLoadErrorOverlay(container, initial) {
         title.textContent = presentation.title;
         detail.textContent = presentation.detail;
         detail.hidden = !advancedOpen;
-        advancedBtn.textContent = advancedOpen ? 'Hide details' : 'Advanced';
+        advancedBtn.textContent = advancedOpen ? 'Hide details' : 'Show details';
         advancedBtn.setAttribute('aria-expanded', advancedOpen ? 'true' : 'false');
     }
     render();

package/dist/svelte/experienceLoadErrorStyles.d.ts

@@ -1,4 +1,4 @@
 /** Subset of session loading overlay styles for pre-attach Experience load errors. */
 export declare const EXPERIENCE_LOAD_ERROR_STYLE_ID = "liforma-experience-load-error-styles";
 export declare function injectExperienceLoadErrorStyles(): void;
-export declare const EXPERIENCE_LOAD_ERROR_CSS = "\n\t.liforma-loading-screen {\n\t\tinset: 0;\n\t\tz-index: 20;\n\t\tbox-sizing: border-box;\n\t\toverflow-x: clip;\n\t\twidth: 100%;\n\t\theight: 100%;\n\t\tmax-width: 100vw;\n\t\tbackground:\n\t\t\tradial-gradient(circle at 50% 60%, rgba(79, 126, 196, 0.18), transparent 38%),\n\t\t\t#030508;\n\t\tfont-family: system-ui, -apple-system, sans-serif;\n\t\tcolor: #e8f0ff;\n\t\ttext-align: center;\n\t}\n\t.liforma-loading-screen-absolute {\n\t\tposition: absolute;\n\t}\n\t.liforma-loading-card {\n\t\tposition: absolute;\n\t\tleft: 50%;\n\t\ttop: 60%;\n\t\ttransform: translate(-50%, -50%);\n\t\twidth: min(22rem, calc(100% - 2.5rem));\n\t\tmax-width: calc(100% - max(1.25rem, env(safe-area-inset-left, 0px)) - max(1.25rem, env(safe-area-inset-right, 0px)));\n\t\tbox-sizing: border-box;\n\t\tmargin: 0;\n\t\tpadding: 0;\n\t\tborder: 0;\n\t\tbackground: transparent;\n\t\tbox-shadow: none;\n\t}\n\t.liforma-loading-card-error {\n\t\tdisplay: block;\n\t\ttext-align: center;\n\t\tpadding: 1rem 1.05rem;\n\t\tborder-radius: 14px;\n\t\tborder: 1px solid rgba(255, 154, 154, 0.28);\n\t\tbackground:\n\t\t\tlinear-gradient(180deg, rgba(21, 29, 42, 0.92), rgba(9, 13, 20, 0.92));\n\t}\n\t.liforma-loading-kicker {\n\t\tmargin: 0 0 0.18rem;\n\t\tcolor: #8ba4c5;\n\t\tfont-size: 0.68rem;\n\t\tfont-weight: 700;\n\t\ttext-transform: uppercase;\n\t\tletter-spacing: 0.08em;\n\t}\n\t.liforma-loading-error {\n\t\tmargin: 0;\n\t\tmax-width: 28rem;\n\t\tcolor: #ffb4b4;\n\t\tfont-size: 0.92rem;\n\t\tline-height: 1.4;\n\t}\n\t.liforma-loading-error-title {\n\t\tmargin: 0;\n\t\tcolor: #f6ebe8;\n\t\tfont-size: 0.98rem;\n\t\tfont-weight: 650;\n\t\tline-height: 1.35;\n\t}\n\t.liforma-loading-error-advanced {\n\t\tmargin: 0.85rem 0 0;\n\t\tpadding: 0;\n\t\tborder: 0;\n\t\tbackground: transparent;\n\t\tcolor: #9eb7d8;\n\t\tfont: inherit;\n\t\tfont-size: 0.78rem;\n\t\tfont-weight: 650;\n\t\tletter-spacing: 0.02em;\n\t\ttext-decoration: underline;\n\t\ttext-underline-offset: 0.18em;\n\t\tcursor: pointer;\n\t}\n\t.liforma-loading-error-advanced:hover,\n\t.liforma-loading-error-advanced:focus-visible {\n\t\tcolor: #d7e6ff;\n\t\toutline: none;\n\t}\n\t.liforma-loading-error-detail {\n\t\tmargin: 0.7rem 0 0;\n\t\tpadding: 0.65rem 0.7rem;\n\t\tborder-radius: 10px;\n\t\tborder: 1px solid rgba(158, 191, 255, 0.16);\n\t\tbackground: rgba(3, 5, 8, 0.45);\n\t\tcolor: #c6d4e8;\n\t\tfont-size: 0.78rem;\n\t\tfont-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;\n\t\tline-height: 1.4;\n\t\ttext-align: left;\n\t\tword-break: break-word;\n\t}\n\t.liforma-loading-error-detail[hidden] {\n\t\tdisplay: none;\n\t}\n";
+export declare const EXPERIENCE_LOAD_ERROR_CSS = "\n\t.liforma-loading-screen {\n\t\tinset: 0;\n\t\tz-index: 20;\n\t\tbox-sizing: border-box;\n\t\toverflow-x: clip;\n\t\twidth: 100%;\n\t\theight: 100%;\n\t\tmax-width: 100vw;\n\t\tbackground:\n\t\t\tradial-gradient(circle at 50% 60%, rgba(79, 126, 196, 0.18), transparent 38%),\n\t\t\t#030508;\n\t\tfont-family: system-ui, -apple-system, sans-serif;\n\t\tcolor: #e8f0ff;\n\t\ttext-align: center;\n\t}\n\t.liforma-loading-screen-absolute {\n\t\tposition: absolute;\n\t}\n\t.liforma-loading-card {\n\t\tposition: absolute;\n\t\tleft: 50%;\n\t\ttop: 60%;\n\t\ttransform: translate(-50%, -50%);\n\t\twidth: min(22rem, calc(100% - 2.5rem));\n\t\tmax-width: calc(100% - max(1.25rem, env(safe-area-inset-left, 0px)) - max(1.25rem, env(safe-area-inset-right, 0px)));\n\t\tbox-sizing: border-box;\n\t\tmargin: 0;\n\t\tpadding: 0;\n\t\tborder: 0;\n\t\tbackground: transparent;\n\t\tbox-shadow: none;\n\t}\n\t.liforma-loading-card-error {\n\t\tdisplay: block;\n\t\ttext-align: center;\n\t\tpadding: 1rem 1.05rem;\n\t\tborder-radius: 14px;\n\t\tborder: 1px solid rgba(255, 154, 154, 0.28);\n\t\tbackground:\n\t\t\tlinear-gradient(180deg, rgba(21, 29, 42, 0.92), rgba(9, 13, 20, 0.92));\n\t}\n\t.liforma-loading-kicker {\n\t\tmargin: 0 0 0.18rem;\n\t\tcolor: #8ba4c5;\n\t\tfont-size: 0.68rem;\n\t\tfont-weight: 700;\n\t\ttext-transform: uppercase;\n\t\tletter-spacing: 0.08em;\n\t}\n\t.liforma-loading-error {\n\t\tmargin: 0;\n\t\tmax-width: 28rem;\n\t\tcolor: #ffb4b4;\n\t\tfont-size: 0.92rem;\n\t\tline-height: 1.4;\n\t}\n\t.liforma-loading-error-title {\n\t\tmargin: 0;\n\t\tcolor: #f6ebe8;\n\t\tfont-size: 0.98rem;\n\t\tfont-weight: 650;\n\t\tline-height: 1.35;\n\t}\n\t.liforma-loading-error-advanced {\n\t\tmargin: 0.85rem 0 0;\n\t\tpadding: 0;\n\t\tborder: 0;\n\t\tbackground: transparent;\n\t\tcolor: #9eb7d8;\n\t\tfont: inherit;\n\t\tfont-size: 0.78rem;\n\t\tfont-weight: 650;\n\t\tletter-spacing: 0.02em;\n\t\ttext-decoration: underline;\n\t\ttext-underline-offset: 0.18em;\n\t\tcursor: pointer;\n\t}\n\t.liforma-loading-error-advanced:hover,\n\t.liforma-loading-error-advanced:focus-visible {\n\t\tcolor: #d7e6ff;\n\t\toutline: none;\n\t}\n\t.liforma-loading-error-detail {\n\t\tmargin: 0.7rem 0 0;\n\t\tpadding: 0.65rem 0.7rem;\n\t\tborder-radius: 10px;\n\t\tborder: 1px solid rgba(158, 191, 255, 0.16);\n\t\tbackground: rgba(3, 5, 8, 0.45);\n\t\tcolor: #c6d4e8;\n\t\tfont-size: 0.78rem;\n\t\tfont-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;\n\t\tline-height: 1.4;\n\t\ttext-align: left;\n\t\twhite-space: pre-wrap;\n\t\tword-break: break-word;\n\t}\n\t.liforma-loading-error-detail[hidden] {\n\t\tdisplay: none;\n\t}\n";

package/dist/svelte/experienceLoadErrorStyles.js

@@ -104,6 +104,7 @@ export const EXPERIENCE_LOAD_ERROR_CSS = `
 		font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
 		line-height: 1.4;
 		text-align: left;
+		white-space: pre-wrap;
 		word-break: break-word;
 	}
 	.liforma-loading-error-detail[hidden] {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@liforma/client",
-	"version": "0.4.8",
+	"version": "0.4.10",
 	"type": "module",
 	"description": "Liforma browser SDK — Experience sessions, speech API, and Svelte embed component.",
 	"license": "MIT",