hash224

modules/septima-lang/README.md

@@ -324,6 +324,35 @@ Array.isArray('not array') // Returns false
 Array.isArray({ key: 'val' }) // Returns false
 ```
 
+# Septima: An Overview
+
+[Previous sections remain unchanged...]
+
+### Built-in Methods
+
+[Previous built-in methods content remains unchanged...]
+
+#### Cryptographic Hashing
+
+Septima provides a secure hashing function through the `crypto.hash224()` method, which computes SHA-224 hashes of any value. The method takes a single argument of any type and returns a hexadecimal string representing the hash.
+
+```javascript
+// Hash a simple string
+crypto.hash224('hello') // Returns a 56-character hex string
+
+// Hash numbers
+crypto.hash224(42) // Hashes the number 42
+
+// Hash complex objects
+crypto.hash224({ name: 'Alice', roles: ['admin', 'user'], settings: { theme: 'dark' } }) // Hashes the entire object structure
+
+// Hashes are deterministic but unique per input
+crypto.hash224('A') === crypto.hash224('A') // true (same input = same hash)
+crypto.hash224('A') !== crypto.hash224('B') // true (different input = different hash)
+```
+
+Note: Septima's `crypto` object is not intended to be compatible with Node.js's `crypto` module. It provides its own simplified cryptographic utilities specifically designed for Septima's use cases.
+
 ### Console Output for Debugging
 
 Like JavaScript, Septima provides `console.log()` for debugging and monitoring your code. However, unlike JavaScript's `console.log()` which can take multiple arguments, Septima's version accepts only a single argument. In keeping with Septima's functional nature, `console.log()` returns its argument, making it useful within expressions.

modules/septima-lang/tests/septima.spec.ts

@@ -1015,7 +1015,7 @@ describe('septima', () => {
       expect(run(`JSON.parse(5000)`)).toEqual(5000)
     })
   })
-  describe('hash', () => {
+  describe('hash224', () => {
     const hashOf = (u: unknown) => crypto.createHash('sha224').update(JSON.stringify(u)).digest('hex')
     test('can compute hash values of strings', () => {
       expect(run(`crypto.hash224('A')`)).toEqual(hashOf('A'))