Signal Tags integration

Integrate Signal Tags product authentication with the Better Data platform — verification outcomes that start or advance loops in the Loop Engine.

Overview

Signal Tags bridge physical scans to digital governance. A scan produces a verification result; your integration maps that result to loop transitions (quarantine, investigation, release, etc.).

Install

1npm install @signal-tags/sdk

For schema-only validation:

1npm install @signal-tags/schema

Use @signal-tags/verify for a dedicated verification client when you want HTTP calls wrapped by the published client. Validate responses with @signal-tags/schema (or exports from @signal-tags/sdk) where applicable. Hosted verification today: verify.betterdata.co with your HTTP client and org credentials.

Configure verification

Point your integration at the hosted verification base URL:

1const VERIFY_BASE = process.env.SIGNAL_TAGS_VERIFY_URL ?? "https://verify.betterdata.co";
2"cmt">// Implement GET/POST to your contracted verification route; attach org credentials as required.

Verify a tag (pattern)

1type VerifyStatus = "authentic" | "tampered" | "expired" | "recalled" | string;
2 
3interface VerificationResponse {
4  status: VerifyStatus;
5  tagId: string;
6  verifiedAt: string;
7  "cmt">// Plus contract-specific fields (lot, product, chain-of-custody, etc.)
8}
9 
10async function verifyTag(tagId: string): Promise<VerificationResponse> {
11  const res = await fetch(`${VERIFY_BASE}/v1/verify/${encodeURIComponent(tagId)}`, {
12    headers: { Authorization: `Bearer ${process.env.SIGNAL_TAGS_TOKEN!}` },
13  });
14  if (!res.ok) throw new Error(`verify failed: ${res.status}`);
15  return res.json() as Promise<VerificationResponse>;
16}

Triggering loops from verification

1const result = await verifyTag(tagId);
2 
3switch (result.status) {
4  case "authentic":
5    "cmt">// proceed with sale / fulfillment
6    break;
7  case "recalled":
8    "cmt">// await loopSystem.startLoop({ definitionId: "quarantine", context: { tagId } })
9    break;
10  case "tampered":
11    "cmt">// investigation / brand-protection loop
12    break;
13}

Wire loopSystem to your Loop Engine integration (Loops, Hosted Loop Engine).

Industry applications

| Industry | Use case | | -------- | -------- | | Pharmaceutical | DSCSA serialization, recall handling | | Healthcare | UDI traceability | | Retail | Anti-counterfeit, luxury authentication | | Food & beverage | Farm-to-shelf traceability | | Construction | Materials provenance |

Hosted verification

The hosted endpoint at verify.betterdata.co adds HA operations, compliance-oriented reporting, and optional anchoring features (per contract).
Contact hello@betterdata.co for access.

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