@contractspec/example.learning-journey-platform-tour 1.57.0 → 1.58.0

package/.turbo/turbo-build.log

@@ -1,51 +1,47 @@
-$ bun build:types && bun build:bundle
-$ tsc --noEmit
-$ tsdown
-ℹ tsdown v0.20.3 powered by rolldown v1.0.0-rc.3
-ℹ config file: /home/runner/work/contractspec/contractspec/packages/examples/learning-journey-platform-tour/tsdown.config.js 
-ℹ 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, src/tests/operations.test-spec.ts
-ℹ target: esnext
-ℹ tsconfig: tsconfig.json
-ℹ Build start
-ℹ dist/operations/index.js                              4.26 kB │ gzip: 1.08 kB
-ℹ dist/track.js                                         2.85 kB │ gzip: 0.91 kB
-ℹ dist/learning-journey-platform-tour.feature.js        1.81 kB │ gzip: 0.62 kB
-ℹ dist/docs/platform-tour.docblock.js                   1.57 kB │ gzip: 0.81 kB
-ℹ dist/presentations/index.js                           1.49 kB │ gzip: 0.58 kB
-ℹ dist/example.js                                       1.03 kB │ gzip: 0.51 kB
-ℹ dist/index.js                                         0.99 kB │ gzip: 0.30 kB
-ℹ dist/tests/operations.test-spec.js                    0.90 kB │ gzip: 0.42 kB
-ℹ dist/handlers/demo.handlers.js                        0.83 kB │ gzip: 0.42 kB
-ℹ dist/docs/index.js                                    0.04 kB │ gzip: 0.06 kB
-ℹ dist/operations/index.js.map                          6.35 kB │ gzip: 1.59 kB
-ℹ dist/track.js.map                                     4.47 kB │ gzip: 1.24 kB
-ℹ dist/learning-journey-platform-tour.feature.js.map    2.86 kB │ gzip: 1.02 kB
-ℹ dist/presentations/index.js.map                       2.18 kB │ gzip: 0.87 kB
-ℹ dist/docs/platform-tour.docblock.js.map               2.01 kB │ gzip: 0.97 kB
-ℹ dist/handlers/demo.handlers.js.map                    1.65 kB │ gzip: 0.72 kB
-ℹ dist/example.js.map                                   1.51 kB │ gzip: 0.71 kB
-ℹ dist/tests/operations.test-spec.js.map                1.44 kB │ gzip: 0.61 kB
-ℹ dist/operations/index.d.ts.map                        0.52 kB │ gzip: 0.24 kB
-ℹ dist/handlers/demo.handlers.d.ts.map                  0.51 kB │ gzip: 0.27 kB
-ℹ dist/presentations/index.d.ts.map                     0.22 kB │ gzip: 0.17 kB
-ℹ dist/learning-journey-platform-tour.feature.d.ts.map  0.20 kB │ gzip: 0.16 kB
-ℹ dist/tests/operations.test-spec.d.ts.map              0.16 kB │ gzip: 0.14 kB
-ℹ dist/track.d.ts.map                                   0.14 kB │ gzip: 0.13 kB
-ℹ dist/example.d.ts.map                                 0.13 kB │ gzip: 0.13 kB
-ℹ dist/operations/index.d.ts                            8.79 kB │ gzip: 0.93 kB
-ℹ dist/handlers/demo.handlers.d.ts                      1.00 kB │ gzip: 0.43 kB
-ℹ dist/index.d.ts                                       0.99 kB │ gzip: 0.29 kB
-ℹ dist/presentations/index.d.ts                         0.54 kB │ gzip: 0.22 kB
-ℹ dist/learning-journey-platform-tour.feature.d.ts      0.49 kB │ gzip: 0.26 kB
-ℹ dist/track.d.ts                                       0.37 kB │ gzip: 0.20 kB
-ℹ dist/tests/operations.test-spec.d.ts                  0.28 kB │ gzip: 0.18 kB
-ℹ dist/example.d.ts                                     0.25 kB │ gzip: 0.17 kB
-ℹ dist/docs/index.d.ts                                  0.01 kB │ gzip: 0.03 kB
-ℹ dist/docs/platform-tour.docblock.d.ts                 0.01 kB │ gzip: 0.03 kB
-ℹ 35 files, total: 52.83 kB
-[PLUGIN_TIMINGS] Warning: Your build spent significant time in plugins. Here is a breakdown:
-  - rolldown-plugin-dts:generate (58%)
-  - tsdown:external (37%)
-See https://rolldown.rs/options/checks#plugintimings for more details.
+$ contractspec-bun-build prebuild
+$ bun run prebuild && bun run build:bundle && bun run build:types
+$ contractspec-bun-build prebuild
+$ contractspec-bun-build transpile
+[contractspec-bun-build] transpile target=bun root=src entries=10
+Bundled 10 modules in 47ms
 
-✔ Build complete in 26592ms
+  docs/index.js                                 1.60 KB   (entry point)
+  tests/operations.test-spec.js                 0.90 KB   (entry point)
+  ./index.js                                    13.39 KB  (entry point)
+  docs/platform-tour.docblock.js                1.60 KB   (entry point)
+  ./example.js                                  1.0 KB    (entry point)
+  handlers/demo.handlers.js                     3.71 KB   (entry point)
+  ./learning-journey-platform-tour.feature.js   1.51 KB   (entry point)
+  presentations/index.js                        8.43 KB   (entry point)
+  operations/index.js                           7.14 KB   (entry point)
+  ./track.js                                    3.1 KB    (entry point)
+
+[contractspec-bun-build] transpile target=node root=src entries=10
+Bundled 10 modules in 14ms
+
+  docs/index.js                                 1.57 KB   (entry point)
+  tests/operations.test-spec.js                 0.89 KB   (entry point)
+  ./index.js                                    13.36 KB  (entry point)
+  docs/platform-tour.docblock.js                1.57 KB   (entry point)
+  ./example.js                                  1.0 KB    (entry point)
+  handlers/demo.handlers.js                     3.71 KB   (entry point)
+  ./learning-journey-platform-tour.feature.js   1.50 KB   (entry point)
+  presentations/index.js                        8.42 KB   (entry point)
+  operations/index.js                           7.13 KB   (entry point)
+  ./track.js                                    3.1 KB    (entry point)
+
+[contractspec-bun-build] transpile target=browser root=src entries=10
+Bundled 10 modules in 33ms
+
+  docs/index.js                                 1.57 KB   (entry point)
+  tests/operations.test-spec.js                 0.89 KB   (entry point)
+  ./index.js                                    13.36 KB  (entry point)
+  docs/platform-tour.docblock.js                1.57 KB   (entry point)
+  ./example.js                                  1.0 KB    (entry point)
+  handlers/demo.handlers.js                     3.71 KB   (entry point)
+  ./learning-journey-platform-tour.feature.js   1.50 KB   (entry point)
+  presentations/index.js                        8.42 KB   (entry point)
+  operations/index.js                           7.13 KB   (entry point)
+  ./track.js                                    3.1 KB    (entry point)
+
+$ contractspec-bun-build types

package/.turbo/turbo-prebuild.log

@@ -0,0 +1 @@
+$ contractspec-bun-build prebuild

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @contractspec/example.learning-journey-platform-tour
 
+## 1.58.0
+
+### Minor Changes
+
+- d1f0fd0: chore: Migrate non-app package builds from tsdown to shared Bun tooling, add `@contractspec/tool.bun`, and standardize `prebuild`/`build`/`typecheck` with platform-aware exports and `tsc` declaration emission into `dist`.
+
+### Patch Changes
+
+- Updated dependencies [d1f0fd0]
+- Updated dependencies [4355a9e]
+  - @contractspec/module.learning-journey@1.58.0
+  - @contractspec/lib.contracts@1.58.0
+  - @contractspec/lib.schema@1.58.0
+
 ## 1.57.0
 
 ### Minor Changes

package/dist/browser/docs/index.js

@@ -0,0 +1,37 @@
+// src/docs/platform-tour.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var platformTourDocBlocks = [
+  {
+    id: "docs.learning-journey.platform-tour",
+    title: "Learning Journey — Platform Primitives Tour",
+    summary: "Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/learning-journey/platform-tour",
+    tags: ["learning", "platform", "onboarding"],
+    body: `## Track
+- **Key**: \`platform_primitives_tour\`
+- **Persona**: platform developer exploring primitives
+- **Goal**: Touch each cross-cutting module once, event-driven completion
+
+## Steps & Events
+1) \`identity_rbac\` → \`org.member.added\`
+2) \`event_bus_audit\` → \`audit_log.created\`
+3) \`notifications\` → \`notification.sent\`
+4) \`jobs_scheduler\` → \`job.completed\`
+5) \`feature_flags\` → \`flag.toggled\`
+6) \`files_attachments\` → \`attachment.attached\`
+7) \`usage_metering\` → \`usage.recorded\`
+
+XP: 20 per step, 20 bonus XP upon completion.
+
+## Wiring
+- Tracks export from \`@contractspec/example.learning-journey-platform-tour/track\`.
+- Use onboarding API to surface progress:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\` wired from each module's event bus handlers.
+- Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`
+  }
+];
+registerDocBlocks(platformTourDocBlocks);

package/dist/browser/docs/platform-tour.docblock.js

@@ -0,0 +1,37 @@
+// src/docs/platform-tour.docblock.ts
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+var platformTourDocBlocks = [
+  {
+    id: "docs.learning-journey.platform-tour",
+    title: "Learning Journey — Platform Primitives Tour",
+    summary: "Cross-module tour that touches identity, audit, notifications, jobs, feature flags, files, and metering.",
+    kind: "reference",
+    visibility: "public",
+    route: "/docs/learning-journey/platform-tour",
+    tags: ["learning", "platform", "onboarding"],
+    body: `## Track
+- **Key**: \`platform_primitives_tour\`
+- **Persona**: platform developer exploring primitives
+- **Goal**: Touch each cross-cutting module once, event-driven completion
+
+## Steps & Events
+1) \`identity_rbac\` → \`org.member.added\`
+2) \`event_bus_audit\` → \`audit_log.created\`
+3) \`notifications\` → \`notification.sent\`
+4) \`jobs_scheduler\` → \`job.completed\`
+5) \`feature_flags\` → \`flag.toggled\`
+6) \`files_attachments\` → \`attachment.attached\`
+7) \`usage_metering\` → \`usage.recorded\`
+
+XP: 20 per step, 20 bonus XP upon completion.
+
+## Wiring
+- Tracks export from \`@contractspec/example.learning-journey-platform-tour/track\`.
+- Use onboarding API to surface progress:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\` wired from each module's event bus handlers.
+- Align event payloads with modules: identity-rbac, audit-trail, notifications, jobs, feature-flags, files, metering.`
+  }
+];
+registerDocBlocks(platformTourDocBlocks);

package/dist/browser/example.js

@@ -0,0 +1,34 @@
+// src/example.ts
+import { defineExample } from "@contractspec/lib.contracts";
+var example = defineExample({
+  meta: {
+    key: "learning-journey-platform-tour",
+    version: "1.0.0",
+    title: "Learning Journey — Platform Tour",
+    description: "Learning journey track + contracts + presentations for a platform tour.",
+    kind: "template",
+    visibility: "public",
+    stability: "experimental",
+    owners: ["@platform.core"],
+    tags: ["learning", "journey", "platform-tour"]
+  },
+  docs: {
+    rootDocId: "docs.examples.platform-tour",
+    goalDocId: "docs.examples.platform-tour.goal",
+    usageDocId: "docs.examples.platform-tour.usage"
+  },
+  entrypoints: {
+    packageName: "@contractspec/example.learning-journey-platform-tour",
+    docs: "./docs"
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ["markdown", "playground"] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true }
+  }
+});
+var example_default = example;
+export {
+  example_default as default
+};

package/dist/browser/handlers/demo.handlers.js

@@ -0,0 +1,130 @@
+// src/track.ts
+var platformPrimitivesTourTrack = {
+  id: "platform_primitives_tour",
+  productId: "contractspec-platform",
+  name: "Platform Primitives Tour",
+  description: "Hands-on tour across identity, audit, notifications, jobs, flags, files, and metering.",
+  targetUserSegment: "platform_developer",
+  targetRole: "developer",
+  totalXp: 140,
+  completionRewards: { xpBonus: 20, badgeKey: "platform_primitives" },
+  steps: [
+    {
+      id: "identity_rbac",
+      title: "Create org and member",
+      description: "Create an org and add at least one member.",
+      order: 1,
+      completion: {
+        eventName: "org.member.added",
+        sourceModule: "@contractspec/lib.identity-rbac"
+      },
+      xpReward: 20,
+      metadata: { surface: "identity" }
+    },
+    {
+      id: "event_bus_audit",
+      title: "Emit an auditable event",
+      description: "Emit an event that lands in the audit log.",
+      order: 2,
+      completion: {
+        eventName: "audit_log.created",
+        sourceModule: "@contractspec/module.audit-trail"
+      },
+      xpReward: 20,
+      metadata: { surface: "bus+audit" }
+    },
+    {
+      id: "notifications",
+      title: "Send a notification",
+      description: "Send yourself a notification and verify delivery.",
+      order: 3,
+      completion: {
+        eventName: "notification.sent",
+        sourceModule: "@contractspec/module.notifications"
+      },
+      xpReward: 20,
+      metadata: { surface: "notifications" }
+    },
+    {
+      id: "jobs_scheduler",
+      title: "Schedule and run a job",
+      description: "Schedule a background job and let it run once.",
+      order: 4,
+      completion: {
+        eventName: "job.completed",
+        sourceModule: "@contractspec/lib.jobs"
+      },
+      xpReward: 20,
+      metadata: { surface: "jobs" }
+    },
+    {
+      id: "feature_flags",
+      title: "Create and toggle a feature flag",
+      description: "Create a feature flag and toggle it at least once.",
+      order: 5,
+      completion: {
+        eventName: "flag.toggled",
+        sourceModule: "@contractspec/lib.feature-flags"
+      },
+      xpReward: 20,
+      metadata: { surface: "feature-flags" }
+    },
+    {
+      id: "files_attachments",
+      title: "Attach a file",
+      description: "Upload and attach a file to any entity.",
+      order: 6,
+      completion: {
+        eventName: "attachment.attached",
+        sourceModule: "@contractspec/lib.files"
+      },
+      xpReward: 20,
+      metadata: { surface: "files" }
+    },
+    {
+      id: "usage_metering",
+      title: "Record usage",
+      description: "Emit a usage metric (regeneration, agent run, or similar).",
+      order: 7,
+      completion: {
+        eventName: "usage.recorded",
+        sourceModule: "@contractspec/lib.metering"
+      },
+      xpReward: 20,
+      metadata: { surface: "metering" }
+    }
+  ],
+  metadata: {
+    surfacedIn: ["studio/learning", "platform/dev-center"]
+  }
+};
+var platformLearningTracks = [
+  platformPrimitivesTourTrack
+];
+
+// src/handlers/demo.handlers.ts
+var platformTourEvents = [
+  "org.member.added",
+  "audit_log.created",
+  "notification.sent",
+  "job.completed",
+  "flag.toggled",
+  "attachment.attached",
+  "usage.recorded"
+];
+var emitPlatformTourEvent = (eventName, { learnerId, occurredAt = new Date, payload }, record) => {
+  const event = {
+    learnerId,
+    name: eventName,
+    occurredAt,
+    payload,
+    trackId: platformPrimitivesTourTrack.id
+  };
+  return record ? record(event) : event;
+};
+var emitAllPlatformTourEvents = (params, record) => platformTourEvents.map((name) => emitPlatformTourEvent(name, params, record));
+export {
+  platformTourEvents,
+  emitPlatformTourEvent,
+  emitAllPlatformTourEvents
+};