weboffice-js-sdk 2.0.5-beta.15 → 2.0.5-beta.16

package/README.md

@@ -47,6 +47,27 @@ connect({
 - `disableAiEntry` 为可选布尔值，透传到 iframe 内 `OfficeSDK` 的 AI 入口开关能力。
 - `theme` 为可选主题对象，宿主侧仅负责透传；未传时 iframe 内仍使用默认主题配置。
 
+### V2 统一编辑 / 预览入口
+
+V2 使用独立的 `connectV2()`，旧 `connect()` 保持兼容。V2 要求 `type` 和 `mode` 必填：
+
+```typescript
+import { connectV2 } from 'weboffice-js-sdk'
+
+const sdk = await connectV2({
+  fileId: 'your-file-id',
+  endpoint: 'https://your-shimo-endpoint',
+  signature: 'your-signature',
+  token: 'your-token',
+  container: document.querySelector('#shimo-file'),
+  type: 'writer',
+  mode: 'edit',
+  refreshCredentialsInterval: 600000
+})
+```
+
+支持的 `type` 包括 `file`、`document`、`documentPro`、`writer`、`spreadsheet`、`presentation`、`table` 和 `form`。`writer` 与 `documentPro` 当前共存，`writer` 目前处于内测阶段。当前 `type` 主要作为 iframe 后续基于 `manifest.json` 选择资源的预留字段，不改变后端编辑准备判断。
+
 返回值：
 
 ```

package/dist/OfficeSDK.d.ts

@@ -9,6 +9,7 @@ import { Document, DocumentPro, Presentation, Spreadsheet, Table, Form, Flowchar
 import { EmptyPageOptions } from './types/EmptyPage';
 import { BaseEditor } from './types/BaseEditor';
 import { SlashMenuOptions } from './types/SlashMenu';
+import type { ContentVersion } from './types/ConnectV2';
 import type { CollaboratorFacade, CommentsFacade, ContentFacade, DiscussionFacade, DocsActiveOutlineFacade, DocsOutlineFacade, DocsSearchFacade, DocsSelectionFacade, DocsSettingsFacade, DocsSidebarFacade, DocsTablesFacade, ExternalAppFacade, HistoryFacade, LocksFacade, MentionFacade, OfficeSDKPresentationFacade, PresentationEventSubscriptionFacade, PresentationSelectionFacade, PresentationSlidesFacade, PresentationTextFacade, PresentationZoomFacade, SheetChartsFacade, SheetSelectionsFacade, SheetWorkbookFacade, SheetWorksheetFacade, TitleFacade, VersionFacade } from './OfficeSDK.facade.types';
 import type { OfficeSDKMethodPath } from './OfficeSDK.methods';
 import type { HeaderBarsFacade } from './OfficeSDK.headerBars';
@@ -185,6 +186,7 @@ export declare class OfficeSDK extends TinyEmitter {
     private readonly emitter;
     private channel;
     private readonly connectOptions;
+    private readonly contentVersion?;
     private _readyState;
     private editor;
     private readonly startParams;
@@ -216,10 +218,15 @@ export declare class OfficeSDK extends TinyEmitter {
      * 归一化后的缺省页配置，构造时一次算完，后续仅读取。
      */
     private readonly normalizedEmptyPage;
+    private readonly preloadCredentialsMessageHandler;
+    private pendingInitializationErrorHandler?;
+    private pendingInitializationError?;
+    private preloadCredentialsPromise?;
+    private disconnected;
     private readonly preloadAckTimeoutMs;
     private readonly preloadDoneTimeoutMs;
     private readonly preloadReadyTimeoutMs;
-    constructor(options: OfficeSDKOptions);
+    constructor(options: OfficeSDKOptions, contentVersion?: ContentVersion);
     get fileType(): FileType;
     get readyState(): ReadyState;
     /**
@@ -288,6 +295,8 @@ export declare class OfficeSDK extends TinyEmitter {
      */
     ready(): Promise<void>;
     private initIframe;
+    private handlePreloadMessage;
+    private getPreloadCredentials;
     private runPreloadHandshake;
     private initChannel;
     /**

package/dist/connect.d.ts

@@ -1,6 +1,19 @@
 import { OfficeSDK, OfficeSDKOptions } from './OfficeSDK';
+import { type ConnectV2FileType } from './types/ConnectV2';
+export { CONNECT_V2_FILE_TYPES, isConnectV2FileType, isConnectV2Mode, validateConnectV2Options } from './types/ConnectV2';
+export type { ConnectV2FileType } from './types/ConnectV2';
 export interface ConnectOptions extends OfficeSDKOptions {
 }
+export interface ConnectV2Options extends ConnectOptions {
+    /**
+     * V2 套件类型。当前用于 iframe 侧资源选择预留。
+     */
+    type: ConnectV2FileType;
+    /**
+     * V2 打开模式。
+     */
+    mode: 'edit' | 'preview';
+}
 /**
  * 初始化 SDK，返回 Promise，当 ReadState 变为 Ready 或 Failed 时，Promise 将被 resolve。
  * Promise resovled 不代表编辑器已经完整加载完毕，只代表 SDK 已经准备好了。
@@ -8,3 +21,9 @@ export interface ConnectOptions extends OfficeSDKOptions {
  * 比如受浏览器限制无法发出 postMessage() 时，Promise 将会一直 pending。
  */
 export declare function connect(options: ConnectOptions): Promise<OfficeSDK>;
+/**
+ * 初始化 V2 统一编辑 / 预览入口。
+ *
+ * V2 在运行时强制校验 type 和 mode，底层 iframe 初始化流程与旧 connect 共用。
+ */
+export declare function connectV2(options: ConnectV2Options): Promise<OfficeSDK>;