@abto-app/event 0.1.0

package/dist/context.js

@@ -0,0 +1,146 @@
+/**
+ * Browser identifier context.
+ *
+ * Gateway-aligned identifier model:
+ * - node_key: "feature.node" dot-notation dimension (e.g. "resume.make"); feature is the prefix.
+ * - trace_id: one user action/task execution. Carried as W3C `traceparent`.
+ * - request_id: gateway-issued call PK (returned as `x-request-id`); the call-instance join key.
+ *   The browser does not mint call ids; per-call correlation uses the gateway `request_id`.
+ */
+import { BrowserIdentityStore } from './identity.js';
+import { newUuidV7, newUuidV7TraceId, randomHex } from './uuid.js';
+/** 32-hex-character W3C-compatible trace id. */
+export function newTraceId() {
+    return newUuidV7TraceId();
+}
+export function newSpanId() {
+    return randomHex(8);
+}
+/** Build a W3C `traceparent` value for the given trace id. */
+export function toTraceparent(traceId, spanId = newSpanId()) {
+    return `00-${traceId}-${spanId}-01`;
+}
+/** Client-side id for an emitted event (dedup / ordering only — not a join key). */
+export function newEventId() {
+    return newUuidV7();
+}
+export class ContextStore {
+    constructor(options) {
+        this.identity = new BrowserIdentityStore(options);
+        this.state = {
+            userId: undefined,
+            tenantId: undefined,
+            pageviewId: newUuidV7(),
+            nodeId: undefined,
+            traceId: undefined,
+            taskType: undefined,
+            surface: undefined,
+            entryPoint: undefined,
+            conversationId: undefined,
+            messageId: undefined,
+            promptTemplateId: undefined,
+        };
+    }
+    identify(userId, tenantId) {
+        this.state.userId = userId;
+        this.state.tenantId = tenantId;
+    }
+    reset() {
+        this.clearScopedContext();
+        this.identity.resetSession();
+        this.state.pageviewId = newUuidV7();
+    }
+    forgetDevice() {
+        this.clearScopedContext();
+        this.identity.forgetDevice();
+        this.state.pageviewId = newUuidV7();
+    }
+    clearScopedContext() {
+        this.state.userId = undefined;
+        this.state.tenantId = undefined;
+        this.state.nodeId = undefined;
+        this.state.traceId = undefined;
+        this.state.taskType = undefined;
+        this.state.surface = undefined;
+        this.state.entryPoint = undefined;
+        this.state.conversationId = undefined;
+        this.state.messageId = undefined;
+        this.state.promptTemplateId = undefined;
+    }
+    newPageview() {
+        this.state.pageviewId = newUuidV7();
+        return this.state.pageviewId;
+    }
+    /** Set the "feature.node" node id (e.g. "resume.make"). */
+    setNode(nodeId) {
+        this.state.nodeId = nodeId;
+    }
+    newTrace() {
+        this.state.traceId = newTraceId();
+        return this.state.traceId;
+    }
+    startLlmTrace(options) {
+        this.state.nodeId = options.nodeId;
+        this.state.traceId = options.traceId ?? newTraceId();
+        this.state.taskType = options.taskType;
+        this.state.surface = options.surface;
+        this.state.entryPoint = options.entryPoint;
+        this.state.conversationId = options.conversationId;
+        this.state.messageId = options.messageId;
+        this.state.promptTemplateId = options.promptTemplateId;
+        return { ...options, traceId: this.state.traceId };
+    }
+    get traceId() {
+        return this.state.traceId;
+    }
+    getIdentity() {
+        return this.identity.current();
+    }
+    getTraceHeaders(overrides = {}) {
+        const nodeId = overrides.node_key ?? this.state.nodeId;
+        const traceId = overrides.trace_id ?? this.state.traceId;
+        const headers = {};
+        headers['x-abto-device-id'] = this.identity.current().deviceId;
+        if (this.state.userId)
+            headers['x-abto-user-id'] = this.state.userId;
+        if (nodeId)
+            headers['x-abto-node-key'] = nodeId;
+        if (traceId) {
+            headers['x-abto-trace-id'] = traceId;
+            headers.traceparent = toTraceparent(traceId);
+        }
+        return headers;
+    }
+    toCommonProperties() {
+        const identity = this.identity.current();
+        const common = {
+            device_id: identity.deviceId,
+            anonymous_id: identity.anonymousId,
+            session_id: identity.sessionId,
+            window_id: identity.windowId,
+            pageview_id: this.state.pageviewId,
+        };
+        if (this.state.userId)
+            common.user_id = this.state.userId;
+        if (this.state.tenantId)
+            common.tenant_id = this.state.tenantId;
+        if (this.state.nodeId)
+            common.node_key = this.state.nodeId;
+        if (this.state.traceId)
+            common.trace_id = this.state.traceId;
+        if (this.state.taskType)
+            common.task_type = this.state.taskType;
+        if (this.state.surface)
+            common.surface = this.state.surface;
+        if (this.state.entryPoint)
+            common.entry_point = this.state.entryPoint;
+        if (this.state.conversationId)
+            common.conversation_id = this.state.conversationId;
+        if (this.state.messageId)
+            common.message_id = this.state.messageId;
+        if (this.state.promptTemplateId)
+            common.prompt_template_id = this.state.promptTemplateId;
+        return common;
+    }
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

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

package/dist/elements-chain.d.ts

@@ -0,0 +1,8 @@
+/**
+ * elements_chain serialization — the backbone for post-hoc analysis without pre-tagging.
+ * Walks an element up its ancestors into `tag.class#id:attr="value"` segments joined by ';'.
+ */
+import type { MaskMode } from './types.js';
+export declare function elementText(el: Element, cap?: number): string;
+export declare function serializeElementsChain(el: Element | null, mask?: MaskMode): string;
+//# sourceMappingURL=elements-chain.d.ts.map

package/dist/elements-chain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"elements-chain.d.ts","sourceRoot":"","sources":["../src/elements-chain.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAS3C,wBAAgB,WAAW,CAAC,EAAE,EAAE,OAAO,EAAE,GAAG,SAAW,GAAG,MAAM,CAO/D;AAiDD,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,EAAE,IAAI,GAAE,QAAgB,GAAG,MAAM,CAYzF"}

package/dist/elements-chain.js

@@ -0,0 +1,84 @@
+/**
+ * elements_chain serialization — the backbone for post-hoc analysis without pre-tagging.
+ * Walks an element up its ancestors into `tag.class#id:attr="value"` segments joined by ';'.
+ */
+import { maskText } from './privacy.js';
+const MAX_DEPTH = 20;
+const TEXT_CAP = 255;
+const HREF_CAP = 2048;
+const CLASS_CAP = 10;
+const CHAIN_CAP = 8192;
+const TEXT_NODE = 3;
+export function elementText(el, cap = TEXT_CAP) {
+    let text = '';
+    for (const node of Array.from(el.childNodes)) {
+        if (node.nodeType === TEXT_NODE)
+            text += node.textContent ?? '';
+    }
+    const normalized = text.trim().replace(/\s+/g, ' ');
+    return normalized.length > cap ? normalized.slice(0, cap) : normalized;
+}
+function nthChild(el) {
+    let position = 1;
+    for (let sibling = el.previousElementSibling; sibling; sibling = sibling.previousElementSibling) {
+        position++;
+    }
+    return position;
+}
+function nthOfType(el) {
+    let position = 1;
+    for (let sibling = el.previousElementSibling; sibling; sibling = sibling.previousElementSibling) {
+        if (sibling.tagName === el.tagName)
+            position++;
+    }
+    return position;
+}
+function escapeAttr(value) {
+    return value.replace(/"/g, '\\"');
+}
+function serializeElement(el, mask) {
+    let head = el.tagName.toLowerCase();
+    const rawMetadataAllowed = mask === 'off';
+    if (rawMetadataAllowed) {
+        const id = el.getAttribute('id');
+        if (id)
+            head += `#${id}`;
+        const classes = (el.getAttribute('class') ?? '').split(/\s+/).filter(Boolean).slice(0, CLASS_CAP);
+        for (const cls of classes)
+            head += `.${cls}`;
+    }
+    const attrs = [];
+    const text = elementText(el);
+    if (text)
+        attrs.push(`text="${escapeAttr(maskText(text, mask))}"`);
+    if (rawMetadataAllowed) {
+        const href = el.getAttribute('href');
+        if (href)
+            attrs.push(`href="${escapeAttr(href.slice(0, HREF_CAP))}"`);
+        const role = el.getAttribute('role');
+        if (role)
+            attrs.push(`role="${escapeAttr(role)}"`);
+        for (const attr of Array.from(el.attributes)) {
+            if (attr.name.startsWith('data-abto-'))
+                attrs.push(`${attr.name}="${escapeAttr(attr.value)}"`);
+        }
+    }
+    attrs.push(`nth-child="${nthChild(el)}"`, `nth-of-type="${nthOfType(el)}"`);
+    return `${head}:${attrs.join(':')}`;
+}
+export function serializeElementsChain(el, mask = 'off') {
+    const segments = [];
+    let node = el;
+    for (let depth = 0; node && depth < MAX_DEPTH; depth++) {
+        const tag = node.tagName.toLowerCase();
+        if (tag === 'html')
+            break;
+        segments.push(serializeElement(node, mask));
+        if (tag === 'body')
+            break;
+        node = node.parentElement;
+    }
+    const chain = segments.join(';');
+    return chain.length > CHAIN_CAP ? chain.slice(0, CHAIN_CAP) : chain;
+}
+//# sourceMappingURL=elements-chain.js.map

package/dist/elements-chain.js.map

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

package/dist/event-registry.d.ts

@@ -0,0 +1,37 @@
+export type CustomPropertyType = 'string' | 'number' | 'boolean';
+export type CustomPropertyScalar = string | number | boolean;
+export interface CustomPropertyDefinition<T extends CustomPropertyType = CustomPropertyType, E extends readonly CustomPropertyScalar[] | undefined = readonly CustomPropertyScalar[] | undefined> {
+    type: T;
+    required?: boolean;
+    enum?: E;
+    description?: string;
+}
+export interface CustomEventDefinition<P extends Record<string, CustomPropertyDefinition> = Record<string, CustomPropertyDefinition>> {
+    description?: string;
+    properties: P;
+}
+export type EventRegistry = Record<string, CustomEventDefinition>;
+type ScalarForType<T extends CustomPropertyType> = T extends 'string' ? string : T extends 'number' ? number : boolean;
+type ValueForDefinition<D extends CustomPropertyDefinition> = D['enum'] extends readonly (infer E)[] ? E : ScalarForType<D['type']>;
+type RequiredPropertyKeys<P extends Record<string, CustomPropertyDefinition>> = {
+    [K in keyof P]-?: P[K]['required'] extends true ? K : never;
+}[keyof P];
+type OptionalPropertyKeys<P extends Record<string, CustomPropertyDefinition>> = Exclude<keyof P, RequiredPropertyKeys<P>>;
+export type InferCustomEventProperties<D extends CustomEventDefinition> = {
+    [K in RequiredPropertyKeys<D['properties']>]: ValueForDefinition<D['properties'][K]>;
+} & {
+    [K in OptionalPropertyKeys<D['properties']>]?: ValueForDefinition<D['properties'][K]>;
+};
+export type CustomEventPayloadMap<R extends EventRegistry> = {
+    [K in keyof R]: InferCustomEventProperties<R[K]>;
+};
+export declare function validateCustomEventName(name: string): string | undefined;
+export declare function defineEvents<const R extends EventRegistry>(registry: R): R;
+export interface EventValidationResult {
+    valid: boolean;
+    issues: string[];
+}
+export declare function validateCustomPropertyNames(properties: Record<string, unknown>): string[];
+export declare function validateEventProperties(definition: CustomEventDefinition, properties: Record<string, unknown>): EventValidationResult;
+export {};
+//# sourceMappingURL=event-registry.d.ts.map

package/dist/event-registry.d.ts.map

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

package/dist/event-registry.js

@@ -0,0 +1,59 @@
+import { ABTO_EVENT_NAME_MAX_LENGTH, BROWSER_SYSTEM_EVENT_WIRE_NAMES, } from './system-events.generated.js';
+const SYSTEM_EVENT_WIRE_NAMES = new Set(Object.values(BROWSER_SYSTEM_EVENT_WIRE_NAMES));
+export function validateCustomEventName(name) {
+    if (name.trim() === '')
+        return 'must not be empty';
+    if (name.includes('\u0000'))
+        return 'must not contain U+0000';
+    if (name.startsWith('$'))
+        return 'is reserved; $ names belong to ABTO';
+    if (name.length > ABTO_EVENT_NAME_MAX_LENGTH) {
+        return `must be at most ${ABTO_EVENT_NAME_MAX_LENGTH} UTF-16 code units`;
+    }
+    if (SYSTEM_EVENT_WIRE_NAMES.has(name)) {
+        return 'is reserved for an ABTO system event on the wire';
+    }
+    return undefined;
+}
+export function defineEvents(registry) {
+    for (const name of Object.keys(registry)) {
+        const event = registry[name];
+        if (event === undefined)
+            continue;
+        const eventNameIssue = validateCustomEventName(name);
+        if (eventNameIssue !== undefined) {
+            throw new Error(`[abto] custom event name "${name}" ${eventNameIssue}.`);
+        }
+        for (const property of Object.keys(event.properties)) {
+            if (property.startsWith('$')) {
+                throw new Error(`[abto] custom property name "${property}" is reserved; $ properties belong to ABTO.`);
+            }
+        }
+    }
+    return registry;
+}
+export function validateCustomPropertyNames(properties) {
+    return Object.keys(properties)
+        .filter((name) => name.startsWith('$'))
+        .map((name) => `${name} is reserved; $ properties belong to ABTO`);
+}
+export function validateEventProperties(definition, properties) {
+    const issues = validateCustomPropertyNames(properties);
+    for (const [name, property] of Object.entries(definition.properties)) {
+        const value = properties[name];
+        if (value === undefined) {
+            if (property.required === true)
+                issues.push(`${name} is required`);
+            continue;
+        }
+        if (typeof value !== property.type) {
+            issues.push(`${name} must be ${property.type}`);
+            continue;
+        }
+        if (property.enum !== undefined && !property.enum.includes(value)) {
+            issues.push(`${name} must be one of ${property.enum.join(', ')}`);
+        }
+    }
+    return { valid: issues.length === 0, issues };
+}
+//# sourceMappingURL=event-registry.js.map

package/dist/event-registry.js.map

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