@theia/telemetry 1.74.0-next.68

package/lib/common/index.js

@@ -0,0 +1,25 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./telemetry-consent-provider"), exports);
+tslib_1.__exportStar(require("./telemetry-preferences"), exports);
+tslib_1.__exportStar(require("./telemetry-protocol"), exports);
+tslib_1.__exportStar(require("./telemetry-service"), exports);
+tslib_1.__exportStar(require("./telemetry-topic"), exports);
+tslib_1.__exportStar(require("./telemetry-types"), exports);
+//# sourceMappingURL=index.js.map

package/lib/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,uEAA6C;AAC7C,kEAAwC;AACxC,+DAAqC;AACrC,8DAAoC;AACpC,4DAAkC;AAClC,4DAAkC"}

package/lib/common/telemetry-consent-provider.d.ts

@@ -0,0 +1,24 @@
+import { Emitter, Event } from '@theia/core/lib/common';
+import { TelemetryPreferences } from './telemetry-preferences';
+import { TelemetryEventKind } from './telemetry-service';
+import { TelemetryLevel } from './telemetry-types';
+/** @experimental */
+export declare const TelemetryConsentProvider: unique symbol;
+/** @experimental */
+export interface TelemetryConsentProvider {
+    readonly level: TelemetryLevel;
+    readonly onDidChangeTelemetryLevel: Event<TelemetryLevel>;
+}
+/** @experimental */
+export declare function isKindAllowedByLevel(level: TelemetryLevel, kind: TelemetryEventKind): boolean;
+/** @experimental */
+export declare class PreferenceTelemetryConsentProvider implements TelemetryConsentProvider {
+    protected currentLevel: TelemetryLevel;
+    protected readonly onDidChangeTelemetryLevelEmitter: Emitter<TelemetryLevel>;
+    readonly onDidChangeTelemetryLevel: Event<TelemetryLevel>;
+    protected readonly preferences: TelemetryPreferences;
+    protected init(): void;
+    protected setLevel(level: TelemetryLevel): void;
+    get level(): TelemetryLevel;
+}
+//# sourceMappingURL=telemetry-consent-provider.d.ts.map

package/lib/common/telemetry-consent-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-consent-provider.d.ts","sourceRoot":"","sources":["../../src/common/telemetry-consent-provider.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,EAAmB,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,oBAAoB;AACpB,eAAO,MAAM,wBAAwB,eAAqC,CAAC;AAE3E,oBAAoB;AACpB,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAC/B,QAAQ,CAAC,yBAAyB,EAAE,KAAK,CAAC,cAAc,CAAC,CAAC;CAC7D;AAED,oBAAoB;AACpB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,cAAc,EAAE,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAI7F;AAED,oBAAoB;AACpB,qBACa,kCAAmC,YAAW,wBAAwB;IAE/E,SAAS,CAAC,YAAY,EAAE,cAAc,CAAS;IAC/C,SAAS,CAAC,QAAQ,CAAC,gCAAgC,0BAAiC;IACpF,QAAQ,CAAC,yBAAyB,wBAA+C;IAGjF,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAGrD,SAAS,CAAC,IAAI,IAAI,IAAI;IAWtB,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAO/C,IAAI,KAAK,IAAI,cAAc,CAE1B;CACJ"}

package/lib/common/telemetry-consent-provider.js

@@ -0,0 +1,73 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PreferenceTelemetryConsentProvider = exports.TelemetryConsentProvider = void 0;
+exports.isKindAllowedByLevel = isKindAllowedByLevel;
+const tslib_1 = require("tslib");
+const common_1 = require("@theia/core/lib/common");
+const inversify_1 = require("@theia/core/shared/inversify");
+const telemetry_preferences_1 = require("./telemetry-preferences");
+/** @experimental */
+exports.TelemetryConsentProvider = Symbol('TelemetryConsentProvider');
+/** @experimental */
+function isKindAllowedByLevel(level, kind) {
+    return level === 'all'
+        || level === 'error' && (kind === 'error' || kind === 'crash')
+        || level === 'crash' && kind === 'crash';
+}
+/** @experimental */
+let PreferenceTelemetryConsentProvider = class PreferenceTelemetryConsentProvider {
+    constructor() {
+        this.currentLevel = 'off';
+        this.onDidChangeTelemetryLevelEmitter = new common_1.Emitter();
+        this.onDidChangeTelemetryLevel = this.onDidChangeTelemetryLevelEmitter.event;
+    }
+    init() {
+        this.preferences.onPreferenceChanged(change => {
+            if (change.preferenceName === telemetry_preferences_1.TELEMETRY_LEVEL) {
+                this.setLevel(this.preferences[telemetry_preferences_1.TELEMETRY_LEVEL]);
+            }
+        });
+        this.preferences.ready.then(() => {
+            this.setLevel(this.preferences[telemetry_preferences_1.TELEMETRY_LEVEL]);
+        }, () => undefined);
+    }
+    setLevel(level) {
+        if (level !== this.currentLevel) {
+            this.currentLevel = level;
+            this.onDidChangeTelemetryLevelEmitter.fire(level);
+        }
+    }
+    get level() {
+        return this.currentLevel;
+    }
+};
+exports.PreferenceTelemetryConsentProvider = PreferenceTelemetryConsentProvider;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(telemetry_preferences_1.TelemetryPreferences),
+    tslib_1.__metadata("design:type", Object)
+], PreferenceTelemetryConsentProvider.prototype, "preferences", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.postConstruct)(),
+    tslib_1.__metadata("design:type", Function),
+    tslib_1.__metadata("design:paramtypes", []),
+    tslib_1.__metadata("design:returntype", void 0)
+], PreferenceTelemetryConsentProvider.prototype, "init", null);
+exports.PreferenceTelemetryConsentProvider = PreferenceTelemetryConsentProvider = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], PreferenceTelemetryConsentProvider);
+//# sourceMappingURL=telemetry-consent-provider.js.map

package/lib/common/telemetry-consent-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-consent-provider.js","sourceRoot":"","sources":["../../src/common/telemetry-consent-provider.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAkBhF,oDAIC;;AApBD,mDAAwD;AACxD,4DAAiF;AACjF,mEAAgF;AAIhF,oBAAoB;AACP,QAAA,wBAAwB,GAAG,MAAM,CAAC,0BAA0B,CAAC,CAAC;AAQ3E,oBAAoB;AACpB,SAAgB,oBAAoB,CAAC,KAAqB,EAAE,IAAwB;IAChF,OAAO,KAAK,KAAK,KAAK;WACf,KAAK,KAAK,OAAO,IAAI,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,CAAC;WAC3D,KAAK,KAAK,OAAO,IAAI,IAAI,KAAK,OAAO,CAAC;AACjD,CAAC;AAED,oBAAoB;AAEb,IAAM,kCAAkC,GAAxC,MAAM,kCAAkC;IAAxC;QAEO,iBAAY,GAAmB,KAAK,CAAC;QAC5B,qCAAgC,GAAG,IAAI,gBAAO,EAAkB,CAAC;QAC3E,8BAAyB,GAAG,IAAI,CAAC,gCAAgC,CAAC,KAAK,CAAC;IA2BrF,CAAC;IArBa,IAAI;QACV,IAAI,CAAC,WAAW,CAAC,mBAAmB,CAAC,MAAM,CAAC,EAAE;YAC1C,IAAI,MAAM,CAAC,cAAc,KAAK,uCAAe,EAAE,CAAC;gBAC5C,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,uCAAe,CAAC,CAAC,CAAC;YACrD,CAAC;QACL,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,EAAE;YAC7B,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,uCAAe,CAAC,CAAC,CAAC;QACrD,CAAC,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IACxB,CAAC;IAES,QAAQ,CAAC,KAAqB;QACpC,IAAI,KAAK,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;YAC9B,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;YAC1B,IAAI,CAAC,gCAAgC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACtD,CAAC;IACL,CAAC;IAED,IAAI,KAAK;QACL,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;CACJ,CAAA;AA/BY,gFAAkC;AAOxB;IADlB,IAAA,kBAAM,EAAC,4CAAoB,CAAC;;uEACwB;AAG3C;IADT,IAAA,yBAAa,GAAE;;;;8DAUf;6CAnBQ,kCAAkC;IAD9C,IAAA,sBAAU,GAAE;GACA,kCAAkC,CA+B9C"}

package/lib/common/telemetry-consent-provider.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry-consent-provider.spec.d.ts.map

package/lib/common/telemetry-consent-provider.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-consent-provider.spec.d.ts","sourceRoot":"","sources":["../../src/common/telemetry-consent-provider.spec.ts"],"names":[],"mappings":""}

package/lib/common/telemetry-consent-provider.spec.js

@@ -0,0 +1,87 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const common_1 = require("@theia/core/lib/common");
+const inversify_1 = require("@theia/core/shared/inversify");
+const telemetry_consent_provider_1 = require("./telemetry-consent-provider");
+const telemetry_preferences_1 = require("./telemetry-preferences");
+describe('telemetry consent provider', () => {
+    it('maps telemetry levels to event kinds', () => {
+        const kinds = ['usage', 'error', 'crash'];
+        const levels = ['off', 'crash', 'error', 'all'];
+        (0, chai_1.expect)(levels.map(level => kinds.filter(kind => (0, telemetry_consent_provider_1.isKindAllowedByLevel)(level, kind)))).to.deep.equal([
+            [],
+            ['crash'],
+            ['error', 'crash'],
+            ['usage', 'error', 'crash']
+        ]);
+    });
+    it('applies and reports preference changes before readiness', () => {
+        const changes = new common_1.Emitter();
+        const ready = new Promise(() => undefined);
+        let level = 'off';
+        const preferences = {
+            get [telemetry_preferences_1.TELEMETRY_LEVEL]() {
+                return level;
+            },
+            [telemetry_preferences_1.TELEMETRY_FILTERS]: {},
+            ready,
+            onPreferenceChanged: changes.event
+        };
+        const container = new inversify_1.Container();
+        container.bind(telemetry_preferences_1.TelemetryPreferences).toConstantValue(preferences);
+        container.bind(telemetry_consent_provider_1.TelemetryConsentProvider).to(telemetry_consent_provider_1.PreferenceTelemetryConsentProvider).inSingletonScope();
+        const provider = container.get(telemetry_consent_provider_1.TelemetryConsentProvider);
+        const observed = [];
+        provider.onDidChangeTelemetryLevel(value => observed.push(value));
+        level = 'error';
+        changes.fire({ preferenceName: telemetry_preferences_1.TELEMETRY_LEVEL });
+        (0, chai_1.expect)(provider.level).to.equal('error');
+        (0, chai_1.expect)(observed).to.deep.equal(['error']);
+    });
+    it('starts off, then reads the preference after readiness and fires on changes', async () => {
+        const changes = new common_1.Emitter();
+        let resolveReady;
+        const ready = new Promise(resolve => resolveReady = resolve);
+        let level = 'error';
+        const preferences = {
+            get [telemetry_preferences_1.TELEMETRY_LEVEL]() {
+                return level;
+            },
+            [telemetry_preferences_1.TELEMETRY_FILTERS]: {},
+            ready,
+            onPreferenceChanged: changes.event
+        };
+        const container = new inversify_1.Container();
+        container.bind(telemetry_preferences_1.TelemetryPreferences).toConstantValue(preferences);
+        container.bind(telemetry_consent_provider_1.TelemetryConsentProvider).to(telemetry_consent_provider_1.PreferenceTelemetryConsentProvider).inSingletonScope();
+        const provider = container.get(telemetry_consent_provider_1.TelemetryConsentProvider);
+        const observed = [];
+        provider.onDidChangeTelemetryLevel(value => observed.push(value));
+        (0, chai_1.expect)(provider.level).to.equal('off');
+        resolveReady();
+        await preferences.ready;
+        await Promise.resolve();
+        (0, chai_1.expect)(provider.level).to.equal('error');
+        level = 'all';
+        changes.fire({ preferenceName: telemetry_preferences_1.TELEMETRY_LEVEL });
+        (0, chai_1.expect)(provider.level).to.equal('all');
+        (0, chai_1.expect)(observed).to.deep.equal(['error', 'all']);
+    });
+});
+//# sourceMappingURL=telemetry-consent-provider.spec.js.map

package/lib/common/telemetry-consent-provider.spec.js.map

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

package/lib/common/telemetry-preferences.d.ts

@@ -0,0 +1,29 @@
+import { PreferenceProxy } from '@theia/core/lib/common/preferences/preference-proxy';
+import { PreferenceSchema } from '@theia/core/lib/common/preferences/preference-schema';
+import { PreferenceService } from '@theia/core/lib/common/preferences/preference-service';
+import { interfaces } from '@theia/core/shared/inversify';
+import { TelemetryLevel } from './telemetry-types';
+/** @experimental */
+export declare const TELEMETRY_LEVEL = "telemetry.telemetryLevel";
+/** @experimental */
+export declare const TELEMETRY_FILTERS = "telemetry.filters";
+/** @experimental */
+export type TelemetryFilters = Record<string, string[]>;
+/** @experimental */
+export interface TelemetryConfiguration {
+    [TELEMETRY_LEVEL]: TelemetryLevel;
+    [TELEMETRY_FILTERS]: TelemetryFilters;
+}
+/** @experimental */
+export declare const TelemetryPreferenceSchema: PreferenceSchema;
+/** @experimental */
+export declare const TelemetryPreferenceContribution: unique symbol;
+/** @experimental */
+export declare const TelemetryPreferences: unique symbol;
+/** @experimental */
+export type TelemetryPreferences = PreferenceProxy<TelemetryConfiguration>;
+/** @experimental */
+export declare function createTelemetryPreferences(preferences: PreferenceService, schema?: PreferenceSchema): TelemetryPreferences;
+/** @experimental */
+export declare function bindTelemetryPreferences(bind: interfaces.Bind): void;
+//# sourceMappingURL=telemetry-preferences.d.ts.map

package/lib/common/telemetry-preferences.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-preferences.d.ts","sourceRoot":"","sources":["../../src/common/telemetry-preferences.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAyB,eAAe,EAAE,MAAM,qDAAqD,CAAC;AAC7G,OAAO,EAA0B,gBAAgB,EAAE,MAAM,sDAAsD,CAAC;AAChH,OAAO,EAAE,iBAAiB,EAAE,MAAM,uDAAuD,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD,oBAAoB;AACpB,eAAO,MAAM,eAAe,6BAA6B,CAAC;AAC1D,oBAAoB;AACpB,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAErD,oBAAoB;AACpB,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;AAExD,oBAAoB;AACpB,MAAM,WAAW,sBAAsB;IACnC,CAAC,eAAe,CAAC,EAAE,cAAc,CAAC;IAClC,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CACzC;AAED,oBAAoB;AACpB,eAAO,MAAM,yBAAyB,EAAE,gBA4BvC,CAAC;AAEF,oBAAoB;AACpB,eAAO,MAAM,+BAA+B,eAA4C,CAAC;AACzF,oBAAoB;AACpB,eAAO,MAAM,oBAAoB,eAAiC,CAAC;AACnE,oBAAoB;AACpB,MAAM,MAAM,oBAAoB,GAAG,eAAe,CAAC,sBAAsB,CAAC,CAAC;AAE3E,oBAAoB;AACpB,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,iBAAiB,EAAE,MAAM,GAAE,gBAA4C,GAAG,oBAAoB,CAErJ;AAED,oBAAoB;AACpB,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,GAAG,IAAI,CAQpE"}

package/lib/common/telemetry-preferences.js

@@ -0,0 +1,77 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryPreferences = exports.TelemetryPreferenceContribution = exports.TelemetryPreferenceSchema = exports.TELEMETRY_FILTERS = exports.TELEMETRY_LEVEL = void 0;
+exports.createTelemetryPreferences = createTelemetryPreferences;
+exports.bindTelemetryPreferences = bindTelemetryPreferences;
+const nls_1 = require("@theia/core/lib/common/nls");
+const preference_scope_1 = require("@theia/core/lib/common/preferences/preference-scope");
+const preference_proxy_1 = require("@theia/core/lib/common/preferences/preference-proxy");
+const preference_schema_1 = require("@theia/core/lib/common/preferences/preference-schema");
+const preference_service_1 = require("@theia/core/lib/common/preferences/preference-service");
+/** @experimental */
+exports.TELEMETRY_LEVEL = 'telemetry.telemetryLevel';
+/** @experimental */
+exports.TELEMETRY_FILTERS = 'telemetry.filters';
+/** @experimental */
+exports.TelemetryPreferenceSchema = {
+    scope: preference_scope_1.PreferenceScope.User,
+    properties: {
+        [exports.TELEMETRY_LEVEL]: {
+            type: 'string',
+            enum: ['off', 'crash', 'error', 'all'],
+            enumDescriptions: [
+                nls_1.nls.localizeByDefault('Disables all product telemetry.'),
+                nls_1.nls.localizeByDefault('Sends OS level crash reports.'),
+                nls_1.nls.localizeByDefault('Sends general error telemetry and crash reports.'),
+                nls_1.nls.localizeByDefault('Sends usage data, errors, and crash reports.')
+            ],
+            default: 'off',
+            description: nls_1.nls.localizeByDefault('Controls the level of telemetry.')
+        },
+        [exports.TELEMETRY_FILTERS]: {
+            type: 'object',
+            additionalProperties: {
+                type: 'array',
+                items: {
+                    type: 'string'
+                }
+            },
+            default: {},
+            description: nls_1.nls.localize('theia/telemetry/filters', 'Restrict the topic patterns delivered to each telemetry sink. Missing entries allow all sink interests; empty arrays disable a sink.')
+        }
+    }
+};
+/** @experimental */
+exports.TelemetryPreferenceContribution = Symbol('TelemetryPreferenceContribution');
+/** @experimental */
+exports.TelemetryPreferences = Symbol('TelemetryPreferences');
+/** @experimental */
+function createTelemetryPreferences(preferences, schema = exports.TelemetryPreferenceSchema) {
+    return (0, preference_proxy_1.createPreferenceProxy)(preferences, schema);
+}
+/** @experimental */
+function bindTelemetryPreferences(bind) {
+    bind(exports.TelemetryPreferences).toDynamicValue(ctx => {
+        const preferences = ctx.container.get(preference_service_1.PreferenceService);
+        const contribution = ctx.container.get(exports.TelemetryPreferenceContribution);
+        return createTelemetryPreferences(preferences, contribution.schema);
+    }).inSingletonScope();
+    bind(exports.TelemetryPreferenceContribution).toConstantValue({ schema: exports.TelemetryPreferenceSchema });
+    bind(preference_schema_1.PreferenceContribution).toService(exports.TelemetryPreferenceContribution);
+}
+//# sourceMappingURL=telemetry-preferences.js.map

package/lib/common/telemetry-preferences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-preferences.js","sourceRoot":"","sources":["../../src/common/telemetry-preferences.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AA+DhF,gEAEC;AAGD,4DAQC;AA1ED,oDAAiD;AACjD,0FAAsF;AACtF,0FAA6G;AAC7G,4FAAgH;AAChH,8FAA0F;AAI1F,oBAAoB;AACP,QAAA,eAAe,GAAG,0BAA0B,CAAC;AAC1D,oBAAoB;AACP,QAAA,iBAAiB,GAAG,mBAAmB,CAAC;AAWrD,oBAAoB;AACP,QAAA,yBAAyB,GAAqB;IACvD,KAAK,EAAE,kCAAe,CAAC,IAAI;IAC3B,UAAU,EAAE;QACR,CAAC,uBAAe,CAAC,EAAE;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;YACtC,gBAAgB,EAAE;gBACd,SAAG,CAAC,iBAAiB,CAAC,iCAAiC,CAAC;gBACxD,SAAG,CAAC,iBAAiB,CAAC,+BAA+B,CAAC;gBACtD,SAAG,CAAC,iBAAiB,CAAC,kDAAkD,CAAC;gBACzE,SAAG,CAAC,iBAAiB,CAAC,8CAA8C,CAAC;aACxE;YACD,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,SAAG,CAAC,iBAAiB,CAAC,kCAAkC,CAAC;SACzE;QACD,CAAC,yBAAiB,CAAC,EAAE;YACjB,IAAI,EAAE,QAAQ;YACd,oBAAoB,EAAE;gBAClB,IAAI,EAAE,OAAO;gBACb,KAAK,EAAE;oBACH,IAAI,EAAE,QAAQ;iBACjB;aACJ;YACD,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,SAAG,CAAC,QAAQ,CAAC,yBAAyB,EAC/C,sIAAsI,CAAC;SAC9I;KACJ;CACJ,CAAC;AAEF,oBAAoB;AACP,QAAA,+BAA+B,GAAG,MAAM,CAAC,iCAAiC,CAAC,CAAC;AACzF,oBAAoB;AACP,QAAA,oBAAoB,GAAG,MAAM,CAAC,sBAAsB,CAAC,CAAC;AAInE,oBAAoB;AACpB,SAAgB,0BAA0B,CAAC,WAA8B,EAAE,SAA2B,iCAAyB;IAC3H,OAAO,IAAA,wCAAqB,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC;AAED,oBAAoB;AACpB,SAAgB,wBAAwB,CAAC,IAAqB;IAC1D,IAAI,CAAC,4BAAoB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;QAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAoB,sCAAiB,CAAC,CAAC;QAC5E,MAAM,YAAY,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAyB,uCAA+B,CAAC,CAAC;QAChG,OAAO,0BAA0B,CAAC,WAAW,EAAE,YAAY,CAAC,MAAM,CAAC,CAAC;IACxE,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACtB,IAAI,CAAC,uCAA+B,CAAC,CAAC,eAAe,CAAC,EAAE,MAAM,EAAE,iCAAyB,EAAE,CAAC,CAAC;IAC7F,IAAI,CAAC,0CAAsB,CAAC,CAAC,SAAS,CAAC,uCAA+B,CAAC,CAAC;AAC5E,CAAC"}

package/lib/common/telemetry-preferences.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=telemetry-preferences.spec.d.ts.map

package/lib/common/telemetry-preferences.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-preferences.spec.d.ts","sourceRoot":"","sources":["../../src/common/telemetry-preferences.spec.ts"],"names":[],"mappings":""}

package/lib/common/telemetry-preferences.spec.js

@@ -0,0 +1,50 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const chai_1 = require("chai");
+const preference_scope_1 = require("@theia/core/lib/common/preferences/preference-scope");
+const telemetry_preferences_1 = require("./telemetry-preferences");
+describe('telemetry preferences', () => {
+    it('defines only the level and filters preference keys', () => {
+        (0, chai_1.expect)(Object.keys(telemetry_preferences_1.TelemetryPreferenceSchema.properties)).to.deep.equal([telemetry_preferences_1.TELEMETRY_LEVEL, telemetry_preferences_1.TELEMETRY_FILTERS]);
+    });
+    it('limits telemetry preferences to user scope', () => {
+        (0, chai_1.expect)(telemetry_preferences_1.TelemetryPreferenceSchema.scope).to.equal(preference_scope_1.PreferenceScope.User);
+    });
+    it('uses safe defaults and describes each telemetry level', () => {
+        (0, chai_1.expect)(telemetry_preferences_1.TelemetryPreferenceSchema.properties[telemetry_preferences_1.TELEMETRY_LEVEL]).to.deep.include({
+            type: 'string',
+            enum: ['off', 'crash', 'error', 'all'],
+            enumDescriptions: [
+                'Disables all product telemetry.',
+                'Sends OS level crash reports.',
+                'Sends general error telemetry and crash reports.',
+                'Sends usage data, errors, and crash reports.'
+            ],
+            default: 'off'
+        });
+        (0, chai_1.expect)(telemetry_preferences_1.TelemetryPreferenceSchema.properties[telemetry_preferences_1.TELEMETRY_FILTERS].default).to.deep.equal({});
+    });
+    it('defines filters as sink IDs mapped to arrays of topic patterns', () => {
+        (0, chai_1.expect)(telemetry_preferences_1.TelemetryPreferenceSchema.properties[telemetry_preferences_1.TELEMETRY_FILTERS]).to.include({ type: 'object' });
+        (0, chai_1.expect)(telemetry_preferences_1.TelemetryPreferenceSchema.properties[telemetry_preferences_1.TELEMETRY_FILTERS].additionalProperties).to.deep.equal({
+            type: 'array',
+            items: { type: 'string' }
+        });
+    });
+});
+//# sourceMappingURL=telemetry-preferences.spec.js.map

package/lib/common/telemetry-preferences.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-preferences.spec.js","sourceRoot":"","sources":["../../src/common/telemetry-preferences.spec.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAEhF,+BAA8B;AAC9B,0FAAsF;AACtF,mEAIiC;AAEjC,QAAQ,CAAC,uBAAuB,EAAE,GAAG,EAAE;IACnC,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC1D,IAAA,aAAM,EAAC,MAAM,CAAC,IAAI,CAAC,iDAAyB,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,uCAAe,EAAE,yCAAiB,CAAC,CAAC,CAAC;IAClH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QAClD,IAAA,aAAM,EAAC,iDAAyB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,kCAAe,CAAC,IAAI,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC7D,IAAA,aAAM,EAAC,iDAAyB,CAAC,UAAU,CAAC,uCAAe,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC;YAC1E,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC;YACtC,gBAAgB,EAAE;gBACd,iCAAiC;gBACjC,+BAA+B;gBAC/B,kDAAkD;gBAClD,8CAA8C;aACjD;YACD,OAAO,EAAE,KAAK;SACjB,CAAC,CAAC;QACH,IAAA,aAAM,EAAC,iDAAyB,CAAC,UAAU,CAAC,yCAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9F,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,gEAAgE,EAAE,GAAG,EAAE;QACtE,IAAA,aAAM,EAAC,iDAAyB,CAAC,UAAU,CAAC,yCAAiB,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC/F,IAAA,aAAM,EAAC,iDAAyB,CAAC,UAAU,CAAC,yCAAiB,CAAC,CAAC,oBAAoB,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC;YAC/F,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;SAC5B,CAAC,CAAC;IACP,CAAC,CAAC,CAAC;AACP,CAAC,CAAC,CAAC"}

package/lib/common/telemetry-protocol.d.ts

@@ -0,0 +1,30 @@
+import { TelemetryData, TelemetryEventKind, TelemetryReportOptions, TelemetryValue } from './telemetry-service';
+/** @experimental */
+export interface TelemetryEvent<T extends object = Record<string, TelemetryValue>> {
+    readonly topic: string;
+    readonly kind: TelemetryEventKind;
+    readonly data?: TelemetryData<T>;
+    readonly attributes?: TelemetryData<Record<string, TelemetryValue>>;
+    readonly session: string;
+    readonly timestamp: number;
+}
+/** @experimental */
+export declare function isValidTelemetryEvent(event: unknown): event is TelemetryEvent;
+/** @experimental */
+export declare function describeTelemetryTopic(topic: unknown): string;
+/** @experimental */
+export declare function describeTelemetryEventTopic(event: unknown): string;
+/** @experimental */
+export declare function createTelemetryEvent<T extends object>(topic: string, session: string, data?: TelemetryData<T>, options?: TelemetryReportOptions): TelemetryEvent<T>;
+/** @experimental */
+export declare function snapshotTelemetryEvent(event: TelemetryEvent): TelemetryEvent;
+/** @experimental */
+export declare const telemetryServicePath = "/services/telemetry";
+/** @experimental */
+export declare const TelemetryRpc: unique symbol;
+/** @experimental */
+export interface TelemetryRpc {
+    notifyEvent(event: TelemetryEvent): void;
+    getLocalSinkInterests(): Promise<string[]>;
+}
+//# sourceMappingURL=telemetry-protocol.d.ts.map

package/lib/common/telemetry-protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-protocol.d.ts","sourceRoot":"","sources":["../../src/common/telemetry-protocol.ts"],"names":[],"mappings":"AAiBA,OAAO,EACH,aAAa,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,cAAc,EAC5E,MAAM,qBAAqB,CAAC;AAG7B,oBAAoB;AACpB,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC;IAC7E,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED,oBAAoB;AACpB,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAY7E;AAED,oBAAoB;AACpB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAE7D;AAED,oBAAoB;AACpB,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAKlE;AAED,oBAAoB;AACpB,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,MAAM,EACjD,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EACvB,OAAO,CAAC,EAAE,sBAAsB,GACjC,cAAc,CAAC,CAAC,CAAC,CASnB;AAED,oBAAoB;AACpB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,cAAc,GAAG,cAAc,CAS5E;AAED,oBAAoB;AACpB,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAE1D,oBAAoB;AACpB,eAAO,MAAM,YAAY,eAAyB,CAAC;AAEnD,oBAAoB;AACpB,MAAM,WAAW,YAAY;IACzB,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,CAAC;IACzC,qBAAqB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9C"}

package/lib/common/telemetry-protocol.js

@@ -0,0 +1,78 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 STMicroelectronics and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryRpc = exports.telemetryServicePath = void 0;
+exports.isValidTelemetryEvent = isValidTelemetryEvent;
+exports.describeTelemetryTopic = describeTelemetryTopic;
+exports.describeTelemetryEventTopic = describeTelemetryEventTopic;
+exports.createTelemetryEvent = createTelemetryEvent;
+exports.snapshotTelemetryEvent = snapshotTelemetryEvent;
+const types_1 = require("@theia/core/lib/common/types");
+const telemetry_service_1 = require("./telemetry-service");
+const telemetry_topic_1 = require("./telemetry-topic");
+/** @experimental */
+function isValidTelemetryEvent(event) {
+    if (!(0, types_1.isObject)(event)) {
+        return false;
+    }
+    return (0, telemetry_topic_1.isValidTelemetryTopic)(event.topic)
+        && (0, telemetry_service_1.isTelemetryEventKind)(event.kind)
+        && typeof event.session === 'string'
+        && event.session.length > 0
+        && typeof event.timestamp === 'number'
+        && Number.isFinite(event.timestamp)
+        && (event.data === undefined || (0, telemetry_service_1.isTelemetryData)(event.data))
+        && (event.attributes === undefined || (0, telemetry_service_1.isTelemetryData)(event.attributes));
+}
+/** @experimental */
+function describeTelemetryTopic(topic) {
+    return typeof topic === 'string' ? topic : '<invalid>';
+}
+/** @experimental */
+function describeTelemetryEventTopic(event) {
+    if (!(0, types_1.isObject)(event)) {
+        return '<invalid>';
+    }
+    return describeTelemetryTopic(event.topic);
+}
+/** @experimental */
+function createTelemetryEvent(topic, session, data, options) {
+    return {
+        topic,
+        kind: options?.kind ?? 'usage',
+        data,
+        attributes: options?.attributes,
+        session,
+        timestamp: Date.now()
+    };
+}
+/** @experimental */
+function snapshotTelemetryEvent(event) {
+    return Object.freeze({
+        topic: event.topic,
+        kind: event.kind,
+        data: (0, telemetry_service_1.snapshotTelemetryData)(event.data),
+        attributes: (0, telemetry_service_1.snapshotTelemetryData)(event.attributes),
+        session: event.session,
+        timestamp: event.timestamp
+    });
+}
+/** @experimental */
+exports.telemetryServicePath = '/services/telemetry';
+/** @experimental */
+exports.TelemetryRpc = Symbol('TelemetryRpc');
+//# sourceMappingURL=telemetry-protocol.js.map

package/lib/common/telemetry-protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-protocol.js","sourceRoot":"","sources":["../../src/common/telemetry-protocol.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAmBhF,sDAYC;AAGD,wDAEC;AAGD,kEAKC;AAGD,oDAcC;AAGD,wDASC;AAvED,wDAAwD;AACxD,2DAE6B;AAC7B,uDAA0D;AAY1D,oBAAoB;AACpB,SAAgB,qBAAqB,CAAC,KAAc;IAChD,IAAI,CAAC,IAAA,gBAAQ,EAAiB,KAAK,CAAC,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,IAAA,uCAAqB,EAAC,KAAK,CAAC,KAAK,CAAC;WAClC,IAAA,wCAAoB,EAAC,KAAK,CAAC,IAAI,CAAC;WAChC,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ;WACjC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;WACxB,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ;WACnC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;WAChC,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,IAAI,IAAA,mCAAe,EAAC,KAAK,CAAC,IAAI,CAAC,CAAC;WACzD,CAAC,KAAK,CAAC,UAAU,KAAK,SAAS,IAAI,IAAA,mCAAe,EAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,oBAAoB;AACpB,SAAgB,sBAAsB,CAAC,KAAc;IACjD,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC;AAC3D,CAAC;AAED,oBAAoB;AACpB,SAAgB,2BAA2B,CAAC,KAAc;IACtD,IAAI,CAAC,IAAA,gBAAQ,EAAC,KAAK,CAAC,EAAE,CAAC;QACnB,OAAO,WAAW,CAAC;IACvB,CAAC;IACD,OAAO,sBAAsB,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,oBAAoB;AACpB,SAAgB,oBAAoB,CAChC,KAAa,EACb,OAAe,EACf,IAAuB,EACvB,OAAgC;IAEhC,OAAO;QACH,KAAK;QACL,IAAI,EAAE,OAAO,EAAE,IAAI,IAAI,OAAO;QAC9B,IAAI;QACJ,UAAU,EAAE,OAAO,EAAE,UAAU;QAC/B,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;KACxB,CAAC;AACN,CAAC;AAED,oBAAoB;AACpB,SAAgB,sBAAsB,CAAC,KAAqB;IACxD,OAAO,MAAM,CAAC,MAAM,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,IAAA,yCAAqB,EAAC,KAAK,CAAC,IAAI,CAAC;QACvC,UAAU,EAAE,IAAA,yCAAqB,EAAC,KAAK,CAAC,UAAU,CAAC;QACnD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC7B,CAAC,CAAC;AACP,CAAC;AAED,oBAAoB;AACP,QAAA,oBAAoB,GAAG,qBAAqB,CAAC;AAE1D,oBAAoB;AACP,QAAA,YAAY,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC"}

package/lib/common/telemetry-service.d.ts

@@ -0,0 +1,28 @@
+/** @experimental */
+export type TelemetryPrimitive = string | number | boolean;
+/** @experimental */
+export type TelemetryValue = TelemetryPrimitive | readonly string[] | readonly number[] | readonly boolean[];
+/** @experimental */
+export type TelemetryData<T extends object> = {
+    [K in keyof T]: T[K] extends TelemetryValue ? T[K] : never;
+};
+/** @experimental */
+export declare function isTelemetryData(data: unknown): data is Record<string, TelemetryValue>;
+/** @experimental */
+export declare function snapshotTelemetryData<T extends object>(data: TelemetryData<T> | undefined): TelemetryData<T> | undefined;
+/** @experimental */
+export type TelemetryEventKind = 'usage' | 'error' | 'crash';
+/** @experimental */
+export declare function isTelemetryEventKind(value: unknown): value is TelemetryEventKind;
+/** @experimental */
+export interface TelemetryReportOptions {
+    readonly kind?: TelemetryEventKind;
+    readonly attributes?: TelemetryData<Record<string, TelemetryValue>>;
+}
+/** @experimental */
+export declare const TelemetryService: unique symbol;
+/** @experimental */
+export interface TelemetryService {
+    report<T extends object>(topic: string, data?: TelemetryData<T>, options?: TelemetryReportOptions): void;
+}
+//# sourceMappingURL=telemetry-service.d.ts.map

package/lib/common/telemetry-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-service.d.ts","sourceRoot":"","sources":["../../src/common/telemetry-service.ts"],"names":[],"mappings":"AAmBA,oBAAoB;AACpB,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAC3D,oBAAoB;AACpB,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,OAAO,EAAE,CAAC;AAE7G,oBAAoB;AACpB,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,MAAM,IAAI;KACzC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CAC7D,CAAC;AA6BF,oBAAoB;AACpB,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAKrF;AAED,oBAAoB;AACpB,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,EAAE,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,CAExH;AAED,oBAAoB;AACpB,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,CAAC;AAE7D,oBAAoB;AACpB,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,kBAAkB,CAEhF;AAED,oBAAoB;AACpB,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;CACvE;AAED,oBAAoB;AACpB,eAAO,MAAM,gBAAgB,eAA6B,CAAC;AAE3D,oBAAoB;AACpB,MAAM,WAAW,gBAAgB;IAC7B,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,sBAAsB,GAAG,IAAI,CAAC;CAC5G"}