@slicemachine/manager 0.1.1-dev-plugins.11 → 0.1.1-dev-plugins.12

package/dist/managers/versions/VersionsManager.js

@@ -7,6 +7,7 @@ var __publicField = (obj, key, value) => {
 import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import semver from "semver";
+import { decodePackageJSON } from "../../lib/decodePackageJSON.js";
 import { fetchGitHubReleaseBodyForRelease } from "../../lib/fetchGitHubReleaseBodyForRelease.js";
 import { fetchNPMPackageVersions } from "../../lib/fetchNPMPackageVersions.js";
 import { SLICE_MACHINE_GITHUB_PACKAGE_NAME } from "../../constants/SLICE_MACHINE_GITHUB_PACKAGE_NAME.js";
@@ -19,7 +20,9 @@ const detectVersionBumpKind = (to, from) => {
   if (!from) {
     return VERSION_KIND.FIRST;
   }
-  if (semver.satisfies(to, `~${from}`)) {
+  if (semver.eq(to, from)) {
+    return void 0;
+  } else if (semver.satisfies(to, `~${from}`)) {
     return VERSION_KIND.PATCH;
   } else if (semver.satisfies(to, `^${from}`)) {
     return VERSION_KIND.MINOR;
@@ -38,8 +41,16 @@ class VersionsManager extends BaseManager {
   async getRunningSliceMachineVersion() {
     const sliceMachineDir = await this.project.locateSliceMachineUIDir();
     const sliceMachinePackageJSONContents = await fs.readFile(path.join(sliceMachineDir, "package.json"), "utf8");
-    const json = JSON.parse(sliceMachinePackageJSONContents);
-    return json.version;
+    let sliceMachinePackageJSON;
+    try {
+      sliceMachinePackageJSON = JSON.parse(sliceMachinePackageJSONContents);
+    } catch {
+    }
+    const { value, error } = decodePackageJSON(sliceMachinePackageJSON);
+    if (error) {
+      throw new Error(`Invalid ${SLICE_MACHINE_NPM_PACKAGE_NAME} \`package.json\` file. ${error.errors.join(", ")}`);
+    }
+    return value.version;
   }
   async getAllStableSliceMachineVersions() {
     const versions = await fetchNPMPackageVersions({

package/dist/managers/versions/VersionsManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"VersionsManager.js","sources":["../../../../src/managers/versions/VersionsManager.ts"],"sourcesContent":["import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport semver from \"semver\";\n\nimport {\n\tfetchGitHubReleaseBodyForRelease,\n\tGitHubReleaseMetadata,\n} from \"../../lib/fetchGitHubReleaseBodyForRelease\";\nimport { fetchNPMPackageVersions } from \"../../lib/fetchNPMPackageVersions\";\n\nimport { SLICE_MACHINE_GITHUB_PACKAGE_NAME } from \"../../constants/SLICE_MACHINE_GITHUB_PACKAGE_NAME\";\nimport { SLICE_MACHINE_GITHUB_REPOSITORY_NAME } from \"../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_NAME\";\nimport { SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION } from \"../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION\";\nimport { SLICE_MACHINE_NPM_PACKAGE_NAME } from \"../../constants/SLICE_MACHINE_NPM_PACKAGE_NAME\";\nimport { VERSION_KIND } from \"../../constants/VERSION_KIND\";\n\nimport { BaseManager } from \"../BaseManager\";\n\nimport { Version } from \"./types\";\n\nconst detectVersionBumpKind = (\n\tto: string,\n\tfrom?: string,\n): typeof VERSION_KIND[keyof typeof VERSION_KIND] => {\n\tif (!from) {\n\t\treturn VERSION_KIND.FIRST;\n\t}\n\n\tif (semver.satisfies(to, `~${from}`)) {\n\t\treturn VERSION_KIND.PATCH;\n\t} else if (semver.satisfies(to, `^${from}`)) {\n\t\treturn VERSION_KIND.MINOR;\n\t} else {\n\t\treturn VERSION_KIND.MAJOR;\n\t}\n};\n\ntype SliceMachineManagerGetReleaseNotesForVersionArgs = {\n\tversion: string;\n};\n\nexport class VersionsManager extends BaseManager {\n\t/**\n\t * Record of version numbers mapped to their GitHub release metadata.\n\t */\n\tgitHubSliceMachineReleaseMetadataCache: Record<\n\t\tstring,\n\t\tGitHubReleaseMetadata | undefined\n\t> = {};\n\n\tasync getRunningSliceMachineVersion(): Promise<string> {\n\t\tconst sliceMachineDir = await this.project.locateSliceMachineUIDir();\n\n\t\tconst sliceMachinePackageJSONContents = await fs.readFile(\n\t\t\tpath.join(sliceMachineDir, \"package.json\"),\n\t\t\t\"utf8\",\n\t\t);\n\n\t\t// TODO: Validate the contents? This code currently assumes a\n\t\t// well-formed document.\n\t\tconst json = JSON.parse(sliceMachinePackageJSONContents);\n\n\t\treturn json.version;\n\t}\n\n\tasync getAllStableSliceMachineVersions(): Promise<string[]> {\n\t\tconst versions = await fetchNPMPackageVersions({\n\t\t\tpackageName: SLICE_MACHINE_NPM_PACKAGE_NAME,\n\t\t});\n\n\t\tconst filteredVersions = versions.filter((version) => {\n\t\t\t// Exclude tagged versions (e.g. `1.0.0-alpha.0`).\n\t\t\t// Exclude versions < 0.1.0 (e.g. `0.0.1`).\n\t\t\treturn (\n\t\t\t\t/^[1-9]\\d*\\.\\d+\\.\\d+$/.test(version) ||\n\t\t\t\t/^\\d+\\.[1-9]\\d*\\.\\d+$/.test(version)\n\t\t\t);\n\t\t});\n\n\t\treturn semver.rsort(filteredVersions);\n\t}\n\n\tasync getAllStableSliceMachineVersionsWithKind(): Promise<Version[]> {\n\t\tconst versions = await this.getAllStableSliceMachineVersions();\n\n\t\treturn versions.map((version, i) => {\n\t\t\tconst previousVersion = versions[i + 1];\n\n\t\t\treturn {\n\t\t\t\tversion,\n\t\t\t\tkind: detectVersionBumpKind(version, previousVersion),\n\t\t\t};\n\t\t});\n\t}\n\n\tasync getLatestNonBreakingSliceMachineVersion(): Promise<string | undefined> {\n\t\tconst versions = await this.getAllStableSliceMachineVersions();\n\t\tconst currentVersion = await this.getRunningSliceMachineVersion();\n\n\t\treturn semver.maxSatisfying(versions, `^${currentVersion}`) ?? undefined;\n\t}\n\n\tasync checkIsUpdateAvailable(): Promise<boolean> {\n\t\tconst versions = await this.getAllStableSliceMachineVersions();\n\t\tconst currentVersion = await this.getRunningSliceMachineVersion();\n\n\t\treturn semver.gt(versions[0], currentVersion);\n\t}\n\n\tasync getSliceMachineReleaseNotesForVersion(\n\t\targs: SliceMachineManagerGetReleaseNotesForVersionArgs,\n\t): Promise<string | undefined> {\n\t\treturn await fetchGitHubReleaseBodyForRelease({\n\t\t\trepositoryOwner: SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION,\n\t\t\trepositoryName: SLICE_MACHINE_GITHUB_REPOSITORY_NAME,\n\t\t\tpackageName: SLICE_MACHINE_GITHUB_PACKAGE_NAME,\n\t\t\tversion: args.version,\n\t\t\tcache: this.gitHubSliceMachineReleaseMetadataCache,\n\t\t});\n\t}\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAoBA,MAAM,wBAAwB,CAC7B,IACA,SACmD;AACnD,MAAI,CAAC,MAAM;AACV,WAAO,aAAa;AAAA,EACpB;AAED,MAAI,OAAO,UAAU,IAAI,IAAI,MAAM,GAAG;AACrC,WAAO,aAAa;AAAA,EAAA,WACV,OAAO,UAAU,IAAI,IAAI,MAAM,GAAG;AAC5C,WAAO,aAAa;AAAA,EAAA,OACd;AACN,WAAO,aAAa;AAAA,EACpB;AACF;AAMM,MAAO,wBAAwB,YAAW;AAAA,EAA1C;AAAA;AAIL;AAAA;AAAA;AAAA,kEAGI,CAAA;AAAA;AAAA,EAEJ,MAAM,gCAA6B;AAClC,UAAM,kBAAkB,MAAM,KAAK,QAAQ,wBAAuB;AAE5D,UAAA,kCAAkC,MAAM,GAAG,SAChD,KAAK,KAAK,iBAAiB,cAAc,GACzC,MAAM;AAKD,UAAA,OAAO,KAAK,MAAM,+BAA+B;AAEvD,WAAO,KAAK;AAAA,EACb;AAAA,EAEA,MAAM,mCAAgC;AAC/B,UAAA,WAAW,MAAM,wBAAwB;AAAA,MAC9C,aAAa;AAAA,IAAA,CACb;AAED,UAAM,mBAAmB,SAAS,OAAO,CAAC,YAAW;AAGpD,aACC,uBAAuB,KAAK,OAAO,KACnC,uBAAuB,KAAK,OAAO;AAAA,IAAA,CAEpC;AAEM,WAAA,OAAO,MAAM,gBAAgB;AAAA,EACrC;AAAA,EAEA,MAAM,2CAAwC;AACvC,UAAA,WAAW,MAAM,KAAK;AAE5B,WAAO,SAAS,IAAI,CAAC,SAAS,MAAK;AAC5B,YAAA,kBAAkB,SAAS,IAAI,CAAC;AAE/B,aAAA;AAAA,QACN;AAAA,QACA,MAAM,sBAAsB,SAAS,eAAe;AAAA,MAAA;AAAA,KAErD;AAAA,EACF;AAAA,EAEA,MAAM,0CAAuC;AACtC,UAAA,WAAW,MAAM,KAAK;AACtB,UAAA,iBAAiB,MAAM,KAAK;AAElC,WAAO,OAAO,cAAc,UAAU,IAAI,gBAAgB,KAAK;AAAA,EAChE;AAAA,EAEA,MAAM,yBAAsB;AACrB,UAAA,WAAW,MAAM,KAAK;AACtB,UAAA,iBAAiB,MAAM,KAAK;AAElC,WAAO,OAAO,GAAG,SAAS,CAAC,GAAG,cAAc;AAAA,EAC7C;AAAA,EAEA,MAAM,sCACL,MAAsD;AAEtD,WAAO,MAAM,iCAAiC;AAAA,MAC7C,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,aAAa;AAAA,MACb,SAAS,KAAK;AAAA,MACd,OAAO,KAAK;AAAA,IAAA,CACZ;AAAA,EACF;AACA;"}
+{"version":3,"file":"VersionsManager.js","sources":["../../../../src/managers/versions/VersionsManager.ts"],"sourcesContent":["import * as fs from \"node:fs/promises\";\nimport * as path from \"node:path\";\nimport semver from \"semver\";\n\nimport { decodePackageJSON } from \"../../lib/decodePackageJSON\";\nimport {\n\tfetchGitHubReleaseBodyForRelease,\n\tGitHubReleaseMetadata,\n} from \"../../lib/fetchGitHubReleaseBodyForRelease\";\nimport { fetchNPMPackageVersions } from \"../../lib/fetchNPMPackageVersions\";\n\nimport { SLICE_MACHINE_GITHUB_PACKAGE_NAME } from \"../../constants/SLICE_MACHINE_GITHUB_PACKAGE_NAME\";\nimport { SLICE_MACHINE_GITHUB_REPOSITORY_NAME } from \"../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_NAME\";\nimport { SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION } from \"../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION\";\nimport { SLICE_MACHINE_NPM_PACKAGE_NAME } from \"../../constants/SLICE_MACHINE_NPM_PACKAGE_NAME\";\nimport { VERSION_KIND } from \"../../constants/VERSION_KIND\";\n\nimport { BaseManager } from \"../BaseManager\";\n\nimport { Version } from \"./types\";\n\nconst detectVersionBumpKind = (\n\tto: string,\n\tfrom?: string,\n): typeof VERSION_KIND[keyof typeof VERSION_KIND] | undefined => {\n\tif (!from) {\n\t\treturn VERSION_KIND.FIRST;\n\t}\n\n\tif (semver.eq(to, from)) {\n\t\treturn undefined;\n\t} else if (semver.satisfies(to, `~${from}`)) {\n\t\treturn VERSION_KIND.PATCH;\n\t} else if (semver.satisfies(to, `^${from}`)) {\n\t\treturn VERSION_KIND.MINOR;\n\t} else {\n\t\treturn VERSION_KIND.MAJOR;\n\t}\n};\n\ntype SliceMachineManagerGetReleaseNotesForVersionArgs = {\n\tversion: string;\n};\n\nexport class VersionsManager extends BaseManager {\n\t/**\n\t * Record of version numbers mapped to their GitHub release metadata.\n\t */\n\tgitHubSliceMachineReleaseMetadataCache: Record<\n\t\tstring,\n\t\tGitHubReleaseMetadata | undefined\n\t> = {};\n\n\tasync getRunningSliceMachineVersion(): Promise<string> {\n\t\tconst sliceMachineDir = await this.project.locateSliceMachineUIDir();\n\n\t\tconst sliceMachinePackageJSONContents = await fs.readFile(\n\t\t\tpath.join(sliceMachineDir, \"package.json\"),\n\t\t\t\"utf8\",\n\t\t);\n\n\t\tlet sliceMachinePackageJSON: unknown;\n\t\ttry {\n\t\t\tsliceMachinePackageJSON = JSON.parse(sliceMachinePackageJSONContents);\n\t\t} catch {\n\t\t\t// noop\n\t\t}\n\n\t\tconst { value, error } = decodePackageJSON(sliceMachinePackageJSON);\n\n\t\tif (error) {\n\t\t\tthrow new Error(\n\t\t\t\t`Invalid ${SLICE_MACHINE_NPM_PACKAGE_NAME} \\`package.json\\` file. ${error.errors.join(\n\t\t\t\t\t\", \",\n\t\t\t\t)}`,\n\t\t\t);\n\t\t}\n\n\t\treturn value.version;\n\t}\n\n\tasync getAllStableSliceMachineVersions(): Promise<string[]> {\n\t\tconst versions = await fetchNPMPackageVersions({\n\t\t\tpackageName: SLICE_MACHINE_NPM_PACKAGE_NAME,\n\t\t});\n\n\t\tconst filteredVersions = versions.filter((version) => {\n\t\t\t// Exclude tagged versions (e.g. `1.0.0-alpha.0`).\n\t\t\t// Exclude versions < 0.1.0 (e.g. `0.0.1`).\n\t\t\treturn (\n\t\t\t\t/^[1-9]\\d*\\.\\d+\\.\\d+$/.test(version) ||\n\t\t\t\t/^\\d+\\.[1-9]\\d*\\.\\d+$/.test(version)\n\t\t\t);\n\t\t});\n\n\t\treturn semver.rsort(filteredVersions);\n\t}\n\n\tasync getAllStableSliceMachineVersionsWithKind(): Promise<Version[]> {\n\t\tconst versions = await this.getAllStableSliceMachineVersions();\n\n\t\treturn versions.map((version, i) => {\n\t\t\tconst previousVersion = versions[i + 1];\n\n\t\t\treturn {\n\t\t\t\tversion,\n\t\t\t\tkind: detectVersionBumpKind(version, previousVersion),\n\t\t\t};\n\t\t});\n\t}\n\n\tasync getLatestNonBreakingSliceMachineVersion(): Promise<string | undefined> {\n\t\tconst versions = await this.getAllStableSliceMachineVersions();\n\t\tconst currentVersion = await this.getRunningSliceMachineVersion();\n\n\t\treturn semver.maxSatisfying(versions, `^${currentVersion}`) ?? undefined;\n\t}\n\n\tasync checkIsUpdateAvailable(): Promise<boolean> {\n\t\tconst versions = await this.getAllStableSliceMachineVersions();\n\t\tconst currentVersion = await this.getRunningSliceMachineVersion();\n\n\t\treturn semver.gt(versions[0], currentVersion);\n\t}\n\n\tasync getSliceMachineReleaseNotesForVersion(\n\t\targs: SliceMachineManagerGetReleaseNotesForVersionArgs,\n\t): Promise<string | undefined> {\n\t\treturn await fetchGitHubReleaseBodyForRelease({\n\t\t\trepositoryOwner: SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION,\n\t\t\trepositoryName: SLICE_MACHINE_GITHUB_REPOSITORY_NAME,\n\t\t\tpackageName: SLICE_MACHINE_GITHUB_PACKAGE_NAME,\n\t\t\tversion: args.version,\n\t\t\tcache: this.gitHubSliceMachineReleaseMetadataCache,\n\t\t});\n\t}\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;AAqBA,MAAM,wBAAwB,CAC7B,IACA,SAC+D;AAC/D,MAAI,CAAC,MAAM;AACV,WAAO,aAAa;AAAA,EACpB;AAED,MAAI,OAAO,GAAG,IAAI,IAAI,GAAG;AACjB,WAAA;AAAA,EAAA,WACG,OAAO,UAAU,IAAI,IAAI,MAAM,GAAG;AAC5C,WAAO,aAAa;AAAA,EAAA,WACV,OAAO,UAAU,IAAI,IAAI,MAAM,GAAG;AAC5C,WAAO,aAAa;AAAA,EAAA,OACd;AACN,WAAO,aAAa;AAAA,EACpB;AACF;AAMM,MAAO,wBAAwB,YAAW;AAAA,EAA1C;AAAA;AAIL;AAAA;AAAA;AAAA,kEAGI,CAAA;AAAA;AAAA,EAEJ,MAAM,gCAA6B;AAClC,UAAM,kBAAkB,MAAM,KAAK,QAAQ,wBAAuB;AAE5D,UAAA,kCAAkC,MAAM,GAAG,SAChD,KAAK,KAAK,iBAAiB,cAAc,GACzC,MAAM;AAGH,QAAA;AACA,QAAA;AACuB,gCAAA,KAAK,MAAM,+BAA+B;AAAA,IAAA,QACnE;AAAA,IAED;AAED,UAAM,EAAE,OAAO,MAAK,IAAK,kBAAkB,uBAAuB;AAElE,QAAI,OAAO;AACJ,YAAA,IAAI,MACT,WAAW,yDAAyD,MAAM,OAAO,KAChF,IAAI,GACF;AAAA,IAEJ;AAED,WAAO,MAAM;AAAA,EACd;AAAA,EAEA,MAAM,mCAAgC;AAC/B,UAAA,WAAW,MAAM,wBAAwB;AAAA,MAC9C,aAAa;AAAA,IAAA,CACb;AAED,UAAM,mBAAmB,SAAS,OAAO,CAAC,YAAW;AAGpD,aACC,uBAAuB,KAAK,OAAO,KACnC,uBAAuB,KAAK,OAAO;AAAA,IAAA,CAEpC;AAEM,WAAA,OAAO,MAAM,gBAAgB;AAAA,EACrC;AAAA,EAEA,MAAM,2CAAwC;AACvC,UAAA,WAAW,MAAM,KAAK;AAE5B,WAAO,SAAS,IAAI,CAAC,SAAS,MAAK;AAC5B,YAAA,kBAAkB,SAAS,IAAI,CAAC;AAE/B,aAAA;AAAA,QACN;AAAA,QACA,MAAM,sBAAsB,SAAS,eAAe;AAAA,MAAA;AAAA,KAErD;AAAA,EACF;AAAA,EAEA,MAAM,0CAAuC;AACtC,UAAA,WAAW,MAAM,KAAK;AACtB,UAAA,iBAAiB,MAAM,KAAK;AAElC,WAAO,OAAO,cAAc,UAAU,IAAI,gBAAgB,KAAK;AAAA,EAChE;AAAA,EAEA,MAAM,yBAAsB;AACrB,UAAA,WAAW,MAAM,KAAK;AACtB,UAAA,iBAAiB,MAAM,KAAK;AAElC,WAAO,OAAO,GAAG,SAAS,CAAC,GAAG,cAAc;AAAA,EAC7C;AAAA,EAEA,MAAM,sCACL,MAAsD;AAEtD,WAAO,MAAM,iCAAiC;AAAA,MAC7C,iBAAiB;AAAA,MACjB,gBAAgB;AAAA,MAChB,aAAa;AAAA,MACb,SAAS,KAAK;AAAA,MACd,OAAO,KAAK;AAAA,IAAA,CACZ;AAAA,EACF;AACA;"}

package/dist/managers/versions/types.d.ts

@@ -1,5 +1,5 @@
 import { VERSION_KIND } from "../../constants/VERSION_KIND";
 export type Version = {
     version: string;
-    kind: typeof VERSION_KIND[keyof typeof VERSION_KIND];
+    kind: typeof VERSION_KIND[keyof typeof VERSION_KIND] | undefined;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@slicemachine/manager",
-	"version": "0.1.1-dev-plugins.11",
+	"version": "0.1.1-dev-plugins.12",
 	"description": "Manage all aspects of a Slice Machine project.",
 	"repository": {
 		"type": "git",
@@ -52,7 +52,8 @@
 		"lint": "eslint --ext .js,.ts .",
 		"prepare": "npm run build",
 		"size": "size-limit",
-		"test": "npm run lint && npm run unit && npm run build && npm run size",
+		"test": "npm run lint && npm run types && npm run unit && npm run build && npm run size",
+		"types": "tsc --noEmit",
 		"unit": "vitest run --coverage",
 		"unit:watch": "vitest watch",
 		"depcheck": "depcheck --config=.depcheckrc"
@@ -60,7 +61,7 @@
 	"dependencies": {
 		"@prismicio/custom-types-client": "^1.0.2",
 		"@prismicio/types-internal": "^1.5.3",
-		"@slicemachine/plugin-kit": "0.1.8-dev-plugins.11",
+		"@slicemachine/plugin-kit": "0.1.8-dev-plugins.12",
 		"@wooorm/starry-night": "^1.4.2",
 		"analytics-node": "^6.2.0",
 		"cookie": "^0.5.0",
@@ -87,8 +88,9 @@
 	"devDependencies": {
 		"@prismicio/mock": "^0.2.0",
 		"@size-limit/preset-small-lib": "^8.1.0",
-		"@types/analytics-node": "^3.1.9",
+		"@types/analytics-node": "^3.1.10",
 		"@types/cookie": "^0.5.1",
+		"@types/express": "^4.17.17",
 		"@types/semver": "^7.3.13",
 		"@typescript-eslint/eslint-plugin": "~5.46.1",
 		"@typescript-eslint/parser": "^5.46.1",
@@ -124,5 +126,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "033da5acbcbf93792fa478b4d83386034a0f4f09"
+	"gitHead": "913882c4079ffcab3a72938b4be902470c1e3c32"
 }

package/src/constants/API_ENDPOINTS.ts

@@ -1,6 +1,6 @@
 import { APPLICATION_MODE } from "./APPLICATION_MODE";
 
-type APIEndpoints = {
+export type APIEndpoints = {
 	PrismicWroom: string;
 	PrismicAuthentication: string;
 	PrismicModels: string;

package/src/errors.ts

@@ -1,53 +1,6 @@
-// const Errors = {
-// 	1000: {
-// 		message: "Could not refresh token",
-// 		description:
-// 			"You are not logged in. Log in before refreshing your authentication token.",
-// 	},
-// 	1001: {
-// 		message: "Failed to refresh authentication token",
-// 		description:
-// 			"The Prismic Authentication service returned an invalid response.",
-// 	},
-// 	1002: {
-// 		message: "Failed to refresh authentication token",
-// 		description:
-// 			"You are not logged in. Log in before attempting to get your authentication token.",
-// 	},
-// 	// 1000: {
-// 	// 	message: "Unauthenticated",
-// 	// 	description:
-// 	// 		"Unable to access the Prismic Custom Types API. Log in to fix this issue.",
-// 	// },
-// 	// 1001: {
-// 	// 	message: "Unauthorized",
-// 	// 	description:
-// 	// 		"Unable to access the Prismic Custom Types API. Grant the user access to the repository to fix this issue.",
-// 	// },
-// } as const;
-// type Errors = typeof Errors;
-
 import { HookError } from "@slicemachine/plugin-kit";
 
-// const InternalErrorCodes = {
-// 	Unauthorized: "Unauthorized",
-// 	Unauthenticated: "Unauthenticated",
-// 	InternalServerError: "InternalServerError",
-// } as const;
-// type InternalErrorCodes =
-// 	typeof InternalErrorCodes[keyof typeof InternalErrorCodes];
-
-// type InternalErrorCode =
-// 	| typeof InternalError.Unauthorized
-// 	| typeof InternalError.Unauthenticated
-// 	| typeof InternalError.InternalServerError;
-
-// type InternalErrorArgs = {
-// 	message?: string;
-// 	cause?: Error;
-// };
-
-export abstract class SliceMachineError extends Error {
+export class SliceMachineError extends Error {
 	_sliceMachineError = true;
 	name = "SliceMachineError";
 }
@@ -118,29 +71,3 @@ export const isUnexpectedDataError = (
 export const isInternalError = (error: unknown): error is InternalError => {
 	return isSliceMachineError(error) && error.name === InternalError.name;
 };
-
-// export class InternalError<TCode extends InternalErrorCode> extends Error {
-// 	static Unauthorized = "Unauthorized" as const;
-// 	static Unauthenticated = "Unauthenticated" as const;
-// 	static InternalServerError = "InternalServerError" as const;
-//
-// 	code: TCode;
-// 	cause?: Error;
-//
-// 	constructor(code: TCode, args: InternalErrorArgs = {}) {
-// 		super(args.message);
-//
-// 		this.code = code;
-// 		this.cause = args.cause;
-//
-// 		// const error = Errors[code];
-//
-// 		// this.message = error.message as TMessage;
-//
-// 		// if ("description" in error) {
-// 		// 	this.description = error.description as TDescription;
-// 		// } else {
-// 		// 	this.description = undefined as TDescription;
-// 		// }
-// 	}
-// }

package/src/lib/decodePackageJSON.ts

@@ -0,0 +1,18 @@
+import * as t from "io-ts";
+
+import { decode, DecodeReturnType } from "./decode";
+
+/**
+ * A minimally defined codec for package.json files. Only data needed for
+ * version detection is defined.
+ */
+const PackageJSONCodec = t.type({
+	version: t.string,
+});
+type PackageJSON = t.TypeOf<typeof PackageJSONCodec>;
+
+export const decodePackageJSON = (
+	input: unknown,
+): DecodeReturnType<PackageJSON, PackageJSON, unknown> => {
+	return decode(PackageJSONCodec, input);
+};

package/src/lib/locateFileUpward.ts

@@ -24,25 +24,21 @@ export const locateFileUpward = async (
 
 	const filePaths = castArray(filePathOrPaths);
 
-	try {
-		for (const filePath of filePaths) {
-			const resolvedFilePath = path.resolve(startDir, filePath);
+	for (const filePath of filePaths) {
+		const resolvedFilePath = path.resolve(startDir, filePath);
 
-			try {
-				await fs.access(resolvedFilePath);
+		try {
+			await fs.access(resolvedFilePath);
 
-				return resolvedFilePath;
-			} catch {
-				continue;
-			}
+			return resolvedFilePath;
+		} catch {
+			continue;
 		}
-	} catch {
-		// noop
 	}
 
 	if (startDir === stopDir) {
 		const formattedFilePaths = filePaths
-			.map((filePath) => `\`${filePath}\``)
+			.map((filePath) => "`" + filePath + "`")
 			.join(" or ");
 
 		throw new Error(

package/src/managers/SliceMachineManager.ts

@@ -19,6 +19,8 @@ import {
 } from "../auth/PrismicAuthManager";
 import { createPrismicAuthManager } from "../auth/createPrismicAuthManager";
 
+import { API_ENDPOINTS, APIEndpoints } from "../constants/API_ENDPOINTS";
+
 import { UserManager } from "./user/UserManager";
 import { PrismicRepositoryManager } from "./prismicRepository/PrismicRepositoryManager";
 
@@ -153,6 +155,10 @@ export class SliceMachineManager {
 		return this._prismicAuthManager;
 	}
 
+	getAPIEndpoints(): APIEndpoints {
+		return API_ENDPOINTS;
+	}
+
 	// TODO: Remove this global-state method. It is expensive and a
 	// potential source of bugs due to data inconsistency. SM UI relies on
 	// it heavily, so removal will require significant effort.

package/src/managers/createSliceMachineManager.ts

@@ -2,10 +2,10 @@ import { SliceMachineManager } from "./SliceMachineManager";
 
 type CreateSliceMachineManagerArgs = ConstructorParameters<
 	typeof SliceMachineManager
->[0];
+>;
 
 export const createSliceMachineManager = (
-	args?: CreateSliceMachineManagerArgs,
+	...args: CreateSliceMachineManagerArgs
 ): SliceMachineManager => {
-	return new SliceMachineManager(args);
+	return new SliceMachineManager(...args);
 };

package/src/managers/slices/SlicesManager.ts

@@ -104,7 +104,7 @@ type SliceMachineManagerReadSliceMocksArgs = {
 
 type SliceMachineManagerReadSliceMocksReturnType = {
 	mocks?: SharedSliceContent[];
-	errors: HookError[];
+	errors: (DecodeError | HookError)[];
 };
 
 type SliceMachineManagerReadSliceMocksConfigArgs = {
@@ -467,19 +467,36 @@ export class SlicesManager extends BaseManager {
 				assetID: `mocks.json`,
 			},
 		);
-		const data = hookResult.data[0]?.data;
-
-		// TODO: Validate the returned mocks.
+		const { data, errors } = decodeHookResult(
+			t.type({
+				data: t.array(SharedSliceContent),
+			}),
+			{
+				...hookResult,
+				// Convert the asset data from a Buffer to JSON
+				// to prepare it for validation.
+				data: hookResult.data.map((result) => {
+					try {
+						return {
+							...result,
+							data: JSON.parse(result.data.toString()),
+						};
+					} catch {
+						return result;
+					}
+				}),
+			},
+		);
 
 		if (data) {
 			return {
-				mocks: JSON.parse(data.toString()),
-				errors: hookResult.errors,
+				mocks: data[0]?.data,
+				errors,
 			};
 		} else {
 			return {
 				mocks: [],
-				errors: hookResult.errors,
+				errors,
 			};
 		}
 	}

package/src/managers/telemetry/TelemetryManager.ts

@@ -56,6 +56,12 @@ export class TelemetryManager extends BaseManager {
 			flushAt: 1,
 			// TODO: Verify that this actually does not send data to Segment when false.
 			enable: this._enabled,
+			errorHandler: () => {
+				// noop - We don't care if the tracking event
+				// failed. Some users or networks intentionally
+				// block Segment, so we can't block the app if
+				// a tracking event is unsuccessful.
+			},
 		});
 		this._anonymousID = randomUUID();
 	}

package/src/managers/user/UserManager.ts

@@ -1,6 +1,18 @@
+import { SliceMachineError } from "../../errors";
 import { BaseManager } from "../BaseManager";
+import { SliceMachineManager } from "../SliceMachineManager";
 
 export class UserManager extends BaseManager {
+	constructor(sliceMachineManager: SliceMachineManager) {
+		super(sliceMachineManager);
+
+		if (!sliceMachineManager.getPrismicAuthManager()) {
+			throw new SliceMachineError(
+				"SliceMachineManager._prismicAuthManager must be set with a PrismicAuthManager instance before instantiating UserManager.",
+			);
+		}
+	}
+
 	login = this.prismicAuthManager.login.bind(this.prismicAuthManager);
 	getLoginSessionInfo = this.prismicAuthManager.getLoginSessionInfo.bind(
 		this.prismicAuthManager,

package/src/managers/versions/VersionsManager.ts

@@ -2,6 +2,7 @@ import * as fs from "node:fs/promises";
 import * as path from "node:path";
 import semver from "semver";
 
+import { decodePackageJSON } from "../../lib/decodePackageJSON";
 import {
 	fetchGitHubReleaseBodyForRelease,
 	GitHubReleaseMetadata,
@@ -21,12 +22,14 @@ import { Version } from "./types";
 const detectVersionBumpKind = (
 	to: string,
 	from?: string,
-): typeof VERSION_KIND[keyof typeof VERSION_KIND] => {
+): typeof VERSION_KIND[keyof typeof VERSION_KIND] | undefined => {
 	if (!from) {
 		return VERSION_KIND.FIRST;
 	}
 
-	if (semver.satisfies(to, `~${from}`)) {
+	if (semver.eq(to, from)) {
+		return undefined;
+	} else if (semver.satisfies(to, `~${from}`)) {
 		return VERSION_KIND.PATCH;
 	} else if (semver.satisfies(to, `^${from}`)) {
 		return VERSION_KIND.MINOR;
@@ -56,11 +59,24 @@ export class VersionsManager extends BaseManager {
 			"utf8",
 		);
 
-		// TODO: Validate the contents? This code currently assumes a
-		// well-formed document.
-		const json = JSON.parse(sliceMachinePackageJSONContents);
+		let sliceMachinePackageJSON: unknown;
+		try {
+			sliceMachinePackageJSON = JSON.parse(sliceMachinePackageJSONContents);
+		} catch {
+			// noop
+		}
 
-		return json.version;
+		const { value, error } = decodePackageJSON(sliceMachinePackageJSON);
+
+		if (error) {
+			throw new Error(
+				`Invalid ${SLICE_MACHINE_NPM_PACKAGE_NAME} \`package.json\` file. ${error.errors.join(
+					", ",
+				)}`,
+			);
+		}
+
+		return value.version;
 	}
 
 	async getAllStableSliceMachineVersions(): Promise<string[]> {

package/src/managers/versions/types.ts

@@ -2,5 +2,5 @@ import { VERSION_KIND } from "../../constants/VERSION_KIND";
 
 export type Version = {
 	version: string;
-	kind: typeof VERSION_KIND[keyof typeof VERSION_KIND];
+	kind: typeof VERSION_KIND[keyof typeof VERSION_KIND] | undefined;
 };