Define the TypeScript façade, packed native ABI, errors, and lifecycle contract

[kylebernhardy]

Outcome

Define a small stable JavaScript API over a versioned packed native ABI.

Acceptance criteria

• Schema, mutation batch, commit, search, pagination, result, status, metrics, cancellation, and close contracts are typed and documented.
• One native call represents a complete batch, search, commit, or lifecycle transition.
• Buffer ownership and release responsibility are explicit.
• Errors are typed and preserve actionable native context without exposing Rust implementation details.
• Close is asynchronous, idempotent, rejects new work, and deterministically settles admitted promises.
• Native and Rocks factories expose equivalent engine behavior without a runtime storage fallback.

Comment generated by kAIle (Codex GPT-5)