@lssm/example.personalization 0.0.0-canary-20251217080011 → 1.41.0

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 (70) hide show
  1. package/.turbo/turbo-build.log +18 -20
  2. package/dist/behavior-tracking.js +1 -49
  3. package/dist/docs/index.js +1 -1
  4. package/dist/docs/personalization.docblock.js +8 -29
  5. package/dist/example.js +1 -38
  6. package/dist/index.js +1 -7
  7. package/dist/overlay-customization.js +1 -53
  8. package/dist/workflow-extension.js +1 -67
  9. package/package.json +15 -18
  10. package/tsconfig.tsbuildinfo +1 -1
  11. package/.turbo/turbo-build$colon$bundle.log +0 -96
  12. package/CHANGELOG.md +0 -17
  13. package/dist/behavior-tracking.d.ts +0 -4
  14. package/dist/docs/index.d.ts +0 -1
  15. package/dist/docs/personalization.docblock.d.ts +0 -1
  16. package/dist/example.d.ts +0 -33
  17. package/dist/index.d.ts +0 -5
  18. package/dist/libs/contracts/dist/docs/PUBLISHING.docblock.js +0 -16
  19. package/dist/libs/contracts/dist/docs/accessibility_wcag_compliance_specs.docblock.js +0 -16
  20. package/dist/libs/contracts/dist/docs/index.js +0 -29
  21. package/dist/libs/contracts/dist/docs/presentations.js +0 -71
  22. package/dist/libs/contracts/dist/docs/registry.js +0 -44
  23. package/dist/libs/contracts/dist/docs/tech/PHASE_1_QUICKSTART.docblock.js +0 -16
  24. package/dist/libs/contracts/dist/docs/tech/PHASE_2_AI_NATIVE_OPERATIONS.docblock.js +0 -16
  25. package/dist/libs/contracts/dist/docs/tech/PHASE_3_AUTO_EVOLUTION.docblock.js +0 -16
  26. package/dist/libs/contracts/dist/docs/tech/PHASE_4_PERSONALIZATION_ENGINE.docblock.js +0 -16
  27. package/dist/libs/contracts/dist/docs/tech/PHASE_5_ZERO_TOUCH_OPERATIONS.docblock.js +0 -16
  28. package/dist/libs/contracts/dist/docs/tech/auth/better-auth-nextjs.docblock.js +0 -80
  29. package/dist/libs/contracts/dist/docs/tech/contracts/openapi-export.docblock.js +0 -57
  30. package/dist/libs/contracts/dist/docs/tech/lifecycle-stage-system.docblock.js +0 -16
  31. package/dist/libs/contracts/dist/docs/tech/llm/llm-integration.docblock.js +0 -357
  32. package/dist/libs/contracts/dist/docs/tech/mcp-endpoints.docblock.js +0 -37
  33. package/dist/libs/contracts/dist/docs/tech/presentation-runtime.docblock.js +0 -16
  34. package/dist/libs/contracts/dist/docs/tech/schema/README.docblock.js +0 -20
  35. package/dist/libs/contracts/dist/docs/tech/studio/learning-events.docblock.js +0 -48
  36. package/dist/libs/contracts/dist/docs/tech/studio/learning-journeys.docblock.js +0 -79
  37. package/dist/libs/contracts/dist/docs/tech/studio/platform-admin-panel.docblock.js +0 -84
  38. package/dist/libs/contracts/dist/docs/tech/studio/project-access-teams.docblock.js +0 -45
  39. package/dist/libs/contracts/dist/docs/tech/studio/project-routing.docblock.js +0 -67
  40. package/dist/libs/contracts/dist/docs/tech/studio/sandbox-unlogged.docblock.js +0 -40
  41. package/dist/libs/contracts/dist/docs/tech/studio/team-invitations.docblock.js +0 -69
  42. package/dist/libs/contracts/dist/docs/tech/studio/workspace-ops.docblock.js +0 -47
  43. package/dist/libs/contracts/dist/docs/tech/studio/workspaces.docblock.js +0 -62
  44. package/dist/libs/contracts/dist/docs/tech/telemetry-ingest.docblock.js +0 -155
  45. package/dist/libs/contracts/dist/docs/tech/templates/runtime.docblock.js +0 -20
  46. package/dist/libs/contracts/dist/docs/tech/vscode-extension.docblock.js +0 -101
  47. package/dist/libs/contracts/dist/docs/tech/workflows/overview.docblock.js +0 -20
  48. package/dist/libs/logger/dist/context.node.js +0 -78
  49. package/dist/libs/logger/dist/elysia-plugin.js +0 -3
  50. package/dist/libs/logger/dist/formatters.js +0 -163
  51. package/dist/libs/logger/dist/index.js +0 -7
  52. package/dist/libs/logger/dist/logger.node.js +0 -189
  53. package/dist/libs/logger/dist/timer.js +0 -126
  54. package/dist/libs/logger/dist/tracer.node.js +0 -115
  55. package/dist/libs/logger/dist/types.js +0 -13
  56. package/dist/libs/overlay-engine/dist/index.js +0 -6
  57. package/dist/libs/overlay-engine/dist/merger.js +0 -106
  58. package/dist/libs/overlay-engine/dist/registry.js +0 -106
  59. package/dist/libs/overlay-engine/dist/runtime.js +0 -53
  60. package/dist/libs/overlay-engine/dist/signer.js +0 -45
  61. package/dist/libs/overlay-engine/dist/spec.js +0 -7
  62. package/dist/libs/overlay-engine/dist/validator.js +0 -93
  63. package/dist/libs/personalization/dist/analyzer.js +0 -54
  64. package/dist/libs/personalization/dist/store.js +0 -58
  65. package/dist/libs/personalization/dist/tracker.js +0 -92
  66. package/dist/libs/workflow-composer/dist/composer.js +0 -28
  67. package/dist/libs/workflow-composer/dist/injector.js +0 -72
  68. package/dist/libs/workflow-composer/dist/validator.js +0 -36
  69. package/dist/overlay-customization.d.ts +0 -4
  70. package/dist/workflow-extension.d.ts +0 -7
@@ -1,54 +0,0 @@
1
- //#region ../../libs/personalization/dist/analyzer.js
2
- const DEFAULT_THRESHOLD = 3;
3
- var BehaviorAnalyzer = class {
4
- constructor(store, options = {}) {
5
- this.store = store;
6
- this.options = options;
7
- }
8
- async analyze(params) {
9
- const query = {
10
- tenantId: params.tenantId,
11
- userId: params.userId,
12
- role: params.role
13
- };
14
- if (params.windowMs) query.since = Date.now() - params.windowMs;
15
- return buildInsights(await this.store.summarize(query), this.options);
16
- }
17
- };
18
- function buildInsights(summary, options) {
19
- const threshold = options.fieldInactivityThreshold ?? DEFAULT_THRESHOLD;
20
- const minSamples = options.minSamples ?? 10;
21
- const ignoredFields = [];
22
- const frequentlyUsedFields = [];
23
- for (const [field, count] of Object.entries(summary.fieldCounts)) {
24
- if (count <= threshold) ignoredFields.push(field);
25
- if (count >= threshold * 4) frequentlyUsedFields.push(field);
26
- }
27
- const workflowBottlenecks = Object.entries(summary.workflowStepCounts).flatMap(([workflow, steps]) => {
28
- const total = Object.values(steps).reduce((acc, value) => acc + value, 0);
29
- if (!total || total < minSamples) return [];
30
- return Object.entries(steps).filter(([, count]) => count / total < .4).map(([step, count]) => ({
31
- workflow,
32
- step,
33
- dropRate: 1 - count / total
34
- }));
35
- });
36
- const layoutPreference = detectLayout(summary);
37
- return {
38
- unusedFields: ignoredFields,
39
- suggestedHiddenFields: ignoredFields.slice(0, 5),
40
- frequentlyUsedFields: frequentlyUsedFields.slice(0, 10),
41
- workflowBottlenecks,
42
- layoutPreference
43
- };
44
- }
45
- function detectLayout(summary) {
46
- const fieldCount = Object.keys(summary.fieldCounts).length;
47
- if (!fieldCount) return;
48
- if (fieldCount >= 15) return "table";
49
- if (fieldCount >= 8) return "grid";
50
- return "form";
51
- }
52
-
53
- //#endregion
54
- export { BehaviorAnalyzer };
@@ -1,58 +0,0 @@
1
- //#region ../../libs/personalization/dist/store.js
2
- var InMemoryBehaviorStore = class {
3
- events = [];
4
- async record(event) {
5
- this.events.push(event);
6
- }
7
- async bulkRecord(events) {
8
- this.events.push(...events);
9
- }
10
- async query(query) {
11
- return filterEvents(this.events, query);
12
- }
13
- async summarize(query) {
14
- const events = await this.query(query);
15
- const summary = {
16
- fieldCounts: {},
17
- featureCounts: {},
18
- workflowStepCounts: {},
19
- totalEvents: events.length
20
- };
21
- events.forEach((event) => {
22
- switch (event.type) {
23
- case "field_access":
24
- summary.fieldCounts[event.field] = (summary.fieldCounts[event.field] ?? 0) + 1;
25
- break;
26
- case "feature_usage":
27
- summary.featureCounts[event.feature] = (summary.featureCounts[event.feature] ?? 0) + 1;
28
- break;
29
- case "workflow_step": {
30
- const workflow = summary.workflowStepCounts[event.workflow] ??= {};
31
- workflow[event.step] = (workflow[event.step] ?? 0) + 1;
32
- break;
33
- }
34
- default: break;
35
- }
36
- });
37
- return summary;
38
- }
39
- async clear() {
40
- this.events = [];
41
- }
42
- };
43
- function filterEvents(events, query) {
44
- return events.filter((event) => {
45
- if (query.tenantId && event.tenantId !== query.tenantId) return false;
46
- if (query.userId && event.userId !== query.userId) return false;
47
- if (query.role && event.role !== query.role) return false;
48
- if (query.since && event.timestamp < query.since) return false;
49
- if (query.until && event.timestamp > query.until) return false;
50
- if (query.operation && event.type === "field_access" && event.operation !== query.operation) return false;
51
- if (query.feature && event.type === "feature_usage" && event.feature !== query.feature) return false;
52
- if (query.workflow && event.type === "workflow_step" && event.workflow !== query.workflow) return false;
53
- return true;
54
- });
55
- }
56
-
57
- //#endregion
58
- export { InMemoryBehaviorStore };
@@ -1,92 +0,0 @@
1
- import { metrics, trace } from "@opentelemetry/api";
2
-
3
- //#region ../../libs/personalization/dist/tracker.js
4
- const DEFAULT_BUFFER_SIZE = 25;
5
- var BehaviorTracker = class {
6
- store;
7
- context;
8
- tracer = trace.getTracer("lssm.personalization", "1.0.0");
9
- counter = metrics.getMeter("lssm.personalization", "1.0.0").createCounter("lssm.personalization.events", { description: "Behavior events tracked for personalization" });
10
- buffer = [];
11
- bufferSize;
12
- flushTimer;
13
- constructor(options) {
14
- this.store = options.store;
15
- this.context = options.context;
16
- this.bufferSize = options.bufferSize ?? DEFAULT_BUFFER_SIZE;
17
- if (options.autoFlushIntervalMs) this.flushTimer = setInterval(() => {
18
- this.flush();
19
- }, options.autoFlushIntervalMs);
20
- }
21
- trackFieldAccess(input) {
22
- const event = {
23
- type: "field_access",
24
- operation: input.operation,
25
- field: input.field,
26
- timestamp: Date.now(),
27
- ...this.context,
28
- metadata: {
29
- ...this.context.metadata,
30
- ...input.metadata
31
- }
32
- };
33
- this.enqueue(event);
34
- }
35
- trackFeatureUsage(input) {
36
- const event = {
37
- type: "feature_usage",
38
- feature: input.feature,
39
- action: input.action,
40
- timestamp: Date.now(),
41
- ...this.context,
42
- metadata: {
43
- ...this.context.metadata,
44
- ...input.metadata
45
- }
46
- };
47
- this.enqueue(event);
48
- }
49
- trackWorkflowStep(input) {
50
- const event = {
51
- type: "workflow_step",
52
- workflow: input.workflow,
53
- step: input.step,
54
- status: input.status,
55
- timestamp: Date.now(),
56
- ...this.context,
57
- metadata: {
58
- ...this.context.metadata,
59
- ...input.metadata
60
- }
61
- };
62
- this.enqueue(event);
63
- }
64
- async flush() {
65
- if (!this.buffer.length) return;
66
- const events = this.buffer;
67
- this.buffer = [];
68
- await this.store.bulkRecord(events);
69
- }
70
- async dispose() {
71
- if (this.flushTimer) clearInterval(this.flushTimer);
72
- await this.flush();
73
- }
74
- enqueue(event) {
75
- this.buffer.push(event);
76
- this.counter.add(1, {
77
- tenantId: this.context.tenantId,
78
- type: event.type
79
- });
80
- this.tracer.startActiveSpan(`personalization.${event.type}`, (span) => {
81
- span.setAttribute("tenant.id", this.context.tenantId);
82
- if (this.context.userId) span.setAttribute("user.id", this.context.userId);
83
- span.setAttribute("personalization.event_type", event.type);
84
- span.end();
85
- });
86
- if (this.buffer.length >= this.bufferSize) this.flush();
87
- }
88
- };
89
- const createBehaviorTracker = (options) => new BehaviorTracker(options);
90
-
91
- //#endregion
92
- export { createBehaviorTracker };
@@ -1,28 +0,0 @@
1
- import { applyWorkflowExtension } from "./injector.js";
2
-
3
- //#region ../../libs/workflow-composer/dist/composer.js
4
- var WorkflowComposer = class {
5
- extensions = [];
6
- register(extension) {
7
- this.extensions.push(extension);
8
- return this;
9
- }
10
- registerMany(extensions) {
11
- extensions.forEach((extension) => this.register(extension));
12
- return this;
13
- }
14
- compose(params) {
15
- return this.extensions.filter((extension) => matches(params, extension)).sort((a, b) => (a.priority ?? 0) - (b.priority ?? 0)).reduce((acc, extension) => applyWorkflowExtension(acc, extension), params.base);
16
- }
17
- };
18
- function matches(params, extension) {
19
- if (extension.workflow !== params.base.meta.name) return false;
20
- if (extension.baseVersion && extension.baseVersion !== params.base.meta.version) return false;
21
- if (extension.tenantId && extension.tenantId !== params.tenantId) return false;
22
- if (extension.role && extension.role !== params.role) return false;
23
- if (extension.device && extension.device !== params.device) return false;
24
- return true;
25
- }
26
-
27
- //#endregion
28
- export { WorkflowComposer };
@@ -1,72 +0,0 @@
1
- import { validateExtension } from "./validator.js";
2
-
3
- //#region ../../libs/workflow-composer/dist/injector.js
4
- function applyWorkflowExtension(base, extension) {
5
- validateExtension(extension, base);
6
- const spec = cloneWorkflowSpec(base);
7
- const steps = [...spec.definition.steps];
8
- let transitions = [...spec.definition.transitions];
9
- const hiddenSet = new Set(extension.hiddenSteps ?? []);
10
- hiddenSet.forEach((stepId) => {
11
- const idx = steps.findIndex((step) => step.id === stepId);
12
- if (idx !== -1) steps.splice(idx, 1);
13
- });
14
- if (hiddenSet.size) transitions = transitions.filter((transition) => !hiddenSet.has(transition.from) && !hiddenSet.has(transition.to));
15
- extension.customSteps?.forEach((injection) => {
16
- insertStep(steps, injection);
17
- wireTransitions(transitions, injection);
18
- });
19
- spec.definition.steps = steps;
20
- spec.definition.transitions = dedupeTransitions(transitions);
21
- spec.meta = {
22
- ...spec.meta,
23
- version: spec.meta.version
24
- };
25
- return spec;
26
- }
27
- function insertStep(steps, injection) {
28
- const anchorIndex = resolveAnchorIndex(steps, injection);
29
- if (anchorIndex === -1) throw new Error(`Unable to place injected step "${injection.inject.id}"`);
30
- steps.splice(anchorIndex, 0, { ...injection.inject });
31
- }
32
- function resolveAnchorIndex(steps, injection) {
33
- if (injection.after) {
34
- const idx = steps.findIndex((step) => step.id === injection.after);
35
- return idx === -1 ? -1 : idx + 1;
36
- }
37
- if (injection.before) {
38
- const idx = steps.findIndex((step) => step.id === injection.before);
39
- return idx === -1 ? -1 : idx;
40
- }
41
- return steps.length;
42
- }
43
- function wireTransitions(transitions, injection) {
44
- if (!injection.inject.id) return;
45
- if (injection.transitionFrom) transitions.push({
46
- from: injection.transitionFrom,
47
- to: injection.inject.id,
48
- condition: injection.when
49
- });
50
- if (injection.transitionTo) transitions.push({
51
- from: injection.inject.id,
52
- to: injection.transitionTo,
53
- condition: injection.when
54
- });
55
- }
56
- function dedupeTransitions(transitions) {
57
- const seen = /* @__PURE__ */ new Set();
58
- const result = [];
59
- transitions.forEach((transition) => {
60
- const key = `${transition.from}->${transition.to}:${transition.condition ?? ""}`;
61
- if (seen.has(key)) return;
62
- seen.add(key);
63
- result.push(transition);
64
- });
65
- return result;
66
- }
67
- function cloneWorkflowSpec(spec) {
68
- return JSON.parse(JSON.stringify(spec));
69
- }
70
-
71
- //#endregion
72
- export { applyWorkflowExtension };
@@ -1,36 +0,0 @@
1
- //#region ../../libs/workflow-composer/dist/validator.js
2
- function validateExtension(extension, base) {
3
- const issues = [];
4
- const stepIds = new Set(base.definition.steps.map((step) => step.id));
5
- extension.customSteps?.forEach((injection, idx) => {
6
- if (!injection.inject.id) issues.push({
7
- code: "workflow.extension.step.id",
8
- message: `customSteps[${idx}] is missing an id`
9
- });
10
- if (!injection.after && !injection.before) issues.push({
11
- code: "workflow.extension.step.anchor",
12
- message: `customSteps[${idx}] must set after or before`
13
- });
14
- if (injection.after && !stepIds.has(injection.after)) issues.push({
15
- code: "workflow.extension.step.after",
16
- message: `customSteps[${idx}] references unknown step "${injection.after}"`
17
- });
18
- if (injection.before && !stepIds.has(injection.before)) issues.push({
19
- code: "workflow.extension.step.before",
20
- message: `customSteps[${idx}] references unknown step "${injection.before}"`
21
- });
22
- });
23
- extension.hiddenSteps?.forEach((stepId) => {
24
- if (!stepIds.has(stepId)) issues.push({
25
- code: "workflow.extension.hidden-step",
26
- message: `hidden step "${stepId}" does not exist`
27
- });
28
- });
29
- if (issues.length) {
30
- const reason = issues.map((issue) => `${issue.code}: ${issue.message}`).join("; ");
31
- throw new Error(`Invalid workflow extension for ${extension.workflow}: ${reason}`);
32
- }
33
- }
34
-
35
- //#endregion
36
- export { validateExtension };
@@ -1,4 +0,0 @@
1
- //#region src/overlay-customization.d.ts
2
- declare function runOverlayCustomizationExample(): Promise<void>;
3
- //#endregion
4
- export { runOverlayCustomizationExample };
@@ -1,7 +0,0 @@
1
- import { WorkflowSpec } from "@lssm/lib.contracts/workflow/spec";
2
-
3
- //#region src/workflow-extension.d.ts
4
- declare function composeTenantWorkflowExample(): WorkflowSpec;
5
- declare function logTenantWorkflowSteps(workflow: WorkflowSpec): void;
6
- //#endregion
7
- export { composeTenantWorkflowExample, logTenantWorkflowSteps };