pepr 0.3.2 → 0.4.0

package/dist/src/cli/index.js

@@ -1,35 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const package_json_1 = require("../../package.json");
-const banner_1 = require("./banner");
-const build_1 = __importDefault(require("./build"));
-const deploy_1 = __importDefault(require("./deploy"));
-const dev_1 = __importDefault(require("./dev"));
-const init_1 = __importDefault(require("./init"));
-const root_1 = require("./root");
-const update_1 = __importDefault(require("./update"));
-const program = new root_1.RootCmd();
-program
-    .version(package_json_1.version)
-    .description(`Pepr Kubernetes Thingy (v${package_json_1.version})`)
-    .action(() => {
-    if (program.args.length < 1) {
-        console.log(banner_1.banner);
-        program.help();
-    }
-});
-(0, init_1.default)(program);
-(0, build_1.default)(program);
-(0, deploy_1.default)(program);
-(0, dev_1.default)(program);
-(0, update_1.default)(program);
-// @todo: finish/re-evaluate these commands
-// test(program);
-// capability(program);
-program.parse();

package/dist/src/cli/init/index.js

@@ -1,81 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const child_process_1 = require("child_process");
-const path_1 = require("path");
-const prompts_1 = __importDefault(require("prompts"));
-const logger_1 = __importDefault(require("../../../src/lib/logger"));
-const templates_1 = require("./templates");
-const utils_1 = require("./utils");
-const walkthrough_1 = require("./walkthrough");
-function default_1(program) {
-    program
-        .command("init")
-        .description("Initialize a new Pepr Module")
-        // skip auto npm install and git init
-        .option("--skip-post-init", "Skip npm install, git init and VSCode launch")
-        .action(async (opts) => {
-        let pkgOverride = "";
-        // Overrides for testing. @todo: don't be so gross with Node CLI testing
-        if (process.env.TEST_MODE === "true") {
-            prompts_1.default.inject(["pepr-test-module", "A test module for Pepr", "ignore", "y"]);
-            pkgOverride = "file:../pepr-0.0.0-development.tgz";
-        }
-        const response = await (0, walkthrough_1.walkthrough)();
-        const dirName = (0, utils_1.sanitizeName)(response.name);
-        const packageJSON = (0, templates_1.genPkgJSON)(response, pkgOverride);
-        const peprTS = (0, templates_1.genPeprTS)();
-        const confirmed = await (0, walkthrough_1.confirm)(dirName, packageJSON, peprTS.path);
-        if (confirmed) {
-            console.log("Creating new Pepr module...");
-            try {
-                await (0, utils_1.createDir)(dirName);
-                await (0, utils_1.createDir)((0, path_1.resolve)(dirName, ".vscode"));
-                await (0, utils_1.createDir)((0, path_1.resolve)(dirName, "capabilities"));
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, templates_1.gitIgnore.path), templates_1.gitIgnore.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, templates_1.prettierRC.path), templates_1.prettierRC.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, packageJSON.path), packageJSON.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, templates_1.readme.path), templates_1.readme.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, templates_1.tsConfig.path), templates_1.tsConfig.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, peprTS.path), peprTS.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, ".vscode", templates_1.snippet.path), templates_1.snippet.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, "capabilities", templates_1.samplesYaml.path), templates_1.samplesYaml.data);
-                await (0, utils_1.write)((0, path_1.resolve)(dirName, "capabilities", templates_1.helloPeprTS.path), templates_1.helloPeprTS.data);
-                if (!opts.skipPostInit) {
-                    // run npm install from the new directory
-                    process.chdir(dirName);
-                    (0, child_process_1.execSync)("npm install", {
-                        stdio: "inherit",
-                    });
-                    // setup git
-                    (0, child_process_1.execSync)("git init", {
-                        stdio: "inherit",
-                    });
-                    // try to open vscode
-                    try {
-                        (0, child_process_1.execSync)("code .", {
-                            stdio: "inherit",
-                        });
-                    }
-                    catch (e) {
-                        // vscode not found, do nothing
-                    }
-                }
-                console.log(`New Pepr module created at ${dirName}`);
-                console.log(`Open VSCode or your editor of choice in ${dirName} to get started!`);
-            }
-            catch (e) {
-                logger_1.default.debug(e);
-                if (e instanceof Error) {
-                    logger_1.default.error(e.message);
-                }
-                process.exit(1);
-            }
-        }
-    });
-}
-exports.default = default_1;

package/dist/src/cli/init/templates/.prettierrc.json

@@ -1,13 +0,0 @@
-{
-    "arrowParens": "avoid",
-    "bracketSameLine": false,
-    "bracketSpacing": true,
-    "embeddedLanguageFormatting": "auto",
-    "insertPragma": false,
-    "printWidth": 80,
-    "quoteProps": "as-needed",
-    "requirePragma": false,
-    "semi": true,
-    "tabWidth": 2,
-    "useTabs": false
-}

package/dist/src/cli/init/templates/capabilities/hello-pepr.samples.json

@@ -1,115 +0,0 @@
-[
-    {
-        "apiVersion": "v1",
-        "kind": "Namespace",
-        "metadata": {
-            "name": "pepr-demo",
-            "labels": {
-                "keep-me": "please",
-                "remove-me": "please"
-            }
-        }
-    },
-    {
-        "apiVersion": "v1",
-        "kind": "ConfigMap",
-        "metadata": {
-            "name": "example-1",
-            "namespace": "pepr-demo"
-        },
-        "data": {
-            "key": "ex-1-val"
-        }
-    },
-    {
-        "apiVersion": "v1",
-        "kind": "ConfigMap",
-        "metadata": {
-            "name": "example-2",
-            "namespace": "pepr-demo"
-        },
-        "data": {
-            "key": "ex-2-val"
-        }
-    },
-    {
-        "apiVersion": "v1",
-        "kind": "ConfigMap",
-        "metadata": {
-            "name": "example-3",
-            "namespace": "pepr-demo",
-            "labels": {
-                "change": "by-label"
-            }
-        },
-        "data": {
-            "key": "ex-3-val"
-        }
-    },
-    {
-        "apiVersion": "v1",
-        "kind": "ConfigMap",
-        "metadata": {
-            "name": "example-4",
-            "namespace": "pepr-demo"
-        },
-        "data": {
-            "key": "ex-4-val"
-        }
-    },
-    {
-        "apiVersion": "v1",
-        "kind": "ConfigMap",
-        "metadata": {
-            "name": "example-5",
-            "namespace": "pepr-demo",
-            "labels": {
-                "chuck-norris": "test"
-            }
-        },
-        "data": {
-            "key": "ex-5-val"
-        }
-    },
-    {
-        "apiVersion": "apiextensions.k8s.io/v1",
-        "kind": "CustomResourceDefinition",
-        "metadata": {
-            "name": "unicorns.pepr.dev"
-        },
-        "spec": {
-            "group": "pepr.dev",
-            "versions": [
-                {
-                    "name": "v1",
-                    "served": true,
-                    "storage": true,
-                    "schema": {
-                        "openAPIV3Schema": {
-                            "type": "object",
-                            "properties": {
-                                "spec": {
-                                    "type": "object",
-                                    "properties": {
-                                        "message": {
-                                            "type": "string"
-                                        },
-                                        "counter": {
-                                            "type": "number"
-                                        }
-                                    }
-                                }
-                            }
-                        }
-                    }
-                }
-            ],
-            "scope": "Namespaced",
-            "names": {
-                "plural": "unicorns",
-                "singular": "unicorn",
-                "kind": "Unicorn"
-            }
-        }
-    }
-]

package/dist/src/cli/init/templates/data.json

@@ -1 +0,0 @@
-{ "gitignore": "# Ignore node_modules and Pepr build artifacts\nnode_modules\ndist\ninsecure*\n", "readme": "# Pepr Module\n\nThis is a Pepr Module. [Pepr](https://github.com/defenseunicorns/pepr) is a Kubernetes transformation system\nwritten in Typescript.\n\nThe `capabilities` directory contains all the capabilities for this module. By default,\na capability is a single typescript file in the format of `capability-name.ts` that is\nimported in the root `pepr.ts` file as `import { HelloPepr } from \"./capabilities/hello-pepr\";`.\nBecause this is typescript, you can organize this however you choose, e.g. creating a sub-folder\nper-capability or common logic in shared files or folders.\n\nExample Structure:\n\n```\nModule Root\n├── package.json\n├── pepr.ts\n└── capabilities\n    ├── example-one.ts\n    ├── example-three.ts\n    └── example-two.ts\n```\n", "peprTS": "import { Log, PeprModule } from \"pepr\";\nimport { HelloPepr } from \"./capabilities/hello-pepr\";\n// cfg loads your pepr configuration from package.json\nimport cfg from \"./package.json\";\n\n/**\n * This is the main entrypoint for this Pepr module. It is run when the module is started.\n * This is where you register your Pepr configurations and capabilities.\n */\nnew PeprModule(\n  cfg,\n  [\n    // \"HelloPepr\" is a demo capability that is included with Pepr. Comment or delete the line below to remove it.\n    HelloPepr,\n\n    // Your additional capabilities go here\n  ],\n  {\n    // Any actions you want to perform before the request is processed, including modifying the request.\n    // Comment out or delete the line below to remove the default beforeHook.\n    beforeHook: req => Log.debug(`beforeHook: ${req.uid}`),\n\n    // Any actions you want to perform after the request is processed, including modifying the response.\n    // Comment out or delete the line below to remove the default afterHook.\n    afterHook: res => Log.debug(`afterHook: ${res.uid}`),\n  }\n);\n", "helloPeprTS": "import {\n  Capability,\n  PeprRequest,\n  RegisterKind,\n  a,\n  fetch,\n  fetchStatus,\n} from \"pepr\";\n\n/**\n *  The HelloPepr Capability is an example capability to demonstrate some general concepts of Pepr.\n *  To test this capability you can run `pepr dev` or `npm start` and then run the following command:\n *  `kubectl apply -f capabilities/hello-pepr.samples.yaml`\n */\nexport const HelloPepr = new Capability({\n  name: \"hello-pepr\",\n  description: \"A simple example capability to show how things work.\",\n  namespaces: [\"pepr-demo\"],\n});\n\n// Use the 'When' function to create a new Capability Action\nconst { When } = HelloPepr;\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (Namespace)                                   *\n * ---------------------------------------------------------------------------------------------------\n *\n * This Capability Action removes the label `remove-me` when a Namespace is created.\n * Note we don't need to specify the namespace here, because we've already specified\n * it in the Capability definition above.\n */\nWhen(a.Namespace)\n  .IsCreated()\n  .Then(ns => ns.RemoveLabel(\"remove-me\"));\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (CM Example 1)                                *\n * ---------------------------------------------------------------------------------------------------\n *\n * This is a single Capability Action. They can be in the same file or put imported from other files.\n * In this example, when a ConfigMap is created with the name `example-1`, then add a label and annotation.\n *\n * Equivalent to manually running:\n * `kubectl label configmap example-1 pepr=was-here`\n * `kubectl annotate configmap example-1 pepr.dev=annotations-work-too`\n */\nWhen(a.ConfigMap)\n  .IsCreated()\n  .WithName(\"example-1\")\n  .Then(request =>\n    request\n      .SetLabel(\"pepr\", \"was-here\")\n      .SetAnnotation(\"pepr.dev\", \"annotations-work-too\")\n  );\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (CM Example 2)                                *\n * ---------------------------------------------------------------------------------------------------\n *\n * This Capability Action does the exact same changes for example-2, except this time it uses\n * the `.ThenSet()` feature. You can stack multiple `.Then()` calls, but only a single `.ThenSet()`\n */\nWhen(a.ConfigMap)\n  .IsCreated()\n  .WithName(\"example-2\")\n  .ThenSet({\n    metadata: {\n      labels: {\n        pepr: \"was-here\",\n      },\n      annotations: {\n        \"pepr.dev\": \"annotations-work-too\",\n      },\n    },\n  });\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (CM Example 3)                                *\n * ---------------------------------------------------------------------------------------------------\n *\n * This Capability Action combines different styles. Unlike the previous actions, this one will look\n * for any ConfigMap in the `pepr-demo` namespace that has the label `change=by-label` during either\n * CREATE or UPDATE. Note that all conditions added such as `WithName()`, `WithLabel()`, `InNamespace()`,\n * are ANDs so all conditions must be true for the request to be processed.\n */\nWhen(a.ConfigMap)\n  .IsCreatedOrUpdated()\n  .WithLabel(\"change\", \"by-label\")\n  .Then(request => {\n    // The K8s object e are going to mutate\n    const cm = request.Raw;\n\n    // Get the username and uid of the K8s request\n    const { username, uid } = request.Request.userInfo;\n\n    // Store some data about the request in the configmap\n    cm.data[\"username\"] = username;\n    cm.data[\"uid\"] = uid;\n\n    // You can still mix other ways of making changes too\n    request.SetAnnotation(\"pepr.dev\", \"making-waves\");\n  });\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (CM Example 4)                                *\n * ---------------------------------------------------------------------------------------------------\n *\n * This Capability Action show how you can use the `Then()` function to make multiple changes to the\n * same object from different functions. This is useful if you want to keep your Capability Actions\n * small and focused on a single task, or if you want to reuse the same function in multiple\n * Capability Actions.\n *\n * Note that the order of the `.Then()` calls matters. The first call will be executed first,\n * then the second, and so on. Also note the functions are not called until the Capability Action\n * is triggered.\n */\nWhen(a.ConfigMap)\n  .IsCreated()\n  .WithName(\"example-4\")\n  .Then(cm => cm.SetLabel(\"pepr.dev/first\", \"true\"))\n  .Then(addSecond)\n  .Then(addThird);\n\n//This function uses the complete type definition, but is not required.\nfunction addSecond(cm: PeprRequest<a.ConfigMap>) {\n  cm.SetLabel(\"pepr.dev/second\", \"true\");\n}\n\n// This function has no type definition, so you won't have intellisense in the function body.\nfunction addThird(cm) {\n  cm.SetLabel(\"pepr.dev/third\", \"true\");\n}\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (CM Example 5)                                *\n * ---------------------------------------------------------------------------------------------------\n *\n * This Capability Action is a bit more complex. It will look for any ConfigMap in the `pepr-demo`\n * namespace that has the label `chuck-norris` during CREATE. When it finds one, it will fetch a\n * random Chuck Norris joke from the API and add it to the ConfigMap. This is a great example of how\n * you can use Pepr to make changes to your K8s objects based on external data.\n *\n * Note the use of the `async` keyword. This is required for any Capability Action that uses `await` or `fetch()`.\n *\n * Also note we are passing a type to the `fetch()` function. This is optional, but it will help you\n * avoid mistakes when working with the data returned from the API. You can also use the `as` keyword to\n * cast the data returned from the API.\n *\n * These are equivalent:\n * ```ts\n * const joke = await fetch<TheChuckNorrisJoke>(\"https://api.chucknorris.io/jokes/random?category=dev\");\n * const joke = await fetch(\"https://api.chucknorris.io/jokes/random?category=dev\") as TheChuckNorrisJoke;\n * ```\n *\n * Alternatively, you can drop the type completely:\n *\n * ```ts\n * fetch(\"https://api.chucknorris.io/jokes/random?category=dev\")\n * ```\n */\ninterface TheChuckNorrisJoke {\n  icon_url: string;\n  id: string;\n  url: string;\n  value: string;\n}\n\nWhen(a.ConfigMap)\n  .IsCreated()\n  .WithLabel(\"chuck-norris\")\n  .Then(async change => {\n    // Try/catch is not needed as a response object will always be returned\n    const response = await fetch<TheChuckNorrisJoke>(\n      \"https://api.chucknorris.io/jokes/random?category=dev\"\n    );\n\n    // Instead, check the `response.ok` field\n    if (response.ok) {\n      // Add the Chuck Norris joke to the configmap\n      change.Raw.data[\"chuck-says\"] = response.data.value;\n      return;\n    }\n\n    // You can also assert on different HTTP response codes\n    if (response.status === fetchStatus.NOT_FOUND) {\n      // Do something else\n      return;\n    }\n  });\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (Untyped Custom Resource)                     *\n * ---------------------------------------------------------------------------------------------------\n *\n * Out of the box, Pepr supports all the standard Kubernetes objects. However, you can also create\n * your own types. This is useful if you are working with an Operator that creates custom resources.\n * There are two ways to do this, the first is to use the `When()` function with a `GenericKind`,\n * the second is to create a new class that extends `GenericKind` and use the `RegisterKind()` function.\n *\n * This example shows how to use the `When()` function with a `GenericKind`. Note that you\n * must specify the `group`, `version`, and `kind` of the object (if applicable). This is how Pepr knows\n * if the Capability Action should be triggered or not. Since we are using a `GenericKind`,\n * Pepr will not be able to provide any intellisense for the object, so you will need to refer to the\n * Kubernetes API documentation for the object you are working with.\n *\n * You will need ot wait for the CRD in `hello-pepr.samples.yaml` to be created, then you can apply\n *\n * ```yaml\n * apiVersion: pepr.dev/v1\n * kind: Unicorn\n * metadata:\n *   name: example-1\n *   namespace: pepr-demo\n * spec:\n *   message: replace-me\n *   counter: 0\n * ```\n */\nWhen(a.GenericKind, {\n  group: \"pepr.dev\",\n  version: \"v1\",\n  kind: \"Unicorn\",\n})\n  .IsCreated()\n  .WithName(\"example-1\")\n  .ThenSet({\n    spec: {\n      message: \"Hello Pepr without type data!\",\n      counter: Math.random(),\n    },\n  });\n\n/**\n * ---------------------------------------------------------------------------------------------------\n *                                   CAPABILITY ACTION (Typed Custom Resource)                       *\n * ---------------------------------------------------------------------------------------------------\n *\n * This example shows how to use the `RegisterKind()` function to create a new type. This is useful\n * if you are working with an Operator that creates custom resources and you want to have intellisense\n * for the object. Note that you must specify the `group`, `version`, and `kind` of the object (if applicable)\n * as this is how Pepr knows if the Capability Action should be triggered or not.\n *\n * Once you register a new Kind with Pepr, you can use the `When()` function with the new Kind. Ideally,\n * you should register custom Kinds at the top of your Capability file or Pepr Module so they are available\n * to all Capability Actions, but we are putting it here for demonstration purposes.\n *\n * You will need ot wait for the CRD in `hello-pepr.samples.yaml` to be created, then you can apply\n *\n * ```yaml\n * apiVersion: pepr.dev/v1\n * kind: Unicorn\n * metadata:\n *   name: example-2\n *   namespace: pepr-demo\n * spec:\n *   message: replace-me\n *   counter: 0\n * ```*\n */\nclass UnicornKind extends a.GenericKind {\n  spec: {\n    /**\n     * JSDoc comments can be added to explain more details about the field.\n     *\n     * @example\n     * ```ts\n     * request.Raw.spec.message = \"Hello Pepr!\";\n     * ```\n     * */\n    message: string;\n    counter: number;\n  };\n}\n\nRegisterKind(UnicornKind, {\n  group: \"pepr.dev\",\n  version: \"v1\",\n  kind: \"Unicorn\",\n});\n\nWhen(UnicornKind)\n  .IsCreated()\n  .WithName(\"example-2\")\n  .ThenSet({\n    spec: {\n      message: \"Hello Pepr now with type data!\",\n      counter: Math.random(),\n    },\n  });\n" }

package/dist/src/cli/init/templates/pepr.code-snippets.json

@@ -1,21 +0,0 @@
-{
-    "Create a new Pepr capability": {
-        "prefix": "create pepr capability",
-        "body": [
-            "import { Capability, a } from 'pepr';",
-            "",
-            "export const ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/} = new Capability({",
-            "\tname: '${TM_FILENAME_BASE}',",
-            "\tdescription: '${1:A brief description of this capability.}',",
-            "\tnamespaces: [${2:}],",
-            "});",
-            "",
-            "// Use the 'When' function to create a new Capability Action",
-            "const { When } = ${TM_FILENAME_BASE/(.*)/${1:/pascalcase}/};",
-            "",
-            "// When(a.<Kind>).Is<Event>().Then(change => change.<changes>",
-            "When(${3:})"
-        ],
-        "description": "Creates a new Pepr capability with a specified description, and optional namespaces, and adds a When statement for the specified value."
-    }
-}

package/dist/src/cli/init/templates/tsconfig.module.json

@@ -1,12 +0,0 @@
-{
-    "compilerOptions": {
-        "esModuleInterop": true,
-        "lib": ["ES2020"],
-        "moduleResolution": "node",
-        "resolveJsonModule": true,
-        "rootDir": ".",
-        "strict": false,
-        "target": "ES2020"
-    },
-    "include": ["**/*.ts"]
-}

package/dist/src/cli/init/templates.js

@@ -1,96 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.prettierRC = exports.tsConfig = exports.snippet = exports.samplesYaml = exports.gitIgnore = exports.helloPeprTS = exports.readme = exports.genPeprTS = exports.genPkgJSON = void 0;
-const client_node_1 = require("@kubernetes/client-node");
-const util_1 = require("util");
-const uuid_1 = require("uuid");
-const package_json_1 = require("../../../package.json");
-const _prettierrc_json_1 = __importDefault(require("./templates/.prettierrc.json"));
-const hello_pepr_samples_json_1 = __importDefault(require("./templates/capabilities/hello-pepr.samples.json"));
-const data_json_1 = __importDefault(require("./templates/data.json"));
-const pepr_code_snippets_json_1 = __importDefault(require("./templates/pepr.code-snippets.json"));
-const tsconfig_module_json_1 = __importDefault(require("./templates/tsconfig.module.json"));
-const utils_1 = require("./utils");
-function genPkgJSON(opts, pgkVerOverride) {
-    // Generate a random UUID for the module based on the module name
-    const uuid = (0, uuid_1.v5)(opts.name, (0, uuid_1.v4)());
-    // Generate a name for the module based on the module name
-    const name = (0, utils_1.sanitizeName)(opts.name);
-    // Make typescript a dev dependency
-    const { typescript } = package_json_1.peerDependencies;
-    const { prettier } = package_json_1.devDependencies;
-    const data = {
-        name,
-        version: "0.0.1",
-        description: opts.description,
-        keywords: ["pepr", "k8s", "policy-engine", "pepr-module", "security"],
-        pepr: {
-            name: opts.name.trim(),
-            uuid: pgkVerOverride ? "static-test" : uuid,
-            onError: opts.errorBehavior,
-            alwaysIgnore: {
-                namespaces: [],
-                labels: [],
-            },
-        },
-        scripts: {
-            "k3d-setup": package_json_1.scripts["test:e2e:k3d"],
-            build: "pepr build",
-            deploy: "pepr deploy",
-            start: "pepr dev",
-        },
-        dependencies: {
-            pepr: pgkVerOverride || `${package_json_1.version}`,
-        },
-        devDependencies: {
-            prettier,
-            typescript,
-        },
-    };
-    return {
-        data,
-        path: "package.json",
-        print: (0, util_1.inspect)(data, false, 5, true),
-    };
-}
-exports.genPkgJSON = genPkgJSON;
-function genPeprTS() {
-    return {
-        path: "pepr.ts",
-        data: data_json_1.default.peprTS,
-    };
-}
-exports.genPeprTS = genPeprTS;
-exports.readme = {
-    path: "README.md",
-    data: data_json_1.default.readme,
-};
-exports.helloPeprTS = {
-    path: "hello-pepr.ts",
-    data: data_json_1.default.helloPeprTS,
-};
-exports.gitIgnore = {
-    path: ".gitignore",
-    data: data_json_1.default.gitignore,
-};
-exports.samplesYaml = {
-    path: "hello-pepr.samples.yaml",
-    data: hello_pepr_samples_json_1.default.map(r => (0, client_node_1.dumpYaml)(r, { noRefs: true })).join("---\n"),
-};
-exports.snippet = {
-    path: "pepr.code-snippets",
-    data: pepr_code_snippets_json_1.default,
-};
-exports.tsConfig = {
-    path: "tsconfig.json",
-    data: tsconfig_module_json_1.default,
-};
-exports.prettierRC = {
-    path: ".prettierrc",
-    data: _prettierrc_json_1.default,
-};

package/dist/src/cli/init/utils.js

@@ -1,56 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.write = exports.createDir = exports.sanitizeName = void 0;
-const fs_1 = require("fs");
-/**
- * Sanitize a user input name to be used as a pepr module directory name
- *
- * @param name the user input name
- * @returns the sanitized name
- */
-function sanitizeName(name) {
-    // Replace any characters outside of [^a-z0-9-] with "-"
-    let sanitized = name.toLowerCase().replace(/[^a-z0-9-]+/gi, "-");
-    // Remove any leading or trailing hyphens
-    sanitized = sanitized.replace(/^-+|-+$/g, "");
-    // Replace multiple hyphens with a single hyphen
-    sanitized = sanitized.replace(/--+/g, "-");
-    return sanitized;
-}
-exports.sanitizeName = sanitizeName;
-/**
- * Creates a directory and throws an error if it already exists
- *
- * @param dir - The directory to create
- */
-async function createDir(dir) {
-    try {
-        await fs_1.promises.mkdir(dir);
-    }
-    catch (err) {
-        // The directory already exists
-        if (err && err.code === "EEXIST") {
-            throw new Error(`Directory ${dir} already exists`);
-        }
-        else {
-            throw err;
-        }
-    }
-}
-exports.createDir = createDir;
-/**
- * Write data to a file on disk
- * @param path - The path to the file
- * @param data - The data to write
- * @returns A promise that resolves when the file has been written
- */
-function write(path, data) {
-    // If the data is not a string, stringify it
-    if (typeof data !== "string") {
-        data = JSON.stringify(data, null, 2);
-    }
-    return fs_1.promises.writeFile(path, data);
-}
-exports.write = write;

package/dist/src/cli/init/walkthrough.js

@@ -1,84 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.confirm = exports.walkthrough = void 0;
-const fs_1 = require("fs");
-const prompts_1 = __importDefault(require("prompts"));
-const types_1 = require("../../../src/lib/types");
-const templates_1 = require("./templates");
-const utils_1 = require("./utils");
-function walkthrough() {
-    const askName = {
-        type: "text",
-        name: "name",
-        message: "Enter a name for the new Pepr module. This will create a new directory based on the name.\n",
-        validate: async (val) => {
-            try {
-                const name = (0, utils_1.sanitizeName)(val);
-                await fs_1.promises.access(name, fs_1.promises.constants.F_OK);
-                return "A directory with this name already exists";
-            }
-            catch (e) {
-                return val.length > 2 || "The name must be at least 3 characters long";
-            }
-        },
-    };
-    const askDescription = {
-        type: "text",
-        name: "description",
-        message: "(Recommended) Enter a description for the new Pepr module.\n",
-    };
-    const askErrorBehavior = {
-        type: "select",
-        name: "errorBehavior",
-        validate: (val) => types_1.ErrorBehavior[val],
-        message: "How do you want Pepr to handle errors encountered during K8s operations?",
-        choices: [
-            {
-                title: "Ignore",
-                value: types_1.ErrorBehavior.ignore,
-                description: "Pepr will continue processing and generate an entry in the Pepr Controller log.",
-                selected: true,
-            },
-            {
-                title: "Log an audit event",
-                value: types_1.ErrorBehavior.audit,
-                description: "Pepr will continue processing and generate an entry in the Pepr Controller log as well as an audit event in the cluster.",
-            },
-            {
-                title: "Reject the operation",
-                value: types_1.ErrorBehavior.reject,
-                description: "Pepr will reject the operation and return an error to the client.",
-            },
-        ],
-    };
-    return (0, prompts_1.default)([askName, askDescription, askErrorBehavior]);
-}
-exports.walkthrough = walkthrough;
-async function confirm(dirName, packageJSON, peprTSPath) {
-    console.log(`
-  To be generated:
-
-    \x1b[1m${dirName}\x1b[0m
-    ├── \x1b[1m${templates_1.gitIgnore.path}\x1b[0m
-    ├── \x1b[1m${templates_1.prettierRC.path}\x1b[0m
-    ├── \x1b[1mcapabilties\x1b[0m
-    |   └── \x1b[1mhello-pepr.ts\x1b[0m     
-    ├── \x1b[1m${packageJSON.path}\x1b[0m
-${packageJSON.print.replace(/^/gm, "    │   ")}
-    ├── \x1b[1m${peprTSPath}\x1b[0m
-    ├── \x1b[1m${templates_1.readme.path}\x1b[0m
-    └── \x1b[1m${templates_1.tsConfig.path}\x1b[0m
-      `);
-    const confirm = await (0, prompts_1.default)({
-        type: "confirm",
-        name: "confirm",
-        message: "Create the new Pepr module?",
-    });
-    return confirm.confirm;
-}
-exports.confirm = confirm;

package/dist/src/cli/root.js

@@ -1,21 +0,0 @@
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RootCmd = void 0;
-const commander_1 = require("commander");
-const logger_1 = __importDefault(require("../../src/lib/logger"));
-class RootCmd extends commander_1.Command {
-    createCommand(name) {
-        const cmd = new commander_1.Command(name);
-        cmd.option("-l, --log-level [level]", "Log level: debug, info, warn, error", "info");
-        cmd.hook("preAction", run => {
-            logger_1.default.SetLogLevel(run.opts().logLevel);
-        });
-        return cmd;
-    }
-}
-exports.RootCmd = RootCmd;

package/dist/src/cli/run.js

@@ -1,58 +0,0 @@
-#!/usr/bin/env node
-"use strict";
-// SPDX-License-Identifier: Apache-2.0
-// SPDX-FileCopyrightText: 2023-Present The Pepr Authors
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const child_process_1 = require("child_process");
-const crypto_1 = __importDefault(require("crypto"));
-const fs_1 = __importDefault(require("fs"));
-const zlib_1 = require("zlib");
-const package_json_1 = require("../../package.json");
-const logger_1 = __importDefault(require("../lib/logger"));
-function validateHash(expectedHash) {
-    // Require the hash to be 64 characters long
-    if (!expectedHash || expectedHash.length !== 64) {
-        logger_1.default.error("Invalid hash");
-        process.exit(1);
-    }
-}
-function runModule(expectedHash) {
-    const gzPath = `/app/load/module-${expectedHash}.js.gz`;
-    const jsPath = `/app/module-${expectedHash}.js`;
-    // Set the log level
-    logger_1.default.SetLogLevel("debug");
-    // Check if the path is a valid file
-    if (!fs_1.default.existsSync(gzPath)) {
-        logger_1.default.error(`File not found: ${gzPath}`);
-        process.exit(1);
-    }
-    try {
-        logger_1.default.info(`Loading module ${gzPath}`);
-        // Extract the code from the file
-        const codeGZ = fs_1.default.readFileSync(gzPath);
-        const code = (0, zlib_1.gunzipSync)(codeGZ);
-        // Get the hash of the extracted code
-        const actualHash = crypto_1.default.createHash("sha256").update(code).digest("hex");
-        // If the hash doesn't match, exit
-        if (expectedHash !== actualHash) {
-            logger_1.default.error(`File hash does not match, expected ${expectedHash} but got ${actualHash}`);
-            process.exit(1);
-        }
-        logger_1.default.info(`File hash matches, running module`);
-        // Write the code to a file
-        fs_1.default.writeFileSync(jsPath, code);
-        // Run the module
-        (0, child_process_1.fork)(jsPath);
-    }
-    catch (e) {
-        logger_1.default.error(`Failed to decompress module: ${e}`);
-        process.exit(1);
-    }
-}
-logger_1.default.info(`Pepr Controller (v${package_json_1.version})`);
-const hash = process.argv[2];
-validateHash(hash);
-runModule(hash);