@spectro/protocol 0.0.0-stage → 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Spectro contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# @spectro/protocol
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Spectro Protocol V1 JSON Schemas, TypeScript types, serialization limits and strict validators. The common event envelope and event-specific payloads are shared by SDKs and server services.
+
+```ts
+import { validateEnvelope, protocolSchemas } from '@spectro/protocol';
+
+const result = validateEnvelope({ version: 1, sentAt: Date.now(), items: [] });
+console.log(result.success);
+console.log(protocolSchemas.event.$id);
+```
+
+Original JSON Schemas are also exported through `@spectro/protocol/schemas/*.json`. Package release versions are independent of event and envelope protocol versions. The package is ESM; Node consumers need a runtime that supports JSON import attributes (Node 22.12+).
+
+MIT, including this package's original schemas. See LICENSE. Platform services outside this package are not covered by this license.

package/dist/schemas/common.schema.json

@@ -0,0 +1,149 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/common.schema.json",
+    "$defs": {
+        "uuidV7": {
+            "type": "string",
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$"
+        },
+        "jsonValue": {
+            "oneOf": [
+                { "type": "string", "maxLength": 2048 },
+                { "type": "number" },
+                { "type": "boolean" },
+                { "type": "null" },
+                {
+                    "type": "array",
+                    "maxItems": 100,
+                    "items": { "$ref": "#/$defs/jsonValue" }
+                },
+                {
+                    "type": "object",
+                    "maxProperties": 100,
+                    "propertyNames": { "maxLength": 128 },
+                    "additionalProperties": { "$ref": "#/$defs/jsonValue" }
+                }
+            ]
+        },
+        "jsonObject": {
+            "type": "object",
+            "maxProperties": 100,
+            "propertyNames": { "maxLength": 128 },
+            "additionalProperties": { "$ref": "#/$defs/jsonValue" }
+        },
+        "sdkContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["name", "version"],
+            "properties": {
+                "name": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "version": { "type": "string", "minLength": 1, "maxLength": 64 }
+            }
+        },
+        "projectContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id"],
+            "properties": {
+                "id": { "type": "string", "pattern": "^prj_[A-Za-z0-9_-]{1,120}$" }
+            }
+        },
+        "sessionContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "startedAt": { "type": "integer", "minimum": 0 }
+            }
+        },
+        "userContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["anonymousId"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "anonymousId": { "type": "string", "minLength": 1, "maxLength": 256 },
+                "traits": { "$ref": "#/$defs/jsonObject" }
+            }
+        },
+        "pageContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["id", "url", "path"],
+            "properties": {
+                "id": { "type": "string", "minLength": 1, "maxLength": 128 },
+                "url": { "type": "string", "minLength": 1, "maxLength": 2048 },
+                "path": { "type": "string", "minLength": 1, "maxLength": 2048 },
+                "title": { "type": "string", "maxLength": 512 },
+                "referrer": { "type": "string", "maxLength": 2048 }
+            }
+        },
+        "deviceContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "type": { "type": "string", "enum": ["desktop", "mobile", "tablet", "unknown"] },
+                "model": { "type": "string", "maxLength": 128 }
+            }
+        },
+        "browserContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "name": { "type": "string", "maxLength": 128 },
+                "version": { "type": "string", "maxLength": 64 }
+            }
+        },
+        "osContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "name": { "type": "string", "maxLength": 128 },
+                "version": { "type": "string", "maxLength": 64 }
+            }
+        },
+        "releaseContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["version"],
+            "properties": {
+                "version": { "type": "string", "minLength": 1, "maxLength": 128 }
+            }
+        },
+        "traceContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "traceId": { "type": "string", "maxLength": 64 },
+                "spanId": { "type": "string", "maxLength": 32 },
+                "parentSpanId": { "type": "string", "maxLength": 32 }
+            }
+        },
+        "tags": {
+            "type": "object",
+            "maxProperties": 50,
+            "propertyNames": { "pattern": "^[A-Za-z][A-Za-z0-9_.-]{0,63}$" },
+            "additionalProperties": { "type": "string", "maxLength": 256 }
+        },
+        "eventContext": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["sdk", "project", "environment"],
+            "properties": {
+                "sdk": { "$ref": "#/$defs/sdkContext" },
+                "project": { "$ref": "#/$defs/projectContext" },
+                "environment": { "type": "string", "minLength": 1, "maxLength": 64 },
+                "session": { "$ref": "#/$defs/sessionContext" },
+                "user": { "$ref": "#/$defs/userContext" },
+                "page": { "$ref": "#/$defs/pageContext" },
+                "device": { "$ref": "#/$defs/deviceContext" },
+                "browser": { "$ref": "#/$defs/browserContext" },
+                "os": { "$ref": "#/$defs/osContext" },
+                "release": { "$ref": "#/$defs/releaseContext" },
+                "trace": { "$ref": "#/$defs/traceContext" },
+                "tags": { "$ref": "#/$defs/tags" }
+            }
+        }
+    }
+}

package/dist/schemas/custom.schema.json

@@ -0,0 +1,10 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/custom.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["properties"],
+    "properties": {
+        "properties": { "$ref": "https://spectro.dev/schemas/common.schema.json#/$defs/jsonObject" }
+    }
+}

package/dist/schemas/envelope.schema.json

@@ -0,0 +1,25 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/envelope.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["version", "sentAt", "items"],
+    "properties": {
+        "version": { "const": 1 },
+        "sentAt": { "type": "integer", "minimum": 0 },
+        "items": {
+            "type": "array",
+            "minItems": 1,
+            "maxItems": 100,
+            "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "required": ["type", "payload"],
+                "properties": {
+                    "type": { "const": "event" },
+                    "payload": { "$ref": "https://spectro.dev/schemas/event.schema.json" }
+                }
+            }
+        }
+    }
+}

package/dist/schemas/error.schema.json

@@ -0,0 +1,42 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/error.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["mechanism", "message", "handled"],
+    "properties": {
+        "mechanism": { "type": "string", "enum": ["runtime", "promise", "resource", "manual"] },
+        "name": { "type": "string", "maxLength": 256 },
+        "message": { "type": "string", "minLength": 1, "maxLength": 2048 },
+        "handled": { "type": "boolean" },
+        "fingerprint": {
+            "type": "array",
+            "maxItems": 10,
+            "items": { "type": "string", "maxLength": 256 }
+        },
+        "stack": {
+            "type": "array",
+            "maxItems": 50,
+            "items": {
+                "type": "object",
+                "additionalProperties": false,
+                "properties": {
+                    "filename": { "type": "string", "maxLength": 2048 },
+                    "function": { "type": "string", "maxLength": 512 },
+                    "line": { "type": "integer", "minimum": 0 },
+                    "column": { "type": "integer", "minimum": 0 },
+                    "inApp": { "type": "boolean" }
+                }
+            }
+        },
+        "source": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "url": { "type": "string", "maxLength": 2048 },
+                "line": { "type": "integer", "minimum": 0 },
+                "column": { "type": "integer", "minimum": 0 }
+            }
+        }
+    }
+}

package/dist/schemas/event.schema.json

@@ -0,0 +1,67 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/event.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["id", "type", "name", "version", "timestamp", "context", "payload"],
+    "properties": {
+        "id": { "$ref": "https://spectro.dev/schemas/common.schema.json#/$defs/uuidV7" },
+        "type": {
+            "type": "string",
+            "enum": ["session", "page", "error", "performance", "network", "interaction", "custom"]
+        },
+        "name": { "type": "string", "pattern": "^[a-z][a-z0-9_]{0,63}$" },
+        "version": { "const": 1 },
+        "timestamp": { "type": "integer", "minimum": 0 },
+        "context": { "$ref": "https://spectro.dev/schemas/common.schema.json#/$defs/eventContext" },
+        "payload": { "type": "object" }
+    },
+    "allOf": [
+        {
+            "if": { "properties": { "type": { "const": "session" } }, "required": ["type"] },
+            "then": {
+                "properties": { "payload": { "$ref": "https://spectro.dev/schemas/session.schema.json" } }
+            }
+        },
+        {
+            "if": { "properties": { "type": { "const": "page" } }, "required": ["type"] },
+            "then": {
+                "properties": { "payload": { "$ref": "https://spectro.dev/schemas/page.schema.json" } }
+            }
+        },
+        {
+            "if": { "properties": { "type": { "const": "error" } }, "required": ["type"] },
+            "then": {
+                "properties": { "payload": { "$ref": "https://spectro.dev/schemas/error.schema.json" } }
+            }
+        },
+        {
+            "if": { "properties": { "type": { "const": "performance" } }, "required": ["type"] },
+            "then": {
+                "properties": {
+                    "payload": { "$ref": "https://spectro.dev/schemas/performance.schema.json" }
+                }
+            }
+        },
+        {
+            "if": { "properties": { "type": { "const": "network" } }, "required": ["type"] },
+            "then": {
+                "properties": { "payload": { "$ref": "https://spectro.dev/schemas/network.schema.json" } }
+            }
+        },
+        {
+            "if": { "properties": { "type": { "const": "interaction" } }, "required": ["type"] },
+            "then": {
+                "properties": {
+                    "payload": { "$ref": "https://spectro.dev/schemas/interaction.schema.json" }
+                }
+            }
+        },
+        {
+            "if": { "properties": { "type": { "const": "custom" } }, "required": ["type"] },
+            "then": {
+                "properties": { "payload": { "$ref": "https://spectro.dev/schemas/custom.schema.json" } }
+            }
+        }
+    ]
+}

package/dist/schemas/interaction.schema.json

@@ -0,0 +1,28 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/interaction.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "properties": {
+        "target": {
+            "type": "object",
+            "additionalProperties": false,
+            "properties": {
+                "tag": { "type": "string", "maxLength": 64 },
+                "id": { "type": "string", "maxLength": 128 },
+                "role": { "type": "string", "maxLength": 64 },
+                "selector": { "type": "string", "maxLength": 512 },
+                "monitorId": { "type": "string", "maxLength": 128 }
+            }
+        },
+        "coordinates": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["x", "y"],
+            "properties": {
+                "x": { "type": "number" },
+                "y": { "type": "number" }
+            }
+        }
+    }
+}

package/dist/schemas/network.schema.json

@@ -0,0 +1,37 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/network.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["request", "timing", "initiator", "success"],
+    "properties": {
+        "request": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["method", "url"],
+            "properties": {
+                "method": { "type": "string", "pattern": "^[A-Z]+$", "maxLength": 16 },
+                "url": { "type": "string", "minLength": 1, "maxLength": 2048 }
+            }
+        },
+        "response": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["status"],
+            "properties": {
+                "status": { "type": "integer", "minimum": 0, "maximum": 599 }
+            }
+        },
+        "timing": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["start", "duration"],
+            "properties": {
+                "start": { "type": "number", "minimum": 0 },
+                "duration": { "type": "number", "minimum": 0 }
+            }
+        },
+        "initiator": { "type": "string", "enum": ["fetch", "xhr", "resource"] },
+        "success": { "type": "boolean" }
+    }
+}

package/dist/schemas/page.schema.json

@@ -0,0 +1,12 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/page.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["action"],
+    "properties": {
+        "action": { "type": "string", "enum": ["view", "route_change", "leave"] },
+        "from": { "type": "string", "maxLength": 2048 },
+        "to": { "type": "string", "maxLength": 2048 }
+    }
+}

package/dist/schemas/performance.schema.json

@@ -0,0 +1,18 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/performance.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["metric", "value", "unit"],
+    "properties": {
+        "metric": {
+            "type": "string",
+            "enum": ["lcp", "inp", "cls", "fcp", "ttfb", "long_task", "navigation", "resource_timing"]
+        },
+        "value": { "type": "number", "minimum": 0 },
+        "unit": { "type": "string", "enum": ["ms", "score"] },
+        "rating": { "type": "string", "enum": ["good", "needs_improvement", "poor"] },
+        "navigationType": { "type": "string", "maxLength": 64 },
+        "attribution": { "$ref": "https://spectro.dev/schemas/common.schema.json#/$defs/jsonObject" }
+    }
+}

package/dist/schemas/session.schema.json

@@ -0,0 +1,11 @@
+{
+    "$schema": "https://json-schema.org/draft/2020-12/schema",
+    "$id": "https://spectro.dev/schemas/session.schema.json",
+    "type": "object",
+    "additionalProperties": false,
+    "required": ["action"],
+    "properties": {
+        "action": { "type": "string", "enum": ["start", "end"] },
+        "duration": { "type": "number", "minimum": 0 }
+    }
+}

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './validation.js';
+export * from './schemas.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,4 @@
+export * from './types.js';
+export * from './validation.js';
+export * from './schemas.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/src/schemas.d.ts

@@ -0,0 +1,8 @@
+export type ProtocolSchemaValue = string | number | boolean | null | readonly ProtocolSchemaValue[] | ProtocolSchemaDocument;
+export interface ProtocolSchemaDocument {
+    readonly [key: string]: ProtocolSchemaValue;
+}
+export type ProtocolSchemaName = 'common' | 'custom' | 'envelope' | 'error' | 'event' | 'interaction' | 'network' | 'page' | 'performance' | 'session';
+/** Original bundled Draft 2020-12 documents. Their $id values are identifiers, not fetch URLs. */
+export declare const protocolSchemas: Readonly<Record<ProtocolSchemaName, ProtocolSchemaDocument>>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/src/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/schemas.ts"],"names":[],"mappings":"AAWA,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,MAAM,GACN,OAAO,GACP,IAAI,GACJ,SAAS,mBAAmB,EAAE,GAC9B,sBAAsB,CAAC;AAE3B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAAC;CAC7C;AAED,MAAM,MAAM,kBAAkB,GAC1B,QAAQ,GACR,QAAQ,GACR,UAAU,GACV,OAAO,GACP,OAAO,GACP,aAAa,GACb,SAAS,GACT,MAAM,GACN,aAAa,GACb,SAAS,CAAC;AAEd,kGAAkG;AAClG,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,sBAAsB,CAAC,CAWxF,CAAC"}

package/dist/src/schemas.js

@@ -0,0 +1,24 @@
+import common from '../schemas/common.schema.json' with { type: 'json' };
+import custom from '../schemas/custom.schema.json' with { type: 'json' };
+import envelope from '../schemas/envelope.schema.json' with { type: 'json' };
+import error from '../schemas/error.schema.json' with { type: 'json' };
+import event from '../schemas/event.schema.json' with { type: 'json' };
+import interaction from '../schemas/interaction.schema.json' with { type: 'json' };
+import network from '../schemas/network.schema.json' with { type: 'json' };
+import page from '../schemas/page.schema.json' with { type: 'json' };
+import performance from '../schemas/performance.schema.json' with { type: 'json' };
+import session from '../schemas/session.schema.json' with { type: 'json' };
+/** Original bundled Draft 2020-12 documents. Their $id values are identifiers, not fetch URLs. */
+export const protocolSchemas = {
+    common,
+    custom,
+    envelope,
+    error,
+    event,
+    interaction,
+    network,
+    page,
+    performance,
+    session,
+};
+//# sourceMappingURL=schemas.js.map

package/dist/src/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,+BAA+B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzE,OAAO,MAAM,MAAM,+BAA+B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACzE,OAAO,QAAQ,MAAM,iCAAiC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC7E,OAAO,KAAK,MAAM,8BAA8B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvE,OAAO,KAAK,MAAM,8BAA8B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACvE,OAAO,WAAW,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,OAAO,MAAM,gCAAgC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAC3E,OAAO,IAAI,MAAM,6BAA6B,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACrE,OAAO,WAAW,MAAM,oCAAoC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AACnF,OAAO,OAAO,MAAM,gCAAgC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AA0B3E,kGAAkG;AAClG,MAAM,CAAC,MAAM,eAAe,GAAiE;IAC3F,MAAM;IACN,MAAM;IACN,QAAQ;IACR,KAAK;IACL,KAAK;IACL,WAAW;IACX,OAAO;IACP,IAAI;IACJ,WAAW;IACX,OAAO;CACR,CAAC"}

package/dist/src/types.d.ts

@@ -0,0 +1,170 @@
+export declare const EVENT_VERSION: 1;
+export declare const ENVELOPE_VERSION: 1;
+export declare const EVENT_NAME_PATTERN: RegExp;
+export declare const MAX_EVENT_BYTES: number;
+export declare const MAX_ENVELOPE_BYTES: number;
+export declare const MAX_JSON_DEPTH = 5;
+export declare const MAX_ENVELOPE_STRUCTURE_DEPTH = 16;
+export type JSONPrimitive = string | number | boolean | null;
+export type JSONValue = JSONPrimitive | JSONValue[] | {
+    [key: string]: JSONValue;
+};
+export type JSONObject = {
+    [key: string]: JSONValue;
+};
+export type EventType = 'session' | 'page' | 'error' | 'performance' | 'network' | 'interaction' | 'custom';
+export interface SDKContext {
+    name: string;
+    version: string;
+}
+export interface ProjectContext {
+    id: string;
+}
+export interface SessionContext {
+    id: string;
+    startedAt?: number;
+}
+export interface UserContext {
+    id?: string;
+    anonymousId: string;
+    traits?: JSONObject;
+}
+export interface PageContext {
+    id: string;
+    url: string;
+    path: string;
+    title?: string;
+    referrer?: string;
+}
+export interface DeviceContext {
+    type?: 'desktop' | 'mobile' | 'tablet' | 'unknown';
+    model?: string;
+}
+export interface BrowserContext {
+    name?: string;
+    version?: string;
+}
+export interface OSContext {
+    name?: string;
+    version?: string;
+}
+export interface ReleaseContext {
+    version: string;
+}
+export interface TraceContext {
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+}
+export interface EventContext {
+    sdk: SDKContext;
+    project: ProjectContext;
+    environment: string;
+    session?: SessionContext;
+    user?: UserContext;
+    page?: PageContext;
+    device?: DeviceContext;
+    browser?: BrowserContext;
+    os?: OSContext;
+    release?: ReleaseContext;
+    trace?: TraceContext;
+    tags?: Record<string, string>;
+}
+export interface StackFrame {
+    filename?: string;
+    function?: string;
+    line?: number;
+    column?: number;
+    inApp?: boolean;
+}
+export interface ErrorPayload {
+    mechanism: 'runtime' | 'promise' | 'resource' | 'manual';
+    name?: string;
+    message: string;
+    stack?: StackFrame[];
+    fingerprint?: string[];
+    handled: boolean;
+    source?: {
+        url?: string;
+        line?: number;
+        column?: number;
+    };
+}
+export interface PerformancePayload {
+    metric: 'lcp' | 'inp' | 'cls' | 'fcp' | 'ttfb' | 'long_task' | 'navigation' | 'resource_timing';
+    value: number;
+    unit: 'ms' | 'score';
+    rating?: 'good' | 'needs_improvement' | 'poor';
+    navigationType?: string;
+    attribution?: JSONObject;
+}
+export interface NetworkPayload {
+    request: {
+        method: string;
+        url: string;
+    };
+    response?: {
+        status: number;
+    };
+    timing: {
+        start: number;
+        duration: number;
+    };
+    initiator: 'fetch' | 'xhr' | 'resource';
+    success: boolean;
+}
+export interface InteractionPayload {
+    target?: {
+        tag?: string;
+        id?: string;
+        role?: string;
+        selector?: string;
+        monitorId?: string;
+    };
+    coordinates?: {
+        x: number;
+        y: number;
+    };
+}
+export interface CustomEventPayload {
+    properties: JSONObject;
+}
+export interface SessionPayload {
+    action: 'start' | 'end';
+    duration?: number;
+}
+export interface PagePayload {
+    action: 'view' | 'route_change' | 'leave';
+    from?: string;
+    to?: string;
+}
+export interface EventPayloadByType {
+    session: SessionPayload;
+    page: PagePayload;
+    error: ErrorPayload;
+    performance: PerformancePayload;
+    network: NetworkPayload;
+    interaction: InteractionPayload;
+    custom: CustomEventPayload;
+}
+type SpectroEventOfType<TType extends EventType> = {
+    id: string;
+    type: TType;
+    name: string;
+    version: typeof EVENT_VERSION;
+    timestamp: number;
+    context: EventContext;
+    payload: EventPayloadByType[TType];
+};
+export type SpectroEvent<TType extends EventType = EventType> = TType extends EventType ? SpectroEventOfType<TType> : never;
+export interface EventEnvelopeItem {
+    type: 'event';
+    payload: SpectroEvent;
+}
+export interface Envelope {
+    version: typeof ENVELOPE_VERSION;
+    sentAt: number;
+    items: EventEnvelopeItem[];
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/src/types.js

@@ -0,0 +1,8 @@
+export const EVENT_VERSION = 1;
+export const ENVELOPE_VERSION = 1;
+export const EVENT_NAME_PATTERN = /^[a-z][a-z0-9_]{0,63}$/;
+export const MAX_EVENT_BYTES = 64 * 1024;
+export const MAX_ENVELOPE_BYTES = 1024 * 1024;
+export const MAX_JSON_DEPTH = 5;
+export const MAX_ENVELOPE_STRUCTURE_DEPTH = 16;
+//# sourceMappingURL=types.js.map

package/dist/src/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAU,CAAC;AACxC,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAU,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,wBAAwB,CAAC;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,EAAE,GAAG,IAAI,CAAC;AACzC,MAAM,CAAC,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC;AAChC,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC"}

package/dist/src/validation.d.ts

@@ -0,0 +1,18 @@
+import type { Envelope, SpectroEvent } from './types.js';
+export interface ValidationIssue {
+    path: string;
+    keyword: string;
+    message: string;
+}
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    issues: ValidationIssue[];
+};
+export declare function validateEvent(input: unknown): ValidationResult<SpectroEvent>;
+export declare function validateEnvelope(input: unknown): ValidationResult<Envelope>;
+export declare function serializedByteLength(value: unknown): number;
+export declare function isJsonDepthWithin(value: unknown, maxDepth: number, depth?: number): boolean;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAGzD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,eAAe,EAAE,CAAA;CAAE,CAAC;AA8DlD,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAU5E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAa3E;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,CA0BtF"}

package/dist/src/validation.js

@@ -0,0 +1,109 @@
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import commonSchema from '../schemas/common.schema.json' with { type: 'json' };
+import customSchema from '../schemas/custom.schema.json' with { type: 'json' };
+import envelopeSchema from '../schemas/envelope.schema.json' with { type: 'json' };
+import errorSchema from '../schemas/error.schema.json' with { type: 'json' };
+import eventSchema from '../schemas/event.schema.json' with { type: 'json' };
+import interactionSchema from '../schemas/interaction.schema.json' with { type: 'json' };
+import networkSchema from '../schemas/network.schema.json' with { type: 'json' };
+import pageSchema from '../schemas/page.schema.json' with { type: 'json' };
+import performanceSchema from '../schemas/performance.schema.json' with { type: 'json' };
+import sessionSchema from '../schemas/session.schema.json' with { type: 'json' };
+import { MAX_ENVELOPE_STRUCTURE_DEPTH, MAX_JSON_DEPTH } from './types.js';
+const ajv = new Ajv2020({ allErrors: true, strict: true });
+for (const schema of [
+    commonSchema,
+    customSchema,
+    errorSchema,
+    performanceSchema,
+    networkSchema,
+    interactionSchema,
+    sessionSchema,
+    pageSchema,
+    eventSchema,
+    envelopeSchema,
+]) {
+    ajv.addSchema(schema);
+}
+const eventValidator = ajv.getSchema(eventSchema.$id);
+const envelopeValidator = ajv.getSchema(envelopeSchema.$id);
+function toIssues(errors) {
+    return (errors ?? []).map((error) => ({
+        path: error.instancePath || '/',
+        keyword: error.keyword,
+        message: error.message ?? 'is invalid',
+    }));
+}
+function runValidation(validator, input) {
+    if (validator(input)) {
+        return { success: true, data: input };
+    }
+    return { success: false, issues: toIssues(validator.errors) };
+}
+function maxDepthIssue(message) {
+    return {
+        success: false,
+        issues: [{ path: '/', keyword: 'maxDepth', message }],
+    };
+}
+function recursiveJsonFieldsAreBounded(event) {
+    if (event.context.user?.traits && !isJsonDepthWithin(event.context.user.traits, MAX_JSON_DEPTH)) {
+        return false;
+    }
+    if (event.type === 'custom' && !isJsonDepthWithin(event.payload.properties, MAX_JSON_DEPTH)) {
+        return false;
+    }
+    if (event.type === 'performance' &&
+        event.payload.attribution &&
+        !isJsonDepthWithin(event.payload.attribution, MAX_JSON_DEPTH)) {
+        return false;
+    }
+    return true;
+}
+export function validateEvent(input) {
+    if (!isJsonDepthWithin(input, MAX_ENVELOPE_STRUCTURE_DEPTH)) {
+        return maxDepthIssue('exceeds the maximum structural depth');
+    }
+    const result = runValidation(eventValidator, input);
+    if (result.success && !recursiveJsonFieldsAreBounded(result.data)) {
+        return maxDepthIssue(`contains a recursive JSON field deeper than ${MAX_JSON_DEPTH}`);
+    }
+    return result;
+}
+export function validateEnvelope(input) {
+    if (!isJsonDepthWithin(input, MAX_ENVELOPE_STRUCTURE_DEPTH)) {
+        return maxDepthIssue('exceeds the maximum structural depth');
+    }
+    const result = runValidation(envelopeValidator, input);
+    if (result.success &&
+        result.data.items.some((item) => !recursiveJsonFieldsAreBounded(item.payload))) {
+        return maxDepthIssue(`contains a recursive JSON field deeper than ${MAX_JSON_DEPTH}`);
+    }
+    return result;
+}
+export function serializedByteLength(value) {
+    return new TextEncoder().encode(JSON.stringify(value)).byteLength;
+}
+export function isJsonDepthWithin(value, maxDepth, depth = 0) {
+    const pending = [{ depth, value }];
+    const seen = new WeakSet();
+    while (pending.length > 0) {
+        const current = pending.pop();
+        if (!current || current.value === null || typeof current.value !== 'object') {
+            continue;
+        }
+        if (seen.has(current.value)) {
+            return false;
+        }
+        seen.add(current.value);
+        const children = Object.values(current.value);
+        if (current.depth >= maxDepth && children.length > 0) {
+            return false;
+        }
+        for (const child of children) {
+            pending.push({ depth: current.depth + 1, value: child });
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=validation.js.map

package/dist/src/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/validation.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,42 @@
 {
   "name": "@spectro/protocol",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0-alpha.0",
+  "homepage": "https://github.com/spectro-hq/spectro/tree/main/packages/protocol",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/spectro-hq/spectro.git",
+    "directory": "packages/protocol"
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "!dist/.tsbuildinfo"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "import": "./dist/src/index.js"
+    },
+    "./schemas/*": "./dist/schemas/*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/",
+    "tag": "alpha"
+  },
+  "dependencies": {
+    "ajv": "^8.17.1"
+  },
+  "devDependencies": {
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "check": "tsc -b --pretty false && tsc -p tsconfig.check.json --pretty false",
+    "test": "vitest run --exclude 'dist/**'"
+  }
 }