前端 SDK API

// plugin.ts
import { definePlugin } from 'fh2-plugin-sdk'

export default definePlugin({
  async activate(ctx) {
    // 贡献扩展、申请能力、订阅事件都从这里开始
    return {
      dispose({ reason }) {
        // 业务收尾：停止自己的业务逻辑
      },
    }
  },
})

const res = await ctx.apiCall('/plugin/invoke', {
  method: 'POST',                             // 默认 GET
  body: {pluginId: 'exp_demo', handler: 'demo.status', input: {}},
  timeoutMs: 10000,
  idempotencyKey: 'capture-001',              // 1-256 字符，不含换行
})

import { defineView } from 'fh2-plugin-sdk'

export default defineView({
  mount(viewCtx) {
    // viewCtx: {viewId, mountElement, styleTarget, overlayElement, port, locale, direction, theme}
    viewCtx.mountElement.textContent = 'hello'
    return { dispose() {} }
  },
})

import { definePluginView, createViewState } from 'fh2-plugin-sdk'

const panel = definePluginView<{
  state: {count: number}
  methods: {increment(delta: number): number}
}>('panel')

// 入口侧：接管界面。对象形态（state 是 createViewState 之类的状态源）：
const state = createViewState({count: 0})
await panel.handle(ctx, {
  state,
  methods: {
    increment: delta => {
      state.update(v => ({count: v.count + delta}))
      return state.get().count
    },
  },
})

// 界面侧：contract.client(port) 得到 { state, <各方法平铺>, dispose }，
// 方法直接调用：await client.increment(1)