pepr 0.52.2 → 0.52.3

package/src/lib/assets/environment.ts

@@ -1,6 +1,13 @@
 import { V1EnvVar } from "@kubernetes/client-node";
 import { ModuleConfig } from "../types";
 
+export function getLogLevel(config: ModuleConfig): string {
+  const fromEnv = process.env.LOG_LEVEL;
+  if (fromEnv) {
+    return fromEnv;
+  }
+  return config.logLevel || "info";
+}
 export function genEnv(
   config: ModuleConfig,
   watchMode = false,
@@ -8,7 +15,7 @@ export function genEnv(
 ): V1EnvVar[] {
   const noWatchDef = {
     PEPR_PRETTY_LOG: "false",
-    LOG_LEVEL: config.logLevel || "info",
+    LOG_LEVEL: getLogLevel(config),
   };
 
   const def = {

package/src/lib/assets/loader.ts

@@ -29,7 +29,7 @@ export function loadCapabilities(path: string): Promise<CapabilityExport[]> {
 
       // Iterate through the capabilities and generate the rules
       for (const capability of capabilities) {
-        console.info(`Registered Pepr Capability "${capability.name}"`);
+        console.debug(`Registered Pepr Capability "${capability.name}"`);
       }
 
       resolve(capabilities);

package/src/lib/assets/yaml/generateAllYaml.ts

@@ -23,7 +23,7 @@ type services = {
   watch: V1Service | null;
 };
 
-export function pushControllerManifests(
+function pushControllerManifests(
   resources: KubernetesObject[],
   deployments: deployments,
   services: services,

package/src/lib/controller/index.ts

@@ -57,10 +57,10 @@ export class Controller {
       if (typeof onReady === "function") {
         onReady();
       }
-      Log.info("✅ Controller startup complete");
+      Log.debug("Controller startup complete");
       // Initialize the schedule store for each capability
       new StoreController(capabilities, `pepr-${config.uuid}-schedule`, () => {
-        Log.info("✅ Scheduling processed");
+        Log.debug("Scheduling processed");
       });
     });
 
@@ -112,7 +112,7 @@ export class Controller {
 
     // Handle server listening event
     server.on("listening", () => {
-      Log.info(`Server listening on port ${port}`);
+      Log.debug(`Server listening on port ${port}`);
       // Track that the server is running
       this.#running = true;
     });

package/src/lib/controller/store.ts

@@ -138,7 +138,7 @@ export class StoreController {
   };
 
   #createStoreResource = async (e: unknown): Promise<void> => {
-    Log.info(`Pepr store not found, creating...`);
+    Log.debug(`Pepr store not found, creating...`);
     Log.debug(e);
 
     try {

package/src/lib/core/capability.ts

@@ -133,7 +133,7 @@ export class Capability implements CapabilityExport {
     this.#namespaces = cfg.namespaces;
     this.hasSchedule = false;
 
-    Log.info(`Capability ${this.#name} registered`);
+    Log.debug(`Capability ${this.#name} registered`);
     Log.debug(cfg);
   }
 
@@ -141,7 +141,7 @@ export class Capability implements CapabilityExport {
    * Register the store with the capability. This is called automatically by the Pepr controller.
    */
   registerScheduleStore = (): Storage => {
-    Log.info(`Registering schedule store for ${this.#name}`);
+    Log.debug(`Registering schedule store for ${this.#name}`);
 
     if (this.#scheduleRegistered) {
       throw new Error(`Schedule store already registered for ${this.#name}`);
@@ -159,7 +159,7 @@ export class Capability implements CapabilityExport {
    * @param store
    */
   registerStore = (): Storage => {
-    Log.info(`Registering store for ${this.#name}`);
+    Log.debug(`Registering store for ${this.#name}`);
 
     if (this.#registered) {
       throw new Error(`Store already registered for ${this.#name}`);

package/src/lib/core/storage.ts

@@ -6,7 +6,7 @@ import pointer from "json-pointer";
 export type DataOp = "add" | "remove";
 export type DataStore = Record<string, string>;
 export type DataSender = (op: DataOp, keys: string[], value?: string) => void;
-export type DataReceiver = (data: DataStore) => void;
+type DataReceiver = (data: DataStore) => void;
 export type Unsubscribe = () => void;
 
 const MAX_WAIT_TIME = 15000;

package/src/lib/filter/adjudicators/binding.ts

@@ -74,7 +74,8 @@ export const definedCategory = (binding: Partial<Binding>): string => {
 
   return Object.keys(categories).find(key => categories[key]) || "";
 };
-export type DefinedCallbackReturnType =
+
+type DefinedCallbackReturnType =
   | FinalizeAction<GenericClass, InstanceType<GenericClass>>
   | WatchLogAction<GenericClass, InstanceType<GenericClass>>
   | MutateAction<GenericClass, InstanceType<GenericClass>>

package/src/lib/filter/adjudicators/kubernetesObject.ts

@@ -4,7 +4,7 @@
 import { __, allPass, complement, defaultTo, equals, length, gt, not, nthArg, pipe } from "ramda";
 import { KubernetesObject } from "kubernetes-fluent-client";
 
-export const carriesDeletionTimestamp = pipe(
+const carriesDeletionTimestamp = pipe(
   kubernetesObject => !!kubernetesObject.metadata?.deletionTimestamp,
   defaultTo(false),
 );

package/src/lib/processors/mutate-processor.ts

@@ -30,7 +30,7 @@ export interface Bindable {
   actMeta: Record<string, string>;
 }
 
-export interface Result {
+interface Result {
   wrapped: PeprMutateRequest<KubernetesObject>;
   response: MutateResponse;
 }

package/src/lib/types.ts

@@ -68,10 +68,6 @@ export type WhenSelector<T extends GenericClass> = {
   /** Register an action to be executed when a Kubernetes resource is deleted. */
   IsDeleted: () => BindingAll<T>;
 };
-export interface RegExpFilter {
-  obj: RegExp;
-  source: string;
-}
 
 export type Filters = {
   annotations: Record<string, string>;

package/src/runtime/controller.ts

@@ -18,16 +18,12 @@ function runModule(expectedHash: string): void {
   const gzPath = `/app/load/module-${expectedHash}.js.gz`;
   const jsPath = `/app/module-${expectedHash}.js`;
 
-  // Set the log level
-  Log.level = "info";
-
   // Check if the path is a valid file
   if (!fs.existsSync(gzPath)) {
     throw new Error(`File not found: ${gzPath}`);
   }
-
   try {
-    Log.info(`Loading module ${gzPath}`);
+    Log.debug(`Loading module ${gzPath}`);
 
     // Extract the code from the file
     const codeGZ = fs.readFileSync(gzPath);
@@ -42,8 +38,7 @@ function runModule(expectedHash: string): void {
     if (!crypto.timingSafeEqual(Buffer.from(expectedHash, "hex"), Buffer.from(actualHash, "hex"))) {
       throw new Error(`File hash does not match, expected ${expectedHash} but got ${actualHash}`);
     }
-
-    Log.info(`File hash matches, running module`);
+    Log.debug(`File hash matches, running module`);
 
     // Write the code to a file
     fs.writeFileSync(jsPath, code);
@@ -55,13 +50,10 @@ function runModule(expectedHash: string): void {
   }
 }
 
-Log.info(`Pepr Controller (v${version})`);
-
-const hash = process.argv[2];
-
-const startup = async (): Promise<void> => {
+export const startup = async (hash: string): Promise<void> => {
   try {
-    Log.info("Applying the Pepr Store CRD if it doesn't exist");
+    Log.debug(`Pepr Controller (v${version})`);
+    Log.debug("Applying the Pepr Store CRD if it doesn't exist");
     await K8s(kind.CustomResourceDefinition).Apply(peprStoreCRD, { force: true });
 
     validateHash(hash);
@@ -72,4 +64,6 @@ const startup = async (): Promise<void> => {
   }
 };
 
-startup().catch(err => Log.error(err, `Error starting Pepr Controller`));
+// Start the controller
+const hash = process.argv[2];
+startup(hash).catch(err => Log.error(err, `Error starting Pepr Controller`));

package/dist/cli/build.d.ts

@@ -1,34 +0,0 @@
-import { BuildContext, BuildOptions, BuildResult } from "esbuild";
-import { Command } from "commander";
-import { ModuleConfig } from "../lib/types";
-export type Reloader = (opts: BuildResult<BuildOptions>) => void | Promise<void>;
-export type PeprNestedFields = Pick<ModuleConfig, "uuid" | "onError" | "webhookTimeout" | "customLabels" | "alwaysIgnore" | "env" | "rbac" | "rbacMode"> & {
-    peprVersion: string;
-};
-export type PeprConfig = Omit<ModuleConfig, keyof PeprNestedFields> & {
-    pepr: PeprNestedFields & {
-        includedFiles: string[];
-    };
-    description: string;
-    version: string;
-};
-type LoadModuleReturn = {
-    cfg: PeprConfig;
-    entryPointPath: string;
-    modulePath: string;
-    name: string;
-    path: string;
-    uuid: string;
-};
-type BuildModuleReturn = {
-    ctx: BuildContext<BuildOptions>;
-    path: string;
-    cfg: PeprConfig;
-    uuid: string;
-};
-export default function (program: Command): void;
-export declare function loadModule(entryPoint?: string): Promise<LoadModuleReturn>;
-export declare function buildModule(reloader?: Reloader, entryPoint?: string, embed?: boolean): Promise<BuildModuleReturn | void>;
-export declare function checkFormat(): Promise<void>;
-export {};
-//# sourceMappingURL=build.d.ts.map

package/dist/cli/build.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../src/cli/build.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAmB,MAAM,SAAS,CAAC;AAKnF,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAc5C,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACjF,MAAM,MAAM,gBAAgB,GAAG,IAAI,CACjC,YAAY,EACV,MAAM,GACN,SAAS,GACT,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,KAAK,GACL,MAAM,GACN,UAAU,CACb,GAAG;IACF,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,EAAE,MAAM,gBAAgB,CAAC,GAAG;IACpE,IAAI,EAAE,gBAAgB,GAAG;QACvB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,gBAAgB,GAAG;IACtB,GAAG,EAAE,UAAU,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,iBAAiB,GAAG;IACvB,GAAG,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,UAAU,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,CAAC,OAAO,WAAW,OAAO,EAAE,OAAO,GAAG,IAAI,CA8H/C;AAWD,wBAAsB,UAAU,CAAC,UAAU,SAAS,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAuC/E;AAED,wBAAsB,WAAW,CAC/B,QAAQ,CAAC,EAAE,QAAQ,EACnB,UAAU,SAAS,EACnB,KAAK,UAAO,GACX,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAwEnC;AA6CD,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CASjD"}

package/dist/cli/build.helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"build.helpers.d.ts","sourceRoot":"","sources":["../../src/cli/build.helpers.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAW,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3E,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAc9C,UAAU,YAAY;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AACD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAe9D;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,WAAW,CAAC,YAAY,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACjF;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3B,GAAG,EAAE;IAAE,IAAI,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACnC,MAAM,CAaR;AAED;;;;GAIG;AAEH,wBAAsB,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAS9E;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAI/F;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAStE;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,aAAa,EAAE,MAAM,EAAE,EACvB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAQjF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,QAAQ,GAAG,SAAS,GAC7B,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC,CAarC;AAED,wBAAsB,0BAA0B,CAAC,GAAG,EAAE;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAiChB"}

package/src/cli/build.ts

@@ -1,375 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-
-import { execFileSync } from "child_process";
-import { BuildContext, BuildOptions, BuildResult, analyzeMetafile } from "esbuild";
-import { promises as fs } from "fs";
-import { basename, dirname, extname, resolve } from "path";
-import { Assets } from "../lib/assets/assets";
-import { dependencies, version } from "./init/templates";
-import { Command } from "commander";
-import { Option } from "commander";
-import { parseTimeout } from "../lib/helpers";
-import { peprFormat } from "./format";
-import { ModuleConfig } from "../lib/types";
-import {
-  watchForChanges,
-  determineRbacMode,
-  assignImage,
-  createOutputDirectory,
-  handleValidCapabilityNames,
-  handleCustomImageBuild,
-  validImagePullSecret,
-  generateYamlAndWriteToDisk,
-} from "./build.helpers";
-
-const peprTS = "pepr.ts";
-let outputDir: string = "dist";
-export type Reloader = (opts: BuildResult<BuildOptions>) => void | Promise<void>;
-export type PeprNestedFields = Pick<
-  ModuleConfig,
-  | "uuid"
-  | "onError"
-  | "webhookTimeout"
-  | "customLabels"
-  | "alwaysIgnore"
-  | "env"
-  | "rbac"
-  | "rbacMode"
-> & {
-  peprVersion: string;
-};
-
-export type PeprConfig = Omit<ModuleConfig, keyof PeprNestedFields> & {
-  pepr: PeprNestedFields & {
-    includedFiles: string[];
-  };
-  description: string;
-  version: string;
-};
-
-type LoadModuleReturn = {
-  cfg: PeprConfig;
-  entryPointPath: string;
-  modulePath: string;
-  name: string;
-  path: string;
-  uuid: string;
-};
-
-type BuildModuleReturn = {
-  ctx: BuildContext<BuildOptions>;
-  path: string;
-  cfg: PeprConfig;
-  uuid: string;
-};
-
-export default function (program: Command): void {
-  program
-    .command("build")
-    .description("Build a Pepr Module for deployment")
-    .addOption(
-      new Option("-M, --rbac-mode <mode>", "Override module config and set RBAC mode.").choices([
-        "admin",
-        "scoped",
-      ]),
-    )
-    .addOption(
-      new Option(
-        "-I, --registry-info <registry/username>",
-        "Provide the image registry and username for building and pushing a custom WASM container. Requires authentication. Conflicts with --custom-image and --registry. Builds and pushes `'<registry/username>/custom-pepr-controller:<current-version>'`.",
-      ).conflicts(["customImage", "registry"]),
-    )
-    .option("-P, --with-pull-secret <name>", "Use image pull secret for controller Deployment.", "")
-    .addOption(
-      new Option(
-        "-c, --custom-name <name>",
-        "Set name for zarf component and service monitors in helm charts.",
-      ),
-    )
-    .option("-e, --entry-point <file>", "Specify the entry point file to build with.", peprTS)
-    .addOption(
-      new Option(
-        "-i, --custom-image <image>",
-        "Specify a custom image with version for deployments. Conflicts with --registry-info and --registry. Example: 'docker.io/username/custom-pepr-controller:v1.0.0'",
-      ).conflicts(["registryInfo", "registry"]),
-    )
-    .option(
-      "-n, --no-embed",
-      "Disable embedding of deployment files into output module. Useful when creating library modules intended solely for reuse/distribution via NPM.",
-    )
-    .option("-o, --output <directory>", "Set output directory.", "dist")
-    .addOption(
-      new Option(
-        "-r, --registry <GitHub|Iron Bank>",
-        "Container registry: Choose container registry for deployment manifests. Conflicts with --custom-image and --registry-info.",
-      )
-        .conflicts(["customImage", "registryInfo"])
-        .choices(["GitHub", "Iron Bank"]),
-    )
-    .option(
-      "-t, --timeout <seconds>",
-      "How long the API server should wait for a webhook to respond before treating the call as a failure.",
-      parseTimeout,
-    )
-    .addOption(
-      new Option("-z, --zarf <manifest|chart>", "Set Zarf package type")
-        .choices(["manifest", "chart"])
-        .default("manifest"),
-    )
-    .action(async opts => {
-      outputDir = await createOutputDirectory(opts.output);
-
-      // Build the module
-      const buildModuleResult = await buildModule(undefined, opts.entryPoint, opts.embed);
-
-      const { cfg, path } = buildModuleResult!;
-      // override the name if provided
-      if (opts.customName) {
-        process.env.PEPR_CUSTOM_BUILD_NAME = opts.customName;
-      }
-
-      const image = assignImage({
-        customImage: opts.customImage,
-        registryInfo: opts.registryInfo,
-        peprVersion: cfg.pepr.peprVersion,
-        registry: opts.registry,
-      });
-
-      // Check if there is a custom timeout defined
-      if (opts.timeout !== undefined) {
-        cfg.pepr.webhookTimeout = opts.timeout;
-      }
-
-      if (opts.registryInfo !== undefined) {
-        console.info(`Including ${cfg.pepr.includedFiles.length} files in controller image.`);
-        // for journey test to make sure the image is built
-
-        // only actually build/push if there are files to include
-        await handleCustomImageBuild(
-          cfg.pepr.includedFiles,
-          cfg.pepr.peprVersion,
-          cfg.description,
-          image,
-        );
-      }
-
-      // If building without embedding, exit after building
-      if (!opts.embed) {
-        console.info(`Module built successfully at ${path}`);
-        return;
-      }
-
-      // Generate a secret for the module
-      const assets = new Assets(
-        {
-          ...cfg.pepr,
-          appVersion: cfg.version,
-          description: cfg.description,
-          alwaysIgnore: {
-            namespaces: cfg.pepr.alwaysIgnore?.namespaces,
-          },
-          // Can override the rbacMode with the CLI option
-          rbacMode: determineRbacMode(opts, cfg),
-        },
-        path,
-        opts.withPullSecret === "" ? [] : [opts.withPullSecret],
-      );
-
-      if (image !== "") assets.image = image;
-
-      // Ensure imagePullSecret is valid
-      validImagePullSecret(opts.withPullSecret);
-
-      handleValidCapabilityNames(assets.capabilities);
-      await generateYamlAndWriteToDisk({
-        uuid: cfg.pepr.uuid,
-        outputDir,
-        imagePullSecret: opts.withPullSecret,
-        zarf: opts.zarf,
-        assets,
-      });
-    });
-}
-
-// Create a list of external libraries to exclude from the bundle, these are already stored in the container
-const externalLibs = Object.keys(dependencies);
-
-// Add the pepr library to the list of external libraries
-externalLibs.push("pepr");
-
-// Add the kubernetes client to the list of external libraries as it is pulled in by kubernetes-fluent-client
-externalLibs.push("@kubernetes/client-node");
-
-export async function loadModule(entryPoint = peprTS): Promise<LoadModuleReturn> {
-  // Resolve path to the module / files
-  const entryPointPath = resolve(".", entryPoint);
-  const modulePath = dirname(entryPointPath);
-  const cfgPath = resolve(modulePath, "package.json");
-
-  // Ensure the module's package.json and entrypoint files exist
-  try {
-    await fs.access(cfgPath);
-    await fs.access(entryPointPath);
-  } catch {
-    console.error(
-      `Could not find ${cfgPath} or ${entryPointPath} in the current directory. Please run this command from the root of your module's directory.`,
-    );
-    process.exit(1);
-  }
-
-  // Read the module's UUID from the package.json file
-  const moduleText = await fs.readFile(cfgPath, { encoding: "utf-8" });
-  const cfg = JSON.parse(moduleText);
-  const { uuid } = cfg.pepr;
-  const name = `pepr-${uuid}.js`;
-
-  // Set the Pepr version from the current running version
-  cfg.pepr.peprVersion = version;
-
-  // Exit if the module's UUID could not be found
-  if (!uuid) {
-    throw new Error("Could not load the uuid in package.json");
-  }
-
-  return {
-    cfg,
-    entryPointPath,
-    modulePath,
-    name,
-    path: resolve(outputDir, name),
-    uuid,
-  };
-}
-
-export async function buildModule(
-  reloader?: Reloader,
-  entryPoint = peprTS,
-  embed = true,
-): Promise<BuildModuleReturn | void> {
-  try {
-    const { cfg, modulePath, path, uuid } = await loadModule(entryPoint);
-
-    await checkFormat();
-    // Resolve node_modules folder (in support of npm workspaces!)
-    const npmRoot = execFileSync("npm", ["root"]).toString().trim();
-
-    // Run `tsc` to validate the module's types & output sourcemaps
-    const args = ["--project", `${modulePath}/tsconfig.json`, "--outdir", outputDir];
-    execFileSync(`${npmRoot}/.bin/tsc`, args);
-
-    // Common build options for all builds
-    const ctxCfg: BuildOptions = {
-      bundle: true,
-      entryPoints: [entryPoint],
-      external: externalLibs,
-      format: "cjs",
-      keepNames: true,
-      legalComments: "external",
-      metafile: true,
-      minify: true,
-      outfile: path,
-      plugins: [
-        {
-          name: "reload-server",
-          setup(build): void | Promise<void> {
-            build.onEnd(async r => {
-              // Print the build size analysis
-              if (r?.metafile) {
-                console.info(await analyzeMetafile(r.metafile));
-              }
-
-              // If we're in dev mode, call the reloader function
-              if (reloader) {
-                await reloader(r);
-              }
-            });
-          },
-        },
-      ],
-      platform: "node",
-      sourcemap: true,
-      treeShaking: true,
-    };
-
-    if (reloader) {
-      // Only minify the code if we're not in dev mode
-      ctxCfg.minify = false;
-    }
-
-    // If not embedding (i.e. making a library module to be distro'd via NPM)
-    if (!embed) {
-      // Don't minify
-      ctxCfg.minify = false;
-
-      // Preserve the original file name
-      ctxCfg.outfile = resolve(outputDir, basename(entryPoint, extname(entryPoint))) + ".js";
-
-      // Don't bundle
-      ctxCfg.packages = "external";
-
-      // Don't tree shake
-      ctxCfg.treeShaking = false;
-    }
-
-    const ctx = await watchForChanges(ctxCfg, reloader);
-
-    return { ctx, path, cfg, uuid };
-  } catch (e) {
-    handleModuleBuildError(e);
-  }
-}
-
-interface BuildModuleResult {
-  stdout?: Buffer;
-  stderr: Buffer;
-}
-
-function handleModuleBuildError(e: BuildModuleResult): void {
-  console.error(`Error building module:`, e);
-
-  if (!e.stdout) process.exit(1); // Exit with a non-zero exit code on any other error
-
-  const out = e.stdout.toString() as string;
-  const err = e.stderr.toString();
-
-  console.info(out);
-  console.error(err);
-
-  // Check for version conflicts
-  if (out.includes("Types have separate declarations of a private property '_name'.")) {
-    // Try to find the conflicting package
-    const pgkErrMatch = /error TS2322: .*? 'import\("\/.*?\/node_modules\/(.*?)\/node_modules/g;
-    out.matchAll(pgkErrMatch);
-
-    // Look for package conflict errors
-    const conflicts = [...out.matchAll(pgkErrMatch)];
-
-    // If the regex didn't match, leave a generic error
-    if (conflicts.length < 1) {
-      console.info(
-        `\n\tOne or more imported Pepr Capabilities seem to be using an incompatible version of Pepr.\n\tTry updating your Pepr Capabilities to their latest versions.`,
-        "Version Conflict",
-      );
-    }
-
-    // Otherwise, loop through each conflicting package and print an error
-    conflicts.forEach(match => {
-      console.info(
-        `\n\tPackage '${match[1]}' seems to be incompatible with your current version of Pepr.\n\tTry updating to the latest version.`,
-        "Version Conflict",
-      );
-    });
-  }
-}
-
-export async function checkFormat(): Promise<void> {
-  const validFormat = await peprFormat(true);
-
-  if (!validFormat) {
-    console.info(
-      "\x1b[33m%s\x1b[0m",
-      "Formatting errors were found. The build will continue, but you may want to run `npx pepr format` to address any issues.",
-    );
-  }
-}