3dviewer-sdk 1.0.2 → 1.0.4

package/dist/contracts/events.d.ts

@@ -0,0 +1,97 @@
+import type { MarkupListItem, MarkupOperationResultPayload, PdfCurrentPagePayload, PdfModeEventPayload, PdfToolbarActionEventPayload } from "./messages";
+export declare type ViewerEventMap = {
+    "camera:home": {
+        timestamp: number;
+    };
+    "node:select": {
+        nodeId: string;
+        timestamp: number;
+    };
+    "interaction:pan-change": {
+        enabled: boolean;
+    };
+    "toolbar:pdf-plan-mode": PdfModeEventPayload;
+    "toolbar:pdf-document-mode": PdfModeEventPayload;
+    "toolbar:pdf-first-page": PdfToolbarActionEventPayload;
+    "toolbar:pdf-previous-page": PdfToolbarActionEventPayload;
+    "toolbar:pdf-next-page": PdfToolbarActionEventPayload;
+    "toolbar:pdf-last-page": PdfToolbarActionEventPayload;
+    "toolbar:pdf-current-page": PdfCurrentPagePayload;
+    "modelTree:node-ids": {
+        requestId: string;
+        nodeIds: string[];
+        timestamp: number;
+    };
+    "sheets:list": {
+        requestId: string;
+        sheets: {
+            id: string | number;
+            name: string;
+            is3D?: boolean;
+            viewId?: string;
+        }[];
+        activeSheetId?: string | number | null;
+        timestamp: number;
+    };
+    "markup:list": {
+        requestId: string;
+        markups: MarkupListItem[];
+        timestamp: number;
+    };
+    "markup:save": MarkupOperationResultPayload;
+    "markup:cancel": MarkupOperationResultPayload;
+};
+export declare type LoadStage = "idle" | "uploading" | "converting" | "rendering" | "completed" | "error";
+export declare type LoadStatePayload = {
+    isLoading: boolean;
+    stage: LoadStage;
+    message?: string;
+    elapsedMs?: number;
+};
+export declare type PreparedViewerData = {
+    baseFileId: string;
+    baseMajorRev: number;
+    baseMinorRev: number;
+    fileName: string;
+    query: string;
+    url: string;
+};
+export declare type FilesEventMap = {
+    "files:state": LoadStatePayload;
+    "files:upload:start": {
+        fileName: string;
+    };
+    "files:upload:success": {
+        fileName: string;
+        baseFileId: string;
+    };
+    "files:upload:error": {
+        fileName: string;
+        error: string;
+    };
+    "files:conversion:start": {
+        fileName: string;
+    };
+    "files:conversion:success": PreparedViewerData;
+    "files:conversion:error": {
+        fileName: string;
+        error: string;
+    };
+    "files:render:start": {
+        url: string;
+    };
+    "files:render:success": {
+        url: string;
+    };
+    "files:render:error": {
+        url?: string;
+        error: string;
+    };
+    "files:load:success": PreparedViewerData;
+    "files:load:error": {
+        error: string;
+    };
+};
+export declare type SdkEventMap = ViewerEventMap & FilesEventMap;
+export declare type SdkEventKey = keyof SdkEventMap;
+export declare type SdkEventPayload<K extends SdkEventKey> = SdkEventMap[K];

package/dist/contracts/events.js

@@ -0,0 +1 @@
+export {};

package/dist/contracts/messages.d.ts

@@ -0,0 +1,153 @@
+export declare enum ViewerMessageType {
+    LANGUAGE_CHANGE = "viewer-language-change",
+    ZOOM = "viewer-zoom",
+    DRAW_MODE = "viewer-draw-mode",
+    EXPLODE = "viewer-explode",
+    MARKUP_ACTION = "viewer-markup-action",
+    MARKUP_SAVE = "viewer-markup-save",
+    MARKUP_CANCEL = "viewer-markup-cancel",
+    MARKUP_GET_LIST = "viewer-markup-get-list",
+    MARKUP_SAVE_RESULT = "viewer-markup-save-result",
+    MARKUP_CANCEL_RESULT = "viewer-markup-cancel-result",
+    MARKUP_LIST = "viewer-markup-list",
+    HOME = "viewer-home",
+    PAN_TOGGLE = "viewer-pan-toggle",
+    SELECT = "viewer-select",
+    AREA_SELECT = "viewer-area-select",
+    ORBIT = "viewer-orbit",
+    ROTATE_Z = "viewer-rotate-z",
+    WALK_THROUGH = "viewer-walk-through",
+    ZOOM_WINDOW = "viewer-zoom-window",
+    ZOOM_FIT = "viewer-zoom-fit",
+    TOOLBAR_CONFIG = "viewer-toolbar-config",
+    PANEL_OPEN = "viewer-panel-open",
+    PANEL_CLOSE = "viewer-panel-close",
+    CUTTING_PLANE_ACTION = "viewer-cutting-plane-action",
+    SHEETS_GET_LIST = "viewer-sheets-get-list",
+    SHEETS_LIST = "viewer-sheets-list",
+    SHEETS_APPLY = "viewer-sheets-apply",
+    TREE_SELECT_NODE = "viewer-tree-select-node",
+    TREE_GET_NODE_IDS = "viewer-tree-get-node-ids",
+    TREE_NODE_IDS = "viewer-tree-node-ids",
+    PDF_PLAN_MODE = "viewer-pdf-plan-mode",
+    PDF_DOCUMENT_MODE = "viewer-pdf-document-mode",
+    PDF_FIRST_PAGE = "viewer-pdf-first-page",
+    PDF_PREVIOUS_PAGE = "viewer-pdf-previous-page",
+    PDF_NEXT_PAGE = "viewer-pdf-next-page",
+    PDF_LAST_PAGE = "viewer-pdf-last-page",
+    PDF_CURRENT_PAGE = "viewer-pdf-current-page",
+    HOME_CLICK = "viewer-home-click",
+    NODE_SELECT = "viewer-node-select",
+    PAN_CHANGE = "viewer-pan-change"
+}
+export declare enum ViewerMessageSource {
+    SDK = "HC_SDK",
+    VIEWER = "HC_VIEWER"
+}
+export declare type OutgoingMessage<T = unknown> = {
+    source: ViewerMessageSource.SDK;
+    type: ViewerMessageType;
+    payload?: T;
+};
+export declare type IncomingMessage<T = any> = {
+    source?: ViewerMessageSource | string;
+    type: ViewerMessageType;
+    payload?: T;
+};
+export declare type LanguageCode = "en" | "vn";
+export declare type LanguageChangePayload = {
+    language: LanguageCode;
+    timestamp?: number;
+};
+export declare type DrawModeValue = "shaded" | "wireframe" | "hidden-line" | "shaded-wire" | "xray" | "ghosting";
+export declare type DrawModePayload = {
+    mode: DrawModeValue;
+};
+export declare type ExplodePayload = {
+    magnitude: number;
+};
+export declare type MarkupAction = "line" | "arrow" | "circle" | "ellipse" | "rectangle" | "polygon" | "polyline" | "textbox" | "note" | "callout" | "cloud" | "freehand";
+export declare type MarkupActionPayload = {
+    action: MarkupAction;
+};
+export declare type MarkupRequestPayload = {
+    requestId: string;
+};
+export declare type MarkupOperationResultPayload = {
+    requestId: string;
+    success: boolean;
+    timestamp: number;
+    error?: string;
+};
+export declare type MarkupListItem = {
+    id: string;
+    viewId: string;
+    viewName?: string;
+    title: string;
+    type: string;
+    shapeName?: string;
+    createdDate?: string;
+    modifiedDate?: string;
+    createdBy?: string;
+    lastModifiedBy?: string;
+};
+export declare type MarkupListPayload = {
+    requestId: string;
+    markups: MarkupListItem[];
+    timestamp: number;
+};
+export declare type PanelTarget = "clipping-commands" | "setting" | "statesObjects" | "linkedObjects" | "model-tree" | "sheets" | "object-properties";
+export declare type PanelOpenPayload = {
+    panel: PanelTarget;
+    format?: "3d" | "pdf";
+};
+export declare type PanelClosePayload = {
+    panel: PanelTarget;
+    format?: "3d" | "pdf";
+};
+export declare type CuttingPlaneAction = "close" | "multi" | "toggle-section" | "toggle-plane" | "plane-x" | "plane-y" | "plane-z" | "plane-box" | "rotate-box" | "reverse-plane-x" | "reverse-plane-y" | "reverse-plane-z";
+export declare type CuttingPlaneActionPayload = {
+    action: CuttingPlaneAction;
+};
+export declare type SheetsGetListPayload = {
+    requestId: string;
+};
+export declare type SheetListItem = {
+    id: string | number;
+    name: string;
+    is3D?: boolean;
+    viewId?: string;
+};
+export declare type SheetsListPayload = {
+    requestId: string;
+    sheets: SheetListItem[];
+    activeSheetId?: string | number | null;
+    timestamp: number;
+};
+export declare type SheetsApplyPayload = {
+    sheetId: string | number;
+};
+export declare type TreeSelectNodePayload = {
+    nodeId: string;
+};
+export declare type TreeGetNodeIdsPayload = {
+    requestId: string;
+    onlyRealNodes?: boolean;
+};
+export declare type TreeNodeIdsPayload = {
+    requestId: string;
+    nodeIds: string[];
+    timestamp: number;
+};
+export declare type PdfModeEventPayload = {
+    mode: "plan" | "document";
+    timestamp: number;
+};
+export declare type PdfToolbarActionEventPayload = {
+    timestamp: number;
+};
+export declare type PdfCurrentPagePayload = {
+    pageIndex: number;
+    pageNumber: number;
+    timestamp: number;
+};

package/dist/contracts/messages.js

@@ -0,0 +1,49 @@
+// sdk/src/contracts/messages.ts
+export var ViewerMessageType;
+(function (ViewerMessageType) {
+    ViewerMessageType["LANGUAGE_CHANGE"] = "viewer-language-change";
+    ViewerMessageType["ZOOM"] = "viewer-zoom";
+    ViewerMessageType["DRAW_MODE"] = "viewer-draw-mode";
+    ViewerMessageType["EXPLODE"] = "viewer-explode";
+    ViewerMessageType["MARKUP_ACTION"] = "viewer-markup-action";
+    ViewerMessageType["MARKUP_SAVE"] = "viewer-markup-save";
+    ViewerMessageType["MARKUP_CANCEL"] = "viewer-markup-cancel";
+    ViewerMessageType["MARKUP_GET_LIST"] = "viewer-markup-get-list";
+    ViewerMessageType["MARKUP_SAVE_RESULT"] = "viewer-markup-save-result";
+    ViewerMessageType["MARKUP_CANCEL_RESULT"] = "viewer-markup-cancel-result";
+    ViewerMessageType["MARKUP_LIST"] = "viewer-markup-list";
+    ViewerMessageType["HOME"] = "viewer-home";
+    ViewerMessageType["PAN_TOGGLE"] = "viewer-pan-toggle";
+    ViewerMessageType["SELECT"] = "viewer-select";
+    ViewerMessageType["AREA_SELECT"] = "viewer-area-select";
+    ViewerMessageType["ORBIT"] = "viewer-orbit";
+    ViewerMessageType["ROTATE_Z"] = "viewer-rotate-z";
+    ViewerMessageType["WALK_THROUGH"] = "viewer-walk-through";
+    ViewerMessageType["ZOOM_WINDOW"] = "viewer-zoom-window";
+    ViewerMessageType["ZOOM_FIT"] = "viewer-zoom-fit";
+    ViewerMessageType["TOOLBAR_CONFIG"] = "viewer-toolbar-config";
+    ViewerMessageType["PANEL_OPEN"] = "viewer-panel-open";
+    ViewerMessageType["PANEL_CLOSE"] = "viewer-panel-close";
+    ViewerMessageType["CUTTING_PLANE_ACTION"] = "viewer-cutting-plane-action";
+    ViewerMessageType["SHEETS_GET_LIST"] = "viewer-sheets-get-list";
+    ViewerMessageType["SHEETS_LIST"] = "viewer-sheets-list";
+    ViewerMessageType["SHEETS_APPLY"] = "viewer-sheets-apply";
+    ViewerMessageType["TREE_SELECT_NODE"] = "viewer-tree-select-node";
+    ViewerMessageType["TREE_GET_NODE_IDS"] = "viewer-tree-get-node-ids";
+    ViewerMessageType["TREE_NODE_IDS"] = "viewer-tree-node-ids";
+    ViewerMessageType["PDF_PLAN_MODE"] = "viewer-pdf-plan-mode";
+    ViewerMessageType["PDF_DOCUMENT_MODE"] = "viewer-pdf-document-mode";
+    ViewerMessageType["PDF_FIRST_PAGE"] = "viewer-pdf-first-page";
+    ViewerMessageType["PDF_PREVIOUS_PAGE"] = "viewer-pdf-previous-page";
+    ViewerMessageType["PDF_NEXT_PAGE"] = "viewer-pdf-next-page";
+    ViewerMessageType["PDF_LAST_PAGE"] = "viewer-pdf-last-page";
+    ViewerMessageType["PDF_CURRENT_PAGE"] = "viewer-pdf-current-page";
+    ViewerMessageType["HOME_CLICK"] = "viewer-home-click";
+    ViewerMessageType["NODE_SELECT"] = "viewer-node-select";
+    ViewerMessageType["PAN_CHANGE"] = "viewer-pan-change";
+})(ViewerMessageType || (ViewerMessageType = {}));
+export var ViewerMessageSource;
+(function (ViewerMessageSource) {
+    ViewerMessageSource["SDK"] = "HC_SDK";
+    ViewerMessageSource["VIEWER"] = "HC_VIEWER";
+})(ViewerMessageSource || (ViewerMessageSource = {}));

package/dist/core/emitter.d.ts

@@ -0,0 +1,7 @@
+export declare class Emitter<EventMap extends Record<string, any>> {
+    private listeners;
+    on<K extends keyof EventMap>(event: K, cb: (payload: EventMap[K]) => void): () => void;
+    off<K extends keyof EventMap>(event: K, cb: (payload: EventMap[K]) => void): void;
+    emit<K extends keyof EventMap>(event: K, payload: EventMap[K]): void;
+    clear(): void;
+}

package/dist/core/emitter.js

@@ -0,0 +1,31 @@
+// sdk/src/core/emitter.ts
+export class Emitter {
+    constructor() {
+        this.listeners = {};
+    }
+    on(event, cb) {
+        if (!this.listeners[event]) {
+            this.listeners[event] = [];
+        }
+        const arr = this.listeners[event];
+        arr.push(cb);
+        return () => this.off(event, cb);
+    }
+    off(event, cb) {
+        const arr = this.listeners[event];
+        if (!arr)
+            return;
+        const idx = arr.indexOf(cb);
+        if (idx >= 0)
+            arr.splice(idx, 1);
+        if (arr.length === 0)
+            delete this.listeners[event];
+    }
+    emit(event, payload) {
+        var _a;
+        (_a = this.listeners[event]) === null || _a === void 0 ? void 0 : _a.forEach((cb) => cb(payload));
+    }
+    clear() {
+        this.listeners = {};
+    }
+}

package/dist/index.d.mts

@@ -233,6 +233,26 @@ type FilesConfig = {
     viewerPath?: string;
     uploadPath?: string;
 };
+type ConvertOptions = {
+    downloadUrl?: string;
+};
+type ConvertV2Options = {
+    filename: string;
+    originalFilePath: string;
+    downloadUrl: string;
+    baseFileId: string;
+    baseMajorRev?: number;
+    baseMinorRev?: number;
+    overwrite?: boolean;
+    project?: string;
+    convertOptions?: Partial<StreamConvertOptions>;
+};
+type StreamConvertOptions = {
+    convert3DModel: number;
+    convert2DSheet: number;
+    extractProperties: number;
+    childModels: number;
+};
 declare class FilesModule {
     private viewer;
     on: {
@@ -282,12 +302,13 @@ declare class FilesModule {
         fileName: string;
         baseFileId: string;
     }>;
-    convert(file?: File): Promise<PreparedViewerData>;
-    prepare(file?: File): Promise<PreparedViewerData>;
+    convert(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
+    prepare(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
+    convertV2(options: ConvertV2Options): Promise<PreparedViewerData>;
     open(input: PreparedViewerData | {
         url: string;
     }): void;
-    render(file?: File): Promise<PreparedViewerData>;
+    render(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
     private resolveFile;
     private normalizeBaseUrl;
     private resolveBaseUrl;
@@ -301,8 +322,11 @@ declare class FilesModule {
     private getUploadSessionForFile;
     private uploadInternal;
     private buildCachePayload;
+    private buildConvertV2Payload;
     private cacheFile;
+    private cacheFileV2;
     private convertInternal;
+    private convertV2Internal;
     private updateState;
     private withOperation;
     private toErrorMessage;
@@ -475,4 +499,4 @@ declare class Viewer3D {
     private handleMessage;
 }
 
-export { type FilesConfig, type LanguageCode, type LoadStage, type LoadStatePayload, type MarkupAction, type MarkupListItem, type MarkupOperationResultPayload, type PreparedViewerData, Viewer3D };
+export { type ConvertOptions, type ConvertV2Options, type FilesConfig, type LanguageCode, type LoadStage, type LoadStatePayload, type MarkupAction, type MarkupListItem, type MarkupOperationResultPayload, type PreparedViewerData, Viewer3D };

package/dist/index.d.ts

@@ -233,6 +233,26 @@ type FilesConfig = {
     viewerPath?: string;
     uploadPath?: string;
 };
+type ConvertOptions = {
+    downloadUrl?: string;
+};
+type ConvertV2Options = {
+    filename: string;
+    originalFilePath: string;
+    downloadUrl: string;
+    baseFileId: string;
+    baseMajorRev?: number;
+    baseMinorRev?: number;
+    overwrite?: boolean;
+    project?: string;
+    convertOptions?: Partial<StreamConvertOptions>;
+};
+type StreamConvertOptions = {
+    convert3DModel: number;
+    convert2DSheet: number;
+    extractProperties: number;
+    childModels: number;
+};
 declare class FilesModule {
     private viewer;
     on: {
@@ -282,12 +302,13 @@ declare class FilesModule {
         fileName: string;
         baseFileId: string;
     }>;
-    convert(file?: File): Promise<PreparedViewerData>;
-    prepare(file?: File): Promise<PreparedViewerData>;
+    convert(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
+    prepare(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
+    convertV2(options: ConvertV2Options): Promise<PreparedViewerData>;
     open(input: PreparedViewerData | {
         url: string;
     }): void;
-    render(file?: File): Promise<PreparedViewerData>;
+    render(file?: File, options?: ConvertOptions): Promise<PreparedViewerData>;
     private resolveFile;
     private normalizeBaseUrl;
     private resolveBaseUrl;
@@ -301,8 +322,11 @@ declare class FilesModule {
     private getUploadSessionForFile;
     private uploadInternal;
     private buildCachePayload;
+    private buildConvertV2Payload;
     private cacheFile;
+    private cacheFileV2;
     private convertInternal;
+    private convertV2Internal;
     private updateState;
     private withOperation;
     private toErrorMessage;
@@ -475,4 +499,4 @@ declare class Viewer3D {
     private handleMessage;
 }
 
-export { type FilesConfig, type LanguageCode, type LoadStage, type LoadStatePayload, type MarkupAction, type MarkupListItem, type MarkupOperationResultPayload, type PreparedViewerData, Viewer3D };
+export { type ConvertOptions, type ConvertV2Options, type FilesConfig, type LanguageCode, type LoadStage, type LoadStatePayload, type MarkupAction, type MarkupListItem, type MarkupOperationResultPayload, type PreparedViewerData, Viewer3D };

package/dist/index.js

@@ -146,7 +146,7 @@ var NodeModule = class {
 
 // src/modules/files.module.ts
 var DEFAULT_API_BASE_URL = "https://dev.3dviewer.anybim.vn";
-var DEFAULT_VIEWER_ORIGIN = "https://dev.3dviewer.anybim.vn";
+var DEFAULT_VIEWER_ORIGIN = "http://localhost:3000";
 var FilesModule = class {
   constructor(viewer) {
     this.viewer = viewer;
@@ -194,12 +194,12 @@ var FilesModule = class {
     });
   }
   // Trigger conversion flow and resolve final viewer metadata.
-  async convert(file) {
+  async convert(file, options = {}) {
     const target = this.resolveFile(file);
     return this.withOperation({ stage: "converting", message: "Converting file..." }, async () => {
       this.viewer._emit("files:conversion:start", { fileName: target.name });
       try {
-        const prepared = await this.convertInternal(target);
+        const prepared = await this.convertInternal(target, options);
         this.viewer._emit("files:conversion:success", prepared);
         return prepared;
       } catch (e) {
@@ -209,14 +209,28 @@ var FilesModule = class {
     });
   }
   // Convenience API: upload first, then convert in one call.
-  async prepare(file) {
+  async prepare(file, options = {}) {
     const target = this.resolveFile(file);
     return this.withOperation({ stage: "uploading", message: "Preparing file..." }, async () => {
       await this.uploadInternal(target);
-      const prepared = await this.convertInternal(target);
+      const prepared = await this.convertInternal(target, options);
       return prepared;
     });
   }
+  // Trigger the newer downloadUrl-based conversion flow.
+  async convertV2(options) {
+    return this.withOperation({ stage: "converting", message: "Converting file..." }, async () => {
+      this.viewer._emit("files:conversion:start", { fileName: options.filename });
+      try {
+        const prepared = await this.convertV2Internal(options);
+        this.viewer._emit("files:conversion:success", prepared);
+        return prepared;
+      } catch (e) {
+        this.viewer._emit("files:conversion:error", { fileName: options.filename, error: this.toErrorMessage(e) });
+        throw e;
+      }
+    });
+  }
   // Open iframe with an already prepared viewer URL.
   open(input) {
     const url = input.url;
@@ -230,11 +244,11 @@ var FilesModule = class {
     }
   }
   // Full pipeline: upload + convert + open iframe.
-  async render(file) {
+  async render(file, options = {}) {
     const target = this.resolveFile(file);
     return this.withOperation({ stage: "uploading", message: "Uploading + converting + opening..." }, async () => {
       await this.upload(target);
-      const prepared = await this.convert(target);
+      const prepared = await this.convert(target, options);
       this.updateState({ stage: "rendering", message: "Opening viewer..." });
       this.open(prepared);
       this.viewer._emit("files:load:success", prepared);
@@ -327,10 +341,11 @@ var FilesModule = class {
     }
   }
   // Build StreamFile payload compatible with conversion service.
-  buildCachePayload(file, baseFileId) {
+  buildCachePayload(file, baseFileId, options = {}) {
     const createdDate = (/* @__PURE__ */ new Date()).toISOString();
     return {
       filename: file.name,
+      ...options.downloadUrl ? { downloadUrl: options.downloadUrl } : {},
       baseFileId,
       baseMajorRev: 0,
       baseMinorRev: 0,
@@ -373,11 +388,31 @@ var FilesModule = class {
       attemptedConvertTimes: 0
     };
   }
+  // Build payload for POST /api/StreamFile/convert.
+  buildConvertV2Payload(options) {
+    var _a, _b;
+    const convertOptions = {
+      convert3DModel: 1,
+      convert2DSheet: 1,
+      extractProperties: 1,
+      childModels: 0,
+      ...options.convertOptions
+    };
+    return {
+      filename: options.filename,
+      originalFilePath: options.originalFilePath,
+      convertOptions,
+      downloadUrl: options.downloadUrl,
+      baseFileId: options.baseFileId,
+      baseMajorRev: (_a = options.baseMajorRev) != null ? _a : 0,
+      baseMinorRev: (_b = options.baseMinorRev) != null ? _b : 0
+    };
+  }
   // Submit conversion/caching request and return service response.
-  async cacheFile(file, baseFileId) {
+  async cacheFile(file, baseFileId, options = {}) {
     const hostConversion = await this.resolveHostConversion();
     const url = `${hostConversion}/api/StreamFile?overwrite=true&ignore_line_weight=1`;
-    const payload = this.buildCachePayload(file, baseFileId);
+    const payload = this.buildCachePayload(file, baseFileId, options);
     const response = await fetch(url, {
       method: "POST",
       headers: {
@@ -393,17 +428,45 @@ var FilesModule = class {
     }
     return await response.json();
   }
+  // Submit conversion request to the newer downloadUrl-based endpoint.
+  async cacheFileV2(options) {
+    const hostConversion = await this.resolveHostConversion();
+    const params = new URLSearchParams();
+    if (typeof options.overwrite === "boolean") {
+      params.set("overwrite", String(options.overwrite));
+    }
+    if (options.project) {
+      params.set("project", options.project);
+    }
+    const query = params.toString();
+    const url = `${hostConversion}/api/StreamFile/convert${query ? `?${query}` : ""}`;
+    const payload = this.buildConvertV2Payload(options);
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json"
+      },
+      body: JSON.stringify(payload)
+    });
+    if (!response.ok) {
+      throw new Error(
+        `Cache/convert v2 failed (${response.status} ${response.statusText})`
+      );
+    }
+    return await response.json();
+  }
   // Convert file and generate final iframe URL with query string.
-  async convertInternal(file) {
+  async convertInternal(file, options = {}) {
     var _a, _b, _c, _d;
     this.updateState({ stage: "converting", message: "Converting file..." });
     const uploadSession = this.getUploadSessionForFile(file) || this.createUploadSession(file);
     const seedBaseFileId = uploadSession.baseFileId;
-    const cacheResult = await this.cacheFile(file, seedBaseFileId);
+    const cacheResult = await this.cacheFile(file, seedBaseFileId, options);
     const baseFileId = (_a = cacheResult.baseFileId) != null ? _a : seedBaseFileId;
     const baseMajorRev = (_b = cacheResult.baseMajorRev) != null ? _b : 0;
     const baseMinorRev = (_c = cacheResult.baseMinorRev) != null ? _c : 0;
-    const fileName = cacheResult.filename || file.name;
+    const fileName = cacheResult.filename || cacheResult.fileName || file.name;
     const cacheListItem = { baseFileId, baseMajorRev, baseMinorRev, fileName };
     if (cacheResult.cacheStatus !== 2) {
       throw new Error(`Conversion not ready after first request (cacheStatus=${(_d = cacheResult.cacheStatus) != null ? _d : "unknown"})`);
@@ -414,6 +477,24 @@ var FilesModule = class {
     const url = `${viewerBase}${viewerPath}?${query}`;
     return { baseFileId, baseMajorRev, baseMinorRev, fileName, query, url };
   }
+  async convertV2Internal(options) {
+    var _a, _b, _c, _d, _e;
+    this.updateState({ stage: "converting", message: "Converting file..." });
+    const cacheResult = await this.cacheFileV2(options);
+    const baseFileId = (_a = cacheResult.baseFileId) != null ? _a : options.baseFileId;
+    const baseMajorRev = (_c = (_b = cacheResult.baseMajorRev) != null ? _b : options.baseMajorRev) != null ? _c : 0;
+    const baseMinorRev = (_e = (_d = cacheResult.baseMinorRev) != null ? _d : options.baseMinorRev) != null ? _e : 0;
+    const fileName = cacheResult.filename || cacheResult.fileName || options.filename;
+    if (cacheResult.cacheStatus !== void 0 && cacheResult.cacheStatus !== 2) {
+      throw new Error(`Conversion not ready after v2 request (cacheStatus=${cacheResult.cacheStatus})`);
+    }
+    const cacheListItem = { baseFileId, baseMajorRev, baseMinorRev, fileName };
+    const query = new URLSearchParams({ fileList: JSON.stringify([cacheListItem]) }).toString();
+    const viewerBase = this.resolveViewerOrigin();
+    const viewerPath = this.resolveViewerPath();
+    const url = `${viewerBase}${viewerPath}?${query}`;
+    return { baseFileId, baseMajorRev, baseMinorRev, fileName, query, url };
+  }
   // Update internal loading state and emit state event.
   updateState(next) {
     const elapsedMs = this.operationStartTime > 0 ? Date.now() - this.operationStartTime : 0;