blokctl 1.2.0 → 1.4.0

package/dist/scaffold-repo/triggers/grpc/vitest.config.ts

@@ -0,0 +1,29 @@
+import path from "node:path";
+import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+	test: {
+		globals: true,
+		environment: "node",
+		coverage: {
+			provider: "istanbul",
+			reporter: ["text", "json", "html", "lcov"],
+			exclude: ["node_modules/", "dist/", "**/*.d.ts", "**/*.config.ts", "__tests__/", "src/gen/", "src/types/"],
+			thresholds: {
+				lines: 86,
+				functions: 90,
+				branches: 70,
+				statements: 86,
+			},
+		},
+		include: ["__tests__/**/*.test.ts", "src/**/*.test.ts"],
+		exclude: ["node_modules", "dist"],
+		testTimeout: 10000,
+		hookTimeout: 10000,
+	},
+	resolve: {
+		alias: {
+			"@": path.resolve(__dirname, "./src"),
+		},
+	},
+});

package/dist/scaffold-repo/triggers/grpc/workflows/countries.json

@@ -0,0 +1,27 @@
+{
+	"name": "countries.listGrpc",
+	"description": "Workflow description",
+	"version": "1.0.0",
+	"trigger": {
+		"http": {
+			"method": "GET",
+			"path": "/",
+			"accept": "application/json"
+		}
+	},
+	"steps": [
+		{
+			"id": "get-countries-api",
+			"use": "@blokjs/api-call",
+			"type": "module",
+			"inputs": {
+				"url": "https://countriesnow.space/api/v0.1/countries/capital",
+				"method": "GET",
+				"headers": {
+					"Content-Type": "application/json"
+				},
+				"responseType": "application/json"
+			}
+		}
+	]
+}

package/dist/scaffold-repo/triggers/http/.dockerignore

@@ -0,0 +1,23 @@
+node_modules
+Dockerfile*
+docker-compose*
+.dockerignore
+.git
+.gitignore
+README.md
+LICENSE
+.vscode
+Makefile
+helm-charts
+.env
+.editorconfig
+.idea
+coverage*
+runtimes
+.DS_Store
+*.log
+.blokctl/runtimes/python3/python3_runtime
+.blokctl/runtimes/python3/tests
+.blokctl/runtimes/python3/Makefile
+.blokctl/runtimes/python3/nodemon.json
+.blokctl/runtimes/python3/node_modules

package/dist/scaffold-repo/triggers/http/.env.example

@@ -0,0 +1,8 @@
+PROJECT_NAME=trigger-http-server
+PROJECT_VERSION=0.0.1
+PORT=4000
+WORKFLOWS_PATH=PROJECT_PATH/workflows
+NODES_PATH=PROJECT_PATH/src/nodes
+CONSOLE_LOG_ACTIVE=true
+APP_NAME=blok-http
+DISABLE_TRIGGER_RUN=false # Set to true to disable trigger run and use this project as a module

package/dist/scaffold-repo/triggers/http/CHANGELOG.md

@@ -0,0 +1,326 @@
+# @blokjs/trigger-http
+
+## 0.1.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/shared@0.2.0
+  - @blokjs/helper@0.2.0
+  - @blokjs/runner@0.2.0
+  - @blokjs/api-call@0.2.0
+  - @blokjs/if-else@0.2.0
+
+## 0.0.34
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.26
+  - @blokjs/if-else@0.0.30
+  - @blokjs/api-call@0.1.29
+
+## 0.0.33
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.25
+  - @blokjs/if-else@0.0.29
+  - @blokjs/api-call@0.1.28
+
+## 0.0.32
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.24
+  - @blokjs/if-else@0.0.28
+  - @blokjs/api-call@0.1.27
+
+## 0.0.31
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.23
+  - @blokjs/if-else@0.0.27
+  - @blokjs/api-call@0.1.26
+
+## 0.0.30
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.22
+  - @blokjs/if-else@0.0.26
+  - @blokjs/api-call@0.1.25
+
+## 0.0.29
+
+### Patch Changes
+
+- fixed dockerfile
+
+## 0.0.28
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.21
+  - @blokjs/if-else@0.0.25
+  - @blokjs/api-call@0.1.24
+
+## 0.0.27
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/helper@0.1.5
+  - @blokjs/runner@0.1.20
+  - @blokjs/if-else@0.0.24
+  - @blokjs/api-call@0.1.23
+
+## 0.0.26
+
+### Patch Changes
+
+- Python3 runtime implemented in the runner
+- Updated dependencies
+  - @blokjs/runner@0.1.19
+  - @blokjs/shared@0.0.9
+  - @blokjs/if-else@0.0.23
+  - @blokjs/api-call@0.1.22
+
+## 0.0.25
+
+### Patch Changes
+
+- Added examples and create project' command to include examples and 'create node' command with options for type ('module' or 'class') and template ('class' or 'ui')
+- Updated dependencies
+  - @blokjs/if-else@0.0.22
+  - @blokjs/api-call@0.1.21
+  - @blokjs/runner@0.1.18
+  - @blokjs/shared@0.0.8
+
+## 0.0.24
+
+### Patch Changes
+
+- Successfully implemented all the enhancements and improvements identified during our internal hackathon.
+
+## 0.0.23
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.17
+  - @blokjs/if-else@0.0.21
+  - @blokjs/api-call@0.1.20
+
+## 0.0.22
+
+### Patch Changes
+
+- Added support for YAML, XML and TOML in the workflow file. Upgraded package version recommended by Dependabot.
+- Updated dependencies
+  - @blokjs/if-else@0.0.20
+  - @blokjs/api-call@0.1.19
+  - @blokjs/helper@0.1.4
+  - @blokjs/runner@0.1.16
+  - @blokjs/shared@0.0.7
+
+## 0.0.21
+
+### Patch Changes
+
+- Improved the BlokService base class to accept a InputType. This force developer to always create a type to define the Node handle input. Added unit test for pending projects like if-else and api-call.
+- Updated dependencies
+  - @blokjs/if-else@0.0.19
+  - @blokjs/api-call@0.1.18
+  - @blokjs/runner@0.1.15
+
+## 0.0.20
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/api-call@0.1.17
+  - @blokjs/shared@0.0.6
+  - @blokjs/runner@0.1.14
+  - @blokjs/if-else@0.0.18
+  - @blokjs/react@0.0.4
+
+## 0.0.19
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/react@0.0.3
+
+## 0.0.18
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/react@0.0.2
+
+## 0.0.17
+
+### Patch Changes
+
+- Implemented a react node and the chatbot demo page
+- Updated dependencies
+  - @blokjs/api-call@0.1.16
+  - @blokjs/runner@0.1.13
+  - @blokjs/shared@0.0.5
+  - @blokjs/react@0.0.1
+  - @blokjs/if-else@0.0.17
+
+## 0.0.16
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.12
+  - @blokjs/shared@0.0.4
+  - @blokjs/if-else@0.0.16
+  - @blokjs/api-call@0.1.15
+
+## 0.0.15
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.11
+  - @blokjs/if-else@0.0.15
+  - @blokjs/api-call@0.1.14
+
+## 0.0.14
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.10
+  - @blokjs/if-else@0.0.14
+  - @blokjs/api-call@0.1.13
+
+## 0.0.13
+
+### Patch Changes
+
+- Improved and extended the open telemetry feature
+- Updated dependencies
+  - @blokjs/if-else@0.0.13
+  - @blokjs/api-call@0.1.12
+  - @blokjs/runner@0.1.9
+  - @blokjs/shared@0.0.3
+
+## 0.0.12
+
+### Patch Changes
+
+- Fixed open telemetry issues and types
+- Updated dependencies
+  - @blokjs/if-else@0.0.12
+  - @blokjs/api-call@0.1.11
+  - @blokjs/runner@0.1.8
+  - @blokjs/shared@0.0.2
+
+## 0.0.11
+
+### Patch Changes
+
+- Fixed issue with the cli node creation test
+- Updated dependencies
+  - @blokjs/if-else@0.0.11
+  - @blokjs/api-call@0.1.10
+  - @blokjs/runner@0.1.7
+  - @blokjs/shared@0.0.1
+
+## 0.0.10
+
+### Patch Changes
+
+- Migrated and refactored shared library
+- Updated dependencies
+  - @blokjs/if-else@0.0.10
+  - @blokjs/api-call@0.1.9
+  - @blokjs/runner@0.1.6
+
+## 0.0.9
+
+### Patch Changes
+
+- e5225d2: Implemented open telemetry and prometheus metrics
+- Updated dependencies [e5225d2]
+  - @blokjs/runner@0.1.5
+  - @blokjs/if-else@0.0.9
+  - @blokjs/api-call@0.1.8
+
+## 0.0.8
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/if-else@0.0.8
+  - @blokjs/api-call@0.1.7
+
+## 0.0.7
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/if-else@0.0.7
+  - @blokjs/api-call@0.1.6
+
+## 0.0.6
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/api-call@0.1.5
+
+## 0.0.5
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/helper@0.1.3
+  - @blokjs/runner@0.1.4
+  - @blokjs/api-call@0.1.4
+
+## 0.0.4
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/helper@0.1.2
+  - @blokjs/runner@0.1.3
+  - @blokjs/api-call@0.1.3
+
+## 0.0.3
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/helper@0.1.1
+  - @blokjs/runner@0.1.2
+  - @blokjs/api-call@0.1.2
+
+## 0.0.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/runner@0.1.1
+  - @blokjs/api-call@0.1.1
+
+## 0.0.1
+
+### Patch Changes
+
+- Updated dependencies
+  - @blokjs/api-call@0.1.0
+  - @blokjs/helper@0.1.0
+  - @blokjs/runner@0.1.0

package/dist/scaffold-repo/triggers/http/Dockerfile

@@ -0,0 +1,49 @@
+# use the official Bun image
+# see all versions at https://hub.docker.com/r/oven/bun/tags
+FROM oven/bun:1 AS base
+WORKDIR /usr/src/app
+
+# install dependencies into temp directory
+# this will cache them and speed up future builds
+FROM base AS install
+RUN mkdir -p /temp/dev
+COPY package.json /temp/dev/
+RUN cd /temp/dev && bun install --frozen-lockfile
+
+# install with --production (exclude devDependencies)
+RUN mkdir -p /temp/prod
+COPY package.json /temp/prod/
+RUN cd /temp/prod && bun install --frozen-lockfile --production
+
+# copy node_modules from temp directory
+# then copy all (non-ignored) project files into the image
+FROM base AS prerelease
+COPY --from=install /temp/dev/node_modules node_modules
+COPY . .
+
+# [optional] tests & build
+ENV NODE_ENV=production
+# RUN bun add -d @types/ejs
+RUN bun run build
+
+# copy production dependencies and source code into final image
+FROM oven/bun:1-slim AS release
+WORKDIR /usr/src/app
+
+COPY --from=install /temp/prod/node_modules node_modules
+COPY --from=prerelease /usr/src/app/dist dist
+COPY --from=prerelease /usr/src/app/package.json .
+COPY --from=prerelease /usr/src/app/workflows workflows
+COPY --from=prerelease /usr/src/app/public public
+
+ENV WORKFLOWS_PATH=/usr/src/app/workflows
+ENV CONSOLE_LOG_ACTIVE=true
+ENV NODE_ENV=production
+ENV APP_NAME=blok-http
+
+# run the app
+USER bun
+EXPOSE 4000/tcp
+EXPOSE 9091/tcp
+
+ENTRYPOINT [ "bun", "run", "dist/index.js" ]

package/dist/scaffold-repo/triggers/http/Dockerfile.dev

@@ -0,0 +1,34 @@
+# Stage 1: Use Bun to install dependencies
+FROM oven/bun:1.1.4-alpine AS deps
+WORKDIR /app
+
+COPY package.json *bun.lockb ./
+RUN bun install --production
+
+# Stage 2: Use Node.js to run the app
+FROM node:23-alpine AS runner
+WORKDIR /usr/src/app
+
+# Copy installed node_modules from previous stage
+COPY --from=deps /app/node_modules ./node_modules
+
+COPY *dist ./dist
+COPY workflows ./workflows
+COPY public ./public
+COPY package.json package.json
+COPY tsconfig.json tsconfig.json
+
+ENV NODE_ENV=production
+ENV PROJECT_NAME=trigger-http-server
+ENV PROJECT_VERSION=0.0.1
+ENV APP_NAME=blok-http
+ENV PORT=4000
+ENV WORKFLOWS_PATH=/usr/src/app/workflows
+ENV NODES_PATH=/usr/src/app/src/nodes
+ENV DISABLE_TRIGGER_RUN=false
+
+# Expose app ports
+EXPOSE 4000 9091
+
+# Wait for dist/index.js to be compiled before running
+CMD ["sh", "-c", "while [ ! -f dist/index.js ]; do echo -n '.'; sleep 1; done && echo && node dist/index.js"]

package/dist/scaffold-repo/triggers/http/infra/docker-compose.yml

@@ -0,0 +1,38 @@
+services:
+  blok-http:
+    container_name: blok-http
+    hostname: blok-http
+    build:
+      context: ../
+      dockerfile: Dockerfile.dev
+    ports:
+      - "4000:4000"
+      - "9091:9091"
+    develop:
+      watch:
+        - action: sync
+          path: ../dist
+          target: /usr/src/app/dist
+        - action: sync
+          path: ../workflows
+          target: /usr/src/app/workflows
+        - action: sync
+          path: ../public
+          target: /usr/src/app/public
+        - action: rebuild
+          path: ../package.json
+        - action: rebuild
+          path: ../tsconfig.json
+        - action: rebuild
+          path: ../.env.local
+    networks:
+      - shared-network
+    # logging: # Log to Loki. Enable this to see logs in Grafana.
+    #   driver: loki
+    #   options:
+    #     loki-url: "http://localhost:3100/loki/api/v1/push"
+    #     loki-retries: 5
+    #     loki-batch-size: 400
+networks:
+  shared-network:
+    external: true

package/dist/scaffold-repo/triggers/http/notes/CLI_Commands/Authentication.md

@@ -0,0 +1,74 @@
+# NanoCTL Login Command
+
+## Table of Contents
+
+1. [Authentication Methods](#authentication-methods)  
+    - [Environment Variable](#1-environment-variable)  
+    - [Token Flag](#2-token-flag)  
+    - [Interactive Prompt](#3-interactive-prompt)  
+2. [How to Logout](#how-to-logout)  
+
+## Authentication Methods
+
+### 1. Environment Variable
+   - **Best for**: Automated environments, CI/CD pipelines
+
+        **Usage**:
+        ```bash
+        export BLOKS_TOKEN="your_api_token_here"
+        npx blokctl@latest login
+        ```
+
+        **Behavior**:
+        - Automatically detects `BLOKS_TOKEN` from the environment.
+        - Non-interactive - runs silently.
+        - Returns exit code `0` on success, non-zero on failure.
+        - Token is not stored locally (uses the environment variable each time).
+        
+### 2. Token Flag
+   - **Best for**: Temporary sessions, quick testing
+
+        **Usage**:
+        ```bash
+        npx blokctl@latest login --token "your_api_token_here"
+        npx blokctl@latest login -t "your_api_token_here"
+        ```
+
+        **Behavior**:
+        - Immediately authenticates with the provided token.
+        - Token is not saved to disk.
+        - Shows authentication result message.
+        - Recommended to wrap the token in quotes to prevent shell history logging.
+
+### 3. Interactive Prompt
+  - **Best for**: First-time setup, most secure local use
+    **Usage**:
+    ```bash
+    npx blokctl@latest login
+    ```
+
+    **Interactive Flow**:
+    - **Command launches prompt**:
+    ```bash
+    ◆ Please provide the token for authentication. You can create it on https://atomic.deskree.com/auth/access/token █
+    ```
+    Input is masked while typing.
+    - **Token is validated immediately**:
+        - **On success**:
+            - Token is encrypted and stored.
+            - Displays welcome message with username and expiration date.
+        - **On failure**:
+            - Shows specific error (e.g., invalid token, network issue).
+
+
+## How to logout
+
+```bash
+npx blokctl@latest logout
+```
+
+Removes the authentication token from the local machine.
+
+This function is used to delete the stored token, ensuring that 
+the user is logged out or the token is no longer accessible 
+from the current environment.

package/dist/scaffold-repo/triggers/http/notes/CLI_Commands/Building.md

@@ -0,0 +1,52 @@
+# BlokService CLI Commands: Build
+
+## Table of Contents
+- [Build Blok ](#build-blok)
+  - [Syntax](#build-syntax)
+  - [Options](#build-options)
+  - [Examples](#build-examples)
+- [Deploy Blok ](#deploy-blok)
+  - [Syntax](#deploy-syntax)
+  - [Options](#deploy-options)
+  - [Examples](#deploy-examples)
+- [Common Examples](#common-examples)
+- [Troubleshooting](#troubleshooting)
+
+---
+
+## Build Blok 
+
+### Syntax
+```bash
+npx blokctl build [options]
+```
+  Compiles and packages a blok from source code into a deployable artifact.
+ 
+  ### Options
+  | Option       | Alias | Type    | Description                | Default            |
+  |--------------|-------|---------|----------------------------|--------------------|
+  | `--directory`| `-d`  | string  | Source directory path      | `./blok` |
+  | `--help`     | `-h`  | boolean | Show help                  | `false`            |
+ 
+  ### Commands
+  | Command | Description               |
+  |---------|---------------------------|
+  | `.`     | Build in current directory|
+ 
+  ### Examples
+  #### Build in default directory:
+  ``` bash
+  npx blokctl build
+  ```
+  #### Build in specific directory:
+  ```bash
+  npx blokctl build -d ./my-blok
+  ```
+
+  #### Build in current directory:
+  ```bash
+  npx blokctl build .
+  ```
+
+---
+> **Note**: After executing the building command, you can proceed to deploy the blok using the [deploy](./Deployment.md) command.