@contractspec/example.learning-journey-platform-tour 1.44.0

package/dist/operations/index.d.ts

@@ -0,0 +1,271 @@
+import * as _contractspec_lib_schema0 from "@contractspec/lib.schema";
+import * as _contractspec_lib_contracts0 from "@contractspec/lib.contracts";
+import * as _contractspec_module_learning_journey_track_spec0 from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/operations/index.d.ts
+declare const PlatformTourTrackModel: _contractspec_lib_schema0.SchemaModel<{
+  id: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  name: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  description: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  totalXp: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  completionXpBonus: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  completionBadgeKey: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: true;
+  };
+  streakHoursWindow: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  streakBonusXp: {
+    type: _contractspec_lib_schema0.FieldType<number, number>;
+    isOptional: true;
+  };
+  steps: {
+    type: _contractspec_lib_schema0.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      title: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      description: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      completionEvent: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      sourceModule: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      xpReward: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      order: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+    }>;
+    isArray: true;
+    isOptional: false;
+  };
+}>;
+declare const GetPlatformTourTrack: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{}>, _contractspec_lib_schema0.SchemaModel<{
+  track: {
+    type: _contractspec_lib_schema0.SchemaModel<{
+      id: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      name: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: false;
+      };
+      description: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      totalXp: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      completionXpBonus: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      completionBadgeKey: {
+        type: _contractspec_lib_schema0.FieldType<string, string>;
+        isOptional: true;
+      };
+      streakHoursWindow: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      streakBonusXp: {
+        type: _contractspec_lib_schema0.FieldType<number, number>;
+        isOptional: true;
+      };
+      steps: {
+        type: _contractspec_lib_schema0.SchemaModel<{
+          id: {
+            type: _contractspec_lib_schema0.FieldType<string, string>;
+            isOptional: false;
+          };
+          title: {
+            type: _contractspec_lib_schema0.FieldType<string, string>;
+            isOptional: false;
+          };
+          description: {
+            type: _contractspec_lib_schema0.FieldType<string, string>;
+            isOptional: true;
+          };
+          completionEvent: {
+            type: _contractspec_lib_schema0.FieldType<string, string>;
+            isOptional: false;
+          };
+          sourceModule: {
+            type: _contractspec_lib_schema0.FieldType<string, string>;
+            isOptional: true;
+          };
+          xpReward: {
+            type: _contractspec_lib_schema0.FieldType<number, number>;
+            isOptional: true;
+          };
+          order: {
+            type: _contractspec_lib_schema0.FieldType<number, number>;
+            isOptional: true;
+          };
+        }>;
+        isArray: true;
+        isOptional: false;
+      };
+    }>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const RecordPlatformTourEvent: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+  learnerId: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  eventName: {
+    type: _contractspec_lib_schema0.FieldType<string, string>;
+    isOptional: false;
+  };
+  payload: {
+    type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
+    isOptional: true;
+  };
+  occurredAt: {
+    type: _contractspec_lib_schema0.FieldType<Date, string>;
+    isOptional: true;
+  };
+}>, _contractspec_lib_schema0.SchemaModel<{
+  success: {
+    type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+    isOptional: false;
+  };
+}>, undefined>;
+declare const platformTourContracts: {
+  GetPlatformTourTrack: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{}>, _contractspec_lib_schema0.SchemaModel<{
+    track: {
+      type: _contractspec_lib_schema0.SchemaModel<{
+        id: {
+          type: _contractspec_lib_schema0.FieldType<string, string>;
+          isOptional: false;
+        };
+        name: {
+          type: _contractspec_lib_schema0.FieldType<string, string>;
+          isOptional: false;
+        };
+        description: {
+          type: _contractspec_lib_schema0.FieldType<string, string>;
+          isOptional: true;
+        };
+        totalXp: {
+          type: _contractspec_lib_schema0.FieldType<number, number>;
+          isOptional: true;
+        };
+        completionXpBonus: {
+          type: _contractspec_lib_schema0.FieldType<number, number>;
+          isOptional: true;
+        };
+        completionBadgeKey: {
+          type: _contractspec_lib_schema0.FieldType<string, string>;
+          isOptional: true;
+        };
+        streakHoursWindow: {
+          type: _contractspec_lib_schema0.FieldType<number, number>;
+          isOptional: true;
+        };
+        streakBonusXp: {
+          type: _contractspec_lib_schema0.FieldType<number, number>;
+          isOptional: true;
+        };
+        steps: {
+          type: _contractspec_lib_schema0.SchemaModel<{
+            id: {
+              type: _contractspec_lib_schema0.FieldType<string, string>;
+              isOptional: false;
+            };
+            title: {
+              type: _contractspec_lib_schema0.FieldType<string, string>;
+              isOptional: false;
+            };
+            description: {
+              type: _contractspec_lib_schema0.FieldType<string, string>;
+              isOptional: true;
+            };
+            completionEvent: {
+              type: _contractspec_lib_schema0.FieldType<string, string>;
+              isOptional: false;
+            };
+            sourceModule: {
+              type: _contractspec_lib_schema0.FieldType<string, string>;
+              isOptional: true;
+            };
+            xpReward: {
+              type: _contractspec_lib_schema0.FieldType<number, number>;
+              isOptional: true;
+            };
+            order: {
+              type: _contractspec_lib_schema0.FieldType<number, number>;
+              isOptional: true;
+            };
+          }>;
+          isArray: true;
+          isOptional: false;
+        };
+      }>;
+      isOptional: false;
+    };
+  }>, undefined>;
+  RecordPlatformTourEvent: _contractspec_lib_contracts0.OperationSpec<_contractspec_lib_schema0.SchemaModel<{
+    learnerId: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    eventName: {
+      type: _contractspec_lib_schema0.FieldType<string, string>;
+      isOptional: false;
+    };
+    payload: {
+      type: _contractspec_lib_schema0.FieldType<unknown, unknown>;
+      isOptional: true;
+    };
+    occurredAt: {
+      type: _contractspec_lib_schema0.FieldType<Date, string>;
+      isOptional: true;
+    };
+  }>, _contractspec_lib_schema0.SchemaModel<{
+    success: {
+      type: _contractspec_lib_schema0.FieldType<boolean, boolean>;
+      isOptional: false;
+    };
+  }>, undefined>;
+  track: _contractspec_module_learning_journey_track_spec0.LearningJourneyTrackSpec;
+};
+//#endregion
+export { GetPlatformTourTrack, PlatformTourTrackModel, RecordPlatformTourEvent, platformTourContracts };
+//# sourceMappingURL=index.d.ts.map

package/dist/operations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/operations/index.ts"],"sourcesContent":[],"mappings":";;;;;cAwBa,kDAAsB;;UAuBjC,yBAAA,CAAA;;;EAvBW,IAAA,EAAA;IAuBX,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;6CAvBiC,CAAA,MAAA,EAAA,MAAA,CAAA;IAAA,UAAA,EAAA,IAAA;EAoDtB,CAAA;EAoBX,iBAAA,EAAA;IApB+B,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;;;;;;;;;;;;;;;;;;QAAA,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,IAAA;MAsBpB,CAAA;MAiBX,eAAA,EAAA;;;;;iDAjBkC,CAAA,MAAA,EAAA,MAAA,CAAA;QAAA,UAAA,EAAA,IAAA;;;QAAA,IAAA,qCAAA,CAAA,MAAA,EAAA,MAAA,CAAA;QAmBvB,UAAA,EAIZ,IAAA;MAAA,CAAA;;;;;;;;;;cA7CY,sBAAoB,4BAAA,CAAA,cAoB/B,yBAAA,CApB+B,2CAAA;;;;cAAA,yBAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAsBpB,sDAAuB,wCAAA;;UAiBlC,yBAAA,CAAA;;;;;;;;;;;;;;;;;UAjBkC,yBAAA,CAAA;;;;cAmBvB;mEAIZ,yBAAA,CAAA"}

package/dist/operations/index.js

@@ -0,0 +1,176 @@
+import { platformPrimitivesTourTrack } from "../track.js";
+import { ScalarTypeEnum, defineSchemaModel } from "@contractspec/lib.schema";
+import { defineCommand, defineQuery } from "@contractspec/lib.contracts";
+
+//#region src/operations/index.ts
+const OWNERS = ["examples.learning-journey.platform-tour"];
+const 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
+		}
+	}
+});
+const 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
+		}
+	}
+});
+const TrackResponseModel = defineSchemaModel({
+	name: "PlatformTourTrackResponse",
+	description: "Response wrapper for platform tour track",
+	fields: { track: {
+		type: PlatformTourTrackModel,
+		isOptional: false
+	} }
+});
+const 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
+		}
+	}
+});
+const SuccessModel = defineSchemaModel({
+	name: "PlatformTourSuccess",
+	description: "Generic success response",
+	fields: { success: {
+		type: ScalarTypeEnum.Boolean(),
+		isOptional: false
+	} }
+});
+const GetPlatformTourTrack = defineQuery({
+	meta: {
+		key: "learningJourney.platformTour.getTrack",
+		version: 1,
+		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" }
+});
+const RecordPlatformTourEvent = defineCommand({
+	meta: {
+		key: "learningJourney.platformTour.recordEvent",
+		version: 1,
+		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" }
+});
+const platformTourContracts = {
+	GetPlatformTourTrack,
+	RecordPlatformTourEvent,
+	track: platformPrimitivesTourTrack
+};
+
+//#endregion
+export { GetPlatformTourTrack, PlatformTourTrackModel, RecordPlatformTourEvent, platformTourContracts };
+//# sourceMappingURL=index.js.map

package/dist/operations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/operations/index.ts"],"sourcesContent":["import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\nimport { defineCommand, defineQuery } from '@contractspec/lib.contracts';\n\nimport { platformPrimitivesTourTrack } from '../track';\n\nconst OWNERS = ['examples.learning-journey.platform-tour'] as const;\n\nconst StepModel = defineSchemaModel({\n  name: 'PlatformTourStep',\n  description: 'Step metadata for platform primitives tour',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    title: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    completionEvent: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    sourceModule: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    xpReward: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    order: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\nexport const PlatformTourTrackModel = defineSchemaModel({\n  name: 'PlatformTourTrack',\n  description: 'Platform primitives tour track definition',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    totalXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    completionXpBonus: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    completionBadgeKey: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    streakHoursWindow: {\n      type: ScalarTypeEnum.Int_unsecure(),\n      isOptional: true,\n    },\n    streakBonusXp: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    steps: { type: StepModel, isArray: true, isOptional: false },\n  },\n});\n\nconst TrackResponseModel = defineSchemaModel({\n  name: 'PlatformTourTrackResponse',\n  description: 'Response wrapper for platform tour track',\n  fields: {\n    track: { type: PlatformTourTrackModel, isOptional: false },\n  },\n});\n\nconst RecordDemoEventInput = defineSchemaModel({\n  name: 'PlatformTourRecordEventInput',\n  description: 'Emit a demo event to advance platform tour steps',\n  fields: {\n    learnerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    eventName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    payload: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    occurredAt: { type: ScalarTypeEnum.DateTime(), isOptional: true },\n  },\n});\n\nconst SuccessModel = defineSchemaModel({\n  name: 'PlatformTourSuccess',\n  description: 'Generic success response',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n  },\n});\n\nexport const GetPlatformTourTrack = defineQuery({\n  meta: {\n    key: 'learningJourney.platformTour.getTrack',\n    version: 1,\n    stability: 'experimental',\n    owners: [...OWNERS],\n    tags: ['learning', 'platform', 'tour'],\n    description: 'Fetch platform primitives tour track definition.',\n    goal: 'Expose track metadata to UIs and templates.',\n    context: 'Called by Studio/Playground to render journey steps.',\n  },\n  io: {\n    input: defineSchemaModel({\n      name: 'PlatformTourTrackInput',\n      description: 'Track input',\n      fields: {},\n    }),\n    output: TrackResponseModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const RecordPlatformTourEvent = defineCommand({\n  meta: {\n    key: 'learningJourney.platformTour.recordEvent',\n    version: 1,\n    stability: 'experimental',\n    owners: [...OWNERS],\n    tags: ['learning', 'platform', 'tour'],\n    description: 'Record an event to advance platform tour progress.',\n    goal: 'Advance steps via domain events in demo/sandbox contexts.',\n    context:\n      'Called by handlers or demo scripts to emit step completion events.',\n  },\n  io: {\n    input: RecordDemoEventInput,\n    output: SuccessModel,\n  },\n  policy: { auth: 'user' },\n});\n\nexport const platformTourContracts = {\n  GetPlatformTourTrack,\n  RecordPlatformTourEvent,\n  track: platformPrimitivesTourTrack,\n};\n"],"mappings":";;;;;AAKA,MAAM,SAAS,CAAC,0CAA0C;AAE1D,MAAM,YAAY,kBAAkB;CAClC,MAAM;CACN,aAAa;CACb,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,OAAO;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACpE,aAAa;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE,iBAAiB;GACf,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,cAAc;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EAC1E,UAAU;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAM;EACnE,OAAO;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAM;EACjE;CACF,CAAC;AAEF,MAAa,yBAAyB,kBAAkB;CACtD,MAAM;CACN,aAAa;CACb,QAAQ;EACN,IAAI;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACjE,MAAM;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACnE,aAAa;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAM;EACzE,SAAS;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAM;EAClE,mBAAmB;GACjB,MAAM,eAAe,cAAc;GACnC,YAAY;GACb;EACD,oBAAoB;GAClB,MAAM,eAAe,iBAAiB;GACtC,YAAY;GACb;EACD,mBAAmB;GACjB,MAAM,eAAe,cAAc;GACnC,YAAY;GACb;EACD,eAAe;GAAE,MAAM,eAAe,cAAc;GAAE,YAAY;GAAM;EACxE,OAAO;GAAE,MAAM;GAAW,SAAS;GAAM,YAAY;GAAO;EAC7D;CACF,CAAC;AAEF,MAAM,qBAAqB,kBAAkB;CAC3C,MAAM;CACN,aAAa;CACb,QAAQ,EACN,OAAO;EAAE,MAAM;EAAwB,YAAY;EAAO,EAC3D;CACF,CAAC;AAEF,MAAM,uBAAuB,kBAAkB;CAC7C,MAAM;CACN,aAAa;CACb,QAAQ;EACN,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,WAAW;GAAE,MAAM,eAAe,iBAAiB;GAAE,YAAY;GAAO;EACxE,SAAS;GAAE,MAAM,eAAe,MAAM;GAAE,YAAY;GAAM;EAC1D,YAAY;GAAE,MAAM,eAAe,UAAU;GAAE,YAAY;GAAM;EAClE;CACF,CAAC;AAEF,MAAM,eAAe,kBAAkB;CACrC,MAAM;CACN,aAAa;CACb,QAAQ,EACN,SAAS;EAAE,MAAM,eAAe,SAAS;EAAE,YAAY;EAAO,EAC/D;CACF,CAAC;AAEF,MAAa,uBAAuB,YAAY;CAC9C,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAY;GAAY;GAAO;EACtC,aAAa;EACb,MAAM;EACN,SAAS;EACV;CACD,IAAI;EACF,OAAO,kBAAkB;GACvB,MAAM;GACN,aAAa;GACb,QAAQ,EAAE;GACX,CAAC;EACF,QAAQ;EACT;CACD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC;AAEF,MAAa,0BAA0B,cAAc;CACnD,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,GAAG,OAAO;EACnB,MAAM;GAAC;GAAY;GAAY;GAAO;EACtC,aAAa;EACb,MAAM;EACN,SACE;EACH;CACD,IAAI;EACF,OAAO;EACP,QAAQ;EACT;CACD,QAAQ,EAAE,MAAM,QAAQ;CACzB,CAAC;AAEF,MAAa,wBAAwB;CACnC;CACA;CACA,OAAO;CACR"}

package/dist/presentations/index.d.ts

@@ -0,0 +1,9 @@
+import { PresentationSpec } from "@contractspec/lib.contracts";
+
+//#region src/presentations/index.d.ts
+declare const PlatformTourTrackPresentation: PresentationSpec;
+declare const PlatformTourWidgetPresentation: PresentationSpec;
+declare const platformTourPresentations: PresentationSpec[];
+//#endregion
+export { PlatformTourTrackPresentation, PlatformTourWidgetPresentation, platformTourPresentations };
+//# sourceMappingURL=index.d.ts.map

package/dist/presentations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/presentations/index.ts"],"sourcesContent":[],"mappings":";;;cAoBa,+BAA+B;cAgB/B,gCAAgC;AAhBhC,cA+BA,yBAjBZ,EAiBqC,gBAjBrC,EAAA"}

package/dist/presentations/index.js

@@ -0,0 +1,55 @@
+import { PlatformTourTrackModel } from "../operations/index.js";
+import { StabilityEnum } from "@contractspec/lib.contracts";
+
+//#region src/presentations/index.ts
+const 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"
+};
+const PlatformTourTrackPresentation = {
+	meta: {
+		key: "learning.journey.platform.track",
+		version: 1,
+		description: "Platform primitives tour track detail",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackDetail",
+		props: PlatformTourTrackModel
+	},
+	targets: [
+		"react",
+		"markdown",
+		"application/json"
+	]
+};
+const PlatformTourWidgetPresentation = {
+	meta: {
+		key: "learning.journey.platform.widget",
+		version: 1,
+		description: "Compact widget for platform tour progress",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackProgressWidget"
+	},
+	targets: ["react"]
+};
+const platformTourPresentations = [PlatformTourTrackPresentation, PlatformTourWidgetPresentation];
+
+//#endregion
+export { PlatformTourTrackPresentation, PlatformTourWidgetPresentation, platformTourPresentations };
+//# sourceMappingURL=index.js.map

package/dist/presentations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["baseMeta: Pick<\n  PresentationSpecMeta,\n  'domain' | 'owners' | 'tags' | 'title' | 'stability' | 'goal' | 'context'\n>","PlatformTourTrackPresentation: PresentationSpec","PlatformTourWidgetPresentation: PresentationSpec"],"sources":["../../src/presentations/index.ts"],"sourcesContent":["import type {\n  PresentationSpecMeta,\n  PresentationSpec,\n} from '@contractspec/lib.contracts';\nimport { StabilityEnum } from '@contractspec/lib.contracts';\nimport { PlatformTourTrackModel } from '../operations';\n\nconst baseMeta: Pick<\n  PresentationSpecMeta,\n  'domain' | 'owners' | 'tags' | 'title' | 'stability' | 'goal' | 'context'\n> = {\n  domain: 'learning-journey',\n  title: 'Platform Tour',\n  owners: ['@examples.learning-journey.platform-tour'],\n  tags: ['learning', 'platform', 'tour'],\n  stability: StabilityEnum.Experimental,\n  goal: 'Visualize platform tour progress',\n  context: 'Used in platform tour dashboard and widgets',\n};\n\nexport const PlatformTourTrackPresentation: PresentationSpec = {\n  meta: {\n    key: 'learning.journey.platform.track',\n    version: 1,\n    description: 'Platform primitives tour track detail',\n    ...baseMeta,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'LearningTrackDetail',\n    props: PlatformTourTrackModel,\n  },\n  targets: ['react', 'markdown', 'application/json'],\n};\n\nexport const PlatformTourWidgetPresentation: PresentationSpec = {\n  meta: {\n    key: 'learning.journey.platform.widget',\n    version: 1,\n    description: 'Compact widget for platform tour progress',\n    ...baseMeta,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'LearningTrackProgressWidget',\n  },\n  targets: ['react'],\n};\n\nexport const platformTourPresentations = [\n  PlatformTourTrackPresentation,\n  PlatformTourWidgetPresentation,\n];\n"],"mappings":";;;;AAOA,MAAMA,WAGF;CACF,QAAQ;CACR,OAAO;CACP,QAAQ,CAAC,2CAA2C;CACpD,MAAM;EAAC;EAAY;EAAY;EAAO;CACtC,WAAW,cAAc;CACzB,MAAM;CACN,SAAS;CACV;AAED,MAAaC,gCAAkD;CAC7D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,GAAG;EACJ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACd,OAAO;EACR;CACD,SAAS;EAAC;EAAS;EAAY;EAAmB;CACnD;AAED,MAAaC,iCAAmD;CAC9D,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,GAAG;EACJ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,QAAQ;CACnB;AAED,MAAa,4BAA4B,CACvC,+BACA,+BACD"}

package/dist/track.d.ts

@@ -0,0 +1,8 @@
+import { LearningJourneyTrackSpec } from "@contractspec/module.learning-journey/track-spec";
+
+//#region src/track.d.ts
+declare const platformPrimitivesTourTrack: LearningJourneyTrackSpec;
+declare const platformLearningTracks: LearningJourneyTrackSpec[];
+//#endregion
+export { platformLearningTracks, platformPrimitivesTourTrack };
+//# sourceMappingURL=track.d.ts.map

package/dist/track.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.d.ts","names":[],"sources":["../src/track.ts"],"sourcesContent":[],"mappings":";;;cAEa,6BAA6B;cAqG7B,wBAAwB"}

package/dist/track.js

@@ -0,0 +1,106 @@
+//#region src/track.ts
+const 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"] }
+};
+const platformLearningTracks = [platformPrimitivesTourTrack];
+
+//#endregion
+export { platformLearningTracks, platformPrimitivesTourTrack };
+//# sourceMappingURL=track.js.map

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":["platformPrimitivesTourTrack: LearningJourneyTrackSpec","platformLearningTracks: LearningJourneyTrackSpec[]"],"sources":["../src/track.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\n\nexport const platformPrimitivesTourTrack: LearningJourneyTrackSpec = {\n  id: 'platform_primitives_tour',\n  productId: 'contractspec-platform',\n  name: 'Platform Primitives Tour',\n  description:\n    'Hands-on tour across identity, audit, notifications, jobs, flags, files, and metering.',\n  targetUserSegment: 'platform_developer',\n  targetRole: 'developer',\n  totalXp: 140,\n  completionRewards: { xpBonus: 20, badgeKey: 'platform_primitives' },\n  steps: [\n    {\n      id: 'identity_rbac',\n      title: 'Create org and member',\n      description: 'Create an org and add at least one member.',\n      order: 1,\n      completion: {\n        eventName: 'org.member.added',\n        sourceModule: '@contractspec/lib.identity-rbac',\n      },\n      xpReward: 20,\n      metadata: { surface: 'identity' },\n    },\n    {\n      id: 'event_bus_audit',\n      title: 'Emit an auditable event',\n      description: 'Emit an event that lands in the audit log.',\n      order: 2,\n      completion: {\n        eventName: 'audit_log.created',\n        sourceModule: '@contractspec/module.audit-trail',\n      },\n      xpReward: 20,\n      metadata: { surface: 'bus+audit' },\n    },\n    {\n      id: 'notifications',\n      title: 'Send a notification',\n      description: 'Send yourself a notification and verify delivery.',\n      order: 3,\n      completion: {\n        eventName: 'notification.sent',\n        sourceModule: '@contractspec/module.notifications',\n      },\n      xpReward: 20,\n      metadata: { surface: 'notifications' },\n    },\n    {\n      id: 'jobs_scheduler',\n      title: 'Schedule and run a job',\n      description: 'Schedule a background job and let it run once.',\n      order: 4,\n      completion: {\n        eventName: 'job.completed',\n        sourceModule: '@contractspec/lib.jobs',\n      },\n      xpReward: 20,\n      metadata: { surface: 'jobs' },\n    },\n    {\n      id: 'feature_flags',\n      title: 'Create and toggle a feature flag',\n      description: 'Create a feature flag and toggle it at least once.',\n      order: 5,\n      completion: {\n        eventName: 'flag.toggled',\n        sourceModule: '@contractspec/lib.feature-flags',\n      },\n      xpReward: 20,\n      metadata: { surface: 'feature-flags' },\n    },\n    {\n      id: 'files_attachments',\n      title: 'Attach a file',\n      description: 'Upload and attach a file to any entity.',\n      order: 6,\n      completion: {\n        eventName: 'attachment.attached',\n        sourceModule: '@contractspec/lib.files',\n      },\n      xpReward: 20,\n      metadata: { surface: 'files' },\n    },\n    {\n      id: 'usage_metering',\n      title: 'Record usage',\n      description: 'Emit a usage metric (regeneration, agent run, or similar).',\n      order: 7,\n      completion: {\n        eventName: 'usage.recorded',\n        sourceModule: '@contractspec/lib.metering',\n      },\n      xpReward: 20,\n      metadata: { surface: 'metering' },\n    },\n  ],\n  metadata: {\n    surfacedIn: ['studio/learning', 'platform/dev-center'],\n  },\n};\n\nexport const platformLearningTracks: LearningJourneyTrackSpec[] = [\n  platformPrimitivesTourTrack,\n];\n"],"mappings":";AAEA,MAAaA,8BAAwD;CACnE,IAAI;CACJ,WAAW;CACX,MAAM;CACN,aACE;CACF,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,mBAAmB;EAAE,SAAS;EAAI,UAAU;EAAuB;CACnE,OAAO;EACL;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,YAAY;GAClC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,aAAa;GACnC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,iBAAiB;GACvC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,QAAQ;GAC9B;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,iBAAiB;GACvC;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,SAAS;GAC/B;EACD;GACE,IAAI;GACJ,OAAO;GACP,aAAa;GACb,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACf;GACD,UAAU;GACV,UAAU,EAAE,SAAS,YAAY;GAClC;EACF;CACD,UAAU,EACR,YAAY,CAAC,mBAAmB,sBAAsB,EACvD;CACF;AAED,MAAaC,yBAAqD,CAChE,4BACD"}

package/example.ts

@@ -0,0 +1 @@
+export { default } from './src/example';