Get started
Start with a local, offline SDK example. No Tracecove or company login is required for this step. Node.js 24 or later and a package manager are required. The Node entry uses the runtime's SQLite reference implementation and may emit its experimental SQLite warning.
Download and install
The current public preview is 0.7.0-preview.1. This is a versioned archive release, not an npm registry publication.
mkdir identity-example
cd identity-example
npm init -y
npm install https://identity.tracecove.com/downloads/tracecove-identity-0.7.0-preview.1.tgzFor an inspected download, use the SDK download page and verify its published SHA-256 before installing the local archive. Keep the package-manager lockfile so your application retains an exact dependency resolution.
Run an offline example
Save the following as example.mjs, then run node example.mjs.
import { productSessionReference } from '@tracecove/identity';
const reference = productSessionReference({
tenant: 'example',
environment: 'development',
issuer: 'https://issuer.example.test',
product: 'example-app',
productSubject: 'example-subject',
brokerSessionId: 'example-session',
});
console.log(reference);The result starts with psr1_. The helper performs a local, deterministic hash; it makes no network request. The result is an opaque revocation locator, not a token, proof of a login, or permission to access a product.
Connect an environment
Networked methods require an operator-issued profile for a registered issuer/API and application. The package does not create an environment or provision credentials.
- Choose your runtime: Node server or Workers.
- Review the configuration fields and transport rules.
- Implement web sign-in in your application's backend using a maintained OIDC library.
- Bind the independently verified actor to a product connection, and enforce explicit product membership.
- Integrate lifecycle consumption and effect-time checks before treating Identity state as product authority.
Tracecove's hosted preview requires an explicit application registration and synthetic test accounts. Public docs and the SDK do not enable unrestricted staging access or production use. Contact hello@tracecove.com for registration.
Public preview 0.7.0-preview.1 · Not production ready · Status and releases