@cloudcare/hvigor-ohos-plugin 0.1.1 → 0.1.2-alpha.2

package/hvigorCompile/ft-web-replay-transform.ts

@@ -0,0 +1,61 @@
+/** Associate every native Web with its controller without replacing application IDs or callbacks. */
+import { isApplicationArkTsSource } from './ft-console-log-transform';
+import { hasRuntimeDependency, SourceReader, SourceDiagnosticReporter, parseApplicationSource,
+  reportSourceDiagnostic, reportSourceParseError } from './ft-transform-context';
+import { createLexicalResolver } from './ft-lexical-scope';
+import { allocateName, collectIdentifierNames } from './ft-generated-names';
+
+type TypeScriptApi = any;
+interface Injection { position: number; content: string; }
+
+const MARKER = '/* guance-web-replay-transform:instrumented */';
+const SDK_IMPORT = '@guancecloud/ft_sdk/Index';
+
+export function transformWebReplaySource(ts: TypeScriptApi, id: string, code: string, readSource?: SourceReader,
+  reportDiagnostic?: SourceDiagnosticReporter): string {
+  if (!isApplicationArkTsSource(id) || code.includes(MARKER) ||
+    !hasRuntimeDependency(ts, id, '@guancecloud/ft_sdk', readSource) ||
+    !hasRuntimeDependency(ts, id, '@guancecloud/ft_session_replay', readSource)) return code;
+
+  const source = ts.createSourceFile(id, code, ts.ScriptTarget.Latest, true, ts.ScriptKind.ETS ?? ts.ScriptKind.TS);
+  const identifiers = collectIdentifierNames(ts, source);
+  const constructors: any[] = [];
+  const unsupported: any[] = [];
+  const resolve = createLexicalResolver(ts, source);
+  let importEnd = 0;
+  const visit = (node: any): void => {
+    if (ts.isImportDeclaration(node)) importEnd = Math.max(importEnd, node.end);
+    if (ts.isCallExpression(node) && ts.isIdentifier(node.expression) && node.expression.text === 'Web' &&
+      !resolve(node.expression, 'Web')) {
+      if (node.arguments.length === 1 && !ts.isSpreadElement(node.arguments[0]) &&
+        !(ts.isOptionalChain && ts.isOptionalChain(node))) constructors.push(node);
+      else unsupported.push(node);
+    }
+    ts.forEachChild(node, visit);
+  };
+  visit(source);
+  if (constructors.length === 0 && unsupported.length === 0) return code;
+  if (reportSourceParseError(ts, parseApplicationSource(ts, id, code), reportDiagnostic)) return code;
+  unsupported.forEach(node => reportSourceDiagnostic(source, node.getStart(source), 'unsupported-web-call',
+    'Automatic ArkWeb binding requires a non-optional Web(options) call with exactly one non-spread argument.', reportDiagnostic));
+  if (constructors.length === 0) return code;
+
+  const bridge = allocateName(identifiers, '__ftWebReplayBridge');
+  const injections: Injection[] = [];
+  for (const constructor of constructors) {
+    const options = constructor.arguments[0];
+    // Keep the pair adjacent, before any app modifier expression can evaluate another Web.
+    injections.push({ position: options.getStart(source), content: `${bridge}.prepare(` });
+    injections.push({ position: options.end, content: ')' });
+    injections.push({ position: constructor.end,
+      content: `.customProperty(${bridge}.PROPERTY, ${bridge}.consumeBindingId())` });
+  }
+  injections.push({ position: importEnd,
+    content: `\n${MARKER}\nimport { FTWebViewReplayBridge as ${bridge} } from '${SDK_IMPORT}';\n` });
+  injections.sort((left, right) => right.position - left.position);
+  let result = code;
+  for (const injection of injections) {
+    result = result.slice(0, injection.position) + injection.content + result.slice(injection.position);
+  }
+  return result;
+}

package/index.js

@@ -4,11 +4,13 @@ const path = require('path');
 const { OhosPluginId } = require('@ohos/hvigor-ohos-plugin');
 
 /**
- * Returns the HAP-level Hvigor plugin used to instrument console/HiLog calls
- * and cold-launch lifecycle boundaries before ArkTS compilation.
+ * Returns the HAP-level Hvigor plugin used to instrument console/HiLog calls,
+ * cold-launch lifecycle boundaries, Session Replay page roots and Web bindings before
+ * ArkTS compilation.
  *
  * This package intentionally contains build tooling only. Applications still
- * need @guancecloud/ft_sdk at runtime to receive the instrumented log calls.
+ * need their matching runtime HARs to receive instrumented calls. The Replay
+ * transform self-disables when @guancecloud/ft_session_replay is absent.
  */
 function ftConsoleLogPlugin() {
   return {

package/package.json

@@ -1,13 +1,18 @@
 {
   "name": "@cloudcare/hvigor-ohos-plugin",
-  "version": "0.1.1",
-  "description": "Guance HarmonyOS Hvigor plugin for automatic console, HiLog, and cold-launch collection.",
+  "version": "0.1.2-alpha.2",
+  "description": "Guance HarmonyOS Hvigor plugin for console, cold-launch, Session Replay page roots, and Web controller binding.",
   "main": "index.js",
   "files": [
     "index.js",
     "hvigorCompile/ft-source-transform-host.ts",
+    "hvigorCompile/ft-transform-context.ts",
+    "hvigorCompile/ft-lexical-scope.ts",
+    "hvigorCompile/ft-generated-names.ts",
     "hvigorCompile/ft-console-log-transform.ts",
     "hvigorCompile/ft-cold-launch-transform.ts",
+    "hvigorCompile/ft-session-replay-transform.ts",
+    "hvigorCompile/ft-web-replay-transform.ts",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -27,11 +32,15 @@
     "node": ">=18"
   },
   "peerDependencies": {
-    "@guancecloud/ft_sdk": ">=0.1.17"
+    "@guancecloud/ft_sdk": ">=0.1.17",
+    "@guancecloud/ft_session_replay": ">=0.1.0-alpha01"
   },
   "peerDependenciesMeta": {
     "@guancecloud/ft_sdk": {
       "optional": true
+    },
+    "@guancecloud/ft_session_replay": {
+      "optional": true
     }
   }
 }