Helix Query Authoring — TypeScript

Write Helix TypeScript DSL queries in a way that is schema-aware, explicit, and easy for agents to reason about. The published package is @helix-db/helix-db@3.0.4, is ESM-only, and requires Node.js 20 or newer.

This is the preferred way to author Helix queries in a TypeScript codebase — type-checked, and it emits the dynamic-request JSON for you. Drop to raw dynamic JSON (helix-query-json-dynamic) only for debugging or dynamically-shaped requests.

When To Use

Use this skill when the task is to:

• write a new Helix query in TypeScript
• revise an existing TypeScript query function
• produce a dynamic POST /v2/query request from TypeScript (toQueryJson / toQueryRequest)
• send a request to a running Helix instance with the built-in Client (client.query(req).send())
• add traversal, projection, pagination, BM25 search, or vector search to an existing query
• migrate a Rust v3 DSL query (#[query], read_batch(), …) to TypeScript