dsh-d365-kit 0.34.1 → 0.34.4

package/lib/preflight.js

@@ -1,116 +1,116 @@
-/**
- * Is the target environment in the middle of a solution import or publish?
- *
- * Microsoft ships first-party updates as solution imports, and while one is
- * running Dataverse holds the customization lock: our metadata writes either
- * fail with 0x80071151 ("another operation is in progress") or hang until the
- * HTTP client gives up. `msdyn_solutionhistories` records every import,
- * uninstall, export and publish with a start time; a row whose `msdyn_endtime`
- * is still null means that operation has not finished.
- */
-import { D365Error } from './errors.js'
-
-/** Operations older than this are treated as zombie rows, not as active work. */
-export const DEFAULT_BUSY_WINDOW_MINUTES = 120
-
-const OPERATION_LABELS = {
-  0: '导入',
-  1: '卸载',
-  2: '导出',
-  3: '发布',
-  7: '元数据生成',
-}
-
-const SELECT_FIELDS = 'msdyn_name,msdyn_starttime,msdyn_operation,msdyn_ismanaged,msdyn_publishername'
-
-export function describeBlocker(blocker) {
-  const parts = [blocker.name]
-  parts.push(blocker.operation)
-  if (blocker.ageMinutes !== null) parts.push(`${blocker.ageMinutes} 分钟前开始`)
-  if (blocker.publisher) parts.push(`发行者 ${blocker.publisher}`)
-  return `${parts[0]}（${parts.slice(1).join('，')}）`
-}
-
-/**
- * @returns {Promise<{
- *   available: boolean, checkedAt: string, windowMinutes: number, reason?: string,
- *   blockers: object[], active: object[], stale: object[], busy: boolean,
- * }>}
- */
-export async function checkEnvironmentIdle(client, { windowMinutes = DEFAULT_BUSY_WINDOW_MINUTES, signal } = {}) {
-  const checkedAt = new Date().toISOString()
-  const url = client.buildUrl('msdyn_solutionhistories', {
-    $select: SELECT_FIELDS,
-    $filter: 'msdyn_endtime eq null',
-    $orderby: 'msdyn_starttime desc',
-    $top: 25,
-  })
-
-  let rows
-  try {
-    const page = await client.requestJson(url, { signal })
-    rows = Array.isArray(page?.value) ? page.value : []
-  } catch (error) {
-    // No privilege on the table, or the environment does not expose it: the
-    // check is a safety net, not a gate we can enforce without data.
-    return {
-      available: false,
-      reason: error instanceof Error ? error.message : String(error),
-      checkedAt,
-      windowMinutes,
-      blockers: [],
-      active: [],
-      stale: [],
-      busy: false,
-    }
-  }
-
-  const now = Date.now()
-  const blockers = rows.map((row) => {
-    const startedAt = row.msdyn_starttime ?? null
-    const started = startedAt ? Date.parse(startedAt) : Number.NaN
-    return {
-      name: row.msdyn_name ?? '(未命名)',
-      operation: OPERATION_LABELS[row.msdyn_operation] ?? `操作 ${row.msdyn_operation}`,
-      managed: row.msdyn_ismanaged === true,
-      publisher: row.msdyn_publishername ?? '',
-      startedAt,
-      ageMinutes: Number.isFinite(started) ? Math.max(0, Math.round((now - started) / 60000)) : null,
-    }
-  })
-
-  const active = blockers.filter((blocker) => blocker.ageMinutes !== null && blocker.ageMinutes <= windowMinutes)
-  const stale = blockers.filter((blocker) => !active.includes(blocker))
-
-  return {
-    available: true,
-    checkedAt,
-    windowMinutes,
-    blockers,
-    active,
-    stale,
-    busy: active.length > 0,
-  }
-}
-
-export function busyError(envKey, state) {
-  // One solution import shows up as many rows (per patch step), and a publish
-  // shows up repeatedly: collapse to one line per name, newest first.
-  const seen = new Map()
-  for (const blocker of state.active) {
-    const previous = seen.get(blocker.name)
-    if (!previous || (blocker.ageMinutes ?? Infinity) < (previous.ageMinutes ?? Infinity)) {
-      seen.set(blocker.name, blocker)
-    }
-  }
-  const collapsed = [...seen.values()].sort((a, b) => (a.ageMinutes ?? 0) - (b.ageMinutes ?? 0))
-  const shown = collapsed.slice(0, 4).map(describeBlocker).join('；')
-  const more = collapsed.length > 4 ? `；等 ${collapsed.length} 个操作` : ''
-  const staleNote = state.stale.length
-    ? ` 另有 ${state.stale.length} 条超过 ${state.windowMinutes} 分钟仍未结束的旧记录，可能是残留。`
-    : ''
-  return new D365Error(`环境 ${envKey} 正在导入或发布解决方案，此时写入会失败或长时间卡住`, {
-    code: 'environment-busy',
-    hint: `进行中：${shown}${more}。${staleNote} 等它结束后重试；确认要跳过检查可以传 force: true。`,
-  })
-}
+/**
+ * Is the target environment in the middle of a solution import or publish?
+ *
+ * Microsoft ships first-party updates as solution imports, and while one is
+ * running Dataverse holds the customization lock: our metadata writes either
+ * fail with 0x80071151 ("another operation is in progress") or hang until the
+ * HTTP client gives up. `msdyn_solutionhistories` records every import,
+ * uninstall, export and publish with a start time; a row whose `msdyn_endtime`
+ * is still null means that operation has not finished.
+ */
+import { D365Error } from './errors.js'
+
+/** Operations older than this are treated as zombie rows, not as active work. */
+export const DEFAULT_BUSY_WINDOW_MINUTES = 120
+
+const OPERATION_LABELS = {
+  0: '导入',
+  1: '卸载',
+  2: '导出',
+  3: '发布',
+  7: '元数据生成',
+}
+
+const SELECT_FIELDS = 'msdyn_name,msdyn_starttime,msdyn_operation,msdyn_ismanaged,msdyn_publishername'
+
+export function describeBlocker(blocker) {
+  const parts = [blocker.name]
+  parts.push(blocker.operation)
+  if (blocker.ageMinutes !== null) parts.push(`${blocker.ageMinutes} 分钟前开始`)
+  if (blocker.publisher) parts.push(`发行者 ${blocker.publisher}`)
+  return `${parts[0]}（${parts.slice(1).join('，')}）`
+}
+
+/**
+ * @returns {Promise<{
+ *   available: boolean, checkedAt: string, windowMinutes: number, reason?: string,
+ *   blockers: object[], active: object[], stale: object[], busy: boolean,
+ * }>}
+ */
+export async function checkEnvironmentIdle(client, { windowMinutes = DEFAULT_BUSY_WINDOW_MINUTES, signal } = {}) {
+  const checkedAt = new Date().toISOString()
+  const url = client.buildUrl('msdyn_solutionhistories', {
+    $select: SELECT_FIELDS,
+    $filter: 'msdyn_endtime eq null',
+    $orderby: 'msdyn_starttime desc',
+    $top: 25,
+  })
+
+  let rows
+  try {
+    const page = await client.requestJson(url, { signal })
+    rows = Array.isArray(page?.value) ? page.value : []
+  } catch (error) {
+    // No privilege on the table, or the environment does not expose it: the
+    // check is a safety net, not a gate we can enforce without data.
+    return {
+      available: false,
+      reason: error instanceof Error ? error.message : String(error),
+      checkedAt,
+      windowMinutes,
+      blockers: [],
+      active: [],
+      stale: [],
+      busy: false,
+    }
+  }
+
+  const now = Date.now()
+  const blockers = rows.map((row) => {
+    const startedAt = row.msdyn_starttime ?? null
+    const started = startedAt ? Date.parse(startedAt) : Number.NaN
+    return {
+      name: row.msdyn_name ?? '(未命名)',
+      operation: OPERATION_LABELS[row.msdyn_operation] ?? `操作 ${row.msdyn_operation}`,
+      managed: row.msdyn_ismanaged === true,
+      publisher: row.msdyn_publishername ?? '',
+      startedAt,
+      ageMinutes: Number.isFinite(started) ? Math.max(0, Math.round((now - started) / 60000)) : null,
+    }
+  })
+
+  const active = blockers.filter((blocker) => blocker.ageMinutes !== null && blocker.ageMinutes <= windowMinutes)
+  const stale = blockers.filter((blocker) => !active.includes(blocker))
+
+  return {
+    available: true,
+    checkedAt,
+    windowMinutes,
+    blockers,
+    active,
+    stale,
+    busy: active.length > 0,
+  }
+}
+
+export function busyError(envKey, state) {
+  // One solution import shows up as many rows (per patch step), and a publish
+  // shows up repeatedly: collapse to one line per name, newest first.
+  const seen = new Map()
+  for (const blocker of state.active) {
+    const previous = seen.get(blocker.name)
+    if (!previous || (blocker.ageMinutes ?? Infinity) < (previous.ageMinutes ?? Infinity)) {
+      seen.set(blocker.name, blocker)
+    }
+  }
+  const collapsed = [...seen.values()].sort((a, b) => (a.ageMinutes ?? 0) - (b.ageMinutes ?? 0))
+  const shown = collapsed.slice(0, 4).map(describeBlocker).join('；')
+  const more = collapsed.length > 4 ? `；等 ${collapsed.length} 个操作` : ''
+  const staleNote = state.stale.length
+    ? ` 另有 ${state.stale.length} 条超过 ${state.windowMinutes} 分钟仍未结束的旧记录，可能是残留。`
+    : ''
+  return new D365Error(`环境 ${envKey} 正在导入或发布解决方案，此时写入会失败或长时间卡住`, {
+    code: 'environment-busy',
+    hint: `进行中：${shown}${more}。${staleNote} 等它结束后重试；确认要跳过检查可以传 force: true。`,
+  })
+}

package/lib/refs.js

@@ -1,191 +1,191 @@
-/**
- * Reverse index: who references this thing?
- *
- * Metadata tells you what exists; it does not tell you what would break if you
- * remove or rename it. The references live in text blobs that Dataverse stores
- * alongside the definitions — formxml, layoutxml/fetchxml, workflow xaml — so
- * this module reads those blobs and asks "does the exact reference appear?".
- *
- * Only exact, quoted matches count. A substring search for `name` would match
- * `fullname`, so every pattern ends at a quote or a tag boundary.
- */
-import { D365Error } from './errors.js'
-import { odataString } from './resources.js'
-
-/** Form types, for labelling what a form is. */
-const FORM_TYPES = { 2: '主表单', 5: '快速查看', 6: '快速创建', 7: '卡片' }
-
-/** Workflow categories. */
-const WORKFLOW_CATEGORIES = { 0: '工作流', 1: '对话', 2: '业务规则', 3: '动作', 4: '业务流程', 5: '现代流', 6: '桌面流' }
-
-/** Query a collection, tolerating servers that reject `$select` on the path. */
-export async function readAll(client, path, params, limit, signal) {
-  const page = await client.getPaged(path, params, limit, signal)
-  return page.records ?? []
-}
-
-/**
- * Find forms that touch a field.
- * @param entity - entity logical name.
- * @param attribute - attribute logical name.
- * @returns forms with the attribute on them.
- */
-export async function findFieldForms(client, entity, attribute, signal) {
-  const needle = `datafieldname="${attribute}"`
-  const filter = `objecttypecode eq '${entity}' and contains(formxml,'${odataString(needle)}')`
-  const rows = await readAll(client, 'systemforms', {
-    $select: 'name,type,objecttypecode,formxml,ismanaged',
-    $filter: filter,
-  }, 200, signal)
-  return rows.map((row) => {
-    // Each control carries its own `visible` attribute, so the control tag — not
-    // the whole form — is the unit that decides whether the field shows.
-    const controls = String(row.formxml ?? '').match(/<control\b[^>]*>/gi) ?? []
-    const own = controls.filter((tag) => tag.includes(`datafieldname="${attribute}"`))
-    return {
-      name: row.name,
-      type: row.type,
-      typeLabel: FORM_TYPES[row.type] ?? `类型 ${row.type}`,
-      managed: row.ismanaged,
-      visible: own.some((tag) => !/\bvisible="false"/i.test(tag)),
-    }
-  })
-}
-
-/**
- * Find views whose layout or filter mentions a field.
- * @returns views that would break (layout) or change behaviour (filter).
- */
-export async function findFieldViews(client, entity, attribute, signal) {
-  const inLayout = `contains(layoutxml,'${odataString(`name="${attribute}"`)}')`
-  const inFilter = `contains(fetchxml,'${odataString(`attribute="${attribute}"`)}')`
-  const rows = await readAll(client, 'savedqueries', {
-    $select: 'name,querytype,returnedtypecode,isdefault,layoutxml,fetchxml',
-    $filter: `returnedtypecode eq '${entity}' and (${inLayout} or ${inFilter})`,
-  }, 500, signal)
-  return rows.map((row) => ({
-    name: row.name,
-    queryType: row.querytype,
-    default: row.isdefault,
-    inLayout: String(row.layoutxml ?? '').includes(`name="${attribute}"`),
-    inFilter: String(row.fetchxml ?? '').includes(`attribute="${attribute}"`),
-  }))
-}
-
-/**
- * Find workflows and business rules whose definition mentions a field.
- *
- * The definition lives in `clientdata` (a large string). Asking the server to
- * filter on it is not portable, so this pulls the entity's automations and
- * scans locally; that is bounded by the number of automations on one entity.
- * @returns automations that mention the field.
- */
-export async function findFieldAutomations(client, entity, attribute, signal) {
-  const rows = await readAll(client, 'workflows', {
-    $select: 'name,category,statecode,primaryentity,clientdata',
-    $filter: `primaryentity eq '${entity}'`,
-  }, 1000, signal)
-  const quoted = `["']${attribute}["']`
-  const patterns = [
-    new RegExp(`<AttributeName>${attribute}</AttributeName>`, 'i'),
-    new RegExp(`"attributeName"\\s*:\\s*"${attribute}"`, 'i'),
-    new RegExp(`getAttribute\\(\\s*${quoted}`, 'i'),
-    // Business rules compile to `formContext.data.entity.attributes.get('x')`.
-    new RegExp(`attributes\\.get\\(\\s*${quoted}`, 'i'),
-    new RegExp(`attributes\\[\\s*${quoted}\\s*\\]`, 'i'),
-  ]
-  return rows
-    .filter((row) => patterns.some((pattern) => pattern.test(String(row.clientdata ?? ''))))
-    .map((row) => ({
-      name: row.name,
-      category: WORKFLOW_CATEGORIES[row.category] ?? `类别 ${row.category}`,
-      state: row.statecode === 1 ? '已启用' : '草稿/停用',
-    }))
-}
-
-/**
- * Find forms whose scripts reference a web resource.
- * @param resourceName - web resource name as written in formxml `libraryName`.
- */
-export async function findResourceForms(client, resourceName, signal) {
-  const rows = await readAll(client, 'systemforms', {
-    $select: 'name,type,objecttypecode,formxml',
-    $filter: `contains(formxml,'${odataString(`libraryName="${resourceName}"`)}')`,
-  }, 500, signal)
-  return rows.map((row) => {
-    // The event name lives on the enclosing <event> node; the <Handler> only
-    // names the function. Pair them so the report says "onload → fn" instead of
-    // "? → fn".
-    const handlers = []
-    for (const block of String(row.formxml ?? '').matchAll(/<event\b[^>]*>([\s\S]*?)<\/event>/gi)) {
-      const eventTag = block[0].slice(0, block[0].indexOf('>') + 1)
-      const eventName = /\bname="([^"]*)"/i.exec(eventTag)?.[1] ?? ''
-      for (const match of block[1].matchAll(/<Handler\b[^>]*>/gi)) {
-        const tag = match[0]
-        if (!tag.includes(`libraryName="${resourceName}"`)) continue
-        const fn = /functionName="([^"]*)"/i.exec(tag)
-        handlers.push({ functionName: fn?.[1] ?? '', event: eventName })
-      }
-    }
-    return {
-      name: row.name,
-      type: row.type,
-      typeLabel: FORM_TYPES[row.type] ?? `类型 ${row.type}`,
-      entity: row.objecttypecode,
-      handlers,
-    }
-  })
-}
-
-/**
- * Resolve a plugin assembly name to its types and message steps.
- * @returns `{ assembly, types: [{ typename, steps: [...] }] }`
- */
-export async function findPluginUsage(client, assemblyName, signal) {
-  const assemblies = await readAll(client, 'pluginassemblies', {
-    $select: 'pluginassemblyid,name,version,isolationmode,sourcetype',
-    $filter: `name eq '${odataString(assemblyName)}'`,
-  }, 5, signal)
-  const assembly = assemblies[0]
-  if (!assembly) {
-    throw new D365Error(`没有找到插件程序集：${assemblyName}`, {
-      code: 'unknown-assembly',
-      hint: '先用 d365_metadata resource=plugin_assemblies 看名字（通常是程序集名，不带 .dll）。',
-    })
-  }
-
-  const types = await readAll(client, 'plugintypes', {
-    $select: 'plugintypeid,typename,friendlyname,_pluginassemblyid_value',
-    $filter: `_pluginassemblyid_value eq ${assembly.pluginassemblyid}`,
-  }, 200, signal)
-
-  const detail = []
-  for (const type of types) {
-    const steps = await readAll(client, 'sdkmessageprocessingsteps', {
-      $select: 'name,stage,mode,rank,filteringattributes,statecode,configuration',
-      $filter: `_eventhandler_value eq ${type.plugintypeid}`,
-    }, 100, signal)
-    detail.push({
-      typename: type.typename,
-      friendlyName: type.friendlyname,
-      steps: steps.map((step) => ({
-        name: step.name,
-        stage: step.stage,
-        mode: step.mode,
-        rank: step.rank,
-        filteringAttributes: step.filteringattributes,
-        enabled: step.statecode === 0,
-      })),
-    })
-  }
-
-  return {
-    assembly: {
-      name: assembly.name,
-      version: assembly.version,
-      isolation: assembly.isolationmode,
-      source: assembly.sourcetype,
-    },
-    types: detail,
-  }
-}
+/**
+ * Reverse index: who references this thing?
+ *
+ * Metadata tells you what exists; it does not tell you what would break if you
+ * remove or rename it. The references live in text blobs that Dataverse stores
+ * alongside the definitions — formxml, layoutxml/fetchxml, workflow xaml — so
+ * this module reads those blobs and asks "does the exact reference appear?".
+ *
+ * Only exact, quoted matches count. A substring search for `name` would match
+ * `fullname`, so every pattern ends at a quote or a tag boundary.
+ */
+import { D365Error } from './errors.js'
+import { odataString } from './resources.js'
+
+/** Form types, for labelling what a form is. */
+const FORM_TYPES = { 2: '主表单', 5: '快速查看', 6: '快速创建', 7: '卡片' }
+
+/** Workflow categories. */
+const WORKFLOW_CATEGORIES = { 0: '工作流', 1: '对话', 2: '业务规则', 3: '动作', 4: '业务流程', 5: '现代流', 6: '桌面流' }
+
+/** Query a collection, tolerating servers that reject `$select` on the path. */
+export async function readAll(client, path, params, limit, signal) {
+  const page = await client.getPaged(path, params, limit, signal)
+  return page.records ?? []
+}
+
+/**
+ * Find forms that touch a field.
+ * @param entity - entity logical name.
+ * @param attribute - attribute logical name.
+ * @returns forms with the attribute on them.
+ */
+export async function findFieldForms(client, entity, attribute, signal) {
+  const needle = `datafieldname="${attribute}"`
+  const filter = `objecttypecode eq '${entity}' and contains(formxml,'${odataString(needle)}')`
+  const rows = await readAll(client, 'systemforms', {
+    $select: 'name,type,objecttypecode,formxml,ismanaged',
+    $filter: filter,
+  }, 200, signal)
+  return rows.map((row) => {
+    // Each control carries its own `visible` attribute, so the control tag — not
+    // the whole form — is the unit that decides whether the field shows.
+    const controls = String(row.formxml ?? '').match(/<control\b[^>]*>/gi) ?? []
+    const own = controls.filter((tag) => tag.includes(`datafieldname="${attribute}"`))
+    return {
+      name: row.name,
+      type: row.type,
+      typeLabel: FORM_TYPES[row.type] ?? `类型 ${row.type}`,
+      managed: row.ismanaged,
+      visible: own.some((tag) => !/\bvisible="false"/i.test(tag)),
+    }
+  })
+}
+
+/**
+ * Find views whose layout or filter mentions a field.
+ * @returns views that would break (layout) or change behaviour (filter).
+ */
+export async function findFieldViews(client, entity, attribute, signal) {
+  const inLayout = `contains(layoutxml,'${odataString(`name="${attribute}"`)}')`
+  const inFilter = `contains(fetchxml,'${odataString(`attribute="${attribute}"`)}')`
+  const rows = await readAll(client, 'savedqueries', {
+    $select: 'name,querytype,returnedtypecode,isdefault,layoutxml,fetchxml',
+    $filter: `returnedtypecode eq '${entity}' and (${inLayout} or ${inFilter})`,
+  }, 500, signal)
+  return rows.map((row) => ({
+    name: row.name,
+    queryType: row.querytype,
+    default: row.isdefault,
+    inLayout: String(row.layoutxml ?? '').includes(`name="${attribute}"`),
+    inFilter: String(row.fetchxml ?? '').includes(`attribute="${attribute}"`),
+  }))
+}
+
+/**
+ * Find workflows and business rules whose definition mentions a field.
+ *
+ * The definition lives in `clientdata` (a large string). Asking the server to
+ * filter on it is not portable, so this pulls the entity's automations and
+ * scans locally; that is bounded by the number of automations on one entity.
+ * @returns automations that mention the field.
+ */
+export async function findFieldAutomations(client, entity, attribute, signal) {
+  const rows = await readAll(client, 'workflows', {
+    $select: 'name,category,statecode,primaryentity,clientdata',
+    $filter: `primaryentity eq '${entity}'`,
+  }, 1000, signal)
+  const quoted = `["']${attribute}["']`
+  const patterns = [
+    new RegExp(`<AttributeName>${attribute}</AttributeName>`, 'i'),
+    new RegExp(`"attributeName"\\s*:\\s*"${attribute}"`, 'i'),
+    new RegExp(`getAttribute\\(\\s*${quoted}`, 'i'),
+    // Business rules compile to `formContext.data.entity.attributes.get('x')`.
+    new RegExp(`attributes\\.get\\(\\s*${quoted}`, 'i'),
+    new RegExp(`attributes\\[\\s*${quoted}\\s*\\]`, 'i'),
+  ]
+  return rows
+    .filter((row) => patterns.some((pattern) => pattern.test(String(row.clientdata ?? ''))))
+    .map((row) => ({
+      name: row.name,
+      category: WORKFLOW_CATEGORIES[row.category] ?? `类别 ${row.category}`,
+      state: row.statecode === 1 ? '已启用' : '草稿/停用',
+    }))
+}
+
+/**
+ * Find forms whose scripts reference a web resource.
+ * @param resourceName - web resource name as written in formxml `libraryName`.
+ */
+export async function findResourceForms(client, resourceName, signal) {
+  const rows = await readAll(client, 'systemforms', {
+    $select: 'name,type,objecttypecode,formxml',
+    $filter: `contains(formxml,'${odataString(`libraryName="${resourceName}"`)}')`,
+  }, 500, signal)
+  return rows.map((row) => {
+    // The event name lives on the enclosing <event> node; the <Handler> only
+    // names the function. Pair them so the report says "onload → fn" instead of
+    // "? → fn".
+    const handlers = []
+    for (const block of String(row.formxml ?? '').matchAll(/<event\b[^>]*>([\s\S]*?)<\/event>/gi)) {
+      const eventTag = block[0].slice(0, block[0].indexOf('>') + 1)
+      const eventName = /\bname="([^"]*)"/i.exec(eventTag)?.[1] ?? ''
+      for (const match of block[1].matchAll(/<Handler\b[^>]*>/gi)) {
+        const tag = match[0]
+        if (!tag.includes(`libraryName="${resourceName}"`)) continue
+        const fn = /functionName="([^"]*)"/i.exec(tag)
+        handlers.push({ functionName: fn?.[1] ?? '', event: eventName })
+      }
+    }
+    return {
+      name: row.name,
+      type: row.type,
+      typeLabel: FORM_TYPES[row.type] ?? `类型 ${row.type}`,
+      entity: row.objecttypecode,
+      handlers,
+    }
+  })
+}
+
+/**
+ * Resolve a plugin assembly name to its types and message steps.
+ * @returns `{ assembly, types: [{ typename, steps: [...] }] }`
+ */
+export async function findPluginUsage(client, assemblyName, signal) {
+  const assemblies = await readAll(client, 'pluginassemblies', {
+    $select: 'pluginassemblyid,name,version,isolationmode,sourcetype',
+    $filter: `name eq '${odataString(assemblyName)}'`,
+  }, 5, signal)
+  const assembly = assemblies[0]
+  if (!assembly) {
+    throw new D365Error(`没有找到插件程序集：${assemblyName}`, {
+      code: 'unknown-assembly',
+      hint: '先用 d365_metadata resource=plugin_assemblies 看名字（通常是程序集名，不带 .dll）。',
+    })
+  }
+
+  const types = await readAll(client, 'plugintypes', {
+    $select: 'plugintypeid,typename,friendlyname,_pluginassemblyid_value',
+    $filter: `_pluginassemblyid_value eq ${assembly.pluginassemblyid}`,
+  }, 200, signal)
+
+  const detail = []
+  for (const type of types) {
+    const steps = await readAll(client, 'sdkmessageprocessingsteps', {
+      $select: 'name,stage,mode,rank,filteringattributes,statecode,configuration',
+      $filter: `_eventhandler_value eq ${type.plugintypeid}`,
+    }, 100, signal)
+    detail.push({
+      typename: type.typename,
+      friendlyName: type.friendlyname,
+      steps: steps.map((step) => ({
+        name: step.name,
+        stage: step.stage,
+        mode: step.mode,
+        rank: step.rank,
+        filteringAttributes: step.filteringattributes,
+        enabled: step.statecode === 0,
+      })),
+    })
+  }
+
+  return {
+    assembly: {
+      name: assembly.name,
+      version: assembly.version,
+      isolation: assembly.isolationmode,
+      source: assembly.sourcetype,
+    },
+    types: detail,
+  }
+}