@jaak.ai/stamps 2.1.0-dev.9 → 2.2.0-beta.1

package/dist/types/services/interfaces/ITracingService.d.ts

@@ -0,0 +1,64 @@
+import { Span } from '@opentelemetry/api';
+export interface ITracingService {
+    /**
+     * Initializes the tracing service with the collector endpoint
+     */
+    initialize(): void;
+    /**
+     * Starts a new span with the given name
+     * @param name - Name of the span
+     * @param attributes - Optional attributes to add to the span
+     * @returns The created span
+     */
+    startSpan(name: string, attributes?: Record<string, any>): Span;
+    /**
+     * Ends a span
+     * @param span - The span to end
+     */
+    endSpan(span: Span): void;
+    /**
+     * Adds an event to a span
+     * @param span - The span to add the event to
+     * @param name - Name of the event
+     * @param attributes - Optional attributes for the event
+     */
+    addSpanEvent(span: Span, name: string, attributes?: Record<string, any>): void;
+    /**
+     * Records an exception in a span
+     * @param span - The span to record the exception in
+     * @param error - The error to record
+     */
+    recordException(span: Span, error: Error): void;
+    /**
+     * Sets an attribute on a span
+     * @param span - The span to set the attribute on
+     * @param key - Attribute key
+     * @param value - Attribute value
+     */
+    setSpanAttribute(span: Span, key: string, value: any): void;
+    /**
+     * Wraps a function with automatic span creation
+     * @param name - Name of the span
+     * @param fn - Function to wrap
+     * @param attributes - Optional attributes
+     */
+    trace<T>(name: string, fn: () => T | Promise<T>, attributes?: Record<string, any>): Promise<T>;
+    /**
+     * Flushes all pending spans to the collector
+     * Call this when capture/process is complete
+     */
+    flush(): Promise<void>;
+    /**
+     * Cleans up resources
+     */
+    cleanup(): void;
+    /**
+     * Set the session trace ID from external source (license or component prop)
+     * @param traceId - The trace ID to use for all spans (32 hex characters)
+     */
+    setSessionTraceId(traceId: string | null): void;
+    /**
+     * Get the current session trace ID
+     */
+    getSessionTraceId(): string | null;
+}

package/dist/types/stencil-public-runtime.d.ts

@@ -846,7 +846,7 @@ export declare namespace JSXBase {
     interface DetailsHTMLAttributes<T> extends HTMLAttributes<T> {
         open?: boolean;
         name?: string;
-        onToggle?: (event: Event) => void;
+        onToggle?: (event: ToggleEvent) => void;
     }
     interface DelHTMLAttributes<T> extends HTMLAttributes<T> {
         cite?: string;
@@ -1552,6 +1552,13 @@ export declare namespace JSXBase {
         z?: number | string;
         zoomAndPan?: string;
     }
+    /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent) */
+    interface ToggleEvent extends Event {
+        /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent/newState) */
+        readonly newState: string;
+        /** [MDN Reference](https://developer.mozilla.org/docs/Web/API/ToggleEvent/oldState) */
+        readonly oldState: string;
+    }
     interface DOMAttributes<T> extends JSXAttributes<T> {
         slot?: string;
         part?: string;
@@ -1568,6 +1575,10 @@ export declare namespace JSXBase {
         onCompositionstartCapture?: (event: CompositionEvent) => void;
         onCompositionupdate?: (event: CompositionEvent) => void;
         onCompositionupdateCapture?: (event: CompositionEvent) => void;
+        onBeforeToggle?: (event: ToggleEvent) => void;
+        onBeforeToggleCapture?: (event: ToggleEvent) => void;
+        onToggle?: (event: ToggleEvent) => void;
+        onToggleCapture?: (event: ToggleEvent) => void;
         onFocus?: (event: FocusEvent) => void;
         onFocusCapture?: (event: FocusEvent) => void;
         onFocusin?: (event: FocusEvent) => void;
@@ -1586,10 +1597,6 @@ export declare namespace JSXBase {
         onSubmitCapture?: (event: Event) => void;
         onInvalid?: (event: Event) => void;
         onInvalidCapture?: (event: Event) => void;
-        onBeforeToggle?: (event: Event) => void;
-        onBeforeToggleCapture?: (event: Event) => void;
-        onToggle?: (event: Event) => void;
-        onToggleCapture?: (event: Event) => void;
         onLoad?: (event: Event) => void;
         onLoadCapture?: (event: Event) => void;
         onError?: (event: Event) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jaak.ai/stamps",
-  "version": "2.1.0-dev.9",
+  "version": "2.2.0-beta.1",
   "description": "Jaak Document Identifier",
   "main": "dist/index.cjs.js",
   "module": "dist/index.js",
@@ -34,6 +34,7 @@
   "scripts": {
     "build": "stencil build",
     "start": "stencil build --dev --watch --serve",
+    "start:demo": "http-server src -p 8080 -o /demo.html",
     "test": "stencil test --spec --e2e",
     "test.watch": "stencil test --spec --e2e --watchAll",
     "generate": "stencil generate"
@@ -42,18 +43,35 @@
     "@stencil/core": "^4.27.1",
     "@types/jest": "^29.5.14",
     "@types/node": "^22.13.5",
+    "@types/ua-parser-js": "^0.7.39",
+    "http-server": "^14.1.1",
     "jest": "^29.7.0",
     "jest-cli": "^29.7.0",
     "puppeteer": "^24.3.0"
   },
   "license": "MIT",
   "dependencies": {
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/context-zone": "^2.2.0",
+    "@opentelemetry/exporter-metrics-otlp-http": "^0.208.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.208.0",
+    "@opentelemetry/instrumentation-document-load": "^0.54.0",
+    "@opentelemetry/instrumentation-fetch": "^0.208.0",
+    "@opentelemetry/instrumentation-user-interaction": "^0.53.0",
+    "@opentelemetry/instrumentation-xml-http-request": "^0.208.0",
+    "@opentelemetry/propagator-b3": "^2.2.0",
+    "@opentelemetry/resources": "^2.2.0",
+    "@opentelemetry/sdk-metrics": "^2.2.0",
+    "@opentelemetry/sdk-trace-base": "^2.2.0",
+    "@opentelemetry/sdk-trace-web": "^2.2.0",
+    "@opentelemetry/semantic-conventions": "^1.38.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/commit-analyzer": "^13.0.1",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^11.0.4",
     "@semantic-release/npm": "^12.0.2",
     "@semantic-release/release-notes-generator": "^14.0.3",
-    "semantic-release": "^24.2.7"
+    "semantic-release": "^24.2.7",
+    "ua-parser-js": "^1.0.40"
   }
 }