# Integration downloads

Install verified client and CLI archives, verify their checksums, and use only the currently deployed beta operations.

Canonical: https://assurance.nexusregen.com/developers/tools

## What is available

The TypeScript client 0.1.0-beta.4 and read-only diagnostics CLI 0.1.0-beta.0 are available as versioned, checksum-published package archives for Node.js 24 or newer. The dependency-free Python client 0.1.0b0 is available as an MIT-licensed wheel for Python 3.11. The MIT-licensed integration kit 0.1.0-beta.0 contains an OpenAPI-derived Postman collection, environment template, portable SKILL.md, help, examples, fixture, and provenance manifest for exactly the 17 released operations. None is published to a registry. Earlier TypeScript client 0.1.0-beta.0 through 0.1.0-beta.3 archives remain immutable for existing consumers.

The CLI bundles the released TypeScript client 0.1.0-beta.0; installing the standalone beta.4 client alongside it does not upgrade that bundled client. The integration kit does not make self-service sandbox automation, outbound webhook delivery, replay, jobs, feeds, or project/location provisioning available. The CLI does not add write, reset, replay, job, or example-workflow operations. Do not substitute a production workspace for the unavailable sandbox.

[Download TypeScript client 0.1.0-beta.4](https://assurance.nexusregen.com/developers/downloads/assurance-client-typescript-0.1.0-beta.4.tgz)

[Download TypeScript client SHA-256 checksum](https://assurance.nexusregen.com/developers/downloads/assurance-client-typescript-0.1.0-beta.4.tgz.sha256)

[Download Python client 0.1.0b0](https://assurance.nexusregen.com/developers/downloads/nexus_assurance_client-0.1.0b0-py3-none-any.whl)

[Download Python SHA-256 checksum](https://assurance.nexusregen.com/developers/downloads/nexus_assurance_client-0.1.0b0-py3-none-any.whl.sha256)

[Download CLI 0.1.0-beta.0](https://assurance.nexusregen.com/developers/downloads/assurance-cli-0.1.0-beta.0.tgz)

[Download CLI SHA-256 checksum](https://assurance.nexusregen.com/developers/downloads/assurance-cli-0.1.0-beta.0.tgz.sha256)

[Download integration kit 0.1.0-beta.0](https://assurance.nexusregen.com/developers/downloads/nexus-assurance-integration-kit-0.1.0-beta.0.tgz)

[Download integration kit SHA-256 checksum](https://assurance.nexusregen.com/developers/downloads/nexus-assurance-integration-kit-0.1.0-beta.0.tgz.sha256)

[Check machine-readable availability](https://assurance.nexusregen.com/developers/capabilities.json)

## Use the Postman collection and portable skill

Download the MIT-licensed integration kit and its SHA-256 file, verify it, then import its Postman collection and duplicate its environment template. The template deliberately leaves API keys and resource references blank. The collection is generated from the deployed OpenAPI contract and contains exactly 17 operations.

Writes are grouped as explicit user actions and require a stable idempotency key. The skill and help explain bounded retries, DELETE uncertainty, source mapping, and human-action boundaries. An endpoint record remains different from a delivered webhook.

```sh
curl --fail --location --remote-name https://assurance.nexusregen.com/developers/downloads/nexus-assurance-integration-kit-0.1.0-beta.0.tgz
curl --fail --location --output nexus-assurance-integration-kit-0.1.0-beta.0.tgz.sha256 https://assurance.nexusregen.com/developers/downloads/nexus-assurance-integration-kit-0.1.0-beta.0.tgz.sha256
sha256sum --check nexus-assurance-integration-kit-0.1.0-beta.0.tgz.sha256
tar -xzf nexus-assurance-integration-kit-0.1.0-beta.0.tgz
```

## Verify and install the Python wheel

Use Python 3.11. Download the wheel and its checksum from this host, verify them before installing, and keep the API key in server-side environment configuration. The wheel supplies the same 17 deployed operations as the TypeScript client, including authorised project and location discovery; it does not add provisioning, webhook delivery, or sandbox automation.

```sh
curl --fail --location --remote-name https://assurance.nexusregen.com/developers/downloads/nexus_assurance_client-0.1.0b0-py3-none-any.whl
curl --fail --location --output nexus_assurance_client-0.1.0b0-py3-none-any.whl.sha256 https://assurance.nexusregen.com/developers/downloads/nexus_assurance_client-0.1.0b0-py3-none-any.whl.sha256
sha256sum --check nexus_assurance_client-0.1.0b0-py3-none-any.whl.sha256
python3.11 -m pip install ./nexus_assurance_client-0.1.0b0-py3-none-any.whl
```

## Verify and install the archive

Download both archives and their SHA-256 metadata from this host. Verify each before installing, then install the local archives with Bun. Keep the API key in server-side environment configuration, never in a browser bundle or URL. Update by installing the next verified pair; uninstall with bun remove @nexusregen/assurance-cli (and remove the client only if unused elsewhere).

```sh
curl --fail --location --remote-name https://assurance.nexusregen.com/developers/downloads/assurance-client-typescript-0.1.0-beta.4.tgz
curl --fail --location --output assurance-client-typescript-0.1.0-beta.4.tgz.sha256 https://assurance.nexusregen.com/developers/downloads/assurance-client-typescript-0.1.0-beta.4.tgz.sha256
sha256sum --check assurance-client-typescript-0.1.0-beta.4.tgz.sha256
curl --fail --location --remote-name https://assurance.nexusregen.com/developers/downloads/assurance-cli-0.1.0-beta.0.tgz
curl --fail --location --output assurance-cli-0.1.0-beta.0.tgz.sha256 https://assurance.nexusregen.com/developers/downloads/assurance-cli-0.1.0-beta.0.tgz.sha256
sha256sum --check assurance-cli-0.1.0-beta.0.tgz.sha256
bun add ./assurance-client-typescript-0.1.0-beta.4.tgz ./assurance-cli-0.1.0-beta.0.tgz
```

## Connection quickstart

Start with a read-only connection check. This package also covers authorised project and location discovery alongside connection, sites, movements, loads, evidence upload initiation and completion, and webhook endpoint records. A webhook endpoint record is not proof of event delivery.

```ts
import { createNexusAssuranceClient } from "@nexusregen/assurance-client";

const client = createNexusAssuranceClient({ apiKey: process.env.NEXUS_API_KEY! });
const connection = await client.getConnection();
console.log(connection.data.connection.scopes);
console.log(connection.meta.requestId);
```

## Paginate movements safely

The iterator follows page.hasMore and cursor values. It rejects a missing or repeated continuation cursor instead of silently treating a partial listing as complete. Persist your own reconciliation state only when the deployed contract supports it; incremental feeds are not available in this beta.

```ts
for await (const movement of client.iterateMovements({ limit: 50 })) {
  await reconcileMovement(movement.ref);
}
```

## Handle errors and bounded retries

The TypeScript and Python clients retry transient 429 and 5xx responses for reads and idempotent POST or PATCH requests, honour Retry-After, and bound retries, delay, and total request time. DELETE is sent once: a lost response is indeterminate, so inspect current state rather than replaying it.

Use one stable idempotency key for one logical supported write. Validation, authorisation, and version errors require correction rather than blind retry. NexusApiError carries the HTTP status, safe error code, request ID, and server details when supplied.

```ts
import { NexusApiError } from "@nexusregen/assurance-client";

try {
  await client.createMovement(payload, "source-booking-4821");
} catch (error) {
  if (error instanceof NexusApiError) console.error(error.status, error.code, error.requestId);
  throw error;
}
```

[Read support and request-ID guidance](https://assurance.nexusregen.com/developers/support)