@lssm/example.personalization 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

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 (63) hide show
  1. package/.turbo/turbo-build$colon$bundle.log +88 -17
  2. package/.turbo/turbo-build.log +87 -16
  3. package/CHANGELOG.md +7 -6
  4. package/dist/behavior-tracking.js +49 -1
  5. package/dist/docs/index.js +1 -1
  6. package/dist/docs/personalization.docblock.js +29 -8
  7. package/dist/example.js +38 -1
  8. package/dist/index.js +7 -1
  9. package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js +16 -0
  10. package/dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js +16 -0
  11. package/dist/libs/contracts/dist/docs/index.js +29 -0
  12. package/dist/libs/contracts/dist/docs/presentations.js +71 -0
  13. package/dist/libs/contracts/dist/docs/registry.js +44 -0
  14. package/dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js +16 -0
  15. package/dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js +16 -0
  16. package/dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js +16 -0
  17. package/dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js +16 -0
  18. package/dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js +16 -0
  19. package/dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js +80 -0
  20. package/dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js +57 -0
  21. package/dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js +16 -0
  22. package/dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js +357 -0
  23. package/dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js +37 -0
  24. package/dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js +16 -0
  25. package/dist/libs/contracts/dist/docs/tech/schema/README.docblock.js +20 -0
  26. package/dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js +48 -0
  27. package/dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js +79 -0
  28. package/dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js +84 -0
  29. package/dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js +45 -0
  30. package/dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js +67 -0
  31. package/dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js +40 -0
  32. package/dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js +69 -0
  33. package/dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js +47 -0
  34. package/dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js +62 -0
  35. package/dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js +155 -0
  36. package/dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js +20 -0
  37. package/dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js +101 -0
  38. package/dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js +20 -0
  39. package/dist/libs/logger/dist/context.node.js +78 -0
  40. package/dist/libs/logger/dist/elysia-plugin.js +3 -0
  41. package/dist/libs/logger/dist/formatters.js +163 -0
  42. package/dist/libs/logger/dist/index.js +7 -0
  43. package/dist/libs/logger/dist/logger.node.js +189 -0
  44. package/dist/libs/logger/dist/timer.js +126 -0
  45. package/dist/libs/logger/dist/tracer.node.js +115 -0
  46. package/dist/libs/logger/dist/types.js +13 -0
  47. package/dist/libs/overlay-engine/dist/index.js +6 -0
  48. package/dist/libs/overlay-engine/dist/merger.js +106 -0
  49. package/dist/libs/overlay-engine/dist/registry.js +106 -0
  50. package/dist/libs/overlay-engine/dist/runtime.js +53 -0
  51. package/dist/libs/overlay-engine/dist/signer.js +45 -0
  52. package/dist/libs/overlay-engine/dist/spec.js +7 -0
  53. package/dist/libs/overlay-engine/dist/validator.js +93 -0
  54. package/dist/libs/personalization/dist/analyzer.js +54 -0
  55. package/dist/libs/personalization/dist/store.js +58 -0
  56. package/dist/libs/personalization/dist/tracker.js +92 -0
  57. package/dist/libs/workflow-composer/dist/composer.js +28 -0
  58. package/dist/libs/workflow-composer/dist/injector.js +72 -0
  59. package/dist/libs/workflow-composer/dist/validator.js +36 -0
  60. package/dist/overlay-customization.js +53 -1
  61. package/dist/workflow-extension.js +67 -1
  62. package/package.json +9 -8
  63. package/tsconfig.tsbuildinfo +1 -1
@@ -0,0 +1,78 @@
1
+ import { AsyncLocalStorage } from "node:async_hooks";
2
+
3
+ //#region ../../libs/logger/dist/context.node.mjs
4
+ /**
5
+ * Node.js implementation of LogContext using AsyncLocalStorage.
6
+ */
7
+ var LogContext = class LogContext$1 {
8
+ static instance;
9
+ storage;
10
+ constructor() {
11
+ this.storage = new AsyncLocalStorage();
12
+ }
13
+ static getInstance() {
14
+ if (!LogContext$1.instance) LogContext$1.instance = new LogContext$1();
15
+ return LogContext$1.instance;
16
+ }
17
+ /**
18
+ * Run a function with a new context
19
+ */
20
+ run(context, fn) {
21
+ const contextData = {
22
+ context: { ...context },
23
+ trace: this.getCurrentTrace()
24
+ };
25
+ return this.storage.run(contextData, fn);
26
+ }
27
+ /**
28
+ * Run a function with an extended context (merges with current)
29
+ */
30
+ extend(additionalContext, fn) {
31
+ const mergedContext = {
32
+ ...this.getContext(),
33
+ ...additionalContext
34
+ };
35
+ return this.run(mergedContext, fn);
36
+ }
37
+ /**
38
+ * Set context data for the current execution context
39
+ */
40
+ set(key, value) {
41
+ const current = this.storage.getStore();
42
+ if (current) current.context[key] = value;
43
+ }
44
+ /**
45
+ * Get a specific context value
46
+ */
47
+ get(key) {
48
+ return this.storage.getStore()?.context?.[key];
49
+ }
50
+ /**
51
+ * Get all context data
52
+ */
53
+ getContext() {
54
+ return this.storage.getStore()?.context || {};
55
+ }
56
+ /**
57
+ * Set trace context
58
+ */
59
+ setTrace(trace) {
60
+ const current = this.storage.getStore();
61
+ if (current) current.trace = trace;
62
+ }
63
+ /**
64
+ * Get current trace context
65
+ */
66
+ getCurrentTrace() {
67
+ return this.storage.getStore()?.trace;
68
+ }
69
+ /**
70
+ * Generate a unique ID for requests/operations
71
+ */
72
+ generateId() {
73
+ return crypto.randomUUID();
74
+ }
75
+ };
76
+
77
+ //#endregion
78
+ export { LogContext };
@@ -0,0 +1,3 @@
1
+ import "./context.node.js";
2
+ import "./logger.node.js";
3
+ import "elysia";
@@ -0,0 +1,163 @@
1
+ import { LogLevel } from "./types.js";
2
+
3
+ //#region ../../libs/logger/dist/formatters.mjs
4
+ const colors = {
5
+ reset: "\x1B[0m",
6
+ bright: "\x1B[1m",
7
+ dim: "\x1B[2m",
8
+ red: "\x1B[31m",
9
+ green: "\x1B[32m",
10
+ yellow: "\x1B[33m",
11
+ blue: "\x1B[34m",
12
+ magenta: "\x1B[35m",
13
+ cyan: "\x1B[36m",
14
+ white: "\x1B[37m",
15
+ gray: "\x1B[90m",
16
+ bgRed: "\x1B[41m",
17
+ bgYellow: "\x1B[43m"
18
+ };
19
+ const levelConfig = {
20
+ [LogLevel.TRACE]: {
21
+ color: colors.gray,
22
+ symbol: "○",
23
+ name: "TRACE"
24
+ },
25
+ [LogLevel.DEBUG]: {
26
+ color: colors.blue,
27
+ symbol: "●",
28
+ name: "DEBUG"
29
+ },
30
+ [LogLevel.INFO]: {
31
+ color: colors.green,
32
+ symbol: "●",
33
+ name: "INFO "
34
+ },
35
+ [LogLevel.WARN]: {
36
+ color: colors.yellow,
37
+ symbol: "▲",
38
+ name: "WARN "
39
+ },
40
+ [LogLevel.ERROR]: {
41
+ color: colors.red,
42
+ symbol: "✖",
43
+ name: "ERROR"
44
+ },
45
+ [LogLevel.FATAL]: {
46
+ color: colors.bgRed + colors.white,
47
+ symbol: "💀",
48
+ name: "FATAL"
49
+ }
50
+ };
51
+ var DevFormatter = class {
52
+ enableColors;
53
+ constructor(enableColors = true) {
54
+ this.enableColors = enableColors;
55
+ }
56
+ format(entry) {
57
+ const parts = [];
58
+ const config = levelConfig[entry.level];
59
+ const timestamp = this.formatTimestamp(entry.timestamp);
60
+ parts.push(this.colorize(timestamp, colors.gray));
61
+ const levelText = `${config.symbol} ${config.name}`;
62
+ parts.push(this.colorize(levelText, config.color));
63
+ if (entry.traceId) {
64
+ const traceInfo = this.formatTraceInfo(entry);
65
+ parts.push(this.colorize(traceInfo, colors.cyan));
66
+ }
67
+ parts.push(this.colorize(entry.message, colors.white));
68
+ if (entry.duration !== void 0) {
69
+ const durationText = `(${this.formatDuration(entry.duration)})`;
70
+ parts.push(this.colorize(durationText, colors.magenta));
71
+ }
72
+ let output = parts.join(" ");
73
+ if (entry.context && Object.keys(entry.context).length > 0) output += "\n" + this.formatContext(entry.context);
74
+ if (entry.metadata && Object.keys(entry.metadata).length > 0) output += "\n" + this.formatMetadata(entry.metadata);
75
+ if (entry.error) output += "\n" + this.formatError(entry.error);
76
+ if (entry.tags && entry.tags.length > 0) {
77
+ const tagsText = entry.tags.map((tag) => `#${tag}`).join(" ");
78
+ output += "\n" + this.colorize(`Tags: ${tagsText}`, colors.blue);
79
+ }
80
+ return output;
81
+ }
82
+ formatTimestamp(timestamp) {
83
+ return timestamp.toISOString().substring(11, 23);
84
+ }
85
+ formatTraceInfo(entry) {
86
+ const parts = [`trace:${entry.traceId?.substring(0, 8) || "unknown"}`];
87
+ if (entry.spanId && entry.spanId.length >= 8) parts.push(`span:${entry.spanId.substring(0, 8)}`);
88
+ if (entry.parentId && entry.parentId.length >= 8) parts.push(`parent:${entry.parentId.substring(0, 8)}`);
89
+ return `[${parts.join("|")}]`;
90
+ }
91
+ formatDuration(duration) {
92
+ if (duration < 1) return `${(duration * 1e3).toFixed(0)}μs`;
93
+ else if (duration < 1e3) return `${duration.toFixed(2)}ms`;
94
+ else return `${(duration / 1e3).toFixed(2)}s`;
95
+ }
96
+ formatContext(context) {
97
+ const formatted = this.formatObject(context, 2);
98
+ return this.colorize(`Context: ${formatted}`, colors.cyan);
99
+ }
100
+ formatMetadata(metadata) {
101
+ const formatted = this.formatObject(metadata, 2);
102
+ return this.colorize(`Metadata: ${formatted}`, colors.blue);
103
+ }
104
+ formatError(error) {
105
+ let output = this.colorize(`Error: ${error.name}: ${error.message}`, colors.red);
106
+ if (error.stack) {
107
+ const indentedStack = error.stack.split("\n").slice(1, 6).map((line) => ` ${line}`).join("\n");
108
+ output += "\n" + this.colorize(indentedStack, colors.gray);
109
+ }
110
+ return output;
111
+ }
112
+ formatObject(obj, indent = 0) {
113
+ const spaces = " ".repeat(indent);
114
+ const entries = Object.entries(obj);
115
+ if (entries.length === 0) return "{}";
116
+ if (entries[0] && typeof entries[0][1] !== "object") return `{ ${entries[0][0]}: ${this.formatValue(entries[0][1])} }`;
117
+ return `{\n${entries.map(([key, value]) => {
118
+ return `${spaces} ${key}: ${this.formatValue(value, indent + 2)}`;
119
+ }).join("\n")}\n${spaces}}`;
120
+ }
121
+ formatValue(value, indent = 0) {
122
+ if (value === null) return "null";
123
+ if (value === void 0) return "undefined";
124
+ if (typeof value === "string") return `"${value}"`;
125
+ if (typeof value === "boolean" || typeof value === "number") return String(value);
126
+ if (value instanceof Date) return value.toISOString();
127
+ if (Array.isArray(value)) {
128
+ if (value.length === 0) return "[]";
129
+ return `[${value.map((v) => this.formatValue(v)).join(", ")}]`;
130
+ }
131
+ if (typeof value === "object") return this.formatObject(value, indent);
132
+ return String(value);
133
+ }
134
+ colorize(text, color) {
135
+ if (!this.enableColors) return text;
136
+ return `${color}${text}${colors.reset}`;
137
+ }
138
+ };
139
+ var ProductionFormatter = class {
140
+ format(entry) {
141
+ const logObject = {
142
+ timestamp: entry.timestamp,
143
+ level: entry.level,
144
+ message: entry.message
145
+ };
146
+ if (entry.traceId) logObject.traceId = entry.traceId;
147
+ if (entry.spanId) logObject.spanId = entry.spanId;
148
+ if (entry.parentId) logObject.parentId = entry.parentId;
149
+ if (entry.duration !== void 0) logObject.duration = entry.duration;
150
+ if (entry.context && Object.keys(entry.context).length > 0) logObject.context = entry.context;
151
+ if (entry.metadata && Object.keys(entry.metadata).length > 0) logObject.metadata = entry.metadata;
152
+ if (entry.error) logObject.error = {
153
+ name: entry.error.name,
154
+ message: entry.error.message,
155
+ stack: entry.error.stack
156
+ };
157
+ if (entry.tags && entry.tags.length > 0) logObject.tags = entry.tags;
158
+ return JSON.stringify(logObject);
159
+ }
160
+ };
161
+
162
+ //#endregion
163
+ export { DevFormatter, ProductionFormatter };
@@ -0,0 +1,7 @@
1
+ import { LogContext } from "./context.node.js";
2
+ import { LogLevel } from "./types.js";
3
+ import { Timer } from "./timer.js";
4
+ import { Tracer } from "./tracer.node.js";
5
+ import { DevFormatter, ProductionFormatter } from "./formatters.js";
6
+ import { Logger } from "./logger.node.js";
7
+ import "./elysia-plugin.js";
@@ -0,0 +1,189 @@
1
+ import { LogContext } from "./context.node.js";
2
+ import { LogLevel } from "./types.js";
3
+ import { TimerManager } from "./timer.js";
4
+ import { Tracer } from "./tracer.node.js";
5
+ import { DevFormatter, ProductionFormatter } from "./formatters.js";
6
+
7
+ //#region ../../libs/logger/dist/logger.node.mjs
8
+ var Logger = class Logger$1 {
9
+ config;
10
+ formatter;
11
+ context;
12
+ tracer;
13
+ timerManager;
14
+ constructor(config) {
15
+ this.config = {
16
+ level: LogLevel.INFO,
17
+ environment: process.env.NODE_ENV || "development",
18
+ enableTracing: true,
19
+ enableTiming: true,
20
+ enableContext: true,
21
+ enableColors: true,
22
+ maxContextDepth: 10,
23
+ timestampFormat: "iso",
24
+ ...config
25
+ };
26
+ this.context = LogContext.getInstance();
27
+ this.tracer = new Tracer();
28
+ this.timerManager = new TimerManager();
29
+ this.formatter = this.config.environment === "production" ? new ProductionFormatter() : new DevFormatter(this.config.enableColors);
30
+ }
31
+ traceLog(message, metadata) {
32
+ this.log(LogLevel.TRACE, message, metadata);
33
+ }
34
+ debug(message, metadata) {
35
+ this.log(LogLevel.DEBUG, message, metadata);
36
+ }
37
+ info(message, metadata) {
38
+ this.log(LogLevel.INFO, message, metadata);
39
+ }
40
+ warn(message, metadata) {
41
+ this.log(LogLevel.WARN, message, metadata);
42
+ }
43
+ error(message, metadata, error) {
44
+ this.log(LogLevel.ERROR, message, metadata, error);
45
+ }
46
+ fatal(message, metadata, error) {
47
+ this.log(LogLevel.FATAL, message, metadata, error);
48
+ }
49
+ withContext(context, fn) {
50
+ return this.context.run(context, fn);
51
+ }
52
+ extendContext(additionalContext, fn) {
53
+ return this.context.extend(additionalContext, fn);
54
+ }
55
+ setContext(key, value) {
56
+ this.context.set(key, value);
57
+ }
58
+ getContext() {
59
+ return this.context.getContext();
60
+ }
61
+ trace = async (options, fn) => {
62
+ if (!this.config.enableTracing) return await fn();
63
+ return this.tracer.trace(options, fn);
64
+ };
65
+ getTraceId() {
66
+ return this.tracer.getCurrentTrace()?.traceId;
67
+ }
68
+ startSpan(options) {
69
+ if (!this.config.enableTracing) return null;
70
+ return this.tracer.startSpan(options);
71
+ }
72
+ finishSpan(spanId) {
73
+ if (!this.config.enableTracing) return;
74
+ return this.tracer.finishSpan(spanId);
75
+ }
76
+ addTraceMetadata(key, value) {
77
+ if (this.config.enableTracing) this.tracer.addMetadata(key, value);
78
+ }
79
+ addTraceTags(...tags) {
80
+ if (this.config.enableTracing) this.tracer.addTags(...tags);
81
+ }
82
+ startTimer(id) {
83
+ if (!this.config.enableTiming) return null;
84
+ return this.timerManager.start(id);
85
+ }
86
+ stopTimer(id) {
87
+ if (!this.config.enableTiming) return;
88
+ return this.timerManager.stop(id);
89
+ }
90
+ getTimer(id) {
91
+ return this.timerManager.get(id);
92
+ }
93
+ child(context) {
94
+ const childLogger = new Logger$1(this.config);
95
+ Object.entries(context).forEach(([key, value]) => {
96
+ childLogger.setContext(key, value);
97
+ });
98
+ return childLogger;
99
+ }
100
+ setLevel(level) {
101
+ this.config.level = level;
102
+ }
103
+ setFormatter(formatter) {
104
+ this.formatter = formatter;
105
+ }
106
+ async profile(operationName, fn, options) {
107
+ const timer = this.startTimer(`profile-${operationName}`);
108
+ const startTime = performance.now();
109
+ try {
110
+ const result = await this.tracer.trace({
111
+ operationType: "custom",
112
+ operationName: `profile:${operationName}`,
113
+ autoTiming: true
114
+ }, fn);
115
+ const duration = performance.now() - startTime;
116
+ timer?.stop();
117
+ const logLevel = options?.logLevel || LogLevel.DEBUG;
118
+ this.log(logLevel, `Profile: ${operationName} completed`, {
119
+ operation: operationName,
120
+ duration: `${duration.toFixed(2)}ms`,
121
+ result: options?.logResult ? result : "[result hidden]"
122
+ });
123
+ return result;
124
+ } catch (error) {
125
+ const duration = performance.now() - startTime;
126
+ timer?.stop();
127
+ this.error(`Profile: ${operationName} failed`, {
128
+ operation: operationName,
129
+ duration: `${duration.toFixed(2)}ms`,
130
+ error: error.message
131
+ }, error);
132
+ throw error;
133
+ }
134
+ }
135
+ logRequest(method, url, statusCode, duration) {
136
+ const level = this.getHttpLogLevel(statusCode);
137
+ const message = `${method.toUpperCase()} ${url}${statusCode ? ` ${statusCode}` : ""}`;
138
+ this.log(level, message, {
139
+ method,
140
+ url,
141
+ statusCode,
142
+ duration: duration ? `${duration.toFixed(2)}ms` : void 0,
143
+ type: "http_request"
144
+ });
145
+ }
146
+ async flush() {
147
+ this.timerManager.clear();
148
+ }
149
+ getStats() {
150
+ return {
151
+ activeTimers: this.timerManager.getActive().length,
152
+ activeSpans: this.tracer.getActiveSpans().length,
153
+ config: { ...this.config }
154
+ };
155
+ }
156
+ output(message, level) {
157
+ if (level >= LogLevel.ERROR) console.error(message);
158
+ else console.log(message);
159
+ }
160
+ log(level, message, metadata, error) {
161
+ if (level < this.config.level) return;
162
+ const currentTrace = this.config.enableTracing ? this.tracer.getCurrentTrace() : void 0;
163
+ const contextData = this.config.enableContext ? this.context.getContext() : void 0;
164
+ const entry = {
165
+ level,
166
+ message,
167
+ timestamp: /* @__PURE__ */ new Date(),
168
+ traceId: currentTrace?.traceId,
169
+ parentId: currentTrace?.parentId,
170
+ spanId: currentTrace?.spanId,
171
+ context: contextData,
172
+ metadata,
173
+ error,
174
+ tags: currentTrace?.tags
175
+ };
176
+ if (currentTrace?.metadata?.duration) entry.duration = currentTrace.metadata.duration;
177
+ const formatted = this.formatter.format(entry);
178
+ this.output(formatted, level);
179
+ }
180
+ getHttpLogLevel(statusCode) {
181
+ if (!statusCode) return LogLevel.INFO;
182
+ if (statusCode >= 500) return LogLevel.ERROR;
183
+ if (statusCode >= 400) return LogLevel.WARN;
184
+ return LogLevel.INFO;
185
+ }
186
+ };
187
+
188
+ //#endregion
189
+ export { Logger };
@@ -0,0 +1,126 @@
1
+ //#region ../../libs/logger/dist/timer.mjs
2
+ var Timer = class {
3
+ id;
4
+ startTime;
5
+ laps = [];
6
+ stopped = false;
7
+ stopTime;
8
+ constructor(id) {
9
+ this.id = id || crypto.randomUUID();
10
+ this.startTime = performance.now();
11
+ }
12
+ /**
13
+ * Stop the timer and return elapsed time in milliseconds
14
+ */
15
+ stop() {
16
+ if (this.stopped) return this.getElapsed();
17
+ this.stopTime = performance.now();
18
+ this.stopped = true;
19
+ const elapsed = this.stopTime - this.startTime;
20
+ this.laps.push({
21
+ label: "stop",
22
+ time: this.stopTime,
23
+ elapsed
24
+ });
25
+ return elapsed;
26
+ }
27
+ /**
28
+ * Record a lap time and return elapsed time since start
29
+ */
30
+ lap(label) {
31
+ if (this.stopped) return this.getElapsed();
32
+ const now = performance.now();
33
+ const elapsed = now - this.startTime;
34
+ this.laps.push({
35
+ label: label || `lap-${this.laps.length + 1}`,
36
+ time: now,
37
+ elapsed
38
+ });
39
+ return elapsed;
40
+ }
41
+ /**
42
+ * Get elapsed time without stopping the timer
43
+ */
44
+ getElapsed() {
45
+ if (this.stopped && this.stopTime) return this.stopTime - this.startTime;
46
+ return performance.now() - this.startTime;
47
+ }
48
+ /**
49
+ * Get all recorded laps
50
+ */
51
+ getLaps() {
52
+ return [...this.laps];
53
+ }
54
+ /**
55
+ * Get timer summary with total time and laps
56
+ */
57
+ getSummary() {
58
+ return {
59
+ id: this.id,
60
+ totalTime: this.getElapsed(),
61
+ isRunning: !this.stopped,
62
+ laps: this.getLaps()
63
+ };
64
+ }
65
+ /**
66
+ * Reset the timer (starts a new timing session)
67
+ */
68
+ reset() {
69
+ this.startTime = performance.now();
70
+ this.laps = [];
71
+ this.stopped = false;
72
+ this.stopTime = void 0;
73
+ }
74
+ };
75
+ /**
76
+ * Utility class for managing multiple timers
77
+ */
78
+ var TimerManager = class {
79
+ timers = /* @__PURE__ */ new Map();
80
+ /**
81
+ * Start a new timer
82
+ */
83
+ start(id) {
84
+ const timer = new Timer(id);
85
+ this.timers.set(timer.id, timer);
86
+ return timer;
87
+ }
88
+ /**
89
+ * Get an existing timer
90
+ */
91
+ get(id) {
92
+ return this.timers.get(id);
93
+ }
94
+ /**
95
+ * Stop and remove a timer
96
+ */
97
+ stop(id) {
98
+ const timer = this.timers.get(id);
99
+ if (timer) {
100
+ const elapsed = timer.stop();
101
+ this.timers.delete(id);
102
+ return elapsed;
103
+ }
104
+ }
105
+ /**
106
+ * Get all active timers
107
+ */
108
+ getActive() {
109
+ return Array.from(this.timers.values()).filter((timer) => !timer.getSummary().isRunning === false);
110
+ }
111
+ /**
112
+ * Clear all timers
113
+ */
114
+ clear() {
115
+ this.timers.clear();
116
+ }
117
+ /**
118
+ * Get summary of all timers
119
+ */
120
+ getSummary() {
121
+ return Array.from(this.timers.values()).map((timer) => timer.getSummary());
122
+ }
123
+ };
124
+
125
+ //#endregion
126
+ export { Timer, TimerManager };
@@ -0,0 +1,115 @@
1
+ import { LogContext } from "./context.node.js";
2
+ import { Timer } from "./timer.js";
3
+
4
+ //#region ../../libs/logger/dist/tracer.node.mjs
5
+ var Tracer = class {
6
+ context;
7
+ activeSpans = /* @__PURE__ */ new Map();
8
+ constructor() {
9
+ this.context = LogContext.getInstance();
10
+ }
11
+ /**
12
+ * Start a new trace span
13
+ */
14
+ startSpan(options) {
15
+ const parentTrace = this.context.getCurrentTrace();
16
+ const span = {
17
+ traceId: parentTrace?.traceId || this.generateTraceId(),
18
+ parentId: parentTrace?.spanId,
19
+ spanId: this.generateSpanId(),
20
+ operationType: options.operationType,
21
+ operationName: options.operationName,
22
+ startTime: performance.now(),
23
+ metadata: { ...options.metadata },
24
+ tags: [...options.tags || []]
25
+ };
26
+ this.activeSpans.set(span.spanId, span);
27
+ this.context.setTrace(span);
28
+ return span;
29
+ }
30
+ /**
31
+ * Finish a trace span
32
+ */
33
+ finishSpan(spanId) {
34
+ const span = this.activeSpans.get(spanId);
35
+ if (!span) return;
36
+ const duration = performance.now() - span.startTime;
37
+ this.activeSpans.delete(spanId);
38
+ if (this.context.getCurrentTrace()?.spanId === spanId && span.parentId) {
39
+ const parentSpan = this.findSpanById(span.parentId);
40
+ if (parentSpan) this.context.setTrace(parentSpan);
41
+ }
42
+ return duration;
43
+ }
44
+ /**
45
+ * Execute a function within a trace span
46
+ */
47
+ async trace(options, fn) {
48
+ const span = this.startSpan(options);
49
+ const timer = options.autoTiming !== false ? new Timer(`trace-${span.spanId}`) : void 0;
50
+ try {
51
+ const result = await fn();
52
+ const duration = this.finishSpan(span.spanId);
53
+ if (timer) timer.stop();
54
+ if (duration !== void 0) span.metadata.duration = duration;
55
+ return result;
56
+ } catch (error) {
57
+ span.metadata.error = {
58
+ name: error.name || "Unknown",
59
+ message: error.message || "Unknown error",
60
+ stack: error.stack
61
+ };
62
+ const duration = this.finishSpan(span.spanId);
63
+ span.metadata.duration = duration;
64
+ if (timer) timer.stop();
65
+ throw error;
66
+ }
67
+ }
68
+ /**
69
+ * Add metadata to current span
70
+ */
71
+ addMetadata(key, value) {
72
+ const currentTrace = this.context.getCurrentTrace();
73
+ if (currentTrace) currentTrace.metadata[key] = value;
74
+ }
75
+ /**
76
+ * Add tags to current span
77
+ */
78
+ addTags(...tags) {
79
+ const currentTrace = this.context.getCurrentTrace();
80
+ if (currentTrace) currentTrace.tags.push(...tags);
81
+ }
82
+ /**
83
+ * Get current trace context
84
+ */
85
+ getCurrentTrace() {
86
+ return this.context.getCurrentTrace();
87
+ }
88
+ /**
89
+ * Get all active spans
90
+ */
91
+ getActiveSpans() {
92
+ return Array.from(this.activeSpans.values());
93
+ }
94
+ /**
95
+ * Find a span by ID
96
+ */
97
+ findSpanById(spanId) {
98
+ return this.activeSpans.get(spanId);
99
+ }
100
+ /**
101
+ * Generate a unique trace ID
102
+ */
103
+ generateTraceId() {
104
+ return crypto.randomUUID().replace(/-/g, "");
105
+ }
106
+ /**
107
+ * Generate a unique span ID
108
+ */
109
+ generateSpanId() {
110
+ return crypto.randomUUID().replace(/-/g, "").substring(0, 16);
111
+ }
112
+ };
113
+
114
+ //#endregion
115
+ export { Tracer };
@@ -0,0 +1,13 @@
1
+ //#region ../../libs/logger/dist/types.mjs
2
+ let LogLevel = /* @__PURE__ */ function(LogLevel$1) {
3
+ LogLevel$1[LogLevel$1["TRACE"] = 0] = "TRACE";
4
+ LogLevel$1[LogLevel$1["DEBUG"] = 1] = "DEBUG";
5
+ LogLevel$1[LogLevel$1["INFO"] = 2] = "INFO";
6
+ LogLevel$1[LogLevel$1["WARN"] = 3] = "WARN";
7
+ LogLevel$1[LogLevel$1["ERROR"] = 4] = "ERROR";
8
+ LogLevel$1[LogLevel$1["FATAL"] = 5] = "FATAL";
9
+ return LogLevel$1;
10
+ }({});
11
+
12
+ //#endregion
13
+ export { LogLevel };
@@ -0,0 +1,6 @@
1
+ import { defineOverlay } from "./spec.js";
2
+ import { canonicalizeOverlay, signOverlay } from "./signer.js";
3
+ import { defaultOverlayValidator, validateOverlaySpec } from "./validator.js";
4
+ import { OverlayRegistry } from "./registry.js";
5
+ import { applyOverlayModifications } from "./merger.js";
6
+ import { OverlayEngine } from "./runtime.js";