@lssm/example.learning-journey-crm-onboarding 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{CrmOnboardingTrackModel as e}from"../contracts/index.js";const t={domain:`learning-journey`,owners:[`examples.learning-journey.crm-onboarding`],tags:[`learning`,`crm`,`onboarding`]},n={meta:{name:`learning.journey.crm.track`,version:1,description:`CRM first win track detail`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackDetail`,props:e},targets:[`react`,`markdown`,`application/json`]},r={meta:{name:`learning.journey.crm.widget`,version:1,description:`Compact widget for CRM onboarding progress`,...t},source:{type:`component`,framework:`react`,componentKey:`LearningTrackProgressWidget`},targets:[`react`]},i=[n,r];export{n as CrmOnboardingTrackPresentation,r as CrmOnboardingWidgetPresentation,i as crmOnboardingPresentations};
+import { CrmOnboardingTrackModel } from "../contracts/index.js";
+
+//#region src/presentations/index.ts
+const baseMeta = {
+	domain: "learning-journey",
+	owners: ["examples.learning-journey.crm-onboarding"],
+	tags: [
+		"learning",
+		"crm",
+		"onboarding"
+	]
+};
+const CrmOnboardingTrackPresentation = {
+	meta: {
+		name: "learning.journey.crm.track",
+		version: 1,
+		description: "CRM first win track detail",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackDetail",
+		props: CrmOnboardingTrackModel
+	},
+	targets: [
+		"react",
+		"markdown",
+		"application/json"
+	]
+};
+const CrmOnboardingWidgetPresentation = {
+	meta: {
+		name: "learning.journey.crm.widget",
+		version: 1,
+		description: "Compact widget for CRM onboarding progress",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackProgressWidget"
+	},
+	targets: ["react"]
+};
+const crmOnboardingPresentations = [CrmOnboardingTrackPresentation, CrmOnboardingWidgetPresentation];
+
+//#endregion
+export { CrmOnboardingTrackPresentation, CrmOnboardingWidgetPresentation, crmOnboardingPresentations };

package/dist/track.js

@@ -1 +1,98 @@
-const e={id:`crm_first_win`,productId:`crm-pipeline`,name:`CRM First Win`,description:`Guide a new CRM user from empty pipeline to first closed-won deal.`,targetUserSegment:`crm_adopter`,targetRole:`sales`,totalXp:135,streakRule:{hoursWindow:72,bonusXp:25},completionRewards:{xpBonus:25,badgeKey:`crm_first_win`},steps:[{id:`create_pipeline`,title:`Create pipeline & stages`,description:`Create a pipeline with baseline stages.`,order:1,completion:{eventName:`pipeline.created`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:15,metadata:{surface:`pipeline`}},{id:`create_contact_and_company`,title:`Create contact and company`,description:`Add your first contact and associated company.`,order:2,completion:{eventName:`contact.created`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:20,metadata:{surface:`contacts`}},{id:`create_first_deal`,title:`Log first deal`,description:`Create your first deal in the pipeline.`,order:3,completion:{eventName:`deal.created`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:20,metadata:{surface:`deals`}},{id:`move_deal_in_pipeline`,title:`Move a deal across stages`,description:`Move a deal across at least three stages.`,order:4,completion:{eventName:`deal.moved`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:20,metadata:{surface:`deals`}},{id:`close_deal_won`,title:`Close a deal as won`,description:`Close a deal as won to hit first revenue.`,order:5,completion:{eventName:`deal.won`,sourceModule:`@lssm/example.crm-pipeline`},xpReward:30,metadata:{surface:`deals`}},{id:`setup_follow_up`,title:`Create follow-up task`,description:`Create a follow-up task and notification for a contact or deal.`,order:6,completion:{eventName:`task.completed`,sourceModule:`@lssm/example.crm-pipeline`,payloadFilter:{type:`follow_up`}},xpReward:30,metadata:{surface:`tasks`}}],metadata:{surfacedIn:[`crm/dashboard`,`crm/pipeline`]}},t=[e];export{e as crmFirstWinTrack,t as crmLearningTracks};
+//#region src/track.ts
+const crmFirstWinTrack = {
+	id: "crm_first_win",
+	productId: "crm-pipeline",
+	name: "CRM First Win",
+	description: "Guide a new CRM user from empty pipeline to first closed-won deal.",
+	targetUserSegment: "crm_adopter",
+	targetRole: "sales",
+	totalXp: 135,
+	streakRule: {
+		hoursWindow: 72,
+		bonusXp: 25
+	},
+	completionRewards: {
+		xpBonus: 25,
+		badgeKey: "crm_first_win"
+	},
+	steps: [
+		{
+			id: "create_pipeline",
+			title: "Create pipeline & stages",
+			description: "Create a pipeline with baseline stages.",
+			order: 1,
+			completion: {
+				eventName: "pipeline.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 15,
+			metadata: { surface: "pipeline" }
+		},
+		{
+			id: "create_contact_and_company",
+			title: "Create contact and company",
+			description: "Add your first contact and associated company.",
+			order: 2,
+			completion: {
+				eventName: "contact.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "contacts" }
+		},
+		{
+			id: "create_first_deal",
+			title: "Log first deal",
+			description: "Create your first deal in the pipeline.",
+			order: 3,
+			completion: {
+				eventName: "deal.created",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "move_deal_in_pipeline",
+			title: "Move a deal across stages",
+			description: "Move a deal across at least three stages.",
+			order: 4,
+			completion: {
+				eventName: "deal.moved",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 20,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "close_deal_won",
+			title: "Close a deal as won",
+			description: "Close a deal as won to hit first revenue.",
+			order: 5,
+			completion: {
+				eventName: "deal.won",
+				sourceModule: "@lssm/example.crm-pipeline"
+			},
+			xpReward: 30,
+			metadata: { surface: "deals" }
+		},
+		{
+			id: "setup_follow_up",
+			title: "Create follow-up task",
+			description: "Create a follow-up task and notification for a contact or deal.",
+			order: 6,
+			completion: {
+				eventName: "task.completed",
+				sourceModule: "@lssm/example.crm-pipeline",
+				payloadFilter: { type: "follow_up" }
+			},
+			xpReward: 30,
+			metadata: { surface: "tasks" }
+		}
+	],
+	metadata: { surfacedIn: ["crm/dashboard", "crm/pipeline"] }
+};
+const crmLearningTracks = [crmFirstWinTrack];
+
+//#endregion
+export { crmFirstWinTrack, crmLearningTracks };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lssm/example.learning-journey-crm-onboarding",
-  "version": "0.0.0-canary-20251217060834",
+  "version": "0.0.0-canary-20251217072406",
   "description": "Learning journey track that onboards users to the CRM pipeline example.",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,14 +30,14 @@
     "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/example.crm-pipeline": "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",
+    "@lssm/example.crm-pipeline": "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"
   },