Signal Tags (OSS)

Signal Tags are an open schema and protocol story for verifiable physical product identity. Published packages use the @signal-tags scope on npm (see tagd.sh).

@signal-tags/sdk

1npm install @signal-tags/sdk

The SDK is the primary install surface. It bundles the developer workflow for schema-backed tags, verification helpers, and related tooling.

@signal-tags/schema

For schema-only use (JSON Schema draft-07 artifacts and TypeScript types without the full SDK surface):

1npm install @signal-tags/schema

1import { SignalTagSchema } from '@signal-tags/schema'

Point validators (for example Ajv) at the JSON files under node_modules/@signal-tags/schema/schemas/ (or copy schemas into your repo) and validate incoming verification payloads.

Other published modules

• @signal-tags/verify — verification client for calling verify endpoints consistently
• @signal-tags/generate — tag ID generation utilities

Exact exports evolve with releases; see tagd.sh and npm org signal-tags.

Verification client

Call your verification HTTP API (hosted at verify.betterdata.co or self-managed). Validate responses with @signal-tags/schema (or types from @signal-tags/sdk) where applicable.

1"cmt">// Conceptual — replace with your contracted path and auth
2const res = await fetch(`https://verify.betterdata.co/v1/verify/${tagId}`, {
3  headers: { Authorization: `Bearer ${process.env.SIGNAL_TAGS_TOKEN}` },
4});
5const payload = await res.json();
6"cmt">// payload.status: 'authentic' | 'tampered' | 'expired' | 'recalled' (per contract)

Loop Engine integration

Verification outcomes should feed the Loop Engine — for example opening a quarantine loop on recalled or investigation on tampered.

→ Signal Tags (platform)
→ Signal Tags integration
→ tagd.sh