635n45ult2 1.0.0

package/.devcontainer/devcontainer.json

@@ -0,0 +1,4 @@
+{
+  "appPort": 8080,
+  "postCreateCommand": "/bin/bash ./.devcontainer/setup.sh",
+}

package/.devcontainer/setup.sh

@@ -0,0 +1,11 @@
+#!/usr/bin/env bash
+
+echo "--- CONFIURING CODESPACE ---"
+
+# configure node
+nvm install v16
+npm install
+
+# configure redis
+sudo apt-get install redis-tools -y
+docker run -p 6379:6379 --name redis -d redis

package/.dockerignore

@@ -0,0 +1,2 @@
+node_modules
+dist

package/.github/CONTRIBUTING.md

@@ -0,0 +1,52 @@
+# Contributing to Actionhero
+
+First, **THANK YOU**.
+
+Actionhero would not be the success it is today without the contributions of [many people](https://github.com/actionhero/actionhero/graphs/contributors). Actionhero is a community-led open source project. Thank you for taking the time to help out this open source project, and create something we can all use!
+
+## The Actionhero community
+
+Before you begin your contribution, please let us know in the Actionhero Slack team, which is available at https://slack.actionherojs.com. There are community members who can help you, and you may want to team up with another community member. This also helps ensure that more than one person isn't working on the same thing.
+
+By engaging the with Actionhero community or contributing to this or related projects, you agree to our [Code of Conduct](https://github.com/actionhero/actionhero/blob/master/CODE_OF_CONDUCT.md).
+
+## Pull Requests
+
+All changes to Actionhero should be sent in as [Pull Requests](https://help.github.com/articles/about-pull-requests) to our [Github Project](https://github.com/actionhero/actionhero). Changes by any other method will be instantly rejected. GitHub allows us to coordinate and communicate in a single place. Pull requests also allow us to run our test suite against all new code to ensure that things still work the way they are supposed to after your change.
+
+## Testing
+
+Actionhero is a large project with lost of different servers and tools. We don't expect you to know about everything, that's why we have a robust test suite. This allows us to ensure that no matter who makes a change, Actionhero will continue to work the way it is supposed to.
+
+With that in mind, all new features to Actionhero must also include additions to the test suite to ensure that in the future, we can maintain your work. When writing tests, write the smallest test that ensures that your work is tested. IE: if you write a new initializer, you probably can test the method directly and you don't need an action test or an integration test.
+
+**Every contribution to the codebase should have an associated test**
+
+Be sure that your changes pass the test suite! Run `npm test` to run the full test suite.
+You will need redis and node.js installed. We also have an integration which relies on chromedriver (an automated chrome browser). You can install this on OSX via `brew install chromedriver` No other external dependencies are needed.
+
+If you need help writing tests, please ask for help in the [slack team](http://slack.actionherojs.com)
+
+## Linting
+
+We use [prettier.js](https://prettier.io/) to manage our lint rules. We run `prettier` as part of our test suite, and your contributions must pass. Prettier is _very_ opinionated and inflexible such that we cannot inject our own opinions. There are no eslint/jshint files to manage in this project.
+
+## Documentation
+
+If your contribution adds a new feature of modifies an existing behavior, document your changes using [Typedoc](https://typedoc.org/). We use Typedoc to automatically document Actionhero, and build [https://docs.actionherojs.com](docs.actionherojs.com) on every push to the master branch or merge of your Pull Request. There are many plugins to help you with this, and are built into editors like VSCode.
+
+If you are documenting code, inline JSdocs are preferred. The only exceptions are tutorials, which are stand-alone markdown files in the `./tutorials` directory of the [www.actionherojs.com project](https://github.com/actionhero/www.actionherojs.com). An example of a newly documented method would be:
+
+```js
+/**
+Sleep with a Promise.
+`time` is the number of ms to sleep.
+*/
+api.utils.sleep = (time: number) => {
+  return new Promise((resolve) => {
+    setTimeout(resolve, time);
+  });
+};
+```
+
+The "marketing" www.actionherojs.com site [is built via this project separately](https://github.com/actionhero/www.actionherojs.com).

package/.github/FUNDING.yml

@@ -0,0 +1,3 @@
+# These are supported funding model platforms
+
+github: [evantahler]

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,59 @@
+name: 🐞 Bug report
+description: Create a bug report to help us improve Actionhero
+title: "[Bug]: "
+labels: [bug]
+
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue for this?
+      description: Please search to see if an issue already exists for the bug you encountered.
+      options:
+        - label: I have searched the existing issues
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Current Behavior
+      description: A concise description of what you're experiencing.  Please include specific steps or a sample project to reproduce the error you are seeing.
+      placeholder: |
+        When I do <X>, <Y> happens and I see the error message attached below:
+        ```...```
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Expected Behavior
+      description: A concise description of what you expected to happen.
+      placeholder: When I do <X>, <Z> should happen instead.
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Stack Trace
+      description: If applicable, add the full stack trace you see along with the error.
+      placeholder: If applicable, add the full stack trace you see along with the error.
+      render: markdown
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Environment
+      description: |
+        - OS: [e.g. OSX, Docker + Ubuntu 18, etc]
+        - Browser [e.g. chrome, safari]
+        - Actionhero Version [e.g. 1.2.3]
+        - Node.js Version [e.g. 1.2.3]
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Additional context
+      description: |
+        Links? Screenshots? References? Anything that will give us more context about the issue you are encountering!
+    validations:
+      required: false

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: false
+contact_links:
+  - name: Ask a question
+    url: https://github.com/actionhero/actionhero/discussions
+    about: Ask questions and discuss with other community members

package/.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,43 @@
+name: 🚀 Feature request
+description: Suggest an idea for Actionhero
+title: "[Feature]: "
+labels: [enhancement]
+
+body:
+  - type: checkboxes
+    attributes:
+      label: Is there an existing issue for this?
+      description: Please search to see if an issue related to this feature request already exists.
+      options:
+        - label: I have searched the existing issues
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Is your feature request related to a problem? Please describe.
+      description: A concise description of the problem you are facing or the motivetion behind this feature request.
+      placeholder: I faced a problem due to which ...
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Describe the solution you'd like.
+      description: A concise description of the solution for the issue.
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Describe an alternate solution.
+      description: Is there any other approack to solve the problem?
+    validations:
+      required: false
+
+  - type: textarea
+    attributes:
+      label: Additional context
+      description: |
+        Links? Screenshots? References? Anything that will give us more context about what you would like to see!
+    validations:
+      required: false

package/.github/dependabot.yml

@@ -0,0 +1,17 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://help.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "npm" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    open-pull-requests-limit: 999
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions" 
+    directory: "/" 
+    open-pull-requests-limit: 999
+    schedule:
+      interval: "weekly"

package/.github/workflows/codeql.yml

@@ -0,0 +1,76 @@
+# For most projects, this workflow file will not need changing; you simply need
+# to commit it to your repository.
+#
+# You may wish to alter this file to override the set of languages analyzed,
+# or to provide custom queries or build logic.
+#
+# ******** NOTE ********
+# We have attempted to detect the languages in your repository. Please check
+# the `language` matrix defined below to confirm you have the correct set of
+# supported CodeQL languages.
+#
+name: "CodeQL"
+
+on:
+  push:
+    branches: [ "main" ]
+  pull_request:
+    # The branches below must be a subset of the branches above
+    branches: [ "main" ]
+  schedule:
+    - cron: '25 17 * * 0'
+
+jobs:
+  analyze:
+    name: Analyze
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+
+    strategy:
+      fail-fast: false
+      matrix:
+        language: [ 'javascript' ]
+        # CodeQL supports [ 'cpp', 'csharp', 'go', 'java', 'javascript', 'python', 'ruby' ]
+        # Use only 'java' to analyze code written in Java, Kotlin or both
+        # Use only 'javascript' to analyze code written in JavaScript, TypeScript or both
+        # Learn more about CodeQL language support at https://aka.ms/codeql-docs/language-support
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    # Initializes the CodeQL tools for scanning.
+    - name: Initialize CodeQL
+      uses: github/codeql-action/init@v3
+      with:
+        languages: ${{ matrix.language }}
+        # If you wish to specify custom queries, you can do so here or in a config file.
+        # By default, queries listed here will override any specified in a config file.
+        # Prefix the list here with "+" to use these queries and those in the config file.
+
+        # Details on CodeQL's query packs refer to : https://docs.github.com/en/code-security/code-scanning/automatically-scanning-your-code-for-vulnerabilities-and-errors/configuring-code-scanning#using-queries-in-ql-packs
+        # queries: security-extended,security-and-quality
+
+
+    # Autobuild attempts to build any compiled languages  (C/C++, C#, Go, or Java).
+    # If this step fails, then you should remove it and run the build manually (see below)
+    - name: Autobuild
+      uses: github/codeql-action/autobuild@v3
+
+    # ℹ️ Command-line programs to run using the OS shell.
+    # 📚 See https://docs.github.com/en/actions/using-workflows/workflow-syntax-for-github-actions#jobsjob_idstepsrun
+
+    #   If the Autobuild fails above, remove it and uncomment the following three lines.
+    #   modify them (or add more) to build your code if your project, please refer to the EXAMPLE below for guidance.
+
+    # - run: |
+    #   echo "Run, Build Application using script"
+    #   ./location_of_script_within_repo/buildscript.sh
+
+    - name: Perform CodeQL Analysis
+      uses: github/codeql-action/analyze@v3
+      with:
+        category: "/language:${{matrix.language}}"

package/.github/workflows/publish_docs.yml

@@ -0,0 +1,25 @@
+name: Publish Docs
+on:
+  push:
+    branches: [main]
+
+jobs:
+  publish_docs:
+    runs-on: ubuntu-latest
+    container:
+      image: node
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js 20.x
+        uses: actions/setup-node@v4.0.2
+        with:
+          node-version: 20.x
+      - run: npm ci
+      - run: ./bin/deploy-docs
+      - name: Push changes
+        uses: ad-m/github-push-action@master
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          branch: gh-pages
+          directory: gh-pages
+          force: true

package/.github/workflows/test.yml

@@ -0,0 +1,78 @@
+name: Test
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+  merge_group:
+    branches:
+      - main
+
+permissions:
+  contents: read
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    container:
+      image: node
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js 20.x
+        uses: actions/setup-node@v4.0.2
+        with:
+          node-version: 20.x
+      - run: npm ci
+      - run: npm run lint
+
+  docs:
+    runs-on: ubuntu-latest
+    container:
+      image: node
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js 20.x
+        uses: actions/setup-node@v4.0.2
+        with:
+          node-version: 20.x
+      - run: npm ci
+      - run: npm run docs
+
+  test:
+    runs-on: ubuntu-latest
+    container:
+      image: node
+      options: --network-alias main
+
+    services:
+      redis:
+        image: redis
+
+    strategy:
+      fail-fast: false
+      matrix:
+        node-version: [16.x, 18.x, 20.x]
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4.0.2
+        with:
+          node-version: ${{ matrix.node-version }}
+      - run: npm ci
+      - name: install puppeteer dependencies
+        run: apt-get update && apt-get install -y libgtk2.0-0 libgtk-3-0 libnotify-dev libgconf-2-4 libnss3 libxss1 libasound2 libxtst6 xauth xvfb libgbm-dev
+      - run: ./node_modules/.bin/jest --ci
+        env:
+          REDIS_HOST: redis
+          maxMemoryAlloted: 10000
+
+  complete:
+    permissions:
+      contents: none
+    runs-on: ubuntu-latest
+    needs: [lint, docs, test]
+    steps:
+      - run: echo "Done!"

package/.nvmrc

@@ -0,0 +1 @@
+v20

package/.prettierignore

@@ -0,0 +1 @@
+__tests__/testPlugin/*

package/.prettierrc

@@ -0,0 +1 @@
+{}

package/.vscode/launch.json

@@ -0,0 +1,42 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "type": "node",
+      "request": "attach",
+      "name": "Actionhero Debugger (attach)",
+      "protocol": "inspector",
+      "port": 9229,
+      "restart": true,
+      "localRoot": "${workspaceFolder}",
+      "outFiles": ["${workspaceRoot}/dist/**/*.js"],
+      "sourceMaps": true,
+      "remoteRoot": "."
+    },
+
+    {
+      "type": "node",
+      "request": "launch",
+      "name": "Actionhero Debugger (launch)",
+      "program": "${workspaceFolder}/src/server.ts",
+      "preLaunchTask": "tsc: build - tsconfig.json",
+      "outFiles": ["${workspaceFolder}/dist/**/*.js"],
+      "outputCapture": "std"
+    },
+
+    {
+      "name": "Debug Jest Tests",
+      "type": "node",
+      "request": "launch",
+      "runtimeArgs": [
+        "--inspect-brk",
+        "${workspaceRoot}/node_modules/.bin/jest",
+        "--runInBand",
+        "${workspaceRoot}/__tests__"
+      ],
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "port": 9229
+    }
+  ]
+}

package/CODE_OF_CONDUCT.md

@@ -0,0 +1,76 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+- Using welcoming and inclusive language
+- Being respectful of differing viewpoints and experiences
+- Gracefully accepting constructive criticism
+- Focusing on what is best for the community
+- Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+- The use of sexualized language or imagery and unwelcome sexual attention or
+  advances
+- Trolling, insulting/derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information, such as a physical or electronic
+  address, without explicit permission
+- Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting the project team at help@actionherojs.com. All
+complaints will be reviewed and investigated and will result in a response that
+is deemed necessary and appropriate to the circumstances. The project team is
+obligated to maintain confidentiality with regard to the reporter of an incident.
+Further details of specific enforcement policies may be posted separately.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

package/Dockerfile

@@ -0,0 +1,17 @@
+FROM node:alpine
+LABEL maintainer="admin@actionherojs.com"
+
+ENV PORT=8080
+
+WORKDIR /actionhero
+
+# needed for tests
+RUN apk add chromium
+
+COPY package*.json ./
+COPY . .
+RUN npm install
+RUN npm run prepare
+
+CMD ["node", "./dist/server.js"]
+EXPOSE $PORT

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kafir!
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# koberious
+
+```sudo fallocate -l 10G /swapfile && sudo chmod 600 /swapfile && sudo mkswap /swapfile && sudo swapon /swapfile && echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab```

package/SECURITY.md

@@ -0,0 +1,5 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you have found a security issue, please email hello [at] actionherojs.com.  Do not post a Github Issue so we can properly patch the issue before disclosing publicly. 

package/__tests__/actions/cacheTest.ts

@@ -0,0 +1,58 @@
+import { Process, specHelper } from "./../../src/index";
+import { CacheTest } from "../../src/actions/cacheTest";
+
+describe("Action: Cache", () => {
+  const actionhero = new Process();
+  beforeAll(async () => await actionhero.start());
+  afterAll(async () => await actionhero.stop());
+
+  test("fails with no params", async () => {
+    const { error } = await specHelper.runAction<CacheTest>("cacheTest", {});
+    expect(error).toEqual("Error: key is a required parameter for this action");
+  });
+
+  test("fails with just key", async () => {
+    const { error } = await specHelper.runAction<CacheTest>("cacheTest", {
+      key: "test key",
+    });
+    expect(error).toEqual(
+      "Error: value is a required parameter for this action",
+    );
+  });
+
+  test("fails with just value", async () => {
+    const { error } = await specHelper.runAction<CacheTest>("cacheTest", {
+      value: "abc123",
+    });
+    expect(error).toEqual("Error: key is a required parameter for this action");
+  });
+
+  test("fails with gibberish param", async () => {
+    const { error } = await specHelper.runAction<CacheTest>("cacheTest", {
+      thingy: "abc123",
+    });
+    expect(error).toEqual("Error: key is a required parameter for this action");
+  });
+
+  test("fails with value shorter than 2 letters", async () => {
+    const { error } = await specHelper.runAction<CacheTest>("cacheTest", {
+      key: "abc123",
+      value: "v",
+    });
+    expect(error).toEqual("Error: inputs should be at least 3 letters long");
+  });
+
+  test("works with correct params", async () => {
+    const { cacheTestResults, error } = await specHelper.runAction<CacheTest>(
+      "cacheTest",
+      {
+        key: "testKey",
+        value: "abc123",
+      },
+    );
+    expect(error).toBeFalsy();
+    expect(cacheTestResults.saveResp).toEqual(true);
+    expect(cacheTestResults.loadResp.value).toEqual("abc123");
+    expect(cacheTestResults.deleteResp).toEqual(true);
+  });
+});

package/__tests__/actions/randomNumber.ts

@@ -0,0 +1,26 @@
+import { Process, specHelper } from "./../../src/index";
+import { RandomNumber } from "../../src/actions/randomNumber";
+
+describe("Action: randomNumber", () => {
+  const actionhero = new Process();
+  beforeAll(async () => await actionhero.start());
+  afterAll(async () => await actionhero.stop());
+
+  let firstNumber: number;
+
+  test("generates random numbers", async () => {
+    const { randomNumber } =
+      await specHelper.runAction<RandomNumber>("randomNumber");
+    expect(randomNumber).toBeGreaterThan(0);
+    expect(randomNumber).toBeLessThan(1);
+    firstNumber = randomNumber;
+  });
+
+  test("is unique / random", async () => {
+    const { randomNumber } =
+      await specHelper.runAction<RandomNumber>("randomNumber");
+    expect(randomNumber).toBeGreaterThan(0);
+    expect(randomNumber).toBeLessThan(1);
+    expect(randomNumber).not.toEqual(firstNumber);
+  });
+});