v0.2.0 — Data Braider + GitHub Copilot

navapi 0.2.0 — Data Braider + GitHub Copilot.

All four faces (core, CLI, MCP, VS Code) are aligned at 0.2.0.

Highlights

🧭 Native Data Braider support

First-class support for Data Braider, the free community no-code API factory for Business Central, across every face:

• Discover configured endpoints; read their data (Braider filters, paging, flat + hierarchical output) with the double-encoded payloads transparently unwrapped; write to them (Insert/Update/Delete/Upsert); introspect schema.
• Remote endpoint authoring against Data Braider's config API (2.4+): create endpoints, lines, and fields without leaving your editor. Older installs get discovery/read/write/inferred-schema and light up the authoring path automatically once the config API is present.

🤖 GitHub Copilot integration (VS Code)

The extension registers navapi's MCP server with VS Code (1.101+), so Copilot agent mode gets all 24 navapi tools — BC discovery, CRUD, $batch, bound actions, and the full Data Braider tool set — with zero mcp.json setup, scoped to your active profile.

Install

• VS Code: search "navapi" in the Marketplace, or install the attached .vsix.
• CLI / library / MCP: npm i -g @navapi/cli, npm i @navapi/core, npm i -g @navapi/mcp.

Packages

• @navapi/core 0.2.0 — Data Braider client + BraiderClient; create() etag option.
• @navapi/cli 0.2.0 — navapi braider command tree.
• @navapi/mcp 0.2.0 — 10 braider_* tools (24 total).
• navapi-vscode 0.2.0 — Data Braider sidebar + Copilot/MCP integration.

navapi 0.1.0-alpha.1

First public alpha of navapi — the discovery-first Business Central API toolkit. Four faces, one brain, validated live against a real BC tenant (22 API routes, 645 entity sets, full CRUD with transparent ETags).

What's in the box

• @navapi/core — auth (client credentials, token caching), route discovery via the runtime apiRoutes API, per-route $metadata ingestion + on-disk cache, company resolution, CRUD with GET→If-Match→retry-once-on-412, server-driven pagination (odata.maxpagesize), $count, $batch, bound actions, navigation properties, OS-keychain secret storage with file fallback.
• @navapi/cli — the navapi command: profiles, companies, discovery, queries (--filter/--select/--orderby/--count/--nav/--show-url), writes, actions, batch, secrets status|migrate. TTY-aware: humans get tables, pipes get stable JSON.
• @navapi/mcp — 14 typed MCP tools over stdio with real pagination (nextLink → get_next_page), shared profiles with the CLI.
• navapi-vscode (attached .vsix) — Profiles / Companies / Endpoint Browser sidebar, records grid with a BC-style query builder ($filter/$select/$count, copyable query URL), server-side sorting, FastTab detail panes with lazy-loaded navigations, right-click Filter… / Filter to This Value / Copy Value, add/edit profile form with Test Connection.

Install

npm i -g @navapi/cli@alpha    # CLI  (the bare `navapi` npm name is squatted; the command is still `navapi`)
npm i  @navapi/core@alpha     # library
npm i -g @navapi/mcp@alpha    # MCP server (`navapi-mcp`)

code --install-extension navapi-vscode-0.0.6.vsix   # extension (download below)

⚠️ The attached .vsix bundles the OS-keychain binding for Windows x64 only; on other platforms the extension falls back to file-based secret storage. Alpha-quality: expect sharp edges, report them.

Notes

• Secrets: stored in the OS keychain (Credential Manager / Keychain / libsecret); pre-existing plaintext file secrets migrate automatically on first use. NAVAPI_SECRET_BACKEND=file opts out; NAVAPI_CLIENT_SECRET covers CI.
• Route enumeration is company-scoped — set a default company (navapi company use) to see custom and Microsoft API routes.
• 128 tests, CI on ubuntu/windows × Node 20/22.