@contractspec/example.learning-journey-crm-onboarding 0.0.0-canary-20260113170453

package/dist/presentations/index.js

@@ -0,0 +1,55 @@
+import { CrmOnboardingTrackModel } from "../operations/index.js";
+import { StabilityEnum, definePresentation } from "@contractspec/lib.contracts";
+
+//#region src/presentations/index.ts
+const baseMeta = {
+	domain: "learning-journey",
+	title: "CRM Onboarding",
+	owners: ["@examples.learning-journey.crm-onboarding"],
+	tags: [
+		"learning",
+		"crm",
+		"onboarding"
+	],
+	stability: StabilityEnum.Experimental,
+	goal: "Guide CRM users through onboarding",
+	context: "CRM onboarding journey"
+};
+const CrmOnboardingTrackPresentation = definePresentation({
+	meta: {
+		key: "learning.journey.crm.track",
+		version: "1.0.0",
+		description: "CRM first win track detail",
+		...baseMeta
+	},
+	source: {
+		type: "component",
+		framework: "react",
+		componentKey: "LearningTrackDetail",
+		props: CrmOnboardingTrackModel
+	},
+	targets: [
+		"react",
+		"markdown",
+		"application/json"
+	]
+});
+const CrmOnboardingWidgetPresentation = definePresentation({
+	meta: {
+		key: "learning.journey.crm.widget",
+		version: "1.0.0",
+		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 };
+//# sourceMappingURL=index.js.map

package/dist/presentations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/presentations/index.ts"],"sourcesContent":["import { definePresentation, StabilityEnum, type PresentationSpecMeta } from '@contractspec/lib.contracts';\nimport { CrmOnboardingTrackModel } from '../operations';\n\nconst baseMeta: Pick<\n  PresentationSpecMeta,\n  'domain' | 'owners' | 'tags' | 'title' | 'stability' | 'goal' | 'context'\n> = {\n  domain: 'learning-journey',\n  title: 'CRM Onboarding',\n  owners: ['@examples.learning-journey.crm-onboarding'],\n  tags: ['learning', 'crm', 'onboarding'],\n  stability: StabilityEnum.Experimental,\n  goal: 'Guide CRM users through onboarding',\n  context: 'CRM onboarding journey',\n};\n\nexport const CrmOnboardingTrackPresentation = definePresentation({\n  meta: {\n    key: 'learning.journey.crm.track',\n    version: '1.0.0',\n    description: 'CRM first win track detail',\n    ...baseMeta,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'LearningTrackDetail',\n    props: CrmOnboardingTrackModel,\n  },\n  targets: ['react', 'markdown', 'application/json'],\n});\n\nexport const CrmOnboardingWidgetPresentation = definePresentation({\n  meta: {\n    key: 'learning.journey.crm.widget',\n    version: '1.0.0',\n    description: 'Compact widget for CRM onboarding progress',\n    ...baseMeta,\n  },\n  source: {\n    type: 'component',\n    framework: 'react',\n    componentKey: 'LearningTrackProgressWidget',\n  },\n  targets: ['react'],\n});\n\nexport const crmOnboardingPresentations = [\n  CrmOnboardingTrackPresentation,\n  CrmOnboardingWidgetPresentation,\n];\n"],"mappings":";;;;AAGA,MAAM,WAGF;CACF,QAAQ;CACR,OAAO;CACP,QAAQ,CAAC,4CAA4C;CACrD,MAAM;EAAC;EAAY;EAAO;EAAa;CACvC,WAAW,cAAc;CACzB,MAAM;CACN,SAAS;CACV;AAED,MAAa,iCAAiC,mBAAmB;CAC/D,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,CAAC;AAEF,MAAa,kCAAkC,mBAAmB;CAChE,MAAM;EACJ,KAAK;EACL,SAAS;EACT,aAAa;EACb,GAAG;EACJ;CACD,QAAQ;EACN,MAAM;EACN,WAAW;EACX,cAAc;EACf;CACD,SAAS,CAAC,QAAQ;CACnB,CAAC;AAEF,MAAa,6BAA6B,CACxC,gCACA,gCACD"}

package/dist/tests/operations.test-spec.d.ts

@@ -0,0 +1,7 @@
+import * as _contractspec_lib_contracts8 from "@contractspec/lib.contracts";
+
+//#region src/tests/operations.test-spec.d.ts
+declare const GetTrackTest: _contractspec_lib_contracts8.TestSpec;
+//#endregion
+export { GetTrackTest };
+//# sourceMappingURL=operations.test-spec.d.ts.map

package/dist/tests/operations.test-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.test-spec.d.ts","names":[],"sources":["../../src/tests/operations.test-spec.ts"],"sourcesContent":[],"mappings":";;;cAEa,cA4BX,4BAAA,CA5BuB"}

package/dist/tests/operations.test-spec.js

@@ -0,0 +1,36 @@
+import { defineTestSpec } from "@contractspec/lib.contracts";
+
+//#region src/tests/operations.test-spec.ts
+const GetTrackTest = defineTestSpec({
+	meta: {
+		key: "learningJourney.crmOnboarding.getTrack.test",
+		version: "1.0.0",
+		stability: "experimental",
+		owners: ["@example.learning-journey-crm-onboarding"],
+		description: "Test for getting CRM onboarding track",
+		tags: ["test"]
+	},
+	target: {
+		type: "operation",
+		operation: {
+			key: "learningJourney.crmOnboarding.getTrack",
+			version: "1.0.0"
+		}
+	},
+	scenarios: [{
+		key: "success",
+		when: { operation: { key: "learningJourney.crmOnboarding.getTrack" } },
+		then: [{
+			type: "expectOutput",
+			match: {}
+		}]
+	}, {
+		key: "error",
+		when: { operation: { key: "learningJourney.crmOnboarding.getTrack" } },
+		then: [{ type: "expectError" }]
+	}]
+});
+
+//#endregion
+export { GetTrackTest };
+//# sourceMappingURL=operations.test-spec.js.map

package/dist/tests/operations.test-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"operations.test-spec.js","names":[],"sources":["../../src/tests/operations.test-spec.ts"],"sourcesContent":["import { defineTestSpec } from '@contractspec/lib.contracts';\n\nexport const GetTrackTest = defineTestSpec({\n  meta: {\n    key: 'learningJourney.crmOnboarding.getTrack.test',\n    version: '1.0.0',\n    stability: 'experimental',\n    owners: ['@example.learning-journey-crm-onboarding'],\n    description: 'Test for getting CRM onboarding track',\n    tags: ['test'],\n  },\n  target: {\n    type: 'operation',\n    operation: {\n      key: 'learningJourney.crmOnboarding.getTrack',\n      version: '1.0.0',\n    },\n  },\n  scenarios: [\n    {\n      key: 'success',\n      when: { operation: { key: 'learningJourney.crmOnboarding.getTrack' } },\n      then: [{ type: 'expectOutput', match: {} }],\n    },\n    {\n      key: 'error',\n      when: { operation: { key: 'learningJourney.crmOnboarding.getTrack' } },\n      then: [{ type: 'expectError' }],\n    },\n  ],\n});\n"],"mappings":";;;AAEA,MAAa,eAAe,eAAe;CACzC,MAAM;EACJ,KAAK;EACL,SAAS;EACT,WAAW;EACX,QAAQ,CAAC,2CAA2C;EACpD,aAAa;EACb,MAAM,CAAC,OAAO;EACf;CACD,QAAQ;EACN,MAAM;EACN,WAAW;GACT,KAAK;GACL,SAAS;GACV;EACF;CACD,WAAW,CACT;EACE,KAAK;EACL,MAAM,EAAE,WAAW,EAAE,KAAK,0CAA0C,EAAE;EACtE,MAAM,CAAC;GAAE,MAAM;GAAgB,OAAO,EAAE;GAAE,CAAC;EAC5C,EACD;EACE,KAAK;EACL,MAAM,EAAE,WAAW,EAAE,KAAK,0CAA0C,EAAE;EACtE,MAAM,CAAC,EAAE,MAAM,eAAe,CAAC;EAChC,CACF;CACF,CAAC"}

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 crmFirstWinTrack: LearningJourneyTrackSpec;
+declare const crmLearningTracks: LearningJourneyTrackSpec[];
+//#endregion
+export { crmFirstWinTrack, crmLearningTracks };
+//# 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,kBAAkB;cA4FlB,mBAAmB"}

package/dist/track.js

@@ -0,0 +1,99 @@
+//#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: "@contractspec/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: "@contractspec/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: "@contractspec/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: "@contractspec/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: "@contractspec/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: "@contractspec/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 };
+//# sourceMappingURL=track.js.map

package/dist/track.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"track.js","names":[],"sources":["../src/track.ts"],"sourcesContent":["import type { LearningJourneyTrackSpec } from '@contractspec/module.learning-journey/track-spec';\n\nexport const crmFirstWinTrack: LearningJourneyTrackSpec = {\n  id: 'crm_first_win',\n  productId: 'crm-pipeline',\n  name: 'CRM First Win',\n  description:\n    'Guide a new CRM user from empty pipeline to first closed-won deal.',\n  targetUserSegment: 'crm_adopter',\n  targetRole: 'sales',\n  totalXp: 135,\n  streakRule: { hoursWindow: 72, bonusXp: 25 },\n  completionRewards: { xpBonus: 25, badgeKey: 'crm_first_win' },\n  steps: [\n    {\n      id: 'create_pipeline',\n      title: 'Create pipeline & stages',\n      description: 'Create a pipeline with baseline stages.',\n      order: 1,\n      completion: {\n        eventName: 'pipeline.created',\n        sourceModule: '@contractspec/example.crm-pipeline',\n      },\n      xpReward: 15,\n      metadata: { surface: 'pipeline' },\n    },\n    {\n      id: 'create_contact_and_company',\n      title: 'Create contact and company',\n      description: 'Add your first contact and associated company.',\n      order: 2,\n      completion: {\n        eventName: 'contact.created',\n        sourceModule: '@contractspec/example.crm-pipeline',\n      },\n      xpReward: 20,\n      metadata: { surface: 'contacts' },\n    },\n    {\n      id: 'create_first_deal',\n      title: 'Log first deal',\n      description: 'Create your first deal in the pipeline.',\n      order: 3,\n      completion: {\n        eventName: 'deal.created',\n        sourceModule: '@contractspec/example.crm-pipeline',\n      },\n      xpReward: 20,\n      metadata: { surface: 'deals' },\n    },\n    {\n      id: 'move_deal_in_pipeline',\n      title: 'Move a deal across stages',\n      description: 'Move a deal across at least three stages.',\n      order: 4,\n      completion: {\n        eventName: 'deal.moved',\n        sourceModule: '@contractspec/example.crm-pipeline',\n      },\n      xpReward: 20,\n      metadata: { surface: 'deals' },\n    },\n    {\n      id: 'close_deal_won',\n      title: 'Close a deal as won',\n      description: 'Close a deal as won to hit first revenue.',\n      order: 5,\n      completion: {\n        eventName: 'deal.won',\n        sourceModule: '@contractspec/example.crm-pipeline',\n      },\n      xpReward: 30,\n      metadata: { surface: 'deals' },\n    },\n    {\n      id: 'setup_follow_up',\n      title: 'Create follow-up task',\n      description:\n        'Create a follow-up task and notification for a contact or deal.',\n      order: 6,\n      completion: {\n        eventName: 'task.completed',\n        sourceModule: '@contractspec/example.crm-pipeline',\n        payloadFilter: { type: 'follow_up' },\n      },\n      xpReward: 30,\n      metadata: { surface: 'tasks' },\n    },\n  ],\n  metadata: {\n    surfacedIn: ['crm/dashboard', 'crm/pipeline'],\n  },\n};\n\nexport const crmLearningTracks: LearningJourneyTrackSpec[] = [crmFirstWinTrack];\n"],"mappings":";AAEA,MAAa,mBAA6C;CACxD,IAAI;CACJ,WAAW;CACX,MAAM;CACN,aACE;CACF,mBAAmB;CACnB,YAAY;CACZ,SAAS;CACT,YAAY;EAAE,aAAa;EAAI,SAAS;EAAI;CAC5C,mBAAmB;EAAE,SAAS;EAAI,UAAU;EAAiB;CAC7D,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,YAAY;GAClC;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,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,SAAS;GAC/B;EACD;GACE,IAAI;GACJ,OAAO;GACP,aACE;GACF,OAAO;GACP,YAAY;IACV,WAAW;IACX,cAAc;IACd,eAAe,EAAE,MAAM,aAAa;IACrC;GACD,UAAU;GACV,UAAU,EAAE,SAAS,SAAS;GAC/B;EACF;CACD,UAAU,EACR,YAAY,CAAC,iBAAiB,eAAe,EAC9C;CACF;AAED,MAAa,oBAAgD,CAAC,iBAAiB"}

package/example.ts

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

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@contractspec/example.learning-journey-crm-onboarding",
+  "version": "0.0.0-canary-20260113170453",
+  "description": "Learning journey track that onboards users to the CRM pipeline example.",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./docs": "./dist/docs/index.js",
+    "./docs/crm-onboarding.docblock": "./dist/docs/crm-onboarding.docblock.js",
+    "./example": "./dist/example.js",
+    "./handlers/demo.handlers": "./dist/handlers/demo.handlers.js",
+    "./learning-journey-crm-onboarding.feature": "./dist/learning-journey-crm-onboarding.feature.js",
+    "./operations": "./dist/operations/index.js",
+    "./presentations": "./dist/presentations/index.js",
+    "./tests/operations.test-spec": "./dist/tests/operations.test-spec.js",
+    "./track": "./dist/track.js",
+    "./*": "./*"
+  },
+  "scripts": {
+    "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
+    "publish:pkg:canary": "bun publish:pkg --tag canary",
+    "build": "bun build:types && bun build:bundle",
+    "build:bundle": "tsdown",
+    "build:types": "tsc --noEmit",
+    "dev": "bun build:bundle --watch",
+    "clean": "rimraf dist .turbo",
+    "lint": "bun lint:fix",
+    "lint:fix": "eslint src --fix",
+    "lint:check": "eslint src"
+  },
+  "dependencies": {
+    "@contractspec/lib.contracts": "0.0.0-canary-20260113170453",
+    "@contractspec/lib.schema": "0.0.0-canary-20260113170453",
+    "@contractspec/module.learning-journey": "0.0.0-canary-20260113170453",
+    "@contractspec/example.crm-pipeline": "0.0.0-canary-20260113170453"
+  },
+  "devDependencies": {
+    "@contractspec/tool.tsdown": "0.0.0-canary-20260113170453",
+    "@contractspec/tool.typescript": "0.0.0-canary-20260113170453",
+    "tsdown": "^0.19.0",
+    "typescript": "^5.9.3"
+  },
+  "publishConfig": {
+    "exports": {
+      ".": "./dist/index.js",
+      "./contracts": "./dist/contracts/index.js",
+      "./docs": "./dist/docs/index.js",
+      "./docs/crm-onboarding.docblock": "./dist/docs/crm-onboarding.docblock.js",
+      "./example": "./dist/example.js",
+      "./handlers/demo.handlers": "./dist/handlers/demo.handlers.js",
+      "./learning-journey-crm-onboarding.feature": "./dist/learning-journey-crm-onboarding.feature.js",
+      "./presentations": "./dist/presentations/index.js",
+      "./track": "./dist/track.js",
+      "./*": "./*"
+    },
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lssm-tech/contractspec.git",
+    "directory": "packages/examples/learning-journey-crm-onboarding"
+  },
+  "homepage": "https://contractspec.io"
+}

package/src/docs/crm-onboarding.docblock.ts

@@ -0,0 +1,40 @@
+import type { DocBlock } from '@contractspec/lib.contracts/docs';
+import { registerDocBlocks } from '@contractspec/lib.contracts/docs';
+
+const crmOnboardingDocBlocks: DocBlock[] = [
+  {
+    id: 'docs.learning-journey.crm-onboarding',
+    title: 'Learning Journey — CRM First Win',
+    summary:
+      'Onboarding track for the CRM Pipeline example that drives users to first closed-won deal.',
+    kind: 'reference',
+    visibility: 'public',
+    route: '/docs/learning-journey/crm-onboarding',
+    tags: ['learning', 'crm', 'onboarding'],
+    body: `## Track
+- **Key**: \`crm_first_win\`
+- **Persona**: CRM adopter
+- **Goal**: From empty CRM to first closed-won deal with follow-up
+
+## Steps & Events
+1) \`create_pipeline\` → \`pipeline.created\`
+2) \`create_contact_and_company\` → \`contact.created\`
+3) \`create_first_deal\` → \`deal.created\`
+4) \`move_deal_in_pipeline\` → \`deal.moved\`
+5) \`close_deal_won\` → \`deal.won\`
+6) \`setup_follow_up\` → \`task.completed\` (type: follow_up)
+
+XP: 15/20/20/20/30/30 with 25 bonus within 72h. Badge: \`crm_first_win\`.
+
+## Wiring
+- Depends on \`@contractspec/example.crm-pipeline\` events.
+- Tracks export from \`@contractspec/example.learning-journey-crm-onboarding/track\`.
+- Use onboarding API:
+  - \`learning.onboarding.listTracks\`
+  - \`learning.onboarding.getProgress\`
+  - \`learning.onboarding.recordEvent\` wired from CRM event bus handlers.
+- Surface in CRM dashboard/pipeline UI to guide new users.`,
+  },
+];
+
+registerDocBlocks(crmOnboardingDocBlocks);

package/src/docs/index.ts

@@ -0,0 +1 @@
+import './crm-onboarding.docblock';

package/src/example.ts

@@ -0,0 +1,31 @@
+import { defineExample } from '@contractspec/lib.contracts';
+
+const example = defineExample({
+  meta: {
+    key: 'learning-journey-crm-onboarding',
+    version: '1.0.0',
+    title: 'Learning Journey — CRM First Win',
+    description:
+      'Onboarding track for CRM Pipeline driving users from empty CRM to first closed-won deal.',
+    kind: 'template',
+    visibility: 'public',
+    stability: 'experimental',
+    owners: ['@platform.core'],
+    tags: ['learning', 'crm', 'onboarding'],
+  },
+  docs: {
+    rootDocId: 'docs.learning-journey.crm-onboarding',
+  },
+  entrypoints: {
+    packageName: '@contractspec/example.learning-journey-crm-onboarding',
+    docs: './docs',
+  },
+  surfaces: {
+    templates: true,
+    sandbox: { enabled: true, modes: ['playground', 'markdown'] },
+    studio: { enabled: true, installable: true },
+    mcp: { enabled: true },
+  },
+});
+
+export default example;

package/src/handlers/demo.handlers.ts

@@ -0,0 +1,51 @@
+import { crmFirstWinTrack } from '../track';
+
+interface EmitParams {
+  learnerId: string;
+  occurredAt?: Date;
+  payload?: Record<string, unknown>;
+}
+
+interface LearningJourneyEvent {
+  learnerId: string;
+  name: string;
+  occurredAt: Date;
+  trackId: string;
+  payload?: Record<string, unknown>;
+}
+
+type RecordEvent = (event: LearningJourneyEvent) => unknown;
+
+export const crmOnboardingEvents = [
+  'pipeline.created',
+  'contact.created',
+  'deal.created',
+  'deal.moved',
+  'deal.won',
+  'task.completed',
+] as const;
+
+export type CrmEvent = (typeof crmOnboardingEvents)[number];
+
+export const emitCrmOnboardingEvent = (
+  eventName: CrmEvent,
+  { learnerId, occurredAt = new Date(), payload }: EmitParams,
+  record?: RecordEvent
+) => {
+  const event: LearningJourneyEvent = {
+    learnerId,
+    name: eventName,
+    occurredAt,
+    payload,
+    trackId: crmFirstWinTrack.id,
+  };
+  return record ? record(event) : event;
+};
+
+export const emitAllCrmOnboardingEvents = (
+  params: EmitParams,
+  record?: RecordEvent
+) =>
+  crmOnboardingEvents.map((name) =>
+    emitCrmOnboardingEvent(name, params, record)
+  );

package/src/index.ts

@@ -0,0 +1,7 @@
+export * from './track';
+export * from './docs';
+export * from './operations';
+export * from './handlers/demo.handlers';
+export * from './presentations';
+export * from './learning-journey-crm-onboarding.feature';
+export { default as example } from './example';

package/src/learning-journey-crm-onboarding.feature.ts

@@ -0,0 +1,66 @@
+/**
+ * Learning Journey CRM Onboarding Feature Module Specification
+ *
+ * Defines the feature module for CRM first-win onboarding journey.
+ */
+import { defineFeature } from '@contractspec/lib.contracts';
+
+/**
+ * Learning Journey CRM Onboarding feature module that bundles
+ * CRM-specific onboarding track operations and presentations.
+ */
+export const LearningJourneyCrmOnboardingFeature = defineFeature({
+  meta: {
+    key: 'learning-journey-crm-onboarding',
+    title: 'Learning Journey: CRM Onboarding',
+    description:
+      'CRM first-win onboarding journey with step-by-step guidance for new CRM users',
+    domain: 'learning-journey',
+    owners: ['@examples.learning-journey.crm-onboarding'],
+    tags: ['learning', 'crm', 'onboarding', 'journey'],
+    stability: 'experimental',
+    version: '1.0.0',
+  },
+
+  // All contract operations included in this feature
+  operations: [
+    { key: 'learningJourney.crmOnboarding.recordEvent', version: '1.0.0' },
+    { key: 'learningJourney.crmOnboarding.getTrack', version: '1.0.0' },
+  ],
+
+  // Events emitted by this feature
+  events: [],
+
+  // Presentations associated with this feature
+  presentations: [
+    { key: 'learning.journey.crm.track', version: '1.0.0' },
+    { key: 'learning.journey.crm.widget', version: '1.0.0' },
+  ],
+
+  // Link operations to their primary presentations
+  opToPresentation: [
+    {
+      op: { key: 'learningJourney.crmOnboarding.getTrack', version: '1.0.0' },
+      pres: { key: 'learning.journey.crm.track', version: '1.0.0' },
+    },
+  ],
+
+  // Target requirements for multi-surface rendering
+  presentationsTargets: [
+    {
+      key: 'learning.journey.crm.track',
+      version: '1.0.0',
+      targets: ['react', 'markdown', 'application/json'],
+    },
+    {
+      key: 'learning.journey.crm.widget',
+      version: '1.0.0',
+      targets: ['react'],
+    },
+  ],
+
+  // Capability requirements
+  capabilities: {
+    requires: [{ key: 'identity', version: '1.0.0' }],
+  },
+});

package/src/operations/index.test.ts

@@ -0,0 +1,49 @@
+import { describe, expect, it } from 'bun:test';
+
+import {
+  GetCrmOnboardingTrack,
+  RecordCrmOnboardingEvent,
+  crmOnboardingContracts,
+} from './index';
+import { crmFirstWinTrack } from '../track';
+import {
+  crmOnboardingEvents,
+  emitCrmOnboardingEvent,
+} from '../handlers/demo.handlers';
+import type { CrmEvent } from '../handlers/demo.handlers';
+
+describe('crm onboarding contracts', () => {
+  it('exposes track metadata', () => {
+    expect(crmOnboardingContracts.track.id).toBe('crm_first_win');
+    expect(crmOnboardingContracts.track.steps.length).toBeGreaterThan(0);
+    expect(GetCrmOnboardingTrack.meta.key).toBe(
+      'learningJourney.crmOnboarding.getTrack'
+    );
+  });
+
+  it('allows recording events via demo handler', async () => {
+    const [step] = crmFirstWinTrack.steps;
+    expect(step).toBeDefined();
+    if (!step) throw new Error('Expected at least one CRM onboarding step');
+
+    const eventName = step.completion.eventName;
+    const isCrmEvent = (value: string): value is CrmEvent =>
+      crmOnboardingEvents.includes(value as CrmEvent);
+
+    expect(isCrmEvent(eventName)).toBe(true);
+    if (!isCrmEvent(eventName)) {
+      throw new Error(`Unexpected event name: ${eventName}`);
+    }
+
+    const result = await emitCrmOnboardingEvent(eventName, {
+      learnerId: 'demo-learner',
+    });
+    expect(result).toBeDefined();
+  });
+
+  it('exposes record event contract', () => {
+    expect(RecordCrmOnboardingEvent.meta.key).toBe(
+      'learningJourney.crmOnboarding.recordEvent'
+    );
+  });
+});