@contractspec/example.learning-journey-platform-tour 3.7.17 → 3.7.18

package/dist/node/handlers/demo.handlers.js

@@ -1,130 +1 @@
-// 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
-};
+var r={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"]}},s=[r];var c=["org.member.added","audit_log.created","notification.sent","job.completed","flag.toggled","attachment.attached","usage.recorded"],d=(e,{learnerId:t,occurredAt:a=new Date,payload:i},o)=>{let n={learnerId:t,name:e,occurredAt:a,payload:i,trackId:r.id};return o?o(n):n},u=(e,t)=>c.map((a)=>d(a,e,t));export{c as platformTourEvents,d as emitPlatformTourEvent,u as emitAllPlatformTourEvents};

package/dist/node/index.js

@@ -1,416 +1 @@
-// src/docs/platform-tour.docblock.ts
-import { registerDocBlocks } from "@contractspec/lib.contracts-spec/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);
-// src/example.ts
-import { defineExample } from "@contractspec/lib.contracts-spec";
-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;
-
-// 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));
-
-// src/learning-journey-platform-tour.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyPlatformTourFeature = defineFeature({
-  meta: {
-    key: "learning-journey-platform-tour",
-    version: "1.0.0",
-    title: "Learning Journey: Platform Tour",
-    description: "Platform primitives tour journey for exploring ContractSpec core features",
-    domain: "learning-journey",
-    owners: ["@examples.learning-journey.platform-tour"],
-    tags: ["learning", "platform", "tour", "journey"],
-    stability: "experimental"
-  },
-  operations: [
-    { key: "learningJourney.platformTour.recordEvent", version: "1.0.0" },
-    { key: "learningJourney.platformTour.getTrack", version: "1.0.0" }
-  ],
-  events: [],
-  presentations: [
-    { key: "learning.journey.platform.track", version: "1.0.0" },
-    { key: "learning.journey.platform.widget", version: "1.0.0" }
-  ],
-  opToPresentation: [
-    {
-      op: { key: "learningJourney.platformTour.getTrack", version: "1.0.0" },
-      pres: { key: "learning.journey.platform.track", version: "1.0.0" }
-    }
-  ],
-  presentationsTargets: [
-    {
-      key: "learning.journey.platform.track",
-      version: "1.0.0",
-      targets: ["react", "markdown", "application/json"]
-    },
-    {
-      key: "learning.journey.platform.widget",
-      version: "1.0.0",
-      targets: ["react"]
-    }
-  ],
-  capabilities: {
-    requires: [{ key: "identity", version: "1.0.0" }]
-  },
-  docs: ["docs.learning-journey.platform-tour"]
-});
-
-// src/operations/index.ts
-import { defineCommand, defineQuery } from "@contractspec/lib.contracts-spec";
-import { defineSchemaModel, ScalarTypeEnum } from "@contractspec/lib.schema";
-var OWNERS = ["examples.learning-journey.platform-tour"];
-var StepModel = defineSchemaModel({
-  name: "PlatformTourStep",
-  description: "Step metadata for platform primitives tour",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    completionEvent: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: false
-    },
-    sourceModule: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    xpReward: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    order: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true }
-  }
-});
-var PlatformTourTrackModel = defineSchemaModel({
-  name: "PlatformTourTrack",
-  description: "Platform primitives tour track definition",
-  fields: {
-    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },
-    totalXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    completionXpBonus: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    completionBadgeKey: {
-      type: ScalarTypeEnum.String_unsecure(),
-      isOptional: true
-    },
-    streakHoursWindow: {
-      type: ScalarTypeEnum.Int_unsecure(),
-      isOptional: true
-    },
-    streakBonusXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },
-    steps: { type: StepModel, isArray: true, isOptional: false }
-  }
-});
-var TrackResponseModel = defineSchemaModel({
-  name: "PlatformTourTrackResponse",
-  description: "Response wrapper for platform tour track",
-  fields: {
-    track: { type: PlatformTourTrackModel, isOptional: false }
-  }
-});
-var RecordDemoEventInput = defineSchemaModel({
-  name: "PlatformTourRecordEventInput",
-  description: "Emit a demo event to advance platform tour steps",
-  fields: {
-    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    eventName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },
-    payload: { type: ScalarTypeEnum.JSON(), isOptional: true },
-    occurredAt: { type: ScalarTypeEnum.DateTime(), isOptional: true }
-  }
-});
-var SuccessModel = defineSchemaModel({
-  name: "PlatformTourSuccess",
-  description: "Generic success response",
-  fields: {
-    success: { type: ScalarTypeEnum.Boolean(), isOptional: false }
-  }
-});
-var GetPlatformTourTrack = defineQuery({
-  meta: {
-    key: "learningJourney.platformTour.getTrack",
-    version: "1.0.0",
-    stability: "experimental",
-    owners: [...OWNERS],
-    tags: ["learning", "platform", "tour"],
-    description: "Fetch platform primitives tour track definition.",
-    goal: "Expose track metadata to UIs and templates.",
-    context: "Called by Studio/Playground to render journey steps."
-  },
-  io: {
-    input: defineSchemaModel({
-      name: "PlatformTourTrackInput",
-      description: "Track input",
-      fields: {}
-    }),
-    output: TrackResponseModel
-  },
-  policy: { auth: "user" }
-});
-var RecordPlatformTourEvent = defineCommand({
-  meta: {
-    key: "learningJourney.platformTour.recordEvent",
-    version: "1.0.0",
-    stability: "experimental",
-    owners: [...OWNERS],
-    tags: ["learning", "platform", "tour"],
-    description: "Record an event to advance platform tour progress.",
-    goal: "Advance steps via domain events in demo/sandbox contexts.",
-    context: "Called by handlers or demo scripts to emit step completion events."
-  },
-  io: {
-    input: RecordDemoEventInput,
-    output: SuccessModel
-  },
-  policy: { auth: "user" }
-});
-var platformTourContracts = {
-  GetPlatformTourTrack,
-  RecordPlatformTourEvent,
-  track: platformPrimitivesTourTrack
-};
-
-// src/presentations/index.ts
-import {
-  definePresentation,
-  StabilityEnum
-} from "@contractspec/lib.contracts-spec";
-var baseMeta = {
-  domain: "learning-journey",
-  title: "Platform Tour",
-  owners: ["@examples.learning-journey.platform-tour"],
-  tags: ["learning", "platform", "tour"],
-  stability: StabilityEnum.Experimental,
-  goal: "Visualize platform tour progress",
-  context: "Used in platform tour dashboard and widgets"
-};
-var PlatformTourTrackPresentation = definePresentation({
-  meta: {
-    key: "learning.journey.platform.track",
-    version: "1.0.0",
-    description: "Platform primitives tour track detail",
-    ...baseMeta
-  },
-  source: {
-    type: "component",
-    framework: "react",
-    componentKey: "LearningTrackDetail",
-    props: PlatformTourTrackModel
-  },
-  targets: ["react", "markdown", "application/json"]
-});
-var PlatformTourWidgetPresentation = definePresentation({
-  meta: {
-    key: "learning.journey.platform.widget",
-    version: "1.0.0",
-    description: "Compact widget for platform tour progress",
-    ...baseMeta
-  },
-  source: {
-    type: "component",
-    framework: "react",
-    componentKey: "LearningTrackProgressWidget"
-  },
-  targets: ["react"]
-});
-var platformTourPresentations = [
-  PlatformTourTrackPresentation,
-  PlatformTourWidgetPresentation
-];
-export {
-  platformTourPresentations,
-  platformTourEvents,
-  platformTourContracts,
-  platformPrimitivesTourTrack,
-  platformLearningTracks,
-  example_default as example,
-  emitPlatformTourEvent,
-  emitAllPlatformTourEvents,
-  RecordPlatformTourEvent,
-  PlatformTourWidgetPresentation,
-  PlatformTourTrackPresentation,
-  PlatformTourTrackModel,
-  LearningJourneyPlatformTourFeature,
-  GetPlatformTourTrack
-};
+import{registerDocBlocks as l}from"@contractspec/lib.contracts-spec/docs";var f=[{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\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."}];l(f);import{defineExample as p}from"@contractspec/lib.contracts-spec";var v=p({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:!0,sandbox:{enabled:!0,modes:["markdown","playground"]},studio:{enabled:!0,installable:!0},mcp:{enabled:!0}}}),b=v;var r={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"]}},y=[r];var _=["org.member.added","audit_log.created","notification.sent","job.completed","flag.toggled","attachment.attached","usage.recorded"],w=(a,{learnerId:i,occurredAt:o=new Date,payload:u},d)=>{let s={learnerId:i,name:a,occurredAt:o,payload:u,trackId:r.id};return d?d(s):s},P=(a,i)=>_.map((o)=>w(o,a,i));import{defineFeature as x}from"@contractspec/lib.contracts-spec";var Z=x({meta:{key:"learning-journey-platform-tour",version:"1.0.0",title:"Learning Journey: Platform Tour",description:"Platform primitives tour journey for exploring ContractSpec core features",domain:"learning-journey",owners:["@examples.learning-journey.platform-tour"],tags:["learning","platform","tour","journey"],stability:"experimental"},operations:[{key:"learningJourney.platformTour.recordEvent",version:"1.0.0"},{key:"learningJourney.platformTour.getTrack",version:"1.0.0"}],events:[],presentations:[{key:"learning.journey.platform.track",version:"1.0.0"},{key:"learning.journey.platform.widget",version:"1.0.0"}],opToPresentation:[{op:{key:"learningJourney.platformTour.getTrack",version:"1.0.0"},pres:{key:"learning.journey.platform.track",version:"1.0.0"}}],presentationsTargets:[{key:"learning.journey.platform.track",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"learning.journey.platform.widget",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"}]},docs:["docs.learning-journey.platform-tour"]});import{defineCommand as R,defineQuery as j}from"@contractspec/lib.contracts-spec";import{defineSchemaModel as e,ScalarTypeEnum as t}from"@contractspec/lib.schema";var g=["examples.learning-journey.platform-tour"],L=e({name:"PlatformTourStep",description:"Step metadata for platform primitives tour",fields:{id:{type:t.String_unsecure(),isOptional:!1},title:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},completionEvent:{type:t.String_unsecure(),isOptional:!1},sourceModule:{type:t.String_unsecure(),isOptional:!0},xpReward:{type:t.Int_unsecure(),isOptional:!0},order:{type:t.Int_unsecure(),isOptional:!0}}}),n=e({name:"PlatformTourTrack",description:"Platform primitives tour track definition",fields:{id:{type:t.String_unsecure(),isOptional:!1},name:{type:t.String_unsecure(),isOptional:!1},description:{type:t.String_unsecure(),isOptional:!0},totalXp:{type:t.Int_unsecure(),isOptional:!0},completionXpBonus:{type:t.Int_unsecure(),isOptional:!0},completionBadgeKey:{type:t.String_unsecure(),isOptional:!0},streakHoursWindow:{type:t.Int_unsecure(),isOptional:!0},streakBonusXp:{type:t.Int_unsecure(),isOptional:!0},steps:{type:L,isArray:!0,isOptional:!1}}}),J=e({name:"PlatformTourTrackResponse",description:"Response wrapper for platform tour track",fields:{track:{type:n,isOptional:!1}}}),h=e({name:"PlatformTourRecordEventInput",description:"Emit a demo event to advance platform tour steps",fields:{learnerId:{type:t.String_unsecure(),isOptional:!1},eventName:{type:t.String_unsecure(),isOptional:!1},payload:{type:t.JSON(),isOptional:!0},occurredAt:{type:t.DateTime(),isOptional:!0}}}),I=e({name:"PlatformTourSuccess",description:"Generic success response",fields:{success:{type:t.Boolean(),isOptional:!1}}}),N=j({meta:{key:"learningJourney.platformTour.getTrack",version:"1.0.0",stability:"experimental",owners:[...g],tags:["learning","platform","tour"],description:"Fetch platform primitives tour track definition.",goal:"Expose track metadata to UIs and templates.",context:"Called by Studio/Playground to render journey steps."},io:{input:e({name:"PlatformTourTrackInput",description:"Track input",fields:{}}),output:J},policy:{auth:"user"}}),A=R({meta:{key:"learningJourney.platformTour.recordEvent",version:"1.0.0",stability:"experimental",owners:[...g],tags:["learning","platform","tour"],description:"Record an event to advance platform tour progress.",goal:"Advance steps via domain events in demo/sandbox contexts.",context:"Called by handlers or demo scripts to emit step completion events."},io:{input:h,output:I},policy:{auth:"user"}}),Q={GetPlatformTourTrack:N,RecordPlatformTourEvent:A,track:r};import{definePresentation as c,StabilityEnum as k}from"@contractspec/lib.contracts-spec";var m={domain:"learning-journey",title:"Platform Tour",owners:["@examples.learning-journey.platform-tour"],tags:["learning","platform","tour"],stability:k.Experimental,goal:"Visualize platform tour progress",context:"Used in platform tour dashboard and widgets"},C=c({meta:{key:"learning.journey.platform.track",version:"1.0.0",description:"Platform primitives tour track detail",...m},source:{type:"component",framework:"react",componentKey:"LearningTrackDetail",props:n},targets:["react","markdown","application/json"]}),U=c({meta:{key:"learning.journey.platform.widget",version:"1.0.0",description:"Compact widget for platform tour progress",...m},source:{type:"component",framework:"react",componentKey:"LearningTrackProgressWidget"},targets:["react"]}),E=[C,U];export{E as platformTourPresentations,_ as platformTourEvents,Q as platformTourContracts,r as platformPrimitivesTourTrack,y as platformLearningTracks,b as example,w as emitPlatformTourEvent,P as emitAllPlatformTourEvents,A as RecordPlatformTourEvent,U as PlatformTourWidgetPresentation,C as PlatformTourTrackPresentation,n as PlatformTourTrackModel,Z as LearningJourneyPlatformTourFeature,N as GetPlatformTourTrack};

package/dist/node/learning-journey-platform-tour.feature.js

@@ -1,48 +1 @@
-// src/learning-journey-platform-tour.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var LearningJourneyPlatformTourFeature = defineFeature({
-  meta: {
-    key: "learning-journey-platform-tour",
-    version: "1.0.0",
-    title: "Learning Journey: Platform Tour",
-    description: "Platform primitives tour journey for exploring ContractSpec core features",
-    domain: "learning-journey",
-    owners: ["@examples.learning-journey.platform-tour"],
-    tags: ["learning", "platform", "tour", "journey"],
-    stability: "experimental"
-  },
-  operations: [
-    { key: "learningJourney.platformTour.recordEvent", version: "1.0.0" },
-    { key: "learningJourney.platformTour.getTrack", version: "1.0.0" }
-  ],
-  events: [],
-  presentations: [
-    { key: "learning.journey.platform.track", version: "1.0.0" },
-    { key: "learning.journey.platform.widget", version: "1.0.0" }
-  ],
-  opToPresentation: [
-    {
-      op: { key: "learningJourney.platformTour.getTrack", version: "1.0.0" },
-      pres: { key: "learning.journey.platform.track", version: "1.0.0" }
-    }
-  ],
-  presentationsTargets: [
-    {
-      key: "learning.journey.platform.track",
-      version: "1.0.0",
-      targets: ["react", "markdown", "application/json"]
-    },
-    {
-      key: "learning.journey.platform.widget",
-      version: "1.0.0",
-      targets: ["react"]
-    }
-  ],
-  capabilities: {
-    requires: [{ key: "identity", version: "1.0.0" }]
-  },
-  docs: ["docs.learning-journey.platform-tour"]
-});
-export {
-  LearningJourneyPlatformTourFeature
-};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"learning-journey-platform-tour",version:"1.0.0",title:"Learning Journey: Platform Tour",description:"Platform primitives tour journey for exploring ContractSpec core features",domain:"learning-journey",owners:["@examples.learning-journey.platform-tour"],tags:["learning","platform","tour","journey"],stability:"experimental"},operations:[{key:"learningJourney.platformTour.recordEvent",version:"1.0.0"},{key:"learningJourney.platformTour.getTrack",version:"1.0.0"}],events:[],presentations:[{key:"learning.journey.platform.track",version:"1.0.0"},{key:"learning.journey.platform.widget",version:"1.0.0"}],opToPresentation:[{op:{key:"learningJourney.platformTour.getTrack",version:"1.0.0"},pres:{key:"learning.journey.platform.track",version:"1.0.0"}}],presentationsTargets:[{key:"learning.journey.platform.track",version:"1.0.0",targets:["react","markdown","application/json"]},{key:"learning.journey.platform.widget",version:"1.0.0",targets:["react"]}],capabilities:{requires:[{key:"identity",version:"1.0.0"}]},docs:["docs.learning-journey.platform-tour"]});export{j as LearningJourneyPlatformTourFeature};