用途:这是构建 Salla App Function 的第 1–2 步,在写代码前先决定什么会运行、何时运行。
主要能力:
- 确认事件契约。事件目录按 Merchant 与 Customer 分组,标注每个触发器的同步/异步类型及已文档化的 payload.data 形状,存放于 references/event-contexts.md。可用 salla_functions action=list_triggers(无需 app_id)查实时触发器名称与分类,用 action=get 获取触发器的权威 .d.ts。客户事件文档给出的多为示例 payload,须先确认字段名再依赖。检查点:是否已确认该事件的 payload.data 字段名?
- 选择执行类型。异步事件在操作后触发,不阻塞用户,超时 30 秒,属 fire-and-forget,仅记录日志不影响流程;同步动作在操作前触发,会阻塞用户,总超时 5 秒,可修改参数或拒绝/阻断操作。同步动作即 merchant_actions 分类(如 shipment.creating、shipment.cancelling,须用 action=list_triggers 确认分类而非动词形式)。shipment.creating 是文档化的同步示例,返回 Shipment ((context: Shipments): Promise<Shipment>) 而非普通 Resp,用于设置运单编号/标签。异步事件(如 order.created、product.added)带外运行,需返回有效的成功/错误结果以便记录日志。
超时预算:同步为 5 秒硬上限、目标 < 500 毫秒,内部异步调用每次 < 2 秒并用 AbortController 约束;异步总超时 30 秒,同样用 AbortController 约束。同步动作期间商户被阻塞,故以 < 500 毫秒为目标、5 秒为上限;超时会使同步阻塞、异步丢弃。检查点:是否已确定同步或异步,并理解超时预算?
安全与数据交接:处理令牌、商户认证或外部调用时,令牌存储/OAuth/商户访问令牌转交 salla-app-auth;webhook 签名验证与幂等转交 salla-webhooks。完整交接清单见 references/event-contexts.md。下一步在 salla-app-functions-handler 中实现。
限制:资料未提供具体命令、安装步骤、价格或平台支持等事实,以上均暂未提供。