@glasstrace/protocol

@glasstrace/protocol

Shared types and wire format schemas for the Glasstrace SDK.

This package defines the Zod schemas that form the public contract between the Glasstrace SDK and the Glasstrace backend. Both the SDK (public) and the backend (private) depend on this package.

Status: Pre-release -- not yet published to npm.

What's Inside

• Branded ID types -- DevApiKey, AnonApiKey, SessionId, BuildHash
• Configuration schemas -- CaptureConfig, GlasstraceOptions
• Wire format schemas -- SdkInitResponse, DiscoveryResponse, SourceMapUploadResponse
• Constants -- semantic attribute names, default capture config, source map upload limits (MAX_SOURCE_MAP_FILE_PATH_LENGTH, MAX_SOURCE_MAP_FILE_SIZE, MAX_SOURCE_MAP_FILE_COUNT)
• Session ID derivation -- deriveSessionId() produces the same 16-char hex SessionId the SDK uses, so independent clients (SDK, browser extension, tooling) agree on a session without coordination.

License

MIT