@gadgetinc/ggt 0.3.3 → 0.4.0

package/lib/services/output/stream.js

@@ -0,0 +1,54 @@
+import { _ as _define_property } from "@swc/helpers/_/_define_property";
+import process from "node:process";
+import { env } from "../config/env.js";
+import { isObject } from "../util/is.js";
+/**
+ * A wrapper around process.stdout and process.stderr that allows us to mock out the streams for testing.
+ *
+ * @see https://github.com/oclif/core/blob/16139fe8a7f991b4b446a1599ab63f15d9809b8e/src/cli-ux/stream.ts
+ */ export class Stream {
+    get isTTY() {
+        return process[this.channel].isTTY;
+    }
+    getWindowSize() {
+        return process[this.channel].getWindowSize();
+    }
+    write(data) {
+        if (env.testLike) {
+            // use console.log/error in tests since vitest doesn't display
+            // process.stdout/stderr correctly; also, remove trailing newline
+            // since console.log/error adds one.
+            data = data.replace(/\n$/, "");
+            if (this.channel === "stdout") {
+                console.log(data);
+            } else {
+                console.error(data);
+            }
+            return true;
+        } else {
+            return process[this.channel].write(data);
+        }
+    }
+    on(event, listener) {
+        process[this.channel].on(event, listener);
+        return this;
+    }
+    once(event, listener) {
+        process[this.channel].once(event, listener);
+        return this;
+    }
+    constructor(channel){
+        _define_property(this, "channel", void 0);
+        this.channel = channel;
+        process[this.channel].on("error", (err)=>{
+            if (isObject(err) && "code" in err && err.code === "EPIPE") {
+                return;
+            }
+            throw err;
+        });
+    }
+}
+export const stdout = new Stream("stdout");
+export const stderr = new Stream("stderr");
+
+//# sourceMappingURL=stream.js.map

package/lib/services/output/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/output/stream.ts"],"sourcesContent":["import process from \"node:process\";\nimport { env } from \"../config/env.js\";\nimport { isObject } from \"../util/is.js\";\n\n/**\n * A wrapper around process.stdout and process.stderr that allows us to mock out the streams for testing.\n *\n * @see https://github.com/oclif/core/blob/16139fe8a7f991b4b446a1599ab63f15d9809b8e/src/cli-ux/stream.ts\n */\nexport class Stream {\n  public constructor(public channel: \"stdout\" | \"stderr\") {\n    process[this.channel].on(\"error\", (err: unknown) => {\n      if (isObject(err) && \"code\" in err && err.code === \"EPIPE\") {\n        return;\n      }\n      throw err;\n    });\n  }\n\n  public get isTTY(): boolean {\n    return process[this.channel].isTTY;\n  }\n\n  public getWindowSize(): number[] {\n    return process[this.channel].getWindowSize();\n  }\n\n  public write(data: string): boolean {\n    if (env.testLike) {\n      // use console.log/error in tests since vitest doesn't display\n      // process.stdout/stderr correctly; also, remove trailing newline\n      // since console.log/error adds one.\n      data = data.replace(/\\n$/, \"\");\n      if (this.channel === \"stdout\") {\n        console.log(data);\n      } else {\n        console.error(data);\n      }\n      return true;\n    } else {\n      return process[this.channel].write(data);\n    }\n  }\n\n  public on(event: string, listener: (...args: unknown[]) => void): this {\n    process[this.channel].on(event, listener);\n    return this;\n  }\n\n  public once(event: string, listener: (...args: unknown[]) => void): this {\n    process[this.channel].once(event, listener);\n    return this;\n  }\n}\n\nexport const stdout = new Stream(\"stdout\");\nexport const stderr = new Stream(\"stderr\");\n"],"names":["process","env","isObject","Stream","isTTY","channel","getWindowSize","write","data","testLike","replace","console","log","error","on","event","listener","once","err","code","stdout","stderr"],"mappings":";AAAA,OAAOA,aAAa,eAAe;AACnC,SAASC,GAAG,QAAQ,mBAAmB;AACvC,SAASC,QAAQ,QAAQ,gBAAgB;AAEzC;;;;CAIC,GACD,OAAO,MAAMC;IAUX,IAAWC,QAAiB;QAC1B,OAAOJ,OAAO,CAAC,IAAI,CAACK,OAAO,CAAC,CAACD,KAAK;IACpC;IAEOE,gBAA0B;QAC/B,OAAON,OAAO,CAAC,IAAI,CAACK,OAAO,CAAC,CAACC,aAAa;IAC5C;IAEOC,MAAMC,IAAY,EAAW;QAClC,IAAIP,IAAIQ,QAAQ,EAAE;YAChB,8DAA8D;YAC9D,iEAAiE;YACjE,oCAAoC;YACpCD,OAAOA,KAAKE,OAAO,CAAC,OAAO;YAC3B,IAAI,IAAI,CAACL,OAAO,KAAK,UAAU;gBAC7BM,QAAQC,GAAG,CAACJ;YACd,OAAO;gBACLG,QAAQE,KAAK,CAACL;YAChB;YACA,OAAO;QACT,OAAO;YACL,OAAOR,OAAO,CAAC,IAAI,CAACK,OAAO,CAAC,CAACE,KAAK,CAACC;QACrC;IACF;IAEOM,GAAGC,KAAa,EAAEC,QAAsC,EAAQ;QACrEhB,OAAO,CAAC,IAAI,CAACK,OAAO,CAAC,CAACS,EAAE,CAACC,OAAOC;QAChC,OAAO,IAAI;IACb;IAEOC,KAAKF,KAAa,EAAEC,QAAsC,EAAQ;QACvEhB,OAAO,CAAC,IAAI,CAACK,OAAO,CAAC,CAACY,IAAI,CAACF,OAAOC;QAClC,OAAO,IAAI;IACb;IA1CA,YAAmB,AAAOX,OAA4B,CAAE;;aAA9BA,UAAAA;QACxBL,OAAO,CAAC,IAAI,CAACK,OAAO,CAAC,CAACS,EAAE,CAAC,SAAS,CAACI;YACjC,IAAIhB,SAASgB,QAAQ,UAAUA,OAAOA,IAAIC,IAAI,KAAK,SAAS;gBAC1D;YACF;YACA,MAAMD;QACR;IACF;AAoCF;AAEA,OAAO,MAAME,SAAS,IAAIjB,OAAO,UAAU;AAC3C,OAAO,MAAMkB,SAAS,IAAIlB,OAAO,UAAU"}

package/lib/services/{version.js → output/update.js}

@@ -6,12 +6,20 @@ import assert from "node:assert";
 import path from "node:path";
 import semver from "semver";
 import { z } from "zod";
-import { config } from "./config.js";
-import { http } from "./http.js";
-import { createLogger } from "./log.js";
-import { println, sprint } from "./output.js";
-const log = createLogger("version");
+import { config } from "../config/config.js";
+import { http } from "../http/http.js";
+import { createLogger } from "./log/logger.js";
+import { sprint } from "./sprint.js";
+const log = createLogger({
+    name: "update"
+});
 const UPDATE_CHECK_FREQUENCY = ms("12 hours");
+const Registry = z.object({
+    name: z.literal("ggt"),
+    "dist-tags": z.object({
+        latest: z.string()
+    })
+});
 export const getDistTags = async ()=>{
     const json = await http({
         method: "GET",
@@ -22,24 +30,24 @@ export const getDistTags = async ()=>{
             request: ms("5s")
         }
     });
-    const parsed = z.object({
-        name: z.literal("ggt"),
-        "dist-tags": z.object({
-            latest: z.string()
-        })
-    }).parse(json);
-    return parsed["dist-tags"];
+    return Registry.parse(json)["dist-tags"];
 };
 export const shouldCheckForUpdate = async ()=>{
     try {
-        const lastCheck = Number(await fs.readFile(path.join(config.cacheDir, "last-update-check"), "utf-8"));
+        const lastCheck = Number(await fs.readFile(path.join(config.cacheDir, "last-update-check"), "utf8"));
         assert(!Number.isNaN(lastCheck));
         return dayjs().isAfter(lastCheck + UPDATE_CHECK_FREQUENCY);
     } catch (error) {
         return true;
     }
 };
-export const warnIfUpdateAvailable = async ()=>{
+/**
+ * Checks for updates to the `ggt` npm package and logs a warning
+ * message if an update is available.
+ *
+ * @returns A Promise that resolves with void when the check is
+ * complete.
+ */ export const warnIfUpdateAvailable = async ()=>{
     try {
         const shouldCheck = await shouldCheckForUpdate();
         if (!shouldCheck) {
@@ -52,7 +60,7 @@ export const warnIfUpdateAvailable = async ()=>{
                 current: config.version,
                 latest: tags.latest
             });
-            println(boxen(sprint`
+            log.println(boxen(sprint`
             Update available! {red ${config.version}} -> {green ${tags.latest}}.
             Changelog: https://github.com/gadget-inc/ggt/releases/tag/v${tags.latest}
             Run "npm install -g ${config.name}" to update.
@@ -69,4 +77,4 @@ export const warnIfUpdateAvailable = async ()=>{
     }
 };
 
-//# sourceMappingURL=version.js.map
+//# sourceMappingURL=update.js.map

package/lib/services/output/update.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/output/update.ts"],"sourcesContent":["import boxen from \"boxen\";\nimport dayjs from \"dayjs\";\nimport fs from \"fs-extra\";\nimport ms from \"ms\";\nimport assert from \"node:assert\";\nimport path from \"node:path\";\nimport semver from \"semver\";\nimport { z } from \"zod\";\nimport { config } from \"../config/config.js\";\nimport { http } from \"../http/http.js\";\nimport { createLogger } from \"./log/logger.js\";\nimport { sprint } from \"./sprint.js\";\n\nconst log = createLogger({ name: \"update\" });\n\nconst UPDATE_CHECK_FREQUENCY = ms(\"12 hours\");\n\nconst Registry = z.object({\n  name: z.literal(\"ggt\"),\n  \"dist-tags\": z.object({\n    latest: z.string(),\n  }),\n});\n\ntype Registry = z.infer<typeof Registry>;\n\nexport const getDistTags = async (): Promise<Registry[\"dist-tags\"]> => {\n  const json = await http({\n    method: \"GET\",\n    url: \"https://registry.npmjs.org/ggt\",\n    responseType: \"json\",\n    resolveBodyOnly: true,\n    timeout: {\n      request: ms(\"5s\"),\n    },\n  });\n\n  return Registry.parse(json)[\"dist-tags\"];\n};\n\nexport const shouldCheckForUpdate = async (): Promise<boolean> => {\n  try {\n    const lastCheck = Number(await fs.readFile(path.join(config.cacheDir, \"last-update-check\"), \"utf8\"));\n    assert(!Number.isNaN(lastCheck));\n    return dayjs().isAfter(lastCheck + UPDATE_CHECK_FREQUENCY);\n  } catch (error) {\n    return true;\n  }\n};\n\n/**\n * Checks for updates to the `ggt` npm package and logs a warning\n * message if an update is available.\n *\n * @returns A Promise that resolves with void when the check is\n * complete.\n */\nexport const warnIfUpdateAvailable = async (): Promise<void> => {\n  try {\n    const shouldCheck = await shouldCheckForUpdate();\n    if (!shouldCheck) {\n      return;\n    }\n\n    await fs.outputFile(path.join(config.cacheDir, \"last-update-check\"), String(Date.now()));\n\n    const tags = await getDistTags();\n\n    if (semver.lt(config.version, tags.latest)) {\n      log.info(\"update available\", { current: config.version, latest: tags.latest });\n      log.println(\n        boxen(\n          sprint`\n            Update available! {red ${config.version}} -> {green ${tags.latest}}.\n            Changelog: https://github.com/gadget-inc/ggt/releases/tag/v${tags.latest}\n            Run \"npm install -g ${config.name}\" to update.\n          `,\n          {\n            padding: 1,\n            borderStyle: \"round\",\n            textAlignment: \"center\",\n          },\n        ),\n      );\n    }\n  } catch (error) {\n    log.error(\"failed to check for updates\", { error });\n  }\n};\n"],"names":["boxen","dayjs","fs","ms","assert","path","semver","z","config","http","createLogger","sprint","log","name","UPDATE_CHECK_FREQUENCY","Registry","object","literal","latest","string","getDistTags","json","method","url","responseType","resolveBodyOnly","timeout","request","parse","shouldCheckForUpdate","lastCheck","Number","readFile","join","cacheDir","isNaN","isAfter","error","warnIfUpdateAvailable","shouldCheck","outputFile","String","Date","now","tags","lt","version","info","current","println","padding","borderStyle","textAlignment"],"mappings":"AAAA,OAAOA,WAAW,QAAQ;AAC1B,OAAOC,WAAW,QAAQ;AAC1B,OAAOC,QAAQ,WAAW;AAC1B,OAAOC,QAAQ,KAAK;AACpB,OAAOC,YAAY,cAAc;AACjC,OAAOC,UAAU,YAAY;AAC7B,OAAOC,YAAY,SAAS;AAC5B,SAASC,CAAC,QAAQ,MAAM;AACxB,SAASC,MAAM,QAAQ,sBAAsB;AAC7C,SAASC,IAAI,QAAQ,kBAAkB;AACvC,SAASC,YAAY,QAAQ,kBAAkB;AAC/C,SAASC,MAAM,QAAQ,cAAc;AAErC,MAAMC,MAAMF,aAAa;IAAEG,MAAM;AAAS;AAE1C,MAAMC,yBAAyBX,GAAG;AAElC,MAAMY,WAAWR,EAAES,MAAM,CAAC;IACxBH,MAAMN,EAAEU,OAAO,CAAC;IAChB,aAAaV,EAAES,MAAM,CAAC;QACpBE,QAAQX,EAAEY,MAAM;IAClB;AACF;AAIA,OAAO,MAAMC,cAAc;IACzB,MAAMC,OAAO,MAAMZ,KAAK;QACtBa,QAAQ;QACRC,KAAK;QACLC,cAAc;QACdC,iBAAiB;QACjBC,SAAS;YACPC,SAASxB,GAAG;QACd;IACF;IAEA,OAAOY,SAASa,KAAK,CAACP,KAAK,CAAC,YAAY;AAC1C,EAAE;AAEF,OAAO,MAAMQ,uBAAuB;IAClC,IAAI;QACF,MAAMC,YAAYC,OAAO,MAAM7B,GAAG8B,QAAQ,CAAC3B,KAAK4B,IAAI,CAACzB,OAAO0B,QAAQ,EAAE,sBAAsB;QAC5F9B,OAAO,CAAC2B,OAAOI,KAAK,CAACL;QACrB,OAAO7B,QAAQmC,OAAO,CAACN,YAAYhB;IACrC,EAAE,OAAOuB,OAAO;QACd,OAAO;IACT;AACF,EAAE;AAEF;;;;;;CAMC,GACD,OAAO,MAAMC,wBAAwB;IACnC,IAAI;QACF,MAAMC,cAAc,MAAMV;QAC1B,IAAI,CAACU,aAAa;YAChB;QACF;QAEA,MAAMrC,GAAGsC,UAAU,CAACnC,KAAK4B,IAAI,CAACzB,OAAO0B,QAAQ,EAAE,sBAAsBO,OAAOC,KAAKC,GAAG;QAEpF,MAAMC,OAAO,MAAMxB;QAEnB,IAAId,OAAOuC,EAAE,CAACrC,OAAOsC,OAAO,EAAEF,KAAK1B,MAAM,GAAG;YAC1CN,IAAImC,IAAI,CAAC,oBAAoB;gBAAEC,SAASxC,OAAOsC,OAAO;gBAAE5B,QAAQ0B,KAAK1B,MAAM;YAAC;YAC5EN,IAAIqC,OAAO,CACTjD,MACEW,MAAM,CAAC;mCACkB,EAAEH,OAAOsC,OAAO,CAAC,YAAY,EAAEF,KAAK1B,MAAM,CAAC;uEACP,EAAE0B,KAAK1B,MAAM,CAAC;gCACrD,EAAEV,OAAOK,IAAI,CAAC;UACpC,CAAC,EACD;gBACEqC,SAAS;gBACTC,aAAa;gBACbC,eAAe;YACjB;QAGN;IACF,EAAE,OAAOf,OAAO;QACdzB,IAAIyB,KAAK,CAAC,+BAA+B;YAAEA;QAAM;IACnD;AACF,EAAE"}

package/lib/services/user/session.js

@@ -0,0 +1,50 @@
+import fs from "fs-extra";
+import { configPath } from "../config/config.js";
+import { swallowEnoent } from "../filesync/directory.js";
+import { createLogger } from "../output/log/logger.js";
+import { memo } from "../util/function.js";
+const log = createLogger({
+    name: "session"
+});
+/**
+ * Reads the session from either the environment variable `GGT_SESSION`
+ * or from the `session.txt` file in the config directory.
+ *
+ * @returns The session string if found, otherwise undefined.
+ */ export const readSession = memo(()=>{
+    if (process.env["GGT_SESSION"]) {
+        log.debug("reading session from env");
+        return process.env["GGT_SESSION"];
+    }
+    try {
+        log.debug("reading session from disk");
+        return fs.readFileSync(configPath("session.txt"), "utf8");
+    } catch (error) {
+        swallowEnoent(error);
+        return undefined;
+    }
+});
+/**
+ * Writes the session to disk in the `session.txt` file in the config.
+ *
+ * @param session - The session to write to disk.
+ */ export const writeSession = (session)=>{
+    readSession.clear();
+    if (process.env["GGT_SESSION"]) {
+        log.debug("writing session to env", {
+            session: Boolean(session)
+        });
+        process.env["GGT_SESSION"] = session;
+    }
+    log.debug("writing session to disk", {
+        session: Boolean(session),
+        path: configPath("session.txt")
+    });
+    if (session) {
+        fs.outputFileSync(configPath("session.txt"), session);
+    } else {
+        fs.removeSync(configPath("session.txt"));
+    }
+};
+
+//# sourceMappingURL=session.js.map

package/lib/services/user/session.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/user/session.ts"],"sourcesContent":["import fs from \"fs-extra\";\nimport { configPath } from \"../config/config.js\";\nimport { swallowEnoent } from \"../filesync/directory.js\";\nimport { createLogger } from \"../output/log/logger.js\";\nimport { memo } from \"../util/function.js\";\n\nconst log = createLogger({ name: \"session\" });\n\n/**\n * Reads the session from either the environment variable `GGT_SESSION`\n * or from the `session.txt` file in the config directory.\n *\n * @returns The session string if found, otherwise undefined.\n */\nexport const readSession = memo((): string | undefined => {\n  if (process.env[\"GGT_SESSION\"]) {\n    log.debug(\"reading session from env\");\n    return process.env[\"GGT_SESSION\"];\n  }\n\n  try {\n    log.debug(\"reading session from disk\");\n    return fs.readFileSync(configPath(\"session.txt\"), \"utf8\");\n  } catch (error) {\n    swallowEnoent(error);\n    return undefined;\n  }\n});\n\n/**\n * Writes the session to disk in the `session.txt` file in the config.\n *\n * @param session - The session to write to disk.\n */\nexport const writeSession = (session: string | undefined): void => {\n  readSession.clear();\n\n  if (process.env[\"GGT_SESSION\"]) {\n    log.debug(\"writing session to env\", { session: Boolean(session) });\n    process.env[\"GGT_SESSION\"] = session;\n  }\n\n  log.debug(\"writing session to disk\", { session: Boolean(session), path: configPath(\"session.txt\") });\n\n  if (session) {\n    fs.outputFileSync(configPath(\"session.txt\"), session);\n  } else {\n    fs.removeSync(configPath(\"session.txt\"));\n  }\n};\n"],"names":["fs","configPath","swallowEnoent","createLogger","memo","log","name","readSession","process","env","debug","readFileSync","error","undefined","writeSession","session","clear","Boolean","path","outputFileSync","removeSync"],"mappings":"AAAA,OAAOA,QAAQ,WAAW;AAC1B,SAASC,UAAU,QAAQ,sBAAsB;AACjD,SAASC,aAAa,QAAQ,2BAA2B;AACzD,SAASC,YAAY,QAAQ,0BAA0B;AACvD,SAASC,IAAI,QAAQ,sBAAsB;AAE3C,MAAMC,MAAMF,aAAa;IAAEG,MAAM;AAAU;AAE3C;;;;;CAKC,GACD,OAAO,MAAMC,cAAcH,KAAK;IAC9B,IAAII,QAAQC,GAAG,CAAC,cAAc,EAAE;QAC9BJ,IAAIK,KAAK,CAAC;QACV,OAAOF,QAAQC,GAAG,CAAC,cAAc;IACnC;IAEA,IAAI;QACFJ,IAAIK,KAAK,CAAC;QACV,OAAOV,GAAGW,YAAY,CAACV,WAAW,gBAAgB;IACpD,EAAE,OAAOW,OAAO;QACdV,cAAcU;QACd,OAAOC;IACT;AACF,GAAG;AAEH;;;;CAIC,GACD,OAAO,MAAMC,eAAe,CAACC;IAC3BR,YAAYS,KAAK;IAEjB,IAAIR,QAAQC,GAAG,CAAC,cAAc,EAAE;QAC9BJ,IAAIK,KAAK,CAAC,0BAA0B;YAAEK,SAASE,QAAQF;QAAS;QAChEP,QAAQC,GAAG,CAAC,cAAc,GAAGM;IAC/B;IAEAV,IAAIK,KAAK,CAAC,2BAA2B;QAAEK,SAASE,QAAQF;QAAUG,MAAMjB,WAAW;IAAe;IAElG,IAAIc,SAAS;QACXf,GAAGmB,cAAc,CAAClB,WAAW,gBAAgBc;IAC/C,OAAO;QACLf,GAAGoB,UAAU,CAACnB,WAAW;IAC3B;AACF,EAAE"}

package/lib/services/{user.js → user/user.js}

@@ -1,13 +1,16 @@
 import assert from "node:assert";
 import z from "zod";
-import { run as login } from "../commands/login.js";
-import { pick } from "./collections.js";
-import { config } from "./config.js";
-import { setUser } from "./errors.js";
-import { http, loadCookie, swallowUnauthorized } from "./http.js";
-import { createLogger } from "./log.js";
-import { confirm } from "./prompt.js";
-const log = createLogger("user");
+import { login } from "../../commands/login.js";
+import { config } from "../config/config.js";
+import { loadCookie, swallowUnauthorized } from "../http/auth.js";
+import { http } from "../http/http.js";
+import { createLogger } from "../output/log/logger.js";
+import { confirm } from "../output/prompt.js";
+import { setUser } from "../output/report.js";
+import { pick } from "../util/object.js";
+const log = createLogger({
+    name: "user"
+});
 const User = z.object({
     id: z.union([
         z.string(),
@@ -17,7 +20,10 @@ const User = z.object({
     email: z.string()
 });
 /**
- * @returns The current user.
+ * Retrieves the currently logged in user from Gadgets API.
+ *
+ * @returns A Promise that resolves to a User object representing the
+ * current user, or undefined if the user is not authenticated.
  */ export const getUser = async ()=>{
     const cookie = loadCookie();
     if (!cookie) {
@@ -47,18 +53,21 @@ const User = z.object({
         return undefined;
     }
 };
-export const getUserOrLogin = async (message = "You must be logged in to use this command. Would you like to log in?")=>{
+/**
+ * Retrieves the current user or prompts the user to log in if not
+ * already logged in.
+ *
+ * @param message The message to display when prompting the user to log in.
+ * @returns A Promise that resolves to the current user.
+ */ export const getUserOrLogin = async (message = "You must be logged in to use this command. Would you like to log in?")=>{
     let user = await getUser();
     if (user) {
         return user;
     }
     log.info("prompting user to log in");
-    const yes = await confirm({
+    await confirm({
         message
     });
-    if (!yes) {
-        process.exit(0);
-    }
     await login();
     user = await getUser();
     assert(user, "missing user after successful login");

package/lib/services/user/user.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/user/user.ts"],"sourcesContent":["import assert from \"node:assert\";\nimport z from \"zod\";\nimport { login } from \"../../commands/login.js\";\nimport { config } from \"../config/config.js\";\nimport { loadCookie, swallowUnauthorized } from \"../http/auth.js\";\nimport { http } from \"../http/http.js\";\nimport { createLogger } from \"../output/log/logger.js\";\nimport { confirm } from \"../output/prompt.js\";\nimport { setUser } from \"../output/report.js\";\nimport { pick } from \"../util/object.js\";\n\nconst log = createLogger({ name: \"user\" });\n\nconst User = z.object({\n  id: z.union([z.string(), z.number()]).transform(Number),\n  name: z.string().nullish(),\n  email: z.string(),\n});\n\nexport type User = z.infer<typeof User>;\n\n/**\n * Retrieves the currently logged in user from Gadgets API.\n *\n * @returns A Promise that resolves to a User object representing the\n * current user, or undefined if the user is not authenticated.\n */\nexport const getUser = async (): Promise<User | undefined> => {\n  const cookie = loadCookie();\n  if (!cookie) {\n    return undefined;\n  }\n\n  try {\n    const json = await http({\n      url: `https://${config.domains.services}/auth/api/current-user`,\n      headers: { cookie },\n      responseType: \"json\",\n      resolveBodyOnly: true,\n    });\n\n    const user = User.parse(json);\n    setUser(user);\n    log.info(\"loaded current user\", { user: pick(user, [\"id\", \"name\", \"email\"]) });\n\n    return user;\n  } catch (error) {\n    swallowUnauthorized(error);\n    return undefined;\n  }\n};\n\n/**\n * Retrieves the current user or prompts the user to log in if not\n * already logged in.\n *\n * @param message The message to display when prompting the user to log in.\n * @returns A Promise that resolves to the current user.\n */\nexport const getUserOrLogin = async (message = \"You must be logged in to use this command. Would you like to log in?\"): Promise<User> => {\n  let user = await getUser();\n  if (user) {\n    return user;\n  }\n\n  log.info(\"prompting user to log in\");\n  await confirm({ message });\n\n  await login();\n\n  user = await getUser();\n  assert(user, \"missing user after successful login\");\n\n  return user;\n};\n"],"names":["assert","z","login","config","loadCookie","swallowUnauthorized","http","createLogger","confirm","setUser","pick","log","name","User","object","id","union","string","number","transform","Number","nullish","email","getUser","cookie","undefined","json","url","domains","services","headers","responseType","resolveBodyOnly","user","parse","info","error","getUserOrLogin","message"],"mappings":"AAAA,OAAOA,YAAY,cAAc;AACjC,OAAOC,OAAO,MAAM;AACpB,SAASC,KAAK,QAAQ,0BAA0B;AAChD,SAASC,MAAM,QAAQ,sBAAsB;AAC7C,SAASC,UAAU,EAAEC,mBAAmB,QAAQ,kBAAkB;AAClE,SAASC,IAAI,QAAQ,kBAAkB;AACvC,SAASC,YAAY,QAAQ,0BAA0B;AACvD,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,OAAO,QAAQ,sBAAsB;AAC9C,SAASC,IAAI,QAAQ,oBAAoB;AAEzC,MAAMC,MAAMJ,aAAa;IAAEK,MAAM;AAAO;AAExC,MAAMC,OAAOZ,EAAEa,MAAM,CAAC;IACpBC,IAAId,EAAEe,KAAK,CAAC;QAACf,EAAEgB,MAAM;QAAIhB,EAAEiB,MAAM;KAAG,EAAEC,SAAS,CAACC;IAChDR,MAAMX,EAAEgB,MAAM,GAAGI,OAAO;IACxBC,OAAOrB,EAAEgB,MAAM;AACjB;AAIA;;;;;CAKC,GACD,OAAO,MAAMM,UAAU;IACrB,MAAMC,SAASpB;IACf,IAAI,CAACoB,QAAQ;QACX,OAAOC;IACT;IAEA,IAAI;QACF,MAAMC,OAAO,MAAMpB,KAAK;YACtBqB,KAAK,CAAC,QAAQ,EAAExB,OAAOyB,OAAO,CAACC,QAAQ,CAAC,sBAAsB,CAAC;YAC/DC,SAAS;gBAAEN;YAAO;YAClBO,cAAc;YACdC,iBAAiB;QACnB;QAEA,MAAMC,OAAOpB,KAAKqB,KAAK,CAACR;QACxBjB,QAAQwB;QACRtB,IAAIwB,IAAI,CAAC,uBAAuB;YAAEF,MAAMvB,KAAKuB,MAAM;gBAAC;gBAAM;gBAAQ;aAAQ;QAAE;QAE5E,OAAOA;IACT,EAAE,OAAOG,OAAO;QACd/B,oBAAoB+B;QACpB,OAAOX;IACT;AACF,EAAE;AAEF;;;;;;CAMC,GACD,OAAO,MAAMY,iBAAiB,OAAOC,UAAU,sEAAsE;IACnH,IAAIL,OAAO,MAAMV;IACjB,IAAIU,MAAM;QACR,OAAOA;IACT;IAEAtB,IAAIwB,IAAI,CAAC;IACT,MAAM3B,QAAQ;QAAE8B;IAAQ;IAExB,MAAMpC;IAEN+B,OAAO,MAAMV;IACbvB,OAAOiC,MAAM;IAEb,OAAOA;AACT,EAAE"}

package/lib/services/util/boolean.js

@@ -0,0 +1,15 @@
+import { memo } from "./function.js";
+/**
+ * Parses a string value and returns a boolean value.
+ *
+ * @param value - The string value to parse.
+ * @returns A boolean value representing the parsed value.
+ */ export const parseBoolean = memo((value)=>{
+    value ??= "";
+    return [
+        "true",
+        "1"
+    ].includes(value.trim().toLowerCase());
+});
+
+//# sourceMappingURL=boolean.js.map

package/lib/services/util/boolean.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/util/boolean.ts"],"sourcesContent":["import { memo } from \"./function.js\";\n\n/**\n * Parses a string value and returns a boolean value.\n *\n * @param value - The string value to parse.\n * @returns A boolean value representing the parsed value.\n */\nexport const parseBoolean = memo((value: string | null | undefined): boolean => {\n  value ??= \"\";\n  return [\"true\", \"1\"].includes(value.trim().toLowerCase());\n});\n"],"names":["memo","parseBoolean","value","includes","trim","toLowerCase"],"mappings":"AAAA,SAASA,IAAI,QAAQ,gBAAgB;AAErC;;;;;CAKC,GACD,OAAO,MAAMC,eAAeD,KAAK,CAACE;IAChCA,UAAU;IACV,OAAO;QAAC;QAAQ;KAAI,CAACC,QAAQ,CAACD,MAAME,IAAI,GAAGC,WAAW;AACxD,GAAG"}

package/lib/services/util/collection.js

@@ -0,0 +1,38 @@
+import levenshtein from "fast-levenshtein";
+import assert from "node:assert";
+/**
+ * Returns a new array with all falsy values removed. The values
+ * `false`, `null`, `0`, `""`, `undefined`, and `NaN` are falsy.
+ *
+ * @param array - The array to compact.
+ * @returns A new array with all falsy values removed.
+ */ export const compact = (array)=>{
+    return array.filter((value)=>Boolean(value));
+};
+/**
+ * Returns a new array with all duplicate elements removed.
+ *
+ * @param array The array to remove duplicates from.
+ * @returns A new array with all duplicate elements removed.
+ */ export const uniq = (array)=>{
+    return [
+        ...new Set(array)
+    ];
+};
+/**
+ * Sorts an array of strings based on their similarity to a given input
+ * string. The closest match is returned as the first element, followed
+ * by the sorted array.
+ *
+ * @param input - The input string to compare against.
+ * @param options - The array of strings to be sorted.
+ * @returns An array with the closest match as the first element,
+ * followed by the sorted array.
+ */ export const sortBySimilar = (input, options)=>{
+    assert(options.length > 0, "options must not be empty");
+    return [
+        ...options
+    ].sort((a, b)=>levenshtein.get(a, input) - levenshtein.get(b, input));
+};
+
+//# sourceMappingURL=collection.js.map

package/lib/services/util/collection.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/util/collection.ts"],"sourcesContent":["import levenshtein from \"fast-levenshtein\";\nimport assert from \"node:assert\";\n\n/**\n * Returns a new array with all falsy values removed. The values\n * `false`, `null`, `0`, `\"\"`, `undefined`, and `NaN` are falsy.\n *\n * @param array - The array to compact.\n * @returns A new array with all falsy values removed.\n */\nexport const compact = <T>(array: T[]): NonNullable<T>[] => {\n  return array.filter((value): value is NonNullable<T> => Boolean(value));\n};\n\n/**\n * Returns a new array with all duplicate elements removed.\n *\n * @param array The array to remove duplicates from.\n * @returns A new array with all duplicate elements removed.\n */\nexport const uniq = <T>(array: T[]): T[] => {\n  return [...new Set(array)];\n};\n\n/**\n * Sorts an array of strings based on their similarity to a given input\n * string. The closest match is returned as the first element, followed\n * by the sorted array.\n *\n * @param input - The input string to compare against.\n * @param options - The array of strings to be sorted.\n * @returns An array with the closest match as the first element,\n * followed by the sorted array.\n */\nexport const sortBySimilar = (input: string, options: readonly string[]): [closest: string, ...sorted: string[]] => {\n  assert(options.length > 0, \"options must not be empty\");\n  return [...options].sort((a, b) => levenshtein.get(a, input) - levenshtein.get(b, input)) as [string, ...string[]];\n};\n"],"names":["levenshtein","assert","compact","array","filter","value","Boolean","uniq","Set","sortBySimilar","input","options","length","sort","a","b","get"],"mappings":"AAAA,OAAOA,iBAAiB,mBAAmB;AAC3C,OAAOC,YAAY,cAAc;AAEjC;;;;;;CAMC,GACD,OAAO,MAAMC,UAAU,CAAIC;IACzB,OAAOA,MAAMC,MAAM,CAAC,CAACC,QAAmCC,QAAQD;AAClE,EAAE;AAEF;;;;;CAKC,GACD,OAAO,MAAME,OAAO,CAAIJ;IACtB,OAAO;WAAI,IAAIK,IAAIL;KAAO;AAC5B,EAAE;AAEF;;;;;;;;;CASC,GACD,OAAO,MAAMM,gBAAgB,CAACC,OAAeC;IAC3CV,OAAOU,QAAQC,MAAM,GAAG,GAAG;IAC3B,OAAO;WAAID;KAAQ,CAACE,IAAI,CAAC,CAACC,GAAGC,IAAMf,YAAYgB,GAAG,CAACF,GAAGJ,SAASV,YAAYgB,GAAG,CAACD,GAAGL;AACpF,EAAE"}

package/lib/services/util/function.js

@@ -0,0 +1,97 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */ /* eslint-disable func-style */ import mimicFunction from "mimic-fn";
+import assert from "node:assert";
+import { isFunction } from "./is.js";
+const memoizedFns = new Set();
+export const MemoFirstArg = (...args)=>String(args[0]);
+export const MemoAllArgs = (...args)=>args.map(String).join(":");
+export function memo(fnOrKeyFn, fn) {
+    let keyFn;
+    if (fn) {
+        keyFn = fnOrKeyFn;
+    } else {
+        fn = fnOrKeyFn;
+        keyFn = MemoFirstArg;
+    }
+    const cache = new Map();
+    const memoized = (...args)=>{
+        const key = keyFn(...args);
+        if (cache.has(key)) {
+            return cache.get(key);
+        }
+        assert(fn, "fn shouldn't be undefined");
+        const result = fn(...args);
+        cache.set(key, result);
+        return result;
+    };
+    memoized.clear = cache.clear.bind(cache);
+    memoizedFns.add(memoized);
+    mimicFunction(memoized, fn);
+    return memoized;
+}
+export const clearMemoized = ()=>{
+    for (const memoized of memoizedFns){
+        memoized.clear();
+    }
+};
+/**
+ * Creates a debounced function that delays invoking the provided
+ * function until after `delayMS` milliseconds have elapsed since the
+ * last time it was invoked.
+ *
+ * @param delayMS The number of milliseconds to delay.
+ * @param f The function to be debounced.
+ * @returns A debounced version of the provided function.
+ */ export const debounce = (delayMS, f)=>{
+    let timerId;
+    let upcomingCall;
+    const debounced = (...args)=>{
+        upcomingCall = ()=>{
+            upcomingCall = undefined;
+            timerId = undefined;
+            f(...args);
+        };
+        clearTimeout(timerId);
+        timerId = setTimeout(upcomingCall, delayMS);
+    };
+    debounced.flush = ()=>{
+        if (upcomingCall) {
+            upcomingCall();
+        }
+    };
+    return debounced;
+};
+/**
+ * Wraps a value in a thunk (a function that returns a value). If the
+ * value is already a function, it is returned as is.
+ *
+ * @param val The value or function to wrap.
+ * @returns A function that returns the value.
+ */ export const thunk = (val)=>{
+    if (isFunction(val)) {
+        return val;
+    }
+    return ()=>val;
+};
+/**
+ * Unwraps a value from a thunk (a function that returns a value). If the
+ * value is not a function, it is returned as is.
+ *
+ * @param val The value or thunk to unwrap.
+ * @returns The unwrapped value.
+ */ export const unthunk = (val)=>{
+    if (isFunction(val)) {
+        return val();
+    }
+    return val;
+};
+/**
+ * A function that does nothing and returns nothing.
+ */ // eslint-disable-next-line @typescript-eslint/no-empty-function
+export const noop = ()=>{};
+/**
+ * A function that does nothing and returns `this`.
+ */ export const noopThis = function() {
+    return this;
+};
+
+//# sourceMappingURL=function.js.map

package/lib/services/util/function.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/util/function.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n/* eslint-disable func-style */\nimport mimicFunction from \"mimic-fn\";\nimport assert from \"node:assert\";\nimport type { Promisable } from \"type-fest\";\nimport { isFunction } from \"./is.js\";\n\nexport type AnyFunction = (...args: never[]) => unknown;\n\nexport type AnyVoid = Promisable<void>;\n\nconst memoizedFns = new Set<MemoizedFn>();\n\nexport type MemoizedFn<Fn extends AnyFunction = AnyFunction> = Fn & {\n  /**\n   * Clears the cache.\n   */\n  clear: () => void;\n};\n\nexport const MemoFirstArg = (...args: any[]): string => String(args[0]);\nexport const MemoAllArgs = (...args: any[]): string => args.map(String).join(\":\");\n\nexport function memo<Fn extends AnyFunction>(fn: Fn): MemoizedFn<Fn>;\nexport function memo<Fn extends AnyFunction, KeyFn extends (...args: Parameters<Fn>) => string>(keyFn: KeyFn, fn: Fn): MemoizedFn<Fn>;\nexport function memo<Fn extends AnyFunction, KeyFn extends (...args: Parameters<Fn>) => string>(\n  fnOrKeyFn: Fn | KeyFn,\n  fn?: Fn,\n): MemoizedFn<Fn> {\n  let keyFn: KeyFn;\n  if (fn) {\n    keyFn = fnOrKeyFn as KeyFn;\n  } else {\n    fn = fnOrKeyFn as Fn;\n    keyFn = MemoFirstArg as unknown as KeyFn;\n  }\n\n  const cache = new Map<string, unknown>();\n\n  const memoized = ((...args) => {\n    const key = keyFn(...(args as Parameters<Fn>));\n    if (cache.has(key)) {\n      return cache.get(key);\n    }\n\n    assert(fn, \"fn shouldn't be undefined\");\n    const result = fn(...args);\n    cache.set(key, result);\n\n    return result;\n  }) as MemoizedFn<Fn>;\n\n  memoized.clear = cache.clear.bind(cache);\n\n  memoizedFns.add(memoized);\n\n  mimicFunction(memoized, fn);\n\n  return memoized;\n}\n\nexport const clearMemoized = (): void => {\n  for (const memoized of memoizedFns) {\n    memoized.clear();\n  }\n};\n\nexport type DebouncedFunc<Fn extends (...args: unknown[]) => void> = Fn & {\n  /**\n   * Invokes the function if it is waiting to stop being called.\n   */\n  flush: () => void;\n};\n\n/**\n * Creates a debounced function that delays invoking the provided\n * function until after `delayMS` milliseconds have elapsed since the\n * last time it was invoked.\n *\n * @param delayMS The number of milliseconds to delay.\n * @param f The function to be debounced.\n * @returns A debounced version of the provided function.\n */\nexport const debounce = <F extends (...args: unknown[]) => void>(delayMS: number, f: F): DebouncedFunc<F> => {\n  let timerId: NodeJS.Timeout | undefined;\n  let upcomingCall: (() => void) | undefined;\n\n  const debounced = ((...args) => {\n    upcomingCall = () => {\n      upcomingCall = undefined;\n      timerId = undefined;\n      f(...args);\n    };\n\n    clearTimeout(timerId);\n    timerId = setTimeout(upcomingCall, delayMS);\n  }) as DebouncedFunc<F>;\n\n  debounced.flush = () => {\n    if (upcomingCall) {\n      upcomingCall();\n    }\n  };\n\n  return debounced;\n};\n\nexport type Thunk<T> = T | (() => T);\n\n/**\n * Wraps a value in a thunk (a function that returns a value). If the\n * value is already a function, it is returned as is.\n *\n * @param val The value or function to wrap.\n * @returns A function that returns the value.\n */\nexport const thunk = <T>(val: T | (() => T)): (() => T) => {\n  if (isFunction(val)) {\n    return val;\n  }\n  return () => val;\n};\n\n/**\n * Unwraps a value from a thunk (a function that returns a value). If the\n * value is not a function, it is returned as is.\n *\n * @param val The value or thunk to unwrap.\n * @returns The unwrapped value.\n */\nexport const unthunk = <T>(val: T | (() => T)): T => {\n  if (isFunction(val)) {\n    return val();\n  }\n  return val;\n};\n\n/**\n * A function that does nothing and returns nothing.\n */\n// eslint-disable-next-line @typescript-eslint/no-empty-function\nexport const noop = (): void => {};\n\n/**\n * A function that does nothing and returns `this`.\n */\nexport const noopThis = function <T>(this: T): T {\n  return this;\n};\n"],"names":["mimicFunction","assert","isFunction","memoizedFns","Set","MemoFirstArg","args","String","MemoAllArgs","map","join","memo","fnOrKeyFn","fn","keyFn","cache","Map","memoized","key","has","get","result","set","clear","bind","add","clearMemoized","debounce","delayMS","f","timerId","upcomingCall","debounced","undefined","clearTimeout","setTimeout","flush","thunk","val","unthunk","noop","noopThis"],"mappings":"AAAA,qDAAqD,GACrD,6BAA6B,GAC7B,OAAOA,mBAAmB,WAAW;AACrC,OAAOC,YAAY,cAAc;AAEjC,SAASC,UAAU,QAAQ,UAAU;AAMrC,MAAMC,cAAc,IAAIC;AASxB,OAAO,MAAMC,eAAe,CAAC,GAAGC,OAAwBC,OAAOD,IAAI,CAAC,EAAE,EAAE;AACxE,OAAO,MAAME,cAAc,CAAC,GAAGF,OAAwBA,KAAKG,GAAG,CAACF,QAAQG,IAAI,CAAC,KAAK;AAIlF,OAAO,SAASC,KACdC,SAAqB,EACrBC,EAAO;IAEP,IAAIC;IACJ,IAAID,IAAI;QACNC,QAAQF;IACV,OAAO;QACLC,KAAKD;QACLE,QAAQT;IACV;IAEA,MAAMU,QAAQ,IAAIC;IAElB,MAAMC,WAAY,CAAC,GAAGX;QACpB,MAAMY,MAAMJ,SAAUR;QACtB,IAAIS,MAAMI,GAAG,CAACD,MAAM;YAClB,OAAOH,MAAMK,GAAG,CAACF;QACnB;QAEAjB,OAAOY,IAAI;QACX,MAAMQ,SAASR,MAAMP;QACrBS,MAAMO,GAAG,CAACJ,KAAKG;QAEf,OAAOA;IACT;IAEAJ,SAASM,KAAK,GAAGR,MAAMQ,KAAK,CAACC,IAAI,CAACT;IAElCZ,YAAYsB,GAAG,CAACR;IAEhBjB,cAAciB,UAAUJ;IAExB,OAAOI;AACT;AAEA,OAAO,MAAMS,gBAAgB;IAC3B,KAAK,MAAMT,YAAYd,YAAa;QAClCc,SAASM,KAAK;IAChB;AACF,EAAE;AASF;;;;;;;;CAQC,GACD,OAAO,MAAMI,WAAW,CAAyCC,SAAiBC;IAChF,IAAIC;IACJ,IAAIC;IAEJ,MAAMC,YAAa,CAAC,GAAG1B;QACrByB,eAAe;YACbA,eAAeE;YACfH,UAAUG;YACVJ,KAAKvB;QACP;QAEA4B,aAAaJ;QACbA,UAAUK,WAAWJ,cAAcH;IACrC;IAEAI,UAAUI,KAAK,GAAG;QAChB,IAAIL,cAAc;YAChBA;QACF;IACF;IAEA,OAAOC;AACT,EAAE;AAIF;;;;;;CAMC,GACD,OAAO,MAAMK,QAAQ,CAAIC;IACvB,IAAIpC,WAAWoC,MAAM;QACnB,OAAOA;IACT;IACA,OAAO,IAAMA;AACf,EAAE;AAEF;;;;;;CAMC,GACD,OAAO,MAAMC,UAAU,CAAID;IACzB,IAAIpC,WAAWoC,MAAM;QACnB,OAAOA;IACT;IACA,OAAOA;AACT,EAAE;AAEF;;CAEC,GACD,gEAAgE;AAChE,OAAO,MAAME,OAAO,KAAa,EAAE;AAEnC;;CAEC,GACD,OAAO,MAAMC,WAAW;IACtB,OAAO,IAAI;AACb,EAAE"}

package/lib/services/{is.js → util/is.js}

@@ -35,5 +35,12 @@ export const isGraphQLErrors = (e)=>{
         message: z.string()
     })).safeParse(e).success;
 };
+export const isNever = (value)=>{
+    // eslint-disable-next-line @typescript-eslint/restrict-template-expressions
+    throw new Error(`Unexpected value: ${value}`);
+};
+export const isAbortError = (error)=>{
+    return error instanceof Error && error.name === "AbortError" || error instanceof Event && error.type === "abort";
+};
 
 //# sourceMappingURL=is.js.map

package/lib/services/util/is.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/util/is.ts"],"sourcesContent":["import type { GraphQLError } from \"graphql\";\nimport type { SetOptional } from \"type-fest\";\nimport type { CloseEvent, ErrorEvent } from \"ws\";\nimport { z } from \"zod\";\n\nexport const isNil = (val: unknown): val is null | undefined => {\n  return val === null || val === undefined;\n};\n\nexport const isString = (val: unknown): val is string => {\n  return typeof val === \"string\";\n};\n\nexport const isObject = (val: unknown): val is object => {\n  return val instanceof Object;\n};\n\n// eslint-disable-next-line @typescript-eslint/ban-types\nexport const isFunction = (val: unknown): val is Function => {\n  return typeof val === \"function\";\n};\n\nexport const isError = (val: unknown): val is Error => {\n  return val instanceof Error;\n};\n\nexport const isCloseEvent = (e: unknown): e is SetOptional<CloseEvent, \"target\"> => {\n  return z.object({ type: z.string(), code: z.number(), reason: z.string(), wasClean: z.boolean() }).safeParse(e).success;\n};\n\nexport const isErrorEvent = (e: unknown): e is SetOptional<ErrorEvent, \"target\"> => {\n  return z.object({ type: z.string(), message: z.string(), error: z.any() }).safeParse(e).success;\n};\n\nexport const isGraphQLErrors = (e: unknown): e is readonly GraphQLError[] => {\n  return z.array(z.object({ message: z.string() })).safeParse(e).success;\n};\n\nexport const isNever = (value: never): never => {\n  // eslint-disable-next-line @typescript-eslint/restrict-template-expressions\n  throw new Error(`Unexpected value: ${value}`);\n};\n\nexport const isAbortError = (error: unknown): error is Error | Event => {\n  return (error instanceof Error && error.name === \"AbortError\") || (error instanceof Event && error.type === \"abort\");\n};\n"],"names":["z","isNil","val","undefined","isString","isObject","Object","isFunction","isError","Error","isCloseEvent","e","object","type","string","code","number","reason","wasClean","boolean","safeParse","success","isErrorEvent","message","error","any","isGraphQLErrors","array","isNever","value","isAbortError","name","Event"],"mappings":"AAGA,SAASA,CAAC,QAAQ,MAAM;AAExB,OAAO,MAAMC,QAAQ,CAACC;IACpB,OAAOA,QAAQ,QAAQA,QAAQC;AACjC,EAAE;AAEF,OAAO,MAAMC,WAAW,CAACF;IACvB,OAAO,OAAOA,QAAQ;AACxB,EAAE;AAEF,OAAO,MAAMG,WAAW,CAACH;IACvB,OAAOA,eAAeI;AACxB,EAAE;AAEF,wDAAwD;AACxD,OAAO,MAAMC,aAAa,CAACL;IACzB,OAAO,OAAOA,QAAQ;AACxB,EAAE;AAEF,OAAO,MAAMM,UAAU,CAACN;IACtB,OAAOA,eAAeO;AACxB,EAAE;AAEF,OAAO,MAAMC,eAAe,CAACC;IAC3B,OAAOX,EAAEY,MAAM,CAAC;QAAEC,MAAMb,EAAEc,MAAM;QAAIC,MAAMf,EAAEgB,MAAM;QAAIC,QAAQjB,EAAEc,MAAM;QAAII,UAAUlB,EAAEmB,OAAO;IAAG,GAAGC,SAAS,CAACT,GAAGU,OAAO;AACzH,EAAE;AAEF,OAAO,MAAMC,eAAe,CAACX;IAC3B,OAAOX,EAAEY,MAAM,CAAC;QAAEC,MAAMb,EAAEc,MAAM;QAAIS,SAASvB,EAAEc,MAAM;QAAIU,OAAOxB,EAAEyB,GAAG;IAAG,GAAGL,SAAS,CAACT,GAAGU,OAAO;AACjG,EAAE;AAEF,OAAO,MAAMK,kBAAkB,CAACf;IAC9B,OAAOX,EAAE2B,KAAK,CAAC3B,EAAEY,MAAM,CAAC;QAAEW,SAASvB,EAAEc,MAAM;IAAG,IAAIM,SAAS,CAACT,GAAGU,OAAO;AACxE,EAAE;AAEF,OAAO,MAAMO,UAAU,CAACC;IACtB,4EAA4E;IAC5E,MAAM,IAAIpB,MAAM,CAAC,kBAAkB,EAAEoB,MAAM,CAAC;AAC9C,EAAE;AAEF,OAAO,MAAMC,eAAe,CAACN;IAC3B,OAAO,AAACA,iBAAiBf,SAASe,MAAMO,IAAI,KAAK,gBAAkBP,iBAAiBQ,SAASR,MAAMX,IAAI,KAAK;AAC9G,EAAE"}

package/lib/services/util/number.js

@@ -0,0 +1,27 @@
+/**
+ * Parses a string value into a number. If the value is an invalid
+ * number it returns {@linkcode defaultValue}.
+ *
+ * @param value - The string value to parse.
+ * @returns The parsed number.
+ */ export const parseNumber = (value, defaultValue = 0)=>{
+    value ??= "";
+    const parsed = Number.parseFloat(value);
+    return Number.isNaN(parsed) ? defaultValue : parsed;
+};
+/**
+ * Ensures that a number is within a given range.
+ *
+ * If the number is less than the minimum value, the minimum value is returned.
+ * If the number is greater than the maximum value, the maximum value is returned.
+ * Otherwise, the number is returned as is.
+ *
+ * @param value The value to be clamped.
+ * @param min The minimum value of the range.
+ * @param max The maximum value of the range.
+ * @returns The clamped value.
+ */ export const clamp = (value, min, max)=>{
+    return Math.max(min, Math.min(max, value));
+};
+
+//# sourceMappingURL=number.js.map

package/lib/services/util/number.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/util/number.ts"],"sourcesContent":["/**\n * Parses a string value into a number. If the value is an invalid\n * number it returns {@linkcode defaultValue}.\n *\n * @param value - The string value to parse.\n * @returns The parsed number.\n */\nexport const parseNumber = (value: string | null | undefined, defaultValue = 0): number => {\n  value ??= \"\";\n  const parsed = Number.parseFloat(value);\n  return Number.isNaN(parsed) ? defaultValue : parsed;\n};\n\n/**\n * Ensures that a number is within a given range.\n *\n * If the number is less than the minimum value, the minimum value is returned.\n * If the number is greater than the maximum value, the maximum value is returned.\n * Otherwise, the number is returned as is.\n *\n * @param value The value to be clamped.\n * @param min The minimum value of the range.\n * @param max The maximum value of the range.\n * @returns The clamped value.\n */\nexport const clamp = (value: number, min: number, max: number): number => {\n  return Math.max(min, Math.min(max, value));\n};\n"],"names":["parseNumber","value","defaultValue","parsed","Number","parseFloat","isNaN","clamp","min","max","Math"],"mappings":"AAAA;;;;;;CAMC,GACD,OAAO,MAAMA,cAAc,CAACC,OAAkCC,eAAe,CAAC;IAC5ED,UAAU;IACV,MAAME,SAASC,OAAOC,UAAU,CAACJ;IACjC,OAAOG,OAAOE,KAAK,CAACH,UAAUD,eAAeC;AAC/C,EAAE;AAEF;;;;;;;;;;;CAWC,GACD,OAAO,MAAMI,QAAQ,CAACN,OAAeO,KAAaC;IAChD,OAAOC,KAAKD,GAAG,CAACD,KAAKE,KAAKF,GAAG,CAACC,KAAKR;AACrC,EAAE"}

package/lib/services/util/object.js

@@ -0,0 +1,101 @@
+import cleanStack from "clean-stack";
+import { RequestError } from "got";
+import { inspect } from "node:util";
+import { serializeError as baseSerializeError } from "serialize-error";
+import { workspaceRoot } from "./paths.js";
+/**
+ * Returns a new object with the properties of the input object merged
+ * with the properties of the defaults object. If a property exists in
+ * both objects, the property of the input object will be used.
+ *
+ * @param input - The input object to merge with the defaults object.
+ * @param defaults - The defaults object to merge with the input object.
+ * @returns A new object with the properties of the input object merged
+ * with the properties of the defaults object.
+ */ export const defaults = (input, defaults)=>{
+    const result = {
+        ...input
+    };
+    for (const [key, defaultValue] of Object.entries(defaults)){
+        if (!result[key]) {
+            result[key] = defaultValue;
+        }
+    }
+    return result;
+};
+/**
+ * Creates a new object with only the specified properties of the
+ * original object.
+ *
+ * @param object - The original object to pick properties from.
+ * @param keys - The keys of the properties to pick.
+ * @returns A new object with only the specified properties of the
+ * original object.
+ */ export const pick = (object, keys)=>{
+    const result = {};
+    for (const key of keys){
+        result[key] = object[key];
+    }
+    return result;
+};
+/**
+ * Returns a new object with the specified keys omitted.
+ *
+ * @param record The input object.
+ * @param keys The keys to omit.
+ * @returns A new object with the specified keys omitted.
+ */ export const omit = (record, keys)=>{
+    const result = {
+        ...record
+    };
+    for (const key of keys){
+        // eslint-disable-next-line @typescript-eslint/no-dynamic-delete
+        delete result[key];
+    }
+    return result;
+};
+/**
+ * Maps the values of an object to a new set of values using the
+ * provided function.
+ *
+ * @param obj The input object to map.
+ * @param fn The function to apply to each value in the input object.
+ * @returns A new object with the same keys as the input object, but
+ * with the values mapped to new values using the provided function.
+ */ export const mapValues = (obj, fn)=>{
+    const result = {};
+    for (const [key, value] of Object.entries(obj)){
+        result[key] = fn(value);
+    }
+    return result;
+};
+/**
+ * Universal Error object to json blob serializer.
+ *
+ * Wraps `serialize-error` with some handy stuff, like special support
+ * for Got HTTP errors
+ */ export const serializeError = (error)=>{
+    let serialized = baseSerializeError(Array.isArray(error) ? new AggregateError(error) : error);
+    if (typeof serialized == "string") {
+        serialized = {
+            message: serialized
+        };
+    }
+    if (serialized.stack) {
+        serialized.stack = cleanStack(serialized.stack, {
+            pretty: true,
+            basePath: workspaceRoot
+        }).replaceAll(/file:\/\/\//g, "");
+    }
+    if (error instanceof RequestError) {
+        serialized["timings"] = undefined;
+        serialized["options"] = {
+            method: error.options.method,
+            url: error.options.url instanceof URL ? error.options.url.toJSON() : error.options.url
+        };
+        serialized["responseBody"] = inspect(error.response?.body);
+    }
+    return serialized;
+};
+
+//# sourceMappingURL=object.js.map

package/lib/services/util/object.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/services/util/object.ts"],"sourcesContent":["import cleanStack from \"clean-stack\";\nimport { RequestError } from \"got\";\nimport { inspect } from \"node:util\";\nimport { serializeError as baseSerializeError, type ErrorObject } from \"serialize-error\";\nimport type { Simplify } from \"type-fest\";\nimport { workspaceRoot } from \"./paths.js\";\n\n/**\n * Returns a new object with the properties of the input object merged\n * with the properties of the defaults object. If a property exists in\n * both objects, the property of the input object will be used.\n *\n * @param input - The input object to merge with the defaults object.\n * @param defaults - The defaults object to merge with the input object.\n * @returns A new object with the properties of the input object merged\n * with the properties of the defaults object.\n */\nexport const defaults = <Input extends Record<string, unknown>, Defaults extends Partial<Input>>(\n  input: Input | null | undefined,\n  defaults: Defaults,\n): Simplify<Defaults & Input> => {\n  const result = { ...input };\n  for (const [key, defaultValue] of Object.entries(defaults)) {\n    if (!result[key]) {\n      result[key] = defaultValue;\n    }\n  }\n  return result as Simplify<Defaults & Input>;\n};\n\n/**\n * Creates a new object with only the specified properties of the\n * original object.\n *\n * @param object - The original object to pick properties from.\n * @param keys - The keys of the properties to pick.\n * @returns A new object with only the specified properties of the\n * original object.\n */\nexport const pick = <T extends Record<string, unknown>, K extends keyof T>(object: T, keys: readonly K[]): Pick<T, K> => {\n  const result = {} as Pick<T, K>;\n  for (const key of keys) {\n    result[key] = object[key];\n  }\n  return result;\n};\n\n/**\n * Returns a new object with the specified keys omitted.\n *\n * @param record The input object.\n * @param keys The keys to omit.\n * @returns A new object with the specified keys omitted.\n */\nexport const omit = <T extends Record<string, unknown>, K extends keyof T>(record: T, keys: readonly K[]): Omit<T, K> => {\n  const result = { ...record };\n  for (const key of keys) {\n    // eslint-disable-next-line @typescript-eslint/no-dynamic-delete\n    delete result[key];\n  }\n  return result;\n};\n\n/**\n * Maps the values of an object to a new set of values using the\n * provided function.\n *\n * @param obj The input object to map.\n * @param fn The function to apply to each value in the input object.\n * @returns A new object with the same keys as the input object, but\n * with the values mapped to new values using the provided function.\n */\nexport const mapValues = <Key extends string | number | symbol, Value, MappedValue>(\n  obj: Record<Key, Value>,\n  fn: (value: Value) => MappedValue,\n): Record<Key, MappedValue> => {\n  const result = {} as Record<Key, MappedValue>;\n  for (const [key, value] of Object.entries(obj)) {\n    result[key as Key] = fn(value as Value);\n  }\n  return result;\n};\n\n/**\n * Universal Error object to json blob serializer.\n *\n * Wraps `serialize-error` with some handy stuff, like special support\n * for Got HTTP errors\n */\nexport const serializeError = (error: unknown): ErrorObject => {\n  let serialized = baseSerializeError(Array.isArray(error) ? new AggregateError(error) : error);\n  if (typeof serialized == \"string\") {\n    serialized = { message: serialized };\n  }\n\n  if (serialized.stack) {\n    serialized.stack = cleanStack(serialized.stack, { pretty: true, basePath: workspaceRoot }).replaceAll(/file:\\/\\/\\//g, \"\");\n  }\n\n  if (error instanceof RequestError) {\n    serialized[\"timings\"] = undefined;\n    serialized[\"options\"] = {\n      method: error.options.method,\n      url: error.options.url instanceof URL ? error.options.url.toJSON() : error.options.url,\n    };\n    serialized[\"responseBody\"] = inspect(error.response?.body);\n  }\n\n  return serialized;\n};\n"],"names":["cleanStack","RequestError","inspect","serializeError","baseSerializeError","workspaceRoot","defaults","input","result","key","defaultValue","Object","entries","pick","object","keys","omit","record","mapValues","obj","fn","value","error","serialized","Array","isArray","AggregateError","message","stack","pretty","basePath","replaceAll","undefined","method","options","url","URL","toJSON","response","body"],"mappings":"AAAA,OAAOA,gBAAgB,cAAc;AACrC,SAASC,YAAY,QAAQ,MAAM;AACnC,SAASC,OAAO,QAAQ,YAAY;AACpC,SAASC,kBAAkBC,kBAAkB,QAA0B,kBAAkB;AAEzF,SAASC,aAAa,QAAQ,aAAa;AAE3C;;;;;;;;;CASC,GACD,OAAO,MAAMC,WAAW,CACtBC,OACAD;IAEA,MAAME,SAAS;QAAE,GAAGD,KAAK;IAAC;IAC1B,KAAK,MAAM,CAACE,KAAKC,aAAa,IAAIC,OAAOC,OAAO,CAACN,UAAW;QAC1D,IAAI,CAACE,MAAM,CAACC,IAAI,EAAE;YAChBD,MAAM,CAACC,IAAI,GAAGC;QAChB;IACF;IACA,OAAOF;AACT,EAAE;AAEF;;;;;;;;CAQC,GACD,OAAO,MAAMK,OAAO,CAAuDC,QAAWC;IACpF,MAAMP,SAAS,CAAC;IAChB,KAAK,MAAMC,OAAOM,KAAM;QACtBP,MAAM,CAACC,IAAI,GAAGK,MAAM,CAACL,IAAI;IAC3B;IACA,OAAOD;AACT,EAAE;AAEF;;;;;;CAMC,GACD,OAAO,MAAMQ,OAAO,CAAuDC,QAAWF;IACpF,MAAMP,SAAS;QAAE,GAAGS,MAAM;IAAC;IAC3B,KAAK,MAAMR,OAAOM,KAAM;QACtB,gEAAgE;QAChE,OAAOP,MAAM,CAACC,IAAI;IACpB;IACA,OAAOD;AACT,EAAE;AAEF;;;;;;;;CAQC,GACD,OAAO,MAAMU,YAAY,CACvBC,KACAC;IAEA,MAAMZ,SAAS,CAAC;IAChB,KAAK,MAAM,CAACC,KAAKY,MAAM,IAAIV,OAAOC,OAAO,CAACO,KAAM;QAC9CX,MAAM,CAACC,IAAW,GAAGW,GAAGC;IAC1B;IACA,OAAOb;AACT,EAAE;AAEF;;;;;CAKC,GACD,OAAO,MAAML,iBAAiB,CAACmB;IAC7B,IAAIC,aAAanB,mBAAmBoB,MAAMC,OAAO,CAACH,SAAS,IAAII,eAAeJ,SAASA;IACvF,IAAI,OAAOC,cAAc,UAAU;QACjCA,aAAa;YAAEI,SAASJ;QAAW;IACrC;IAEA,IAAIA,WAAWK,KAAK,EAAE;QACpBL,WAAWK,KAAK,GAAG5B,WAAWuB,WAAWK,KAAK,EAAE;YAAEC,QAAQ;YAAMC,UAAUzB;QAAc,GAAG0B,UAAU,CAAC,gBAAgB;IACxH;IAEA,IAAIT,iBAAiBrB,cAAc;QACjCsB,UAAU,CAAC,UAAU,GAAGS;QACxBT,UAAU,CAAC,UAAU,GAAG;YACtBU,QAAQX,MAAMY,OAAO,CAACD,MAAM;YAC5BE,KAAKb,MAAMY,OAAO,CAACC,GAAG,YAAYC,MAAMd,MAAMY,OAAO,CAACC,GAAG,CAACE,MAAM,KAAKf,MAAMY,OAAO,CAACC,GAAG;QACxF;QACAZ,UAAU,CAAC,eAAe,GAAGrB,QAAQoB,MAAMgB,QAAQ,EAAEC;IACvD;IAEA,OAAOhB;AACT,EAAE"}