@contractspec/example.personalization 3.7.16 → 3.7.18

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 (33) hide show
  1. package/.turbo/turbo-build.log +33 -33
  2. package/CHANGELOG.md +29 -0
  3. package/dist/behavior-tracking.js +1 -44
  4. package/dist/browser/behavior-tracking.js +1 -44
  5. package/dist/browser/docs/index.js +2 -33
  6. package/dist/browser/docs/personalization.docblock.js +2 -33
  7. package/dist/browser/example.js +1 -33
  8. package/dist/browser/index.js +2 -365
  9. package/dist/browser/overlay-customization.js +1 -53
  10. package/dist/browser/personalization.experiment.js +1 -62
  11. package/dist/browser/personalization.feature.js +1 -22
  12. package/dist/browser/personalization.theme.js +1 -64
  13. package/dist/browser/workflow-extension.js +1 -60
  14. package/dist/docs/index.js +2 -33
  15. package/dist/docs/personalization.docblock.js +2 -33
  16. package/dist/example.js +1 -33
  17. package/dist/index.js +2 -365
  18. package/dist/node/behavior-tracking.js +1 -44
  19. package/dist/node/docs/index.js +2 -33
  20. package/dist/node/docs/personalization.docblock.js +2 -33
  21. package/dist/node/example.js +1 -33
  22. package/dist/node/index.js +2 -365
  23. package/dist/node/overlay-customization.js +1 -53
  24. package/dist/node/personalization.experiment.js +1 -62
  25. package/dist/node/personalization.feature.js +1 -22
  26. package/dist/node/personalization.theme.js +1 -64
  27. package/dist/node/workflow-extension.js +1 -60
  28. package/dist/overlay-customization.js +1 -53
  29. package/dist/personalization.experiment.js +1 -62
  30. package/dist/personalization.feature.js +1 -22
  31. package/dist/personalization.theme.js +1 -64
  32. package/dist/workflow-extension.js +1 -60
  33. package/package.json +10 -10
@@ -1,16 +1,5 @@
1
1
  // @bun
2
- // src/docs/personalization.docblock.ts
3
- import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
4
- var blocks = [
5
- {
6
- id: "docs.examples.personalization",
7
- title: "Personalization Patterns (example)",
8
- summary: "Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",
9
- kind: "reference",
10
- visibility: "public",
11
- route: "/docs/examples/personalization",
12
- tags: ["personalization", "overlays", "workflows", "example"],
13
- body: `## Includes
2
+ import{registerDocBlocks as m}from"@contractspec/lib.contracts-spec/docs";var f=[{id:"docs.examples.personalization",title:"Personalization Patterns (example)",summary:"Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",kind:"reference",visibility:"public",route:"/docs/examples/personalization",tags:["personalization","overlays","workflows","example"],body:`## Includes
14
3
  - Behavior tracking + insight analysis.
15
4
  - Overlay customization (hide fields, rename labels).
16
5
  - Workflow extension (inject tenant-specific steps).
@@ -18,24 +7,4 @@ var blocks = [
18
7
  ## Guardrails
19
8
  - Keep tracking events structured and non-PII.
20
9
  - Keep overlays signed and scoped.
21
- - Keep workflow composition deterministic.`
22
- },
23
- {
24
- id: "docs.examples.personalization.usage",
25
- title: "Personalization \u2014 Usage",
26
- summary: "How to run the small examples and swap adapters.",
27
- kind: "usage",
28
- visibility: "public",
29
- route: "/docs/examples/personalization/usage",
30
- tags: ["personalization", "usage"],
31
- body: `## Usage
32
- - Call \`runBehaviorTrackingExample()\` for insights.
33
- - Call \`runOverlayCustomizationExample()\` to apply overlays.
34
- - Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
35
-
36
- ## Notes
37
- - Replace in-memory stores with app-layer storage.
38
- - Keep PII out of logs and markdown outputs.`
39
- }
40
- ];
41
- registerDocBlocks(blocks);
10
+ - Keep workflow composition deterministic.`},{id:"docs.examples.personalization.usage",title:"Personalization \u2014 Usage",summary:"How to run the small examples and swap adapters.",kind:"usage",visibility:"public",route:"/docs/examples/personalization/usage",tags:["personalization","usage"],body:"## Usage\n- Call `runBehaviorTrackingExample()` for insights.\n- Call `runOverlayCustomizationExample()` to apply overlays.\n- Call `composeTenantWorkflowExample()` and `logTenantWorkflowSteps()` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs."}];m(f);
@@ -1,16 +1,5 @@
1
1
  // @bun
2
- // src/docs/personalization.docblock.ts
3
- import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
4
- var blocks = [
5
- {
6
- id: "docs.examples.personalization",
7
- title: "Personalization Patterns (example)",
8
- summary: "Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",
9
- kind: "reference",
10
- visibility: "public",
11
- route: "/docs/examples/personalization",
12
- tags: ["personalization", "overlays", "workflows", "example"],
13
- body: `## Includes
2
+ import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.examples.personalization",title:"Personalization Patterns (example)",summary:"Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",kind:"reference",visibility:"public",route:"/docs/examples/personalization",tags:["personalization","overlays","workflows","example"],body:`## Includes
14
3
  - Behavior tracking + insight analysis.
15
4
  - Overlay customization (hide fields, rename labels).
16
5
  - Workflow extension (inject tenant-specific steps).
@@ -18,24 +7,4 @@ var blocks = [
18
7
  ## Guardrails
19
8
  - Keep tracking events structured and non-PII.
20
9
  - Keep overlays signed and scoped.
21
- - Keep workflow composition deterministic.`
22
- },
23
- {
24
- id: "docs.examples.personalization.usage",
25
- title: "Personalization \u2014 Usage",
26
- summary: "How to run the small examples and swap adapters.",
27
- kind: "usage",
28
- visibility: "public",
29
- route: "/docs/examples/personalization/usage",
30
- tags: ["personalization", "usage"],
31
- body: `## Usage
32
- - Call \`runBehaviorTrackingExample()\` for insights.
33
- - Call \`runOverlayCustomizationExample()\` to apply overlays.
34
- - Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
35
-
36
- ## Notes
37
- - Replace in-memory stores with app-layer storage.
38
- - Keep PII out of logs and markdown outputs.`
39
- }
40
- ];
41
- registerDocBlocks(blocks);
10
+ - Keep workflow composition deterministic.`},{id:"docs.examples.personalization.usage",title:"Personalization \u2014 Usage",summary:"How to run the small examples and swap adapters.",kind:"usage",visibility:"public",route:"/docs/examples/personalization/usage",tags:["personalization","usage"],body:"## Usage\n- Call `runBehaviorTrackingExample()` for insights.\n- Call `runOverlayCustomizationExample()` to apply overlays.\n- Call `composeTenantWorkflowExample()` and `logTenantWorkflowSteps()` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs."}];f(h);
package/dist/example.js CHANGED
@@ -1,34 +1,2 @@
1
1
  // @bun
2
- // src/example.ts
3
- import { defineExample } from "@contractspec/lib.contracts-spec";
4
- var example = defineExample({
5
- meta: {
6
- key: "personalization",
7
- version: "1.0.0",
8
- title: "Personalization Patterns",
9
- description: "Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.",
10
- kind: "library",
11
- visibility: "public",
12
- stability: "experimental",
13
- owners: ["@platform.core"],
14
- tags: ["personalization", "overlays", "behavior", "workflows"]
15
- },
16
- docs: {
17
- rootDocId: "docs.examples.personalization",
18
- usageDocId: "docs.examples.personalization.usage"
19
- },
20
- entrypoints: {
21
- packageName: "@contractspec/example.personalization",
22
- docs: "./docs"
23
- },
24
- surfaces: {
25
- templates: true,
26
- sandbox: { enabled: true, modes: ["markdown", "specs"] },
27
- studio: { enabled: true, installable: true },
28
- mcp: { enabled: true }
29
- }
30
- });
31
- var example_default = example;
32
- export {
33
- example_default as default
34
- };
2
+ import{defineExample as g}from"@contractspec/lib.contracts-spec";var h=g({meta:{key:"personalization",version:"1.0.0",title:"Personalization Patterns",description:"Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.",kind:"library",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["personalization","overlays","behavior","workflows"]},docs:{rootDocId:"docs.examples.personalization",usageDocId:"docs.examples.personalization.usage"},entrypoints:{packageName:"@contractspec/example.personalization",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["markdown","specs"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),q=h;export{q as default};
package/dist/index.js CHANGED
@@ -1,58 +1,5 @@
1
1
  // @bun
2
- // src/behavior-tracking.ts
3
- import { Logger, LogLevel } from "@contractspec/lib.logger";
4
- import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
5
- import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
6
- import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
7
- var logger = new Logger({
8
- level: LogLevel.INFO,
9
- environment: "production",
10
- enableColors: false
11
- });
12
- async function runBehaviorTrackingExample() {
13
- const store = new InMemoryBehaviorStore;
14
- const tracker = createBehaviorTracker({
15
- store,
16
- context: {
17
- tenantId: "acme",
18
- userId: "user-123"
19
- }
20
- });
21
- tracker.trackFieldAccess({
22
- operation: "billing.createOrder",
23
- field: "internalNotes"
24
- });
25
- tracker.trackFieldAccess({
26
- operation: "billing.createOrder",
27
- field: "customerReference"
28
- });
29
- tracker.trackFeatureUsage({ feature: "workflow-editor", action: "opened" });
30
- tracker.trackWorkflowStep({
31
- workflow: "invoice-approval",
32
- step: "review",
33
- status: "entered"
34
- });
35
- await tracker.flush();
36
- const analyzer = new BehaviorAnalyzer(store);
37
- const insights = await analyzer.analyze({
38
- tenantId: "acme",
39
- userId: "user-123"
40
- });
41
- logger.info("Behavior insights computed", { insights });
42
- }
43
-
44
- // src/docs/personalization.docblock.ts
45
- import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
46
- var blocks = [
47
- {
48
- id: "docs.examples.personalization",
49
- title: "Personalization Patterns (example)",
50
- summary: "Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",
51
- kind: "reference",
52
- visibility: "public",
53
- route: "/docs/examples/personalization",
54
- tags: ["personalization", "overlays", "workflows", "example"],
55
- body: `## Includes
2
+ import{Logger as J,LogLevel as K}from"@contractspec/lib.logger";import{BehaviorAnalyzer as N}from"@contractspec/lib.personalization/analyzer";import{InMemoryBehaviorStore as P}from"@contractspec/lib.personalization/store";import{createBehaviorTracker as Q}from"@contractspec/lib.personalization/tracker";var U=new J({level:K.INFO,environment:"production",enableColors:!1});async function v(){let x=new P,j=Q({store:x,context:{tenantId:"acme",userId:"user-123"}});j.trackFieldAccess({operation:"billing.createOrder",field:"internalNotes"}),j.trackFieldAccess({operation:"billing.createOrder",field:"customerReference"}),j.trackFeatureUsage({feature:"workflow-editor",action:"opened"}),j.trackWorkflowStep({workflow:"invoice-approval",step:"review",status:"entered"}),await j.flush();let q=await new N(x).analyze({tenantId:"acme",userId:"user-123"});U.info("Behavior insights computed",{insights:q})}import{registerDocBlocks as V}from"@contractspec/lib.contracts-spec/docs";var X=[{id:"docs.examples.personalization",title:"Personalization Patterns (example)",summary:"Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",kind:"reference",visibility:"public",route:"/docs/examples/personalization",tags:["personalization","overlays","workflows","example"],body:`## Includes
56
3
  - Behavior tracking + insight analysis.
57
4
  - Overlay customization (hide fields, rename labels).
58
5
  - Workflow extension (inject tenant-specific steps).
@@ -60,314 +7,4 @@ var blocks = [
60
7
  ## Guardrails
61
8
  - Keep tracking events structured and non-PII.
62
9
  - Keep overlays signed and scoped.
63
- - Keep workflow composition deterministic.`
64
- },
65
- {
66
- id: "docs.examples.personalization.usage",
67
- title: "Personalization \u2014 Usage",
68
- summary: "How to run the small examples and swap adapters.",
69
- kind: "usage",
70
- visibility: "public",
71
- route: "/docs/examples/personalization/usage",
72
- tags: ["personalization", "usage"],
73
- body: `## Usage
74
- - Call \`runBehaviorTrackingExample()\` for insights.
75
- - Call \`runOverlayCustomizationExample()\` to apply overlays.
76
- - Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
77
-
78
- ## Notes
79
- - Replace in-memory stores with app-layer storage.
80
- - Keep PII out of logs and markdown outputs.`
81
- }
82
- ];
83
- registerDocBlocks(blocks);
84
- // src/example.ts
85
- import { defineExample } from "@contractspec/lib.contracts-spec";
86
- var example = defineExample({
87
- meta: {
88
- key: "personalization",
89
- version: "1.0.0",
90
- title: "Personalization Patterns",
91
- description: "Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.",
92
- kind: "library",
93
- visibility: "public",
94
- stability: "experimental",
95
- owners: ["@platform.core"],
96
- tags: ["personalization", "overlays", "behavior", "workflows"]
97
- },
98
- docs: {
99
- rootDocId: "docs.examples.personalization",
100
- usageDocId: "docs.examples.personalization.usage"
101
- },
102
- entrypoints: {
103
- packageName: "@contractspec/example.personalization",
104
- docs: "./docs"
105
- },
106
- surfaces: {
107
- templates: true,
108
- sandbox: { enabled: true, modes: ["markdown", "specs"] },
109
- studio: { enabled: true, installable: true },
110
- mcp: { enabled: true }
111
- }
112
- });
113
- var example_default = example;
114
-
115
- // src/overlay-customization.ts
116
- import { Logger as Logger2, LogLevel as LogLevel2 } from "@contractspec/lib.logger";
117
- import {
118
- OverlayEngine,
119
- OverlayRegistry
120
- } from "@contractspec/lib.overlay-engine";
121
- import { signOverlay } from "@contractspec/lib.overlay-engine/signer";
122
- import { defineOverlay } from "@contractspec/lib.overlay-engine/spec";
123
- var logger2 = new Logger2({
124
- level: LogLevel2.INFO,
125
- environment: "production",
126
- enableColors: false
127
- });
128
- async function runOverlayCustomizationExample() {
129
- const registry = new OverlayRegistry({ allowUnsigned: true });
130
- const engine = new OverlayEngine({ registry });
131
- const overlay = defineOverlay({
132
- overlayId: "demo-overlay",
133
- version: "1.0.0",
134
- appliesTo: {
135
- capability: "billing.createOrder",
136
- tenantId: "demo"
137
- },
138
- modifications: [
139
- { type: "hideField", field: "internalNotes" },
140
- {
141
- type: "renameLabel",
142
- field: "customerReference",
143
- newLabel: "PO Number"
144
- }
145
- ]
146
- });
147
- const signed = await signOverlay(overlay, process.env.PRIVATE_KEY_PEM ?? "");
148
- registry.register(signed);
149
- const result = engine.apply({
150
- target: {
151
- fields: [
152
- {
153
- key: "customerReference",
154
- label: "Customer Reference",
155
- visible: true
156
- },
157
- { key: "internalNotes", label: "Internal Notes", visible: true }
158
- ]
159
- },
160
- capability: "billing.createOrder",
161
- tenantId: "demo"
162
- });
163
- logger2.info("Overlay applied", { fields: result.target.fields });
164
- }
165
-
166
- // src/personalization.experiment.ts
167
- import {
168
- OwnersEnum,
169
- StabilityEnum
170
- } from "@contractspec/lib.contracts-spec/ownership";
171
- var PersonalizationExperiment = {
172
- meta: {
173
- key: "personalization.experiment.overlay-copy",
174
- version: "1.0.0",
175
- title: "Personalization Overlay Copy Experiment",
176
- description: "Tests a control onboarding copy against a personalized overlay variant.",
177
- domain: "personalization",
178
- owners: [OwnersEnum.PlatformCore],
179
- tags: ["personalization", "experiment", "overlay"],
180
- stability: StabilityEnum.Experimental
181
- },
182
- controlVariant: "control",
183
- variants: [
184
- {
185
- id: "control",
186
- key: "control",
187
- description: "Default onboarding copy and standard workflow."
188
- },
189
- {
190
- id: "personalized-overlay",
191
- key: "personalized-overlay",
192
- description: "Personalized copy with a branded theme override.",
193
- overrides: [
194
- {
195
- type: "theme",
196
- target: "personalization.theme.guided-onboarding",
197
- version: "1.0.0"
198
- },
199
- {
200
- type: "workflow",
201
- target: "billing.invoiceApproval",
202
- version: "1.0.0"
203
- }
204
- ]
205
- }
206
- ],
207
- allocation: {
208
- type: "sticky",
209
- attribute: "userId",
210
- salt: "personalization-overlay-copy"
211
- },
212
- successMetrics: [
213
- {
214
- key: "checklist-completion-rate",
215
- telemetryEvent: {
216
- key: "personalization.assignment.completed",
217
- version: "1.0.0"
218
- },
219
- aggregation: "count",
220
- target: 1
221
- }
222
- ],
223
- tags: ["personalization", "experiment"]
224
- };
225
-
226
- // src/personalization.feature.ts
227
- import { defineFeature } from "@contractspec/lib.contracts-spec";
228
- var PersonalizationFeature = defineFeature({
229
- meta: {
230
- key: "personalization",
231
- version: "1.0.0",
232
- title: "Personalization Patterns",
233
- description: "Behavior tracking, overlay customization, and workflow extension patterns",
234
- domain: "personalization",
235
- owners: ["@examples"],
236
- tags: ["personalization", "behavior", "overlay", "workflow"],
237
- stability: "experimental"
238
- },
239
- telemetry: [{ key: "personalization.telemetry", version: "1.0.0" }],
240
- docs: [
241
- "docs.examples.personalization",
242
- "docs.examples.personalization.usage"
243
- ]
244
- });
245
-
246
- // src/personalization.theme.ts
247
- import {
248
- OwnersEnum as OwnersEnum2,
249
- StabilityEnum as StabilityEnum2
250
- } from "@contractspec/lib.contracts-spec/ownership";
251
- var PersonalizationTheme = {
252
- meta: {
253
- key: "personalization.theme.guided-onboarding",
254
- version: "1.0.0",
255
- title: "Guided Onboarding Theme",
256
- description: "Theme tokens used when the personalized onboarding experience is active.",
257
- domain: "personalization",
258
- owners: [OwnersEnum2.PlatformCore],
259
- tags: ["personalization", "theme", "onboarding"],
260
- stability: StabilityEnum2.Experimental,
261
- scopes: ["tenant", "user"]
262
- },
263
- tokens: {
264
- colors: {
265
- surface: { value: "#FCF6E8" },
266
- accent: { value: "#C8742A" },
267
- text: { value: "#2F2419" }
268
- },
269
- radii: {
270
- card: { value: 18 }
271
- },
272
- space: {
273
- panel: { value: 24 }
274
- },
275
- typography: {
276
- body: { value: 16 },
277
- title: { value: 28 }
278
- },
279
- motion: {
280
- stagger: { value: "180ms" }
281
- }
282
- },
283
- components: [
284
- {
285
- component: "OnboardingChecklist",
286
- variants: {
287
- guided: {
288
- props: {
289
- emphasis: "warm"
290
- }
291
- }
292
- }
293
- }
294
- ],
295
- overrides: [
296
- {
297
- scope: "tenant",
298
- target: "tenant:acme",
299
- tokens: {
300
- colors: {
301
- accent: { value: "#8A4B12" }
302
- }
303
- }
304
- }
305
- ]
306
- };
307
-
308
- // src/workflow-extension.ts
309
- import { StabilityEnum as StabilityEnum3 } from "@contractspec/lib.contracts-spec";
310
- import { Logger as Logger3, LogLevel as LogLevel3 } from "@contractspec/lib.logger";
311
- import { WorkflowComposer } from "@contractspec/lib.workflow-composer";
312
- var logger3 = new Logger3({
313
- level: LogLevel3.INFO,
314
- environment: "production",
315
- enableColors: false
316
- });
317
- var BaseWorkflow = {
318
- meta: {
319
- key: "billing.invoiceApproval",
320
- version: "1.0.0",
321
- title: "Invoice Approval",
322
- owners: [],
323
- tags: [],
324
- description: "",
325
- domain: "billing",
326
- stability: StabilityEnum3.Stable
327
- },
328
- definition: {
329
- steps: [
330
- { id: "validate-invoice", type: "automation", label: "Validate Invoice" },
331
- { id: "final-approval", type: "human", label: "Final Approval" }
332
- ],
333
- transitions: [{ from: "validate-invoice", to: "final-approval" }]
334
- }
335
- };
336
- function composeTenantWorkflowExample() {
337
- const composer = new WorkflowComposer;
338
- composer.register({
339
- workflow: "billing.invoiceApproval",
340
- tenantId: "acme",
341
- customSteps: [
342
- {
343
- after: "validate-invoice",
344
- inject: {
345
- id: "acme-legal",
346
- type: "human",
347
- label: "ACME Legal Review"
348
- },
349
- transitionTo: "final-approval"
350
- }
351
- ]
352
- });
353
- return composer.compose({
354
- base: BaseWorkflow,
355
- tenantId: "acme"
356
- });
357
- }
358
- function logTenantWorkflowSteps(workflow) {
359
- logger3.info("Tenant workflow composed", {
360
- workflow: workflow.meta.key,
361
- steps: workflow.definition.steps.map((step) => step.id)
362
- });
363
- }
364
- export {
365
- runOverlayCustomizationExample,
366
- runBehaviorTrackingExample,
367
- logTenantWorkflowSteps,
368
- example_default as example,
369
- composeTenantWorkflowExample,
370
- PersonalizationTheme,
371
- PersonalizationFeature,
372
- PersonalizationExperiment
373
- };
10
+ - Keep workflow composition deterministic.`},{id:"docs.examples.personalization.usage",title:"Personalization \u2014 Usage",summary:"How to run the small examples and swap adapters.",kind:"usage",visibility:"public",route:"/docs/examples/personalization/usage",tags:["personalization","usage"],body:"## Usage\n- Call `runBehaviorTrackingExample()` for insights.\n- Call `runOverlayCustomizationExample()` to apply overlays.\n- Call `composeTenantWorkflowExample()` and `logTenantWorkflowSteps()` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs."}];V(X);import{defineExample as Y}from"@contractspec/lib.contracts-spec";var Z=Y({meta:{key:"personalization",version:"1.0.0",title:"Personalization Patterns",description:"Small examples for behavior tracking, overlay-based UI customization, and tenant workflow extension.",kind:"library",visibility:"public",stability:"experimental",owners:["@platform.core"],tags:["personalization","overlays","behavior","workflows"]},docs:{rootDocId:"docs.examples.personalization",usageDocId:"docs.examples.personalization.usage"},entrypoints:{packageName:"@contractspec/example.personalization",docs:"./docs"},surfaces:{templates:!0,sandbox:{enabled:!0,modes:["markdown","specs"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),_=Z;import{Logger as $,LogLevel as A}from"@contractspec/lib.logger";import{OverlayEngine as C,OverlayRegistry as D}from"@contractspec/lib.overlay-engine";import{signOverlay as F}from"@contractspec/lib.overlay-engine/signer";import{defineOverlay as I}from"@contractspec/lib.overlay-engine/spec";var M=new $({level:A.INFO,environment:"production",enableColors:!1});async function t(){let x=new D({allowUnsigned:!0}),j=new C({registry:x}),G=I({overlayId:"demo-overlay",version:"1.0.0",appliesTo:{capability:"billing.createOrder",tenantId:"demo"},modifications:[{type:"hideField",field:"internalNotes"},{type:"renameLabel",field:"customerReference",newLabel:"PO Number"}]}),q=await F(G,process.env.PRIVATE_KEY_PEM??"");x.register(q);let H=j.apply({target:{fields:[{key:"customerReference",label:"Customer Reference",visible:!0},{key:"internalNotes",label:"Internal Notes",visible:!0}]},capability:"billing.createOrder",tenantId:"demo"});M.info("Overlay applied",{fields:H.target.fields})}import{OwnersEnum as R,StabilityEnum as T}from"@contractspec/lib.contracts-spec/ownership";var c={meta:{key:"personalization.experiment.overlay-copy",version:"1.0.0",title:"Personalization Overlay Copy Experiment",description:"Tests a control onboarding copy against a personalized overlay variant.",domain:"personalization",owners:[R.PlatformCore],tags:["personalization","experiment","overlay"],stability:T.Experimental},controlVariant:"control",variants:[{id:"control",key:"control",description:"Default onboarding copy and standard workflow."},{id:"personalized-overlay",key:"personalized-overlay",description:"Personalized copy with a branded theme override.",overrides:[{type:"theme",target:"personalization.theme.guided-onboarding",version:"1.0.0"},{type:"workflow",target:"billing.invoiceApproval",version:"1.0.0"}]}],allocation:{type:"sticky",attribute:"userId",salt:"personalization-overlay-copy"},successMetrics:[{key:"checklist-completion-rate",telemetryEvent:{key:"personalization.assignment.completed",version:"1.0.0"},aggregation:"count",target:1}],tags:["personalization","experiment"]};import{defineFeature as f}from"@contractspec/lib.contracts-spec";var xx=f({meta:{key:"personalization",version:"1.0.0",title:"Personalization Patterns",description:"Behavior tracking, overlay customization, and workflow extension patterns",domain:"personalization",owners:["@examples"],tags:["personalization","behavior","overlay","workflow"],stability:"experimental"},telemetry:[{key:"personalization.telemetry",version:"1.0.0"}],docs:["docs.examples.personalization","docs.examples.personalization.usage"]});import{OwnersEnum as m,StabilityEnum as z}from"@contractspec/lib.contracts-spec/ownership";var Gx={meta:{key:"personalization.theme.guided-onboarding",version:"1.0.0",title:"Guided Onboarding Theme",description:"Theme tokens used when the personalized onboarding experience is active.",domain:"personalization",owners:[m.PlatformCore],tags:["personalization","theme","onboarding"],stability:z.Experimental,scopes:["tenant","user"]},tokens:{colors:{surface:{value:"#FCF6E8"},accent:{value:"#C8742A"},text:{value:"#2F2419"}},radii:{card:{value:18}},space:{panel:{value:24}},typography:{body:{value:16},title:{value:28}},motion:{stagger:{value:"180ms"}}},components:[{component:"OnboardingChecklist",variants:{guided:{props:{emphasis:"warm"}}}}],overrides:[{scope:"tenant",target:"tenant:acme",tokens:{colors:{accent:{value:"#8A4B12"}}}}]};import{StabilityEnum as W}from"@contractspec/lib.contracts-spec";import{Logger as d,LogLevel as S}from"@contractspec/lib.logger";import{WorkflowComposer as B}from"@contractspec/lib.workflow-composer";var h=new d({level:S.INFO,environment:"production",enableColors:!1}),u={meta:{key:"billing.invoiceApproval",version:"1.0.0",title:"Invoice Approval",owners:[],tags:[],description:"",domain:"billing",stability:W.Stable},definition:{steps:[{id:"validate-invoice",type:"automation",label:"Validate Invoice"},{id:"final-approval",type:"human",label:"Final Approval"}],transitions:[{from:"validate-invoice",to:"final-approval"}]}};function Px(){let x=new B;return x.register({workflow:"billing.invoiceApproval",tenantId:"acme",customSteps:[{after:"validate-invoice",inject:{id:"acme-legal",type:"human",label:"ACME Legal Review"},transitionTo:"final-approval"}]}),x.compose({base:u,tenantId:"acme"})}function Qx(x){h.info("Tenant workflow composed",{workflow:x.meta.key,steps:x.definition.steps.map((j)=>j.id)})}export{t as runOverlayCustomizationExample,v as runBehaviorTrackingExample,Qx as logTenantWorkflowSteps,_ as example,Px as composeTenantWorkflowExample,Gx as PersonalizationTheme,xx as PersonalizationFeature,c as PersonalizationExperiment};
@@ -1,44 +1 @@
1
- // src/behavior-tracking.ts
2
- import { Logger, LogLevel } from "@contractspec/lib.logger";
3
- import { BehaviorAnalyzer } from "@contractspec/lib.personalization/analyzer";
4
- import { InMemoryBehaviorStore } from "@contractspec/lib.personalization/store";
5
- import { createBehaviorTracker } from "@contractspec/lib.personalization/tracker";
6
- var logger = new Logger({
7
- level: LogLevel.INFO,
8
- environment: "production",
9
- enableColors: false
10
- });
11
- async function runBehaviorTrackingExample() {
12
- const store = new InMemoryBehaviorStore;
13
- const tracker = createBehaviorTracker({
14
- store,
15
- context: {
16
- tenantId: "acme",
17
- userId: "user-123"
18
- }
19
- });
20
- tracker.trackFieldAccess({
21
- operation: "billing.createOrder",
22
- field: "internalNotes"
23
- });
24
- tracker.trackFieldAccess({
25
- operation: "billing.createOrder",
26
- field: "customerReference"
27
- });
28
- tracker.trackFeatureUsage({ feature: "workflow-editor", action: "opened" });
29
- tracker.trackWorkflowStep({
30
- workflow: "invoice-approval",
31
- step: "review",
32
- status: "entered"
33
- });
34
- await tracker.flush();
35
- const analyzer = new BehaviorAnalyzer(store);
36
- const insights = await analyzer.analyze({
37
- tenantId: "acme",
38
- userId: "user-123"
39
- });
40
- logger.info("Behavior insights computed", { insights });
41
- }
42
- export {
43
- runBehaviorTrackingExample
44
- };
1
+ import{Logger as q,LogLevel as u}from"@contractspec/lib.logger";import{BehaviorAnalyzer as w}from"@contractspec/lib.personalization/analyzer";import{InMemoryBehaviorStore as x}from"@contractspec/lib.personalization/store";import{createBehaviorTracker as C}from"@contractspec/lib.personalization/tracker";var D=new q({level:u.INFO,environment:"production",enableColors:!1});async function K(){let f=new x,d=C({store:f,context:{tenantId:"acme",userId:"user-123"}});d.trackFieldAccess({operation:"billing.createOrder",field:"internalNotes"}),d.trackFieldAccess({operation:"billing.createOrder",field:"customerReference"}),d.trackFeatureUsage({feature:"workflow-editor",action:"opened"}),d.trackWorkflowStep({workflow:"invoice-approval",step:"review",status:"entered"}),await d.flush();let j=await new w(f).analyze({tenantId:"acme",userId:"user-123"});D.info("Behavior insights computed",{insights:j})}export{K as runBehaviorTrackingExample};
@@ -1,15 +1,4 @@
1
- // src/docs/personalization.docblock.ts
2
- import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
3
- var blocks = [
4
- {
5
- id: "docs.examples.personalization",
6
- title: "Personalization Patterns (example)",
7
- summary: "Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",
8
- kind: "reference",
9
- visibility: "public",
10
- route: "/docs/examples/personalization",
11
- tags: ["personalization", "overlays", "workflows", "example"],
12
- body: `## Includes
1
+ import{registerDocBlocks as m}from"@contractspec/lib.contracts-spec/docs";var f=[{id:"docs.examples.personalization",title:"Personalization Patterns (example)",summary:"Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",kind:"reference",visibility:"public",route:"/docs/examples/personalization",tags:["personalization","overlays","workflows","example"],body:`## Includes
13
2
  - Behavior tracking + insight analysis.
14
3
  - Overlay customization (hide fields, rename labels).
15
4
  - Workflow extension (inject tenant-specific steps).
@@ -17,24 +6,4 @@ var blocks = [
17
6
  ## Guardrails
18
7
  - Keep tracking events structured and non-PII.
19
8
  - Keep overlays signed and scoped.
20
- - Keep workflow composition deterministic.`
21
- },
22
- {
23
- id: "docs.examples.personalization.usage",
24
- title: "Personalization — Usage",
25
- summary: "How to run the small examples and swap adapters.",
26
- kind: "usage",
27
- visibility: "public",
28
- route: "/docs/examples/personalization/usage",
29
- tags: ["personalization", "usage"],
30
- body: `## Usage
31
- - Call \`runBehaviorTrackingExample()\` for insights.
32
- - Call \`runOverlayCustomizationExample()\` to apply overlays.
33
- - Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
34
-
35
- ## Notes
36
- - Replace in-memory stores with app-layer storage.
37
- - Keep PII out of logs and markdown outputs.`
38
- }
39
- ];
40
- registerDocBlocks(blocks);
9
+ - Keep workflow composition deterministic.`},{id:"docs.examples.personalization.usage",title:"Personalization — Usage",summary:"How to run the small examples and swap adapters.",kind:"usage",visibility:"public",route:"/docs/examples/personalization/usage",tags:["personalization","usage"],body:"## Usage\n- Call `runBehaviorTrackingExample()` for insights.\n- Call `runOverlayCustomizationExample()` to apply overlays.\n- Call `composeTenantWorkflowExample()` and `logTenantWorkflowSteps()` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs."}];m(f);
@@ -1,15 +1,4 @@
1
- // src/docs/personalization.docblock.ts
2
- import { registerDocBlocks } from "@contractspec/lib.contracts-spec/docs";
3
- var blocks = [
4
- {
5
- id: "docs.examples.personalization",
6
- title: "Personalization Patterns (example)",
7
- summary: "Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",
8
- kind: "reference",
9
- visibility: "public",
10
- route: "/docs/examples/personalization",
11
- tags: ["personalization", "overlays", "workflows", "example"],
12
- body: `## Includes
1
+ import{registerDocBlocks as f}from"@contractspec/lib.contracts-spec/docs";var h=[{id:"docs.examples.personalization",title:"Personalization Patterns (example)",summary:"Behavior tracking, overlay-driven UI tweaks, and tenant workflow extension patterns.",kind:"reference",visibility:"public",route:"/docs/examples/personalization",tags:["personalization","overlays","workflows","example"],body:`## Includes
13
2
  - Behavior tracking + insight analysis.
14
3
  - Overlay customization (hide fields, rename labels).
15
4
  - Workflow extension (inject tenant-specific steps).
@@ -17,24 +6,4 @@ var blocks = [
17
6
  ## Guardrails
18
7
  - Keep tracking events structured and non-PII.
19
8
  - Keep overlays signed and scoped.
20
- - Keep workflow composition deterministic.`
21
- },
22
- {
23
- id: "docs.examples.personalization.usage",
24
- title: "Personalization — Usage",
25
- summary: "How to run the small examples and swap adapters.",
26
- kind: "usage",
27
- visibility: "public",
28
- route: "/docs/examples/personalization/usage",
29
- tags: ["personalization", "usage"],
30
- body: `## Usage
31
- - Call \`runBehaviorTrackingExample()\` for insights.
32
- - Call \`runOverlayCustomizationExample()\` to apply overlays.
33
- - Call \`composeTenantWorkflowExample()\` and \`logTenantWorkflowSteps()\` to inspect steps.
34
-
35
- ## Notes
36
- - Replace in-memory stores with app-layer storage.
37
- - Keep PII out of logs and markdown outputs.`
38
- }
39
- ];
40
- registerDocBlocks(blocks);
9
+ - Keep workflow composition deterministic.`},{id:"docs.examples.personalization.usage",title:"Personalization — Usage",summary:"How to run the small examples and swap adapters.",kind:"usage",visibility:"public",route:"/docs/examples/personalization/usage",tags:["personalization","usage"],body:"## Usage\n- Call `runBehaviorTrackingExample()` for insights.\n- Call `runOverlayCustomizationExample()` to apply overlays.\n- Call `composeTenantWorkflowExample()` and `logTenantWorkflowSteps()` to inspect steps.\n\n## Notes\n- Replace in-memory stores with app-layer storage.\n- Keep PII out of logs and markdown outputs."}];f(h);