#multipart-stream

#已实现的完整功能范围

• 严格 Content-Type、Content-Disposition、quoted parameter、filename* 与 _charset_ 处理，拒绝 header 注入和编码后的控制字符；
• 基于 KMP 的增量 boundary matcher，支持任意切块、regular/closing delimiter、 transport-padding、近似前缀和有界 retained 状态；
• PartBegin、PartData、PartEnd、MessageEnd 有序事件、二进制正文、严格 EOF、 sticky failure、limits、脱敏 diagnostic 与 parser stats；
• 增量 MultipartWriter、canonical headers、boundary collision 检查、精确 Content-Length plan 与长度校验 PlannedEmitter；
• 有界字段 collector、callback source/sink、legacy multipart/mixed 增量展开；
• 事务 UploadPipeline、field/file/aggregate quota、exactly-once abort、CRC-32 审计和 peak-chunk metrics；
• Native mpstream CLI、basic/limits 示例、Go mime/multipart 双向互操作与真实 curl -F 客户端验证。

#安装

moon add longhuanlin/multipart-stream@0.1.1

import {
  "longhuanlin/multipart-stream" @multipart,
}

#快速开始

moon run src/examples/basic --target native

Content-Type: multipart/form-data; boundary=basic-demo
begin greeting
data 13 bytes
end #0
message complete

moon run src/cmd/mpstream --target native -- \
  generate --boundary demo --field title=hello \
  --file blob=@test/interop/curl_fixture.txt

mpstream validate-boundary <value>
mpstream generate --boundary <value> [--field name=value] [--file name=@path] ...
mpstream inspect --content-type <value> (--hex <wire-hex> | --file <path>) [--chunk-size N]
mpstream version

#库 API

let writer = MultipartWriter::new("demo", default_limits())
let meta : PartMeta = {
  index: 0,
  name: "title",
  filename: None,
  content_type: Some("text/plain; charset=utf-8"),
  headers: [],
}
let wire = @buffer.Buffer()
wire.write_bytes(writer.begin_part(meta))
wire.write_bytes(writer.write(b"hello"))
wire.write_bytes(writer.end_part())
wire.write_bytes(writer.finish())

let parser = MultipartParser::new("demo", default_limits())
let events = parser.feed(wire.to_bytes())
let completed = parser.finish() // [MessageEnd]

#验证

moon fmt --check
moon check --target all --warn-list +73 --deny-warn
moon test --target all --warn-list -68-1+73
moon build src/cmd/mpstream --target native --warn-list +73 --deny-warn
moon info --target all
bash test/cli_smoke.sh
bash test/interop/run.sh --required
bash bench/run.sh

#设计边界

• 协议范围是 multipart/form-data，另有受限的 legacy multipart/mixed 兼容层；不实现 完整邮件 MIME、Content-Transfer-Encoding、HTTP server/client、TCP 或 TLS；
• parser、writer 和 pipeline 是同步单 owner 状态机；同一实例不能并发或重入调用；
• PartData 当前是 owned Bytes；borrowed/zero-copy event 属于后续演进；
• 真实文件系统、网络、对象存储、backpressure 和安全摘要由宿主实现；CRC-32 仅用于非安全 审计，filename 也始终是不可信 metadata；
• CLI 的 --file 是诊断便利入口，会整体读取指定文件；生产大文件应使用增量 API；
• 模块名为 longhuanlin/multipart-stream，当前稳定发布版为 v0.1.1。

#文档

• 项目申请书
• 架构说明

#许可证