@open-feishu-card/adapter 0.3.18 → 0.3.20

package/dist/index.cjs

@@ -818,10 +818,12 @@ function convertEl(el, colors) {
       }
     }
     if (tag === "video") {
-      const cover = el.image_key ?? el.cover_image_key ?? el.coverImageID;
+      const nestedCover = isRecord2(el.cover) ? el.cover.img_key : void 0;
+      const cover = nestedCover ?? el.image_key ?? el.cover_image_key ?? el.coverImageID;
       if (typeof cover === "string" && cover) property.coverImageID = cover;
       delete property.image_key;
       delete property.cover_image_key;
+      delete property.cover;
     }
     return withRawElementId(el, { tag, property });
   }
@@ -1013,14 +1015,15 @@ function behaviorsToActions(behaviors) {
   for (const b of behaviors) {
     if (!isRecord2(b)) continue;
     const type = typeof b.type === "string" ? b.type : "open_url";
-    if (type === "callback") {
-      out.push({ type: "callback", action: { value: isRecord2(b.value) ? b.value : {} } });
+    if (type === "callback" || type === "action_request") {
+      const value = isRecord2(b.value) || typeof b.value === "string" ? b.value : {};
+      out.push({ type: "action_request", action: { value } });
       continue;
     }
     const action = { url: normalizeUrl(b.default_url) };
-    if (typeof b.pc_url === "string" && b.pc_url) action.pcURL = b.pc_url;
-    if (typeof b.ios_url === "string" && b.ios_url) action.iosURL = b.ios_url;
-    if (typeof b.android_url === "string" && b.android_url) action.androidURL = b.android_url;
+    if (typeof b.pc_url === "string" && b.pc_url) action.pc_url = b.pc_url;
+    if (typeof b.ios_url === "string" && b.ios_url) action.ios_url = b.ios_url;
+    if (typeof b.android_url === "string" && b.android_url) action.android_url = b.android_url;
     out.push({ type, action });
   }
   return out;
@@ -1028,10 +1031,10 @@ function behaviorsToActions(behaviors) {
 function multiUrlToOpenUrlAction(multi) {
   const url = typeof multi.url === "string" ? multi.url : typeof multi.default_url === "string" ? multi.default_url : "";
   const action = { url };
-  if (typeof multi.pc_url === "string" && multi.pc_url) action.pcURL = multi.pc_url;
-  if (typeof multi.ios_url === "string" && multi.ios_url) action.iosURL = multi.ios_url;
+  if (typeof multi.pc_url === "string" && multi.pc_url) action.pc_url = multi.pc_url;
+  if (typeof multi.ios_url === "string" && multi.ios_url) action.ios_url = multi.ios_url;
   if (typeof multi.android_url === "string" && multi.android_url) {
-    action.androidURL = multi.android_url;
+    action.android_url = multi.android_url;
   }
   return { type: "open_url", action };
 }
@@ -1343,7 +1346,7 @@ function isRawCardEnvelope(value) {
   const v = value;
   return typeof v.json_card === "string" && typeof v.card_schema === "number";
 }
-function rawCardToDsl(envelope) {
+function rawCardToDsl(envelope, options) {
   if (!isRawCardEnvelope(envelope)) return envelope;
   const env = envelope;
   let inner;
@@ -1354,7 +1357,8 @@ function rawCardToDsl(envelope) {
   }
   const ctx = makeCtx({
     images: env.json_attachment?.images ?? {},
-    atUsers: env.json_attachment?.at_users ?? {}
+    atUsers: env.json_attachment?.at_users ?? {},
+    onWarn: options?.onWarn
   });
   return convertRoot(inner, ctx);
 }
@@ -1362,7 +1366,8 @@ function makeCtx(partial) {
   return {
     images: partial?.images ?? {},
     atUsers: partial?.atUsers ?? {},
-    colors: createColorRegistry()
+    colors: createColorRegistry(),
+    onWarn: partial?.onWarn
   };
 }
 var RAW_ONLY_FIELDS = /* @__PURE__ */ new Set([
@@ -1786,6 +1791,67 @@ function openUrlFieldsToMultiUrl(fields) {
   if (fields.android_url) multi.android_url = fields.android_url;
   return multi;
 }
+var RAW_CALLBACK_TYPES = /* @__PURE__ */ new Set(["callback", "action_request"]);
+function callbackValueFromRaw(inner, ownerTag, warn) {
+  const v = inner.value;
+  if (isRecord3(v)) return v;
+  if (typeof v === "string" && v.length > 0) return v;
+  const hadObjectValue = inner.isValueObjectType === true;
+  const hasActionId = typeof inner.actionID === "string" && inner.actionID.length > 0;
+  if (hadObjectValue) {
+    warn?.({
+      code: "callback_payload_cleared",
+      ownerTag,
+      message: `\u670D\u52A1\u7AEF\u628A\u56DE\u8C03\u5BF9\u8C61\u8F7D\u8377\u6362\u6210\u4E86 actionID \u5F15\u7528${hasActionId ? ` (${String(inner.actionID)})` : ""}\uFF0C\u6295\u5F71\u51FA\u7684 behaviors.value \u662F\u7A7A\u5BF9\u8C61\uFF0C\u70B9\u51FB\u56DE\u8C03\u62FF\u4E0D\u5230\u539F\u59CB\u53C2\u6570\u3002\u4FDD\u4F4F\u53C2\u6570\u9700\u53D1\u9001\u4FA7\u7559\u5B58\u539F\u59CB DSL\u3002`
+    });
+    return {};
+  }
+  if (hasActionId) {
+    warn?.({
+      code: "callback_payload_cleared",
+      ownerTag,
+      message: `\u670D\u52A1\u7AEF\u628A\u56DE\u8C03\u8F7D\u8377\u6362\u6210\u4E86 actionID \u5F15\u7528 (${String(inner.actionID)})\uFF0C\u539F\u503C\u5DF2\u4E0D\u53EF\u89C1\uFF1B\u6295\u5F71\u51FA\u7684 behaviors.value \u4FDD\u7559\u7A7A\u5B57\u7B26\u4E32\uFF0C\u70B9\u51FB\u56DE\u8C03\u62FF\u4E0D\u5230\u539F\u59CB\u53C2\u6570\u3002`
+    });
+    return "";
+  }
+  if (v === void 0) {
+    warn?.({
+      code: "callback_payload_cleared",
+      ownerTag,
+      message: "\u56DE\u8C03 action \u6CA1\u6709 value\uFF08\u670D\u52A1\u7AEF\u56DE\u8BFB\u5F62\u6001\uFF09\uFF0C\u6295\u5F71\u4E3A behaviors.value: {}\uFF1B\u70B9\u51FB\u56DE\u8C03\u62FF\u4E0D\u5230\u539F\u59CB\u53C2\u6570\uFF0C\u9700\u53D1\u9001\u4FA7\u7559\u5B58\u539F\u59CB DSL\u3002"
+    });
+    return {};
+  }
+  return "";
+}
+function actionEntryToBehavior(entry, ownerTag, ctx, onWarn = ctx.onWarn) {
+  if (!isRecord3(entry)) return void 0;
+  const inner = isRecord3(entry.action) ? entry.action : {};
+  const type = typeof entry.type === "string" ? entry.type : void 0;
+  if (type === "open_url") {
+    const fields = projectOpenUrlFields(inner);
+    return fields ? { type: "open_url", ...fields } : void 0;
+  }
+  if (type && RAW_CALLBACK_TYPES.has(type)) {
+    return {
+      type: "callback",
+      value: callbackValueFromRaw(inner, ownerTag, onWarn ?? void 0)
+    };
+  }
+  const kept = {};
+  for (const [k, v] of Object.entries(entry)) {
+    if (k === "type" || k === "action") continue;
+    kept[snake(k)] = convertGeneric(v, ctx);
+  }
+  if (type) kept.type = type;
+  if (Object.keys(inner).length > 0) kept.action = convertGeneric(inner, ctx);
+  onWarn?.({
+    code: "unknown_action_type",
+    ownerTag,
+    message: `\u672A\u8BC6\u522B\u7684 action type: ${type ?? "(\u65E0 type)"}\uFF1B\u5DF2\u6309\u539F\u6837\u4FDD\u7559\u8FDB behaviors\uFF0C\u53D1\u5F80\u98DE\u4E66\u524D\u8BF7\u6E05\u6D17\u3002`
+  });
+  return kept;
+}
 function convertProperty(property, ownerTag, ctx) {
   const out = {};
   const siblings = {
@@ -1923,19 +1989,7 @@ function convertField(rawKey, rawValue, ownerTag, ctx, siblings = {}) {
   }
   if (ownerTag === "button" && key === "action_type") return DROP;
   if (ownerTag === "button" && key === "actions" && Array.isArray(rawValue)) {
-    const behaviors = [];
-    for (const a of rawValue) {
-      if (!isRecord3(a)) continue;
-      const inner = isRecord3(a.action) ? a.action : {};
-      const t = typeof a.type === "string" ? a.type : void 0;
-      if (t === "callback") {
-        behaviors.push({ type: "callback", value: isRecord3(inner.value) ? inner.value : {} });
-        continue;
-      }
-      if (t !== "open_url") continue;
-      const fields = projectOpenUrlFields(inner);
-      if (fields) behaviors.push({ type: "open_url", ...fields });
-    }
+    const behaviors = rawValue.map((a) => actionEntryToBehavior(a, ownerTag, ctx)).filter((b) => b !== void 0);
     if (behaviors.length === 0) return DROP;
     if (siblings.buttonActionType === "link" && behaviors.length === 1 && behaviors[0]?.type === "open_url") {
       const only = behaviors[0];
@@ -1945,29 +1999,23 @@ function convertField(rawKey, rawValue, ownerTag, ctx, siblings = {}) {
     return ["behaviors", behaviors];
   }
   if (ownerTag === "interactive_container" && key === "actions" && Array.isArray(rawValue)) {
-    const behaviors = rawValue.map((a) => {
-      if (!isRecord3(a)) return void 0;
-      const inner = isRecord3(a.action) ? a.action : {};
-      const t = typeof a.type === "string" ? a.type : void 0;
-      if (t === "open_url") {
-        const fields = projectOpenUrlFields(inner);
-        return fields ? { type: "open_url", ...fields } : void 0;
-      }
-      if (t === "callback") {
-        return { type: "callback", value: inner.value ?? {} };
-      }
-      return void 0;
-    }).filter((b) => b !== void 0);
+    const behaviors = rawValue.map((a) => actionEntryToBehavior(a, ownerTag, ctx)).filter((b) => b !== void 0);
     if (behaviors.length === 0) return DROP;
     return ["behaviors", behaviors];
   }
   if ((ownerTag === "column_set" || ownerTag === "column") && key === "actions" && Array.isArray(rawValue)) {
-    for (const a of rawValue) {
-      if (!isRecord3(a)) continue;
-      if (a.type !== "open_url") continue;
-      const inner = isRecord3(a.action) ? a.action : {};
-      const fields = projectOpenUrlFields(inner);
-      if (!fields) continue;
+    const behaviors = rawValue.map((a) => actionEntryToBehavior(a, ownerTag, ctx, null)).filter((b) => b !== void 0);
+    const openUrl = behaviors.find((b) => b.type === "open_url");
+    const unrepresentable = behaviors.filter((b) => b.type !== "open_url");
+    if (unrepresentable.length > 0) {
+      ctx.onWarn?.({
+        code: "unrepresentable_action",
+        ownerTag,
+        message: `${ownerTag} \u7684 actions \u542B ${unrepresentable.map((b) => String(b.type)).join(" / ")}\uFF0C\u516C\u5F00 DSL \u7684 ColumnAction \u53EA\u6709 multi_url\uFF0C\u65E0\u6CD5\u6295\u5F71\uFF1B\u8BE5 action \u4E0D\u4F1A\u51FA\u73B0\u5728 DSL \u91CC\u3002`
+      });
+    }
+    if (openUrl) {
+      const { type: _t, ...fields } = openUrl;
       return ["action", { multi_url: openUrlFieldsToMultiUrl(fields) }];
     }
     return DROP;
@@ -2449,11 +2497,11 @@ function pixelOf(side) {
 function snake(key) {
   return key.replace(/ID$/g, "_id").replace(/URL$/g, "_url").replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/([a-z\d])([A-Z])/g, "$1_$2").toLowerCase();
 }
-function rawToDsl(raw) {
-  if (isRawCardEnvelope(raw)) return rawCardToDsl(raw);
+function rawToDsl(raw, options) {
+  if (isRawCardEnvelope(raw)) return rawCardToDsl(raw, options);
   if (typeof raw === "string") {
     try {
-      return rawToDsl(JSON.parse(raw));
+      return rawToDsl(JSON.parse(raw), options);
     } catch {
       return raw;
     }
@@ -2471,19 +2519,20 @@ function rawToDsl(raw) {
     const attachment = isRecord3(raw.json_attachment) ? raw.json_attachment : {};
     const ctx = makeCtx({
       images: isRecord3(attachment.images) ? attachment.images : {},
-      atUsers: isRecord3(attachment.at_users) ? attachment.at_users : {}
+      atUsers: isRecord3(attachment.at_users) ? attachment.at_users : {},
+      onWarn: options?.onWarn
     });
     return convertRoot(inner, ctx);
   }
   if (isRecord3(raw.card)) {
     const card = raw.card;
     if (typeof card.json_card === "string" || isRecord3(card.json_card)) {
-      return rawToDsl(card);
+      return rawToDsl(card, options);
     }
-    return convertRoot(card, makeCtx());
+    return convertRoot(card, makeCtx({ onWarn: options?.onWarn }));
   }
   if ("body" in raw || "header" in raw || "schema" in raw) {
-    return convertRoot(raw, makeCtx());
+    return convertRoot(raw, makeCtx({ onWarn: options?.onWarn }));
   }
   return raw;
 }

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  */
 export { dslToRaw } from './dsl-to-raw.js';
 export { rawToDsl, rawCardToDsl, isRawCardEnvelope, degradeUnknown, } from './raw-to-dsl.js';
+export type { RawToDslOptions, RawToDslWarning } from './raw-to-dsl.js';
 export { normalizeStoredCardColors, createColorRegistry, registerColorEntry } from './normalize-stored-colors.js';
 export type { CustomColorEntry } from './normalize-stored-colors.js';
 export { readThemeColorLight, readThemeColorDark, resolveCustomBackgroundLight, resolveCustomBorderLight, resolveTextStyleColor, resolveTextStyleCustomColorPair, themePairToColorEntry, isCustomHexColor, } from './custom-colors.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClH,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACxE,OAAO,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAClH,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,+BAA+B,EAC/B,qBAAqB,EACrB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -816,10 +816,12 @@ function convertEl(el, colors) {
       }
     }
     if (tag === "video") {
-      const cover = el.image_key ?? el.cover_image_key ?? el.coverImageID;
+      const nestedCover = isRecord2(el.cover) ? el.cover.img_key : void 0;
+      const cover = nestedCover ?? el.image_key ?? el.cover_image_key ?? el.coverImageID;
       if (typeof cover === "string" && cover) property.coverImageID = cover;
       delete property.image_key;
       delete property.cover_image_key;
+      delete property.cover;
     }
     return withRawElementId(el, { tag, property });
   }
@@ -1011,14 +1013,15 @@ function behaviorsToActions(behaviors) {
   for (const b of behaviors) {
     if (!isRecord2(b)) continue;
     const type = typeof b.type === "string" ? b.type : "open_url";
-    if (type === "callback") {
-      out.push({ type: "callback", action: { value: isRecord2(b.value) ? b.value : {} } });
+    if (type === "callback" || type === "action_request") {
+      const value = isRecord2(b.value) || typeof b.value === "string" ? b.value : {};
+      out.push({ type: "action_request", action: { value } });
       continue;
     }
     const action = { url: normalizeUrl(b.default_url) };
-    if (typeof b.pc_url === "string" && b.pc_url) action.pcURL = b.pc_url;
-    if (typeof b.ios_url === "string" && b.ios_url) action.iosURL = b.ios_url;
-    if (typeof b.android_url === "string" && b.android_url) action.androidURL = b.android_url;
+    if (typeof b.pc_url === "string" && b.pc_url) action.pc_url = b.pc_url;
+    if (typeof b.ios_url === "string" && b.ios_url) action.ios_url = b.ios_url;
+    if (typeof b.android_url === "string" && b.android_url) action.android_url = b.android_url;
     out.push({ type, action });
   }
   return out;
@@ -1026,10 +1029,10 @@ function behaviorsToActions(behaviors) {
 function multiUrlToOpenUrlAction(multi) {
   const url = typeof multi.url === "string" ? multi.url : typeof multi.default_url === "string" ? multi.default_url : "";
   const action = { url };
-  if (typeof multi.pc_url === "string" && multi.pc_url) action.pcURL = multi.pc_url;
-  if (typeof multi.ios_url === "string" && multi.ios_url) action.iosURL = multi.ios_url;
+  if (typeof multi.pc_url === "string" && multi.pc_url) action.pc_url = multi.pc_url;
+  if (typeof multi.ios_url === "string" && multi.ios_url) action.ios_url = multi.ios_url;
   if (typeof multi.android_url === "string" && multi.android_url) {
-    action.androidURL = multi.android_url;
+    action.android_url = multi.android_url;
   }
   return { type: "open_url", action };
 }
@@ -1341,7 +1344,7 @@ function isRawCardEnvelope(value) {
   const v = value;
   return typeof v.json_card === "string" && typeof v.card_schema === "number";
 }
-function rawCardToDsl(envelope) {
+function rawCardToDsl(envelope, options) {
   if (!isRawCardEnvelope(envelope)) return envelope;
   const env = envelope;
   let inner;
@@ -1352,7 +1355,8 @@ function rawCardToDsl(envelope) {
   }
   const ctx = makeCtx({
     images: env.json_attachment?.images ?? {},
-    atUsers: env.json_attachment?.at_users ?? {}
+    atUsers: env.json_attachment?.at_users ?? {},
+    onWarn: options?.onWarn
   });
   return convertRoot(inner, ctx);
 }
@@ -1360,7 +1364,8 @@ function makeCtx(partial) {
   return {
     images: partial?.images ?? {},
     atUsers: partial?.atUsers ?? {},
-    colors: createColorRegistry()
+    colors: createColorRegistry(),
+    onWarn: partial?.onWarn
   };
 }
 var RAW_ONLY_FIELDS = /* @__PURE__ */ new Set([
@@ -1784,6 +1789,67 @@ function openUrlFieldsToMultiUrl(fields) {
   if (fields.android_url) multi.android_url = fields.android_url;
   return multi;
 }
+var RAW_CALLBACK_TYPES = /* @__PURE__ */ new Set(["callback", "action_request"]);
+function callbackValueFromRaw(inner, ownerTag, warn) {
+  const v = inner.value;
+  if (isRecord3(v)) return v;
+  if (typeof v === "string" && v.length > 0) return v;
+  const hadObjectValue = inner.isValueObjectType === true;
+  const hasActionId = typeof inner.actionID === "string" && inner.actionID.length > 0;
+  if (hadObjectValue) {
+    warn?.({
+      code: "callback_payload_cleared",
+      ownerTag,
+      message: `\u670D\u52A1\u7AEF\u628A\u56DE\u8C03\u5BF9\u8C61\u8F7D\u8377\u6362\u6210\u4E86 actionID \u5F15\u7528${hasActionId ? ` (${String(inner.actionID)})` : ""}\uFF0C\u6295\u5F71\u51FA\u7684 behaviors.value \u662F\u7A7A\u5BF9\u8C61\uFF0C\u70B9\u51FB\u56DE\u8C03\u62FF\u4E0D\u5230\u539F\u59CB\u53C2\u6570\u3002\u4FDD\u4F4F\u53C2\u6570\u9700\u53D1\u9001\u4FA7\u7559\u5B58\u539F\u59CB DSL\u3002`
+    });
+    return {};
+  }
+  if (hasActionId) {
+    warn?.({
+      code: "callback_payload_cleared",
+      ownerTag,
+      message: `\u670D\u52A1\u7AEF\u628A\u56DE\u8C03\u8F7D\u8377\u6362\u6210\u4E86 actionID \u5F15\u7528 (${String(inner.actionID)})\uFF0C\u539F\u503C\u5DF2\u4E0D\u53EF\u89C1\uFF1B\u6295\u5F71\u51FA\u7684 behaviors.value \u4FDD\u7559\u7A7A\u5B57\u7B26\u4E32\uFF0C\u70B9\u51FB\u56DE\u8C03\u62FF\u4E0D\u5230\u539F\u59CB\u53C2\u6570\u3002`
+    });
+    return "";
+  }
+  if (v === void 0) {
+    warn?.({
+      code: "callback_payload_cleared",
+      ownerTag,
+      message: "\u56DE\u8C03 action \u6CA1\u6709 value\uFF08\u670D\u52A1\u7AEF\u56DE\u8BFB\u5F62\u6001\uFF09\uFF0C\u6295\u5F71\u4E3A behaviors.value: {}\uFF1B\u70B9\u51FB\u56DE\u8C03\u62FF\u4E0D\u5230\u539F\u59CB\u53C2\u6570\uFF0C\u9700\u53D1\u9001\u4FA7\u7559\u5B58\u539F\u59CB DSL\u3002"
+    });
+    return {};
+  }
+  return "";
+}
+function actionEntryToBehavior(entry, ownerTag, ctx, onWarn = ctx.onWarn) {
+  if (!isRecord3(entry)) return void 0;
+  const inner = isRecord3(entry.action) ? entry.action : {};
+  const type = typeof entry.type === "string" ? entry.type : void 0;
+  if (type === "open_url") {
+    const fields = projectOpenUrlFields(inner);
+    return fields ? { type: "open_url", ...fields } : void 0;
+  }
+  if (type && RAW_CALLBACK_TYPES.has(type)) {
+    return {
+      type: "callback",
+      value: callbackValueFromRaw(inner, ownerTag, onWarn ?? void 0)
+    };
+  }
+  const kept = {};
+  for (const [k, v] of Object.entries(entry)) {
+    if (k === "type" || k === "action") continue;
+    kept[snake(k)] = convertGeneric(v, ctx);
+  }
+  if (type) kept.type = type;
+  if (Object.keys(inner).length > 0) kept.action = convertGeneric(inner, ctx);
+  onWarn?.({
+    code: "unknown_action_type",
+    ownerTag,
+    message: `\u672A\u8BC6\u522B\u7684 action type: ${type ?? "(\u65E0 type)"}\uFF1B\u5DF2\u6309\u539F\u6837\u4FDD\u7559\u8FDB behaviors\uFF0C\u53D1\u5F80\u98DE\u4E66\u524D\u8BF7\u6E05\u6D17\u3002`
+  });
+  return kept;
+}
 function convertProperty(property, ownerTag, ctx) {
   const out = {};
   const siblings = {
@@ -1921,19 +1987,7 @@ function convertField(rawKey, rawValue, ownerTag, ctx, siblings = {}) {
   }
   if (ownerTag === "button" && key === "action_type") return DROP;
   if (ownerTag === "button" && key === "actions" && Array.isArray(rawValue)) {
-    const behaviors = [];
-    for (const a of rawValue) {
-      if (!isRecord3(a)) continue;
-      const inner = isRecord3(a.action) ? a.action : {};
-      const t = typeof a.type === "string" ? a.type : void 0;
-      if (t === "callback") {
-        behaviors.push({ type: "callback", value: isRecord3(inner.value) ? inner.value : {} });
-        continue;
-      }
-      if (t !== "open_url") continue;
-      const fields = projectOpenUrlFields(inner);
-      if (fields) behaviors.push({ type: "open_url", ...fields });
-    }
+    const behaviors = rawValue.map((a) => actionEntryToBehavior(a, ownerTag, ctx)).filter((b) => b !== void 0);
     if (behaviors.length === 0) return DROP;
     if (siblings.buttonActionType === "link" && behaviors.length === 1 && behaviors[0]?.type === "open_url") {
       const only = behaviors[0];
@@ -1943,29 +1997,23 @@ function convertField(rawKey, rawValue, ownerTag, ctx, siblings = {}) {
     return ["behaviors", behaviors];
   }
   if (ownerTag === "interactive_container" && key === "actions" && Array.isArray(rawValue)) {
-    const behaviors = rawValue.map((a) => {
-      if (!isRecord3(a)) return void 0;
-      const inner = isRecord3(a.action) ? a.action : {};
-      const t = typeof a.type === "string" ? a.type : void 0;
-      if (t === "open_url") {
-        const fields = projectOpenUrlFields(inner);
-        return fields ? { type: "open_url", ...fields } : void 0;
-      }
-      if (t === "callback") {
-        return { type: "callback", value: inner.value ?? {} };
-      }
-      return void 0;
-    }).filter((b) => b !== void 0);
+    const behaviors = rawValue.map((a) => actionEntryToBehavior(a, ownerTag, ctx)).filter((b) => b !== void 0);
     if (behaviors.length === 0) return DROP;
     return ["behaviors", behaviors];
   }
   if ((ownerTag === "column_set" || ownerTag === "column") && key === "actions" && Array.isArray(rawValue)) {
-    for (const a of rawValue) {
-      if (!isRecord3(a)) continue;
-      if (a.type !== "open_url") continue;
-      const inner = isRecord3(a.action) ? a.action : {};
-      const fields = projectOpenUrlFields(inner);
-      if (!fields) continue;
+    const behaviors = rawValue.map((a) => actionEntryToBehavior(a, ownerTag, ctx, null)).filter((b) => b !== void 0);
+    const openUrl = behaviors.find((b) => b.type === "open_url");
+    const unrepresentable = behaviors.filter((b) => b.type !== "open_url");
+    if (unrepresentable.length > 0) {
+      ctx.onWarn?.({
+        code: "unrepresentable_action",
+        ownerTag,
+        message: `${ownerTag} \u7684 actions \u542B ${unrepresentable.map((b) => String(b.type)).join(" / ")}\uFF0C\u516C\u5F00 DSL \u7684 ColumnAction \u53EA\u6709 multi_url\uFF0C\u65E0\u6CD5\u6295\u5F71\uFF1B\u8BE5 action \u4E0D\u4F1A\u51FA\u73B0\u5728 DSL \u91CC\u3002`
+      });
+    }
+    if (openUrl) {
+      const { type: _t, ...fields } = openUrl;
       return ["action", { multi_url: openUrlFieldsToMultiUrl(fields) }];
     }
     return DROP;
@@ -2447,11 +2495,11 @@ function pixelOf(side) {
 function snake(key) {
   return key.replace(/ID$/g, "_id").replace(/URL$/g, "_url").replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/([a-z\d])([A-Z])/g, "$1_$2").toLowerCase();
 }
-function rawToDsl(raw) {
-  if (isRawCardEnvelope(raw)) return rawCardToDsl(raw);
+function rawToDsl(raw, options) {
+  if (isRawCardEnvelope(raw)) return rawCardToDsl(raw, options);
   if (typeof raw === "string") {
     try {
-      return rawToDsl(JSON.parse(raw));
+      return rawToDsl(JSON.parse(raw), options);
     } catch {
       return raw;
     }
@@ -2469,19 +2517,20 @@ function rawToDsl(raw) {
     const attachment = isRecord3(raw.json_attachment) ? raw.json_attachment : {};
     const ctx = makeCtx({
       images: isRecord3(attachment.images) ? attachment.images : {},
-      atUsers: isRecord3(attachment.at_users) ? attachment.at_users : {}
+      atUsers: isRecord3(attachment.at_users) ? attachment.at_users : {},
+      onWarn: options?.onWarn
     });
     return convertRoot(inner, ctx);
   }
   if (isRecord3(raw.card)) {
     const card = raw.card;
     if (typeof card.json_card === "string" || isRecord3(card.json_card)) {
-      return rawToDsl(card);
+      return rawToDsl(card, options);
     }
-    return convertRoot(card, makeCtx());
+    return convertRoot(card, makeCtx({ onWarn: options?.onWarn }));
   }
   if ("body" in raw || "header" in raw || "schema" in raw) {
-    return convertRoot(raw, makeCtx());
+    return convertRoot(raw, makeCtx({ onWarn: options?.onWarn }));
   }
   return raw;
 }

package/dist/raw-to-dsl.d.ts

@@ -45,14 +45,31 @@
  * downstream sees an unknown field rather than silently losing data.
  */
 export declare function isRawCardEnvelope(value: unknown): boolean;
-export declare function rawCardToDsl(envelope: unknown): unknown;
+export declare function rawCardToDsl(envelope: unknown, options?: RawToDslOptions): unknown;
+/** rawToDsl 的诊断级别。默认静默：只有传了 onWarn 才会回调。 */
+export interface RawToDslWarning {
+    /**
+     * unknown_action_type: action.type 不认识（已原样保留进 behaviors）
+     * callback_payload_cleared: 服务端把回调载荷换成了 actionID / 清空
+     * unrepresentable_action: 该宿主（column_set / column）的公开 schema 没有可放 action 的字段
+     */
+    code: "unknown_action_type" | "callback_payload_cleared" | "unrepresentable_action";
+    /** 可读诊断，中文 */
+    message: string;
+    /** 持有 actions 的元素 tag：button / interactive_container / column_set / column */
+    ownerTag?: string;
+}
+/** 诊断通道；不传则完全不打扰调用方。 */
+export interface RawToDslOptions {
+    onWarn?: (warning: RawToDslWarning) => void;
+}
 /**
  * Flexible entry used by this monorepo:
  * - raw envelope (`json_card` + `card_schema`) → same as `rawCardToDsl`
  * - already-parsed `{ json_card: object, json_attachment? }`
  * - `{ card: ... }` / bare card (e.g. output of `dslToRaw`) → `convertRoot`
  */
-export declare function rawToDsl(raw: unknown): unknown;
+export declare function rawToDsl(raw: unknown, options?: RawToDslOptions): unknown;
 /**
  * Optional helper: wrap a private/unknown element as
  * `{ tag: 'unknown', raw_tag, fallback }`.

package/dist/raw-to-dsl.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"raw-to-dsl.d.ts","sourceRoot":"","sources":["../src/raw-to-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAwBH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CAcvD;AA2vDD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CA8C9C;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnF"}
+{"version":3,"file":"raw-to-dsl.d.ts","sourceRoot":"","sources":["../src/raw-to-dsl.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAwBH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAIzD;AAED,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,OAAO,EACjB,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAeT;AAED,4CAA4C;AAC5C,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,IAAI,EAAE,qBAAqB,GAAG,0BAA0B,GAAG,wBAAwB,CAAC;IACpF,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAwB;AACxB,MAAM,WAAW,eAAe;IAC9B,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,IAAI,CAAC;CAC7C;AA+2DD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CA+CzE;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAGnF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-feishu-card/adapter",
-  "version": "0.3.18",
+  "version": "0.3.20",
   "description": "公开 DSL 与飞书内部 RAW JSON 的双向适配器；raw→DSL 对齐 feishu-raw-card-to-dsl",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -22,7 +22,7 @@
     "tsx": "^4.19.3",
     "typescript": "^7.0.2",
     "vitest": "^2.1.9",
-    "@open-feishu-card/schema": "0.1.7"
+    "@open-feishu-card/schema": "0.1.10"
   },
   "license": "MIT",
   "publishConfig": {