@contractspec/example.learning-journey-platform-tour 1.44.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 (51) hide show
  1. package/.turbo/turbo-build$colon$bundle.log +41 -0
  2. package/.turbo/turbo-build.log +42 -0
  3. package/CHANGELOG.md +178 -0
  4. package/LICENSE +21 -0
  5. package/README.md +43 -0
  6. package/dist/docs/index.d.ts +1 -0
  7. package/dist/docs/index.js +1 -0
  8. package/dist/docs/platform-tour.docblock.d.ts +1 -0
  9. package/dist/docs/platform-tour.docblock.js +42 -0
  10. package/dist/docs/platform-tour.docblock.js.map +1 -0
  11. package/dist/example.d.ts +35 -0
  12. package/dist/example.d.ts.map +1 -0
  13. package/dist/example.js +39 -0
  14. package/dist/example.js.map +1 -0
  15. package/dist/handlers/demo.handlers.d.ts +25 -0
  16. package/dist/handlers/demo.handlers.d.ts.map +1 -0
  17. package/dist/handlers/demo.handlers.js +27 -0
  18. package/dist/handlers/demo.handlers.js.map +1 -0
  19. package/dist/index.d.ts +7 -0
  20. package/dist/index.js +9 -0
  21. package/dist/learning-journey-platform-tour.feature.d.ts +12 -0
  22. package/dist/learning-journey-platform-tour.feature.d.ts.map +1 -0
  23. package/dist/learning-journey-platform-tour.feature.js +68 -0
  24. package/dist/learning-journey-platform-tour.feature.js.map +1 -0
  25. package/dist/operations/index.d.ts +271 -0
  26. package/dist/operations/index.d.ts.map +1 -0
  27. package/dist/operations/index.js +176 -0
  28. package/dist/operations/index.js.map +1 -0
  29. package/dist/presentations/index.d.ts +9 -0
  30. package/dist/presentations/index.d.ts.map +1 -0
  31. package/dist/presentations/index.js +55 -0
  32. package/dist/presentations/index.js.map +1 -0
  33. package/dist/track.d.ts +8 -0
  34. package/dist/track.d.ts.map +1 -0
  35. package/dist/track.js +106 -0
  36. package/dist/track.js.map +1 -0
  37. package/example.ts +1 -0
  38. package/package.json +67 -0
  39. package/src/docs/index.ts +1 -0
  40. package/src/docs/platform-tour.docblock.ts +40 -0
  41. package/src/example.ts +26 -0
  42. package/src/handlers/demo.handlers.ts +50 -0
  43. package/src/index.ts +7 -0
  44. package/src/learning-journey-platform-tour.feature.ts +66 -0
  45. package/src/operations/index.test.ts +49 -0
  46. package/src/operations/index.ts +122 -0
  47. package/src/presentations/index.ts +55 -0
  48. package/src/track.ts +106 -0
  49. package/tsconfig.json +9 -0
  50. package/tsconfig.tsbuildinfo +1 -0
  51. package/tsdown.config.js +17 -0
@@ -0,0 +1,41 @@
1
+ $ tsdown
2
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
3
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-platform-tour/tsdown.config.js
4
+ ℹ entry: src/example.ts, src/index.ts, src/learning-journey-platform-tour.feature.ts, src/track.ts, src/docs/index.ts, src/docs/platform-tour.docblock.ts, src/handlers/demo.handlers.ts, src/operations/index.ts, src/presentations/index.ts
5
+ ℹ target: esnext
6
+ ℹ tsconfig: tsconfig.json
7
+ ℹ Build start
8
+ ℹ Cleaning 35 files
9
+ ℹ dist/operations/index.js 4.24 kB │ gzip: 1.07 kB
10
+ ℹ dist/track.js 2.85 kB │ gzip: 0.91 kB
11
+ ℹ dist/docs/platform-tour.docblock.js 1.57 kB │ gzip: 0.81 kB
12
+ ℹ dist/learning-journey-platform-tour.feature.js 1.53 kB │ gzip: 0.55 kB
13
+ ℹ dist/presentations/index.js 1.42 kB │ gzip: 0.56 kB
14
+ ℹ dist/index.js 1.01 kB │ gzip: 0.31 kB
15
+ ℹ dist/example.js 0.89 kB │ gzip: 0.45 kB
16
+ ℹ dist/handlers/demo.handlers.js 0.83 kB │ gzip: 0.42 kB
17
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
18
+ ℹ dist/operations/index.js.map 6.33 kB │ gzip: 1.58 kB
19
+ ℹ dist/track.js.map 4.58 kB │ gzip: 1.25 kB
20
+ ℹ dist/learning-journey-platform-tour.feature.js.map 2.85 kB │ gzip: 1.02 kB
21
+ ℹ dist/presentations/index.js.map 2.41 kB │ gzip: 0.86 kB
22
+ ℹ dist/docs/platform-tour.docblock.js.map 2.01 kB │ gzip: 0.97 kB
23
+ ℹ dist/handlers/demo.handlers.js.map 1.68 kB │ gzip: 0.73 kB
24
+ ℹ dist/example.js.map 1.26 kB │ gzip: 0.61 kB
25
+ ℹ dist/operations/index.d.ts.map 0.84 kB │ gzip: 0.32 kB
26
+ ℹ dist/handlers/demo.handlers.d.ts.map 0.68 kB │ gzip: 0.35 kB
27
+ ℹ dist/presentations/index.d.ts.map 0.19 kB │ gzip: 0.16 kB
28
+ ℹ dist/learning-journey-platform-tour.feature.d.ts.map 0.19 kB │ gzip: 0.14 kB
29
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
30
+ ℹ dist/track.d.ts.map 0.14 kB │ gzip: 0.13 kB
31
+ ℹ dist/operations/index.d.ts 8.79 kB │ gzip: 0.93 kB
32
+ ℹ dist/example.d.ts 1.14 kB │ gzip: 0.44 kB
33
+ ℹ dist/handlers/demo.handlers.d.ts 1.00 kB │ gzip: 0.43 kB
34
+ ℹ dist/index.d.ts 0.99 kB │ gzip: 0.29 kB
35
+ ℹ dist/learning-journey-platform-tour.feature.d.ts 0.45 kB │ gzip: 0.25 kB
36
+ ℹ dist/presentations/index.d.ts 0.44 kB │ gzip: 0.20 kB
37
+ ℹ dist/track.d.ts 0.37 kB │ gzip: 0.20 kB
38
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
39
+ ℹ dist/docs/platform-tour.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
40
+ ℹ 31 files, total: 50.89 kB
41
+ ✔ Build complete in 18569ms
@@ -0,0 +1,42 @@
1
+ $ bun build:types && bun build:bundle
2
+ $ tsc --noEmit
3
+ $ tsdown
4
+ ℹ tsdown v0.18.3 powered by rolldown v1.0.0-beta.57
5
+ ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-platform-tour/tsdown.config.js
6
+ ℹ entry: src/example.ts, src/index.ts, src/learning-journey-platform-tour.feature.ts, src/track.ts, src/docs/index.ts, src/docs/platform-tour.docblock.ts, src/handlers/demo.handlers.ts, src/operations/index.ts, src/presentations/index.ts
7
+ ℹ target: esnext
8
+ ℹ tsconfig: tsconfig.json
9
+ ℹ Build start
10
+ ℹ dist/operations/index.js 4.24 kB │ gzip: 1.07 kB
11
+ ℹ dist/track.js 2.85 kB │ gzip: 0.91 kB
12
+ ℹ dist/docs/platform-tour.docblock.js 1.57 kB │ gzip: 0.81 kB
13
+ ℹ dist/learning-journey-platform-tour.feature.js 1.53 kB │ gzip: 0.55 kB
14
+ ℹ dist/presentations/index.js 1.42 kB │ gzip: 0.56 kB
15
+ ℹ dist/index.js 1.01 kB │ gzip: 0.31 kB
16
+ ℹ dist/example.js 0.89 kB │ gzip: 0.45 kB
17
+ ℹ dist/handlers/demo.handlers.js 0.83 kB │ gzip: 0.42 kB
18
+ ℹ dist/docs/index.js 0.04 kB │ gzip: 0.06 kB
19
+ ℹ dist/operations/index.js.map 6.33 kB │ gzip: 1.58 kB
20
+ ℹ dist/track.js.map 4.58 kB │ gzip: 1.25 kB
21
+ ℹ dist/learning-journey-platform-tour.feature.js.map 2.85 kB │ gzip: 1.02 kB
22
+ ℹ dist/presentations/index.js.map 2.41 kB │ gzip: 0.86 kB
23
+ ℹ dist/docs/platform-tour.docblock.js.map 2.01 kB │ gzip: 0.97 kB
24
+ ℹ dist/handlers/demo.handlers.js.map 1.68 kB │ gzip: 0.73 kB
25
+ ℹ dist/example.js.map 1.26 kB │ gzip: 0.61 kB
26
+ ℹ dist/operations/index.d.ts.map 0.84 kB │ gzip: 0.32 kB
27
+ ℹ dist/handlers/demo.handlers.d.ts.map 0.68 kB │ gzip: 0.35 kB
28
+ ℹ dist/presentations/index.d.ts.map 0.19 kB │ gzip: 0.16 kB
29
+ ℹ dist/learning-journey-platform-tour.feature.d.ts.map 0.19 kB │ gzip: 0.14 kB
30
+ ℹ dist/example.d.ts.map 0.14 kB │ gzip: 0.13 kB
31
+ ℹ dist/track.d.ts.map 0.14 kB │ gzip: 0.13 kB
32
+ ℹ dist/operations/index.d.ts 8.79 kB │ gzip: 0.93 kB
33
+ ℹ dist/example.d.ts 1.14 kB │ gzip: 0.44 kB
34
+ ℹ dist/handlers/demo.handlers.d.ts 1.00 kB │ gzip: 0.43 kB
35
+ ℹ dist/index.d.ts 0.99 kB │ gzip: 0.29 kB
36
+ ℹ dist/learning-journey-platform-tour.feature.d.ts 0.45 kB │ gzip: 0.25 kB
37
+ ℹ dist/presentations/index.d.ts 0.44 kB │ gzip: 0.20 kB
38
+ ℹ dist/track.d.ts 0.37 kB │ gzip: 0.20 kB
39
+ ℹ dist/docs/index.d.ts 0.01 kB │ gzip: 0.03 kB
40
+ ℹ dist/docs/platform-tour.docblock.d.ts 0.01 kB │ gzip: 0.03 kB
41
+ ℹ 31 files, total: 50.89 kB
42
+ ✔ Build complete in 21513ms
package/CHANGELOG.md ADDED
@@ -0,0 +1,178 @@
1
+ # @contractspec/example.learning-journey-platform-tour
2
+
3
+ ## 1.44.0
4
+
5
+ ### Minor Changes
6
+
7
+ - 5f3a868: chore: isolate branding to contractspec.io
8
+
9
+ ### Patch Changes
10
+
11
+ - Updated dependencies [5f3a868]
12
+ - @contractspec/module.learning-journey@1.44.0
13
+ - @contractspec/lib.contracts@1.44.0
14
+ - @contractspec/lib.schema@1.44.0
15
+
16
+ ## 1.43.3
17
+
18
+ ### Patch Changes
19
+
20
+ - 9216062: fix: cross-platform compatibility
21
+ - Updated dependencies [9216062]
22
+ - @contractspec/module.learning-journey@1.43.4
23
+ - @contractspec/lib.contracts@1.43.4
24
+ - @contractspec/lib.schema@1.43.3
25
+
26
+ ## 1.43.2
27
+
28
+ ### Patch Changes
29
+
30
+ - 24d9759: improve documentation
31
+ - Updated dependencies [24d9759]
32
+ - @contractspec/module.learning-journey@1.43.3
33
+ - @contractspec/lib.contracts@1.43.3
34
+ - @contractspec/lib.schema@1.43.2
35
+
36
+ ## 1.43.2
37
+
38
+ ### Patch Changes
39
+
40
+ - e147271: fix: improve stability
41
+ - Updated dependencies [e147271]
42
+ - @contractspec/module.learning-journey@1.43.2
43
+ - @contractspec/lib.contracts@1.43.2
44
+ - @contractspec/lib.schema@1.43.1
45
+
46
+ ## 1.43.1
47
+
48
+ ### Patch Changes
49
+
50
+ - Updated dependencies [f28fdad]
51
+ - @contractspec/lib.contracts@1.43.1
52
+ - @contractspec/module.learning-journey@1.43.1
53
+
54
+ ## 1.43.0
55
+
56
+ ### Minor Changes
57
+
58
+ - 042d072: feat: schema declaration using json schema, including zod
59
+
60
+ ### Patch Changes
61
+
62
+ - Updated dependencies [042d072]
63
+ - @contractspec/module.learning-journey@1.43.0
64
+ - @contractspec/lib.contracts@1.43.0
65
+ - @contractspec/lib.schema@1.43.0
66
+
67
+ ## 1.42.9
68
+
69
+ ### Patch Changes
70
+
71
+ - 1e6a0f1: fix: mcp server
72
+ - Updated dependencies [1e6a0f1]
73
+ - @contractspec/module.learning-journey@1.42.10
74
+ - @contractspec/lib.contracts@1.42.10
75
+ - @contractspec/lib.schema@1.42.10
76
+
77
+ ## 1.42.8
78
+
79
+ ### Patch Changes
80
+
81
+ - 9281db7: fix ModelRegistry
82
+ - Updated dependencies [9281db7]
83
+ - @contractspec/module.learning-journey@1.42.9
84
+ - @contractspec/lib.contracts@1.42.9
85
+ - @contractspec/lib.schema@1.42.9
86
+
87
+ ## 1.42.7
88
+
89
+ ### Patch Changes
90
+
91
+ - e07b5ac: fix
92
+ - Updated dependencies [e07b5ac]
93
+ - @contractspec/module.learning-journey@1.42.8
94
+ - @contractspec/lib.contracts@1.42.8
95
+ - @contractspec/lib.schema@1.42.8
96
+
97
+ ## 1.42.6
98
+
99
+ ### Patch Changes
100
+
101
+ - e9b575d: fix release
102
+ - Updated dependencies [e9b575d]
103
+ - @contractspec/module.learning-journey@1.42.7
104
+ - @contractspec/lib.contracts@1.42.7
105
+ - @contractspec/lib.schema@1.42.7
106
+
107
+ ## 1.42.5
108
+
109
+ ### Patch Changes
110
+
111
+ - 1500242: fix tooling
112
+ - Updated dependencies [1500242]
113
+ - @contractspec/module.learning-journey@1.42.6
114
+ - @contractspec/lib.contracts@1.42.6
115
+ - @contractspec/lib.schema@1.42.6
116
+
117
+ ## 1.42.4
118
+
119
+ ### Patch Changes
120
+
121
+ - 1299719: fix vscode
122
+ - Updated dependencies [1299719]
123
+ - @contractspec/module.learning-journey@1.42.5
124
+ - @contractspec/lib.contracts@1.42.5
125
+ - @contractspec/lib.schema@1.42.5
126
+
127
+ ## 1.42.3
128
+
129
+ ### Patch Changes
130
+
131
+ - ac28b99: fix: generate from openapi
132
+ - Updated dependencies [ac28b99]
133
+ - @contractspec/module.learning-journey@1.42.4
134
+ - @contractspec/lib.contracts@1.42.4
135
+ - @contractspec/lib.schema@1.42.4
136
+
137
+ ## 1.42.2
138
+
139
+ ### Patch Changes
140
+
141
+ - 3f5d015: fix(tooling): cicd
142
+ - Updated dependencies [3f5d015]
143
+ - @contractspec/lib.contracts@1.42.3
144
+ - @contractspec/lib.schema@1.42.3
145
+ - @contractspec/module.learning-journey@1.42.3
146
+
147
+ ## 1.42.2
148
+
149
+ ### Patch Changes
150
+
151
+ - 1f9ac4c: fix
152
+ - Updated dependencies [1f9ac4c]
153
+ - @contractspec/lib.contracts@1.42.2
154
+ - @contractspec/lib.schema@1.42.2
155
+ - @contractspec/module.learning-journey@1.42.2
156
+
157
+ ## 1.42.1
158
+
159
+ ### Patch Changes
160
+
161
+ - f043995: Fix release
162
+ - Updated dependencies [f043995]
163
+ - @contractspec/module.learning-journey@1.42.1
164
+ - @contractspec/lib.contracts@1.42.1
165
+ - @contractspec/lib.schema@1.42.1
166
+
167
+ ## 1.42.0
168
+
169
+ ### Minor Changes
170
+
171
+ - 8eefd9c: initial release
172
+
173
+ ### Patch Changes
174
+
175
+ - Updated dependencies [8eefd9c]
176
+ - @contractspec/lib.contracts@1.42.0
177
+ - @contractspec/lib.schema@1.42.0
178
+ - @contractspec/module.learning-journey@1.42.0
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2025 Chaman Ventures, SASU
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md ADDED
@@ -0,0 +1,43 @@
1
+ # @contractspec/example.learning-journey-platform-tour
2
+
3
+ Website: https://contractspec.io/
4
+
5
+
6
+ Learning Journey example that tours platform primitives.
7
+
8
+ ## Track
9
+
10
+ - **Key**: `platform_primitives_tour`
11
+ - **Persona**: platform developer
12
+ - **XP**: 7 steps × 20 XP + 20 bonus
13
+ - **Badge**: `platform_primitives`
14
+
15
+ ## Steps & Events
16
+
17
+ 1. `identity_rbac` → `org.member.added`
18
+ 2. `event_bus_audit` → `audit_log.created`
19
+ 3. `notifications` → `notification.sent`
20
+ 4. `jobs_scheduler` → `job.completed`
21
+ 5. `feature_flags` → `flag.toggled`
22
+ 6. `files_attachments` → `attachment.attached`
23
+ 7. `usage_metering` → `usage.recorded`
24
+
25
+ ## Usage
26
+
27
+ - Import track specs:
28
+ `import { platformLearningTracks } from '@contractspec/example.learning-journey-platform-tour/track'`
29
+ - Contracts/handlers for demos:
30
+ `import { GetPlatformTourTrack, RecordPlatformTourEvent } from '@contractspec/example.learning-journey-platform-tour/contracts'`
31
+ `import { emitPlatformTourEvent } from '@contractspec/example.learning-journey-platform-tour/handlers/demo.handlers'`
32
+ - Presentations (react/markdown/json targets):
33
+ `import { platformTourPresentations } from '@contractspec/example.learning-journey-platform-tour/presentations'`
34
+ - Register via onboarding API:
35
+ - `learning.onboarding.listTracks`
36
+ - `learning.onboarding.getProgress`
37
+ - `learning.onboarding.recordEvent` wired from each module’s events
38
+ - Map module events (identity, audit-trail, notifications, jobs, feature-flags, files, metering) into `recordEvent`.
39
+
40
+ ## Docs
41
+
42
+ - Docblock: `src/docs/platform-tour.docblock.ts`
43
+ - Route suggestion: `/docs/learning-journey/platform-tour`
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1 @@
1
+ import "./platform-tour.docblock.js";
@@ -0,0 +1 @@
1
+ export { };
@@ -0,0 +1,42 @@
1
+ import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
2
+
3
+ //#region src/docs/platform-tour.docblock.ts
4
+ registerDocBlocks([{
5
+ id: "docs.learning-journey.platform-tour",
6
+ title: "Learning Journey — Platform Primitives Tour",
7
+ summary: "Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.",
8
+ kind: "reference",
9
+ visibility: "public",
10
+ route: "/docs/learning-journey/platform-tour",
11
+ tags: [
12
+ "learning",
13
+ "platform",
14
+ "onboarding"
15
+ ],
16
+ body: `## Track
17
+ - **Key**: \`platform_primitives_tour\`
18
+ - **Persona**: platform developer exploring primitives
19
+ - **Goal**: Touch each cross-cutting module once, event-driven completion
20
+
21
+ ## Steps & Events
22
+ 1) \`identity_rbac\` → \`org.member.added\`
23
+ 2) \`event_bus_audit\` → \`audit_log.created\`
24
+ 3) \`notifications\` → \`notification.sent\`
25
+ 4) \`jobs_scheduler\` → \`job.completed\`
26
+ 5) \`feature_flags\` → \`flag.toggled\`
27
+ 6) \`files_attachments\` → \`attachment.attached\`
28
+ 7) \`usage_metering\` → \`usage.recorded\`
29
+
30
+ XP: 20 per step, 20 bonus XP upon completion.
31
+
32
+ ## Wiring
33
+ - Tracks export from \`@contractspec/example.learning-journey-platform-tour/track\`.
34
+ - Use onboarding API to surface progress:
35
+ - \`learning.onboarding.listTracks\`
36
+ - \`learning.onboarding.getProgress\`
37
+ - \`learning.onboarding.recordEvent\` wired from each module's event bus handlers.
38
+ - Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`
39
+ }]);
40
+
41
+ //#endregion
42
+ //# sourceMappingURL=platform-tour.docblock.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"platform-tour.docblock.js","names":[],"sources":["../../src/docs/platform-tour.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst platformTourDocBlocks: DocBlock[] = [\n {\n id: 'docs.learning-journey.platform-tour',\n title: 'Learning Journey — Platform Primitives Tour',\n summary:\n 'Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.',\n kind: 'reference',\n visibility: 'public',\n route: '/docs/learning-journey/platform-tour',\n tags: ['learning', 'platform', 'onboarding'],\n body: `## Track\n- **Key**: \\`platform_primitives_tour\\`\n- **Persona**: platform developer exploring primitives\n- **Goal**: Touch each cross-cutting module once, event-driven completion\n\n## Steps & Events\n1) \\`identity_rbac\\` → \\`org.member.added\\`\n2) \\`event_bus_audit\\` → \\`audit_log.created\\`\n3) \\`notifications\\` → \\`notification.sent\\`\n4) \\`jobs_scheduler\\` → \\`job.completed\\`\n5) \\`feature_flags\\` → \\`flag.toggled\\`\n6) \\`files_attachments\\` → \\`attachment.attached\\`\n7) \\`usage_metering\\` → \\`usage.recorded\\`\n\nXP: 20 per step, 20 bonus XP upon completion.\n\n## Wiring\n- Tracks export from \\`@contractspec/example.learning-journey-platform-tour/track\\`.\n- Use onboarding API to surface progress:\n - \\`learning.onboarding.listTracks\\`\n - \\`learning.onboarding.getProgress\\`\n - \\`learning.onboarding.recordEvent\\` wired from each module's event bus handlers.\n- Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`,\n },\n];\n\nregisterDocBlocks(platformTourDocBlocks);\n"],"mappings":";;;AAuCA,kBApC0C,CACxC;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAY;EAAY;EAAa;CAC5C,MAAM;;;;;;;;;;;;;;;;;;;;;;;CAuBP,CACF,CAEuC"}
@@ -0,0 +1,35 @@
1
+ //#region src/example.d.ts
2
+ declare const example: {
3
+ readonly id: "learning-journey-platform-tour";
4
+ readonly title: "Learning Journey — Platform Tour";
5
+ readonly summary: "Learning journey track + contracts + presentations for a platform tour.";
6
+ readonly tags: readonly ["learning", "journey", "platform-tour"];
7
+ readonly kind: "template";
8
+ readonly visibility: "public";
9
+ readonly docs: {
10
+ readonly rootDocId: "docs.examples.platform-tour";
11
+ readonly goalDocId: "docs.examples.platform-tour.goal";
12
+ readonly usageDocId: "docs.examples.platform-tour.usage";
13
+ };
14
+ readonly entrypoints: {
15
+ readonly packageName: "@contractspec/example.learning-journey-platform-tour";
16
+ readonly docs: "./docs";
17
+ };
18
+ readonly surfaces: {
19
+ readonly templates: true;
20
+ readonly sandbox: {
21
+ readonly enabled: true;
22
+ readonly modes: readonly ["markdown", "playground"];
23
+ };
24
+ readonly studio: {
25
+ readonly enabled: true;
26
+ readonly installable: true;
27
+ };
28
+ readonly mcp: {
29
+ readonly enabled: true;
30
+ };
31
+ };
32
+ };
33
+ //#endregion
34
+ export { example as default };
35
+ //# sourceMappingURL=example.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.d.ts","names":[],"sources":["../src/example.ts"],"sourcesContent":[],"mappings":";cAAM;EAAA,SAAA,EAuBI,EAAA,gCAAA"}
@@ -0,0 +1,39 @@
1
+ //#region src/example.ts
2
+ const example = {
3
+ id: "learning-journey-platform-tour",
4
+ title: "Learning Journey — Platform Tour",
5
+ summary: "Learning journey track + contracts + presentations for a platform tour.",
6
+ tags: [
7
+ "learning",
8
+ "journey",
9
+ "platform-tour"
10
+ ],
11
+ kind: "template",
12
+ visibility: "public",
13
+ docs: {
14
+ rootDocId: "docs.examples.platform-tour",
15
+ goalDocId: "docs.examples.platform-tour.goal",
16
+ usageDocId: "docs.examples.platform-tour.usage"
17
+ },
18
+ entrypoints: {
19
+ packageName: "@contractspec/example.learning-journey-platform-tour",
20
+ docs: "./docs"
21
+ },
22
+ surfaces: {
23
+ templates: true,
24
+ sandbox: {
25
+ enabled: true,
26
+ modes: ["markdown", "playground"]
27
+ },
28
+ studio: {
29
+ enabled: true,
30
+ installable: true
31
+ },
32
+ mcp: { enabled: true }
33
+ }
34
+ };
35
+ var example_default = example;
36
+
37
+ //#endregion
38
+ export { example_default as default };
39
+ //# sourceMappingURL=example.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"example.js","names":[],"sources":["../src/example.ts"],"sourcesContent":["const example = {\n id: 'learning-journey-platform-tour',\n title: 'Learning Journey — Platform Tour',\n summary:\n 'Learning journey track + contracts + presentations for a platform tour.',\n tags: ['learning', 'journey', 'platform-tour'],\n kind: 'template',\n visibility: 'public',\n docs: {\n rootDocId: 'docs.examples.platform-tour',\n goalDocId: 'docs.examples.platform-tour.goal',\n usageDocId: 'docs.examples.platform-tour.usage',\n },\n entrypoints: {\n packageName: '@contractspec/example.learning-journey-platform-tour',\n docs: './docs',\n },\n surfaces: {\n templates: true,\n sandbox: { enabled: true, modes: ['markdown', 'playground'] },\n studio: { enabled: true, installable: true },\n mcp: { enabled: true },\n },\n} as const;\n\nexport default example;\n"],"mappings":";AAAA,MAAM,UAAU;CACd,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;EAAC;EAAY;EAAW;EAAgB;CAC9C,MAAM;CACN,YAAY;CACZ,MAAM;EACJ,WAAW;EACX,WAAW;EACX,YAAY;EACb;CACD,aAAa;EACX,aAAa;EACb,MAAM;EACP;CACD,UAAU;EACR,WAAW;EACX,SAAS;GAAE,SAAS;GAAM,OAAO,CAAC,YAAY,aAAa;GAAE;EAC7D,QAAQ;GAAE,SAAS;GAAM,aAAa;GAAM;EAC5C,KAAK,EAAE,SAAS,MAAM;EACvB;CACF;AAED,sBAAe"}
@@ -0,0 +1,25 @@
1
+ //#region src/handlers/demo.handlers.d.ts
2
+ interface EmitParams {
3
+ learnerId: string;
4
+ occurredAt?: Date;
5
+ payload?: Record<string, unknown>;
6
+ }
7
+ interface LearningJourneyEvent {
8
+ learnerId: string;
9
+ name: string;
10
+ occurredAt: Date;
11
+ trackId: string;
12
+ payload?: Record<string, unknown>;
13
+ }
14
+ type RecordEvent = (event: LearningJourneyEvent) => unknown;
15
+ declare const platformTourEvents: readonly ["org.member.added", "audit_log.created", "notification.sent", "job.completed", "flag.toggled", "attachment.attached", "usage.recorded"];
16
+ type PlatformEvent = (typeof platformTourEvents)[number];
17
+ declare const emitPlatformTourEvent: (eventName: PlatformEvent, {
18
+ learnerId,
19
+ occurredAt,
20
+ payload
21
+ }: EmitParams, record?: RecordEvent) => unknown;
22
+ declare const emitAllPlatformTourEvents: (params: EmitParams, record?: RecordEvent) => unknown[];
23
+ //#endregion
24
+ export { PlatformEvent, emitAllPlatformTourEvents, emitPlatformTourEvent, platformTourEvents };
25
+ //# sourceMappingURL=demo.handlers.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"demo.handlers.d.ts","names":[],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":[],"mappings":";UAEU,UAAA;EAAA,SAAA,EAAA,MAAU;EAMV,UAAA,CAAA,EAJK,IAIL;EAQL,OAAA,CAAA,EAXO,MAWI,CAAA,MAAA,EAAW,OAAA,CAAA;AAE3B;AAUA,UApBU,oBAAA,CAoBe;EAEZ,SAAA,EAAA,MAAA;EACA,IAAA,EAAA,MAAA;EACX,UAAA,EArBY,IAqBZ;EAAA,OAAA,EAAA,MAAA;EAAA,OAAA,CAAA,EAnBU,MAmBV,CAAA,MAAA,EAAA,OAAA,CAAA;;KAhBG,WAAA,GAiBM,CAAA,KAAA,EAjBgB,oBAiBhB,EAAA,GAAA,OAAA;AAAW,cAfT,kBAeS,EAAA,SAAA,CAAA,kBAAA,EAAA,mBAAA,EAAA,mBAAA,EAAA,eAAA,EAAA,cAAA,EAAA,qBAAA,EAAA,gBAAA,CAAA;AAYT,KAjBD,aAAA,GAiBC,CAAA,OAjBuB,kBAkB1B,CAAA,CACC,MAAA,CAAA;cAjBE,mCACA;;;;GACsC,qBACxC;cAYE,oCACH,qBACC"}
@@ -0,0 +1,27 @@
1
+ import { platformPrimitivesTourTrack } from "../track.js";
2
+
3
+ //#region src/handlers/demo.handlers.ts
4
+ const platformTourEvents = [
5
+ "org.member.added",
6
+ "audit_log.created",
7
+ "notification.sent",
8
+ "job.completed",
9
+ "flag.toggled",
10
+ "attachment.attached",
11
+ "usage.recorded"
12
+ ];
13
+ const emitPlatformTourEvent = (eventName, { learnerId, occurredAt = /* @__PURE__ */ new Date(), payload }, record) => {
14
+ const event = {
15
+ learnerId,
16
+ name: eventName,
17
+ occurredAt,
18
+ payload,
19
+ trackId: platformPrimitivesTourTrack.id
20
+ };
21
+ return record ? record(event) : event;
22
+ };
23
+ const emitAllPlatformTourEvents = (params, record) => platformTourEvents.map((name) => emitPlatformTourEvent(name, params, record));
24
+
25
+ //#endregion
26
+ export { emitAllPlatformTourEvents, emitPlatformTourEvent, platformTourEvents };
27
+ //# sourceMappingURL=demo.handlers.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"demo.handlers.js","names":["event: LearningJourneyEvent"],"sources":["../../src/handlers/demo.handlers.ts"],"sourcesContent":["import { platformPrimitivesTourTrack } from '../track';\n\ninterface EmitParams {\n learnerId: string;\n occurredAt?: Date;\n payload?: Record<string, unknown>;\n}\n\ninterface LearningJourneyEvent {\n learnerId: string;\n name: string;\n occurredAt: Date;\n trackId: string;\n payload?: Record<string, unknown>;\n}\n\ntype RecordEvent = (event: LearningJourneyEvent) => unknown;\n\nexport const platformTourEvents = [\n 'org.member.added',\n 'audit_log.created',\n 'notification.sent',\n 'job.completed',\n 'flag.toggled',\n 'attachment.attached',\n 'usage.recorded',\n] as const;\n\nexport type PlatformEvent = (typeof platformTourEvents)[number];\n\nexport const emitPlatformTourEvent = (\n eventName: PlatformEvent,\n { learnerId, occurredAt = new Date(), payload }: EmitParams,\n record?: RecordEvent\n) => {\n const event: LearningJourneyEvent = {\n learnerId,\n name: eventName,\n occurredAt,\n payload,\n trackId: platformPrimitivesTourTrack.id,\n };\n return record ? record(event) : event;\n};\n\nexport const emitAllPlatformTourEvents = (\n params: EmitParams,\n record?: RecordEvent\n) =>\n platformTourEvents.map((name) => emitPlatformTourEvent(name, params, record));\n"],"mappings":";;;AAkBA,MAAa,qBAAqB;CAChC;CACA;CACA;CACA;CACA;CACA;CACA;CACD;AAID,MAAa,yBACX,WACA,EAAE,WAAW,6BAAa,IAAI,MAAM,EAAE,WACtC,WACG;CACH,MAAMA,QAA8B;EAClC;EACA,MAAM;EACN;EACA;EACA,SAAS,4BAA4B;EACtC;AACD,QAAO,SAAS,OAAO,MAAM,GAAG;;AAGlC,MAAa,6BACX,QACA,WAEA,mBAAmB,KAAK,SAAS,sBAAsB,MAAM,QAAQ,OAAO,CAAC"}
@@ -0,0 +1,7 @@
1
+ import example from "./example.js";
2
+ import { PlatformEvent, emitAllPlatformTourEvents, emitPlatformTourEvent, platformTourEvents } from "./handlers/demo.handlers.js";
3
+ import { platformLearningTracks, platformPrimitivesTourTrack } from "./track.js";
4
+ import { GetPlatformTourTrack, PlatformTourTrackModel, RecordPlatformTourEvent, platformTourContracts } from "./operations/index.js";
5
+ import { PlatformTourTrackPresentation, PlatformTourWidgetPresentation, platformTourPresentations } from "./presentations/index.js";
6
+ import { LearningJourneyPlatformTourFeature } from "./learning-journey-platform-tour.feature.js";
7
+ export { GetPlatformTourTrack, LearningJourneyPlatformTourFeature, PlatformEvent, PlatformTourTrackModel, PlatformTourTrackPresentation, PlatformTourWidgetPresentation, RecordPlatformTourEvent, emitAllPlatformTourEvents, emitPlatformTourEvent, example, platformLearningTracks, platformPrimitivesTourTrack, platformTourContracts, platformTourEvents, platformTourPresentations };
package/dist/index.js ADDED
@@ -0,0 +1,9 @@
1
+ import example_default from "./example.js";
2
+ import { platformLearningTracks, platformPrimitivesTourTrack } from "./track.js";
3
+ import "./docs/index.js";
4
+ import { GetPlatformTourTrack, PlatformTourTrackModel, RecordPlatformTourEvent, platformTourContracts } from "./operations/index.js";
5
+ import { emitAllPlatformTourEvents, emitPlatformTourEvent, platformTourEvents } from "./handlers/demo.handlers.js";
6
+ import { PlatformTourTrackPresentation, PlatformTourWidgetPresentation, platformTourPresentations } from "./presentations/index.js";
7
+ import { LearningJourneyPlatformTourFeature } from "./learning-journey-platform-tour.feature.js";
8
+
9
+ export { GetPlatformTourTrack, LearningJourneyPlatformTourFeature, PlatformTourTrackModel, PlatformTourTrackPresentation, PlatformTourWidgetPresentation, RecordPlatformTourEvent, emitAllPlatformTourEvents, emitPlatformTourEvent, example_default as example, platformLearningTracks, platformPrimitivesTourTrack, platformTourContracts, platformTourEvents, platformTourPresentations };
@@ -0,0 +1,12 @@
1
+ import { FeatureModuleSpec } from "@contractspec/lib.contracts";
2
+
3
+ //#region src/learning-journey-platform-tour.feature.d.ts
4
+
5
+ /**
6
+ * Learning Journey Platform Tour feature module that bundles
7
+ * platform-specific tour track operations and presentations.
8
+ */
9
+ declare const LearningJourneyPlatformTourFeature: FeatureModuleSpec;
10
+ //#endregion
11
+ export { LearningJourneyPlatformTourFeature };
12
+ //# sourceMappingURL=learning-journey-platform-tour.feature.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"learning-journey-platform-tour.feature.d.ts","names":[],"sources":["../src/learning-journey-platform-tour.feature.ts"],"sourcesContent":[],"mappings":";;;;;;;;cAWa,oCAAoC"}
@@ -0,0 +1,68 @@
1
+ //#region src/learning-journey-platform-tour.feature.ts
2
+ /**
3
+ * Learning Journey Platform Tour feature module that bundles
4
+ * platform-specific tour track operations and presentations.
5
+ */
6
+ const LearningJourneyPlatformTourFeature = {
7
+ meta: {
8
+ key: "learning-journey-platform-tour",
9
+ version: 1,
10
+ title: "Learning Journey: Platform Tour",
11
+ description: "Platform primitives tour journey for exploring ContractSpec core features",
12
+ domain: "learning-journey",
13
+ owners: ["@examples.learning-journey.platform-tour"],
14
+ tags: [
15
+ "learning",
16
+ "platform",
17
+ "tour",
18
+ "journey"
19
+ ],
20
+ stability: "experimental"
21
+ },
22
+ operations: [{
23
+ key: "learningJourney.platformTour.recordEvent",
24
+ version: 1
25
+ }, {
26
+ key: "learningJourney.platformTour.getTrack",
27
+ version: 1
28
+ }],
29
+ events: [],
30
+ presentations: [{
31
+ key: "learning.journey.platform.track",
32
+ version: 1
33
+ }, {
34
+ key: "learning.journey.platform.widget",
35
+ version: 1
36
+ }],
37
+ opToPresentation: [{
38
+ op: {
39
+ key: "learningJourney.platformTour.getTrack",
40
+ version: 1
41
+ },
42
+ pres: {
43
+ key: "learning.journey.platform.track",
44
+ version: 1
45
+ }
46
+ }],
47
+ presentationsTargets: [{
48
+ key: "learning.journey.platform.track",
49
+ version: 1,
50
+ targets: [
51
+ "react",
52
+ "markdown",
53
+ "application/json"
54
+ ]
55
+ }, {
56
+ key: "learning.journey.platform.widget",
57
+ version: 1,
58
+ targets: ["react"]
59
+ }],
60
+ capabilities: { requires: [{
61
+ key: "identity",
62
+ version: 1
63
+ }] }
64
+ };
65
+
66
+ //#endregion
67
+ export { LearningJourneyPlatformTourFeature };
68
+ //# sourceMappingURL=learning-journey-platform-tour.feature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"learning-journey-platform-tour.feature.js","names":["LearningJourneyPlatformTourFeature: FeatureModuleSpec"],"sources":["../src/learning-journey-platform-tour.feature.ts"],"sourcesContent":["/**\n * Learning Journey Platform Tour Feature Module Specification\n *\n * Defines the feature module for platform primitives tour journey.\n */\nimport type { FeatureModuleSpec } from '@contractspec/lib.contracts';\n\n/**\n * Learning Journey Platform Tour feature module that bundles\n * platform-specific tour track operations and presentations.\n */\nexport const LearningJourneyPlatformTourFeature: FeatureModuleSpec = {\n meta: {\n key: 'learning-journey-platform-tour',\n version: 1,\n title: 'Learning Journey: Platform Tour',\n description:\n 'Platform primitives tour journey for exploring ContractSpec core features',\n domain: 'learning-journey',\n owners: ['@examples.learning-journey.platform-tour'],\n tags: ['learning', 'platform', 'tour', 'journey'],\n stability: 'experimental',\n },\n\n // All contract operations included in this feature\n operations: [\n { key: 'learningJourney.platformTour.recordEvent', version: 1 },\n { key: 'learningJourney.platformTour.getTrack', version: 1 },\n ],\n\n // Events emitted by this feature\n events: [],\n\n // Presentations associated with this feature\n presentations: [\n { key: 'learning.journey.platform.track', version: 1 },\n { key: 'learning.journey.platform.widget', version: 1 },\n ],\n\n // Link operations to their primary presentations\n opToPresentation: [\n {\n op: { key: 'learningJourney.platformTour.getTrack', version: 1 },\n pres: { key: 'learning.journey.platform.track', version: 1 },\n },\n ],\n\n // Target requirements for multi-surface rendering\n presentationsTargets: [\n {\n key: 'learning.journey.platform.track',\n version: 1,\n targets: ['react', 'markdown', 'application/json'],\n },\n {\n key: 'learning.journey.platform.widget',\n version: 1,\n targets: ['react'],\n },\n ],\n\n // Capability requirements\n capabilities: {\n requires: [{ key: 'identity', version: 1 }],\n },\n};\n"],"mappings":";;;;;AAWA,MAAaA,qCAAwD;CACnE,MAAM;EACJ,KAAK;EACL,SAAS;EACT,OAAO;EACP,aACE;EACF,QAAQ;EACR,QAAQ,CAAC,2CAA2C;EACpD,MAAM;GAAC;GAAY;GAAY;GAAQ;GAAU;EACjD,WAAW;EACZ;CAGD,YAAY,CACV;EAAE,KAAK;EAA4C,SAAS;EAAG,EAC/D;EAAE,KAAK;EAAyC,SAAS;EAAG,CAC7D;CAGD,QAAQ,EAAE;CAGV,eAAe,CACb;EAAE,KAAK;EAAmC,SAAS;EAAG,EACtD;EAAE,KAAK;EAAoC,SAAS;EAAG,CACxD;CAGD,kBAAkB,CAChB;EACE,IAAI;GAAE,KAAK;GAAyC,SAAS;GAAG;EAChE,MAAM;GAAE,KAAK;GAAmC,SAAS;GAAG;EAC7D,CACF;CAGD,sBAAsB,CACpB;EACE,KAAK;EACL,SAAS;EACT,SAAS;GAAC;GAAS;GAAY;GAAmB;EACnD,EACD;EACE,KAAK;EACL,SAAS;EACT,SAAS,CAAC,QAAQ;EACnB,CACF;CAGD,cAAc,EACZ,UAAU,CAAC;EAAE,KAAK;EAAY,SAAS;EAAG,CAAC,EAC5C;CACF"}