@od-oneapp/observability 2026.2.1501-canary.1

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 (79) hide show
  1. package/CHANGELOG.md +75 -0
  2. package/README.md +523 -0
  3. package/client-next.d.mts +20 -0
  4. package/client-next.d.mts.map +1 -0
  5. package/client-next.mjs +64 -0
  6. package/client-next.mjs.map +1 -0
  7. package/client.d.mts +11 -0
  8. package/client.d.mts.map +1 -0
  9. package/client.mjs +47 -0
  10. package/client.mjs.map +1 -0
  11. package/env.d.mts +19 -0
  12. package/env.d.mts.map +1 -0
  13. package/env.mjs +45 -0
  14. package/env.mjs.map +1 -0
  15. package/factory-BbaVR2Fg.mjs +380 -0
  16. package/factory-BbaVR2Fg.mjs.map +1 -0
  17. package/hooks-useObservability.d.mts +11 -0
  18. package/hooks-useObservability.d.mts.map +1 -0
  19. package/hooks-useObservability.mjs +174 -0
  20. package/hooks-useObservability.mjs.map +1 -0
  21. package/index-DyMZnpOb.d.mts +24 -0
  22. package/index-DyMZnpOb.d.mts.map +1 -0
  23. package/index.d.mts +88 -0
  24. package/index.d.mts.map +1 -0
  25. package/index.mjs +97 -0
  26. package/index.mjs.map +1 -0
  27. package/logs-BPZrNxKo.mjs +108 -0
  28. package/logs-BPZrNxKo.mjs.map +1 -0
  29. package/manager-kY_otv_D.d.mts +33 -0
  30. package/manager-kY_otv_D.d.mts.map +1 -0
  31. package/package.json +179 -0
  32. package/plugin-BM4n9vNF.d.mts +72 -0
  33. package/plugin-BM4n9vNF.d.mts.map +1 -0
  34. package/plugin-BllDfqyj.d.mts +53 -0
  35. package/plugin-BllDfqyj.d.mts.map +1 -0
  36. package/plugin-C6VDHiSj.mjs +593 -0
  37. package/plugin-C6VDHiSj.mjs.map +1 -0
  38. package/plugin-CCoP7sLI.d.mts +269 -0
  39. package/plugin-CCoP7sLI.d.mts.map +1 -0
  40. package/plugin-CEnE1UmK.mjs +534 -0
  41. package/plugin-CEnE1UmK.mjs.map +1 -0
  42. package/plugin-CPbnyaji.mjs +234 -0
  43. package/plugin-CPbnyaji.mjs.map +1 -0
  44. package/plugins-betterstack-env.d.mts +40 -0
  45. package/plugins-betterstack-env.d.mts.map +1 -0
  46. package/plugins-betterstack-env.mjs +75 -0
  47. package/plugins-betterstack-env.mjs.map +1 -0
  48. package/plugins-betterstack.d.mts +4 -0
  49. package/plugins-betterstack.mjs +4 -0
  50. package/plugins-console.d.mts +37 -0
  51. package/plugins-console.d.mts.map +1 -0
  52. package/plugins-console.mjs +196 -0
  53. package/plugins-console.mjs.map +1 -0
  54. package/plugins-sentry-env.d.mts +52 -0
  55. package/plugins-sentry-env.d.mts.map +1 -0
  56. package/plugins-sentry-env.mjs +79 -0
  57. package/plugins-sentry-env.mjs.map +1 -0
  58. package/plugins-sentry-microfrontend-env.d.mts +49 -0
  59. package/plugins-sentry-microfrontend-env.d.mts.map +1 -0
  60. package/plugins-sentry-microfrontend-env.mjs +80 -0
  61. package/plugins-sentry-microfrontend-env.mjs.map +1 -0
  62. package/plugins-sentry-microfrontend.d.mts +2 -0
  63. package/plugins-sentry-microfrontend.mjs +3 -0
  64. package/plugins-sentry.d.mts +5 -0
  65. package/plugins-sentry.mjs +6 -0
  66. package/server-edge.d.mts +15 -0
  67. package/server-edge.d.mts.map +1 -0
  68. package/server-edge.mjs +53 -0
  69. package/server-edge.mjs.map +1 -0
  70. package/server-next.d.mts +17 -0
  71. package/server-next.d.mts.map +1 -0
  72. package/server-next.mjs +64 -0
  73. package/server-next.mjs.map +1 -0
  74. package/server.d.mts +11 -0
  75. package/server.d.mts.map +1 -0
  76. package/server.mjs +48 -0
  77. package/server.mjs.map +1 -0
  78. package/utils-meGsrSPI.d.mts +77 -0
  79. package/utils-meGsrSPI.d.mts.map +1 -0
package/package.json ADDED
@@ -0,0 +1,179 @@
1
+ {
2
+ "name": "@od-oneapp/observability",
3
+ "version": "2026.2.1501-canary.1",
4
+ "description": "Observability package with provider subpackages",
5
+ "type": "module",
6
+ "sideEffects": false,
7
+ "exports": {
8
+ ".": {
9
+ "import": "./index.mjs",
10
+ "types": "./index.d.mts"
11
+ },
12
+ "./client": {
13
+ "import": "./client.mjs",
14
+ "types": "./client.d.mts"
15
+ },
16
+ "./server": {
17
+ "import": "./server.mjs",
18
+ "types": "./server.d.mts"
19
+ },
20
+ "./client/next": {
21
+ "import": "./client-next.mjs",
22
+ "types": "./client-next.d.mts"
23
+ },
24
+ "./server/next": {
25
+ "import": "./server-next.mjs",
26
+ "types": "./server-next.d.mts"
27
+ },
28
+ "./server/edge": {
29
+ "import": "./server-edge.mjs",
30
+ "types": "./server-edge.d.mts"
31
+ },
32
+ "./env": {
33
+ "import": "./env.mjs",
34
+ "types": "./env.d.mts"
35
+ },
36
+ "./plugins/console": {
37
+ "import": "./plugins-console.mjs",
38
+ "types": "./plugins-console.d.mts"
39
+ },
40
+ "./plugins/sentry": {
41
+ "import": "./plugins-sentry.mjs",
42
+ "types": "./plugins-sentry.d.mts"
43
+ },
44
+ "./plugins/sentry/env": {
45
+ "import": "./plugins-sentry-env.mjs",
46
+ "types": "./plugins-sentry-env.d.mts"
47
+ },
48
+ "./plugins/betterstack": {
49
+ "import": "./plugins-betterstack.mjs",
50
+ "types": "./plugins-betterstack.d.mts"
51
+ },
52
+ "./plugins/betterstack/env": {
53
+ "import": "./plugins-betterstack-env.mjs",
54
+ "types": "./plugins-betterstack-env.d.mts"
55
+ },
56
+ "./plugins/sentry-microfrontend": {
57
+ "import": "./plugins-sentry-microfrontend.mjs",
58
+ "types": "./plugins-sentry-microfrontend.d.mts"
59
+ },
60
+ "./plugins/sentry-microfrontend/env": {
61
+ "import": "./plugins-sentry-microfrontend-env.mjs",
62
+ "types": "./plugins-sentry-microfrontend-env.d.mts"
63
+ },
64
+ "./hooks/useObservability": {
65
+ "import": "./hooks-useObservability.mjs",
66
+ "types": "./hooks-useObservability.d.mts"
67
+ }
68
+ },
69
+ "dependencies": {
70
+ "@t3-oss/env-core": "^0.13.10",
71
+ "zod": "4.3.6",
72
+ "@sentry/nextjs": "^10.38.0",
73
+ "@sentry/node": "^10.38.0",
74
+ "@sentry/react": "^10.38.0"
75
+ },
76
+ "optionalDependencies": {
77
+ "@logtail/js": "^0.5.6",
78
+ "@logtail/next": "^0.3.1"
79
+ },
80
+ "peerDependencies": {
81
+ "next": "16.1.6",
82
+ "react": "^19.2.4"
83
+ },
84
+ "peerDependenciesMeta": {
85
+ "next": {
86
+ "optional": true
87
+ },
88
+ "react": {
89
+ "optional": true
90
+ }
91
+ },
92
+ "repository": {
93
+ "type": "git",
94
+ "url": "https://github.com/OneDigital-Product/monorepo.git",
95
+ "directory": "platform/packages/observability"
96
+ },
97
+ "license": "MIT",
98
+ "publishConfig": {
99
+ "access": "restricted",
100
+ "exports": {
101
+ ".": {
102
+ "types": "./dist/index.d.mts",
103
+ "import": "./dist/index.mjs",
104
+ "default": "./dist/index.mjs"
105
+ },
106
+ "./client": {
107
+ "types": "./dist/client.d.mts",
108
+ "import": "./dist/client.mjs",
109
+ "default": "./dist/client.mjs"
110
+ },
111
+ "./server": {
112
+ "types": "./dist/server.d.mts",
113
+ "import": "./dist/server.mjs",
114
+ "default": "./dist/server.mjs"
115
+ },
116
+ "./client/next": {
117
+ "types": "./dist/client-next.d.mts",
118
+ "import": "./dist/client-next.mjs",
119
+ "default": "./dist/client-next.mjs"
120
+ },
121
+ "./server/next": {
122
+ "types": "./dist/server-next.d.mts",
123
+ "import": "./dist/server-next.mjs",
124
+ "default": "./dist/server-next.mjs"
125
+ },
126
+ "./server/edge": {
127
+ "types": "./dist/server-edge.d.mts",
128
+ "import": "./dist/server-edge.mjs",
129
+ "default": "./dist/server-edge.mjs"
130
+ },
131
+ "./env": {
132
+ "types": "./dist/env.d.mts",
133
+ "import": "./dist/env.mjs",
134
+ "default": "./dist/env.mjs"
135
+ },
136
+ "./plugins/console": {
137
+ "types": "./dist/plugins-console.d.mts",
138
+ "import": "./dist/plugins-console.mjs",
139
+ "default": "./dist/plugins-console.mjs"
140
+ },
141
+ "./plugins/sentry": {
142
+ "types": "./dist/plugins-sentry.d.mts",
143
+ "import": "./dist/plugins-sentry.mjs",
144
+ "default": "./dist/plugins-sentry.mjs"
145
+ },
146
+ "./plugins/sentry/env": {
147
+ "types": "./dist/plugins-sentry-env.d.mts",
148
+ "import": "./dist/plugins-sentry-env.mjs",
149
+ "default": "./dist/plugins-sentry-env.mjs"
150
+ },
151
+ "./plugins/betterstack": {
152
+ "types": "./dist/plugins-betterstack.d.mts",
153
+ "import": "./dist/plugins-betterstack.mjs",
154
+ "default": "./dist/plugins-betterstack.mjs"
155
+ },
156
+ "./plugins/betterstack/env": {
157
+ "types": "./dist/plugins-betterstack-env.d.mts",
158
+ "import": "./dist/plugins-betterstack-env.mjs",
159
+ "default": "./dist/plugins-betterstack-env.mjs"
160
+ },
161
+ "./plugins/sentry-microfrontend": {
162
+ "types": "./dist/plugins-sentry-microfrontend.d.mts",
163
+ "import": "./dist/plugins-sentry-microfrontend.mjs",
164
+ "default": "./dist/plugins-sentry-microfrontend.mjs"
165
+ },
166
+ "./plugins/sentry-microfrontend/env": {
167
+ "types": "./dist/plugins-sentry-microfrontend-env.d.mts",
168
+ "import": "./dist/plugins-sentry-microfrontend-env.mjs",
169
+ "default": "./dist/plugins-sentry-microfrontend-env.mjs"
170
+ },
171
+ "./hooks/useObservability": {
172
+ "types": "./dist/hooks-useObservability.d.mts",
173
+ "import": "./dist/hooks-useObservability.mjs",
174
+ "default": "./dist/hooks-useObservability.mjs"
175
+ }
176
+ },
177
+ "registry": "https://registry.npmjs.org/"
178
+ }
179
+ }
@@ -0,0 +1,72 @@
1
+ import { a as Breadcrumb, d as ObservabilityUser, l as ObservabilityContext, n as ObservabilityServerPlugin, o as LogLevel } from "./plugin-BllDfqyj.mjs";
2
+
3
+ //#region src/plugins/betterstack/plugin.d.ts
4
+ interface LogtailClient {
5
+ info(message: string, data?: any): void;
6
+ warn(message: string, data?: any): void;
7
+ error(message: string, data?: any): void;
8
+ debug(message: string, data?: any): void;
9
+ flush(): Promise<void>;
10
+ }
11
+ interface BetterStackPluginConfig {
12
+ logtailPackage?: string;
13
+ sourceToken?: string;
14
+ endpoint?: string;
15
+ logLevel?: 'debug' | 'info' | 'warn' | 'error' | 'off';
16
+ enabled?: boolean;
17
+ batchInterval?: number;
18
+ batchSize?: number;
19
+ retryCount?: number;
20
+ retryBackoff?: boolean;
21
+ middleware?: any[];
22
+ }
23
+ declare class BetterStackPlugin<T extends LogtailClient = LogtailClient> implements ObservabilityServerPlugin<T> {
24
+ name: string;
25
+ enabled: boolean;
26
+ protected client: T | undefined;
27
+ protected initialized: boolean;
28
+ protected logtailPackage: string;
29
+ protected currentUser: ObservabilityUser | null;
30
+ protected breadcrumbs: Breadcrumb[];
31
+ protected breadcrumbIndex: number;
32
+ protected config: BetterStackPluginConfig;
33
+ constructor(config?: BetterStackPluginConfig);
34
+ private detectLogtailPackage;
35
+ getClient(): T | undefined;
36
+ protected getSafeEnv(): Readonly<{
37
+ LOGTAIL_SOURCE_TOKEN?: string | undefined;
38
+ BETTERSTACK_SOURCE_TOKEN?: string | undefined;
39
+ BETTER_STACK_SOURCE_TOKEN?: string | undefined;
40
+ BETTER_STACK_INGESTING_URL?: string | undefined;
41
+ BETTER_STACK_LOG_LEVEL?: "error" | "debug" | "info" | "warn" | "off" | undefined;
42
+ NEXT_PUBLIC_LOGTAIL_TOKEN?: string | undefined;
43
+ NEXT_PUBLIC_BETTERSTACK_TOKEN?: string | undefined;
44
+ NEXT_PUBLIC_BETTER_STACK_SOURCE_TOKEN?: string | undefined;
45
+ NEXT_PUBLIC_BETTER_STACK_INGESTING_URL?: string | undefined;
46
+ NEXT_PUBLIC_BETTER_STACK_LOG_LEVEL?: "error" | "debug" | "info" | "warn" | "off" | undefined;
47
+ }> | {
48
+ LOGTAIL_SOURCE_TOKEN: any;
49
+ BETTERSTACK_SOURCE_TOKEN: any;
50
+ NEXT_PUBLIC_LOGTAIL_TOKEN: any;
51
+ NEXT_PUBLIC_BETTERSTACK_TOKEN: any;
52
+ BETTER_STACK_SOURCE_TOKEN: any;
53
+ BETTER_STACK_INGESTING_URL: any;
54
+ BETTER_STACK_LOG_LEVEL: "error" | "debug" | "info" | "warn" | "off";
55
+ NEXT_PUBLIC_BETTER_STACK_SOURCE_TOKEN: any;
56
+ NEXT_PUBLIC_BETTER_STACK_INGESTING_URL: any;
57
+ NEXT_PUBLIC_BETTER_STACK_LOG_LEVEL: "error" | "debug" | "info" | "warn" | "off";
58
+ };
59
+ initialize(config?: BetterStackPluginConfig): Promise<void>;
60
+ shutdown(): Promise<void>;
61
+ captureException(error: Error | unknown, context?: ObservabilityContext): void;
62
+ captureMessage(message: string, level?: LogLevel, context?: ObservabilityContext): void;
63
+ setUser(user: ObservabilityUser | null): void;
64
+ addBreadcrumb(breadcrumb: Breadcrumb): void;
65
+ private getRecentBreadcrumbs;
66
+ withScope(callback: (scope: any) => void): void;
67
+ flush(_timeout?: number): Promise<boolean>;
68
+ }
69
+ declare const createBetterStackPlugin: <T extends LogtailClient = LogtailClient>(config?: BetterStackPluginConfig) => BetterStackPlugin<T>;
70
+ //#endregion
71
+ export { BetterStackPluginConfig as n, createBetterStackPlugin as r, BetterStackPlugin as t };
72
+ //# sourceMappingURL=plugin-BM4n9vNF.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-BM4n9vNF.d.mts","names":[],"sources":["../src/plugins/betterstack/plugin.ts"],"mappings":";;;UA+BU,aAAA;EACR,IAAA,CAAK,OAAA,UAAiB,IAAA;EACtB,IAAA,CAAK,OAAA,UAAiB,IAAA;EACtB,KAAA,CAAM,OAAA,UAAiB,IAAA;EACvB,KAAA,CAAM,OAAA,UAAiB,IAAA;EACvB,KAAA,IAAS,OAAA;AAAA;AAAA,UAMM,uBAAA;EAKf,cAAA;EAGA,WAAA;EACA,QAAA;EACA,QAAA;EACA,OAAA;EAGA,aAAA;EACA,SAAA;EACA,UAAA;EACA,YAAA;EACA,UAAA;AAAA;AAAA,cAaW,iBAAA,WACD,aAAA,GAAgB,aAAA,aACf,yBAAA,CAA0B,CAAA;EACrC,IAAA;EACA,OAAA;EAAA,UACU,MAAA,EAAQ,CAAA;EAAA,UACR,WAAA;EAAA,UACA,cAAA;EAAA,UACA,WAAA,EAAa,iBAAA;EAAA,UACb,WAAA,EAAa,UAAA;EAAA,UACb,eAAA;EAAA,UACA,MAAA,EAAQ,uBAAA;cAON,MAAA,GAAQ,uBAAA;EAAA,QAuBZ,oBAAA;EASR,SAAA,CAAA,GAAa,CAAA;EAAA,UASH,UAAA,CAAA,GAAU,QAAA;;;;;;;;;;;;;;;;;;;;;;;EAId,UAAA,CAAW,MAAA,GAAS,uBAAA,GAA0B,OAAA;EAmE9C,QAAA,CAAA,GAAY,OAAA;EAOlB,gBAAA,CAAiB,KAAA,EAAO,KAAA,YAAiB,OAAA,GAAU,oBAAA;EAqBnD,cAAA,CAAe,OAAA,UAAiB,KAAA,GAAO,QAAA,EAAmB,OAAA,GAAU,oBAAA;EA8BpE,OAAA,CAAQ,IAAA,EAAM,iBAAA;EAKd,aAAA,CAAc,UAAA,EAAY,UAAA;EAAA,QAuBlB,oBAAA;EA8BR,SAAA,CAAU,QAAA,GAAW,KAAA;EAmBf,KAAA,CAAM,QAAA,YAAoB,OAAA;AAAA;AAAA,cA8BrB,uBAAA,aAAqC,aAAA,GAAgB,aAAA,EAChE,MAAA,GAAS,uBAAA,KACR,iBAAA,CAAkB,CAAA"}
@@ -0,0 +1,53 @@
1
+ //#region src/core/types.d.ts
2
+ interface ObservabilityUser {
3
+ id: string;
4
+ email?: string;
5
+ username?: string;
6
+ ip_address?: string;
7
+ [key: string]: unknown;
8
+ }
9
+ interface ObservabilityContext {
10
+ [key: string]: unknown;
11
+ }
12
+ type LogLevel = 'debug' | 'info' | 'warning' | 'error';
13
+ interface Breadcrumb {
14
+ message: string;
15
+ category?: string;
16
+ level?: LogLevel | 'critical';
17
+ data?: Record<string, unknown>;
18
+ timestamp?: number;
19
+ }
20
+ interface ObservabilityClient {
21
+ captureException(error: Error | unknown, context?: ObservabilityContext): void;
22
+ captureMessage(message: string, level?: LogLevel, context?: ObservabilityContext): void;
23
+ setUser(user: ObservabilityUser | null): void;
24
+ addBreadcrumb(breadcrumb: Breadcrumb): void;
25
+ withScope(callback: (scope: any) => void): void;
26
+ }
27
+ interface ObservabilityServer extends ObservabilityClient {
28
+ flush(timeout?: number): Promise<boolean>;
29
+ }
30
+ interface ObservabilityConfig {
31
+ enabled?: boolean;
32
+ environment?: 'development' | 'preview' | 'production';
33
+ debug?: boolean;
34
+ }
35
+ //#endregion
36
+ //#region src/core/plugin.d.ts
37
+ interface ObservabilityPlugin<TClient = any> extends ObservabilityClient {
38
+ name: string;
39
+ enabled: boolean;
40
+ getClient(): TClient | undefined;
41
+ initialize?(config?: any): Promise<void>;
42
+ shutdown?(): Promise<void>;
43
+ }
44
+ interface ObservabilityServerPlugin<TClient = any> extends ObservabilityPlugin<TClient>, ObservabilityServer {}
45
+ type PluginFactory<TConfig = any, TPlugin = ObservabilityPlugin> = (config?: TConfig) => TPlugin;
46
+ interface PluginLifecycle {
47
+ onError?: (error: Error, plugin: ObservabilityPlugin) => void;
48
+ onInitialized?: (plugin: ObservabilityPlugin) => void;
49
+ onShutdown?: (plugin: ObservabilityPlugin) => void;
50
+ }
51
+ //#endregion
52
+ export { Breadcrumb as a, ObservabilityConfig as c, ObservabilityUser as d, PluginLifecycle as i, ObservabilityContext as l, ObservabilityServerPlugin as n, LogLevel as o, PluginFactory as r, ObservabilityClient as s, ObservabilityPlugin as t, ObservabilityServer as u };
53
+ //# sourceMappingURL=plugin-BllDfqyj.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"plugin-BllDfqyj.d.mts","names":[],"sources":["../src/core/types.ts","../src/core/plugin.ts"],"mappings":";UAYiB,iBAAA;EAEf,EAAA;EAEA,KAAA;EAEA,QAAA;EAEA,UAAA;EAAA,CAMC,GAAA;AAAA;AAAA,UASc,oBAAA;EAAA,CACd,GAAA;AAAA;AAAA,KAQS,QAAA;AAAA,UAQK,UAAA;EAEf,OAAA;EAEA,QAAA;EAEA,KAAA,GAAQ,QAAA;EAER,IAAA,GAAO,MAAA;EAEP,SAAA;AAAA;AAAA,UASe,mBAAA;EAOf,gBAAA,CAAiB,KAAA,EAAO,KAAA,YAAiB,OAAA,GAAU,oBAAA;EAQnD,cAAA,CAAe,OAAA,UAAiB,KAAA,GAAQ,QAAA,EAAU,OAAA,GAAU,oBAAA;EAM5D,OAAA,CAAQ,IAAA,EAAM,iBAAA;EAMd,aAAA,CAAc,UAAA,EAAY,UAAA;EAM1B,SAAA,CAAU,QAAA,GAAW,KAAA;AAAA;AAAA,UASN,mBAAA,SAA4B,mBAAA;EAU3C,KAAA,CAAM,OAAA,YAAmB,OAAA;AAAA;AAAA,UAMV,mBAAA;EAEf,OAAA;EAEA,WAAA;EAEA,KAAA;AAAA;;;UC7He,mBAAA,wBAA2C,mBAAA;EAI1D,IAAA;EAKA,OAAA;EAMA,SAAA,IAAa,OAAA;EAKb,UAAA,EAAY,MAAA,SAAe,OAAA;EAK3B,QAAA,KAAa,OAAA;AAAA;AAAA,UAME,yBAAA,wBACP,mBAAA,CAAoB,OAAA,GAAU,mBAAA;AAAA,KAO5B,aAAA,0BAAuC,mBAAA,KACjD,MAAA,GAAS,OAAA,KACN,OAAA;AAAA,UAKY,eAAA;EACf,OAAA,IAAW,KAAA,EAAO,KAAA,EAAO,MAAA,EAAQ,mBAAA;EACjC,aAAA,IAAiB,MAAA,EAAQ,mBAAA;EACzB,UAAA,IAAc,MAAA,EAAQ,mBAAA;AAAA"}