@virtualdisplay.io/client 4.0.0-alpha.1 → 4.0.0-alpha.3

package/dist/virtualdisplay.client.es.js

@@ -1,2 +1,798 @@
-const e={NO_MAPPING:"NO_MAPPING",ATTRIBUTE_NOT_FOUND:"ATTRIBUTE_NOT_FOUND",VALUE_NOT_FOUND:"VALUE_NOT_FOUND",PARENT_NOT_FOUND:"PARENT_NOT_FOUND",INVALID_PARAMETER:"INVALID_PARAMETER",SNAPSHOT_FAILED:"SNAPSHOT_FAILED"};class t extends Error{code;constructor(e,i){super(e),this.name="VirtualdisplayError",this.code=i,void 0!==Error.captureStackTrace&&Error.captureStackTrace(this,t)}static noMapping(){return new t("No attributes available. Waiting for server metadata.",e.NO_MAPPING)}static attributeNotFound(i){return new t(`Attribute "${i}" not found in mapping`,e.ATTRIBUTE_NOT_FOUND)}static valueNotFound(i,n){return new t(`Value "${n}" not found for attribute "${i}"`,e.VALUE_NOT_FOUND)}static parentNotFound(i){return new t(`Parent element not found: ${i}`,e.PARENT_NOT_FOUND)}static invalidParameter(i){return new t(i,e.INVALID_PARAMETER)}static snapshotFailed(i,n){return new t(`Snapshot failed for "${i}": ${n}`,e.SNAPSHOT_FAILED)}}const i={};class n{defaultServer="https://server.virtualdisplay.io";options;constructor(e){this.options=e}create(){const e=this.createIframe();return this.attachToParent(e),e}createIframe(){const e=document.createElement("iframe");return e.src=this.buildUrl(),Object.assign(e.style,{width:"100%",height:"100%",border:"none"}),e.setAttribute("allow","xr-spatial-tracking; fullscreen"),e}attachToParent(e){this.getParentElement().appendChild(e)}buildUrl(){const e=this.getServerUrl(),t=new URL(e);return t.searchParams.set("license",this.options.license),t.searchParams.set("model",this.options.model),!0===this.options.debug&&t.searchParams.set("debug","true"),void 0!==this.options.language&&t.searchParams.set("language",this.options.language),t.toString()}getServerUrl(){if(void 0===i?.VITE_VIRTUALDISPLAY_SERVER_HOST)return this.defaultServer}getParentElement(){if("string"!=typeof this.options.parent)return this.options.parent;const e=document.querySelector(this.options.parent);if(null===e)throw t.parentNotFound(this.options.parent);return e}}function s(e,t){const i=t?function(e){const t=new Date(e.timestamp).toLocaleTimeString("en-GB",{hour12:!1}),i=e.level.toUpperCase().padEnd(5),n=e.trace_id?.slice(0,8)??"--------",s=e.msg,a=["timestamp","level","msg","service","trace_id","span_id"],r=Object.entries(e).filter(([e])=>!a.includes(e)).map(([e,t])=>`${e}=${JSON.stringify(t)}`).join(" ");return`${t} ${i} [${n}] ${s}${r?" "+r:""}`}(e):function(e){return JSON.stringify(e)}(e);"error"===e.level?console.error(i):"warn"===e.level?console.warn(i):console.log(i)}class a{constructor(e){this.config=e}log(e,t,i={}){const n=this.config.traceProvider?.()??{};var a;s({timestamp:(a=/* @__PURE__ */new Date,a.toISOString()),level:e,msg:t,service:this.config.service,...n,...i},this.config.isDev)}debug(e,t){this.config.isDev&&this.log("debug",e,t)}info(e,t){this.log("info",e,t)}warn(e,t){this.log("warn",e,t)}error(e,t){this.log("error",e,t)}with(e){const t=new a(this.config);return t.log=((t,i,n={})=>{this.log(t,i,{...e,...n})}).bind(this),t}}function r(e,t){const i=void 0!==t?.isDev?t.isDev:"undefined"==typeof process||"production"!==process.env.NODE_ENV;return new a({service:e,isDev:i,traceProvider:t?.traceProvider})}function o(e){if(void 0!==e)return"object"!=typeof e||null===e||Array.isArray(e)||e instanceof Error?e instanceof Error?{error:e.message}:{value:e}:e}function l(e){return{debug:(t,i)=>e.debug(t,o(i)),info:(t,i)=>e.info(t,o(i)),warn:(t,i)=>e.warn(t,o(i)),error:(t,i)=>e.error(t,o(i))}}let d=!1,u=l(r("client",{isDev:!1}));function h(){d=!0,u=l(r("client",{isDev:!0}))}function c(){return d}class g{ready=!1;onReady;constructor(e){this.onReady=e}handleMappingReceived(){this.markReady("Mapping received from server")}handleMutationResult(e){e.isInitial&&this.markReady("Initial mutations processed")}get isReady(){return this.ready}clear(){this.ready=!1}markReady(e){this.ready||(this.ready=!0,u.info(`${e} - client is now ready`),this.onReady?.())}}class f{constructor(e,t){this.value=e,this.attribute=t}isSelectedValue=!1;get isSelected(){return this.isSelectedValue}setSelected(e){this.isSelectedValue=e}}class p{name;defaultValue;values;onSelect;onChangeCallback;constructor(e){this.name=e.name,this.defaultValue=e.defaultValue,this.onSelect=e.onSelect,this.values=this.createValues(e.values)}select(e){if(!this.values.has(e))throw t.valueNotFound(this.name,e);this.onSelect(this.name,e)}getValues(){return Array.from(this.values.values())}getValue(e){return this.values.get(e)}onChange(e){this.onChangeCallback=e}handleResult(e){let t;for(const i of this.values.values()){const n=i.value===e;i.setSelected(n),n&&(t=i)}void 0!==t&&void 0!==this.onChangeCallback&&this.onChangeCallback(t)}createValues(e){const t=/* @__PURE__ */new Map;for(const i of e){const e=new f(i,this.name);i===this.defaultValue&&e.setSelected(!0),t.set(i,e)}return t}}class m{attributes=/* @__PURE__ */new Map;constructor(e,t,i){for(const n of e){const e=this.buildOptions(n,t);this.attributes.set(n.name,new p(e))}this.onMutationFailed=i}onMutationFailed;get(e){return this.attributes.get(e)}defaults(){const e=[];for(const t of this.attributes.values())void 0!==t.defaultValue&&e.push({name:t.name,value:t.defaultValue});return e}handleResults(e){for(const t of e)t.success?this.get(t.name)?.handleResult(t.value):this.onMutationFailed?.(t.name,t.value)}buildOptions(e,t){const i={name:e.name,values:e.values,onSelect:(e,i)=>{t([{name:e,value:i}],!1)}};return void 0!==e.defaultValue?{...i,defaultValue:e.defaultValue}:i}}const b={READY:"ready",MUTATION:"mutation",STATE:"state",CONFIG:"config",CAMERA:"camera",SNAPSHOT:"snapshot",MAPPING:"mapping"},v=new Set(Object.values(b));function y(e){return"object"!=typeof e||null===e?null:e}class A{constructor(e){this.processor=e}pending=[];isReady=!1;enqueue(e){this.isReady?this.processor(e):this.pending.push(e)}markReady(){if(this.isReady)return;if(this.isReady=!0,0===this.pending.length)return;const e=[...this.pending];this.pending.length=0;for(const t of e)this.processor(t)}get ready(){return this.isReady}get pendingCount(){return this.pending.length}hasPending(e){return this.pending.some(t=>t.type===e)}clear(){this.pending.length=0}}class E{constructor(e,t){this.getTarget=e,this.sourceId=`vd-${Math.random().toString(36).slice(2,8)}`,this.publisher=new A(e=>this.post(e)),this.consumer=new A(e=>this.routeToHandler(e)),this.shouldBuffer=t?.shouldBuffer??null,!0!==t?.bufferIncoming&&this.consumer.markReady()}handlers=/* @__PURE__ */new Map;publisher;consumer;shouldBuffer;listener=null;sourceId;on(e,t){this.handlers.set(e,t)}off(e){this.handlers.delete(e)}send(e){this.publisher.enqueue(e)}markReady(){this.publisher.markReady()}markConsumerReady(){this.consumer.markReady()}consumerHasPending(e){return this.consumer.hasPending(e)}start(){null===this.listener&&(this.listener=e=>{const{data:t}=e;if(!function(e){if("object"!=typeof e||null===e)return!1;const t=e;return"string"!=typeof t.target&&"string"==typeof t.type&&v.has(t.type)}(t))return;if(t._source===this.sourceId)return;const i=t;null===this.shouldBuffer||this.shouldBuffer(i)?this.consumer.enqueue(i):this.routeToHandler(i)},window.addEventListener("message",this.listener))}destroy(){null!==this.listener&&(window.removeEventListener("message",this.listener),this.listener=null),this.publisher.clear(),this.consumer.clear(),this.handlers.clear()}get ready(){return this.publisher.ready}get pendingCount(){return this.publisher.pendingCount}post(e){const t=this.getTarget();null!==t&&t.postMessage({...e,_source:this.sourceId},"*")}routeToHandler(e){const t=this.handlers.get(e.type);if(void 0===t)return;const i=t(e);i instanceof Promise&&i.catch(t=>{const i=t instanceof Error?t.message:String(t);console.error(`Virtualdisplay: error handling ${e.type}: ${i}`)})}}class C{constructor(e,t){this.send=e,this.onMutationFailed=t}registry;pendingCallbacks=[];handleMappingReceived(e){u.debug("Initializing from server mapping",{attributeCount:e.attributes.length}),this.registry=new m(e.attributes,(e,t)=>this.sendMutation(e,t),this.onMutationFailed);const t=this.registry.defaults();t.length>0&&this.sendMutation(t,!0),this.replayPendingCallbacks()}handleMutationResult(e){this.registry?.handleResults(e.results)}select(e,t){this.sendMutation([{name:e,value:t}],!1)}getValues(e){return this.registry?.get(e)?.getValues()??[]}getValue(e,t){return this.registry?.get(e)?.getValue(t)}onChange(e,t){if(void 0===this.registry)return void this.pendingCallbacks.push({name:e,callback:t});const i=this.registry.get(e);void 0!==i?i.onChange(t):u.warn(`onChange: attribute "${e}" not found — callback will not fire`)}getAttribute(e){return this.registry?.get(e)}get hasMapping(){return void 0!==this.registry}sendMutation(e,t){const i={type:b.MUTATION,mutations:e,isInitial:t};this.send(i)}replayPendingCallbacks(){for(const{name:e,callback:t}of this.pendingCallbacks){const i=this.registry?.get(e);void 0===i&&u.warn(`onChange: attribute "${e}" not found — buffered callback will not fire`),i?.onChange(t)}this.pendingCallbacks.length=0}}class I{constructor(e){this.send=e}commands=[];rotate(e){return this.validateFiniteNumber(e,"rotate"),this.commands.push({action:"rotate",value:e}),this}tilt(e){return this.validateFiniteNumber(e,"tilt"),this.commands.push({action:"tilt",value:e}),this}zoom(e){return this.validateFiniteNumber(e,"zoom"),this.commands.push({action:"zoom",value:e}),this}set(){if(0===this.commands.length)throw t.invalidParameter("No camera commands to execute. Call rotate(), tilt(), or zoom() before set().");const e={type:b.CAMERA,commands:this.commands};this.send(e),this.commands=[]}validateFiniteNumber(e,i){if(!Number.isFinite(e))throw t.invalidParameter(`${i}() requires a finite number, got ${String(e)}`)}reset(){const e={type:b.CAMERA,commands:[{action:"reset"}]};this.send(e)}}class w{state;changeCallbacks=[];constructor(){this.state={rotation:0,tilt:0,zoom:0}}get rotation(){return this.state.rotation}get tilt(){return this.state.tilt}get zoom(){return this.state.zoom}onChange(e){this.changeCallbacks.push(e)}handlePositionUpdate(e){this.update(e.transforms)}update(e){let t=!1;for(const i of e)switch(i.type){case"rotation":this.state.rotation=i.value,t=!0;break;case"tilt":this.state.tilt=i.value,t=!0;break;case"zoom":this.state.zoom=i.value,t=!0}if(t){const e={rotation:this.rotation,tilt:this.tilt,zoom:this.zoom};for(const t of this.changeCallbacks)t(e)}}}class S{constructor(e){this.filename=e}developedCallbacks=/* @__PURE__ */new Set;errorCallbacks=/* @__PURE__ */new Set;developed=!1;failed=!1;photoData=null;onDeveloped(e){return this.developed&&null!==this.photoData?(e(this.photoData),this):(this.developedCallbacks.add(e),this)}onError(e){return this.errorCallbacks.add(e),this}getFilename(){return this.filename}develop(e){this.developed||this.failed||(this.photoData=e,this.developed=!0,this.developedCallbacks.forEach(e=>{e(this.photoData)}),this.developedCallbacks.clear(),this.errorCallbacks.clear())}fail(e){this.developed||this.failed||(this.failed=!0,this.errorCallbacks.forEach(t=>{t(e)}),this.developedCallbacks.clear(),this.errorCallbacks.clear())}}class R{constructor(e){this.send=e}validExtensions=[".png"];pendingPhotos=/* @__PURE__ */new Map;take(e){this.validateFilename(e),u.debug("Taking snapshot",{filename:e});const t=new S(e);return this.pendingPhotos.set(t.getFilename(),t),this.send({type:b.SNAPSHOT,filename:e}),t}handleSnapshotResult(i){const n=this.pendingPhotos.get(i.filename);void 0!==n?(this.pendingPhotos.delete(i.filename),void 0===i.error?void 0!==i.data&&n.develop({filename:i.filename,data:i.data}):n.fail(new t(i.error,e.SNAPSHOT_FAILED))):u.warn("No pending photo found for filename",{filename:i.filename,pendingFilenames:Array.from(this.pendingPhotos.keys())})}validateFilename(i){if(""===i||"string"!=typeof i)throw new t("Filename must be a non-empty string",e.INVALID_PARAMETER);if(!this.validExtensions.some(e=>i.toLowerCase().endsWith(e)))throw new t(`Invalid filename: "${i}". Filename must end with one of: ${this.validExtensions.join(", ")}`,e.INVALID_PARAMETER);if(i.includes("..")||i.includes("/")||i.includes("\\"))throw new t('Filename cannot contain path separators or ".."',e.INVALID_PARAMETER)}}class N{send;constructor(e){this.send=e}sendInitialConfig(e){const t=this.buildUIConfig(e),i=this.buildViewerConfig(t,e.camera);void 0!==i&&this.sendConfig(i)}buildUIConfig(e){const t=this.extractUIValues(e);if(Object.values(t).some(e=>void 0!==e))return{...void 0!==t.arEnabled&&{arEnabled:t.arEnabled},...void 0!==t.fullscreenEnabled&&{fullscreenEnabled:t.fullscreenEnabled},...void 0!==t.loadingIndicatorEnabled&&{loadingIndicatorEnabled:t.loadingIndicatorEnabled}}}extractUIValues(e){return{arEnabled:e.arEnabled??e.ui?.arEnabled,fullscreenEnabled:e.fullscreenEnabled??e.ui?.fullscreenEnabled,loadingIndicatorEnabled:e.loadingIndicatorEnabled??e.ui?.loadingIndicatorEnabled}}buildViewerConfig(e,t){if(void 0!==e||void 0!==t)return{...void 0!==e&&{ui:e},...void 0!==t&&{camera:t}}}setArEnabled(e){u.debug(`Setting AR button enabled: ${e}`),this.updateUIConfig({arEnabled:e})}setFullscreenEnabled(e){u.debug(`Setting fullscreen button enabled: ${e}`),this.updateUIConfig({fullscreenEnabled:e})}setLoadingIndicatorEnabled(e){u.debug(`Setting loading indicator enabled: ${e}`),this.updateUIConfig({loadingIndicatorEnabled:e})}updateUIConfig(e){u.debug("Updating UI configuration",e),Object.keys(e).length>0&&this.sendConfig({ui:e})}hideAllUI(){u.debug("Hiding all UI elements"),this.sendUIConfig({arEnabled:!1,fullscreenEnabled:!1,loadingIndicatorEnabled:!1})}showAllUI(){u.debug("Showing all UI elements"),this.sendUIConfig({arEnabled:!0,fullscreenEnabled:!0,loadingIndicatorEnabled:!0})}sendUIConfig(e){this.sendConfig({ui:e})}sendConfig(e){const t={type:b.CONFIG,config:e};u.debug("Sending config",t),this.send(t)}}class T{attributes;readyStateTracker;messenger;viewerService;cameraApi;cameraPositionApi;snapshotApi;options;iframe;readyCallbacks=[];mutationFailedCallbacks=[];constructor(e){this.options=e,this.initializeLogging(),this.messenger=new E(()=>this.iframe?.contentWindow??null);const t=e=>{this.messenger.send(e)};this.attributes=new C(t,(e,t)=>{for(const i of this.mutationFailedCallbacks)i({attribute:e,value:t})}),this.readyStateTracker=new g(()=>{const e=this.readyCallbacks;this.readyCallbacks=[];for(const t of e)t(this)}),this.viewerService=new N(t),this.cameraApi=new I(t),this.cameraPositionApi=new w,this.snapshotApi=new R(t),this.registerHandlers(),this.messenger.start(),this.createAndConnectIframe()}registerHandlers(){this.messenger.on(b.READY,e=>{(function(e){const t=y(e);return null!==t&&t.type===b.READY})(e)&&(u.info("Server ready — flushing publisher queue"),this.messenger.markReady(),this.viewerService.sendInitialConfig(this.options))}),this.messenger.on(b.MUTATION,e=>{(function(e){const t=y(e);return null!==t&&t.type===b.MUTATION&&Array.isArray(t.results)})(e)&&(this.attributes.handleMutationResult(e),this.readyStateTracker.handleMutationResult(e))}),this.messenger.on(b.SNAPSHOT,e=>{(function(e){const t=y(e);return null!==t&&t.type===b.SNAPSHOT&&("data"in t||"error"in t)})(e)&&this.snapshotApi.handleSnapshotResult(e)}),this.messenger.on(b.CAMERA,e=>{(function(e){const t=y(e);return null!==t&&t.type===b.CAMERA&&Array.isArray(t.transforms)})(e)&&this.cameraPositionApi.handlePositionUpdate(e)}),this.messenger.on(b.MAPPING,e=>{(function(e){const t=y(e);return null!==t&&t.type===b.MAPPING&&Array.isArray(t.attributes)})(e)&&(this.attributes.handleMappingReceived(e),this.readyStateTracker.handleMappingReceived())})}initializeLogging(){!0===this.options.debug&&h(),u.info("Initializing Virtualdisplay client",{model:this.options.model,debug:this.options.debug,language:this.options.language})}createAndConnectIframe(){u.debug("Creating iframe for Virtualdisplay viewer");const e=new n(this.options);this.iframe=e.create(),u.debug("Iframe created, waiting for server READY")}select(e,t){this.attributes.select(e,t)}getValues(e){return this.attributes.getValues(e)}getValue(e,t){return this.attributes.getValue(e,t)}onChange(e,t){this.attributes.onChange(e,t)}getAttribute(e){return this.attributes.getAttribute(e)}get isReady(){return this.readyStateTracker.isReady}onReady(e){this.readyStateTracker.isReady?e(this):this.readyCallbacks.push(e)}onMutationFailed(e){this.mutationFailedCallbacks.push(e)}get viewer(){return this.viewerService}get camera(){return this.cameraApi}get cameraPosition(){return this.cameraPositionApi}get snapshot(){return this.snapshotApi}destroy(){u.info("Destroying Virtualdisplay client"),this.readyStateTracker.clear(),this.readyCallbacks=[],this.messenger.destroy(),null!==this.iframe?.parentElement&&void 0!==this.iframe?.parentElement&&this.iframe.parentElement.removeChild(this.iframe),this.iframe=void 0,u.debug("Virtualdisplay client destroyed")}}export{p as Attribute,f as AttributeValue,I as Camera,e as ERROR_CODES,S as Photo,R as Snapshot,T as VirtualdisplayClient,t as VirtualdisplayError,N as VirtualdisplayViewerService,h as enableDebugMode,c as isDebugMode,u as logger};
-//# sourceMappingURL=virtualdisplay.client.es.js.map
+//#region src/client/error.ts
+var e = {
+	NO_MAPPING: "NO_MAPPING",
+	ATTRIBUTE_NOT_FOUND: "ATTRIBUTE_NOT_FOUND",
+	VALUE_NOT_FOUND: "VALUE_NOT_FOUND",
+	PARENT_NOT_FOUND: "PARENT_NOT_FOUND",
+	INVALID_PARAMETER: "INVALID_PARAMETER",
+	SNAPSHOT_FAILED: "SNAPSHOT_FAILED"
+}, t = class t extends Error {
+	code;
+	constructor(e, n) {
+		super(e), this.name = "VirtualdisplayError", this.code = n, Error.captureStackTrace?.(this, t);
+	}
+	static noMapping() {
+		return new t("No attributes available. Waiting for server metadata.", e.NO_MAPPING);
+	}
+	static attributeNotFound(n) {
+		return new t(`Attribute "${n}" not found in mapping`, e.ATTRIBUTE_NOT_FOUND);
+	}
+	static valueNotFound(n, r) {
+		return new t(`Value "${r}" not found for attribute "${n}"`, e.VALUE_NOT_FOUND);
+	}
+	static parentNotFound(n) {
+		return new t(`Parent element not found: ${n}`, e.PARENT_NOT_FOUND);
+	}
+	static invalidParameter(n) {
+		return new t(n, e.INVALID_PARAMETER);
+	}
+	static snapshotFailed(n, r) {
+		return new t(`Snapshot failed for "${n}": ${r}`, e.SNAPSHOT_FAILED);
+	}
+}, n = class {
+	defaultServer = "https://server.virtualdisplay.io";
+	options;
+	constructor(e) {
+		this.options = e;
+	}
+	create() {
+		let e = this.createIframe();
+		return this.attachToParent(e), e;
+	}
+	createIframe() {
+		let e = document.createElement("iframe");
+		return e.src = this.buildUrl(), Object.assign(e.style, {
+			width: "100%",
+			height: "100%",
+			border: "none"
+		}), e.setAttribute("allow", "xr-spatial-tracking; fullscreen"), e;
+	}
+	attachToParent(e) {
+		this.getParentElement().appendChild(e);
+	}
+	buildUrl() {
+		let e = this.getServerUrl(), t = new URL(e);
+		return t.searchParams.set("license", this.options.license), t.searchParams.set("model", this.options.model), this.options.debug === !0 && t.searchParams.set("debug", "true"), this.options.language !== void 0 && t.searchParams.set("language", this.options.language), t.toString();
+	}
+	getServerUrl() {
+		return this.defaultServer;
+	}
+	getParentElement() {
+		if (typeof this.options.parent != "string") return this.options.parent;
+		let e = document.querySelector(this.options.parent);
+		if (e === null) throw t.parentNotFound(this.options.parent);
+		return e;
+	}
+};
+//#endregion
+//#region ../logger/src/format.ts
+function r(e) {
+	let t = new Date(e.timestamp).toLocaleTimeString("en-GB", { hour12: !1 }), n = e.level.toUpperCase().padEnd(5), r = e.trace_id?.slice(0, 8) ?? "--------", i = e.msg, a = [
+		"timestamp",
+		"level",
+		"msg",
+		"service",
+		"trace_id",
+		"span_id"
+	], o = Object.entries(e).filter(([e]) => !a.includes(e)).map(([e, t]) => `${e}=${JSON.stringify(t)}`).join(" ");
+	return `${t} ${n} [${r}] ${i}${o ? " " + o : ""}`;
+}
+function i(e) {
+	return JSON.stringify(e);
+}
+//#endregion
+//#region ../logger/src/write.ts
+function a(e, t) {
+	let n = t ? r(e) : i(e);
+	e.level === "error" ? console.error(n) : e.level === "warn" ? console.warn(n) : console.log(n);
+}
+//#endregion
+//#region ../utils/src/date.ts
+function o() {
+	return /* @__PURE__ */ new Date();
+}
+function s(e) {
+	return e.toISOString();
+}
+//#endregion
+//#region ../logger/src/logger.ts
+var c = class e {
+	constructor(e) {
+		this.config = e;
+	}
+	log(e, t, n = {}) {
+		let r = this.config.traceProvider?.() ?? {};
+		a({
+			timestamp: s(o()),
+			level: e,
+			msg: t,
+			service: this.config.service,
+			...r,
+			...n
+		}, this.config.isDev);
+	}
+	debug(e, t) {
+		this.config.isDev && this.log("debug", e, t);
+	}
+	info(e, t) {
+		this.log("info", e, t);
+	}
+	warn(e, t) {
+		this.log("warn", e, t);
+	}
+	error(e, t) {
+		this.log("error", e, t);
+	}
+	with(t) {
+		let n = new e(this.config);
+		return n.log = ((e, n, r = {}) => {
+			this.log(e, n, {
+				...t,
+				...r
+			});
+		}).bind(this), n;
+	}
+};
+function l(e, t) {
+	return new c({
+		service: e,
+		isDev: t?.isDev === void 0 ? typeof process < "u" ? process.env.NODE_ENV !== "production" : !0 : t.isDev,
+		traceProvider: t?.traceProvider
+	});
+}
+//#endregion
+//#region src/utils/logger.ts
+function u(e) {
+	if (e !== void 0) return typeof e == "object" && e && !Array.isArray(e) && !(e instanceof Error) ? e : e instanceof Error ? { error: e.message } : { value: e };
+}
+function d(e) {
+	return {
+		debug: (t, n) => e.debug(t, u(n)),
+		info: (t, n) => e.info(t, u(n)),
+		warn: (t, n) => e.warn(t, u(n)),
+		error: (t, n) => e.error(t, u(n))
+	};
+}
+var f = !1, p = d(l("client", { isDev: !1 }));
+function m() {
+	f = !0, p = d(l("client", { isDev: !0 }));
+}
+function h() {
+	return f;
+}
+//#endregion
+//#region src/client/ready-state-tracker.ts
+var g = class {
+	ready = !1;
+	onReady;
+	constructor(e) {
+		this.onReady = e;
+	}
+	handleMappingReceived() {
+		this.markReady("Mapping received from server");
+	}
+	handleMutationResult(e) {
+		e.isInitial && this.markReady("Initial mutations processed");
+	}
+	get isReady() {
+		return this.ready;
+	}
+	clear() {
+		this.ready = !1;
+	}
+	markReady(e) {
+		this.ready || (this.ready = !0, p.info(`${e} - client is now ready`), this.onReady?.());
+	}
+}, _ = class {
+	isSelectedValue = !1;
+	constructor(e, t) {
+		this.value = e, this.attribute = t;
+	}
+	get isSelected() {
+		return this.isSelectedValue;
+	}
+	setSelected(e) {
+		this.isSelectedValue = e;
+	}
+}, v = class {
+	name;
+	defaultValue;
+	values;
+	onSelect;
+	onChangeCallback;
+	constructor(e) {
+		this.name = e.name, this.defaultValue = e.defaultValue, this.onSelect = e.onSelect, this.values = this.createValues(e.values);
+	}
+	select(e) {
+		if (!this.values.has(e)) throw t.valueNotFound(this.name, e);
+		this.onSelect(this.name, e);
+	}
+	getValues() {
+		return Array.from(this.values.values());
+	}
+	getValue(e) {
+		return this.values.get(e);
+	}
+	onChange(e) {
+		this.onChangeCallback = e;
+	}
+	handleResult(e) {
+		let t;
+		for (let n of this.values.values()) {
+			let r = n.value === e;
+			n.setSelected(r), r && (t = n);
+		}
+		t !== void 0 && this.onChangeCallback !== void 0 && this.onChangeCallback(t);
+	}
+	createValues(e) {
+		let t = /* @__PURE__ */ new Map();
+		for (let n of e) {
+			let e = new _(n, this.name);
+			n === this.defaultValue && e.setSelected(!0), t.set(n, e);
+		}
+		return t;
+	}
+}, y = class {
+	attributes = /* @__PURE__ */ new Map();
+	constructor(e, t, n) {
+		for (let n of e) {
+			let e = this.buildOptions(n, t);
+			this.attributes.set(n.name, new v(e));
+		}
+		this.onMutationFailed = n;
+	}
+	onMutationFailed;
+	get(e) {
+		return this.attributes.get(e);
+	}
+	defaults() {
+		let e = [];
+		for (let t of this.attributes.values()) t.defaultValue !== void 0 && e.push({
+			name: t.name,
+			value: t.defaultValue
+		});
+		return e;
+	}
+	handleResults(e) {
+		for (let t of e) {
+			if (!t.success) {
+				this.onMutationFailed?.(t.name, t.value);
+				continue;
+			}
+			this.get(t.name)?.handleResult(t.value);
+		}
+	}
+	buildOptions(e, t) {
+		let n = {
+			name: e.name,
+			values: e.values,
+			onSelect: (e, n) => {
+				t([{
+					name: e,
+					value: n
+				}], !1);
+			}
+		};
+		return e.defaultValue === void 0 ? n : {
+			...n,
+			defaultValue: e.defaultValue
+		};
+	}
+}, b = {
+	READY: "ready",
+	MUTATION: "mutation",
+	STATE: "state",
+	CONFIG: "config",
+	CAMERA: "camera",
+	SNAPSHOT: "snapshot",
+	MAPPING: "mapping"
+}, x = new Set(Object.values(b));
+function S(e) {
+	if (typeof e != "object" || !e) return !1;
+	let t = e;
+	return typeof t.target == "string" ? !1 : typeof t.type == "string" && x.has(t.type);
+}
+function C(e) {
+	let t = O(e);
+	return t !== null && t.type === b.READY;
+}
+function w(e) {
+	let t = O(e);
+	return t !== null && t.type === b.MUTATION && Array.isArray(t.results);
+}
+function T(e) {
+	let t = O(e);
+	return t !== null && t.type === b.SNAPSHOT && ("data" in t || "error" in t);
+}
+function E(e) {
+	let t = O(e);
+	return t !== null && t.type === b.CAMERA && Array.isArray(t.transforms);
+}
+function D(e) {
+	let t = O(e);
+	return t !== null && t.type === b.MAPPING && Array.isArray(t.attributes);
+}
+function O(e) {
+	return typeof e != "object" || !e ? null : e;
+}
+//#endregion
+//#region ../messaging/src/queue.ts
+var k = class {
+	pending = [];
+	isReady = !1;
+	constructor(e) {
+		this.processor = e;
+	}
+	enqueue(e) {
+		if (this.isReady) {
+			this.processor(e);
+			return;
+		}
+		this.pending.push(e);
+	}
+	markReady() {
+		if (this.isReady || (this.isReady = !0, this.pending.length === 0)) return;
+		let e = [...this.pending];
+		this.pending.length = 0;
+		for (let t of e) this.processor(t);
+	}
+	get ready() {
+		return this.isReady;
+	}
+	get pendingCount() {
+		return this.pending.length;
+	}
+	hasPending(e) {
+		return this.pending.some((t) => t.type === e);
+	}
+	clear() {
+		this.pending.length = 0;
+	}
+}, A = class {
+	handlers = /* @__PURE__ */ new Map();
+	publisher;
+	consumer;
+	shouldBuffer;
+	listener = null;
+	sourceId;
+	constructor(e, t) {
+		this.getTarget = e, this.sourceId = `vd-${Math.random().toString(36).slice(2, 8)}`, this.publisher = new k((e) => this.post(e)), this.consumer = new k((e) => this.routeToHandler(e)), this.shouldBuffer = t?.shouldBuffer ?? null, t?.bufferIncoming !== !0 && this.consumer.markReady();
+	}
+	on(e, t) {
+		this.handlers.set(e, t);
+	}
+	off(e) {
+		this.handlers.delete(e);
+	}
+	send(e) {
+		this.publisher.enqueue(e);
+	}
+	markReady() {
+		this.publisher.markReady();
+	}
+	markConsumerReady() {
+		this.consumer.markReady();
+	}
+	consumerHasPending(e) {
+		return this.consumer.hasPending(e);
+	}
+	start() {
+		this.listener === null && (this.listener = (e) => {
+			let { data: t } = e;
+			if (!S(t) || t._source === this.sourceId) return;
+			let n = t;
+			if (this.shouldBuffer !== null && !this.shouldBuffer(n)) {
+				this.routeToHandler(n);
+				return;
+			}
+			this.consumer.enqueue(n);
+		}, window.addEventListener("message", this.listener));
+	}
+	destroy() {
+		this.listener !== null && (window.removeEventListener("message", this.listener), this.listener = null), this.publisher.clear(), this.consumer.clear(), this.handlers.clear();
+	}
+	get ready() {
+		return this.publisher.ready;
+	}
+	get pendingCount() {
+		return this.publisher.pendingCount;
+	}
+	post(e) {
+		let t = this.getTarget();
+		t !== null && t.postMessage({
+			...e,
+			_source: this.sourceId
+		}, "*");
+	}
+	routeToHandler(e) {
+		let t = this.handlers.get(e.type);
+		if (t === void 0) return;
+		let n = t(e);
+		n instanceof Promise && n.catch((t) => {
+			let n = t instanceof Error ? t.message : String(t);
+			console.error(`Virtualdisplay: error handling ${e.type}: ${n}`);
+		});
+	}
+};
+new Set([b.CAMERA]);
+//#endregion
+//#region src/attributes/attributes.ts
+var j = class {
+	registry;
+	pendingCallbacks = [];
+	constructor(e, t) {
+		this.send = e, this.onMutationFailed = t;
+	}
+	handleMappingReceived(e) {
+		p.debug("Initializing from server mapping", { attributeCount: e.attributes.length }), this.registry = new y(e.attributes, (e, t) => this.sendMutation(e, t), this.onMutationFailed);
+		let t = this.registry.defaults();
+		t.length > 0 && this.sendMutation(t, !0), this.replayPendingCallbacks();
+	}
+	handleMutationResult(e) {
+		this.registry?.handleResults(e.results);
+	}
+	select(e, t) {
+		this.sendMutation([{
+			name: e,
+			value: t
+		}], !1);
+	}
+	getValues(e) {
+		return this.registry?.get(e)?.getValues() ?? [];
+	}
+	getValue(e, t) {
+		return this.registry?.get(e)?.getValue(t);
+	}
+	onChange(e, t) {
+		if (this.registry === void 0) {
+			this.pendingCallbacks.push({
+				name: e,
+				callback: t
+			});
+			return;
+		}
+		let n = this.registry.get(e);
+		if (n === void 0) {
+			p.warn(`onChange: attribute "${e}" not found — callback will not fire`);
+			return;
+		}
+		n.onChange(t);
+	}
+	getAttribute(e) {
+		return this.registry?.get(e);
+	}
+	get hasMapping() {
+		return this.registry !== void 0;
+	}
+	sendMutation(e, t) {
+		let n = {
+			type: b.MUTATION,
+			mutations: e,
+			isInitial: t
+		};
+		this.send(n);
+	}
+	replayPendingCallbacks() {
+		for (let { name: e, callback: t } of this.pendingCallbacks) {
+			let n = this.registry?.get(e);
+			n === void 0 && p.warn(`onChange: attribute "${e}" not found — buffered callback will not fire`), n?.onChange(t);
+		}
+		this.pendingCallbacks.length = 0;
+	}
+}, M = class {
+	commands = [];
+	constructor(e) {
+		this.send = e;
+	}
+	rotate(e) {
+		return this.validateFiniteNumber(e, "rotate"), this.commands.push({
+			action: "rotate",
+			value: e
+		}), this;
+	}
+	tilt(e) {
+		return this.validateFiniteNumber(e, "tilt"), this.commands.push({
+			action: "tilt",
+			value: e
+		}), this;
+	}
+	zoom(e) {
+		return this.validateFiniteNumber(e, "zoom"), this.commands.push({
+			action: "zoom",
+			value: e
+		}), this;
+	}
+	set() {
+		if (this.commands.length === 0) throw t.invalidParameter("No camera commands to execute. Call rotate(), tilt(), or zoom() before set().");
+		let e = {
+			type: b.CAMERA,
+			commands: this.commands
+		};
+		this.send(e), this.commands = [];
+	}
+	validateFiniteNumber(e, n) {
+		if (!Number.isFinite(e)) throw t.invalidParameter(`${n}() requires a finite number, got ${String(e)}`);
+	}
+	reset() {
+		let e = {
+			type: b.CAMERA,
+			commands: [{ action: "reset" }]
+		};
+		this.send(e);
+	}
+}, N = class {
+	state;
+	changeCallbacks = [];
+	constructor() {
+		this.state = {
+			rotation: 0,
+			tilt: 0,
+			zoom: 0
+		};
+	}
+	get rotation() {
+		return this.state.rotation;
+	}
+	get tilt() {
+		return this.state.tilt;
+	}
+	get zoom() {
+		return this.state.zoom;
+	}
+	onChange(e) {
+		this.changeCallbacks.push(e);
+	}
+	handlePositionUpdate(e) {
+		this.update(e.transforms);
+	}
+	update(e) {
+		let t = !1;
+		for (let n of e) switch (n.type) {
+			case "rotation":
+				this.state.rotation = n.value, t = !0;
+				break;
+			case "tilt":
+				this.state.tilt = n.value, t = !0;
+				break;
+			case "zoom":
+				this.state.zoom = n.value, t = !0;
+				break;
+			default: break;
+		}
+		if (t) {
+			let e = {
+				rotation: this.rotation,
+				tilt: this.tilt,
+				zoom: this.zoom
+			};
+			for (let t of this.changeCallbacks) t(e);
+		}
+	}
+}, P = class {
+	developedCallbacks = /* @__PURE__ */ new Set();
+	errorCallbacks = /* @__PURE__ */ new Set();
+	developed = !1;
+	failed = !1;
+	photoData = null;
+	constructor(e) {
+		this.filename = e;
+	}
+	onDeveloped(e) {
+		return this.developed && this.photoData !== null ? (e(this.photoData), this) : (this.developedCallbacks.add(e), this);
+	}
+	onError(e) {
+		return this.errorCallbacks.add(e), this;
+	}
+	getFilename() {
+		return this.filename;
+	}
+	develop(e) {
+		this.developed || this.failed || (this.photoData = e, this.developed = !0, this.developedCallbacks.forEach((e) => {
+			e(this.photoData);
+		}), this.developedCallbacks.clear(), this.errorCallbacks.clear());
+	}
+	fail(e) {
+		this.developed || this.failed || (this.failed = !0, this.errorCallbacks.forEach((t) => {
+			t(e);
+		}), this.developedCallbacks.clear(), this.errorCallbacks.clear());
+	}
+}, F = class {
+	validExtensions = [".png"];
+	pendingPhotos = /* @__PURE__ */ new Map();
+	constructor(e) {
+		this.send = e;
+	}
+	take(e) {
+		this.validateFilename(e), p.debug("Taking snapshot", { filename: e });
+		let t = new P(e);
+		return this.pendingPhotos.set(t.getFilename(), t), this.send({
+			type: b.SNAPSHOT,
+			filename: e
+		}), t;
+	}
+	handleSnapshotResult(n) {
+		let r = this.pendingPhotos.get(n.filename);
+		if (r === void 0) {
+			p.warn("No pending photo found for filename", {
+				filename: n.filename,
+				pendingFilenames: Array.from(this.pendingPhotos.keys())
+			});
+			return;
+		}
+		if (this.pendingPhotos.delete(n.filename), n.error !== void 0) {
+			r.fail(new t(n.error, e.SNAPSHOT_FAILED));
+			return;
+		}
+		n.data !== void 0 && r.develop({
+			filename: n.filename,
+			data: n.data
+		});
+	}
+	validateFilename(n) {
+		if (n === "" || typeof n != "string") throw new t("Filename must be a non-empty string", e.INVALID_PARAMETER);
+		if (!this.validExtensions.some((e) => n.toLowerCase().endsWith(e))) throw new t(`Invalid filename: "${n}". Filename must end with one of: ${this.validExtensions.join(", ")}`, e.INVALID_PARAMETER);
+		if (n.includes("..") || n.includes("/") || n.includes("\\")) throw new t("Filename cannot contain path separators or \"..\"", e.INVALID_PARAMETER);
+	}
+}, I = class {
+	send;
+	constructor(e) {
+		this.send = e;
+	}
+	sendInitialConfig(e) {
+		let t = this.buildUIConfig(e), n = this.buildViewerConfig(t, e.camera);
+		n !== void 0 && this.sendConfig(n);
+	}
+	buildUIConfig(e) {
+		let t = this.extractUIValues(e);
+		if (Object.values(t).some((e) => e !== void 0)) return {
+			...t.arEnabled !== void 0 && { arEnabled: t.arEnabled },
+			...t.fullscreenEnabled !== void 0 && { fullscreenEnabled: t.fullscreenEnabled },
+			...t.loadingIndicatorEnabled !== void 0 && { loadingIndicatorEnabled: t.loadingIndicatorEnabled }
+		};
+	}
+	extractUIValues(e) {
+		return {
+			arEnabled: e.arEnabled ?? e.ui?.arEnabled,
+			fullscreenEnabled: e.fullscreenEnabled ?? e.ui?.fullscreenEnabled,
+			loadingIndicatorEnabled: e.loadingIndicatorEnabled ?? e.ui?.loadingIndicatorEnabled
+		};
+	}
+	buildViewerConfig(e, t) {
+		if (!(e === void 0 && t === void 0)) return {
+			...e !== void 0 && { ui: e },
+			...t !== void 0 && { camera: t }
+		};
+	}
+	setArEnabled(e) {
+		p.debug(`Setting AR button enabled: ${e}`), this.updateUIConfig({ arEnabled: e });
+	}
+	setFullscreenEnabled(e) {
+		p.debug(`Setting fullscreen button enabled: ${e}`), this.updateUIConfig({ fullscreenEnabled: e });
+	}
+	setLoadingIndicatorEnabled(e) {
+		p.debug(`Setting loading indicator enabled: ${e}`), this.updateUIConfig({ loadingIndicatorEnabled: e });
+	}
+	updateUIConfig(e) {
+		p.debug("Updating UI configuration", e), Object.keys(e).length > 0 && this.sendConfig({ ui: e });
+	}
+	hideAllUI() {
+		p.debug("Hiding all UI elements"), this.sendUIConfig({
+			arEnabled: !1,
+			fullscreenEnabled: !1,
+			loadingIndicatorEnabled: !1
+		});
+	}
+	showAllUI() {
+		p.debug("Showing all UI elements"), this.sendUIConfig({
+			arEnabled: !0,
+			fullscreenEnabled: !0,
+			loadingIndicatorEnabled: !0
+		});
+	}
+	sendUIConfig(e) {
+		this.sendConfig({ ui: e });
+	}
+	sendConfig(e) {
+		let t = {
+			type: b.CONFIG,
+			config: e
+		};
+		p.debug("Sending config", t), this.send(t);
+	}
+}, L = class {
+	attributes;
+	readyStateTracker;
+	messenger;
+	viewerService;
+	cameraApi;
+	cameraPositionApi;
+	snapshotApi;
+	options;
+	iframe;
+	readyCallbacks = [];
+	mutationFailedCallbacks = [];
+	constructor(e) {
+		this.options = e, this.initializeLogging(), this.messenger = new A(() => this.iframe?.contentWindow ?? null);
+		let t = (e) => {
+			this.messenger.send(e);
+		};
+		this.attributes = new j(t, (e, t) => {
+			for (let n of this.mutationFailedCallbacks) n({
+				attribute: e,
+				value: t
+			});
+		}), this.readyStateTracker = new g(() => {
+			let e = this.readyCallbacks;
+			this.readyCallbacks = [];
+			for (let t of e) t(this);
+		}), this.viewerService = new I(t), this.cameraApi = new M(t), this.cameraPositionApi = new N(), this.snapshotApi = new F(t), this.registerHandlers(), this.messenger.start(), this.createAndConnectIframe();
+	}
+	registerHandlers() {
+		this.messenger.on(b.READY, (e) => {
+			C(e) && (p.info("Server ready — flushing publisher queue"), this.messenger.markReady(), this.viewerService.sendInitialConfig(this.options));
+		}), this.messenger.on(b.MUTATION, (e) => {
+			w(e) && (this.attributes.handleMutationResult(e), this.readyStateTracker.handleMutationResult(e));
+		}), this.messenger.on(b.SNAPSHOT, (e) => {
+			T(e) && this.snapshotApi.handleSnapshotResult(e);
+		}), this.messenger.on(b.CAMERA, (e) => {
+			E(e) && this.cameraPositionApi.handlePositionUpdate(e);
+		}), this.messenger.on(b.MAPPING, (e) => {
+			D(e) && (this.attributes.handleMappingReceived(e), this.readyStateTracker.handleMappingReceived());
+		});
+	}
+	initializeLogging() {
+		this.options.debug === !0 && m(), p.info("Initializing Virtualdisplay client", {
+			model: this.options.model,
+			debug: this.options.debug,
+			language: this.options.language
+		});
+	}
+	createAndConnectIframe() {
+		p.debug("Creating iframe for Virtualdisplay viewer"), this.iframe = new n(this.options).create(), p.debug("Iframe created, waiting for server READY");
+	}
+	select(e, t) {
+		this.attributes.select(e, t);
+	}
+	getValues(e) {
+		return this.attributes.getValues(e);
+	}
+	getValue(e, t) {
+		return this.attributes.getValue(e, t);
+	}
+	onChange(e, t) {
+		this.attributes.onChange(e, t);
+	}
+	getAttribute(e) {
+		return this.attributes.getAttribute(e);
+	}
+	get isReady() {
+		return this.readyStateTracker.isReady;
+	}
+	onReady(e) {
+		if (this.readyStateTracker.isReady) {
+			e(this);
+			return;
+		}
+		this.readyCallbacks.push(e);
+	}
+	onMutationFailed(e) {
+		this.mutationFailedCallbacks.push(e);
+	}
+	get viewer() {
+		return this.viewerService;
+	}
+	get camera() {
+		return this.cameraApi;
+	}
+	get cameraPosition() {
+		return this.cameraPositionApi;
+	}
+	get snapshot() {
+		return this.snapshotApi;
+	}
+	destroy() {
+		p.info("Destroying Virtualdisplay client"), this.readyStateTracker.clear(), this.readyCallbacks = [], this.messenger.destroy(), this.iframe?.parentElement !== null && this.iframe?.parentElement !== void 0 && this.iframe.parentElement.removeChild(this.iframe), this.iframe = void 0, p.debug("Virtualdisplay client destroyed");
+	}
+};
+//#endregion
+export { v as Attribute, _ as AttributeValue, M as Camera, e as ERROR_CODES, P as Photo, F as Snapshot, L as VirtualdisplayClient, t as VirtualdisplayError, I as VirtualdisplayViewerService, m as enableDebugMode, h as isDebugMode, p as logger };