@docx-editor.dev/telemetry 0.0.1 → 2.30.0

package/dist/index.d.ts

@@ -0,0 +1,355 @@
+/**
+ * Anonymous diagnostics, metrics, and error reporting for editors and collaboration servers.
+ *
+ * - `@docx-editor.dev/telemetry`: {@link createTelemetry} for editors, the console, callback,
+ *   memory, and HTTP exporters, and {@link browserPrivacySignals}.
+ * - `@docx-editor.dev/telemetry/ingest`: a route that receives telemetry from `httpExporter`
+ *   and forwards it to a log service.
+ * - `@docx-editor.dev/telemetry/otel`: OpenTelemetry metrics and traces through your SDK.
+ * - `@docx-editor.dev/telemetry/sentry`: Sentry issues and breadcrumbs.
+ * - `@docx-editor.dev/telemetry/prometheus`: a `/metrics` endpoint.
+ * - `@docx-editor.dev/telemetry/server`: room telemetry for any Yjs server.
+ * - `@docx-editor.dev/telemetry/hocuspocus`: room telemetry for Hocuspocus in one call.
+ *
+ * @packageDocumentation
+ */
+import { EditorModule, EditorDiagnostic } from '@docx-editor.dev/core';
+export { ByteSizeBucket, CollaborationDiagnosticCode, CollaborationParticipantsDiagnostic, CollaborationStatusDiagnostic, CountBucket, CustomNodeDiagnosticCode, CustomNodeDiagnosticEvent, DiagnosticBase, DiagnosticCode, DiagnosticErrorName, DiagnosticExplanation, DiagnosticFailureDetail, DocumentOpenDiagnostic, DocumentOpenDiagnosticCode, DocumentPartKind, DocumentSaveDiagnostic, DocumentSaveDiagnosticCode, DocumentShape, EditDiagnosticCode, EditRejectedDiagnostic, EditRejectionOrigin, EditorDiagnostic, EditorDiagnosticKind, FailureStage, FontDiagnosticCode, FontFailedDiagnostic, FormattingChangeKind, HistoryDiagnosticCode, HistoryDiagnosticEvent, PerformanceDiagnostic, PerformanceDiagnosticCode, ReviewChangeKind, ReviewDiagnosticCode, ReviewOperation, ReviewSkippedDiagnostic, SessionActivity, SessionDiagnostic, TimingSummary, explainDiagnostic } from '@docx-editor.dev/core';
+import { A as Attributes, T as TelemetryPipelineOptions, a as TelemetryEvent, b as TelemetryExporter, M as MetricRecord } from './pipeline-CCq2Ng0B.js';
+export { c as AttributeValue, E as ENGINE_VERSION, d as MAX_METRIC_LABEL_VALUES, e as METRICS, f as MetricDefinition, g as MetricId, h as MetricKind, i as TelemetryEventContext, j as TelemetryExporterContext, p as prometheusName } from './pipeline-CCq2Ng0B.js';
+
+/**
+ * The areas you can switch on. Each one selects diagnostic kinds:
+ *
+ * - `documentOpen`: documents opened and refused (`document.open`).
+ * - `editing`: edits and commands refused while changes are not tracked (`edit.rejected`).
+ * - `trackedChanges`: refusals while suggesting, refusals about tracking itself, and skipped
+ *   tracked changes
+ *   (`edit.rejected` with `tracked: true`, `review.skipped`).
+ * - `fonts`: fonts that failed and were substituted (`font.failed`).
+ * - `history`: undo steps that did not group as the gesture intended (`history`).
+ * - `customNodes`: custom node payloads that could not be read (`custom-node`).
+ * - `collaborationClient`: collaboration status changes and room size (`collab.*`).
+ * - `performance`: how fast the editor responds: key presses and clicks to the next frame,
+ *   and engine layout and paint times, as one summary per minute of use (`performance`).
+ * - `documentSave`: calls to `save()` that returned the document or failed (`document.save`).
+ * - `sessions`: when each editor starts and ends, how long it is used, and how many edits it
+ *   commits, as one summary per minute of use (`session`).
+ *
+ * @public
+ */
+type TelemetryArea = 'documentOpen' | 'documentSave' | 'sessions' | 'editing' | 'trackedChanges' | 'fonts' | 'history' | 'customNodes' | 'collaborationClient' | 'performance';
+/** Options for one area. @public */
+interface TelemetryAreaOptions {
+    /**
+     * Share of events to send, from 0 to 1. Metrics count every event, except that a
+     * `performance` rate of 0 turns performance off, metrics included. Defaults to 1.
+     * Each event is sampled on its own, except in `performance` and `sessions`: there the choice
+     * is made once for each editor, which sends all of its summaries or none.
+     */
+    readonly sampleRate?: number;
+}
+/** Which areas to record. An area that is absent or `false` records nothing. @public */
+type TelemetryInclude = {
+    readonly [A in TelemetryArea]?: boolean | TelemetryAreaOptions;
+};
+/** Options for {@link createTelemetry}. @public */
+interface TelemetryOptions extends TelemetryPipelineOptions {
+    /**
+     * The areas to record. Omitted, every area is on.
+     *
+     * @example
+     * ```ts
+     * include: { documentOpen: true, trackedChanges: true, editing: { sampleRate: 0.2 } }
+     * ```
+     */
+    readonly include?: TelemetryInclude;
+    /**
+     * Identical refusals inside this window are sent once, then summarized with `repeated`.
+     * Holding Backspace on a locked drawing is one event, not hundreds. Defaults to 10 000 ms.
+     * Set 0 to send every event.
+     */
+    readonly dedupeWindowMs?: number;
+    /**
+     * How much of an opened document's shape to send. `'basic'`, the default, sends the size and
+     * page buckets. `'detailed'` also sends part, paragraph, review item, and embedded font
+     * buckets: useful to group open times, but several counts together describe a document more
+     * closely, so ask for it only when you need it.
+     */
+    readonly documentShape?: 'basic' | 'detailed';
+    /**
+     * Your identifiers on every event, such as a tenant or a pseudonymous user id. A function is
+     * read at each event, so it can follow sign-in and tenant switches. Events only: to label
+     * metrics with a key, list it in `metricLabels`. For values that belong to one editor, such as
+     * its room or document, use {@link Telemetry.moduleFor}.
+     *
+     * These values are yours and go only to your exporters. Keys follow attribute rules: letters,
+     * digits, `_`, `.`, and `-`, up to 64 characters. Values are strings, numbers, or booleans;
+     * strings are cut at 256 characters.
+     *
+     * @example
+     * ```ts
+     * attributes: () => ({ 'tenant.id': session.tenantId, 'user.id': session.pseudonymousId })
+     * ```
+     */
+    readonly attributes?: Attributes | (() => Attributes);
+    /**
+     * Which events go to your exporters, after the privacy check and sampling. Metrics still count
+     * every event. A filter that throws drops the event.
+     *
+     * @example
+     * ```ts
+     * // Failures and performance summaries only: no event for an open that succeeded.
+     * filter: (event) => isFailure(event) || event.kind === 'performance'
+     * ```
+     */
+    readonly filter?: (event: TelemetryEvent) => boolean;
+}
+/** A configured telemetry client. Create it once, outside any component. @public */
+interface Telemetry {
+    /**
+     * Register this in the editor's `modules`. It observes every editor created with it, from
+     * the first open on.
+     *
+     * @example
+     * ```tsx
+     * const MODULES = [reviewModule(), telemetry.module];
+     * <DocxEditor document={bytes} modules={MODULES} />;
+     * ```
+     */
+    readonly module: EditorModule;
+    /**
+     * A module for one editor, whose events also carry `attributes`, such as its collaboration
+     * room, document, or workspace. Create one for each editor, and keep it stable across renders.
+     * Use it in place of `module`, not next to it.
+     *
+     * @example
+     * ```tsx
+     * const modules = useMemo(
+     *   () => [reviewModule(), telemetry.moduleFor({ 'room.id': roomId, 'document.id': documentId })],
+     *   [roomId, documentId]
+     * );
+     * ```
+     */
+    moduleFor(attributes: Attributes): EditorModule;
+    /**
+     * Record one diagnostic yourself, for example from a runtime you created without `module`.
+     * Use `module` or `record`, not both, or every event is recorded twice. `attributes` are added
+     * to this event, as `moduleFor` adds them.
+     */
+    record(event: EditorDiagnostic, attributes?: Attributes): void;
+    /** Send summaries of open deduplication windows, then flush every exporter. */
+    flush(): Promise<void>;
+    /** Flush, then stop. Later events are dropped. */
+    shutdown(): Promise<void>;
+}
+/**
+ * Create a telemetry client for editors.
+ *
+ * Nothing is sent unless you pass an exporter. With `consent`, nothing is sent while it is
+ * false; without it, events are sent. Every event is anonymous: codes, enums, and bucketed
+ * numbers only.
+ *
+ * @example
+ * ```ts
+ * import { createTelemetry, consoleExporter } from '@docx-editor.dev/telemetry';
+ *
+ * export const telemetry = createTelemetry({
+ *   exporters: [consoleExporter()],
+ *   include: { documentOpen: true, trackedChanges: true },
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function createTelemetry(options: TelemetryOptions): Telemetry;
+
+/**
+ * Sending telemetry to your own HTTP endpoint from a browser, and reading the browser's privacy
+ * signals. No dependency: `fetch`, `sendBeacon`, and `localStorage` only.
+ */
+
+/** Options for {@link httpExporter}. @public */
+interface HttpExporterOptions {
+    /**
+     * Where to POST. Use a route on your own origin, which then forwards to your log service, so
+     * the service's token never reaches the browser. See `@docx-editor.dev/telemetry/ingest`.
+     */
+    readonly url: string;
+    /**
+     * Events per request, from 1 to 50. Defaults to 20. A full batch is sent at once. The limit
+     * matches the default `maxEvents` of `telemetryRoute`, which refuses a longer list.
+     */
+    readonly batchSize?: number;
+    /** How long an event waits for its batch to fill, in milliseconds. Defaults to 10 000. */
+    readonly flushIntervalMs?: number;
+    /**
+     * Extra request headers. A browser cannot set headers on `sendBeacon`, so with headers, the
+     * batches sent while the page closes use `fetch` with `keepalive` instead.
+     */
+    readonly headers?: Readonly<Record<string, string>>;
+    /**
+     * Called when a request fails, or when batches are dropped because the page closed with more
+     * than the browser lets it send. Telemetry never throws into your app.
+     */
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * Batch events and POST them as a JSON array to your own endpoint.
+ *
+ * While the page is open, events wait up to `flushIntervalMs` for a batch of `batchSize`, and
+ * each batch goes out with an ordinary `fetch`; so does a `telemetry.flush()` you call. When the
+ * page is hidden or closes, everything waiting goes out with `sendBeacon`. A closing page may
+ * send only about 64 KiB in all, so delivery while closing is best effort: batches beyond that
+ * are dropped and reported to `onError`. If consent is withdrawn, events still waiting are
+ * discarded.
+ *
+ * @example
+ * ```ts
+ * import { createTelemetry, httpExporter } from '@docx-editor.dev/telemetry';
+ *
+ * export const telemetry = createTelemetry({
+ *   exporters: [httpExporter({ url: '/api/telemetry' })],
+ *   include: { documentOpen: true, editing: true, trackedChanges: true, performance: true },
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function httpExporter(options: HttpExporterOptions): TelemetryExporter;
+/** Options for {@link browserPrivacySignals}. @public */
+interface BrowserPrivacySignalsOptions {
+    /**
+     * A `localStorage` key that opts the visitor out when its value is `off`, such as one your
+     * privacy settings page writes. Omit it to read only the browser signals.
+     */
+    readonly optOutKey?: string;
+}
+/**
+ * A `consent` function that follows the browser's privacy signals: it returns `false` when the
+ * visitor sends Global Privacy Control or Do Not Track, or when `optOutKey` is set to `off`.
+ * Outside a browser page, such as during server rendering, it returns `false`. Combine it with
+ * your consent manager when you have one.
+ *
+ * @example
+ * ```ts
+ * import { browserPrivacySignals, createTelemetry } from '@docx-editor.dev/telemetry';
+ *
+ * const privacy = browserPrivacySignals({ optOutKey: 'my-app:telemetry' });
+ * export const telemetry = createTelemetry({
+ *   exporters: [],
+ *   consent: () => privacy() && consentManager.analytics,
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function browserPrivacySignals(options?: BrowserPrivacySignalsOptions): () => boolean;
+
+/**
+ * Send each event to your own function: Datadog RUM, PostHog, a logger, or an API route.
+ *
+ * `onMetric` receives every measurement. A performance summary arrives as one histogram sample
+ * for each timing in it, at the middle of the timing's band, so the bucket counts are exact.
+ * To chart percentiles, read `p50Ms` and `p95Ms` from the `performance` event instead.
+ *
+ * @example
+ * ```ts
+ * callbackExporter((event) =>
+ *   isFailure(event)
+ *     ? datadogRum.addError(new Error(event.kind), event)
+ *     : datadogRum.addAction(event.kind, event)
+ * );
+ * ```
+ *
+ * @public
+ */
+declare function callbackExporter(onEvent: (event: TelemetryEvent) => void, onMetric?: (record: MetricRecord) => void): TelemetryExporter;
+/** Options for {@link consoleExporter}. @public */
+interface ConsoleExporterOptions {
+    /** Also print every metric measurement. Defaults to `false`. */
+    readonly metrics?: boolean;
+    /** Where to print. Defaults to the global `console`. */
+    readonly console?: Pick<Console, 'info' | 'warn'>;
+}
+/**
+ * Whether an event is a failure: a refused open, a refused edit other than an expected one
+ * (a stale range, a read-only document, protected content, a session or refresh not ready
+ * yet), an unreadable payload, a font that did not load, or a collaboration error. A missing
+ * font that was substituted and a tracked change someone else already reviewed are not. Use it
+ * in a callback to send failures as errors and the rest as actions or logs.
+ *
+ * @example
+ * ```ts
+ * callbackExporter((event) => {
+ *   const code = 'code' in event ? event.code : undefined;
+ *   if (isFailure(event)) myLogger.error(event.kind, { code, hint: event.hint });
+ *   else myLogger.info(event.kind);
+ * });
+ * ```
+ *
+ * A deduplication summary returns `false`: it repeats an event already reported. To total
+ * failures with summaries included, use {@link failureCount}.
+ *
+ * @public
+ */
+declare function isFailure(event: TelemetryEvent): boolean;
+/**
+ * How many failures an event adds to a failure total: `0` when it is not a failure, `1` for a
+ * failure, and `repeated` for a deduplication summary of one. The sum over every event a
+ * client sends equals the number of failures the editor reported, which {@link isFailure}
+ * alone undercounts. Sampling still applies: a sampled area sends a share of its events.
+ *
+ * @example
+ * ```ts
+ * let failures = 0;
+ * callbackExporter((event) => {
+ *   failures += failureCount(event);
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function failureCount(event: TelemetryEvent): number;
+/**
+ * Print each event with its hint and docs link. Use it during development to see why a
+ * document did not open or why a tracked change was refused.
+ *
+ * @example
+ * ```ts
+ * createTelemetry({ exporters: [consoleExporter()] });
+ * // An agent deletes a picture while changes are tracked:
+ * // [docx-editor] edit refused: edit.tracked-operation-unsupported (automation, tracked)
+ * //   This editing API operation cannot be recorded as a tracked change, so nothing was ...
+ * //   https://docx-editor.dev/docs/2.x/guides/diagnostics#edit-tracked-operation-unsupported
+ * ```
+ *
+ * @public
+ */
+declare function consoleExporter(options?: ConsoleExporterOptions): TelemetryExporter;
+/** An exporter that keeps what it receives. Returned by {@link memoryExporter}. @public */
+interface MemoryExporter extends TelemetryExporter {
+    readonly events: readonly TelemetryEvent[];
+    readonly metrics: readonly MetricRecord[];
+    /** Forget everything received so far. */
+    clear(): void;
+}
+/**
+ * Keep events and metrics in memory, for tests in your own suite.
+ *
+ * @example
+ * ```ts
+ * const memory = memoryExporter();
+ * const telemetry = createTelemetry({ exporters: [memory] });
+ * // ...open a file that fails...
+ * expect(memory.events).toContainEqual(
+ *   expect.objectContaining({ code: 'open.missing-main-document' })
+ * );
+ * ```
+ *
+ * @public
+ */
+declare function memoryExporter(): MemoryExporter;
+
+export { Attributes, MetricRecord, TelemetryEvent, TelemetryExporter, TelemetryPipelineOptions, browserPrivacySignals, callbackExporter, consoleExporter, createTelemetry, failureCount, httpExporter, isFailure, memoryExporter };
+export type { BrowserPrivacySignalsOptions, ConsoleExporterOptions, HttpExporterOptions, MemoryExporter, Telemetry, TelemetryArea, TelemetryAreaOptions, TelemetryInclude, TelemetryOptions };

package/dist/index.js

@@ -0,0 +1 @@
+import {c,b as b$1}from'./chunk-WHVIRIUW.js';export{b as ENGINE_VERSION,a as MAX_METRIC_LABEL_VALUES}from'./chunk-WHVIRIUW.js';import {a as a$1}from'./chunk-RSWAOCAT.js';export{a as METRICS,b as prometheusName}from'./chunk-RSWAOCAT.js';export{a as callbackExporter,e as consoleExporter,d as failureCount,c as isFailure,f as memoryExporter}from'./chunk-WLWS5CZT.js';import {c as c$1,a,b}from'./chunk-W5HFB5EV.js';import'./chunk-DT2KMPUJ.js';import {explainDiagnostic}from'@docx-editor.dev/core';export{explainDiagnostic}from'@docx-editor.dev/core';var X={documentOpen:true,documentSave:true,sessions:true,editing:true,trackedChanges:true,fonts:true,history:true,customNodes:true,collaborationClient:true,performance:true},Y=new Set(["edit.tracking-required","edit.suggesting-needs-author","edit.tracking-mode-unsupported","edit.tracking-author-required","edit.tracking-unsupported-host"]);function Z(e){switch(e.kind){case "document.open":return "documentOpen";case "document.save":return "documentSave";case "session":return "sessions";case "edit.rejected":return e.tracked||Y.has(e.code)?"trackedChanges":"editing";case "review.skipped":return "trackedChanges";case "font.failed":return "fonts";case "history":return "history";case "custom-node":return "customNodes";case "collab.status":case "collab.participants":return "collaborationClient";case "performance":return "performance";default:return null}}function J(e){return e.kind==="collab.participants"?`${e.editorSessionId}|participants`:e.kind==="edit.rejected"?[e.editorSessionId,e.code,e.cause,e.errorName,e.stage,e.origin,e.tracked,e.command].join("|"):e.kind==="font.failed"?`${e.editorSessionId}|font|${e.code}`:e.kind==="history"||e.kind==="custom-node"?`${e.editorSessionId}|${e.kind}|${e.code}`:e.kind==="collab.status"?`${e.editorSessionId}|status|${e.status}|${e.code??""}|${e.recovering}`:null}function Q(e){let t=c(e),m=e.metricLabels??[];function n(o){let r={};try{let a=typeof e.attributes=="function"?e.attributes():e.attributes;r=c$1(a??{},"attributes");}catch{}return Object.freeze({...r,...o})}function c$2(o){let r={};for(let a of m)o[a]!==void 0&&(r[a]=o[a]);return r}let f=e.include??X,l=e.dedupeWindowMs??1e4,g=o=>{try{if(e.filter&&!e.filter(o))return}catch{return}t.event(o);},E=e.documentShape==="detailed",y=new Map,S=false,k=()=>{},T=false;function D(o){let r=f[o];return r?r===true?1:Math.min(1,Math.max(0,r.sampleRate??1)):null}let h=new Map;function w(o,r,a){if(a>=1)return  true;if(r!=="performance"&&r!=="sessions")return Math.random()<a;let p=`${r}|${o.editorSessionId}`,b=h.get(p);return b===void 0&&(h.size>=1e3&&h.clear(),b=Math.random()<a,h.set(p,b)),b}function M(){if(S)return;S=true;let o=globalThis;if(typeof o.addEventListener!="function")return;let r=()=>{t.setPageClosing(true),u();},a=()=>{let p=globalThis.document?.visibilityState==="hidden";t.setPageClosing(p),p&&u();};o.addEventListener("pagehide",r),o.addEventListener("visibilitychange",a),k=()=>{o.removeEventListener?.("pagehide",r),o.removeEventListener?.("visibilitychange",a);};}function v(o){let r=y.get(o);if(r){if(y.delete(o),clearTimeout(r.timer),r.latest){let a=r.event;r.latest.count!==a.count&&g(I(F(r.latest,E),t,r.event.attributes));}else if(r.repeated>0){let{connectMs:a$1,...p}=r.event;g({...p,repeated:Math.min(r.repeated,a)});}}}function i(o,r={}){if(T||!t.consented())return;let a=n(r),p=b(I(o,t,a));if("dropped"in p){t.metric(a$1.droppedEvents,1,{...c$2(a),reason:p.dropped,"docx_editor.version":b$1});return}let b$2=Z(o),A=b$2?D(b$2):null;if(A===null||b$2==="performance"&&A===0)return;M(),ee(t,p.event,c$2(a));let x=l>0?J(o):null,O=x?y.get(x):void 0;if(O){o.kind==="collab.participants"?O.latest=o:O.repeated+=1;return}let _=o.kind==="session"&&o.phase==="end";if(!w(o,b$2,A)){_&&u();return}let L=I(F(o,E),t,a);if(g(L),_&&u(),x){let R=setTimeout(()=>v(x),l);R.unref?.(),y.set(x,{event:L,repeated:0,timer:R});}}function d(o){return Object.freeze({id:"telemetry",onDiagnostic:r=>i(r,o),wantsDiagnostic:r=>!T&&(r==="session"?D("sessions")!==null:r!=="performance"||(D("performance")??0)>0&&t.consented())})}async function u(){for(let o of [...y.keys()])v(o);await t.flush();}return {module:d({}),moduleFor(o){return d(c$1(o,"moduleFor"))},record:i,flush:u,async shutdown(){for(let o of [...y.keys()])v(o);T=true,k(),await t.shutdown();}}}function F(e,t){if(t||e.kind!=="document.open"||e.outcome!=="opened"||!("shape"in e))return e;let{shape:m,...n}=e;return n}function I(e,t,m){let n="code"in e?e.code:void 0;return {...e,...n?explainDiagnostic(n):{},engineVersion:b$1,resource:t.resource,attributes:m}}function ee(e,t,m){let n={metric:(c,f,l={})=>e.metric(c,f,{...l,...m,"docx_editor.version":b$1})};switch(t.kind){case "document.open":t.outcome==="opened"?(n.metric(a$1.documentOpens,1,{outcome:"opened",code:"none",cause:"none",part:"none"}),n.metric(a$1.documentOpenDuration,t.durationMs/1e3)):n.metric(a$1.documentOpens,1,{outcome:"rejected",code:t.code,cause:t.cause??"none",part:t.part??"none"});return;case "edit.rejected":n.metric(a$1.editRejections,1,{code:t.code,cause:t.cause??"none",origin:t.origin,tracked:t.tracked});return;case "review.skipped":n.metric(a$1.reviewSkipped,t.count,{code:t.code,cause:t.cause??"none",operation:t.operation??"none",change_kind:t.changeKind??"none"});return;case "font.failed":n.metric(a$1.fontFailures,1,{code:t.code});return;case "history":n.metric(a$1.historyDiagnostics,1,{code:t.code});return;case "custom-node":n.metric(a$1.customNodeDiagnostics,1,{code:t.code});return;case "collab.status":n.metric(a$1.collabClientStatusTransitions,1,{status:t.status,code:t.code??"none"}),t.connectMs!==void 0&&n.metric(a$1.collabClientConnectDuration,t.connectMs/1e3);return;case "collab.participants":n.metric(a$1.collabClientParticipants,t.count);return;case "performance":{let c=t.pagesBucket??"unknown";N(n,a$1.editorInteractionDuration,c,t.interaction),N(n,a$1.editorLayoutDuration,c,t.layout),N(n,a$1.editorPaintDuration,c,t.paint);return}case "document.save":n.metric(a$1.documentSaves,1,{outcome:t.outcome,code:t.outcome==="rejected"?t.code:"none"}),t.outcome==="saved"&&n.metric(a$1.documentSaveDuration,t.durationMs/1e3);return;case "session":te(n,t);}}function te(e,t){if(t.phase==="start"){e.metric(a$1.editorSessions,1,{phase:"start"});return}if(t.phase==="end"){e.metric(a$1.editorSessions,1,{phase:"end"}),e.metric(a$1.editorSessionDuration,t.durationMs/1e3);return}t.activeMs>0&&e.metric(a$1.editorActiveTime,t.activeMs/1e3);for(let[m,n]of [["input",t.inputEdits],["command",t.commandEdits],["automation",t.automationEdits]])n>0&&e.metric(a$1.edits,n,{origin:m});}function N(e,t,m,n){if(!n)return;let c=t.buckets??[];n.bands.forEach((f,l)=>{let g=c[l],E=l===0?0:c[l-1],y=g===void 0?Math.max(n.maxMs/1e3,E+1e-6):(E+g)/2;for(let S=0;S<f;S+=1)e.metric(t,y,{pages:m});});}var oe=new TextEncoder,ne=e=>oe.encode(e).byteLength;function re(e){let t=Math.min(50,Math.max(1,Math.floor(e.batchSize??20))),m=e.flushIntervalMs??1e4,n=[],c,f,l=new Set,g=i=>{try{e.onError?.(i);}catch{}},E=(i,d)=>{if(typeof fetch!="function")return;let u=fetch(e.url,{method:"POST",headers:{"Content-Type":"application/json",...e.headers},body:i,keepalive:d}).then(o=>{if(!o.ok)throw new Error(`telemetry endpoint answered ${o.status}`)}).catch(g).finally(()=>l.delete(u));l.add(u);},y=i=>{let d=globalThis.navigator;if(!e.headers&&typeof d?.sendBeacon=="function")try{if(d.sendBeacon(e.url,new Blob([i],{type:"application/json"})))return}catch{}E(i,true);},S=i=>{let d=Math.min(t,n.length);for(;d>0;){let u=JSON.stringify(n.slice(0,d)),o=ne(u);if(o<=i)return {body:u,bytes:o,count:d};if(d===1)return null;d=Math.ceil(d/2);}return null},k=0,T=false,D=i=>{if(c!==void 0&&clearTimeout(c),c=void 0,f&&!f.consented()){n=[];return}(!i||!T)&&(k=0),T=i;let d=0;for(;n.length;){let u=S(61440-(i?k:0));if(!u){d+=i?n.length:1,n=i?[]:n.slice(1);continue}n=n.slice(u.count),i?(k+=u.bytes,y(u.body)):E(u.body,false);}d&&g(new Error(`telemetry dropped ${d} events that did not fit`));},h=()=>{let i=f?.pageClosing()??false;return i||(T=false),i},w=globalThis.document,M=()=>{w?.visibilityState==="visible"&&(T=false);},v=()=>w?.removeEventListener?.("visibilitychange",M);return {name:"http",attach(i){f=i,w?.addEventListener?.("visibilitychange",M);},event(i){n.push(i),n.length>=t?D(h()):c===void 0&&(c=setTimeout(()=>D(h()),m),c.unref?.());},async flush(){D(h()),await Promise.all(l);},async shutdown(){v(),D(h()),await Promise.all(l);}}}function ie(e={}){return ()=>{let t=globalThis;if(!t.window||!t.document||!t.navigator||t.navigator.globalPrivacyControl===true||t.navigator.doNotTrack==="1")return  false;if(!e.optOutKey)return  true;try{return globalThis.localStorage?.getItem(e.optOutKey)!=="off"}catch{return  true}}}export{ie as browserPrivacySignals,Q as createTelemetry,re as httpExporter};

package/dist/ingest/index.cjs

@@ -0,0 +1 @@
+'use strict';var chunkE2HR5DHZ_cjs=require('../chunk-E2HR5DHZ.cjs'),chunk7SYLCJFQ_cjs=require('../chunk-7SYLCJFQ.cjs');require('../chunk-WGWKNKUT.cjs');var b=50,o=e=>typeof e=="string",u=e=>typeof e=="number"&&Number.isFinite(e),p=e=>typeof e=="boolean",h={"edit.rejected":[["code",o],["origin",o],["tracked",p]],"review.skipped":[["code",o],["count",u]],"font.failed":[["code",o]],history:[["code",o]],"custom-node":[["code",o]],"collab.status":[["status",o],["previous",o],["recovering",p]],"collab.participants":[["count",u]],performance:[["windowMs",u]]},E=["durationMs","activeMs","inputEdits","commandEdits","automationEdits"];function T(e){if(!u(e.schemaVersion)||!u(e.time)||!o(e.editorSessionId)||!o(e.engineVersion))return  false;if(e.kind==="document.open")return e.outcome==="opened"?o(e.sizeBucket)&&u(e.durationMs):e.outcome==="rejected"&&o(e.code);if(e.kind==="document.save")return u(e.durationMs)&&(e.outcome==="saved"?o(e.sizeBucket):e.outcome==="rejected"&&o(e.code));if(e.kind==="session")return e.phase==="start"||(e.phase==="active"||e.phase==="end")&&E.every(t=>u(e[t]));let n=h[e.kind];return !!n&&n.every(([t,s])=>s(e[t]))}function w(e,n){if(n.size===0)return {};let t=chunk7SYLCJFQ_cjs.d(e)??{};return Object.fromEntries(Object.entries(t).filter(([s])=>n.has(s)))}function R(e,n={}){let t=n.maxEvents??b,s=new Set(n.attributeKeys??[]);return !Array.isArray(e)||e.length>t?[]:e.flatMap(r=>{if(!r||typeof r!="object"||Array.isArray(r))return [];let a=r,{resource:d,attributes:l,...i}=a,c=chunk7SYLCJFQ_cjs.b(i);if("dropped"in c||!T(c.event))return [];let g=w(a.attributes,s),{attributes:O,...k}=c.event;return [Object.freeze({...k,resource:w(a.resource,s),attributes:g})]})}function _(e){let{hint:n,docs:t,...s}=e,r="code"in e&&e.code?` ${e.code}`:"";return {...s,dt:e.time,message:`${e.kind}${r}`,occurrences:e.repeated??1,failures:chunkE2HR5DHZ_cjs.d(e)}}var x=64*1024;async function A(e,n){if(Number(e.headers.get("content-length")??0)>n)return null;let t=e.body;if(!t)return "";let s=t.getReader(),r=[],a=0;for(;;){let{done:i,value:c}=await s.read();if(i)break;if(a+=c.byteLength,a>n)return await s.cancel().catch(()=>{}),null;r.push(c);}let d=new Uint8Array(a),l=0;for(let i of r)d.set(i,l),l+=i.byteLength;return new TextDecoder().decode(d)}function F(e){let n=e.maxBodyBytes??x,t=()=>new Response(null,{status:204}),s=r=>{try{e.onError?.(r);}catch{}};return async r=>{if(r.method!=="POST")return t();if(e.allowedOrigins){let i=r.headers.get("origin");if(!i||!e.allowedOrigins.includes(i))return t()}let a;try{a=await A(r,n);}catch{return t()}if(a===null)return t();let d;try{d=JSON.parse(a);}catch{return t()}let l=R(d,e);if(!l.length)return t();try{let c=await e.forward(l);if(c&&c.ok===!1)throw new Error(`the log service answered ${String(c.status)}`)}catch(i){s(i);}return t()}}exports.telemetryRoute=F;exports.toLogRecord=_;exports.validateTelemetryEvents=R;

package/dist/ingest/index.d.cts

@@ -0,0 +1,116 @@
+/**
+ * Receive editor telemetry on your server and forward it to a log service, such as Better Stack,
+ * Axiom, or Datadog Logs. Pair it with `httpExporter` in the browser: the browser posts to your
+ * route, and only your server holds the log service's token.
+ *
+ * Anyone can POST to a public route, so every event is checked again with the same closed lists
+ * the browser used, and fields the client chose itself are dropped unless you allow them. No
+ * dependency: Fetch API `Request` and `Response` only, so it runs in Next.js route handlers,
+ * Hono, Bun, Deno, and Cloudflare Workers.
+ *
+ * @packageDocumentation
+ */
+import { a as TelemetryEvent } from '../pipeline-CCq2Ng0B.cjs';
+import '@docx-editor.dev/core';
+
+/** Options for {@link validateTelemetryEvents}. @public */
+interface ValidateTelemetryEventsOptions {
+    /** The most events one request may carry. Defaults to 50; a longer list is refused whole. */
+    readonly maxEvents?: number;
+    /**
+     * Keys of the browser's `resource` and `attributes` to keep, such as `['app.version']`. Each
+     * kept value must be a number, a boolean, or an identifier string. Defaults to none: a value
+     * the client chose cannot be checked for meaning, so add your fixed fields on the server.
+     */
+    readonly attributeKeys?: readonly string[];
+}
+/**
+ * The telemetry events in an untrusted request body, checked again with the package's own
+ * closed lists. An event with an unknown kind or code, a code of another kind, a value outside
+ * its list or range, or without the fields its kind needs, is dropped. An unknown field, a
+ * number or timing summary its kind does not carry, or a wall-clock span above its bound is
+ * removed. The client's `resource` and `attributes` keep only the keys in `attributeKeys`.
+ * Returns an empty list for a body that is not an array or is longer than `maxEvents`.
+ *
+ * The check proves that every value comes from the package's lists or is a number in the range
+ * the engine produces. It cannot prove that a client told the truth: a script can send a
+ * well-formed event that never happened. It can never send text.
+ *
+ * @example
+ * ```ts
+ * const events = validateTelemetryEvents(await request.json(), { attributeKeys: ['app.version'] });
+ * ```
+ *
+ * @public
+ */
+declare function validateTelemetryEvents(body: unknown, options?: ValidateTelemetryEventsOptions): TelemetryEvent[];
+/** A log record with the fields log services read for time, summary, and counts. @public */
+type TelemetryLogRecord = Record<string, unknown> & {
+    /** The event time in milliseconds since the epoch, which Better Stack and others read. */
+    readonly dt: number;
+    /** A one-line summary, such as `edit.rejected edit.picture-selected`. */
+    readonly message: string;
+    /**
+     * How many times the event happened: `1`, or `repeated` for a deduplication summary, whose
+     * first event was already sent. Sum it to count events; do not count records.
+     */
+    readonly occurrences: number;
+    /** How many failures the record adds to a failure total. See `failureCount`. */
+    readonly failures: number;
+};
+/**
+ * An event as a log record: `dt` for the time, `message` for the live tail, `occurrences` and
+ * `failures` to sum, and every field of the event except the fixed `hint` and `docs` text,
+ * which the code already identifies. Add your own fixed fields, such as a service name, to the
+ * result.
+ *
+ * @example
+ * ```ts
+ * body: JSON.stringify(events.map((event) => ({ ...toLogRecord(event), service: 'my-app' })))
+ * ```
+ *
+ * @public
+ */
+declare function toLogRecord(event: TelemetryEvent): TelemetryLogRecord;
+/** Options for {@link telemetryRoute}. @public */
+interface TelemetryRouteOptions extends ValidateTelemetryEventsOptions {
+    /** Send the checked events on, such as to your log service. Errors are caught and reported. */
+    forward(events: readonly TelemetryEvent[]): unknown;
+    /** Origins allowed to post, such as `['https://app.example.com']`. Omit to allow any. */
+    readonly allowedOrigins?: readonly string[];
+    /** The largest body accepted, in bytes. Defaults to 64 KiB. */
+    readonly maxBodyBytes?: number;
+    /** Called when `forward` throws or rejects, or the log service refuses. Defaults to nothing. */
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * A Fetch-style handler for telemetry from `httpExporter`: it accepts POST only, checks the
+ * origin, reads at most `maxBodyBytes`, validates every event, and calls `forward` with what
+ * passes. It answers 204 to every request, so a telemetry problem never surfaces in the
+ * editor; use `onError` to see failures. It does not rate-limit; put it behind your platform's
+ * limits.
+ *
+ * @example
+ * ```ts
+ * // Next.js: app/api/telemetry/route.ts
+ * import { telemetryRoute, toLogRecord } from '@docx-editor.dev/telemetry/ingest';
+ *
+ * export const POST = telemetryRoute({
+ *   forward: (events) =>
+ *     fetch(`https://${process.env.BETTERSTACK_INGESTING_HOST}`, {
+ *       method: 'POST',
+ *       headers: {
+ *         'Content-Type': 'application/json',
+ *         Authorization: `Bearer ${process.env.BETTERSTACK_SOURCE_TOKEN}`,
+ *       },
+ *       body: JSON.stringify(events.map(toLogRecord)),
+ *     }),
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function telemetryRoute(options: TelemetryRouteOptions): (request: Request) => Promise<Response>;
+
+export { TelemetryEvent, telemetryRoute, toLogRecord, validateTelemetryEvents };
+export type { TelemetryLogRecord, TelemetryRouteOptions, ValidateTelemetryEventsOptions };

package/dist/ingest/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Receive editor telemetry on your server and forward it to a log service, such as Better Stack,
+ * Axiom, or Datadog Logs. Pair it with `httpExporter` in the browser: the browser posts to your
+ * route, and only your server holds the log service's token.
+ *
+ * Anyone can POST to a public route, so every event is checked again with the same closed lists
+ * the browser used, and fields the client chose itself are dropped unless you allow them. No
+ * dependency: Fetch API `Request` and `Response` only, so it runs in Next.js route handlers,
+ * Hono, Bun, Deno, and Cloudflare Workers.
+ *
+ * @packageDocumentation
+ */
+import { a as TelemetryEvent } from '../pipeline-CCq2Ng0B.js';
+import '@docx-editor.dev/core';
+
+/** Options for {@link validateTelemetryEvents}. @public */
+interface ValidateTelemetryEventsOptions {
+    /** The most events one request may carry. Defaults to 50; a longer list is refused whole. */
+    readonly maxEvents?: number;
+    /**
+     * Keys of the browser's `resource` and `attributes` to keep, such as `['app.version']`. Each
+     * kept value must be a number, a boolean, or an identifier string. Defaults to none: a value
+     * the client chose cannot be checked for meaning, so add your fixed fields on the server.
+     */
+    readonly attributeKeys?: readonly string[];
+}
+/**
+ * The telemetry events in an untrusted request body, checked again with the package's own
+ * closed lists. An event with an unknown kind or code, a code of another kind, a value outside
+ * its list or range, or without the fields its kind needs, is dropped. An unknown field, a
+ * number or timing summary its kind does not carry, or a wall-clock span above its bound is
+ * removed. The client's `resource` and `attributes` keep only the keys in `attributeKeys`.
+ * Returns an empty list for a body that is not an array or is longer than `maxEvents`.
+ *
+ * The check proves that every value comes from the package's lists or is a number in the range
+ * the engine produces. It cannot prove that a client told the truth: a script can send a
+ * well-formed event that never happened. It can never send text.
+ *
+ * @example
+ * ```ts
+ * const events = validateTelemetryEvents(await request.json(), { attributeKeys: ['app.version'] });
+ * ```
+ *
+ * @public
+ */
+declare function validateTelemetryEvents(body: unknown, options?: ValidateTelemetryEventsOptions): TelemetryEvent[];
+/** A log record with the fields log services read for time, summary, and counts. @public */
+type TelemetryLogRecord = Record<string, unknown> & {
+    /** The event time in milliseconds since the epoch, which Better Stack and others read. */
+    readonly dt: number;
+    /** A one-line summary, such as `edit.rejected edit.picture-selected`. */
+    readonly message: string;
+    /**
+     * How many times the event happened: `1`, or `repeated` for a deduplication summary, whose
+     * first event was already sent. Sum it to count events; do not count records.
+     */
+    readonly occurrences: number;
+    /** How many failures the record adds to a failure total. See `failureCount`. */
+    readonly failures: number;
+};
+/**
+ * An event as a log record: `dt` for the time, `message` for the live tail, `occurrences` and
+ * `failures` to sum, and every field of the event except the fixed `hint` and `docs` text,
+ * which the code already identifies. Add your own fixed fields, such as a service name, to the
+ * result.
+ *
+ * @example
+ * ```ts
+ * body: JSON.stringify(events.map((event) => ({ ...toLogRecord(event), service: 'my-app' })))
+ * ```
+ *
+ * @public
+ */
+declare function toLogRecord(event: TelemetryEvent): TelemetryLogRecord;
+/** Options for {@link telemetryRoute}. @public */
+interface TelemetryRouteOptions extends ValidateTelemetryEventsOptions {
+    /** Send the checked events on, such as to your log service. Errors are caught and reported. */
+    forward(events: readonly TelemetryEvent[]): unknown;
+    /** Origins allowed to post, such as `['https://app.example.com']`. Omit to allow any. */
+    readonly allowedOrigins?: readonly string[];
+    /** The largest body accepted, in bytes. Defaults to 64 KiB. */
+    readonly maxBodyBytes?: number;
+    /** Called when `forward` throws or rejects, or the log service refuses. Defaults to nothing. */
+    readonly onError?: (error: unknown) => void;
+}
+/**
+ * A Fetch-style handler for telemetry from `httpExporter`: it accepts POST only, checks the
+ * origin, reads at most `maxBodyBytes`, validates every event, and calls `forward` with what
+ * passes. It answers 204 to every request, so a telemetry problem never surfaces in the
+ * editor; use `onError` to see failures. It does not rate-limit; put it behind your platform's
+ * limits.
+ *
+ * @example
+ * ```ts
+ * // Next.js: app/api/telemetry/route.ts
+ * import { telemetryRoute, toLogRecord } from '@docx-editor.dev/telemetry/ingest';
+ *
+ * export const POST = telemetryRoute({
+ *   forward: (events) =>
+ *     fetch(`https://${process.env.BETTERSTACK_INGESTING_HOST}`, {
+ *       method: 'POST',
+ *       headers: {
+ *         'Content-Type': 'application/json',
+ *         Authorization: `Bearer ${process.env.BETTERSTACK_SOURCE_TOKEN}`,
+ *       },
+ *       body: JSON.stringify(events.map(toLogRecord)),
+ *     }),
+ * });
+ * ```
+ *
+ * @public
+ */
+declare function telemetryRoute(options: TelemetryRouteOptions): (request: Request) => Promise<Response>;
+
+export { TelemetryEvent, telemetryRoute, toLogRecord, validateTelemetryEvents };
+export type { TelemetryLogRecord, TelemetryRouteOptions, ValidateTelemetryEventsOptions };

package/dist/ingest/index.js

@@ -0,0 +1 @@
+import {d}from'../chunk-WLWS5CZT.js';import {b as b$1,d as d$1}from'../chunk-W5HFB5EV.js';import'../chunk-DT2KMPUJ.js';var b=50,o=e=>typeof e=="string",u=e=>typeof e=="number"&&Number.isFinite(e),p=e=>typeof e=="boolean",h={"edit.rejected":[["code",o],["origin",o],["tracked",p]],"review.skipped":[["code",o],["count",u]],"font.failed":[["code",o]],history:[["code",o]],"custom-node":[["code",o]],"collab.status":[["status",o],["previous",o],["recovering",p]],"collab.participants":[["count",u]],performance:[["windowMs",u]]},E=["durationMs","activeMs","inputEdits","commandEdits","automationEdits"];function T(e){if(!u(e.schemaVersion)||!u(e.time)||!o(e.editorSessionId)||!o(e.engineVersion))return  false;if(e.kind==="document.open")return e.outcome==="opened"?o(e.sizeBucket)&&u(e.durationMs):e.outcome==="rejected"&&o(e.code);if(e.kind==="document.save")return u(e.durationMs)&&(e.outcome==="saved"?o(e.sizeBucket):e.outcome==="rejected"&&o(e.code));if(e.kind==="session")return e.phase==="start"||(e.phase==="active"||e.phase==="end")&&E.every(t=>u(e[t]));let n=h[e.kind];return !!n&&n.every(([t,s])=>s(e[t]))}function w(e,n){if(n.size===0)return {};let t=d$1(e)??{};return Object.fromEntries(Object.entries(t).filter(([s])=>n.has(s)))}function R(e,n={}){let t=n.maxEvents??b,s=new Set(n.attributeKeys??[]);return !Array.isArray(e)||e.length>t?[]:e.flatMap(r=>{if(!r||typeof r!="object"||Array.isArray(r))return [];let a=r,{resource:d,attributes:l,...i}=a,c=b$1(i);if("dropped"in c||!T(c.event))return [];let g=w(a.attributes,s),{attributes:O,...k}=c.event;return [Object.freeze({...k,resource:w(a.resource,s),attributes:g})]})}function _(e){let{hint:n,docs:t,...s}=e,r="code"in e&&e.code?` ${e.code}`:"";return {...s,dt:e.time,message:`${e.kind}${r}`,occurrences:e.repeated??1,failures:d(e)}}var x=64*1024;async function A(e,n){if(Number(e.headers.get("content-length")??0)>n)return null;let t=e.body;if(!t)return "";let s=t.getReader(),r=[],a=0;for(;;){let{done:i,value:c}=await s.read();if(i)break;if(a+=c.byteLength,a>n)return await s.cancel().catch(()=>{}),null;r.push(c);}let d=new Uint8Array(a),l=0;for(let i of r)d.set(i,l),l+=i.byteLength;return new TextDecoder().decode(d)}function F(e){let n=e.maxBodyBytes??x,t=()=>new Response(null,{status:204}),s=r=>{try{e.onError?.(r);}catch{}};return async r=>{if(r.method!=="POST")return t();if(e.allowedOrigins){let i=r.headers.get("origin");if(!i||!e.allowedOrigins.includes(i))return t()}let a;try{a=await A(r,n);}catch{return t()}if(a===null)return t();let d;try{d=JSON.parse(a);}catch{return t()}let l=R(d,e);if(!l.length)return t();try{let c=await e.forward(l);if(c&&c.ok===!1)throw new Error(`the log service answered ${String(c.status)}`)}catch(i){s(i);}return t()}}export{F as telemetryRoute,_ as toLogRecord,R as validateTelemetryEvents};

package/dist/otel/index.cjs

@@ -0,0 +1 @@
+'use strict';var chunkE2HR5DHZ_cjs=require('../chunk-E2HR5DHZ.cjs'),chunkWGWKNKUT_cjs=require('../chunk-WGWKNKUT.cjs'),api=require('@opentelemetry/api');var E="@docx-editor.dev/telemetry";function M(o){let n=o.getDelegate?.()??o;return /^Noop/.test(n?.constructor?.name??"")}var k=false;function h(o,n){let s=chunkWGWKNKUT_cjs.a();k||s==="production"||!M(o)||!M(n)||(k=true,console.warn("[docx-editor telemetry] otelExporter found no OpenTelemetry SDK. Register a MeterProvider and a TracerProvider before creating the exporter, or pass them as options. Until then every measurement is dropped."));}function C(o,n,s){return o.createObservableGauge(n.name,{unit:n.unit,description:n.description}).addCallback(t=>{for(let{value:i,attributes:a}of s.values())t.observe(i,a);}),{record(t,i={}){s.set(g(i),{value:t,attributes:i});},forget(t){s.delete(g(t));}}}function g(o){return JSON.stringify(Object.keys(o).sort().map(n=>[n,o[n]]))}function f(o){let n={...o.resource,...o.attributes};for(let[s,t]of Object.entries(o))if(!(s==="resource"||s==="attributes"||s==="hint"||s==="docs")){if(typeof t=="string"||typeof t=="number"||typeof t=="boolean")n[`docx_editor.${s}`]=t;else if(s==="shape"&&t&&typeof t=="object")for(let[i,a]of Object.entries(t))typeof a=="string"&&(n[`docx_editor.shape.${i}`]=a);else if(t&&typeof t=="object"&&!Array.isArray(t))for(let[i,a]of Object.entries(t))typeof a=="number"&&(n[`docx_editor.${s}.${i}`]=a);}return n}function j(o={}){let n=o.scope??E,s=()=>o.meterProvider??api.metrics.getMeterProvider(),t=()=>o.tracerProvider??api.trace.getTracerProvider(),i,a,l=new Map,m=new Map,b=false;function P(e){let r=m.get(e);return r||(r=new Map,m.set(e,r)),r}function T(){let e=s();return (e!==i||!a)&&(i=e,a=e.getMeter(n),l.clear()),a}function A(e){let r=T();b||(b=true,setTimeout(()=>h(s(),t()),5e3).unref?.());let c=l.get(e.name);if(c)return c;let u={unit:e.unit,description:e.description},d=e.kind==="counter"?r.createCounter(e.name,u):e.kind==="histogram"?r.createHistogram(e.name,{...u,...e.buckets?{advice:{explicitBucketBoundaries:[...e.buckets]}}:{}}):C(r,e,P(e.name));return l.set(e.name,d),d}return {name:"otel",metric(e){let r=A(e.definition),c=e.attributes;"add"in r?r.add(e.value,c):r.record(e.value,c);},event(e){if(e.kind==="document.open"||e.kind==="document.save"){let u=e.kind==="document.save"||e.outcome==="opened"?e.durationMs:0,d=e.time-u,p=t().getTracer(n).startSpan(`docx_editor.${e.kind}`,{startTime:d,attributes:f(e)},o.parentContext?.());e.outcome==="rejected"&&p.setStatus({code:api.SpanStatusCode.ERROR,message:e.code}),p.end(e.time);return}let r=api.trace.getActiveSpan();if(r){r.addEvent(`docx_editor.${e.kind}`,f(e));return}if(!chunkE2HR5DHZ_cjs.c(e))return;let c=t().getTracer(n).startSpan(`docx_editor.${e.kind}`,{startTime:e.time,attributes:f(e)},o.parentContext?.());c.setStatus({code:api.SpanStatusCode.ERROR,message:"code"in e?e.code:e.kind}),c.end(e.time);},forget(e,r){m.get(e.name)?.delete(g(r));},async flush(){let e=r=>(r.getDelegate?.()??r).forceFlush?.();await Promise.all([e(s()),e(t())]);}}}exports.otelExporter=j;