mirror of https://github.com/johndoe6345789/metabuilder.git synced 2026-04-25 06:14:59 +00:00

Files

johndoe6345789 6e2f0c08c0 feat(workflow): add packagerepo and string.sha256 plugins

Created 11 packagerepo-specific workflow plugins:
- auth_verify_jwt - JWT token verification
- auth_check_scopes - Scope-based authorization
- parse_path - URL path parameter extraction (Express-style)
- normalize_entity - Field normalization (trim, lower, unique, sort)
- validate_entity - JSON schema validation
- kv_get/kv_put - RocksDB key-value operations
- blob_put - Filesystem blob storage with SHA-256 hashing
- index_upsert - Index entry management
- respond_json/respond_error - Response formatting

Created string.sha256 plugin:
- Compute SHA256 hash of strings/bytes
- Optional "sha256:" prefix
- Used by packagerepo for content-addressed storage

All plugins follow standard pattern:
- Class extending NodeExecutor
- Factory with create() function
- package.json with metadata
- Access external state via runtime parameter

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

2026-01-22 15:14:59 +00:00

2.7 KiB

Raw Blame History

String SHA256 Plugin

Computes the SHA256 hash of input strings or bytes.

Plugin Information

Type: string.sha256
Category: string
Class: StringSha256
Version: 1.0.0

Description

This plugin computes the SHA256 cryptographic hash of the input data and returns it as a hexadecimal string. Optionally, the result can include a sha256: prefix for clarity.

Inputs

Parameter	Type	Required	Default	Description
`input`	`string \| bytes`	Yes	`""`	The data to hash
`prefix`	`boolean`	No	`false`	Whether to prepend "sha256:" to the result

Output

Field	Type	Description
`result`	`string`	The SHA256 hash as a hexadecimal string (optionally prefixed)

Examples

Basic Usage (String Input)

inputs = {
    "input": "hello world",
    "prefix": False
}

# Output:
{
    "result": "b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
}

With Prefix

inputs = {
    "input": "hello world",
    "prefix": True
}

# Output:
{
    "result": "sha256:b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
}

Bytes Input

inputs = {
    "input": b"hello world",
    "prefix": True
}

# Output:
{
    "result": "sha256:b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9"
}

Empty String

inputs = {
    "input": "",
    "prefix": False
}

# Output:
{
    "result": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"
}

Use Cases

Data Integrity: Verify file or message integrity
Checksums: Generate checksums for content validation
Content Addressing: Create content-based identifiers
Security: Hash passwords or sensitive data (note: use dedicated password hashing for production)
Deduplication: Identify duplicate content

Implementation Details

Uses Python's built-in hashlib.sha256() function
Automatically converts string inputs to UTF-8 bytes
Accepts both string and bytes inputs
Returns lowercase hexadecimal string
Hash length is always 64 characters (256 bits)

Testing

Run the test suite:

python3 test_direct.py

string.md5 - MD5 hash (less secure, faster)
string.sha1 - SHA1 hash (deprecated for security)
string.sha512 - SHA512 hash (more secure, slower)

Notes

SHA256 is part of the SHA-2 family of cryptographic hash functions
Produces a 256-bit (32-byte) hash value
Collision-resistant and suitable for security applications
For password hashing, consider dedicated algorithms like bcrypt or Argon2

2.7 KiB Raw Blame History