@slicemachine/manager 0.1.1-dev-plugins.3

package/dist/managers/telemetry/TelemetryManager.js

@@ -0,0 +1,105 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { randomUUID } from "node:crypto";
+import SegmentClient from "analytics-node";
+import { readPrismicrc } from "../../lib/prismicrc.js";
+import { API_TOKENS } from "../../constants/API_TOKENS.js";
+import { BaseManager } from "../BaseManager.js";
+import { HumanSegmentEventType } from "./types.js";
+function assertTelemetryInitialized(segmentClient) {
+  if (segmentClient == void 0) {
+    throw new Error("Telemetry has not been initialized. Run `SliceMachineManager.telemetry.prototype.initTelemetry()` before re-calling this method.");
+  }
+}
+class TelemetryManager extends BaseManager {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "_enabled", false);
+    __publicField(this, "_segmentClient");
+    __publicField(this, "_anonymousID");
+    __publicField(this, "_userID");
+  }
+  async initTelemetry() {
+    if (this._segmentClient) {
+      return;
+    }
+    let root;
+    try {
+      root = await this.project.getRoot();
+    } catch {
+      root = await this.project.suggestRoot();
+    }
+    this._enabled = readPrismicrc(root).telemetry !== false;
+    this._segmentClient = new SegmentClient(API_TOKENS.SegmentKey, {
+      // Since it's a local app, we do not benefit from event batching the way a server would normally do, all tracking event will be awaited.
+      flushAt: 1,
+      // TODO: Verify that this actually does not send data to Segment when false.
+      enable: this._enabled
+    });
+    this._anonymousID = randomUUID();
+  }
+  // TODO: Should `userId` be automatically populated by the logged in
+  // user? We already have their info via UserRepository.
+  track(args) {
+    var _a;
+    const { event, repository, ...properties } = args;
+    const payload = {
+      event: HumanSegmentEventType[event],
+      properties: {
+        repo: repository,
+        ...properties
+      }
+    };
+    if (this._userID) {
+      payload.userId = this._userID;
+    } else {
+      payload.anonymousId = this._anonymousID;
+    }
+    if (args.repository) {
+      payload.context || (payload.context = {});
+      (_a = payload.context).groupId || (_a.groupId = {});
+      payload.context.groupId.Repository = repository;
+    }
+    return new Promise((resolve) => {
+      assertTelemetryInitialized(this._segmentClient);
+      this._segmentClient.track(payload, (maybeError) => {
+        if (maybeError) {
+          console.warn(`An error occurred during Segment tracking`, maybeError);
+        }
+        resolve();
+      });
+    });
+  }
+  // TODO: Should `userID` and `intercomHash` be automatically populated
+  // by the logged in user? We already have their info via
+  // UserRepository.
+  identify(args) {
+    return new Promise((resolve) => {
+      assertTelemetryInitialized(this._segmentClient);
+      const payload = {
+        userId: args.userID,
+        anonymousId: this._anonymousID,
+        integrations: {
+          Intercom: {
+            user_hash: args.intercomHash
+          }
+        }
+      };
+      this._userID = args.userID;
+      this._segmentClient.identify(payload, (maybeError) => {
+        if (maybeError) {
+          console.warn(`An error occurred during Segment identify`, maybeError);
+        }
+        resolve();
+      });
+    });
+  }
+}
+export {
+  TelemetryManager
+};
+//# sourceMappingURL=TelemetryManager.js.map

package/dist/managers/telemetry/TelemetryManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryManager.js","sources":["../../../../src/managers/telemetry/TelemetryManager.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\n\nimport SegmentClient from \"analytics-node\";\n\nimport { readPrismicrc } from \"../../lib/prismicrc\";\n\nimport { API_TOKENS } from \"../../constants/API_TOKENS\";\n\nimport { BaseManager } from \"../BaseManager\";\n\nimport {\n\tHumanSegmentEventType,\n\tHumanSegmentEventTypes,\n\tSegmentEvents,\n} from \"./types\";\n\ntype TelemetryManagerTrackArgs = SegmentEvents;\n\ntype TelemetryManagerIdentifyArgs = {\n\tuserID: string;\n\tintercomHash: string;\n};\n\nfunction assertTelemetryInitialized(\n\tsegmentClient: SegmentClient | undefined,\n): asserts segmentClient is NonNullable<typeof segmentClient> {\n\tif (segmentClient == undefined) {\n\t\tthrow new Error(\n\t\t\t\"Telemetry has not been initialized. Run `SliceMachineManager.telemetry.prototype.initTelemetry()` before re-calling this method.\",\n\t\t);\n\t}\n}\n\nexport class TelemetryManager extends BaseManager {\n\tprivate _enabled = false;\n\tprivate _segmentClient: SegmentClient | undefined = undefined;\n\tprivate _anonymousID: string | undefined = undefined;\n\tprivate _userID: string | undefined = undefined;\n\n\tasync initTelemetry(): Promise<void> {\n\t\tif (this._segmentClient) {\n\t\t\t// Prevent subsequent initializations.\n\t\t\treturn;\n\t\t}\n\n\t\tlet root: string;\n\t\ttry {\n\t\t\troot = await this.project.getRoot();\n\t\t} catch {\n\t\t\troot = await this.project.suggestRoot();\n\t\t}\n\n\t\tthis._enabled = readPrismicrc(root).telemetry !== false;\n\t\tthis._segmentClient = new SegmentClient(API_TOKENS.SegmentKey, {\n\t\t\t// Since it's a local app, we do not benefit from event batching the way a server would normally do, all tracking event will be awaited.\n\t\t\tflushAt: 1,\n\t\t\t// TODO: Verify that this actually does not send data to Segment when false.\n\t\t\tenable: this._enabled,\n\t\t});\n\t\tthis._anonymousID = randomUUID();\n\t}\n\n\t// TODO: Should `userId` be automatically populated by the logged in\n\t// user? We already have their info via UserRepository.\n\ttrack(args: TelemetryManagerTrackArgs): Promise<void> {\n\t\tconst { event, repository, ...properties } = args;\n\n\t\tconst payload: {\n\t\t\tevent: HumanSegmentEventTypes;\n\t\t\tuserId?: string;\n\t\t\tanonymousId?: string;\n\t\t\tproperties?: Record<string, unknown>;\n\t\t\tcontext?: {\n\t\t\t\tgroupId?: {\n\t\t\t\t\tRepository?: string;\n\t\t\t\t};\n\t\t\t};\n\t\t} = {\n\t\t\tevent: HumanSegmentEventType[event],\n\t\t\tproperties: {\n\t\t\t\trepo: repository,\n\t\t\t\t...properties,\n\t\t\t},\n\t\t};\n\n\t\tif (this._userID) {\n\t\t\tpayload.userId = this._userID;\n\t\t} else {\n\t\t\tpayload.anonymousId = this._anonymousID;\n\t\t}\n\n\t\tif (args.repository) {\n\t\t\tpayload.context ||= {};\n\t\t\tpayload.context.groupId ||= {};\n\t\t\tpayload.context.groupId.Repository = repository;\n\t\t}\n\n\t\treturn new Promise((resolve) => {\n\t\t\tassertTelemetryInitialized(this._segmentClient);\n\n\t\t\t// TODO: Make sure client fails gracefully when no internet connection\n\t\t\tthis._segmentClient.track(payload, (maybeError?: Error) => {\n\t\t\t\tif (maybeError) {\n\t\t\t\t\t// TODO: Not sure how we want to deal with that\n\t\t\t\t\tconsole.warn(`An error occurred during Segment tracking`, maybeError);\n\t\t\t\t}\n\n\t\t\t\tresolve();\n\t\t\t});\n\t\t});\n\t}\n\n\t// TODO: Should `userID` and `intercomHash` be automatically populated\n\t// by the logged in user? We already have their info via\n\t// UserRepository.\n\tidentify(args: TelemetryManagerIdentifyArgs): Promise<void> {\n\t\treturn new Promise((resolve) => {\n\t\t\tassertTelemetryInitialized(this._segmentClient);\n\n\t\t\tconst payload = {\n\t\t\t\tuserId: args.userID,\n\t\t\t\tanonymousId: this._anonymousID,\n\t\t\t\tintegrations: {\n\t\t\t\t\tIntercom: {\n\t\t\t\t\t\tuser_hash: args.intercomHash,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t};\n\t\t\tthis._userID = args.userID;\n\n\t\t\t// TODO: Make sure client fails gracefully when no internet connection\n\t\t\tthis._segmentClient.identify(payload, (maybeError?: Error) => {\n\t\t\t\tif (maybeError) {\n\t\t\t\t\t// TODO: Not sure how we want to deal with that\n\t\t\t\t\tconsole.warn(`An error occurred during Segment identify`, maybeError);\n\t\t\t\t}\n\n\t\t\t\tresolve();\n\t\t\t});\n\t\t});\n\t}\n}\n"],"names":[],"mappings":";;;;;;;;;;;;AAuBA,SAAS,2BACR,eAAwC;AAExC,MAAI,iBAAiB,QAAW;AACzB,UAAA,IAAI,MACT,kIAAkI;AAAA,EAEnI;AACF;AAEM,MAAO,yBAAyB,YAAW;AAAA,EAA3C;AAAA;AACG,oCAAW;AACX;AACA;AACA;AAAA;AAAA,EAER,MAAM,gBAAa;AAClB,QAAI,KAAK,gBAAgB;AAExB;AAAA,IACA;AAEG,QAAA;AACA,QAAA;AACI,aAAA,MAAM,KAAK,QAAQ;YACzB;AACM,aAAA,MAAM,KAAK,QAAQ;IAC1B;AAED,SAAK,WAAW,cAAc,IAAI,EAAE,cAAc;AAClD,SAAK,iBAAiB,IAAI,cAAc,WAAW,YAAY;AAAA;AAAA,MAE9D,SAAS;AAAA;AAAA,MAET,QAAQ,KAAK;AAAA,IAAA,CACb;AACD,SAAK,eAAe;EACrB;AAAA;AAAA;AAAA,EAIA,MAAM,MAA+B;;AACpC,UAAM,EAAE,OAAO,YAAY,GAAG,eAAe;AAE7C,UAAM,UAUF;AAAA,MACH,OAAO,sBAAsB,KAAK;AAAA,MAClC,YAAY;AAAA,QACX,MAAM;AAAA,QACN,GAAG;AAAA,MACH;AAAA,IAAA;AAGF,QAAI,KAAK,SAAS;AACjB,cAAQ,SAAS,KAAK;AAAA,IAAA,OAChB;AACN,cAAQ,cAAc,KAAK;AAAA,IAC3B;AAED,QAAI,KAAK,YAAY;AACpB,cAAQ,YAAR,QAAQ,UAAY;AACZ,oBAAA,SAAQ,YAAR,GAAQ,UAAY;AACpB,cAAA,QAAQ,QAAQ,aAAa;AAAA,IACrC;AAEM,WAAA,IAAI,QAAQ,CAAC,YAAW;AAC9B,iCAA2B,KAAK,cAAc;AAG9C,WAAK,eAAe,MAAM,SAAS,CAAC,eAAsB;AACzD,YAAI,YAAY;AAEP,kBAAA,KAAK,6CAA6C,UAAU;AAAA,QACpE;;OAGD;AAAA,IAAA,CACD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,SAAS,MAAkC;AACnC,WAAA,IAAI,QAAQ,CAAC,YAAW;AAC9B,iCAA2B,KAAK,cAAc;AAE9C,YAAM,UAAU;AAAA,QACf,QAAQ,KAAK;AAAA,QACb,aAAa,KAAK;AAAA,QAClB,cAAc;AAAA,UACb,UAAU;AAAA,YACT,WAAW,KAAK;AAAA,UAChB;AAAA,QACD;AAAA,MAAA;AAEF,WAAK,UAAU,KAAK;AAGpB,WAAK,eAAe,SAAS,SAAS,CAAC,eAAsB;AAC5D,YAAI,YAAY;AAEP,kBAAA,KAAK,6CAA6C,UAAU;AAAA,QACpE;;OAGD;AAAA,IAAA,CACD;AAAA,EACF;AACA;"}

package/dist/managers/telemetry/types.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const SegmentEventType = {
+  command_init_start: "command:init:start",
+  command_init_identify: "command:init:identify",
+  command_init_end: "command:init:end"
+};
+const HumanSegmentEventType = {
+  [SegmentEventType.command_init_start]: "SliceMachine Init Start",
+  [SegmentEventType.command_init_identify]: "SliceMachine Init Identify",
+  [SegmentEventType.command_init_end]: "SliceMachine Init End"
+};
+exports.HumanSegmentEventType = HumanSegmentEventType;
+exports.SegmentEventType = SegmentEventType;
+//# sourceMappingURL=types.cjs.map

package/dist/managers/telemetry/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.cjs","sources":["../../../../src/managers/telemetry/types.ts"],"sourcesContent":["export const SegmentEventType = {\n\tcommand_init_start: \"command:init:start\",\n\tcommand_init_identify: \"command:init:identify\",\n\tcommand_init_end: \"command:init:end\",\n} as const;\ntype SegmentEventTypes = typeof SegmentEventType[keyof typeof SegmentEventType];\n\nexport const HumanSegmentEventType = {\n\t[SegmentEventType.command_init_start]: \"SliceMachine Init Start\",\n\t[SegmentEventType.command_init_identify]: \"SliceMachine Init Identify\",\n\t[SegmentEventType.command_init_end]: \"SliceMachine Init End\",\n} as const;\nexport type HumanSegmentEventTypes =\n\ttypeof HumanSegmentEventType[keyof typeof HumanSegmentEventType];\n\ntype SegmentEvent<\n\tTType extends SegmentEventTypes,\n\tTProperties extends Record<string, unknown> | void = void,\n> = TProperties extends void\n\t? {\n\t\t\tevent: TType;\n\t\t\trepository?: string;\n\t  }\n\t: {\n\t\t\tevent: TType;\n\t\t\trepository?: string;\n\t  } & TProperties;\n\ntype CommandInitStartSegmentEvent = SegmentEvent<\n\ttypeof SegmentEventType.command_init_start\n>;\n\n// This event feels off, we have a dedicated `identify` method...\ntype CommandInitIdentifySegmentEvent = SegmentEvent<\n\ttypeof SegmentEventType.command_init_identify\n>;\n\ntype CommandInitEndSegmentEvent = SegmentEvent<\n\ttypeof SegmentEventType.command_init_end,\n\t{ framework: string; success: boolean; error?: string }\n>;\n\nexport type SegmentEvents =\n\t| CommandInitStartSegmentEvent\n\t| CommandInitIdentifySegmentEvent\n\t| CommandInitEndSegmentEvent;\n"],"names":[],"mappings":";;AAAO,MAAM,mBAAmB;AAAA,EAC/B,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EACvB,kBAAkB;;AAIZ,MAAM,wBAAwB;AAAA,EACpC,CAAC,iBAAiB,kBAAkB,GAAG;AAAA,EACvC,CAAC,iBAAiB,qBAAqB,GAAG;AAAA,EAC1C,CAAC,iBAAiB,gBAAgB,GAAG;;;;"}

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

@@ -0,0 +1,28 @@
+export declare const SegmentEventType: {
+    readonly command_init_start: "command:init:start";
+    readonly command_init_identify: "command:init:identify";
+    readonly command_init_end: "command:init:end";
+};
+type SegmentEventTypes = typeof SegmentEventType[keyof typeof SegmentEventType];
+export declare const HumanSegmentEventType: {
+    readonly "command:init:start": "SliceMachine Init Start";
+    readonly "command:init:identify": "SliceMachine Init Identify";
+    readonly "command:init:end": "SliceMachine Init End";
+};
+export type HumanSegmentEventTypes = typeof HumanSegmentEventType[keyof typeof HumanSegmentEventType];
+type SegmentEvent<TType extends SegmentEventTypes, TProperties extends Record<string, unknown> | void = void> = TProperties extends void ? {
+    event: TType;
+    repository?: string;
+} : {
+    event: TType;
+    repository?: string;
+} & TProperties;
+type CommandInitStartSegmentEvent = SegmentEvent<typeof SegmentEventType.command_init_start>;
+type CommandInitIdentifySegmentEvent = SegmentEvent<typeof SegmentEventType.command_init_identify>;
+type CommandInitEndSegmentEvent = SegmentEvent<typeof SegmentEventType.command_init_end, {
+    framework: string;
+    success: boolean;
+    error?: string;
+}>;
+export type SegmentEvents = CommandInitStartSegmentEvent | CommandInitIdentifySegmentEvent | CommandInitEndSegmentEvent;
+export {};

package/dist/managers/telemetry/types.js

@@ -0,0 +1,15 @@
+const SegmentEventType = {
+  command_init_start: "command:init:start",
+  command_init_identify: "command:init:identify",
+  command_init_end: "command:init:end"
+};
+const HumanSegmentEventType = {
+  [SegmentEventType.command_init_start]: "SliceMachine Init Start",
+  [SegmentEventType.command_init_identify]: "SliceMachine Init Identify",
+  [SegmentEventType.command_init_end]: "SliceMachine Init End"
+};
+export {
+  HumanSegmentEventType,
+  SegmentEventType
+};
+//# sourceMappingURL=types.js.map

package/dist/managers/telemetry/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../../../../src/managers/telemetry/types.ts"],"sourcesContent":["export const SegmentEventType = {\n\tcommand_init_start: \"command:init:start\",\n\tcommand_init_identify: \"command:init:identify\",\n\tcommand_init_end: \"command:init:end\",\n} as const;\ntype SegmentEventTypes = typeof SegmentEventType[keyof typeof SegmentEventType];\n\nexport const HumanSegmentEventType = {\n\t[SegmentEventType.command_init_start]: \"SliceMachine Init Start\",\n\t[SegmentEventType.command_init_identify]: \"SliceMachine Init Identify\",\n\t[SegmentEventType.command_init_end]: \"SliceMachine Init End\",\n} as const;\nexport type HumanSegmentEventTypes =\n\ttypeof HumanSegmentEventType[keyof typeof HumanSegmentEventType];\n\ntype SegmentEvent<\n\tTType extends SegmentEventTypes,\n\tTProperties extends Record<string, unknown> | void = void,\n> = TProperties extends void\n\t? {\n\t\t\tevent: TType;\n\t\t\trepository?: string;\n\t  }\n\t: {\n\t\t\tevent: TType;\n\t\t\trepository?: string;\n\t  } & TProperties;\n\ntype CommandInitStartSegmentEvent = SegmentEvent<\n\ttypeof SegmentEventType.command_init_start\n>;\n\n// This event feels off, we have a dedicated `identify` method...\ntype CommandInitIdentifySegmentEvent = SegmentEvent<\n\ttypeof SegmentEventType.command_init_identify\n>;\n\ntype CommandInitEndSegmentEvent = SegmentEvent<\n\ttypeof SegmentEventType.command_init_end,\n\t{ framework: string; success: boolean; error?: string }\n>;\n\nexport type SegmentEvents =\n\t| CommandInitStartSegmentEvent\n\t| CommandInitIdentifySegmentEvent\n\t| CommandInitEndSegmentEvent;\n"],"names":[],"mappings":"AAAO,MAAM,mBAAmB;AAAA,EAC/B,oBAAoB;AAAA,EACpB,uBAAuB;AAAA,EACvB,kBAAkB;;AAIZ,MAAM,wBAAwB;AAAA,EACpC,CAAC,iBAAiB,kBAAkB,GAAG;AAAA,EACvC,CAAC,iBAAiB,qBAAqB,GAAG;AAAA,EAC1C,CAAC,iBAAiB,gBAAgB,GAAG;;"}

package/dist/managers/user/UserManager.cjs

@@ -0,0 +1,25 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const BaseManager = require("../BaseManager.cjs");
+class UserManager extends BaseManager.BaseManager {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "login", this.prismicAuthManager.login.bind(this.prismicAuthManager));
+    __publicField(this, "getLoginSessionInfo", this.prismicAuthManager.getLoginSessionInfo.bind(this.prismicAuthManager));
+    __publicField(this, "nodeLoginSession", this.prismicAuthManager.nodeLoginSession.bind(this.prismicAuthManager));
+    __publicField(this, "logout", this.prismicAuthManager.logout.bind(this.prismicAuthManager));
+    __publicField(this, "checkIsLoggedIn", this.prismicAuthManager.checkIsLoggedIn.bind(this.prismicAuthManager));
+    __publicField(this, "refreshAuthenticationToken", this.prismicAuthManager.refreshAuthenticationToken.bind(this.prismicAuthManager));
+    __publicField(this, "getAuthenticationToken", this.prismicAuthManager.getAuthenticationToken.bind(this.prismicAuthManager));
+    __publicField(this, "getAuthenticationCookies", this.prismicAuthManager.getAuthenticationCookies.bind(this.prismicAuthManager));
+    __publicField(this, "getProfile", this.prismicAuthManager.getProfile.bind(this.prismicAuthManager));
+  }
+}
+exports.UserManager = UserManager;
+//# sourceMappingURL=UserManager.cjs.map

package/dist/managers/user/UserManager.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserManager.cjs","sources":["../../../../src/managers/user/UserManager.ts"],"sourcesContent":["import { BaseManager } from \"../BaseManager\";\n\nexport class UserManager extends BaseManager {\n\tlogin = this.prismicAuthManager.login.bind(this.prismicAuthManager);\n\tgetLoginSessionInfo = this.prismicAuthManager.getLoginSessionInfo.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\tnodeLoginSession = this.prismicAuthManager.nodeLoginSession.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\tlogout = this.prismicAuthManager.logout.bind(this.prismicAuthManager);\n\tcheckIsLoggedIn = this.prismicAuthManager.checkIsLoggedIn.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\trefreshAuthenticationToken =\n\t\tthis.prismicAuthManager.refreshAuthenticationToken.bind(\n\t\t\tthis.prismicAuthManager,\n\t\t);\n\tgetAuthenticationToken = this.prismicAuthManager.getAuthenticationToken.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\tgetAuthenticationCookies =\n\t\tthis.prismicAuthManager.getAuthenticationCookies.bind(\n\t\t\tthis.prismicAuthManager,\n\t\t);\n\tgetProfile = this.prismicAuthManager.getProfile.bind(this.prismicAuthManager);\n}\n"],"names":["BaseManager"],"mappings":";;;;;;;;;AAEM,MAAO,oBAAoBA,YAAAA,YAAW;AAAA,EAAtC;AAAA;AACL,iCAAQ,KAAK,mBAAmB,MAAM,KAAK,KAAK,kBAAkB;AAClE,+CAAsB,KAAK,mBAAmB,oBAAoB,KACjE,KAAK,kBAAkB;AAExB,4CAAmB,KAAK,mBAAmB,iBAAiB,KAC3D,KAAK,kBAAkB;AAExB,kCAAS,KAAK,mBAAmB,OAAO,KAAK,KAAK,kBAAkB;AACpE,2CAAkB,KAAK,mBAAmB,gBAAgB,KACzD,KAAK,kBAAkB;AAExB,sDACC,KAAK,mBAAmB,2BAA2B,KAClD,KAAK,kBAAkB;AAEzB,kDAAyB,KAAK,mBAAmB,uBAAuB,KACvE,KAAK,kBAAkB;AAExB,oDACC,KAAK,mBAAmB,yBAAyB,KAChD,KAAK,kBAAkB;AAEzB,sCAAa,KAAK,mBAAmB,WAAW,KAAK,KAAK,kBAAkB;AAAA;AAC5E;;"}

package/dist/managers/user/UserManager.d.ts

@@ -0,0 +1,38 @@
+import { BaseManager } from "../BaseManager";
+export declare class UserManager extends BaseManager {
+    login: (args: {
+        email: string;
+        cookies: string[];
+    }) => Promise<void>;
+    getLoginSessionInfo: () => Promise<{
+        port: number;
+        url: string;
+    }>;
+    nodeLoginSession: (args: {
+        port: number;
+        onListenCallback?: (() => void) | undefined;
+    }) => Promise<void>;
+    logout: () => Promise<void>;
+    checkIsLoggedIn: () => Promise<boolean>;
+    refreshAuthenticationToken: () => Promise<void>;
+    getAuthenticationToken: () => Promise<string>;
+    getAuthenticationCookies: () => Promise<{
+        "prismic-auth"?: string | undefined;
+        SESSION?: string | undefined;
+    } & {
+        [x: string]: string;
+    } & Required<Pick<{
+        "prismic-auth"?: string | undefined;
+        SESSION?: string | undefined;
+    } & {
+        [x: string]: string;
+    }, "prismic-auth" | "SESSION">>>;
+    getProfile: () => Promise<{
+        userId: string;
+        shortId: string;
+        intercomHash: string;
+        email: string;
+        firstName: string;
+        lastName: string;
+    }>;
+}

package/dist/managers/user/UserManager.js

@@ -0,0 +1,25 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import { BaseManager } from "../BaseManager.js";
+class UserManager extends BaseManager {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "login", this.prismicAuthManager.login.bind(this.prismicAuthManager));
+    __publicField(this, "getLoginSessionInfo", this.prismicAuthManager.getLoginSessionInfo.bind(this.prismicAuthManager));
+    __publicField(this, "nodeLoginSession", this.prismicAuthManager.nodeLoginSession.bind(this.prismicAuthManager));
+    __publicField(this, "logout", this.prismicAuthManager.logout.bind(this.prismicAuthManager));
+    __publicField(this, "checkIsLoggedIn", this.prismicAuthManager.checkIsLoggedIn.bind(this.prismicAuthManager));
+    __publicField(this, "refreshAuthenticationToken", this.prismicAuthManager.refreshAuthenticationToken.bind(this.prismicAuthManager));
+    __publicField(this, "getAuthenticationToken", this.prismicAuthManager.getAuthenticationToken.bind(this.prismicAuthManager));
+    __publicField(this, "getAuthenticationCookies", this.prismicAuthManager.getAuthenticationCookies.bind(this.prismicAuthManager));
+    __publicField(this, "getProfile", this.prismicAuthManager.getProfile.bind(this.prismicAuthManager));
+  }
+}
+export {
+  UserManager
+};
+//# sourceMappingURL=UserManager.js.map

package/dist/managers/user/UserManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UserManager.js","sources":["../../../../src/managers/user/UserManager.ts"],"sourcesContent":["import { BaseManager } from \"../BaseManager\";\n\nexport class UserManager extends BaseManager {\n\tlogin = this.prismicAuthManager.login.bind(this.prismicAuthManager);\n\tgetLoginSessionInfo = this.prismicAuthManager.getLoginSessionInfo.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\tnodeLoginSession = this.prismicAuthManager.nodeLoginSession.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\tlogout = this.prismicAuthManager.logout.bind(this.prismicAuthManager);\n\tcheckIsLoggedIn = this.prismicAuthManager.checkIsLoggedIn.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\trefreshAuthenticationToken =\n\t\tthis.prismicAuthManager.refreshAuthenticationToken.bind(\n\t\t\tthis.prismicAuthManager,\n\t\t);\n\tgetAuthenticationToken = this.prismicAuthManager.getAuthenticationToken.bind(\n\t\tthis.prismicAuthManager,\n\t);\n\tgetAuthenticationCookies =\n\t\tthis.prismicAuthManager.getAuthenticationCookies.bind(\n\t\t\tthis.prismicAuthManager,\n\t\t);\n\tgetProfile = this.prismicAuthManager.getProfile.bind(this.prismicAuthManager);\n}\n"],"names":[],"mappings":";;;;;;;AAEM,MAAO,oBAAoB,YAAW;AAAA,EAAtC;AAAA;AACL,iCAAQ,KAAK,mBAAmB,MAAM,KAAK,KAAK,kBAAkB;AAClE,+CAAsB,KAAK,mBAAmB,oBAAoB,KACjE,KAAK,kBAAkB;AAExB,4CAAmB,KAAK,mBAAmB,iBAAiB,KAC3D,KAAK,kBAAkB;AAExB,kCAAS,KAAK,mBAAmB,OAAO,KAAK,KAAK,kBAAkB;AACpE,2CAAkB,KAAK,mBAAmB,gBAAgB,KACzD,KAAK,kBAAkB;AAExB,sDACC,KAAK,mBAAmB,2BAA2B,KAClD,KAAK,kBAAkB;AAEzB,kDAAyB,KAAK,mBAAmB,uBAAuB,KACvE,KAAK,kBAAkB;AAExB,oDACC,KAAK,mBAAmB,yBAAyB,KAChD,KAAK,kBAAkB;AAEzB,sCAAa,KAAK,mBAAmB,WAAW,KAAK,KAAK,kBAAkB;AAAA;AAC5E;"}

package/dist/managers/versions/VersionsManager.cjs

@@ -0,0 +1,104 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const fs = require("node:fs/promises");
+const path = require("node:path");
+const semver = require("semver");
+const fetchGitHubReleaseBodyForRelease = require("../../lib/fetchGitHubReleaseBodyForRelease.cjs");
+const fetchNPMPackageVersions = require("../../lib/fetchNPMPackageVersions.cjs");
+const SLICE_MACHINE_GITHUB_PACKAGE_NAME = require("../../constants/SLICE_MACHINE_GITHUB_PACKAGE_NAME.cjs");
+const SLICE_MACHINE_GITHUB_REPOSITORY_NAME = require("../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_NAME.cjs");
+const SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION = require("../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION.cjs");
+const SLICE_MACHINE_NPM_PACKAGE_NAME = require("../../constants/SLICE_MACHINE_NPM_PACKAGE_NAME.cjs");
+const VERSION_KIND = require("../../constants/VERSION_KIND.cjs");
+const BaseManager = require("../BaseManager.cjs");
+function _interopNamespaceDefault(e) {
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
+  if (e) {
+    for (const k in e) {
+      if (k !== "default") {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+const fs__namespace = /* @__PURE__ */ _interopNamespaceDefault(fs);
+const path__namespace = /* @__PURE__ */ _interopNamespaceDefault(path);
+const detectVersionBumpKind = (to, from) => {
+  if (!from) {
+    return VERSION_KIND.VERSION_KIND.FIRST;
+  }
+  if (semver.satisfies(to, `~${from}`)) {
+    return VERSION_KIND.VERSION_KIND.PATCH;
+  } else if (semver.satisfies(to, `^${from}`)) {
+    return VERSION_KIND.VERSION_KIND.MINOR;
+  } else {
+    return VERSION_KIND.VERSION_KIND.MAJOR;
+  }
+};
+class VersionsManager extends BaseManager.BaseManager {
+  constructor() {
+    super(...arguments);
+    /**
+     * Record of version numbers mapped to their GitHub release metadata.
+     */
+    __publicField(this, "gitHubSliceMachineReleaseMetadataCache", {});
+  }
+  async getRunningSliceMachineVersion() {
+    const sliceMachineDir = await this.project.locateSliceMachineUIDir();
+    const sliceMachinePackageJSONContents = await fs__namespace.readFile(path__namespace.join(sliceMachineDir, "package.json"), "utf8");
+    const json = JSON.parse(sliceMachinePackageJSONContents);
+    return json.version;
+  }
+  async getAllStableSliceMachineVersions() {
+    const versions = await fetchNPMPackageVersions.fetchNPMPackageVersions({
+      packageName: SLICE_MACHINE_NPM_PACKAGE_NAME.SLICE_MACHINE_NPM_PACKAGE_NAME
+    });
+    const filteredVersions = versions.filter((version) => {
+      return /^[1-9]\d*\.\d+\.\d+$/.test(version) || /^\d+\.[1-9]\d*\.\d+$/.test(version);
+    });
+    return semver.rsort(filteredVersions);
+  }
+  async getAllStableSliceMachineVersionsWithKind() {
+    const versions = await this.getAllStableSliceMachineVersions();
+    return versions.map((version, i) => {
+      const previousVersion = versions[i + 1];
+      return {
+        version,
+        kind: detectVersionBumpKind(version, previousVersion)
+      };
+    });
+  }
+  async getLatestNonBreakingSliceMachineVersion() {
+    const versions = await this.getAllStableSliceMachineVersions();
+    const currentVersion = await this.getRunningSliceMachineVersion();
+    return semver.maxSatisfying(versions, `^${currentVersion}`) ?? void 0;
+  }
+  async checkIsUpdateAvailable() {
+    const versions = await this.getAllStableSliceMachineVersions();
+    const currentVersion = await this.getRunningSliceMachineVersion();
+    return semver.gt(versions[0], currentVersion);
+  }
+  async getSliceMachineReleaseNotesForVersion(args) {
+    return await fetchGitHubReleaseBodyForRelease.fetchGitHubReleaseBodyForRelease({
+      repositoryOwner: SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION.SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION,
+      repositoryName: SLICE_MACHINE_GITHUB_REPOSITORY_NAME.SLICE_MACHINE_GITHUB_REPOSITORY_NAME,
+      packageName: SLICE_MACHINE_GITHUB_PACKAGE_NAME.SLICE_MACHINE_GITHUB_PACKAGE_NAME,
+      version: args.version,
+      cache: this.gitHubSliceMachineReleaseMetadataCache
+    });
+  }
+}
+exports.VersionsManager = VersionsManager;
+//# sourceMappingURL=VersionsManager.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"VersionsManager.cjs","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":["VERSION_KIND","BaseManager","fs","path","fetchNPMPackageVersions","SLICE_MACHINE_NPM_PACKAGE_NAME","fetchGitHubReleaseBodyForRelease","SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION","SLICE_MACHINE_GITHUB_REPOSITORY_NAME","SLICE_MACHINE_GITHUB_PACKAGE_NAME"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,MAAM,wBAAwB,CAC7B,IACA,SACmD;AACnD,MAAI,CAAC,MAAM;AACV,WAAOA,aAAAA,aAAa;AAAA,EACpB;AAED,MAAI,OAAO,UAAU,IAAI,IAAI,MAAM,GAAG;AACrC,WAAOA,aAAAA,aAAa;AAAA,EAAA,WACV,OAAO,UAAU,IAAI,IAAI,MAAM,GAAG;AAC5C,WAAOA,aAAAA,aAAa;AAAA,EAAA,OACd;AACN,WAAOA,aAAAA,aAAa;AAAA,EACpB;AACF;AAMM,MAAO,wBAAwBC,YAAAA,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,MAAMC,cAAG,SAChDC,gBAAK,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,MAAMC,gDAAwB;AAAA,MAC9C,aAAaC,+BAAA;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,MAAMC,iCAAAA,iCAAiC;AAAA,MAC7C,iBAAiBC,6CAAA;AAAA,MACjB,gBAAgBC,qCAAA;AAAA,MAChB,aAAaC,kCAAA;AAAA,MACb,SAAS,KAAK;AAAA,MACd,OAAO,KAAK;AAAA,IAAA,CACZ;AAAA,EACF;AACA;;"}

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

@@ -0,0 +1,19 @@
+import { GitHubReleaseMetadata } from "../../lib/fetchGitHubReleaseBodyForRelease";
+import { BaseManager } from "../BaseManager";
+import { Version } from "./types";
+type SliceMachineManagerGetReleaseNotesForVersionArgs = {
+    version: string;
+};
+export declare class VersionsManager extends BaseManager {
+    /**
+     * Record of version numbers mapped to their GitHub release metadata.
+     */
+    gitHubSliceMachineReleaseMetadataCache: Record<string, GitHubReleaseMetadata | undefined>;
+    getRunningSliceMachineVersion(): Promise<string>;
+    getAllStableSliceMachineVersions(): Promise<string[]>;
+    getAllStableSliceMachineVersionsWithKind(): Promise<Version[]>;
+    getLatestNonBreakingSliceMachineVersion(): Promise<string | undefined>;
+    checkIsUpdateAvailable(): Promise<boolean>;
+    getSliceMachineReleaseNotesForVersion(args: SliceMachineManagerGetReleaseNotesForVersionArgs): Promise<string | undefined>;
+}
+export {};

package/dist/managers/versions/VersionsManager.js

@@ -0,0 +1,86 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import semver from "semver";
+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";
+import { SLICE_MACHINE_GITHUB_REPOSITORY_NAME } from "../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_NAME.js";
+import { SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION } from "../../constants/SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION.js";
+import { SLICE_MACHINE_NPM_PACKAGE_NAME } from "../../constants/SLICE_MACHINE_NPM_PACKAGE_NAME.js";
+import { VERSION_KIND } from "../../constants/VERSION_KIND.js";
+import { BaseManager } from "../BaseManager.js";
+const detectVersionBumpKind = (to, from) => {
+  if (!from) {
+    return VERSION_KIND.FIRST;
+  }
+  if (semver.satisfies(to, `~${from}`)) {
+    return VERSION_KIND.PATCH;
+  } else if (semver.satisfies(to, `^${from}`)) {
+    return VERSION_KIND.MINOR;
+  } else {
+    return VERSION_KIND.MAJOR;
+  }
+};
+class VersionsManager extends BaseManager {
+  constructor() {
+    super(...arguments);
+    /**
+     * Record of version numbers mapped to their GitHub release metadata.
+     */
+    __publicField(this, "gitHubSliceMachineReleaseMetadataCache", {});
+  }
+  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;
+  }
+  async getAllStableSliceMachineVersions() {
+    const versions = await fetchNPMPackageVersions({
+      packageName: SLICE_MACHINE_NPM_PACKAGE_NAME
+    });
+    const filteredVersions = versions.filter((version) => {
+      return /^[1-9]\d*\.\d+\.\d+$/.test(version) || /^\d+\.[1-9]\d*\.\d+$/.test(version);
+    });
+    return semver.rsort(filteredVersions);
+  }
+  async getAllStableSliceMachineVersionsWithKind() {
+    const versions = await this.getAllStableSliceMachineVersions();
+    return versions.map((version, i) => {
+      const previousVersion = versions[i + 1];
+      return {
+        version,
+        kind: detectVersionBumpKind(version, previousVersion)
+      };
+    });
+  }
+  async getLatestNonBreakingSliceMachineVersion() {
+    const versions = await this.getAllStableSliceMachineVersions();
+    const currentVersion = await this.getRunningSliceMachineVersion();
+    return semver.maxSatisfying(versions, `^${currentVersion}`) ?? void 0;
+  }
+  async checkIsUpdateAvailable() {
+    const versions = await this.getAllStableSliceMachineVersions();
+    const currentVersion = await this.getRunningSliceMachineVersion();
+    return semver.gt(versions[0], currentVersion);
+  }
+  async getSliceMachineReleaseNotesForVersion(args) {
+    return await fetchGitHubReleaseBodyForRelease({
+      repositoryOwner: SLICE_MACHINE_GITHUB_REPOSITORY_ORGANIZATION,
+      repositoryName: SLICE_MACHINE_GITHUB_REPOSITORY_NAME,
+      packageName: SLICE_MACHINE_GITHUB_PACKAGE_NAME,
+      version: args.version,
+      cache: this.gitHubSliceMachineReleaseMetadataCache
+    });
+  }
+}
+export {
+  VersionsManager
+};
+//# sourceMappingURL=VersionsManager.js.map

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

@@ -0,0 +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;"}

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

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

package/dist/test/createSliceMachineManagerMSWHandler.cjs

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("h3");
+const handleRPCRequest = require('./../__node_modules/r19/dist/handleRPCRequest.cjs');
+const index = require('./../__node_modules/msw/lib/index.cjs');
+const createSliceMachineManagerMiddleware = require("../managers/createSliceMachineManagerMiddleware.cjs");
+const streamToString = async (stream) => {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+};
+const createSliceMachineManagerMSWHandler = (args) => {
+  return index.rest.post(args.url, async (req, res, ctx) => {
+    const rpcResponse = await handleRPCRequest.handleRPCRequest({
+      body: await req.text(),
+      contentTypeHeader: req.headers.get("Content-Type"),
+      procedures: createSliceMachineManagerMiddleware.getSliceMachineManagerProcedures({
+        sliceMachineManager: args.sliceMachineManager
+      })
+    });
+    return res(ctx.body(await streamToString(rpcResponse.stream)), ctx.set(rpcResponse.headers), ctx.status(rpcResponse.statusCode || 200));
+  });
+};
+exports.createSliceMachineManagerMSWHandler = createSliceMachineManagerMSWHandler;
+//# sourceMappingURL=createSliceMachineManagerMSWHandler.cjs.map

package/dist/test/createSliceMachineManagerMSWHandler.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSliceMachineManagerMSWHandler.cjs","sources":["../../../src/test/createSliceMachineManagerMSWHandler.ts"],"sourcesContent":["import { handleRPCRequest } from \"r19\";\nimport { rest, DefaultBodyType, MockedRequest, RestHandler } from \"msw\";\nimport { Readable } from \"node:stream\";\n\nimport { SliceMachineManager } from \"../managers/SliceMachineManager\";\nimport { getSliceMachineManagerProcedures } from \"../managers/createSliceMachineManagerMiddleware\";\n\nconst streamToString = async (stream: Readable) => {\n\tconst chunks: Buffer[] = [];\n\n\tfor await (const chunk of stream) {\n\t\tchunks.push(Buffer.from(chunk));\n\t}\n\n\treturn Buffer.concat(chunks).toString(\"utf-8\");\n};\n\nexport type CreateSliceMachineManagerMSWHandlerArgs = {\n\tsliceMachineManager: SliceMachineManager;\n\turl: string;\n};\n\nexport const createSliceMachineManagerMSWHandler = (\n\targs: CreateSliceMachineManagerMSWHandlerArgs,\n): RestHandler<MockedRequest<DefaultBodyType>> => {\n\treturn rest.post(args.url, async (req, res, ctx) => {\n\t\tconst rpcResponse = await handleRPCRequest({\n\t\t\tbody: await req.text(),\n\t\t\tcontentTypeHeader: req.headers.get(\"Content-Type\"),\n\t\t\tprocedures: getSliceMachineManagerProcedures({\n\t\t\t\tsliceMachineManager: args.sliceMachineManager,\n\t\t\t}),\n\t\t});\n\n\t\treturn res(\n\t\t\tctx.body(await streamToString(rpcResponse.stream)),\n\t\t\tctx.set(rpcResponse.headers),\n\t\t\tctx.status(rpcResponse.statusCode || 200),\n\t\t);\n\t});\n};\n"],"names":["rest","handleRPCRequest","getSliceMachineManagerProcedures"],"mappings":";;;;;;AAOA,MAAM,iBAAiB,OAAO,WAAoB;AACjD,QAAM,SAAmB,CAAA;AAEzB,mBAAiB,SAAS,QAAQ;AACjC,WAAO,KAAK,OAAO,KAAK,KAAK,CAAC;AAAA,EAC9B;AAED,SAAO,OAAO,OAAO,MAAM,EAAE,SAAS,OAAO;AAC9C;AAOa,MAAA,sCAAsC,CAClD,SACgD;AAChD,SAAOA,MAAAA,KAAK,KAAK,KAAK,KAAK,OAAO,KAAK,KAAK,QAAO;AAC5C,UAAA,cAAc,MAAMC,kCAAiB;AAAA,MAC1C,MAAM,MAAM,IAAI,KAAM;AAAA,MACtB,mBAAmB,IAAI,QAAQ,IAAI,cAAc;AAAA,MACjD,YAAYC,oCAAAA,iCAAiC;AAAA,QAC5C,qBAAqB,KAAK;AAAA,MAAA,CAC1B;AAAA,IAAA,CACD;AAED,WAAO,IACN,IAAI,KAAK,MAAM,eAAe,YAAY,MAAM,CAAC,GACjD,IAAI,IAAI,YAAY,OAAO,GAC3B,IAAI,OAAO,YAAY,cAAc,GAAG,CAAC;AAAA,EAAA,CAE1C;AACF;;"}

package/dist/test/createSliceMachineManagerMSWHandler.d.ts

@@ -0,0 +1,7 @@
+import { DefaultBodyType, MockedRequest, RestHandler } from "msw";
+import { SliceMachineManager } from "../managers/SliceMachineManager";
+export type CreateSliceMachineManagerMSWHandlerArgs = {
+    sliceMachineManager: SliceMachineManager;
+    url: string;
+};
+export declare const createSliceMachineManagerMSWHandler: (args: CreateSliceMachineManagerMSWHandlerArgs) => RestHandler<MockedRequest<DefaultBodyType>>;

package/dist/test/createSliceMachineManagerMSWHandler.js

@@ -0,0 +1,27 @@
+import "h3";
+import { handleRPCRequest } from './../__node_modules/r19/dist/handleRPCRequest.js';
+import lib from './../__node_modules/msw/lib/index.js';
+import { getSliceMachineManagerProcedures } from "../managers/createSliceMachineManagerMiddleware.js";
+const streamToString = async (stream) => {
+  const chunks = [];
+  for await (const chunk of stream) {
+    chunks.push(Buffer.from(chunk));
+  }
+  return Buffer.concat(chunks).toString("utf-8");
+};
+const createSliceMachineManagerMSWHandler = (args) => {
+  return lib.rest.post(args.url, async (req, res, ctx) => {
+    const rpcResponse = await handleRPCRequest({
+      body: await req.text(),
+      contentTypeHeader: req.headers.get("Content-Type"),
+      procedures: getSliceMachineManagerProcedures({
+        sliceMachineManager: args.sliceMachineManager
+      })
+    });
+    return res(ctx.body(await streamToString(rpcResponse.stream)), ctx.set(rpcResponse.headers), ctx.status(rpcResponse.statusCode || 200));
+  });
+};
+export {
+  createSliceMachineManagerMSWHandler
+};
+//# sourceMappingURL=createSliceMachineManagerMSWHandler.js.map

package/dist/test/createSliceMachineManagerMSWHandler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"createSliceMachineManagerMSWHandler.js","sources":["../../../src/test/createSliceMachineManagerMSWHandler.ts"],"sourcesContent":["import { handleRPCRequest } from \"r19\";\nimport { rest, DefaultBodyType, MockedRequest, RestHandler } from \"msw\";\nimport { Readable } from \"node:stream\";\n\nimport { SliceMachineManager } from \"../managers/SliceMachineManager\";\nimport { getSliceMachineManagerProcedures } from \"../managers/createSliceMachineManagerMiddleware\";\n\nconst streamToString = async (stream: Readable) => {\n\tconst chunks: Buffer[] = [];\n\n\tfor await (const chunk of stream) {\n\t\tchunks.push(Buffer.from(chunk));\n\t}\n\n\treturn Buffer.concat(chunks).toString(\"utf-8\");\n};\n\nexport type CreateSliceMachineManagerMSWHandlerArgs = {\n\tsliceMachineManager: SliceMachineManager;\n\turl: string;\n};\n\nexport const createSliceMachineManagerMSWHandler = (\n\targs: CreateSliceMachineManagerMSWHandlerArgs,\n): RestHandler<MockedRequest<DefaultBodyType>> => {\n\treturn rest.post(args.url, async (req, res, ctx) => {\n\t\tconst rpcResponse = await handleRPCRequest({\n\t\t\tbody: await req.text(),\n\t\t\tcontentTypeHeader: req.headers.get(\"Content-Type\"),\n\t\t\tprocedures: getSliceMachineManagerProcedures({\n\t\t\t\tsliceMachineManager: args.sliceMachineManager,\n\t\t\t}),\n\t\t});\n\n\t\treturn res(\n\t\t\tctx.body(await streamToString(rpcResponse.stream)),\n\t\t\tctx.set(rpcResponse.headers),\n\t\t\tctx.status(rpcResponse.statusCode || 200),\n\t\t);\n\t});\n};\n"],"names":["rest"],"mappings":";;;;AAOA,MAAM,iBAAiB,OAAO,WAAoB;AACjD,QAAM,SAAmB,CAAA;AAEzB,mBAAiB,SAAS,QAAQ;AACjC,WAAO,KAAK,OAAO,KAAK,KAAK,CAAC;AAAA,EAC9B;AAED,SAAO,OAAO,OAAO,MAAM,EAAE,SAAS,OAAO;AAC9C;AAOa,MAAA,sCAAsC,CAClD,SACgD;AAChD,SAAOA,IAAAA,KAAK,KAAK,KAAK,KAAK,OAAO,KAAK,KAAK,QAAO;AAC5C,UAAA,cAAc,MAAM,iBAAiB;AAAA,MAC1C,MAAM,MAAM,IAAI,KAAM;AAAA,MACtB,mBAAmB,IAAI,QAAQ,IAAI,cAAc;AAAA,MACjD,YAAY,iCAAiC;AAAA,QAC5C,qBAAqB,KAAK;AAAA,MAAA,CAC1B;AAAA,IAAA,CACD;AAED,WAAO,IACN,IAAI,KAAK,MAAM,eAAe,YAAY,MAAM,CAAC,GACjD,IAAI,IAAI,YAAY,OAAO,GAC3B,IAAI,OAAO,YAAY,cAAc,GAAG,CAAC;AAAA,EAAA,CAE1C;AACF;"}

package/dist/test/index.d.ts

@@ -0,0 +1 @@
+export { createSliceMachineManagerMSWHandler, CreateSliceMachineManagerMSWHandlerArgs, } from "./createSliceMachineManagerMSWHandler";