Apr 17, 2020 · Apr 17, 2020 · Apr 17, 2020 · Apr 17, 2020
diff --git a/CHANGELOG.md b/CHANGELOG.md

 ##[0.2.4]

 - Support VSCode 1.39.2
 - Support VSCode 1.39.2

 ##[0.3.0]

 - Validate the extension version against the tutorial config version. This should allow us to manage breaking changes in tutorial schema in upcoming versions
diff --git a/errors/GitProjectAlreadyExists.md b/errors/GitProjectAlreadyExists.md
 ### GitProject Already Exists
 ### GitRemote Already Exists

 CodeRoad requires an emptyGitproject.
 Have you started this tutorial before in this workspace? TheGitremote already exists.

 Open a new workspace to start a tutorial.
 Consider deleting your `.git` folder and restarting.
diff --git a/errors/GitRemoteAlreadyExists.md b/errors/GitRemoteAlreadyExists.md
 ### Git Project Already Exists

 CodeRoad requires an empty Git project.

 Open a new workspace to start a tutorial.
diff --git a/errors/UnmetExtensionVersion.md b/errors/UnmetExtensionVersion.md
 ### Unmet Tutorial Dependency

 This tutorial requires a different version of CodeRoad.
diff --git a/errors/UnmetTutorialDependency.md b/errors/UnmetTutorialDependency.md
 ### Unmet Tutorial Dependency

 ### Unmet Tutorial Dependency

 Tutorial cannot reun because a dependency version doesn't match. Install the correct dependency and click "Check Again".
diff --git a/package-lock.json b/package-lock.json
diff --git a/package.json b/package.json
 {
 "name":"coderoad",
 "version":"0.2.4",
 "version":"0.3.0",
 "description":"Play interactive coding tutorials in your editor",
 "keywords": [
 "tutorial",
  },
 "preview":true,
 "publisher":"CodeRoad"
 }
 }
diff --git a/src/channel/index.ts b/src/channel/index.ts
 import * as TT from 'typings/tutorial'
 import * as E from 'typings/error'
 import * as vscode from 'vscode'
 import { satisfies } from 'semver'
 import saveCommit from '../actions/saveCommit'
 import setupActions from '../actions/setupActions'
 import solutionActions from '../actions/solutionActions'
      case 'EDITOR_TUTORIAL_CONFIG':
        try {
          const data: TT.Tutorial = action.payload.tutorial

          // validate extension version
          const expectedAppVersion = data.config?.appVersions?.vscode
          if (expectedAppVersion) {
            const extension = vscode.extensions.getExtension('coderoad.coderoad')
            if (extension) {
              const currentAppVersion = extension.packageJSON.version
              const satisfied = satisfies(currentAppVersion, expectedAppVersion)
              if (!satisfied) {
                const error: E.ErrorMessage = {
                  type: 'UnmetExtensionVersion',
                  message: `Expected CodeRoad v${expectedAppVersion}, but found v${currentAppVersion}`,
                }
                this.send({ type: 'TUTORIAL_CONFIGURE_FAIL', payload: { error } })
                return
              }
            }
          }

          // setup tutorial config (save watcher, test runner, etc)
          await this.context.setTutorial(this.workspaceState, data)

              const currentVersion: string | null = await version(dep.name)
              if (!currentVersion) {
                // use a custom error message
                const error = {
                const error: E.ErrorMessage = {
                  type: 'MissingTutorialDependency',
                  message:
                    dep.message || `Process "${dep.name}" is required but not found. It may need to be installed`,
              const satisfiedDependency = await compareVersions(currentVersion, dep.version)

              if (!satisfiedDependency) {
                const error = {
                const error: E.ErrorMessage = {
                  type: 'UnmetTutorialDependency',
                  message: `Expected ${dep.name} to have version ${dep.version}, but found version ${currentVersion}`,
                  actions: [
              }

              if (satisfiedDependency !== true) {
                const error = satisfiedDependency || {
                const error: E.ErrorMessage = satisfiedDependency || {
                  type: 'UnknownError',
                  message: `Something went wrong comparing dependency for ${name}`,
                  actions: [
diff --git a/typings/error.d.ts b/typings/error.d.ts
 export type ErrorMessageView = 'FULL_PAGE' | 'NOTIFY' | 'NONE'

 export type ErrorMessageType =
  | 'UnknownError'
  | 'NoWorkspaceFound'
  | 'GitNotFound'
  | 'WorkspaceNotEmpty'
  | 'FailedToConnectToGitRepo'
  | 'GitNotFound'
  | 'GitProjectAlreadyExists'
  | 'GitRemoteAlreadyExists'
  | 'MissingTutorialDependency'
  | 'NoWorkspaceFound'
  | 'UnknownError'
  | 'UnmetExtensionVersion'
  | 'UnmetTutorialDependency'
  | 'WorkspaceNotEmpty'

 export type ErrorAction = {
  label: string
diff --git a/typings/tutorial.d.ts b/typings/tutorial.d.ts
 export type Maybe<T> = T | null

 export type TutorialConfig = {
  appVersions: TutorialAppVersions
  testRunner: TutorialTestRunner
  repo: TutorialRepo
  dependencies?: TutorialDependency[]
  version: string
  message?: string
 }

 export interface TutorialAppVersions {
  vscode: string
 }
diff --git a/web-app/package-lock.json b/web-app/package-lock.json
diff --git a/web-app/package.json b/web-app/package.json
 {
 "name":"coderoad-app",
 "version":"0.2.4",
 "version":"0.3.0",
 "private":true,
 "scripts": {
 "build":"react-app-rewired build",
 "typescript":"^3.8.3",
 "typescript-eslint-parser":"^22.0.0"
  }
 }
 }
Original file line number	Diff line number	Diff line change
Expand Up		@@ -48,4 +48,8 @@ Check [Keep a Changelog](http://keepachangelog.com/) for recommendations on how

		##[0.2.4]

		- Support VSCode 1.39.2
		- Support VSCode 1.39.2

		##[0.3.0]

		- Validate the extension version against the tutorial config version. This should allow us to manage breaking changes in tutorial schema in upcoming versions
Original file line number	Diff line number	Diff line change
		@@ -1,5 +1,5 @@
		### GitProject Already Exists
		### GitRemote Already Exists

		CodeRoad requires an emptyGitproject.
		Have you started this tutorial before in this workspace? TheGitremote already exists.

		Open a new workspace to start a tutorial.
		Consider deleting your `.git` folder and restarting.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,5 @@
		### Git Project Already Exists

		CodeRoad requires an empty Git project.

		Open a new workspace to start a tutorial.
Original file line number	Diff line number	Diff line change
		@@ -0,0 +1,3 @@
		### Unmet Tutorial Dependency

		This tutorial requires a different version of CodeRoad.
Original file line number	Diff line number	Diff line change
		@@ -1,5 +1,3 @@
		### Unmet Tutorial Dependency

		### Unmet Tutorial Dependency

		Tutorial cannot reun because a dependency version doesn't match. Install the correct dependency and click "Check Again".
Original file line number	Diff line number	Diff line change
		@@ -1,6 +1,6 @@
		{
		"name":"coderoad",
		"version":"0.2.4",
		"version":"0.3.0",
		"description":"Play interactive coding tutorials in your editor",
		"keywords": [
		"tutorial",
Expand DownExpand Up		@@ -82,4 +82,4 @@
		},
		"preview":true,
		"publisher":"CodeRoad"
		}
		}
Original file line number	Diff line number	Diff line change
Expand Up		@@ -2,6 +2,7 @@ import * as T from 'typings'
		import * as TT from 'typings/tutorial'
		import * as E from 'typings/error'
		import * as vscode from 'vscode'
		import { satisfies } from 'semver'
		import saveCommit from '../actions/saveCommit'
		import setupActions from '../actions/setupActions'
		import solutionActions from '../actions/solutionActions'
Expand DownExpand Up		@@ -110,6 +111,25 @@ class Channel implements Channel {
		case 'EDITOR_TUTORIAL_CONFIG':
		try {
		const data: TT.Tutorial = action.payload.tutorial

		// validate extension version
		const expectedAppVersion = data.config?.appVersions?.vscode
		if (expectedAppVersion) {
		const extension = vscode.extensions.getExtension('coderoad.coderoad')
		if (extension) {
		const currentAppVersion = extension.packageJSON.version
		const satisfied = satisfies(currentAppVersion, expectedAppVersion)
		if (!satisfied) {
		const error: E.ErrorMessage = {
		type: 'UnmetExtensionVersion',
		message: `Expected CodeRoad v${expectedAppVersion}, but found v${currentAppVersion}`,
		}
		this.send({ type: 'TUTORIAL_CONFIGURE_FAIL', payload: { error } })
		return
		}
		}
		}

		// setup tutorial config (save watcher, test runner, etc)
		await this.context.setTutorial(this.workspaceState, data)

Expand All		@@ -121,7 +141,7 @@ class Channel implements Channel {
		const currentVersion: string \| null = await version(dep.name)
		if (!currentVersion) {
		// use a custom error message
		const error = {
		const error: E.ErrorMessage = {
		type: 'MissingTutorialDependency',
		message:
		dep.message \|\| `Process "${dep.name}" is required but not found. It may need to be installed`,
Expand All		@@ -140,7 +160,7 @@ class Channel implements Channel {
		const satisfiedDependency = await compareVersions(currentVersion, dep.version)

		if (!satisfiedDependency) {
		const error = {
		const error: E.ErrorMessage = {
		type: 'UnmetTutorialDependency',
		message: `Expected ${dep.name} to have version ${dep.version}, but found version ${currentVersion}`,
		actions: [
Expand All		@@ -155,7 +175,7 @@ class Channel implements Channel {
		}

		if (satisfiedDependency !== true) {
		const error = satisfiedDependency \|\| {
		const error: E.ErrorMessage = satisfiedDependency \|\| {
		type: 'UnknownError',
		message: `Something went wrong comparing dependency for ${name}`,
		actions: [
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,13 +1,16 @@
		export type ErrorMessageView = 'FULL_PAGE' \| 'NOTIFY' \| 'NONE'

		export type ErrorMessageType =
		\| 'UnknownError'
		\| 'NoWorkspaceFound'
		\| 'GitNotFound'
		\| 'WorkspaceNotEmpty'
		\| 'FailedToConnectToGitRepo'
		\| 'GitNotFound'
		\| 'GitProjectAlreadyExists'
		\| 'GitRemoteAlreadyExists'
		\| 'MissingTutorialDependency'
		\| 'NoWorkspaceFound'
		\| 'UnknownError'
		\| 'UnmetExtensionVersion'
		\| 'UnmetTutorialDependency'
		\| 'WorkspaceNotEmpty'

		export type ErrorAction = {
		label: string
Expand Down
Original file line number	Diff line number	Diff line change
		@@ -1,6 +1,7 @@
		export type Maybe<T> = T \| null

		export type TutorialConfig = {
		appVersions: TutorialAppVersions
		testRunner: TutorialTestRunner
		repo: TutorialRepo
		dependencies?: TutorialDependency[]
Expand DownExpand Up		@@ -64,3 +65,7 @@ export interface TutorialDependency {
		version: string
		message?: string
		}

		export interface TutorialAppVersions {
		vscode: string
		}
Original file line number	Diff line number	Diff line change
		@@ -1,6 +1,6 @@
		{
		"name":"coderoad-app",
		"version":"0.2.4",
		"version":"0.3.0",
		"private":true,
		"scripts": {
		"build":"react-app-rewired build",
Expand DownExpand Up		@@ -73,4 +73,4 @@
		"typescript":"^3.8.3",
		"typescript-eslint-parser":"^22.0.0"
		}
		}
		}