@lssm/example.learning-journey-platform-tour 0.0.0-canary-20251217060834 → 0.0.0-canary-20251217072406

package/dist/libs/contracts/dist/spec.js

@@ -0,0 +1,34 @@
+//#region ../../libs/contracts/dist/spec.js
+/**
+* Helper to define a Command (write operation).
+* Sets `kind: 'command'` and defaults `idempotent: false`.
+*/
+const defineCommand = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "command"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: spec.policy?.["policy"]?.idempotent ?? false
+	}
+});
+/**
+* Helper to define a Query (read-only operation).
+* Sets `kind: 'query'` and forces `idempotent: true`.
+*/
+const defineQuery = (spec) => ({
+	...spec,
+	meta: {
+		...spec.meta,
+		kind: "query"
+	},
+	policy: {
+		...spec.policy,
+		idempotent: true
+	}
+});
+
+//#endregion
+export { defineCommand, defineQuery };

package/dist/libs/contracts/dist/telemetry/index.js

@@ -0,0 +1 @@
+import "./tracker.js";

package/dist/libs/contracts/dist/telemetry/tracker.js

@@ -0,0 +1 @@
+import "crypto";

package/dist/libs/contracts/dist/tests/index.js

@@ -0,0 +1 @@
+import "./runner.js";

package/dist/libs/contracts/dist/tests/runner.js

@@ -0,0 +1,2 @@
+import "../index.js";
+import "node:assert";

package/dist/libs/contracts/dist/workflow/index.js

@@ -0,0 +1 @@
+import "./runner.js";

package/dist/libs/contracts/dist/workflow/runner.js

@@ -0,0 +1 @@
+import "node:crypto";

package/dist/libs/schema/dist/EnumType.js

@@ -0,0 +1,2 @@
+import "zod";
+import "graphql";

package/dist/libs/schema/dist/FieldType.js

@@ -0,0 +1,49 @@
+import "zod";
+import { GraphQLScalarType } from "graphql";
+
+//#region ../../libs/schema/dist/FieldType.js
+/**
+* GraphQL scalar wrapper that carries zod and JSON Schema metadata.
+*
+* TInternal is the runtime representation; TExternal is the GraphQL output.
+*/
+var FieldType = class extends GraphQLScalarType {
+	zodSchema;
+	jsonSchemaDef;
+	constructor(config) {
+		super(config);
+		this.zodSchema = config.zod;
+		this.jsonSchemaDef = config.jsonSchema;
+	}
+	/** Return the attached zod schema for validation. */
+	getZod() {
+		return this.zodSchema;
+	}
+	/** GraphQL scalar instance usable by Pothos or vanilla GraphQL. */
+	getPothos() {
+		return this;
+	}
+	/** Return the JSON Schema (evaluates factory if provided). */
+	getJson() {
+		return typeof this.jsonSchemaDef === "function" ? this.jsonSchemaDef() : this.jsonSchemaDef;
+	}
+	getJsonSchemaDef() {
+		return this.jsonSchemaDef;
+	}
+	getJsonSchema() {
+		const deepResolve = (v) => {
+			const value = typeof v === "function" ? v() : v;
+			if (Array.isArray(value)) return value.map((item) => deepResolve(item));
+			if (value && typeof value === "object") {
+				const obj = {};
+				for (const [k, val] of Object.entries(value)) obj[k] = deepResolve(val);
+				return obj;
+			}
+			return value;
+		};
+		return deepResolve(this.getJson());
+	}
+};
+
+//#endregion
+export { FieldType };

package/dist/libs/schema/dist/ScalarTypeEnum.js

@@ -0,0 +1,236 @@
+import { FieldType } from "./FieldType.js";
+import * as z$1 from "zod";
+import { Kind } from "graphql";
+
+//#region ../../libs/schema/dist/ScalarTypeEnum.js
+const localeRegex = /^[A-Za-z]{2}(?:-[A-Za-z0-9]{2,8})*$/;
+const timezoneRegex = /^(?:UTC|[A-Za-z_]+\/[A-Za-z_]+)$/;
+const phoneRegex = /^[+]?\d[\d\s().-]{3,}$/;
+const currencyRegex = /^[A-Z]{3}$/;
+const countryRegex = /^[A-Z]{2}$/;
+const latMin = -90;
+const latMax = 90;
+const lonMin = -180;
+const lonMax = 180;
+/**
+* Factory functions for common scalar FieldTypes with zod/GraphQL/JSON Schema.
+*/
+const ScalarTypeEnum = {
+	String_unsecure: () => new FieldType({
+		name: "String_unsecure",
+		description: "Unvalidated string scalar",
+		zod: z$1.string(),
+		parseValue: (v) => z$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	Int_unsecure: () => new FieldType({
+		name: "Int_unsecure",
+		description: "Unvalidated integer scalar",
+		zod: z$1.number().int(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1.number().int().parse(num);
+		},
+		serialize: (v) => Math.trunc(typeof v === "number" ? v : Number(v)),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "integer" }
+	}),
+	Float_unsecure: () => new FieldType({
+		name: "Float_unsecure",
+		description: "Unvalidated float scalar",
+		zod: z$1.number(),
+		parseValue: (v) => {
+			const num = typeof v === "number" ? v : Number(v);
+			return z$1.number().parse(num);
+		},
+		serialize: (v) => Number(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.FLOAT && ast.kind !== Kind.INT) throw new TypeError("Invalid literal");
+			return Number(ast.value);
+		},
+		jsonSchema: { type: "number" }
+	}),
+	Boolean: () => new FieldType({
+		name: "Boolean",
+		description: "Unvalidated boolean scalar",
+		zod: z$1.boolean(),
+		parseValue: (v) => z$1.coerce.boolean().parse(v),
+		serialize: (v) => Boolean(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.BOOLEAN) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "boolean" }
+	}),
+	ID: () => new FieldType({
+		name: "ID",
+		description: "Unvalidated id scalar",
+		zod: z$1.string(),
+		parseValue: (v) => z$1.string().parse(v),
+		serialize: (v) => String(v),
+		parseLiteral: (ast) => {
+			if (ast.kind !== Kind.STRING) throw new TypeError("Invalid literal");
+			return ast.value;
+		},
+		jsonSchema: { type: "string" }
+	}),
+	JSON: () => new FieldType({
+		name: "JSON",
+		zod: z$1.any(),
+		parseValue: (v) => v,
+		serialize: (v) => v,
+		jsonSchema: {}
+	}),
+	JSONObject: () => new FieldType({
+		name: "JSONObject",
+		zod: z$1.record(z$1.string(), z$1.any()),
+		parseValue: (v) => z$1.record(z$1.string(), z$1.any()).parse(v),
+		serialize: (v) => v ?? {},
+		jsonSchema: { type: "object" }
+	}),
+	Date: () => new FieldType({
+		name: "Date",
+		zod: z$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => v instanceof Date ? v.toISOString().split("T")[0] : String(v),
+		jsonSchema: {
+			type: "string",
+			format: "date"
+		}
+	}),
+	DateTime: () => new FieldType({
+		name: "DateTime",
+		zod: z$1.date(),
+		parseValue: (v) => v instanceof Date ? v : new Date(String(v)),
+		serialize: (v) => {
+			return v instanceof Date ? v.toISOString() : String(v);
+		},
+		jsonSchema: {
+			type: "string",
+			format: "date-time"
+		}
+	}),
+	Time: () => new FieldType({
+		name: "Time",
+		zod: z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/),
+		parseValue: (v) => z$1.string().regex(/^\d{2}:\d{2}(:\d{2})?$/).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: "^\\d{2}:\\d{2}(:\\d{2})?$"
+		}
+	}),
+	EmailAddress: () => new FieldType({
+		name: "EmailAddress",
+		zod: z$1.string().email(),
+		parseValue: (v) => z$1.string().email().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "email"
+		}
+	}),
+	URL: () => new FieldType({
+		name: "URL",
+		zod: z$1.string().url(),
+		parseValue: (v) => z$1.string().url().parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			format: "uri"
+		}
+	}),
+	PhoneNumber: () => new FieldType({
+		name: "PhoneNumber",
+		zod: z$1.string().regex(phoneRegex),
+		parseValue: (v) => z$1.string().regex(phoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: phoneRegex.source
+		}
+	}),
+	NonEmptyString: () => new FieldType({
+		name: "NonEmptyString",
+		zod: z$1.string().min(1),
+		parseValue: (v) => z$1.string().min(1).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			minLength: 1
+		}
+	}),
+	Locale: () => new FieldType({
+		name: "Locale",
+		zod: z$1.string().regex(localeRegex),
+		parseValue: (v) => z$1.string().regex(localeRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: localeRegex.source
+		}
+	}),
+	TimeZone: () => new FieldType({
+		name: "TimeZone",
+		zod: z$1.string().regex(timezoneRegex),
+		parseValue: (v) => z$1.string().regex(timezoneRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: timezoneRegex.source
+		}
+	}),
+	Latitude: () => new FieldType({
+		name: "Latitude",
+		zod: z$1.number().min(latMin).max(latMax),
+		parseValue: (v) => z$1.coerce.number().min(latMin).max(latMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: latMin,
+			maximum: latMax
+		}
+	}),
+	Longitude: () => new FieldType({
+		name: "Longitude",
+		zod: z$1.number().min(lonMin).max(lonMax),
+		parseValue: (v) => z$1.coerce.number().min(lonMin).max(lonMax).parse(v),
+		serialize: (v) => Number(v),
+		jsonSchema: {
+			type: "number",
+			minimum: lonMin,
+			maximum: lonMax
+		}
+	}),
+	Currency: () => new FieldType({
+		name: "Currency",
+		zod: z$1.string().regex(currencyRegex),
+		parseValue: (v) => z$1.string().regex(currencyRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: currencyRegex.source
+		}
+	}),
+	CountryCode: () => new FieldType({
+		name: "CountryCode",
+		zod: z$1.string().regex(countryRegex),
+		parseValue: (v) => z$1.string().regex(countryRegex).parse(v),
+		serialize: (v) => String(v),
+		jsonSchema: {
+			type: "string",
+			pattern: countryRegex.source
+		}
+	})
+};
+
+//#endregion
+export { ScalarTypeEnum };

package/dist/libs/schema/dist/SchemaModel.js

@@ -0,0 +1,39 @@
+import "./EnumType.js";
+import "./FieldType.js";
+import * as z$1 from "zod";
+
+//#region ../../libs/schema/dist/SchemaModel.js
+/**
+* Named object model built from FieldType/EnumType/SchemaModel fields.
+* Provides zod and GraphQL input helpers, and supports arrays/optional fields.
+*/
+var SchemaModel = class {
+	constructor(config) {
+		this.config = config;
+	}
+	/**
+	* Build a typed ZodObject from the model fields, preserving each field's
+	* Zod schema and optionality at the type level when possible.
+	*/
+	getZod() {
+		const shape = Object.entries(this.config.fields).reduce((acc, [key, def]) => {
+			const base = def.type.getZod();
+			const withArray = def.isArray ? z$1.array(base) : base;
+			acc[key] = def.isOptional ? withArray.optional() : withArray;
+			return acc;
+		}, {});
+		return z$1.object(shape);
+	}
+	/** Input object name for GraphQL builder adapters. */
+	getPothosInput() {
+		return this.config.name;
+	}
+};
+/**
+* Helper to define a SchemaModel with type inference.
+* Equivalent to `new SchemaModel(config)` but with better ergonomics.
+*/
+const defineSchemaModel = (config) => new SchemaModel(config);
+
+//#endregion
+export { SchemaModel, defineSchemaModel };

package/dist/libs/schema/dist/entity/defineEntity.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/dist/entity/index.js

@@ -0,0 +1,2 @@
+import "./defineEntity.js";
+import "./types.js";

package/dist/libs/schema/dist/entity/types.js

@@ -0,0 +1 @@
+import "zod";

package/dist/libs/schema/dist/index.js

@@ -0,0 +1,6 @@
+import "./EnumType.js";
+import { FieldType } from "./FieldType.js";
+import { ScalarTypeEnum } from "./ScalarTypeEnum.js";
+import { SchemaModel, defineSchemaModel } from "./SchemaModel.js";
+import "./entity/defineEntity.js";
+import "./entity/index.js";

package/dist/presentations/index.js

@@ -1 +1,49 @@
-import{PlatformTourTrackModel as e}from"../contracts/index.js";const t={domain:`learning-journey`,owners:[`examples.learning-journey.platform-tour`],tags:[`learning`,`platform`,`tour`]},n={meta:{name:`learning.journey.platform.track`,version:1,description:`Platform primitives tour track detail`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackDetail`,props:e},targets:[`react`,`markdown`,`application/json`]},r={meta:{name:`learning.journey.platform.widget`,version:1,description:`Compact widget for platform tour progress`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackProgressWidget`},targets:[`react`]},i=[n,r];export{n as PlatformTourTrackPresentation,r as PlatformTourWidgetPresentation,i as platformTourPresentations};
+import { PlatformTourTrackModel } from "../contracts/index.js";
+
+//#region src/presentations/index.ts
+const baseMeta = {
+	domain: "learning-journey",
+	owners: ["examples.learning-journey.platform-tour"],
+	tags: [
+		"learning",
+		"platform",
+		"tour"
+	]
+};
+const PlatformTourTrackPresentation = {
+	meta: {
+		name: "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: {
+		name: "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 };

package/dist/track.js

@@ -1 +1,105 @@
-const e={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:`@lssm/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:`@lssm/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:`@lssm/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:`@lssm/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:`@lssm/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:`@lssm/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:`@lssm/lib.metering`},xpReward:20,metadata:{surface:`metering`}}],metadata:{surfacedIn:[`studio/learning`,`platform/dev-center`]}},t=[e];export{t as platformLearningTracks,e as platformPrimitivesTourTrack};
+//#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: "@lssm/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: "@lssm/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: "@lssm/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: "@lssm/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: "@lssm/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: "@lssm/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: "@lssm/lib.metering"
+			},
+			xpReward: 20,
+			metadata: { surface: "metering" }
+		}
+	],
+	metadata: { surfacedIn: ["studio/learning", "platform/dev-center"] }
+};
+const platformLearningTracks = [platformPrimitivesTourTrack];
+
+//#endregion
+export { platformLearningTracks, platformPrimitivesTourTrack };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.learning-journey-platform-tour",
-  "version": "0.0.0-canary-20251217060834",
+  "version": "0.0.0-canary-20251217072406",
   "description": "Learning journey track covering ContractSpec platform primitives.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,13 +30,13 @@
     "lint:check": "eslint src"
   },
   "dependencies": {
-    "@lssm/lib.contracts": "0.0.0-canary-20251217060834",
-    "@lssm/lib.schema": "0.0.0-canary-20251217060834",
-    "@lssm/module.learning-journey": "0.0.0-canary-20251217060834"
+    "@lssm/lib.contracts": "0.0.0-canary-20251217072406",
+    "@lssm/lib.schema": "0.0.0-canary-20251217072406",
+    "@lssm/module.learning-journey": "0.0.0-canary-20251217072406"
   },
   "devDependencies": {
-    "@lssm/tool.tsdown": "0.0.0-canary-20251217060834",
-    "@lssm/tool.typescript": "0.0.0-canary-20251217060834",
+    "@lssm/tool.tsdown": "0.0.0-canary-20251217072406",
+    "@lssm/tool.typescript": "0.0.0-canary-20251217072406",
     "tsdown": "^0.17.4",
     "typescript": "^5.9.3"
   },