For the complete documentation index, see llms.txt. This page is also available as Markdown.

v2.2.0

npmjs

✨ Changes

  • Email Passwordless without a modal. When a single email_passwordless login provider is configured together with a loginHint (the user's email, known in advance), login() now starts the passwordless flow directly and skips the login-provider selection modal.

    • New loginHint option, accepted both on the constructor config and on the per-call login() override.

    • If loginHint is missing or not a valid email, the modal opens as before — so the behaviour is safe to adopt incrementally.

  • Quieter by default — new debug flag. The SDK no longer prints verbose logs to the browser console. Pass debug: true in the constructor config to re-enable detailed logging while developing.

  • mfaLevel is deprecated. It has no effect since Torus-embed v6 (the underlying ws-embed API has no MFA-level support). Existing code that passes mfaLevel keeps working, but the option is ignored.

Skip the modal with loginHint
const sdk = new Startrail({
  env: 'staging',
  loginProvider: ['email_passwordless'],
  loginHint: 'user@example.com', // known email → passwordless starts directly, no modal
})
await sdk.login()
https://github.com/startbahn/api-portal/blob/main/startrail-sdk-js/initialization.md

🤖 Agent & LLM friendly

This release ships first-class resources so AI coding tools (Claude, Cursor, Copilot, …) integrate the SDK correctly with minimal context.

📄 llms.txt

Machine-readable API reference — install, lifecycle, every method signature, the environment table and the error catalogue.

Bundled in the npm package node_modules/@startbahn/startrail-sdk-js/llms.txt

🤖 AGENTS.md

Rules + the canonical construct → login → action pattern for agents writing code against the SDK.

In the SDK source repository

💬 Typed TSDoc

Rich hover docs and autocomplete on the public class and request/response types, straight from your editor.

Bundled in the package types

Point your AI assistant at node_modules/@startbahn/startrail-sdk-js/llms.txt for an accurate, version-matched reference instead of relying on its training data.

🛠️ Internal

  • Migrated the build/release toolchain from Yarn to pnpm 11 (Node 22) and refreshed the lint/build config. No change to how you install or consume the package.

  • Refactored the Torus login flow (more reliable early-EOA return) and resolved outstanding Dependabot security alerts.

🔀URL per environment

Last updated

Was this helpful?