@rasterex/viewer 1.0.0

package/dist/domains/BlocksApi.d.ts

@@ -0,0 +1,151 @@
+import type { CanvasMessageBroker } from "../messaging/CanvasMessageBroker.js";
+import { type DomainEventHandler, type DomainEventUnsubscribe } from "../utils/DomainEventEmitter.js";
+export interface BlockItem {
+    index?: number;
+    name?: string;
+    visible: boolean;
+    selected?: boolean;
+    hasAttribute?: boolean;
+    [key: string]: unknown;
+}
+export interface BlockAttribute {
+    name: string;
+    value: unknown;
+    blockref?: number;
+    [key: string]: unknown;
+}
+export interface BlockBounds {
+    minX?: number;
+    minY?: number;
+    maxX?: number;
+    maxY?: number;
+    width?: number;
+    height?: number;
+    area?: number;
+    [key: string]: unknown;
+}
+export interface BlockInsertDetails {
+    blockhandleLow?: number;
+    blockhandleHigh?: number;
+    insertX?: number;
+    insertY?: number;
+    insertZ?: number;
+    insertRot?: number;
+    insertscaleX?: number;
+    insertscaleY?: number;
+    insertscaleZ?: number;
+    blockref?: number;
+    MinX?: number;
+    MinY?: number;
+    MaxX?: number;
+    MaxY?: number;
+    type?: string;
+    [key: string]: unknown;
+}
+export interface BlockDetails {
+    index?: number;
+    name?: string;
+    state?: number;
+    defaultstate?: number;
+    defaultcolor?: string | null;
+    color?: string | null;
+    fillstyle?: string | null;
+    defaultfillstyle?: string | null;
+    overridecolor?: boolean;
+    overridefill?: boolean;
+    hatchstyle?: string | null;
+    selected?: boolean;
+    listed?: boolean;
+    insert?: BlockInsertDetails;
+    drawn?: boolean;
+    mouseon?: boolean;
+    hasAttribute?: boolean;
+    fold?: number;
+    bounds?: BlockBounds;
+    [key: string]: unknown;
+}
+export interface BlockDetailsItem {
+    index?: number;
+    name?: string;
+    visible?: boolean;
+    selected?: boolean;
+    hasAttribute?: boolean;
+    details?: BlockDetails;
+    attributes?: BlockAttribute[];
+    [key: string]: unknown;
+}
+export interface BlocksSnapshot {
+    requestId?: string;
+    fileId?: string;
+    fileIndex?: number;
+    fileName?: string;
+    blocks: BlockItem[];
+    [key: string]: unknown;
+}
+export interface BlockDetailsSnapshot {
+    requestId?: string;
+    fileId?: string;
+    fileIndex?: number;
+    fileName?: string;
+    blocks: BlockDetailsItem[];
+    [key: string]: unknown;
+}
+export type BlockAttributesSnapshot = BlockDetailsSnapshot;
+export interface GetBlocksOptions {
+    requestId?: string;
+    timeoutMs?: number;
+}
+export interface GetBlockDetailsOptions {
+    requestId?: string;
+    index?: number;
+    indexes?: number[];
+    timeoutMs?: number;
+}
+export type GetBlockAttributesOptions = GetBlockDetailsOptions;
+export interface SetBlockVisibilityOptions {
+    requestId?: string;
+    index?: number;
+    indexes?: number[];
+    name?: string;
+    names?: string[];
+    all?: boolean;
+    visible: boolean;
+}
+export interface BlocksEventMap {
+    snapshot: BlocksSnapshot;
+    detailsSnapshot: BlockDetailsSnapshot;
+    attributesSnapshot: BlockAttributesSnapshot;
+}
+export type BlocksEventName = keyof BlocksEventMap;
+export type BlocksEventHandler<TEventName extends BlocksEventName> = DomainEventHandler<BlocksEventMap[TEventName]>;
+export type BlocksEventUnsubscribe = DomainEventUnsubscribe;
+export interface BlocksApiOptions {
+    getBroker: () => CanvasMessageBroker | null;
+    getIsReady: () => boolean;
+    commandTimeoutMs: number;
+}
+export declare class BlocksApi {
+    private readonly options;
+    private readonly events;
+    private broker;
+    private brokerCleanups;
+    constructor(options: BlocksApiOptions);
+    on<TEventName extends BlocksEventName>(eventName: TEventName, handler: BlocksEventHandler<TEventName>): BlocksEventUnsubscribe;
+    connect(): void;
+    disconnect(): void;
+    getBlocks(options?: GetBlocksOptions): Promise<BlocksSnapshot>;
+    getDetails(options: GetBlockDetailsOptions): Promise<BlockDetailsSnapshot>;
+    getBlockDetails(options: GetBlockDetailsOptions): Promise<BlockDetailsSnapshot>;
+    getAttributes(options: GetBlockAttributesOptions): Promise<BlockAttributesSnapshot>;
+    getBlockAttributes(options: GetBlockAttributesOptions): Promise<BlockAttributesSnapshot>;
+    setVisibility(options: SetBlockVisibilityOptions): void;
+    setBlockVisibility(options: SetBlockVisibilityOptions): void;
+    private sendAndWaitForSnapshot;
+    private validateIndexSelector;
+    private validateSetVisibilityOptions;
+    private validateNumber;
+    private validateNumberArray;
+    private validateText;
+    private validateTextArray;
+}
+//# sourceMappingURL=BlocksApi.d.ts.map

package/dist/domains/BlocksApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlocksApi.d.ts","sourceRoot":"","sources":["../../src/domains/BlocksApi.ts"],"names":[],"mappings":"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"}

package/dist/domains/BlocksApi.js

@@ -0,0 +1,191 @@
+import { createCommandTimeoutError } from "../errors.js";
+import { createRequestId } from "../utils/createRequestId.js";
+import { DomainEventEmitter } from "../utils/DomainEventEmitter.js";
+import { createCanvasCommandError, requireReadyBroker, sendCanvasFireAndForget } from "./canvasBrokerCommands.js";
+export class BlocksApi {
+    constructor(options) {
+        this.events = new DomainEventEmitter();
+        this.broker = null;
+        this.brokerCleanups = [];
+        this.options = options;
+    }
+    on(eventName, handler) {
+        this.connect();
+        return this.events.on(eventName, handler);
+    }
+    connect() {
+        const broker = this.options.getBroker();
+        if (!broker || broker === this.broker) {
+            return;
+        }
+        this.disconnect();
+        this.broker = broker;
+        this.brokerCleanups = [
+            broker.on("blocksSnapshot", (message) => {
+                if (isBlocksSnapshot(message.payload)) {
+                    this.events.emit("snapshot", message.payload);
+                }
+            }),
+            broker.on("blockDetailsSnapshot", (message) => {
+                if (isBlockDetailsSnapshot(message.payload)) {
+                    this.events.emit("detailsSnapshot", message.payload);
+                }
+            }),
+            broker.on("blockAttributesSnapshot", (message) => {
+                if (isBlockDetailsSnapshot(message.payload)) {
+                    this.events.emit("attributesSnapshot", message.payload);
+                }
+            })
+        ];
+    }
+    disconnect() {
+        for (const cleanup of this.brokerCleanups) {
+            cleanup();
+        }
+        this.brokerCleanups = [];
+        this.broker = null;
+    }
+    getBlocks(options = {}) {
+        const requestId = options.requestId ?? createRequestId();
+        return this.sendAndWaitForSnapshot("getBlocks", "blocksSnapshot", { requestId }, requestId, isBlocksSnapshot, options.timeoutMs);
+    }
+    getDetails(options) {
+        this.validateIndexSelector("getBlockDetails", options);
+        const requestId = options.requestId ?? createRequestId();
+        const { timeoutMs, ...payloadOptions } = options;
+        return this.sendAndWaitForSnapshot("getBlockDetails", "blockDetailsSnapshot", {
+            ...payloadOptions,
+            requestId
+        }, requestId, isBlockDetailsSnapshot, timeoutMs);
+    }
+    getBlockDetails(options) {
+        return this.getDetails(options);
+    }
+    getAttributes(options) {
+        this.validateIndexSelector("getBlockAttributes", options);
+        const requestId = options.requestId ?? createRequestId();
+        const { timeoutMs, ...payloadOptions } = options;
+        return this.sendAndWaitForSnapshot("getBlockAttributes", "blockAttributesSnapshot", {
+            ...payloadOptions,
+            requestId
+        }, requestId, isBlockDetailsSnapshot, timeoutMs);
+    }
+    getBlockAttributes(options) {
+        return this.getAttributes(options);
+    }
+    setVisibility(options) {
+        this.validateSetVisibilityOptions(options);
+        sendCanvasFireAndForget({
+            ...this.options,
+            type: "setBlockVisibility",
+            payload: {
+                ...options,
+                requestId: options.requestId ?? createRequestId()
+            },
+            apiName: "viewer.blocks"
+        });
+    }
+    setBlockVisibility(options) {
+        this.setVisibility(options);
+    }
+    sendAndWaitForSnapshot(type, resultType, payload, requestId, isSnapshot, timeoutMs = this.options.commandTimeoutMs) {
+        const broker = requireReadyBroker({
+            ...this.options,
+            type,
+            apiName: "viewer.blocks"
+        });
+        return new Promise((resolve, reject) => {
+            const cleanup = broker.on(resultType, (message) => {
+                const snapshot = message.payload;
+                if (!isSnapshot(snapshot) || snapshot.requestId !== requestId) {
+                    return;
+                }
+                globalThis.clearTimeout(timeoutId);
+                cleanup();
+                resolve(snapshot);
+            });
+            const timeoutId = globalThis.setTimeout(() => {
+                cleanup();
+                reject(createCommandTimeoutError(requestId, type, timeoutMs));
+            }, timeoutMs);
+            broker.send(type, payload);
+        });
+    }
+    validateIndexSelector(type, options) {
+        if (!options || typeof options !== "object") {
+            throw createCanvasCommandError(type, "Block request options must be an object.", {
+                options
+            });
+        }
+        const selectorCount = [
+            options.index !== undefined,
+            options.indexes !== undefined
+        ].filter(Boolean).length;
+        if (selectorCount !== 1) {
+            throw createCanvasCommandError(type, "Block details and attribute requests require exactly one selector: index or indexes.", { options });
+        }
+        this.validateNumber(type, "index", options.index, options);
+        this.validateNumberArray(type, "indexes", options.indexes, options);
+    }
+    validateSetVisibilityOptions(options) {
+        if (!options || typeof options !== "object") {
+            throw createCanvasCommandError("setBlockVisibility", "Block visibility options must be an object.", { options });
+        }
+        if (typeof options.visible !== "boolean") {
+            throw createCanvasCommandError("setBlockVisibility", "Block visibility requires a boolean visible value.", { options });
+        }
+        const selectorCount = [
+            options.index !== undefined,
+            options.indexes !== undefined,
+            options.name !== undefined,
+            options.names !== undefined,
+            options.all === true
+        ].filter(Boolean).length;
+        if (selectorCount !== 1) {
+            throw createCanvasCommandError("setBlockVisibility", "Block visibility requires exactly one selector: index, indexes, name, names, or all.", { options });
+        }
+        this.validateNumber("setBlockVisibility", "index", options.index, options);
+        this.validateNumberArray("setBlockVisibility", "indexes", options.indexes, options);
+        this.validateText("name", options.name, options);
+        this.validateTextArray("names", options.names, options);
+    }
+    validateNumber(type, fieldName, value, options) {
+        if (value === undefined)
+            return;
+        if (!Number.isInteger(value) || value < 0) {
+            throw createCanvasCommandError(type, `${fieldName} must be a non-negative integer.`, { options });
+        }
+    }
+    validateNumberArray(type, fieldName, value, options) {
+        if (value === undefined)
+            return;
+        if (!Array.isArray(value) ||
+            value.length === 0 ||
+            !value.every((item) => Number.isInteger(item) && item >= 0)) {
+            throw createCanvasCommandError(type, `${fieldName} must be a non-empty array of non-negative integers.`, { options });
+        }
+    }
+    validateText(fieldName, value, options) {
+        if (value === undefined)
+            return;
+        if (value.trim().length === 0) {
+            throw createCanvasCommandError("setBlockVisibility", `${fieldName} must not be empty.`, { options });
+        }
+    }
+    validateTextArray(fieldName, value, options) {
+        if (value === undefined)
+            return;
+        if (!Array.isArray(value) ||
+            value.length === 0 ||
+            !value.every((item) => item.trim().length > 0)) {
+            throw createCanvasCommandError("setBlockVisibility", `${fieldName} must be a non-empty array of non-empty strings.`, { options });
+        }
+    }
+}
+function isBlocksSnapshot(payload) {
+    return !!payload && typeof payload === "object" && Array.isArray(payload.blocks);
+}
+function isBlockDetailsSnapshot(payload) {
+    return !!payload && typeof payload === "object" && Array.isArray(payload.blocks);
+}
+//# sourceMappingURL=BlocksApi.js.map

package/dist/domains/BlocksApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BlocksApi.js","sourceRoot":"","sources":["../../src/domains/BlocksApi.ts"],"names":[],"mappings":"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"}

package/dist/domains/CanvasApi.d.ts

@@ -0,0 +1,13 @@
+import type { CanvasMessage, CanvasMessageBroker, CanvasMessageHandler, CanvasMessageUnsubscribe } from "../messaging/CanvasMessageBroker.js";
+export interface CanvasApiOptions {
+    getBroker: () => CanvasMessageBroker | null;
+}
+export declare class CanvasApi {
+    private readonly getBroker;
+    constructor(options: CanvasApiOptions);
+    send<TPayload = unknown>(type: string, payload?: TPayload): void;
+    on<TPayload = unknown>(type: string, handler: CanvasMessageHandler<TPayload>): CanvasMessageUnsubscribe;
+    private requireBroker;
+}
+export type { CanvasMessage, CanvasMessageHandler, CanvasMessageUnsubscribe };
+//# sourceMappingURL=CanvasApi.d.ts.map

package/dist/domains/CanvasApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasApi.d.ts","sourceRoot":"","sources":["../../src/domains/CanvasApi.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,aAAa,EACb,mBAAmB,EACnB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,qCAAqC,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,mBAAmB,GAAG,IAAI,CAAC;CAC7C;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;gBAEjD,OAAO,EAAE,gBAAgB;IAIrC,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,GAAG,IAAI;IAIhE,EAAE,CAAC,QAAQ,GAAG,OAAO,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,oBAAoB,CAAC,QAAQ,CAAC,GACtC,wBAAwB;IAI3B,OAAO,CAAC,aAAa;CActB;AAED,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,wBAAwB,EACzB,CAAC"}

package/dist/domains/CanvasApi.js

@@ -0,0 +1,22 @@
+import { createViewerNotReadyError } from "../errors.js";
+export class CanvasApi {
+    constructor(options) {
+        this.getBroker = options.getBroker;
+    }
+    send(type, payload) {
+        this.requireBroker("send").send(type, payload);
+    }
+    on(type, handler) {
+        return this.requireBroker("subscribe").on(type, handler);
+    }
+    requireBroker(action) {
+        const broker = this.getBroker();
+        if (!broker) {
+            throw createViewerNotReadyError("RasterexViewer must be mounted before using viewer.canvas.", {
+                action
+            });
+        }
+        return broker;
+    }
+}
+//# sourceMappingURL=CanvasApi.js.map

package/dist/domains/CanvasApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CanvasApi.js","sourceRoot":"","sources":["../../src/domains/CanvasApi.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAYzD,MAAM,OAAO,SAAS;IAGpB,YAAY,OAAyB;QACnC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAED,IAAI,CAAqB,IAAY,EAAE,OAAkB;QACvD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACjD,CAAC;IAED,EAAE,CACA,IAAY,EACZ,OAAuC;QAEvC,OAAO,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3D,CAAC;IAEO,aAAa,CAAC,MAA4B;QAChD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QAEhC,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,yBAAyB,CAC7B,4DAA4D,EAC5D;gBACE,MAAM;aACP,CACF,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/domains/CollaborationApi.d.ts

@@ -0,0 +1,65 @@
+import { type DomainEventHandler, type DomainEventUnsubscribe } from "../utils/DomainEventEmitter.js";
+import type { CanvasMessageBroker } from "../messaging/CanvasMessageBroker.js";
+export interface CollaborationUserPayload {
+    username: string;
+    displayName?: string;
+    email?: string;
+}
+export interface CollaborationTooltipConfig {
+    iconSrc?: string;
+    title?: string;
+    message?: string;
+    messageTemplate?: string;
+    duration?: number;
+    position?: [number | "center", number];
+}
+export interface CollaborationConfigPayload {
+    enabled?: boolean;
+    canCollaborate?: boolean;
+    roomId?: string;
+    collaborationRoomId?: string;
+    canFileOpen?: boolean;
+    localStoreAnnotation?: boolean;
+    dbBackendApiKey?: string;
+    collaborationTooltip?: CollaborationTooltipConfig;
+    [key: string]: unknown;
+}
+export type CollaborationEnableOptions = Omit<CollaborationConfigPayload, "enabled" | "canCollaborate">;
+export interface SetUserOptions extends CollaborationUserPayload {
+    timeoutMs?: number;
+}
+export interface SetUserResultPayload {
+    success: boolean;
+    reason?: string;
+}
+export interface CollaborationEventMap {
+    setUserResult: SetUserResultPayload;
+}
+export type CollaborationEventName = keyof CollaborationEventMap;
+export type CollaborationEventHandler<TEventName extends CollaborationEventName> = DomainEventHandler<CollaborationEventMap[TEventName]>;
+export type CollaborationEventUnsubscribe = DomainEventUnsubscribe;
+export interface CollaborationApiOptions {
+    getBroker: () => CanvasMessageBroker | null;
+    getIsReady: () => boolean;
+    commandTimeoutMs: number;
+}
+export declare class CollaborationApi {
+    private readonly options;
+    private readonly events;
+    private broker;
+    private brokerCleanups;
+    private setUserInProgress;
+    constructor(options: CollaborationApiOptions);
+    on<TEventName extends CollaborationEventName>(eventName: TEventName, handler: CollaborationEventHandler<TEventName>): CollaborationEventUnsubscribe;
+    connect(): void;
+    disconnect(): void;
+    setUser(options: SetUserOptions): Promise<SetUserResultPayload>;
+    configure(payload: CollaborationConfigPayload): void;
+    enable(options?: CollaborationEnableOptions): void;
+    disable(options?: CollaborationEnableOptions): void;
+    private sendCollaboration;
+    private validateUserPayload;
+    private validateConfigPayload;
+    private validateTooltip;
+}
+//# sourceMappingURL=CollaborationApi.d.ts.map

package/dist/domains/CollaborationApi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CollaborationApi.d.ts","sourceRoot":"","sources":["../../src/domains/CollaborationApi.ts"],"names":[],"mappings":"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"}

package/dist/domains/CollaborationApi.js

@@ -0,0 +1,177 @@
+import { DomainEventEmitter } from "../utils/DomainEventEmitter.js";
+import { createCommandTimeoutError } from "../errors.js";
+import { createCanvasCommandError, requireReadyBroker } from "./canvasBrokerCommands.js";
+export class CollaborationApi {
+    constructor(options) {
+        this.events = new DomainEventEmitter();
+        this.broker = null;
+        this.brokerCleanups = [];
+        this.setUserInProgress = false;
+        this.options = options;
+    }
+    on(eventName, handler) {
+        this.connect();
+        return this.events.on(eventName, handler);
+    }
+    connect() {
+        const broker = this.options.getBroker();
+        if (!broker || broker === this.broker) {
+            return;
+        }
+        this.disconnect();
+        this.broker = broker;
+        this.brokerCleanups = [
+            broker.on("setUserResult", (message) => {
+                if (isSetUserResultPayload(message.payload)) {
+                    this.events.emit("setUserResult", message.payload);
+                }
+            })
+        ];
+    }
+    disconnect() {
+        for (const cleanup of this.brokerCleanups) {
+            cleanup();
+        }
+        this.brokerCleanups = [];
+        this.broker = null;
+        this.setUserInProgress = false;
+    }
+    setUser(options) {
+        const { timeoutMs, ...payload } = options;
+        this.validateUserPayload(payload);
+        if (this.setUserInProgress) {
+            return Promise.reject(createCanvasCommandError("setUser", "Only one collaboration setUser request can be active for a viewer iframe."));
+        }
+        const broker = requireReadyBroker({
+            ...this.options,
+            type: "setUser",
+            apiName: "viewer.collaboration"
+        });
+        const resultTimeoutMs = timeoutMs ?? this.options.commandTimeoutMs;
+        this.setUserInProgress = true;
+        return new Promise((resolve, reject) => {
+            const cleanup = broker.on("setUserResult", (message) => {
+                if (!isSetUserResultPayload(message.payload)) {
+                    return;
+                }
+                globalThis.clearTimeout(timeoutId);
+                cleanup();
+                this.setUserInProgress = false;
+                resolve(message.payload);
+            });
+            const timeoutId = globalThis.setTimeout(() => {
+                cleanup();
+                this.setUserInProgress = false;
+                reject(createCommandTimeoutError("setUserResult", "setUser", resultTimeoutMs));
+            }, resultTimeoutMs);
+            broker.send("setUser", payload);
+        });
+    }
+    configure(payload) {
+        this.validateConfigPayload(payload);
+        this.sendCollaboration(payload);
+    }
+    enable(options = {}) {
+        this.validateConfigPayload(options);
+        this.sendCollaboration({
+            ...options,
+            enabled: true
+        });
+    }
+    disable(options = {}) {
+        this.validateConfigPayload(options);
+        this.sendCollaboration({
+            ...options,
+            enabled: false
+        });
+    }
+    sendCollaboration(payload) {
+        requireReadyBroker({
+            ...this.options,
+            type: "collaboration",
+            apiName: "viewer.collaboration"
+        }).send("collaboration", payload);
+    }
+    validateUserPayload(payload) {
+        if (!hasText(payload.username)) {
+            throw createCanvasCommandError("setUser", "Collaboration user requires a non-empty username.", {
+                payload
+            });
+        }
+        if (payload.displayName !== undefined && typeof payload.displayName !== "string") {
+            throw createCanvasCommandError("setUser", "Collaboration user displayName must be a string when provided.", {
+                payload
+            });
+        }
+        if (payload.email !== undefined && typeof payload.email !== "string") {
+            throw createCanvasCommandError("setUser", "Collaboration user email must be a string when provided.", {
+                payload
+            });
+        }
+    }
+    validateConfigPayload(payload) {
+        if (!payload || typeof payload !== "object") {
+            throw createCanvasCommandError("collaboration", "Collaboration config requires a payload object.", {
+                payload
+            });
+        }
+        if (payload.enabled !== undefined && typeof payload.enabled !== "boolean") {
+            throw createCanvasCommandError("collaboration", "Collaboration enabled must be a boolean when provided.", {
+                payload
+            });
+        }
+        if (payload.canCollaborate !== undefined &&
+            typeof payload.canCollaborate !== "boolean") {
+            throw createCanvasCommandError("collaboration", "Collaboration canCollaborate must be a boolean when provided.", {
+                payload
+            });
+        }
+        if (payload.roomId !== undefined && !hasText(payload.roomId)) {
+            throw createCanvasCommandError("collaboration", "Collaboration roomId must be a non-empty string when provided.", {
+                payload
+            });
+        }
+        if (payload.collaborationRoomId !== undefined &&
+            !hasText(payload.collaborationRoomId)) {
+            throw createCanvasCommandError("collaboration", "Collaboration collaborationRoomId must be a non-empty string when provided.", {
+                payload
+            });
+        }
+        if (payload.collaborationTooltip !== undefined) {
+            this.validateTooltip(payload.collaborationTooltip, payload);
+        }
+    }
+    validateTooltip(tooltip, payload) {
+        if (!tooltip || typeof tooltip !== "object") {
+            throw createCanvasCommandError("collaboration", "Collaboration tooltip config must be an object when provided.", {
+                payload
+            });
+        }
+        if (tooltip.duration !== undefined &&
+            !Number.isFinite(tooltip.duration)) {
+            throw createCanvasCommandError("collaboration", "Collaboration tooltip duration must be a finite number when provided.", {
+                payload
+            });
+        }
+        if (tooltip.position === undefined) {
+            return;
+        }
+        const [x, y] = tooltip.position;
+        if (!Array.isArray(tooltip.position) ||
+            tooltip.position.length !== 2 ||
+            !((typeof x === "number" && Number.isFinite(x)) || x === "center") ||
+            typeof y !== "number" ||
+            !Number.isFinite(y)) {
+            throw createCanvasCommandError("collaboration", "Collaboration tooltip position must be [number | \"center\", number] when provided.", {
+                payload
+            });
+        }
+    }
+}
+function hasText(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function isSetUserResultPayload(payload) {
+    return !!payload && typeof payload === "object" && typeof payload.success === "boolean";
+}
+//# sourceMappingURL=CollaborationApi.js.map