@dxos/plugin-observability 0.8.4-main.9735255 → 0.8.4-main.9be5663bfe

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (222) hide show
  1. package/dist/lib/browser/ObservabilitySettings-EM7ABGCA.mjs +31 -0
  2. package/dist/lib/browser/ObservabilitySettings-EM7ABGCA.mjs.map +7 -0
  3. package/dist/lib/browser/capture-user-feedback-4HGXJGJL.mjs +25 -0
  4. package/dist/lib/browser/capture-user-feedback-4HGXJGJL.mjs.map +7 -0
  5. package/dist/lib/browser/chunk-J5LGTIGS.mjs +10 -0
  6. package/dist/lib/browser/chunk-J5LGTIGS.mjs.map +7 -0
  7. package/dist/lib/browser/chunk-J6DPYEFZ.mjs +49 -0
  8. package/dist/lib/browser/chunk-J6DPYEFZ.mjs.map +7 -0
  9. package/dist/lib/browser/chunk-K33HLC3Z.mjs +33 -0
  10. package/dist/lib/browser/chunk-K33HLC3Z.mjs.map +7 -0
  11. package/dist/lib/browser/chunk-VZR3FNBD.mjs +85 -0
  12. package/dist/lib/browser/chunk-VZR3FNBD.mjs.map +7 -0
  13. package/dist/lib/browser/cli/index.mjs +12 -15
  14. package/dist/lib/browser/cli/index.mjs.map +3 -3
  15. package/dist/lib/browser/index.mjs +72 -60
  16. package/dist/lib/browser/index.mjs.map +4 -4
  17. package/dist/lib/browser/meta.json +1 -1
  18. package/dist/lib/browser/operations/index.mjs +16 -0
  19. package/dist/lib/browser/operations/index.mjs.map +7 -0
  20. package/dist/lib/browser/send-event-VV2I6QYY.mjs +23 -0
  21. package/dist/lib/browser/send-event-VV2I6QYY.mjs.map +7 -0
  22. package/dist/lib/browser/toggle-H2GX3A6G.mjs +48 -0
  23. package/dist/lib/browser/toggle-H2GX3A6G.mjs.map +7 -0
  24. package/dist/lib/browser/types/index.mjs +4 -6
  25. package/dist/lib/node-esm/ObservabilitySettings-VP4A362Z.mjs +32 -0
  26. package/dist/lib/node-esm/ObservabilitySettings-VP4A362Z.mjs.map +7 -0
  27. package/dist/lib/node-esm/capture-user-feedback-SDQA2VYI.mjs +26 -0
  28. package/dist/lib/node-esm/capture-user-feedback-SDQA2VYI.mjs.map +7 -0
  29. package/dist/lib/node-esm/chunk-FZRJBWSE.mjs +86 -0
  30. package/dist/lib/node-esm/chunk-FZRJBWSE.mjs.map +7 -0
  31. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs +11 -0
  32. package/dist/lib/node-esm/chunk-HSLMI22Q.mjs.map +7 -0
  33. package/dist/lib/node-esm/chunk-JGHMP7UL.mjs +35 -0
  34. package/dist/lib/node-esm/chunk-JGHMP7UL.mjs.map +7 -0
  35. package/dist/lib/node-esm/chunk-K7WZOJZF.mjs +50 -0
  36. package/dist/lib/node-esm/chunk-K7WZOJZF.mjs.map +7 -0
  37. package/dist/lib/node-esm/cli/index.mjs +12 -15
  38. package/dist/lib/node-esm/cli/index.mjs.map +3 -3
  39. package/dist/lib/node-esm/index.mjs +72 -60
  40. package/dist/lib/node-esm/index.mjs.map +4 -4
  41. package/dist/lib/node-esm/meta.json +1 -1
  42. package/dist/lib/node-esm/operations/index.mjs +17 -0
  43. package/dist/lib/node-esm/operations/index.mjs.map +7 -0
  44. package/dist/lib/node-esm/send-event-EMV3VHAA.mjs +24 -0
  45. package/dist/lib/node-esm/send-event-EMV3VHAA.mjs.map +7 -0
  46. package/dist/lib/node-esm/toggle-XRNGEYNP.mjs +49 -0
  47. package/dist/lib/node-esm/toggle-XRNGEYNP.mjs.map +7 -0
  48. package/dist/lib/node-esm/types/index.mjs +4 -6
  49. package/dist/types/src/ObservabilityPlugin.d.ts +1 -1
  50. package/dist/types/src/ObservabilityPlugin.d.ts.map +1 -1
  51. package/dist/types/src/capabilities/app-graph-builder.d.ts +6 -0
  52. package/dist/types/src/capabilities/app-graph-builder.d.ts.map +1 -0
  53. package/dist/types/src/capabilities/client-ready.d.ts +10 -0
  54. package/dist/types/src/capabilities/client-ready.d.ts.map +1 -0
  55. package/dist/types/src/capabilities/index.d.ts +21 -6
  56. package/dist/types/src/capabilities/index.d.ts.map +1 -1
  57. package/dist/types/src/capabilities/operation-handler.d.ts +6 -0
  58. package/dist/types/src/capabilities/operation-handler.d.ts.map +1 -0
  59. package/dist/types/src/capabilities/react-surface.d.ts +5 -0
  60. package/dist/types/src/capabilities/react-surface.d.ts.map +1 -0
  61. package/dist/types/src/capabilities/settings.d.ts +10 -0
  62. package/dist/types/src/capabilities/settings.d.ts.map +1 -0
  63. package/dist/types/src/capabilities/{state/state.d.ts → state.d.ts} +2 -2
  64. package/dist/types/src/capabilities/state.d.ts.map +1 -0
  65. package/dist/types/src/cli/plugin.d.ts.map +1 -1
  66. package/dist/types/src/components/FeedbackForm/FeedbackForm.d.ts +6 -0
  67. package/dist/types/src/components/FeedbackForm/FeedbackForm.d.ts.map +1 -0
  68. package/dist/types/src/components/FeedbackForm/FeedbackForm.stories.d.ts +36 -0
  69. package/dist/types/src/components/FeedbackForm/FeedbackForm.stories.d.ts.map +1 -0
  70. package/dist/types/src/components/FeedbackForm/index.d.ts +2 -0
  71. package/dist/types/src/components/FeedbackForm/index.d.ts.map +1 -0
  72. package/dist/types/src/components/ObservabilitySettings/ObservabilitySettings.d.ts +6 -0
  73. package/dist/types/src/components/ObservabilitySettings/ObservabilitySettings.d.ts.map +1 -0
  74. package/dist/types/src/components/ObservabilitySettings/ObservabilitySettings.stories.d.ts +37 -0
  75. package/dist/types/src/components/ObservabilitySettings/ObservabilitySettings.stories.d.ts.map +1 -0
  76. package/dist/types/src/components/ObservabilitySettings/index.d.ts +2 -0
  77. package/dist/types/src/components/ObservabilitySettings/index.d.ts.map +1 -0
  78. package/dist/types/src/components/index.d.ts +2 -2
  79. package/dist/types/src/components/index.d.ts.map +1 -1
  80. package/dist/types/src/containers/HelpContainer/HelpContainer.d.ts +4 -0
  81. package/dist/types/src/containers/HelpContainer/HelpContainer.d.ts.map +1 -0
  82. package/dist/types/src/containers/HelpContainer/index.d.ts +2 -0
  83. package/dist/types/src/containers/HelpContainer/index.d.ts.map +1 -0
  84. package/dist/types/src/containers/index.d.ts +3 -0
  85. package/dist/types/src/containers/index.d.ts.map +1 -0
  86. package/dist/types/src/index.d.ts +1 -0
  87. package/dist/types/src/index.d.ts.map +1 -1
  88. package/dist/types/src/operations/capture-user-feedback.d.ts +5 -0
  89. package/dist/types/src/operations/capture-user-feedback.d.ts.map +1 -0
  90. package/dist/types/src/operations/definitions.d.ts +23 -0
  91. package/dist/types/src/operations/definitions.d.ts.map +1 -0
  92. package/dist/types/src/operations/index.d.ts +5 -0
  93. package/dist/types/src/operations/index.d.ts.map +1 -0
  94. package/dist/types/src/operations/send-event.d.ts +5 -0
  95. package/dist/types/src/operations/send-event.d.ts.map +1 -0
  96. package/dist/types/src/operations/toggle.d.ts +5 -0
  97. package/dist/types/src/operations/toggle.d.ts.map +1 -0
  98. package/dist/types/src/translations.d.ts +18 -16
  99. package/dist/types/src/translations.d.ts.map +1 -1
  100. package/dist/types/src/types/Settings.d.ts +6 -0
  101. package/dist/types/src/types/Settings.d.ts.map +1 -0
  102. package/dist/types/src/types/capabilities.d.ts +2 -1
  103. package/dist/types/src/types/capabilities.d.ts.map +1 -1
  104. package/dist/types/src/types/events.d.ts.map +1 -1
  105. package/dist/types/src/types/index.d.ts +1 -1
  106. package/dist/types/src/types/index.d.ts.map +1 -1
  107. package/dist/types/tsconfig.tsbuildinfo +1 -1
  108. package/package.json +50 -30
  109. package/src/ObservabilityPlugin.ts +20 -17
  110. package/src/capabilities/app-graph-builder.ts +35 -0
  111. package/src/capabilities/client-ready.ts +85 -0
  112. package/src/capabilities/index.ts +14 -6
  113. package/src/capabilities/operation-handler.ts +16 -0
  114. package/src/capabilities/react-surface.tsx +42 -0
  115. package/src/capabilities/{settings/settings.ts → settings.ts} +7 -7
  116. package/src/capabilities/{state/state.ts → state.ts} +7 -8
  117. package/src/cli/plugin.ts +17 -13
  118. package/src/components/{FeedbackForm.stories.tsx → FeedbackForm/FeedbackForm.stories.tsx} +3 -4
  119. package/src/components/FeedbackForm/FeedbackForm.tsx +33 -0
  120. package/src/components/FeedbackForm/index.ts +5 -0
  121. package/src/components/ObservabilitySettings/ObservabilitySettings.stories.tsx +33 -0
  122. package/src/components/ObservabilitySettings/ObservabilitySettings.tsx +38 -0
  123. package/src/components/ObservabilitySettings/index.ts +5 -0
  124. package/src/components/index.ts +4 -2
  125. package/src/containers/HelpContainer/HelpContainer.tsx +56 -0
  126. package/src/containers/HelpContainer/index.ts +5 -0
  127. package/src/containers/index.ts +7 -0
  128. package/src/index.ts +1 -0
  129. package/src/meta.ts +1 -1
  130. package/src/operations/capture-user-feedback.ts +22 -0
  131. package/src/operations/definitions.ts +77 -0
  132. package/src/operations/index.ts +14 -0
  133. package/src/operations/send-event.ts +24 -0
  134. package/src/operations/toggle.ts +47 -0
  135. package/src/translations.ts +18 -17
  136. package/src/types/Settings.ts +19 -0
  137. package/src/types/capabilities.ts +9 -6
  138. package/src/types/events.ts +5 -4
  139. package/src/types/index.ts +1 -1
  140. package/dist/lib/browser/app-graph-builder-6KDHLPUO.mjs +0 -44
  141. package/dist/lib/browser/app-graph-builder-6KDHLPUO.mjs.map +0 -7
  142. package/dist/lib/browser/chunk-3XZDP7JS.mjs +0 -16
  143. package/dist/lib/browser/chunk-3XZDP7JS.mjs.map +0 -7
  144. package/dist/lib/browser/chunk-PYNLPSSZ.mjs +0 -133
  145. package/dist/lib/browser/chunk-PYNLPSSZ.mjs.map +0 -7
  146. package/dist/lib/browser/chunk-SN7DIHQG.mjs +0 -102
  147. package/dist/lib/browser/chunk-SN7DIHQG.mjs.map +0 -7
  148. package/dist/lib/browser/client-ready-YWKHC5S2.mjs +0 -107
  149. package/dist/lib/browser/client-ready-YWKHC5S2.mjs.map +0 -7
  150. package/dist/lib/browser/operation-resolver-4ROZET3B.mjs +0 -82
  151. package/dist/lib/browser/operation-resolver-4ROZET3B.mjs.map +0 -7
  152. package/dist/lib/browser/react-surface-SJTESQAF.mjs +0 -37
  153. package/dist/lib/browser/react-surface-SJTESQAF.mjs.map +0 -7
  154. package/dist/lib/browser/settings-SQ4ICR7F.mjs +0 -35
  155. package/dist/lib/browser/settings-SQ4ICR7F.mjs.map +0 -7
  156. package/dist/lib/browser/state-IKCFXHYV.mjs +0 -31
  157. package/dist/lib/browser/state-IKCFXHYV.mjs.map +0 -7
  158. package/dist/lib/node-esm/app-graph-builder-4YHKY4SP.mjs +0 -45
  159. package/dist/lib/node-esm/app-graph-builder-4YHKY4SP.mjs.map +0 -7
  160. package/dist/lib/node-esm/chunk-2ECMMPZY.mjs +0 -18
  161. package/dist/lib/node-esm/chunk-2ECMMPZY.mjs.map +0 -7
  162. package/dist/lib/node-esm/chunk-4T4N2NJZ.mjs +0 -134
  163. package/dist/lib/node-esm/chunk-4T4N2NJZ.mjs.map +0 -7
  164. package/dist/lib/node-esm/chunk-HNMV7ZZZ.mjs +0 -103
  165. package/dist/lib/node-esm/chunk-HNMV7ZZZ.mjs.map +0 -7
  166. package/dist/lib/node-esm/client-ready-YLYG6F6H.mjs +0 -108
  167. package/dist/lib/node-esm/client-ready-YLYG6F6H.mjs.map +0 -7
  168. package/dist/lib/node-esm/operation-resolver-UI7ZINXR.mjs +0 -83
  169. package/dist/lib/node-esm/operation-resolver-UI7ZINXR.mjs.map +0 -7
  170. package/dist/lib/node-esm/react-surface-D53VLGHY.mjs +0 -38
  171. package/dist/lib/node-esm/react-surface-D53VLGHY.mjs.map +0 -7
  172. package/dist/lib/node-esm/settings-WIRCHLWE.mjs +0 -36
  173. package/dist/lib/node-esm/settings-WIRCHLWE.mjs.map +0 -7
  174. package/dist/lib/node-esm/state-MQR4PNOT.mjs +0 -32
  175. package/dist/lib/node-esm/state-MQR4PNOT.mjs.map +0 -7
  176. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts +0 -6
  177. package/dist/types/src/capabilities/app-graph-builder/app-graph-builder.d.ts.map +0 -1
  178. package/dist/types/src/capabilities/app-graph-builder/index.d.ts +0 -3
  179. package/dist/types/src/capabilities/app-graph-builder/index.d.ts.map +0 -1
  180. package/dist/types/src/capabilities/client-ready/client-ready.d.ts +0 -10
  181. package/dist/types/src/capabilities/client-ready/client-ready.d.ts.map +0 -1
  182. package/dist/types/src/capabilities/client-ready/index.d.ts +0 -6
  183. package/dist/types/src/capabilities/client-ready/index.d.ts.map +0 -1
  184. package/dist/types/src/capabilities/operation-resolver/index.d.ts +0 -5
  185. package/dist/types/src/capabilities/operation-resolver/index.d.ts.map +0 -1
  186. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts +0 -7
  187. package/dist/types/src/capabilities/operation-resolver/operation-resolver.d.ts.map +0 -1
  188. package/dist/types/src/capabilities/react-surface/index.d.ts +0 -3
  189. package/dist/types/src/capabilities/react-surface/index.d.ts.map +0 -1
  190. package/dist/types/src/capabilities/react-surface/react-surface.d.ts +0 -5
  191. package/dist/types/src/capabilities/react-surface/react-surface.d.ts.map +0 -1
  192. package/dist/types/src/capabilities/settings/index.d.ts +0 -7
  193. package/dist/types/src/capabilities/settings/index.d.ts.map +0 -1
  194. package/dist/types/src/capabilities/settings/settings.d.ts +0 -9
  195. package/dist/types/src/capabilities/settings/settings.d.ts.map +0 -1
  196. package/dist/types/src/capabilities/state/index.d.ts +0 -11
  197. package/dist/types/src/capabilities/state/index.d.ts.map +0 -1
  198. package/dist/types/src/capabilities/state/state.d.ts.map +0 -1
  199. package/dist/types/src/components/FeedbackForm.d.ts +0 -6
  200. package/dist/types/src/components/FeedbackForm.d.ts.map +0 -1
  201. package/dist/types/src/components/FeedbackForm.stories.d.ts +0 -34
  202. package/dist/types/src/components/FeedbackForm.stories.d.ts.map +0 -1
  203. package/dist/types/src/components/HelpContainer.d.ts +0 -3
  204. package/dist/types/src/components/HelpContainer.d.ts.map +0 -1
  205. package/dist/types/src/components/ObservabilitySettings.d.ts +0 -12
  206. package/dist/types/src/components/ObservabilitySettings.d.ts.map +0 -1
  207. package/dist/types/src/types/schema.d.ts +0 -61
  208. package/dist/types/src/types/schema.d.ts.map +0 -1
  209. package/src/capabilities/app-graph-builder/app-graph-builder.ts +0 -42
  210. package/src/capabilities/app-graph-builder/index.ts +0 -7
  211. package/src/capabilities/client-ready/client-ready.ts +0 -97
  212. package/src/capabilities/client-ready/index.ts +0 -7
  213. package/src/capabilities/operation-resolver/index.ts +0 -7
  214. package/src/capabilities/operation-resolver/operation-resolver.ts +0 -82
  215. package/src/capabilities/react-surface/index.ts +0 -7
  216. package/src/capabilities/react-surface/react-surface.tsx +0 -34
  217. package/src/capabilities/settings/index.ts +0 -7
  218. package/src/capabilities/state/index.ts +0 -7
  219. package/src/components/FeedbackForm.tsx +0 -26
  220. package/src/components/HelpContainer.tsx +0 -36
  221. package/src/components/ObservabilitySettings.tsx +0 -53
  222. package/src/types/schema.ts +0 -78
@@ -0,0 +1,5 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ export { ObservabilitySettings as default } from './ObservabilitySettings';
@@ -2,6 +2,8 @@
2
2
  // Copyright 2023 DXOS.org
3
3
  //
4
4
 
5
+ import { type ComponentType, lazy } from 'react';
6
+
5
7
  export * from './FeedbackForm';
6
- export * from './HelpContainer';
7
- export * from './ObservabilitySettings';
8
+
9
+ export const ObservabilitySettings: ComponentType<any> = lazy(() => import('./ObservabilitySettings'));
@@ -0,0 +1,56 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+ import React, { useCallback, useState } from 'react';
7
+
8
+ import { useCapability, useOperationInvoker } from '@dxos/app-framework/ui';
9
+ import { LayoutOperation } from '@dxos/app-toolkit';
10
+ import { runAndForwardErrors } from '@dxos/effect';
11
+ import { useAsyncEffect } from '@dxos/react-hooks';
12
+ import { osTranslations } from '@dxos/ui-theme';
13
+
14
+ import { FeedbackForm } from '#components';
15
+ import { meta } from '#meta';
16
+ import { ObservabilityOperation, type UserFeedback } from '#operations';
17
+ import { ObservabilityCapabilities } from '#types';
18
+
19
+ /** Renders the feedback form, disabling it when the feedback survey is unavailable. */
20
+ export const HelpContainer = () => {
21
+ const { invokePromise } = useOperationInvoker();
22
+ const observability = useCapability(ObservabilityCapabilities.Observability);
23
+ const [feedbackAvailable, setFeedbackAvailable] = useState(false);
24
+
25
+ useAsyncEffect(
26
+ async (controller) => {
27
+ const available = await observability.isAvailable('feedback').pipe(
28
+ Effect.catchAll(() => Effect.succeed(false)),
29
+ Effect.catchAllDefect(() => Effect.succeed(false)),
30
+ runAndForwardErrors,
31
+ );
32
+ if (!controller.signal.aborted) {
33
+ setFeedbackAvailable(available);
34
+ }
35
+ },
36
+ [observability],
37
+ );
38
+
39
+ const handleSave = useCallback(
40
+ async (values: UserFeedback) => {
41
+ await invokePromise(ObservabilityOperation.CaptureUserFeedback, values);
42
+ await invokePromise(LayoutOperation.UpdateComplementary, { state: 'collapsed' });
43
+ await invokePromise(LayoutOperation.AddToast, {
44
+ id: `${meta.id}.feedback-success`,
45
+ icon: 'ph--paper-plane-tilt--regular',
46
+ duration: 3000,
47
+ title: ['feedback-toast.label', { ns: meta.id }],
48
+ description: ['feedback-toast.description', { ns: meta.id }],
49
+ closeLabel: ['close.label', { ns: osTranslations }],
50
+ });
51
+ },
52
+ [invokePromise],
53
+ );
54
+
55
+ return <FeedbackForm onSave={handleSave} disabled={!feedbackAvailable} />;
56
+ };
@@ -0,0 +1,5 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ export { HelpContainer as default } from './HelpContainer';
@@ -0,0 +1,7 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { type ComponentType, lazy } from 'react';
6
+
7
+ export const HelpContainer: ComponentType<any> = lazy(() => import('./HelpContainer'));
package/src/index.ts CHANGED
@@ -6,3 +6,4 @@ export { ObservabilityCapabilities, ObservabilityEvents } from './types';
6
6
  export * from './components';
7
7
  export * from './meta';
8
8
  export * from './ObservabilityPlugin';
9
+ export { translations as observabilityTranslations } from './translations';
package/src/meta.ts CHANGED
@@ -6,7 +6,7 @@ import { type Plugin } from '@dxos/app-framework';
6
6
  import { trim } from '@dxos/util';
7
7
 
8
8
  export const meta: Plugin.Meta = {
9
- id: 'dxos.org/plugin/observability',
9
+ id: 'org.dxos.plugin.observability',
10
10
  name: 'Telemetry',
11
11
  description: trim`
12
12
  Application observability and telemetry collection for monitoring performance and usage patterns.
@@ -0,0 +1,22 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capability } from '@dxos/app-framework';
8
+ import { Operation } from '@dxos/operation';
9
+
10
+ import { ObservabilityCapabilities } from '../types';
11
+ import { CaptureUserFeedback } from './definitions';
12
+
13
+ const handler: Operation.WithHandler<typeof CaptureUserFeedback> = CaptureUserFeedback.pipe(
14
+ Operation.withHandler(
15
+ Effect.fnUntraced(function* (input) {
16
+ const observability = yield* Capability.get(ObservabilityCapabilities.Observability);
17
+ observability.feedback.captureUserFeedback({ message: input.message, includeLogs: input.includeLogs });
18
+ }),
19
+ ),
20
+ );
21
+
22
+ export default handler;
@@ -0,0 +1,77 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Schema from 'effect/Schema';
6
+
7
+ import { Capability } from '@dxos/app-framework';
8
+ import { Format } from '@dxos/echo';
9
+ import { Operation } from '@dxos/operation';
10
+
11
+ import { meta } from '#meta';
12
+
13
+ import { translations } from '../translations';
14
+
15
+ const t = translations[0]['en-US'][meta.id];
16
+
17
+ export const UserFeedback = Schema.Struct({
18
+ message: Format.Text.pipe(
19
+ Schema.nonEmptyString(),
20
+ Schema.maxLength(4_096),
21
+ Schema.annotations({
22
+ title: t['feedback-textarea.label'],
23
+ description: t['feedback-textarea.placeholder'],
24
+ }),
25
+ ),
26
+ includeLogs: Schema.Boolean.pipe(
27
+ Schema.annotations({
28
+ title: t['include-debug-logs.label'],
29
+ }),
30
+ Schema.optional,
31
+ ),
32
+ });
33
+
34
+ export type UserFeedback = Schema.Schema.Type<typeof UserFeedback>;
35
+
36
+ const OBSERVABILITY_OPERATION = `${meta.id}.operation`;
37
+
38
+ /**
39
+ * Operations for the Observability plugin.
40
+ */
41
+ export const Toggle = Operation.make({
42
+ meta: {
43
+ key: `${OBSERVABILITY_OPERATION}.toggle`,
44
+ name: 'Toggle Observability',
45
+ description: 'Toggle observability on or off.',
46
+ },
47
+ services: [Capability.Service],
48
+ input: Schema.Struct({
49
+ state: Schema.optional(Schema.Boolean),
50
+ }),
51
+ output: Schema.Boolean,
52
+ });
53
+
54
+ export const CaptureUserFeedback = Operation.make({
55
+ meta: {
56
+ key: `${OBSERVABILITY_OPERATION}.capture-feedback`,
57
+ name: 'Capture User Feedback',
58
+ description: 'Capture user feedback.',
59
+ },
60
+ services: [Capability.Service],
61
+ input: UserFeedback,
62
+ output: Schema.Void,
63
+ });
64
+
65
+ export const SendEvent = Operation.make({
66
+ meta: {
67
+ key: `${OBSERVABILITY_OPERATION}.send-event`,
68
+ name: 'Send Event',
69
+ description: 'Send an observability event.',
70
+ },
71
+ services: [Capability.Service],
72
+ input: Schema.Struct({
73
+ name: Schema.String.annotations({ description: 'The name of the event.' }),
74
+ properties: Schema.optional(Schema.Any).annotations({ description: 'Event properties.' }),
75
+ }),
76
+ output: Schema.Void,
77
+ });
@@ -0,0 +1,14 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import { OperationHandlerSet } from '@dxos/operation';
6
+
7
+ export * as ObservabilityOperation from './definitions';
8
+ export { UserFeedback } from './definitions';
9
+
10
+ export const ObservabilityOperationHandlerSet = OperationHandlerSet.lazy(
11
+ () => import('./capture-user-feedback'),
12
+ () => import('./send-event'),
13
+ () => import('./toggle'),
14
+ );
@@ -0,0 +1,24 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capability } from '@dxos/app-framework';
8
+ import { Operation } from '@dxos/operation';
9
+
10
+ import { ObservabilityCapabilities } from '../types';
11
+ import { SendEvent } from './definitions';
12
+
13
+ const handler: Operation.WithHandler<typeof SendEvent> = SendEvent.pipe(
14
+ Operation.withHandler(
15
+ Effect.fnUntraced(function* (input) {
16
+ // NOTE: This is to ensure that events fired before observability is ready are still sent.
17
+ const observability = yield* Capability.waitFor(ObservabilityCapabilities.Observability);
18
+ const properties = input.properties ?? {};
19
+ observability.events.captureEvent(input.name, properties);
20
+ }),
21
+ ),
22
+ );
23
+
24
+ export default handler;
@@ -0,0 +1,47 @@
1
+ //
2
+ // Copyright 2025 DXOS.org
3
+ //
4
+
5
+ import * as Effect from 'effect/Effect';
6
+
7
+ import { Capabilities, Capability } from '@dxos/app-framework';
8
+ import { AppCapabilities } from '@dxos/app-toolkit';
9
+ import { Observability } from '@dxos/observability';
10
+ import { Operation } from '@dxos/operation';
11
+
12
+ import { meta } from '#meta';
13
+
14
+ import { ObservabilityCapabilities, type Settings } from '../types';
15
+ import { Toggle } from './definitions';
16
+
17
+ const handler: Operation.WithHandler<typeof Toggle> = Toggle.pipe(
18
+ Operation.withHandler(
19
+ Effect.fnUntraced(function* (input) {
20
+ const namespace = yield* Capability.get(ObservabilityCapabilities.Namespace);
21
+ const observability = yield* Capability.get(ObservabilityCapabilities.Observability);
22
+ const capabilities = yield* Capability.Service;
23
+ const registry = capabilities.get(Capabilities.AtomRegistry);
24
+ const allSettings = capabilities.getAll(AppCapabilities.Settings);
25
+ const settingsObj = allSettings.find((s: AppCapabilities.Settings) => s.prefix === meta.id);
26
+ if (!settingsObj) {
27
+ return false;
28
+ }
29
+ const settings = registry.get(settingsObj.atom) as Settings.Settings;
30
+ const newEnabled = input.state ?? !settings.enabled;
31
+ registry.set(settingsObj.atom, { ...settings, enabled: newEnabled });
32
+ observability.events.captureEvent('observability.toggle', {
33
+ enabled: newEnabled,
34
+ });
35
+
36
+ if (newEnabled) {
37
+ yield* observability.enable();
38
+ } else {
39
+ yield* observability.disable();
40
+ }
41
+ yield* Effect.promise(() => Observability.storeObservabilityDisabled(namespace, !newEnabled));
42
+ return newEnabled;
43
+ }),
44
+ ),
45
+ );
46
+
47
+ export default handler;
@@ -4,31 +4,32 @@
4
4
 
5
5
  import { type Resource } from '@dxos/react-ui';
6
6
 
7
- import { meta } from './meta';
7
+ import { meta } from '#meta';
8
8
 
9
9
  export const translations = [
10
10
  {
11
11
  'en-US': {
12
12
  [meta.id]: {
13
- 'plugin name': 'Telemetry',
14
- 'settings title': 'Telemetry settings',
15
- 'observability toast label': 'Privacy Notice',
16
- 'observability toast description':
13
+ 'plugin.name': 'Telemetry',
14
+ 'settings.title': 'Telemetry settings',
15
+ 'observability-toast.label': 'Privacy Notice',
16
+ 'observability-toast.description':
17
17
  'Composer collects usage and performance metrics to improve the product. No user data is collected.',
18
- 'observability toast action label': 'Settings',
19
- 'observability toast action alt': 'Open settings to learn more or to disable.',
20
- 'observability toast close label': 'Okay',
21
- 'observability enabled label': 'Enable telemetry',
18
+ 'observability-toast-action.label': 'Settings',
19
+ 'observability-toast-action.alt': 'Open settings to learn more or to disable.',
20
+ 'observability-toast-close.label': 'Okay',
21
+ 'observability-enabled.label': 'Enable telemetry',
22
+ 'observability-enabled.description': 'Send anonymous usage and performance data to help improve the product.',
22
23
  // TODO: Add link about telemetry privacy. Make it clearer that user data is not collected.
23
- 'observability description':
24
+ 'observability.description':
24
25
  'When enabled, basic usage data will used to improve the product. This may include performance metrics, error logs, and usage data. No personally identifiable information, other than your public key, is included with this data and no private data ever leaves your devices.',
25
-
26
- 'help label': 'Feedback & Support',
27
- 'feedback textarea label': 'Feedback',
28
- 'feedback textarea placeholder': 'Please enter your feedback, technical issue, or feature request.',
29
- 'send feedback label': 'Send Feedback',
30
- 'feedback toast label': 'Thank you for your feedback!',
31
- 'feedback toast description': 'We will review your feedback and get back to you as soon as possible.',
26
+ 'help.label': 'Feedback & Support',
27
+ 'feedback-textarea.label': 'Feedback',
28
+ 'feedback-textarea.placeholder': 'Please enter your feedback, technical issue, or feature request.',
29
+ 'include-debug-logs.label': 'Include debug logs',
30
+ 'send-feedback.label': 'Send Feedback',
31
+ 'feedback-toast.label': 'Thank you for your feedback!',
32
+ 'feedback-toast.description': 'We will review your feedback and get back to you as soon as possible.',
32
33
  },
33
34
  },
34
35
  },
@@ -0,0 +1,19 @@
1
+ //
2
+ // Copyright 2023 DXOS.org
3
+ //
4
+
5
+ // @import-as-namespace
6
+
7
+ import * as Schema from 'effect/Schema';
8
+
9
+ export const Settings = Schema.mutable(
10
+ Schema.Struct({
11
+ enabled: Schema.Boolean,
12
+ // TODO(wittjosiah): Separate settings for each observability feature.
13
+ // metrics?: boolean;
14
+ // telemetry?: boolean;
15
+ // errors?: boolean;
16
+ }),
17
+ );
18
+
19
+ export type Settings = Schema.Schema.Type<typeof Settings>;
@@ -9,11 +9,14 @@ import { Capability } from '@dxos/app-framework';
9
9
  import { type Client } from '@dxos/client';
10
10
  import { type Observability } from '@dxos/observability';
11
11
 
12
- import { type ObservabilitySettingsProps } from '../components';
13
- import { meta } from '../meta';
12
+ import { meta } from '#meta';
13
+
14
+ import * as Settings from './Settings';
14
15
 
15
16
  export namespace ObservabilityCapabilities {
16
- export const Settings = Capability.make<Atom.Writable<ObservabilitySettingsProps>>(`${meta.id}/capability/settings`);
17
+ export const Namespace = Capability.make<string>(`${meta.id}.capability.namespace`);
18
+
19
+ export const Settings = Capability.make<Atom.Writable<Settings.Settings>>(`${meta.id}.capability.settings`);
17
20
 
18
21
  export const StateSchema = Schema.mutable(
19
22
  Schema.Struct({
@@ -24,11 +27,11 @@ export namespace ObservabilityCapabilities {
24
27
 
25
28
  export type State = Schema.Schema.Type<typeof StateSchema>;
26
29
 
27
- export const State = Capability.make<Atom.Writable<State>>(`${meta.id}/capability/state`);
30
+ export const State = Capability.make<Atom.Writable<State>>(`${meta.id}.capability.state`);
28
31
 
29
- export const Observability = Capability.make<Observability>(`${meta.id}/capability/observability`);
32
+ export const Observability = Capability.make<Observability.Observability>(`${meta.id}.capability.observability`);
30
33
  }
31
34
 
32
35
  // NOTE: This is cloned from the client plugin to avoid circular dependencies.
33
36
  // TODO(burdon): Figure out how to share defs.
34
- export const ClientCapability = Capability.make<Client>('dxos.org/plugin/client/capability/client');
37
+ export const ClientCapability = Capability.make<Client>('org.dxos.plugin.client.capability.client');
@@ -2,13 +2,14 @@
2
2
  // Copyright 2025 DXOS.org
3
3
  //
4
4
 
5
- import { ActivationEvent, Common } from '@dxos/app-framework';
5
+ import { ActivationEvent } from '@dxos/app-framework';
6
+ import { AppActivationEvents } from '@dxos/app-toolkit';
6
7
 
7
- import { meta } from '../meta';
8
+ import { meta } from '#meta';
8
9
 
9
10
  export namespace ObservabilityEvents {
10
- export const StateReady: ActivationEvent.ActivationEvent = Common.ActivationEvent.createStateEvent(meta.id);
11
+ export const StateReady: ActivationEvent.ActivationEvent = AppActivationEvents.createStateEvent(meta.id);
11
12
  }
12
13
 
13
14
  // NOTE: This is cloned from the client plugin to avoid circular dependencies.
14
- export const ClientReadyEvent = ActivationEvent.make('dxos.org/plugin/client/event/client-ready');
15
+ export const ClientReadyEvent = ActivationEvent.make('org.dxos.plugin.client.event.client-ready');
@@ -4,4 +4,4 @@
4
4
 
5
5
  export * from './capabilities';
6
6
  export * from './events';
7
- export * from './schema';
7
+ export * as Settings from './Settings';
@@ -1,44 +0,0 @@
1
- import {
2
- meta
3
- } from "./chunk-3XZDP7JS.mjs";
4
-
5
- // src/capabilities/app-graph-builder/app-graph-builder.ts
6
- import * as Effect from "effect/Effect";
7
- import { Capability, Common } from "@dxos/app-framework";
8
- import { GraphBuilder, NodeMatcher } from "@dxos/plugin-graph";
9
- var ATTENDABLE_PATH_SEPARATOR = "~";
10
- var DECK_COMPANION_TYPE = "dxos.org/plugin/deck/deck-companion";
11
- var app_graph_builder_default = Capability.makeModule(Effect.fnUntraced(function* () {
12
- const extensions = yield* Effect.all([
13
- GraphBuilder.createExtension({
14
- id: `${meta.id}/help`,
15
- match: NodeMatcher.whenRoot,
16
- connector: (node) => Effect.succeed([
17
- {
18
- id: [
19
- node.id,
20
- "help"
21
- ].join(ATTENDABLE_PATH_SEPARATOR),
22
- type: DECK_COMPANION_TYPE,
23
- data: null,
24
- properties: {
25
- label: [
26
- "help label",
27
- {
28
- ns: meta.id
29
- }
30
- ],
31
- icon: "ph--question--regular",
32
- disposition: "hidden",
33
- position: "hoist"
34
- }
35
- }
36
- ])
37
- })
38
- ]);
39
- return Capability.contributes(Common.Capability.AppGraphBuilder, extensions);
40
- }));
41
- export {
42
- app_graph_builder_default as default
43
- };
44
- //# sourceMappingURL=app-graph-builder-6KDHLPUO.mjs.map
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../../../src/capabilities/app-graph-builder/app-graph-builder.ts"],
4
- "sourcesContent": ["//\n// Copyright 2025 DXOS.org\n//\n\nimport * as Effect from 'effect/Effect';\n\nimport { Capability, Common } from '@dxos/app-framework';\nimport { GraphBuilder, NodeMatcher } from '@dxos/plugin-graph';\n\nimport { meta } from '../../meta';\n\n// NOTE: Copied from @dxos/plugin-deck to break circular dependency.\nconst ATTENDABLE_PATH_SEPARATOR = '~';\n\nconst DECK_COMPANION_TYPE = 'dxos.org/plugin/deck/deck-companion';\n\nexport default Capability.makeModule(\n Effect.fnUntraced(function* () {\n const extensions = yield* Effect.all([\n GraphBuilder.createExtension({\n id: `${meta.id}/help`,\n match: NodeMatcher.whenRoot,\n connector: (node) =>\n Effect.succeed([\n {\n id: [node.id, 'help'].join(ATTENDABLE_PATH_SEPARATOR),\n type: DECK_COMPANION_TYPE,\n data: null,\n properties: {\n label: ['help label', { ns: meta.id }],\n icon: 'ph--question--regular',\n disposition: 'hidden',\n position: 'hoist',\n },\n },\n ]),\n }),\n ]);\n\n return Capability.contributes(Common.Capability.AppGraphBuilder, extensions);\n }),\n);\n"],
5
- "mappings": ";;;;;AAIA,YAAYA,YAAY;AAExB,SAASC,YAAYC,cAAc;AACnC,SAASC,cAAcC,mBAAmB;AAK1C,IAAMC,4BAA4B;AAElC,IAAMC,sBAAsB;AAE5B,IAAA,4BAAeC,WAAWC,WACjBC,kBAAW,aAAA;AAChB,QAAMC,aAAa,OAAcC,WAAI;IACnCC,aAAaC,gBAAgB;MAC3BC,IAAI,GAAGC,KAAKD,EAAE;MACdE,OAAOC,YAAYC;MACnBC,WAAW,CAACC,SACHC,eAAQ;QACb;UACEP,IAAI;YAACM,KAAKN;YAAI;YAAQQ,KAAKjB,yBAAAA;UAC3BkB,MAAMjB;UACNkB,MAAM;UACNC,YAAY;YACVC,OAAO;cAAC;cAAc;gBAAEC,IAAIZ,KAAKD;cAAG;;YACpCc,MAAM;YACNC,aAAa;YACbC,UAAU;UACZ;QACF;OACD;IACL,CAAA;GACD;AAED,SAAOvB,WAAWwB,YAAYC,OAAOzB,WAAW0B,iBAAiBvB,UAAAA;AACnE,CAAA,CAAA;",
6
- "names": ["Effect", "Capability", "Common", "GraphBuilder", "NodeMatcher", "ATTENDABLE_PATH_SEPARATOR", "DECK_COMPANION_TYPE", "Capability", "makeModule", "fnUntraced", "extensions", "all", "GraphBuilder", "createExtension", "id", "meta", "match", "NodeMatcher", "whenRoot", "connector", "node", "succeed", "join", "type", "data", "properties", "label", "ns", "icon", "disposition", "position", "contributes", "Common", "AppGraphBuilder"]
7
- }
@@ -1,16 +0,0 @@
1
- // src/meta.ts
2
- import { trim } from "@dxos/util";
3
- var meta = {
4
- id: "dxos.org/plugin/observability",
5
- name: "Telemetry",
6
- description: trim`
7
- Application observability and telemetry collection for monitoring performance and usage patterns.
8
- Track metrics, logs, and traces for system health and analytics.
9
- `,
10
- icon: "ph--eye--regular"
11
- };
12
-
13
- export {
14
- meta
15
- };
16
- //# sourceMappingURL=chunk-3XZDP7JS.mjs.map
@@ -1,7 +0,0 @@
1
- {
2
- "version": 3,
3
- "sources": ["../../../src/meta.ts"],
4
- "sourcesContent": ["//\n// Copyright 2023 DXOS.org\n//\n\nimport { type Plugin } from '@dxos/app-framework';\nimport { trim } from '@dxos/util';\n\nexport const meta: Plugin.Meta = {\n id: 'dxos.org/plugin/observability',\n name: 'Telemetry',\n description: trim`\n Application observability and telemetry collection for monitoring performance and usage patterns.\n Track metrics, logs, and traces for system health and analytics.\n `,\n icon: 'ph--eye--regular',\n};\n"],
5
- "mappings": ";AAKA,SAASA,YAAY;AAEd,IAAMC,OAAoB;EAC/BC,IAAI;EACJC,MAAM;EACNC,aAAaC;;;;EAIbC,MAAM;AACR;",
6
- "names": ["trim", "meta", "id", "name", "description", "trim", "icon"]
7
- }
@@ -1,133 +0,0 @@
1
- import {
2
- meta
3
- } from "./chunk-3XZDP7JS.mjs";
4
-
5
- // src/types/capabilities.ts
6
- import * as Schema from "effect/Schema";
7
- import { Capability } from "@dxos/app-framework";
8
- (function(ObservabilityCapabilities2) {
9
- ObservabilityCapabilities2.Settings = Capability.make(`${meta.id}/capability/settings`);
10
- ObservabilityCapabilities2.StateSchema = Schema.mutable(Schema.Struct({
11
- group: Schema.optional(Schema.String),
12
- notified: Schema.optional(Schema.Boolean)
13
- }));
14
- ObservabilityCapabilities2.State = Capability.make(`${meta.id}/capability/state`);
15
- ObservabilityCapabilities2.Observability = Capability.make(`${meta.id}/capability/observability`);
16
- })(ObservabilityCapabilities || (ObservabilityCapabilities = {}));
17
- var ClientCapability = Capability.make("dxos.org/plugin/client/capability/client");
18
- var ObservabilityCapabilities;
19
-
20
- // src/types/events.ts
21
- import { ActivationEvent, Common } from "@dxos/app-framework";
22
- (function(ObservabilityEvents2) {
23
- ObservabilityEvents2.StateReady = Common.ActivationEvent.createStateEvent(meta.id);
24
- })(ObservabilityEvents || (ObservabilityEvents = {}));
25
- var ClientReadyEvent = ActivationEvent.make("dxos.org/plugin/client/event/client-ready");
26
- var ObservabilityEvents;
27
-
28
- // src/types/schema.ts
29
- import * as Schema2 from "effect/Schema";
30
- import { Capability as Capability2 } from "@dxos/app-framework";
31
- import { Format } from "@dxos/echo";
32
- import { Operation } from "@dxos/operation";
33
-
34
- // src/translations.ts
35
- var translations = [
36
- {
37
- "en-US": {
38
- [meta.id]: {
39
- "plugin name": "Telemetry",
40
- "settings title": "Telemetry settings",
41
- "observability toast label": "Privacy Notice",
42
- "observability toast description": "Composer collects usage and performance metrics to improve the product. No user data is collected.",
43
- "observability toast action label": "Settings",
44
- "observability toast action alt": "Open settings to learn more or to disable.",
45
- "observability toast close label": "Okay",
46
- "observability enabled label": "Enable telemetry",
47
- // TODO: Add link about telemetry privacy. Make it clearer that user data is not collected.
48
- "observability description": "When enabled, basic usage data will used to improve the product. This may include performance metrics, error logs, and usage data. No personally identifiable information, other than your public key, is included with this data and no private data ever leaves your devices.",
49
- "help label": "Feedback & Support",
50
- "feedback textarea label": "Feedback",
51
- "feedback textarea placeholder": "Please enter your feedback, technical issue, or feature request.",
52
- "send feedback label": "Send Feedback",
53
- "feedback toast label": "Thank you for your feedback!",
54
- "feedback toast description": "We will review your feedback and get back to you as soon as possible."
55
- }
56
- }
57
- }
58
- ];
59
-
60
- // src/types/schema.ts
61
- var t = translations[0]["en-US"][meta.id];
62
- var UserFeedback = Schema2.Struct({
63
- message: Format.Text.pipe(Schema2.nonEmptyString(), Schema2.maxLength(4096), Schema2.annotations({
64
- title: t["feedback textarea label"],
65
- description: t["feedback textarea placeholder"]
66
- }))
67
- });
68
- var OBSERVABILITY_OPERATION = `${meta.id}/operation`;
69
- (function(ObservabilityOperation2) {
70
- ObservabilityOperation2.Toggle = Operation.make({
71
- meta: {
72
- key: `${OBSERVABILITY_OPERATION}/toggle`,
73
- name: "Toggle Observability",
74
- description: "Toggle observability on or off."
75
- },
76
- services: [
77
- Capability2.Service
78
- ],
79
- schema: {
80
- input: Schema2.Struct({
81
- state: Schema2.optional(Schema2.Boolean)
82
- }),
83
- output: Schema2.Boolean
84
- }
85
- });
86
- ObservabilityOperation2.CaptureUserFeedback = Operation.make({
87
- meta: {
88
- key: `${OBSERVABILITY_OPERATION}/capture-feedback`,
89
- name: "Capture User Feedback",
90
- description: "Capture user feedback."
91
- },
92
- services: [
93
- Capability2.Service
94
- ],
95
- schema: {
96
- input: UserFeedback,
97
- output: Schema2.Void
98
- }
99
- });
100
- ObservabilityOperation2.SendEvent = Operation.make({
101
- meta: {
102
- key: `${OBSERVABILITY_OPERATION}/send-event`,
103
- name: "Send Event",
104
- description: "Send an observability event."
105
- },
106
- services: [
107
- Capability2.Service
108
- ],
109
- schema: {
110
- input: Schema2.Struct({
111
- name: Schema2.String.annotations({
112
- description: "The name of the event."
113
- }),
114
- properties: Schema2.optional(Schema2.Any).annotations({
115
- description: "Event properties."
116
- })
117
- }),
118
- output: Schema2.Void
119
- }
120
- });
121
- })(ObservabilityOperation || (ObservabilityOperation = {}));
122
- var ObservabilityOperation;
123
-
124
- export {
125
- ClientCapability,
126
- ObservabilityCapabilities,
127
- ClientReadyEvent,
128
- ObservabilityEvents,
129
- translations,
130
- UserFeedback,
131
- ObservabilityOperation
132
- };
133
- //# sourceMappingURL=chunk-PYNLPSSZ.mjs.map