@dxos/observability 0.8.4-main.a4bbb77 → 0.8.4-main.abd8ff62ef

package/dist/types/src/extensions/posthog/extension.js

@@ -0,0 +1,144 @@
+//
+// Copyright 2025 DXOS.org
+//
+import * as Effect from 'effect/Effect';
+import { log } from '@dxos/log';
+import { stubExtension } from '../stub';
+/** Upload serialized logs to the feedback-logs endpoint. Returns the R2 key on success. */
+const uploadLogs = async (body) => {
+    try {
+        const response = await fetch('/api/feedback-logs', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/x-ndjson' },
+            body,
+        });
+        if (!response.ok) {
+            log.warn('feedback log upload failed', { status: response.status });
+            return undefined;
+        }
+        const { key } = await response.json();
+        return key;
+    }
+    catch (err) {
+        log.warn('feedback log upload error', { error: err });
+        return undefined;
+    }
+};
+/** Create a PostHog-backed observability extension for events, errors, and feedback. */
+export const extensions = Effect.fn(function* ({ config, release, environment, posthog: posthogConfig, logStore, }) {
+    if (typeof window === 'undefined') {
+        log('PostHog is being stubbed because it is running in a worker.');
+        return stubExtension;
+    }
+    const feedbackSurveyId = config.get('runtime.app.env.DX_POSTHOG_FEEDBACK_SURVEY_ID');
+    const apiKey = config.get('runtime.app.env.DX_POSTHOG_API_KEY');
+    const api_host = config.get('runtime.app.env.DX_POSTHOG_API_HOST');
+    if (!apiKey || !api_host) {
+        log.info('Missing POSTHOG_API_KEY or POSTHOG_API_HOST');
+        return stubExtension;
+    }
+    const { default: posthog } = yield* Effect.promise(() => import('posthog-js'));
+    const { logProcessor } = yield* Effect.promise(() => import('./log-processor'));
+    let feedbackSurveyAvailable = null;
+    let unregisterPosthogProcessors;
+    const checkFeedbackSurveyAvailable = () => feedbackSurveyId
+        ? Effect.promise(() => {
+            if (feedbackSurveyAvailable !== null) {
+                return Promise.resolve(feedbackSurveyAvailable);
+            }
+            return new Promise((resolve) => {
+                posthog.getSurveys((surveys) => {
+                    const found = surveys.some((s) => s.id === feedbackSurveyId);
+                    feedbackSurveyAvailable = found;
+                    resolve(found);
+                });
+            });
+        })
+        : Effect.succeed(false);
+    return {
+        initialize: () => Effect.sync(() => {
+            // https://posthog.com/docs/libraries/js/config
+            posthog.init(apiKey, {
+                api_host,
+                mask_all_text: true,
+                capture_exceptions: true,
+                ...posthogConfig,
+            });
+            if (release || environment) {
+                posthog.register({
+                    ...(release ? { release } : {}),
+                    ...(environment ? { environment } : {}),
+                });
+            }
+            unregisterPosthogProcessors?.();
+            const removePosthogLog = log.addProcessor(logProcessor);
+            unregisterPosthogProcessors = () => {
+                removePosthogLog();
+            };
+        }),
+        close: () => Effect.sync(() => {
+            unregisterPosthogProcessors?.();
+            unregisterPosthogProcessors = undefined;
+        }),
+        enable: () => Effect.sync(() => posthog.opt_in_capturing()),
+        disable: () => Effect.sync(() => posthog.opt_out_capturing()),
+        identify: (distinctId, attributes, setOnceAttributes) => {
+            posthog.identify(distinctId, attributes, setOnceAttributes);
+        },
+        alias: (distinctId, previousId) => {
+            posthog.alias(distinctId, previousId);
+        },
+        setTags: (tags) => {
+            posthog.register_for_session(tags);
+        },
+        get enabled() {
+            return posthog.is_capturing();
+        },
+        apis: [
+            {
+                kind: 'events',
+                isAvailable: () => Effect.succeed(true),
+                captureEvent: (event, attributes) => {
+                    posthog.capture(event, attributes);
+                },
+            },
+            {
+                kind: 'errors',
+                isAvailable: () => Effect.succeed(true),
+                captureException: (error, attributes) => {
+                    posthog.captureException(error, attributes);
+                },
+            },
+            {
+                kind: 'feedback',
+                // TODO(wittjosiah): Support custom surveys.
+                captureUserFeedback: (form) => {
+                    posthog.getSurveys(async (surveys) => {
+                        const survey = surveys.find((survey) => survey.id === feedbackSurveyId);
+                        if (!survey || survey.questions.length === 0) {
+                            log.error('Missing feedback survey or survey has no questions', { feedbackSurveyId });
+                            return;
+                        }
+                        let debugLogDumpKey = null;
+                        if (form.includeLogs !== false && logStore !== undefined) {
+                            const ndjson = await logStore.export();
+                            if (ndjson.length > 0) {
+                                debugLogDumpKey = (await uploadLogs(ndjson)) ?? 'failed';
+                            }
+                        }
+                        // https://posthog.com/docs/surveys/implementing-custom-surveys
+                        const question = survey.questions[0];
+                        posthog.capture('survey sent', {
+                            $survey_id: survey.id,
+                            $survey_questions: [{ id: question.id, question: question.question }],
+                            [`$survey_response_${question.id}`]: form.message,
+                            debug_log_dump_key: debugLogDumpKey,
+                        });
+                    });
+                },
+                isAvailable: checkFeedbackSurveyAvailable,
+            },
+        ],
+    };
+});
+//# sourceMappingURL=extension.js.map

package/dist/types/src/extensions/posthog/extension.js.map

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

package/dist/types/src/extensions/posthog/index.d.ts

@@ -0,0 +1,2 @@
+export * from './extension';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/src/extensions/posthog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/index.ts"],"names":[],"mappings":"AAIA,cAAc,aAAa,CAAC"}

package/dist/types/src/extensions/posthog/index.js

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+export * from './extension';
+//# sourceMappingURL=index.js.map

package/dist/types/src/extensions/posthog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/extensions/posthog/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,cAAc,aAAa,CAAC"}

package/dist/types/src/extensions/posthog/log-processor.d.ts

@@ -0,0 +1,3 @@
+import { type LogProcessor } from '@dxos/log';
+export declare const logProcessor: LogProcessor;
+//# sourceMappingURL=log-processor.d.ts.map

package/dist/types/src/extensions/posthog/log-processor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2C,KAAK,YAAY,EAAa,MAAM,WAAW,CAAC;AAElG,eAAO,MAAM,YAAY,EAAE,YAiC1B,CAAC"}

package/dist/types/src/extensions/posthog/log-processor.js

@@ -0,0 +1,36 @@
+//
+// Copyright 2025 DXOS.org
+//
+import posthog from 'posthog-js';
+import { InvariantViolation } from '@dxos/invariant';
+import { LogLevel, shouldLog } from '@dxos/log';
+export const logProcessor = (config, entry) => {
+    // Don't forward logs from remote sessions.
+    if (!shouldLog(entry, config.captureFilters) || entry.meta?.S?.remoteSessionId) {
+        return;
+    }
+    let capturedError = entry.error;
+    if (capturedError == null && entry.level === LogLevel.ERROR) {
+        capturedError = Object.values(entry.context ?? {}).find((v) => v instanceof Error);
+    }
+    if (!capturedError) {
+        return;
+    }
+    const additionalProperties = {};
+    const { filename, line } = entry.computedMeta;
+    if (filename !== undefined && line !== undefined) {
+        additionalProperties.transaction = `${filename}:${line}`;
+    }
+    if (entry.meta?.S?.hostSessionId) {
+        additionalProperties.service_host_issue = true;
+        additionalProperties.service_host_session = entry.meta.S.hostSessionId;
+    }
+    if (entry.meta?.S?.uptimeSeconds != null) {
+        additionalProperties.uptime_seconds = entry.meta.S.uptimeSeconds;
+    }
+    if (capturedError instanceof InvariantViolation) {
+        additionalProperties.invariant_violation = true;
+    }
+    posthog.captureException(capturedError, additionalProperties);
+};
+//# sourceMappingURL=log-processor.js.map

package/dist/types/src/extensions/posthog/log-processor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.js","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,OAAO,MAAM,YAAY,CAAC;AAEjC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAiC,QAAQ,EAAqB,SAAS,EAAE,MAAM,WAAW,CAAC;AAElG,MAAM,CAAC,MAAM,YAAY,GAAiB,CAAC,MAAiB,EAAE,KAAe,EAAE,EAAE;IAC/E,2CAA2C;IAC3C,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC;QAC/E,OAAO;IACT,CAAC;IAED,IAAI,aAAa,GAAG,KAAK,CAAC,KAAK,CAAC;IAChC,IAAI,aAAa,IAAI,IAAI,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,KAAK,EAAE,CAAC;QAC5D,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAc,EAAE,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,oBAAoB,GAA8C,EAAE,CAAC;IAC3E,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,YAAY,CAAC;IAC9C,IAAI,QAAQ,KAAK,SAAS,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACjD,oBAAoB,CAAC,WAAW,GAAG,GAAG,QAAQ,IAAI,IAAI,EAAE,CAAC;IAC3D,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC;QACjC,oBAAoB,CAAC,kBAAkB,GAAG,IAAI,CAAC;QAC/C,oBAAoB,CAAC,oBAAoB,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;IACzE,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,aAAa,IAAI,IAAI,EAAE,CAAC;QACzC,oBAAoB,CAAC,cAAc,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,aAAa,CAAC;IACnE,CAAC;IAED,IAAI,aAAa,YAAY,kBAAkB,EAAE,CAAC;QAChD,oBAAoB,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAClD,CAAC;IAED,OAAO,CAAC,gBAAgB,CAAC,aAAa,EAAE,oBAAoB,CAAC,CAAC;AAChE,CAAC,CAAC"}

package/dist/types/src/extensions/posthog/log-processor.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=log-processor.test.d.ts.map

package/dist/types/src/extensions/posthog/log-processor.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.test.d.ts","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.test.ts"],"names":[],"mappings":""}

package/dist/types/src/extensions/posthog/log-processor.test.js

@@ -0,0 +1,146 @@
+//
+// Copyright 2025 DXOS.org
+//
+import { beforeEach, describe, expect, test, vi } from 'vitest';
+import { InvariantViolation } from '@dxos/invariant';
+import { LogEntry, LogLevel } from '@dxos/log';
+// Replace the posthog-js module with a stub so log-processor's top-level import resolves to our mock.
+// Dynamic imports are used so that both the mock and log-processor are loaded after vi.mock is hoisted.
+vi.mock('posthog-js', () => ({
+    default: {
+        captureException: vi.fn(),
+    },
+}));
+const { default: posthog } = await import('posthog-js');
+const { logProcessor } = await import('./log-processor');
+const baseConfig = {
+    options: {},
+    captureFilters: [{ level: LogLevel.WARN }],
+    processors: [],
+};
+const createEntry = (overrides = {}) => new LogEntry({
+    level: LogLevel.ERROR,
+    message: 'test error',
+    ...overrides,
+});
+describe('logProcessor', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    test('skips entries that do not pass capture filters', () => {
+        const entry = createEntry({ level: LogLevel.DEBUG });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).not.toHaveBeenCalled();
+    });
+    test('skips entries from remote sessions', () => {
+        const entry = createEntry({
+            error: new Error('test'),
+            meta: { F: 'test.ts', L: 1, S: { remoteSessionId: 'remote-123' } },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).not.toHaveBeenCalled();
+    });
+    test('skips entries without errors', () => {
+        const entry = createEntry({ error: undefined, context: {} });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).not.toHaveBeenCalled();
+    });
+    test('captures error from entry.error', () => {
+        const error = new Error('direct error');
+        const entry = createEntry({
+            error,
+            meta: { F: 'packages/sdk/observability/src/test.ts', L: 42, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(error, expect.objectContaining({
+            transaction: 'packages/sdk/observability/src/test.ts:42',
+        }));
+    });
+    test('captures error from context when level is ERROR but no entry.error', () => {
+        const contextError = new Error('context error');
+        const entry = createEntry({
+            level: LogLevel.ERROR,
+            error: undefined,
+            context: { someKey: contextError },
+            meta: { F: 'test.ts', L: 10, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(contextError, expect.any(Object));
+    });
+    test('sets transaction from file:line metadata', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: '/home/user/project/packages/sdk/observability/src/index.ts', L: 99, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            transaction: 'packages/sdk/observability/src/index.ts:99',
+        }));
+    });
+    test('sets service_host_issue/session for worker entries', () => {
+        const entry = createEntry({
+            error: new Error('worker err'),
+            meta: { F: 'test.ts', L: 1, S: { hostSessionId: 'host-abc' } },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            service_host_issue: true,
+            service_host_session: 'host-abc',
+        }));
+    });
+    test('sets uptime_seconds from metadata', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: 'test.ts', L: 1, S: { uptimeSeconds: 123 } },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            uptime_seconds: 123,
+        }));
+    });
+    test('sets invariant_violation flag for InvariantViolation errors', () => {
+        const error = new InvariantViolation('broken invariant');
+        const entry = createEntry({
+            error,
+            meta: { F: 'test.ts', L: 1, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(error, expect.objectContaining({
+            invariant_violation: true,
+        }));
+    });
+    test('does not set invariant_violation for normal errors', () => {
+        const error = new Error('normal error');
+        const entry = createEntry({
+            error,
+            meta: { F: 'test.ts', L: 1, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        const callArgs = vi.mocked(posthog.captureException).mock.calls[0];
+        expect(callArgs[1]).not.toHaveProperty('invariant_violation');
+    });
+});
+describe('getRelativeFilename', () => {
+    // We test this indirectly through the transaction property set by logProcessor.
+    test('extracts relative path from absolute path containing packages/', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: '/home/user/code/packages/sdk/observability/src/file.ts', L: 5, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            transaction: 'packages/sdk/observability/src/file.ts:5',
+        }));
+    });
+    test('returns original filename if no match', () => {
+        const entry = createEntry({
+            error: new Error('err'),
+            meta: { F: 'no-packages-here.ts', L: 1, S: undefined },
+        });
+        logProcessor(baseConfig, entry);
+        expect(posthog.captureException).toHaveBeenCalledWith(expect.any(Error), expect.objectContaining({
+            transaction: 'no-packages-here.ts:1',
+        }));
+    });
+});
+//# sourceMappingURL=log-processor.test.js.map

package/dist/types/src/extensions/posthog/log-processor.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-processor.test.js","sourceRoot":"","sources":["../../../../../src/extensions/posthog/log-processor.test.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAEhE,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAkB,QAAQ,EAAqB,QAAQ,EAAE,MAAM,WAAW,CAAC;AAElF,sGAAsG;AACtG,wGAAwG;AACxG,EAAE,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC;IAC3B,OAAO,EAAE;QACP,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE;KAC1B;CACF,CAAC,CAAC,CAAC;AACJ,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,CAAC;AACxD,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;AAEzD,MAAM,UAAU,GAAc;IAC5B,OAAO,EAAE,EAAE;IACX,cAAc,EAAE,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC;IAC1C,UAAU,EAAE,EAAE;CACf,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,SAAS,GAA0B,EAAE,EAAY,EAAE,CACtE,IAAI,QAAQ,CAAC;IACX,KAAK,EAAE,QAAQ,CAAC,KAAK;IACrB,OAAO,EAAE,YAAY;IACrB,GAAG,SAAS;CACb,CAAC,CAAC;AAEL,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,UAAU,CAAC,GAAG,EAAE;QACd,EAAE,CAAC,aAAa,EAAE,CAAC;IACrB,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,gDAAgD,EAAE,GAAG,EAAE;QAC1D,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QACrD,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC9C,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,CAAC;YACxB,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,EAAE;SACnE,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACxC,MAAM,KAAK,GAAG,WAAW,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC;QAC7D,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;IAC1D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;QAC3C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK;YACL,IAAI,EAAE,EAAE,CAAC,EAAE,wCAAwC,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE;SAC3E,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CACnD,KAAK,EACL,MAAM,CAAC,gBAAgB,CAAC;YACtB,WAAW,EAAE,2CAA2C;SACzD,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oEAAoE,EAAE,GAAG,EAAE;QAC9E,MAAM,YAAY,GAAG,IAAI,KAAK,CAAC,eAAe,CAAC,CAAC;QAChD,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,KAAK,EAAE,SAAS;YAChB,OAAO,EAAE,EAAE,OAAO,EAAE,YAAY,EAAE;YAClC,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE;SAC5C,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CAAC,YAAY,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,0CAA0C,EAAE,GAAG,EAAE;QACpD,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC;YACvB,IAAI,EAAE,EAAE,CAAC,EAAE,4DAA4D,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE;SAC/F,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CACnD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EACjB,MAAM,CAAC,gBAAgB,CAAC;YACtB,WAAW,EAAE,4CAA4C;SAC1D,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,IAAI,KAAK,CAAC,YAAY,CAAC;YAC9B,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE;SAC/D,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CACnD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EACjB,MAAM,CAAC,gBAAgB,CAAC;YACtB,kBAAkB,EAAE,IAAI;YACxB,oBAAoB,EAAE,UAAU;SACjC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,mCAAmC,EAAE,GAAG,EAAE;QAC7C,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC;YACvB,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,aAAa,EAAE,GAAG,EAAE,EAAE;SACxD,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CACnD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EACjB,MAAM,CAAC,gBAAgB,CAAC;YACtB,cAAc,EAAE,GAAG;SACpB,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACvE,MAAM,KAAK,GAAG,IAAI,kBAAkB,CAAC,kBAAkB,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK;YACL,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE;SAC3C,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CACnD,KAAK,EACL,MAAM,CAAC,gBAAgB,CAAC;YACtB,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC9D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK;YACL,IAAI,EAAE,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE;SAC3C,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACnE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,cAAc,CAAC,qBAAqB,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;IACnC,gFAAgF;IAEhF,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;QAC1E,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC;YACvB,IAAI,EAAE,EAAE,CAAC,EAAE,wDAAwD,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE;SAC1F,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CACnD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EACjB,MAAM,CAAC,gBAAgB,CAAC;YACtB,WAAW,EAAE,0CAA0C;SACxD,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;QACjD,MAAM,KAAK,GAAG,WAAW,CAAC;YACxB,KAAK,EAAE,IAAI,KAAK,CAAC,KAAK,CAAC;YACvB,IAAI,EAAE,EAAE,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE;SACvD,CAAC,CAAC;QACH,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC,oBAAoB,CACnD,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EACjB,MAAM,CAAC,gBAAgB,CAAC;YACtB,WAAW,EAAE,uBAAuB;SACrC,CAAC,CACH,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/types/src/extensions/stub.d.ts

@@ -0,0 +1,3 @@
+import { type Extension } from '../observability-extension';
+export declare const stubExtension: Extension;
+//# sourceMappingURL=stub.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stub.d.ts","sourceRoot":"","sources":["../../../../src/extensions/stub.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,eAAO,MAAM,aAAa,EAAE,SAU3B,CAAC"}

package/dist/types/src/extensions/stub.js

@@ -0,0 +1,16 @@
+//
+// Copyright 2025 DXOS.org
+//
+import * as Effect from 'effect/Effect';
+export const stubExtension = {
+    initialize: () => Effect.succeed(undefined),
+    enable: () => Effect.succeed(undefined),
+    disable: () => Effect.succeed(undefined),
+    flush: () => Effect.succeed(undefined),
+    setTags: () => undefined,
+    get enabled() {
+        return true;
+    },
+    apis: [],
+};
+//# sourceMappingURL=stub.js.map

package/dist/types/src/extensions/stub.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stub.js","sourceRoot":"","sources":["../../../../src/extensions/stub.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,MAAM,CAAC,MAAM,aAAa,GAAc;IACtC,UAAU,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IAC3C,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACvC,OAAO,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACxC,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;IACtC,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS;IACxB,IAAI,OAAO;QACT,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,EAAE,EAAE;CACT,CAAC"}

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

@@ -1,3 +1,4 @@
-export * from './helpers';
-export * from './observability';
+export * as Observability from './observability';
+export * as ObservabilityExtension from './observability-extension';
+export * as ObservabilityProvider from './providers';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,sBAAsB,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,aAAa,CAAC"}

package/dist/types/src/index.js

@@ -1,6 +1,7 @@
 //
-// Copyright 2023 DXOS.org
+// Copyright 2025 DXOS.org
 //
-export * from './helpers';
-export * from './observability';
+export * as Observability from './observability';
+export * as ObservabilityExtension from './observability-extension';
+export * as ObservabilityProvider from './providers';
 //# sourceMappingURL=index.js.map

package/dist/types/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAEF,OAAO,KAAK,aAAa,MAAM,iBAAiB,CAAC;AACjD,OAAO,KAAK,sBAAsB,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,qBAAqB,MAAM,aAAa,CAAC"}

package/dist/types/src/observability-extension.d.ts

@@ -0,0 +1,74 @@
+import type * as Effect from 'effect/Effect';
+export * from './extensions';
+/**
+ * Kind of observability extension.
+ *
+ * - errors: Error tracking (e.g., PostHog)
+ * - events: Product usage event tracking (e.g., PostHog)
+ * - feedback: User feedback submission (e.g., PostHog)
+ * - logs: Structured logging (e.g., OTEL)
+ * - metrics: Metric data (e.g., OTEL)
+ * - traces: Distributed tracing (e.g., OTEL)
+ */
+export type Kind = 'errors' | 'events' | 'feedback' | 'logs' | 'metrics' | 'traces';
+/**
+ * Base for every extension API variant. All kinds implement availability the same way.
+ */
+export type ExtensionApiBase<K extends Kind = Kind> = {
+    kind: K;
+    isAvailable(): Effect.Effect<boolean>;
+};
+/**
+ * Metrics extension API (kind-specific methods only).
+ */
+export type Metrics = {
+    gauge(name: string, value: number, tags?: Attributes): void;
+    increment(name: string, value?: number, tags?: Attributes): void;
+    distribution(name: string, value: number, tags?: Attributes): void;
+};
+/**
+ * Errors extension API (kind-specific methods only).
+ */
+export type Errors = {
+    captureException(error: Error, attributes?: Attributes): void;
+};
+/**
+ * Events extension API (kind-specific methods only).
+ */
+export type Events = {
+    captureEvent(event: string, attributes?: Attributes): void;
+};
+/**
+ * Feedback extension API (kind-specific methods only).
+ */
+export type Feedback = {
+    captureUserFeedback(form: FeedbackForm): void;
+};
+export type ExtensionApi = (ExtensionApiBase<'errors'> & Errors) | (ExtensionApiBase<'events'> & Events) | (ExtensionApiBase<'feedback'> & Feedback) | ExtensionApiBase<'logs'> | (ExtensionApiBase<'metrics'> & Metrics) | ExtensionApiBase<'traces'>;
+/**
+ * Feedback form to be captured by the feedback extension.
+ */
+export type FeedbackForm = {
+    message: string;
+    includeLogs?: boolean;
+};
+/**
+ * Attributes to be attached to observability events.
+ */
+export type Attributes = Record<string, string | number | boolean | undefined>;
+/**
+ * Implementation of an observability extension API.
+ */
+export type Extension = {
+    initialize?(): Effect.Effect<void, Error>;
+    close?(): Effect.Effect<void>;
+    enable?(): Effect.Effect<void>;
+    disable?(): Effect.Effect<void>;
+    flush?(): Effect.Effect<void>;
+    identify?(distinctId: string, attributes?: Attributes, setOnceAttributes?: Attributes): void;
+    alias?(distinctId: string, previousId?: string): void;
+    setTags?(tags: Record<string, string>): void;
+    enabled: boolean;
+    apis: ExtensionApi[];
+};
+//# sourceMappingURL=observability-extension.d.ts.map

package/dist/types/src/observability-extension.d.ts.map

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

package/dist/types/src/observability-extension.js

@@ -0,0 +1,5 @@
+//
+// Copyright 2025 DXOS.org
+//
+export * from './extensions';
+//# sourceMappingURL=observability-extension.js.map

package/dist/types/src/observability-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-extension.js","sourceRoot":"","sources":["../../../src/observability-extension.ts"],"names":[],"mappings":"AAAA,EAAE;AACF,0BAA0B;AAC1B,EAAE;AAIF,cAAc,cAAc,CAAC"}