@q9labsai/chalk-client 4.0.0

package/dist/telemetry/index.js

@@ -0,0 +1,48 @@
+import {
+  CHALK_JOURNEY_ID_HEADER,
+  TELEMETRY_EVENT_VERSION,
+  TRACEPARENT_HEADER,
+  TRACESTATE_HEADER,
+  TelemetryClient,
+  TelemetryJourney,
+  createBrowserRuntimeTelemetryStorage,
+  createBrowserTelemetryStorage,
+  createJourneyIntakeExporter,
+  createKeyValueTelemetryStorage,
+  createMemoryTelemetryStorage,
+  createTelemetryClient,
+  createTraceContext,
+  journeyHeaders,
+  parseTraceparent,
+  rtcSummaryAttributes,
+  summarizeRtcStats,
+  toJourneyIntakeEvent,
+  traceContextFromJourney
+} from "../chunk-QVHR3RMB.js";
+import {
+  syncTelemetryCorrelation,
+  withSyncTelemetryCorrelation
+} from "../chunk-PBSYXPNJ.js";
+export {
+  CHALK_JOURNEY_ID_HEADER,
+  TELEMETRY_EVENT_VERSION,
+  TRACEPARENT_HEADER,
+  TRACESTATE_HEADER,
+  TelemetryClient,
+  TelemetryJourney,
+  createBrowserRuntimeTelemetryStorage,
+  createBrowserTelemetryStorage,
+  createJourneyIntakeExporter,
+  createKeyValueTelemetryStorage,
+  createMemoryTelemetryStorage,
+  createTelemetryClient,
+  createTraceContext,
+  journeyHeaders,
+  parseTraceparent,
+  rtcSummaryAttributes,
+  summarizeRtcStats,
+  syncTelemetryCorrelation,
+  toJourneyIntakeEvent,
+  traceContextFromJourney,
+  withSyncTelemetryCorrelation
+};

package/dist/telemetry/journey.d.ts

@@ -0,0 +1,52 @@
+import { type RtcConnectionStateSnapshot, type RtcStatsLike } from "./rtc";
+import type { TelemetryAttributeNormalizationOptions } from "./attributes";
+import type { JourneyPhase, JourneyState, JourneyTelemetryContext, TelemetryAttributes, TelemetryEvent, TelemetryEventDraft } from "./types";
+export type StartJourneyOptions = {
+    readonly attributes?: TelemetryAttributes;
+    readonly journeyId?: string;
+    readonly kind: string;
+    readonly parent?: TelemetryJourney;
+    readonly traceparent?: string;
+    readonly tracestate?: string;
+};
+export type HttpRequestObservation = {
+    readonly durationMs?: number;
+    readonly method: string;
+    readonly route: string;
+    readonly statusCode?: number;
+    readonly state?: Extract<JourneyState, "failed" | "observed" | "succeeded">;
+};
+export type SyncFrameObservation = {
+    readonly direction: "client_to_server" | "server_to_client";
+    readonly frameType: string;
+    readonly state?: Extract<JourneyState, "failed" | "observed" | "succeeded">;
+};
+export type DiagnosticObservation = {
+    readonly category: "connection" | "device" | "episode" | "network" | "permission" | "recovery" | "whiteboard_renderer";
+    readonly code: string;
+    readonly attributes?: TelemetryAttributes;
+    readonly metricValue?: number;
+    readonly phase?: JourneyPhase;
+    readonly state?: Extract<JourneyState, "failed" | "observed" | "succeeded">;
+};
+export type JourneyTelemetryHost = {
+    emit(context: JourneyTelemetryContext, sequence: number, draft: TelemetryEventDraft, options?: TelemetryAttributeNormalizationOptions): TelemetryEvent;
+    startJourney(options: StartJourneyOptions): TelemetryJourney;
+};
+export declare class TelemetryJourney {
+    #private;
+    readonly context: JourneyTelemetryContext;
+    constructor(telemetry: JourneyTelemetryHost, context: JourneyTelemetryContext);
+    get headers(): Record<string, string>;
+    phase(phase: Exclude<JourneyPhase, "root" | "terminal">, attributes?: TelemetryAttributes): TelemetryEvent | undefined;
+    terminal(state: Extract<JourneyState, "cancelled" | "failed" | "succeeded">, attributes?: TelemetryAttributes): TelemetryEvent;
+    recordHttpRequest(observation: HttpRequestObservation): TelemetryEvent | undefined;
+    recordSyncFrame(observation: SyncFrameObservation): TelemetryEvent | undefined;
+    recordRtcSummary(connection: RtcConnectionStateSnapshot, stats: Iterable<RtcStatsLike>, state?: Extract<JourneyState, "failed" | "observed" | "succeeded">): TelemetryEvent | undefined;
+    recordDiagnostic(observation: DiagnosticObservation): TelemetryEvent | undefined;
+    startChild(options: Omit<StartJourneyOptions, "parent">): TelemetryJourney;
+    record(draft: TelemetryEventDraft, options?: TelemetryAttributeNormalizationOptions): TelemetryEvent;
+    linkChild(child: JourneyTelemetryContext): string;
+    start(kind: string, attributes: TelemetryAttributes | undefined, parentEventId: string | undefined): void;
+}
+//# sourceMappingURL=journey.d.ts.map

package/dist/telemetry/journey.d.ts.map

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

package/dist/telemetry/random.d.ts

@@ -0,0 +1,18 @@
+import { Context, Layer } from "effect";
+type TelemetryRandom = {
+    readonly nextIntUnsafe: () => number;
+};
+export type TelemetryEventSource = {
+    readonly createUuid: () => string;
+    readonly now: () => Date;
+    readonly randomHex: (byteLength: number) => string;
+};
+declare const TelemetryEventSourceService_base: Context.ServiceClass<TelemetryEventSourceService, "@chalk/telemetry/TelemetryEventSource", TelemetryEventSource>;
+export declare class TelemetryEventSourceService extends TelemetryEventSourceService_base {
+}
+/** Uses Effect's production Clock and Random services, while retaining the public `now` override. */
+export declare const makeTelemetryEventSourceLayer: (now?: () => Date) => Layer.Layer<TelemetryEventSourceService, never, never>;
+export declare function randomHex(byteLength: number, random?: TelemetryRandom): string;
+export declare function createUuid(random?: TelemetryRandom): string;
+export {};
+//# sourceMappingURL=random.d.ts.map

package/dist/telemetry/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/telemetry/random.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,OAAO,EAAU,KAAK,EAAU,MAAM,QAAQ,CAAC;AAE/D,KAAK,eAAe,GAAG;IACrB,QAAQ,CAAC,aAAa,EAAE,MAAM,MAAM,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,UAAU,EAAE,MAAM,MAAM,CAAC;IAClC,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;CACpD,CAAC;;AAEF,qBAAa,2BAA4B,SAAQ,gCAA6G;CAAG;AAEjK,qGAAqG;AACrG,eAAO,MAAM,6BAA6B,SAAU,MAAM,IAAI,2DAY3D,CAAC;AAEJ,wBAAgB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAE,eAA+C,GAAG,MAAM,CAE7G;AAED,wBAAgB,UAAU,CAAC,MAAM,GAAE,eAA+C,GAAG,MAAM,CAM1F"}

package/dist/telemetry/rtc.d.ts

@@ -0,0 +1,35 @@
+import type { TelemetryAttributes } from "./types";
+export type RtcConnectionStateSnapshot = {
+    readonly connectionState?: string;
+    readonly iceConnectionState?: string;
+    readonly signalingState?: string;
+};
+export type RtcStatsLike = {
+    readonly type?: string;
+    readonly kind?: string;
+    readonly bytesReceived?: number;
+    readonly bytesSent?: number;
+    readonly framesDropped?: number;
+    readonly jitter?: number;
+    readonly packetsLost?: number;
+    readonly packetsReceived?: number;
+    readonly packetsSent?: number;
+    readonly roundTripTime?: number;
+};
+export type RtcStatsSummary = {
+    readonly bytesReceived: number;
+    readonly bytesSent: number;
+    readonly framesDropped: number;
+    readonly inboundStreams: number;
+    readonly jitterMs?: number;
+    readonly outboundStreams: number;
+    readonly packetsLost: number;
+    readonly packetsReceived: number;
+    readonly packetsSent: number;
+    readonly roundTripTimeMs?: number;
+    readonly transportEntries: number;
+};
+export declare function summarizeRtcStats(stats: Iterable<RtcStatsLike>): RtcStatsSummary;
+/** Produces only connection states and aggregated counters. Raw SDP, candidates, tracks, and media content are intentionally excluded. */
+export declare function rtcSummaryAttributes(connection: RtcConnectionStateSnapshot, stats: Iterable<RtcStatsLike>): TelemetryAttributes;
+//# sourceMappingURL=rtc.d.ts.map

package/dist/telemetry/rtc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rtc.d.ts","sourceRoot":"","sources":["../../src/telemetry/rtc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD,MAAM,MAAM,0BAA0B,GAAG;IACvC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC,CAAC;AAgBF,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,eAAe,CAoBhF;AAED,0IAA0I;AAC1I,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,0BAA0B,EAAE,KAAK,EAAE,QAAQ,CAAC,YAAY,CAAC,GAAG,mBAAmB,CAkB/H"}

package/dist/telemetry/storage.d.ts

@@ -0,0 +1,22 @@
+import type { TelemetryEvent } from "./types";
+export interface TelemetryStorage {
+    load(): Promise<readonly TelemetryEvent[]>;
+    save(events: readonly TelemetryEvent[]): Promise<void>;
+}
+export interface TelemetryKeyValueStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+}
+export declare function createMemoryTelemetryStorage(initialEvents?: readonly TelemetryEvent[]): TelemetryStorage;
+/** Adapts browser storage, Expo storage, or another platform key-value store without adding a platform dependency. */
+export declare function createKeyValueTelemetryStorage(storage: TelemetryKeyValueStorage, key?: string): TelemetryStorage;
+export declare function createBrowserTelemetryStorage(key?: string): TelemetryStorage | undefined;
+/**
+ * Creates a durable localStorage queue with a unique runtime key.
+ *
+ * Each runtime preserves its own queue and adopts sibling queues when it starts.
+ * This avoids cross-tab overwrites while allowing a later tab to recover journeys
+ * left behind by a closed tab.
+ */
+export declare function createBrowserRuntimeTelemetryStorage(keyPrefix?: string): TelemetryStorage | undefined;
+//# sourceMappingURL=storage.d.ts.map

package/dist/telemetry/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/telemetry/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,IAAI,OAAO,CAAC,SAAS,cAAc,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACxD;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC7C,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AASD,wBAAgB,4BAA4B,CAAC,aAAa,GAAE,SAAS,cAAc,EAAO,GAAG,gBAAgB,CAW5G;AAED,sHAAsH;AACtH,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,wBAAwB,EAAE,GAAG,SAAuB,GAAG,gBAAgB,CAc9H;AAED,wBAAgB,6BAA6B,CAAC,GAAG,SAAuB,GAAG,gBAAgB,GAAG,SAAS,CAetG;AAED;;;;;;GAMG;AACH,wBAAgB,oCAAoC,CAAC,SAAS,SAAuB,GAAG,gBAAgB,GAAG,SAAS,CAenH"}

package/dist/telemetry/sync.d.ts

@@ -0,0 +1,10 @@
+import type { JourneyTelemetryContext } from "./types";
+export type SyncTelemetryCorrelation = {
+    readonly journey_id: string;
+    readonly traceparent: string;
+    readonly tracestate?: string;
+};
+/** Adds the v1 optional correlation fields accepted by the sync hello frame without changing application frame fields. */
+export declare function withSyncTelemetryCorrelation<TFrame extends object>(frame: TFrame, context: JourneyTelemetryContext): TFrame & SyncTelemetryCorrelation;
+export declare function syncTelemetryCorrelation(context: JourneyTelemetryContext): SyncTelemetryCorrelation;
+//# sourceMappingURL=sync.d.ts.map

package/dist/telemetry/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../src/telemetry/sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAQvD,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAOF,0HAA0H;AAC1H,wBAAgB,4BAA4B,CAAC,MAAM,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,uBAAuB,GAAG,MAAM,GAAG,wBAAwB,CAOtJ;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,uBAAuB,GAAG,wBAAwB,CAEnG"}

package/dist/telemetry/test-support.d.ts

@@ -0,0 +1,51 @@
+import { Effect, Layer } from "effect";
+import { TelemetryExporterService, TelemetryStorageService, type TelemetryDeliveryEffectService, type TelemetryDeliveryOptions } from "./delivery";
+import type { TelemetryExporter, TelemetryExportOptions } from "./exporter";
+import type { TelemetryEvent } from "./types";
+export type RecordedExport = {
+    readonly events: readonly {
+        readonly event_id: string;
+        readonly name: string;
+        readonly journey_id: string;
+    }[];
+    readonly options?: TelemetryExportOptions;
+};
+export type ScriptedExporter = {
+    readonly calls: RecordedExport[];
+    readonly layer: Layer.Layer<TelemetryExporterService>;
+    failNext(cause: unknown, retriable: boolean): void;
+    waitNext(next?: "succeed" | {
+        readonly cause: unknown;
+        readonly retriable: boolean;
+    }): () => void;
+};
+export declare function makeScriptedExporter(): ScriptedExporter;
+export type ScriptedStorage = {
+    readonly saves: readonly (readonly TelemetryEvent[])[];
+    readonly layer: Layer.Layer<TelemetryStorageService>;
+    resolveLoad(events: readonly TelemetryEvent[]): void;
+};
+export declare function makeScriptedStorage(options?: {
+    readonly load?: readonly TelemetryEvent[];
+    readonly waitForLoad?: boolean;
+}): ScriptedStorage;
+export type DeferredFacadeExport = {
+    release(): void;
+    started(): Promise<void>;
+};
+export type DeferredFacadeExporter = {
+    readonly calls: RecordedExport[];
+    readonly exporter: TelemetryExporter;
+    holdNext(): DeferredFacadeExport;
+};
+export declare function makeDeferredFacadeExporter(): DeferredFacadeExporter;
+export type DeliveryHarness = {
+    readonly delivery: TelemetryDeliveryEffectService;
+    adjust(duration: number): Promise<void>;
+    ready(): Promise<void>;
+    run<A, E>(effect: Effect.Effect<A, E>): Promise<A>;
+    settle(): Promise<void>;
+    dispose(): Promise<void>;
+};
+export declare function makeDeliveryHarness(options: Omit<TelemetryDeliveryOptions, "exporter" | "storage">, exporter?: ScriptedExporter, storage?: ScriptedStorage): DeliveryHarness;
+//# sourceMappingURL=test-support.d.ts.map

package/dist/telemetry/test-support.d.ts.map

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

package/dist/telemetry/trace.d.ts

@@ -0,0 +1,18 @@
+import type { JourneyTelemetryContext } from "./types";
+export declare const CHALK_JOURNEY_ID_HEADER = "x-chalk-journey-id";
+export declare const TRACEPARENT_HEADER = "traceparent";
+export declare const TRACESTATE_HEADER = "tracestate";
+export type TraceContext = {
+    readonly traceId: string;
+    readonly spanId: string;
+    readonly traceFlags: string;
+    readonly traceparent: string;
+    readonly tracestate?: string;
+};
+type ParsedTraceparent = Omit<TraceContext, "traceparent" | "tracestate">;
+export declare function createTraceContext(parentTraceparent?: string, tracestate?: string): TraceContext;
+export declare function parseTraceparent(value: string | undefined): ParsedTraceparent | undefined;
+export declare function journeyHeaders(context: JourneyTelemetryContext): Record<string, string>;
+export declare function traceContextFromJourney(context: JourneyTelemetryContext): TraceContext;
+export {};
+//# sourceMappingURL=trace.d.ts.map

package/dist/telemetry/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../src/telemetry/trace.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGvD,eAAO,MAAM,uBAAuB,uBAAuB,CAAC;AAC5D,eAAO,MAAM,kBAAkB,gBAAgB,CAAC;AAChD,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,iBAAiB,GAAG,IAAI,CAAC,YAAY,EAAE,aAAa,GAAG,YAAY,CAAC,CAAC;AAI1E,wBAAgB,kBAAkB,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,YAAY,CAahG;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,iBAAiB,GAAG,SAAS,CAMzF;AAgBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAMvF;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,uBAAuB,GAAG,YAAY,CAWtF"}

package/dist/telemetry/types.d.ts

@@ -0,0 +1,109 @@
+export declare const TELEMETRY_EVENT_VERSION: 1;
+export type TelemetryAttributeValue = boolean | number | string;
+export type TelemetryAttributes = Readonly<Record<string, TelemetryAttributeValue>>;
+export type JourneyPhase = "root" | "authentication" | "signaling" | "media" | "recovery" | "terminal";
+export type JourneyState = "started" | "in_progress" | "succeeded" | "failed" | "cancelled" | "observed";
+export type TelemetryOriginKind = "client" | "diagnostic" | "http" | "rtc" | "sync";
+export type TelemetryUpstreamVisibility = "local" | "propagated";
+export type TelemetryEventBase = {
+    readonly version: typeof TELEMETRY_EVENT_VERSION;
+    readonly event_id: string;
+    readonly journey_id: string;
+    readonly sequence: number;
+    readonly occurred_at: string;
+    readonly phase: JourneyPhase;
+    readonly state: JourneyState;
+    readonly origin_kind: TelemetryOriginKind;
+    readonly first_observed_layer: TelemetryOriginKind;
+    readonly upstream_visibility: TelemetryUpstreamVisibility;
+    readonly parent_event_id?: string;
+    readonly trace_id?: string;
+    readonly span_id?: string;
+    readonly traceparent?: string;
+    readonly tracestate?: string;
+    readonly attributes?: TelemetryAttributes;
+};
+export type JourneyStartedEvent = TelemetryEventBase & {
+    readonly name: "journey.started";
+    readonly phase: "root";
+    readonly state: "started";
+    readonly origin_kind: "client";
+};
+export type JourneyPhaseEvent = TelemetryEventBase & {
+    readonly name: "journey.phase";
+    readonly phase: Exclude<JourneyPhase, "root" | "terminal">;
+    readonly state: "in_progress" | "observed";
+    readonly origin_kind: "client";
+};
+export type JourneyTerminalEvent = TelemetryEventBase & {
+    readonly name: "journey.terminal";
+    readonly phase: "terminal";
+    readonly state: "succeeded" | "failed" | "cancelled";
+    readonly origin_kind: "client";
+};
+export type JourneyLinkedEvent = TelemetryEventBase & {
+    readonly name: "journey.linked";
+    readonly phase: "root";
+    readonly state: "observed";
+    readonly origin_kind: "client";
+    readonly parent_event_id: string;
+};
+export type HttpRequestTelemetryEvent = TelemetryEventBase & {
+    readonly name: "http.request";
+    readonly origin_kind: "http";
+};
+export type SyncFrameTelemetryEvent = TelemetryEventBase & {
+    readonly name: "sync.frame";
+    readonly origin_kind: "sync";
+};
+export type RtcSummaryTelemetryEvent = TelemetryEventBase & {
+    readonly name: "rtc.summary";
+    readonly origin_kind: "rtc";
+};
+export type DiagnosticTimelineTelemetryEvent = TelemetryEventBase & {
+    readonly name: "diagnostic.timeline";
+    readonly origin_kind: "diagnostic";
+};
+/** A stable, versioned client event union. Exporters remove only `version`, because the v1 intake path carries the API version. */
+export type TelemetryEvent = DiagnosticTimelineTelemetryEvent | HttpRequestTelemetryEvent | JourneyLinkedEvent | JourneyPhaseEvent | JourneyStartedEvent | JourneyTerminalEvent | RtcSummaryTelemetryEvent | SyncFrameTelemetryEvent;
+export type TelemetryEventName = TelemetryEvent["name"];
+type TelemetryEventDraftFor<TEvent extends TelemetryEvent> = TEvent extends TelemetryEvent ? Pick<TEvent, "name" | "origin_kind" | "phase" | "state"> & {
+    readonly first_observed_layer?: TelemetryOriginKind;
+    readonly upstream_visibility?: TelemetryUpstreamVisibility;
+    readonly attributes?: TelemetryAttributes;
+} & (TEvent extends {
+    readonly parent_event_id: string;
+} ? Pick<TEvent, "parent_event_id"> : {
+    readonly parent_event_id?: string;
+}) : never;
+export type TelemetryEventDraft = TelemetryEventDraftFor<TelemetryEvent>;
+export type JourneyTelemetryContext = {
+    readonly journeyId: string;
+    readonly rootJourneyId: string;
+    readonly traceparent: string;
+    readonly tracestate?: string;
+};
+export type JourneyIntakeEvent = {
+    readonly event_id: string;
+    readonly journey_id: string;
+    readonly sequence: number;
+    readonly occurred_at: string;
+    readonly name: TelemetryEventName;
+    readonly phase: JourneyPhase;
+    readonly state: JourneyState;
+    readonly origin_kind: TelemetryOriginKind;
+    readonly first_observed_layer: TelemetryOriginKind;
+    readonly upstream_visibility: TelemetryUpstreamVisibility;
+    readonly parent_event_id?: string;
+    readonly trace_id?: string;
+    readonly span_id?: string;
+    readonly traceparent?: string;
+    readonly tracestate?: string;
+    readonly attributes?: TelemetryAttributes;
+};
+export type JourneyIntakeResponse = {
+    readonly accepted_count: number;
+    readonly duplicate_count: number;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/webhooks/chunk-UNMJZNTZ.js

@@ -0,0 +1,31 @@
+// src/webhooks/errors.ts
+var messages = {
+  missing_headers: "Required webhook headers are missing.",
+  malformed_headers: "Webhook headers are malformed.",
+  invalid_secret: "A webhook signing secret is invalid.",
+  stale_timestamp: "The webhook timestamp is outside the allowed tolerance.",
+  invalid_signature: "The webhook signature is invalid.",
+  invalid_json: "The webhook body is not valid JSON.",
+  identifier_mismatch: "The webhook identifiers do not match.",
+  unsupported_api_version: "The webhook API version is unsupported.",
+  invalid_event_body: "The webhook Event body is invalid."
+};
+var WebhookVerificationError = class extends Error {
+  code;
+  constructor(code) {
+    super(messages[code]);
+    this.name = "WebhookVerificationError";
+    this.code = code;
+  }
+};
+var WebhookServerOnlyError = class extends Error {
+  constructor() {
+    super("Chalk webhook receivers are available only in server and edge runtimes.");
+    this.name = "WebhookServerOnlyError";
+  }
+};
+
+export {
+  WebhookVerificationError,
+  WebhookServerOnlyError
+};

package/dist/webhooks/errors.d.cts

@@ -0,0 +1,8 @@
+export type WebhookErrorCode = "missing_headers" | "malformed_headers" | "invalid_secret" | "stale_timestamp" | "invalid_signature" | "invalid_json" | "identifier_mismatch" | "unsupported_api_version" | "invalid_event_body";
+export declare class WebhookVerificationError extends Error {
+    readonly code: WebhookErrorCode;
+    constructor(code: WebhookErrorCode);
+}
+export declare class WebhookServerOnlyError extends Error {
+    constructor();
+}

package/dist/webhooks/errors.d.ts

@@ -0,0 +1,9 @@
+export type WebhookErrorCode = "missing_headers" | "malformed_headers" | "invalid_secret" | "stale_timestamp" | "invalid_signature" | "invalid_json" | "identifier_mismatch" | "unsupported_api_version" | "invalid_event_body";
+export declare class WebhookVerificationError extends Error {
+    readonly code: WebhookErrorCode;
+    constructor(code: WebhookErrorCode);
+}
+export declare class WebhookServerOnlyError extends Error {
+    constructor();
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/webhooks/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/webhooks/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,mBAAmB,GAAG,cAAc,GAAG,qBAAqB,GAAG,yBAAyB,GAAG,oBAAoB,CAAC;AAchO,qBAAa,wBAAyB,SAAQ,KAAK;IACjD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAEhC,YAAY,IAAI,EAAE,gBAAgB,EAIjC;CACF;AAED,qBAAa,sBAAuB,SAAQ,KAAK;IAC/C,cAGC;CACF"}