@timmydev56/hera-ts-sdk

Standalone TypeScript SDK package for Hera.

It publishes as a single npm package by embedding the generated Wasm bridge inside dist/wasm. Consumers do not need to build Rust or run wasm-pack themselves.

Publish shape

The npm package contains:

• dist/index.js and dist/index.d.ts
• dist/types.d.ts
• dist/wasm/* generated by wasm-pack

At runtime the package loads its own colocated Wasm bundle via dynamic import.

Local build flow

1. Build the standalone npm artifact.

cd packages/ts-sdk
npm run build

2. Typecheck the TypeScript wrapper.

tsc --noEmit -p tsconfig.json

npm pack will automatically run prepack, which builds the Wasm bridge and TypeScript wrapper into dist/.

Usage

import { createHeraClient } from "@timmydev56/hera-ts-sdk";

const client = await createHeraClient({
  baseUrl: "https://api.hera.example",
  apiKey: "hera_live_...",
});

const workspaces = await client.listWorkspaces({ limit: 10 });

The bridge still uses JSON strings across the Wasm boundary on purpose. That keeps the published TypeScript package dependency-free while preserving the Rust implementation underneath.

Examples

• examples/node-case-lifecycle.mts
• examples/browser-case-lifecycle.ts