@rhc-office/sdk 6.6.363 → 6.6.381

package/dist/viewer/DocumentSDK.d.ts

@@ -35,6 +35,7 @@ export declare class DocumentSDK implements IDocumentSDK {
     private normalizedConfiguration;
     private runtimeRestoreState;
     private sessionUser?;
+    private sessionUserId?;
     private sessionData?;
     private readonly nativeEventCleanupCallbacks;
     private themeCleanup;

package/dist/viewer/DocumentSDK.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DocumentSDK.d.ts","sourceRoot":"","sources":["../../src/viewer/DocumentSDK.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"DocumentSDK.d.ts","sourceRoot":"","sources":["../../src/viewer/DocumentSDK.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAmB,MAAM,qBAAqB,CAAC;AA+CzE,UAAU,yBAAyB;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAkND,qBAAa,WAAY,YAAW,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA4B;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA6B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA0B;IACtD,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAMhC;IACF,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgD;IAC7E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA0C;IACjE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmD;IACnF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA4C;IACrE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkD;IACjF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAmD;IACnF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiD;IAC/E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkD;IACjF,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAoD;IACrF,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiD;IAC/E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkD;IACjF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA8C;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAgD;IAE7E,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAC5D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA8B;IAE9D,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAAK;IAEvB,OAAO,CAAC,mBAAmB,CAAC,CAAsB;IAClD,OAAO,CAAC,aAAa,CAA+B;IACpD,OAAO,CAAC,aAAa,CAA4B;IACjD,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,uBAAuB,CAA6C;IAC5E,OAAO,CAAC,mBAAmB,CAGX;IAChB,OAAO,CAAC,WAAW,CAAC,CAAgD;IACpE,OAAO,CAAC,aAAa,CAAC,CAAkD;IACxE,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAAyB;IACrE,OAAO,CAAC,YAAY,CAAmC;gBAE3C,OAAO,CAAC,EAAE,yBAAyB;IAO/C,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAE/C;IAEF,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAMrD;IAEF,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CAejD;IAEF,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAErD;IAEF,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAEzD;IAEF,QAAQ,CAAC,cAAc,EAAE,YAAY,CAAC,gBAAgB,CAAC,CAErD;IAEF,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,CAEnD;IAEF,QAAQ,CAAC,iBAAiB,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAE3D;IAEF,QAAQ,CAAC,sBAAsB,EAAE,YAAY,CAAC,wBAAwB,CAAC,CAErE;IAEF,QAAQ,CAAC,uBAAuB,EAAE,YAAY,CAAC,yBAAyB,CAAC,CAEvE;IAEF,QAAQ,CAAC,sBAAsB,EAAE,YAAY,CAAC,wBAAwB,CAAC,CAErE;IAEF,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAgB/C;IAEF,QAAQ,CAAC,YAAY,EAAE,YAAY,CAAC,cAAc,CAAC,CA4BjD;IAEF,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAEvD;IAEF,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAC,WAAW,CAAC,CAE3C;IAEF,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAE/C;IAEF,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC,oBAAoB,CAAC,CAE7D;IAEF,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC,aAAa,CAAC,CAE/C;IAEF,QAAQ,CAAC,iBAAiB,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAE3D;IAEF,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC,oBAAoB,CAAC,CAE7D;IAEF,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAEzD;IAEF,QAAQ,CAAC,iBAAiB,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAE3D;IAEF,QAAQ,CAAC,mBAAmB,EAAE,YAAY,CAAC,qBAAqB,CAAC,CAE/D;IAEF,QAAQ,CAAC,gBAAgB,EAAE,YAAY,CAAC,kBAAkB,CAAC,CAEzD;IAEF,QAAQ,CAAC,iBAAiB,EAAE,YAAY,CAAC,mBAAmB,CAAC,CAE3D;IAEF,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,CAEnD;IAEF,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC,iBAAiB,CAAC,CAEvD;IAEF,QAAQ,CAAC,wBAAwB,EAAE,YAAY,CAAC,0BAA0B,CAAC,CAEzE;IAEF,QAAQ,CAAC,aAAa,EAAE,YAAY,CAAC,eAAe,CAAC,CAEnD;IAEF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAyD1B;IAEF,OAAO,CAAC,wBAAwB;IA0BhC,OAAO,CAAC,0BAA0B;IAclC,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAsCrC;IAEF,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAE3C;IAEF,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAGlC;IAEF,OAAO,CAAC,QAAQ,CAAC,eAAe,CAE9B;IAEF,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAOhC;IAEF,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAMjC;CACH;AAED,eAAO,MAAM,oBAAoB,GAAI,UAAU,yBAAyB,KAAG,YAE1E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rhc-office/sdk",
-  "version": "6.6.363",
+  "version": "6.6.381",
   "description": "SDK for third-party integration with RHC Office Platform",
   "type": "module",
   "main": "dist/index.js",

package/src/api/digital-sign-environment.ts

@@ -111,6 +111,12 @@ interface DigitalSignEnvironmentRuntimeStore {
   overrides: DigitalSignEnvironmentPatch;
 }
 
+export interface DigitalSignEnvironmentSourceSnapshot {
+  current: DigitalSignEnvironmentConfig;
+  defaults: DigitalSignEnvironmentConfig;
+  overrides: DigitalSignEnvironmentPatch;
+}
+
 const DIGITAL_SIGN_ENVIRONMENT_STORE_KEY = '__RHC_OFFICE_DIGITAL_SIGN_ENVIRONMENT__';
 
 const EMPTY_DIGITAL_SIGN_ENVIRONMENT: DigitalSignEnvironmentConfig = {
@@ -302,24 +308,51 @@ const mergeEnvironmentPatchState = (
   base: DigitalSignEnvironmentPatch,
   patch: DigitalSignEnvironmentPatch,
 ): DigitalSignEnvironmentPatch => {
+  const mergedDefaultsBjca =
+    base.defaults?.bjca || patch.defaults?.bjca
+      ? {
+          ...base.defaults?.bjca,
+          ...patch.defaults?.bjca,
+        }
+      : undefined;
+  const mergedDefaultsKol =
+    base.defaults?.kol || patch.defaults?.kol
+      ? {
+          ...base.defaults?.kol,
+          ...patch.defaults?.kol,
+        }
+      : undefined;
+  const mergedDefaultsPlugin =
+    base.defaults?.plugin || patch.defaults?.plugin
+      ? {
+          ...base.defaults?.plugin,
+          ...patch.defaults?.plugin,
+        }
+      : undefined;
+  const mergedSignServerKol =
+    base.signServer?.kol || patch.signServer?.kol
+      ? {
+          ...base.signServer?.kol,
+          ...patch.signServer?.kol,
+        }
+      : undefined;
+  const mergedSignServerUsbKey =
+    base.signServer?.usbKey || patch.signServer?.usbKey
+      ? {
+          ...base.signServer?.usbKey,
+          ...patch.signServer?.usbKey,
+        }
+      : undefined;
+
   return {
     defaults:
       base.defaults || patch.defaults
         ? {
             ...base.defaults,
             ...patch.defaults,
-            bjca: {
-              ...(base.defaults?.bjca ?? {}),
-              ...(patch.defaults?.bjca ?? {}),
-            },
-            kol: {
-              ...(base.defaults?.kol ?? {}),
-              ...(patch.defaults?.kol ?? {}),
-            },
-            plugin: {
-              ...(base.defaults?.plugin ?? {}),
-              ...(patch.defaults?.plugin ?? {}),
-            },
+            ...(mergedDefaultsBjca ? { bjca: mergedDefaultsBjca } : {}),
+            ...(mergedDefaultsKol ? { kol: mergedDefaultsKol } : {}),
+            ...(mergedDefaultsPlugin ? { plugin: mergedDefaultsPlugin } : {}),
           }
         : undefined,
     signServer:
@@ -327,14 +360,8 @@ const mergeEnvironmentPatchState = (
         ? {
             ...base.signServer,
             ...patch.signServer,
-            kol: {
-              ...(base.signServer?.kol ?? {}),
-              ...(patch.signServer?.kol ?? {}),
-            },
-            usbKey: {
-              ...(base.signServer?.usbKey ?? {}),
-              ...(patch.signServer?.usbKey ?? {}),
-            },
+            ...(mergedSignServerKol ? { kol: mergedSignServerKol } : {}),
+            ...(mergedSignServerUsbKey ? { usbKey: mergedSignServerUsbKey } : {}),
           }
         : undefined,
   };
@@ -365,6 +392,15 @@ export const getDigitalSignEnvironment = (): DigitalSignEnvironmentConfig => {
   return resolveRuntimeStore().current;
 };
 
+export const getDigitalSignEnvironmentSource = (): DigitalSignEnvironmentSourceSnapshot => {
+  const store = resolveRuntimeStore();
+  return {
+    current: cloneEnvironmentConfig(store.current),
+    defaults: cloneEnvironmentConfig(store.defaults),
+    overrides: cloneEnvironmentPatch(store.overrides),
+  };
+};
+
 export const initializeDigitalSignEnvironment = (
   defaults: DigitalSignEnvironmentConfig,
 ): DigitalSignEnvironmentConfig => {

package/src/browser.ts

@@ -4,6 +4,7 @@ import {
   WatermarkDisplay,
   createNewDocumentSdk,
   getDigitalSignEnvironment,
+  getDigitalSignEnvironmentSource,
   initializeDigitalSignEnvironment,
   patchDigitalSignEnvironment,
   resetDigitalSignEnvironment,
@@ -18,6 +19,7 @@ export interface RHCOfficeSDKBrowserNamespace {
   createNewDocumentSdk: typeof createNewDocumentSdk;
   newDocumentSDK: typeof createNewDocumentSdk;
   getDigitalSignEnvironment: typeof getDigitalSignEnvironment;
+  getDigitalSignEnvironmentSource: typeof getDigitalSignEnvironmentSource;
   initializeDigitalSignEnvironment: typeof initializeDigitalSignEnvironment;
   patchDigitalSignEnvironment: typeof patchDigitalSignEnvironment;
   resetDigitalSignEnvironment: typeof resetDigitalSignEnvironment;
@@ -31,6 +33,7 @@ export const RHCOfficeSDK: RHCOfficeSDKBrowserNamespace = {
   createNewDocumentSdk,
   newDocumentSDK: createNewDocumentSdk,
   getDigitalSignEnvironment,
+  getDigitalSignEnvironmentSource,
   initializeDigitalSignEnvironment,
   patchDigitalSignEnvironment,
   resetDigitalSignEnvironment,
@@ -62,6 +65,7 @@ declare global {
     createNewDocumentSdk: typeof createNewDocumentSdk;
     newDocumentSDK(options?: ConstructorParameters<typeof DocumentSDK>[0]): IDocumentSDK;
     getDigitalSignEnvironment: typeof getDigitalSignEnvironment;
+    getDigitalSignEnvironmentSource: typeof getDigitalSignEnvironmentSource;
     initializeDigitalSignEnvironment: typeof initializeDigitalSignEnvironment;
     patchDigitalSignEnvironment: typeof patchDigitalSignEnvironment;
     resetDigitalSignEnvironment: typeof resetDigitalSignEnvironment;
@@ -76,6 +80,7 @@ export {
   WatermarkDisplay,
   createNewDocumentSdk,
   getDigitalSignEnvironment,
+  getDigitalSignEnvironmentSource,
   initializeDigitalSignEnvironment,
   patchDigitalSignEnvironment,
   resetDigitalSignEnvironment,

package/src/viewer/DocumentSDK.ts

@@ -61,6 +61,10 @@ interface ReaderHostRuntimeConfig {
     baseUrl?: string;
     paths?: Record<string, string | undefined>;
   };
+  identity?: {
+    sessionUser?: string;
+    sessionUserId?: string;
+  };
 }
 
 type NativeReaderEventName = 'documentLoaded' | 'documentStateChange' | 'documentError';
@@ -107,6 +111,36 @@ const createReaderPayload = (
   };
 };
 
+const normalizeSessionUserIdentity = (
+  sessionUser: Parameters<IDocumentSDK['setSessionUser']>[0] | undefined,
+  sessionUserId: Parameters<IDocumentSDK['setSessionUserId']>[0] | undefined,
+): ReaderHostRuntimeConfig['identity'] | undefined => {
+  if (!sessionUser) {
+    return undefined;
+  }
+
+  const userName =
+    typeof sessionUser === 'string' ? sessionUser.trim() : sessionUser.userName.trim();
+  if (!userName) {
+    return undefined;
+  }
+
+  const explicitUserId =
+    sessionUserId === undefined || sessionUserId === null ? '' : String(sessionUserId).trim();
+  const objectUserId =
+    typeof sessionUser === 'string' ||
+    sessionUser.userId === undefined ||
+    sessionUser.userId === null
+      ? ''
+      : String(sessionUser.userId).trim();
+  const normalizedUserId = explicitUserId || objectUserId;
+
+  return {
+    sessionUser: userName,
+    ...(normalizedUserId ? { sessionUserId: normalizedUserId } : {}),
+  };
+};
+
 const resolveContainerElement = (container: string | HTMLDivElement): HTMLDivElement => {
   if (typeof container === 'string') {
     const element = document.getElementById(container);
@@ -271,6 +305,7 @@ export class DocumentSDK implements IDocumentSDK {
     previousRuntime?: ReaderHostRuntimeConfig;
   } | null = null;
   private sessionUser?: Parameters<IDocumentSDK['setSessionUser']>[0];
+  private sessionUserId?: Parameters<IDocumentSDK['setSessionUserId']>[0];
   private sessionData?: string;
   private readonly nativeEventCleanupCallbacks: Array<() => void> = [];
   private themeCleanup: ReaderThemeCleanup | null = null;
@@ -316,18 +351,7 @@ export class DocumentSDK implements IDocumentSDK {
   };
 
   readonly setSessionUserId: IDocumentSDK['setSessionUserId'] = (userId): void => {
-    if (typeof this.sessionUser === 'string' || !this.sessionUser) {
-      this.sessionUser = {
-        userName: typeof this.sessionUser === 'string' ? this.sessionUser : '',
-        userId,
-      };
-      return;
-    }
-
-    this.sessionUser = {
-      ...this.sessionUser,
-      userId,
-    };
+    this.sessionUserId = userId;
   };
 
   readonly setSessionData: IDocumentSDK['setSessionData'] = (sessionData): void => {
@@ -487,6 +511,11 @@ export class DocumentSDK implements IDocumentSDK {
       const shouldUseCompactMode =
         configuration.compactViewer === true && configuration.keepPCMenu !== true;
       readerElement.toggleAttribute('data-sdk-compact-mode', shouldUseCompactMode);
+      readerElement.toggleAttribute('data-sdk-ribbon-hidden', configuration.ribbonMenu === false);
+      readerElement.toggleAttribute(
+        'data-sdk-ribbon-title-hidden',
+        configuration.ribbonTitle === false,
+      );
       readerElement.setAttribute('language', configuration.language ?? 'zh_CN');
       this.themeCleanup = bindReaderElementTheme(readerElement, configuration.theme);
       this.bindNativeReaderEvents(readerElement);
@@ -525,11 +554,13 @@ export class DocumentSDK implements IDocumentSDK {
     configuration: NormalizedReaderEmbedOptions,
   ): void {
     this.restoreReaderRuntimeConfig();
+    const identity = normalizeSessionUserIdentity(this.sessionUser, this.sessionUserId);
     const readerHost: ReaderHostRuntimeConfig = {
       hostKind: 'server',
       server: {
         baseUrl: configuration.appUrl,
       },
+      ...(identity ? { identity } : {}),
     };
 
     const runtimeElement = readerElement as ReaderRuntimeElement;