@lark-apaas/coding-html-devserver 0.1.2 → 0.1.3-alpha.0

package/lib/transform/index.d.ts

@@ -7,6 +7,7 @@ import { type OgMetaOptions } from './og-meta';
  * （纯拷贝步骤）共用本模块。各功能域拆分在同级文件：
  *   - view-context.ts：window 上下文（HBS 占位符 / 请求真值）
  *   - slardar.ts：Slardar + Performance + Tea 监控埋点
+ *   - runtime.ts：miaoda-coding-sdk runtime（TEA 页面浏览埋点；豆包来源带水印）
  *   - preview-bridge.ts：妙搭预览桥（**仅 dev**）
  *   - og-meta.ts：title / og / description / favicon 原地改写
  *
@@ -28,10 +29,10 @@ export interface InjectPlatformOptions {
     ogMeta?: OgMetaOptions;
 }
 /**
- * 对一份 HTML 注入全部平台能力（view-context + slardar + 额外清单 + og-meta）。
+ * 对一份 HTML 注入全部平台能力（view-context + slardar + runtime + 额外清单 + og-meta）。
  * dev 插件与 build 步骤共用，唯一真相。默认 build 模式（emit HBS 占位符）。
  *
  * head-prepend 顺序（injectTags 按数组序 = 文档序）：view-context 在最前，slardar 其后，
- * 保证 slardar 读 window.tenantId 时已就绪。预览桥仅 dev 注入。
+ * runtime 再其后——保证 runtime 读 window.appId / collectEvent 时已就绪。预览桥仅 dev 注入。
  */
 export declare function injectPlatformTags(html: string, opts?: InjectPlatformOptions): string;

package/lib/transform/index.js

@@ -5,6 +5,7 @@ exports.injectPlatformTags = injectPlatformTags;
 const html_tags_1 = require("../html-tags");
 const view_context_1 = require("./view-context");
 const slardar_1 = require("./slardar");
+const runtime_1 = require("./runtime");
 const preview_bridge_1 = require("./preview-bridge");
 const og_meta_1 = require("./og-meta");
 /**
@@ -12,6 +13,7 @@ const og_meta_1 = require("./og-meta");
  * （纯拷贝步骤）共用本模块。各功能域拆分在同级文件：
  *   - view-context.ts：window 上下文（HBS 占位符 / 请求真值）
  *   - slardar.ts：Slardar + Performance + Tea 监控埋点
+ *   - runtime.ts：miaoda-coding-sdk runtime（TEA 页面浏览埋点；豆包来源带水印）
  *   - preview-bridge.ts：妙搭预览桥（**仅 dev**）
  *   - og-meta.ts：title / og / description / favicon 原地改写
  *
@@ -23,17 +25,19 @@ const og_meta_1 = require("./og-meta");
  */
 exports.PLATFORM_TAGS = [];
 /**
- * 对一份 HTML 注入全部平台能力（view-context + slardar + 额外清单 + og-meta）。
+ * 对一份 HTML 注入全部平台能力（view-context + slardar + runtime + 额外清单 + og-meta）。
  * dev 插件与 build 步骤共用，唯一真相。默认 build 模式（emit HBS 占位符）。
  *
  * head-prepend 顺序（injectTags 按数组序 = 文档序）：view-context 在最前，slardar 其后，
- * 保证 slardar 读 window.tenantId 时已就绪。预览桥仅 dev 注入。
+ * runtime 再其后——保证 runtime 读 window.appId / collectEvent 时已就绪。预览桥仅 dev 注入。
  */
 function injectPlatformTags(html, opts = {}) {
     const mode = opts.mode ?? 'build';
     const tags = [
         (0, view_context_1.viewContextTag)(mode, { appId: opts.appId }, opts.viewCtx),
         ...(0, slardar_1.slardarTags)(opts.slardar),
+        // miaoda-coding-sdk runtime：依赖 collectEvent(slardar) + appId(view-context)，故排其后
+        ...(0, runtime_1.runtimeTags)(mode),
         // 预览桥仅开发环境注入，build 产物不带（线上不经预览外壳）
         ...(mode === 'dev' ? (0, preview_bridge_1.previewBridgeTags)() : []),
         ...exports.PLATFORM_TAGS,

package/lib/transform/runtime.d.ts

@@ -0,0 +1,3 @@
+import type { HtmlTagDescriptor } from '../html-tags';
+/** miaoda-coding-sdk runtime 的 head-prepend script tag（dev → .dev.js / build → .min.js）。 */
+export declare function runtimeTags(mode: 'build' | 'dev'): HtmlTagDescriptor[];

package/lib/transform/runtime.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runtimeTags = runtimeTags;
+/**
+ * 注入 `@lark-apaas/miaoda-coding-sdk` 的 runtime 产物（TEA 页面浏览埋点；豆包来源额外带水印）。
+ *
+ * - **入口**按 `process.env.MIAODA_APP_SOURCE` 选：`'5'`（豆包来源）→ `doubao-runtime`，否则 `runtime`。
+ * - **变体**按 mode 选：dev → `.dev.js`（不自动上报、可调试）；build → `.min.js`（引入即自动上报 VIEW）。
+ * - 走 sf3-scmcdn，版本即 URL（精确 pin、不可变）。
+ *
+ * 依赖 `window.collectEvent`（slardar 注入的 Tea collector）与 `window.appId`（view-context），
+ * 故须排在二者之后注入。
+ */
+/** miaoda-coding-sdk 的 CDN 版本（发布后随版本回填）。 */
+const CODING_SDK_VERSION = '0.0.1';
+/** sf3 SCM CDN 基址。 */
+const CDN_BASE = 'https://sf3-scmcdn-cn.feishucdn.com/obj/feishu-static/miaoda/coding-sdk';
+/** 豆包来源值（对齐 app_meta.source / AppSource_Doubao）。 */
+const DOUBAO_SOURCE = '5';
+/** miaoda-coding-sdk runtime 的 head-prepend script tag（dev → .dev.js / build → .min.js）。 */
+function runtimeTags(mode) {
+    const entry = process.env.MIAODA_APP_SOURCE === DOUBAO_SOURCE ? 'doubao-runtime' : 'runtime';
+    const variant = mode === 'dev' ? 'dev' : 'min';
+    const src = `${CDN_BASE}/${CODING_SDK_VERSION}/${entry}.${variant}.js`;
+    return [
+        {
+            tag: 'script',
+            attrs: { src, crossorigin: 'anonymous', defer: true },
+            injectTo: 'head-prepend',
+        },
+    ];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/coding-html-devserver",
-  "version": "0.1.2",
+  "version": "0.1.3-alpha.0",
   "description": "Dev/build toolchain for the miaoda-coding html (pure HTML) stack. Wraps vite (dev + HMR) behind a bin so the template never sees vite; build is pure-copy + platform-script injection + optional minify.",
   "main": "./lib/index.js",
   "types": "./lib/index.d.ts",