# Plain SDK [#plain-sdk]

Use the plain SDK for TypeScript applications that want typed inputs and
reports without managing Effect services. The root and AU entrypoints also
support browser calculations on the device.

## Call a helper [#call-a-helper]

```ts
import { Cents, aud } from "@taxkit/core/primitives";
import { au } from "@taxkit/sdk/au";

const report = await au.incomeTax.annual({
  taxableIncome: aud(Cents.make(9_000_000)),
});
```

## Call the generic facade [#call-the-generic-facade]

```ts
import { Cents, aud } from "@taxkit/core/primitives";
import { TaxKit } from "@taxkit/sdk";
import { au } from "@taxkit/sdk/au";

const report = await TaxKit.calculate(au.calculations.annualIncomeTax, {
  taxableIncome: aud(Cents.make(9_000_000)),
});
```

`TaxKit.calculate` returns the calculator-specific report type inferred from
the descriptor you pass.

## Use a module-scoped client [#use-a-module-scoped-client]

```ts
import { Cents, aud } from "@taxkit/core/primitives";
import { au } from "@taxkit/sdk/au";

const client = au.createClient();

try {
  const report = await client.calculations.calculate(
    au.calculations.annualIncomeTax,
    { taxableIncome: aud(Cents.make(9_000_000)) }
  );
} finally {
  await client.dispose();
}
```

Module-scoped clients keep the selected calculator modules explicit. Type tests
cover incompatible calculator/module pairs.

Each client owns its resources. Await `dispose()` when you finish, including
when a calculation fails. Closing stops pending calculations and waits for
cleanup. You can safely call it again. Closing one client leaves other clients
usable. Calls on a closed client fail with `TaxKitClientDisposedError` detail.
The direct helpers above handle their own cleanup before returning.

## When to use another surface [#when-to-use-another-surface]

Use [Safe SDK](/sdk/safe-sdk) when you want a result object for expected
failures. Use [Effect SDK](/sdk/effect-sdk) when you need Effect service
composition or a full run response. Use the HTTP API when the caller should not
import TypeScript packages.

## Related pages [#related-pages]

* [Run your first calculation](/start/run-your-first-calculation)
* [Type safety](/sdk/type-safety)
* [Schemas](/sdk/schemas)