Skip to main content

Signal Tags

@betterdata/signal-tags-schema provides JSON Schema contracts for cryptographically anchored product identity and provenance workflows.

What Signal Tags Are

Signal Tags define a structured identity + traceability model for products, lots, and custody events. The package ships schemas, fixtures, and typed schema-aligned TypeScript definitions.

Schema Files (Draft-07)

FilePurpose
schemas/v0.1/signal-tag.schema.jsonTop-level Signal Tag envelope
schemas/v0.1/product-identifier.schema.jsonProduct identity fields and identifiers
schemas/v0.1/trace-event.schema.jsonChain-of-custody and lifecycle event records
schemas/v0.1/lot.schema.jsonLot-level serialization and trace attributes

Regulatory Relevance

  • DSCSA: Supports structured serialization and provenance context for trace workflows.
  • FSMA: Lot-level event modeling aligns with CTE/KDE trace expectations.
  • CSRD / due diligence: Product-level provenance links support auditable sourcing narratives.

Install And Use

npm install @betterdata/signal-tags-schema
Key package paths:
  • ./schemas/* for schema import
  • ./fixtures/* for sample payloads
  • src/index.ts for typed helpers like SignalTagStatus and TraceEventType