fenrir-runtime 0.0.1 → 0.3.0

package/Makefile

@@ -1,16 +1,10 @@
-.PHONY: install build all
+.PHONY: build link clean
 
-all: install build
-
-install:
-	@echo "Running npm install..."
+build:
 	npm install
 
-build:
-	@echo "Running npm run build..."
-	npm run build
-	@echo "Finish."
+link: build
+	npm link
 
 clean:
-	@echo "Cleaning up node_modules and build files..."
-	rm -rf node_modules build dist
+	rm -rf node_modules

package/README.md

@@ -1,89 +1,155 @@
-# Fenrir Runtime
+<div align="center">
 
+# Fenrir
 
+**A Lightweight Runtime**
 
-**Fenrir** is a modern JavaScript runtime environment based on TypeScript.
-It provides developers with a fast, secure, and flexible working environment. Thanks to TypeScript support, it offers powerful type safety and a modern development experience. Fenrir is distributed as open source and is open to community contributions.
+[![npm](https://img.shields.io/npm/v/fenrir-runtime?style=flat-square&color=000&labelColor=000)](https://www.npmjs.com/package/fenrir-runtime)
 
----
-
-### Features
+<br/>
 
-- **TypeScript Compatibility:** Compatible with all TypeScript functions, making your projects more secure and sustainable.
+🌐 &nbsp;[Türkçe](/READMEs/turkish.md)
 
-- **Rollback System:** Reduces the risk of errors by allowing you to undo changes.
+</div>
 
-- **Modern Framework Support:** Works seamlessly with popular libraries such as Express, Koa, and Fastify.
+---
 
-- **Open Source and Community-Focused:** You can review, modify, and contribute to the project.
+<br/>
 
----
+Fenrir is a minimal scripting runtime that runs `.fnr` files using a clean, expressive syntax on top of Node.js. It ships with a built-in standard library, package management, and a snapshot/rollback archive system.
 
-### Installation
+<br/>
 
-Installing Fenrir is very easy. You can run the project by following the steps below:
+## Features
 
-1. Clone the repository.
 ```
-git clone https://github.com/yigitkabak/Fenrir
+  Clean syntax      fn, use, log — no verbose JS boilerplate
+  Built-in stdlib   File I/O, HTTP, math, arrays — globally available, no imports
+  Package manager   Install and remove npm packages via fenrir install
+  Archive system    Snapshot your project and roll back at any time
 ```
 
-2. Enter the Project Directory.
-```
-cd Fenrir
-```
+<br/>
 
-3. Install and Compile Dependencies.
+## Installation
+
+**Via npm**
+
+```bash
+npm install -g fenrir-runtime
 ```
-make
+
+**Via GitHub**
+
+```bash
+git clone https://github.com/yourusername/fenrir.git
+cd fenrir
+npm install
+npm link
 ```
 
-Or if you use Linux, you can download our application. [App](/App)
+<br/>
 
-Once the installation is complete, **Fenrir** is ready to use in your projects.
+## Usage
 
----
+```bash
+fenrir main.fnr              # Run a file
+fenrir install <pkg>         # Install a package
+fenrir remove  <pkg>         # Remove a package
+fenrir archive "message"     # Save a snapshot
+fenrir archives              # List snapshots
+fenrir rollback              # Restore latest snapshot
+fenrir rollback <id>         # Restore specific snapshot
+fenrir clean   <n>           # Keep last n snapshots
+fenrir help                  # Show help
+```
 
-### Example Usage
+<br/>
 
-Creating a simple Express server with **Fenrir** is quite easy:
+## Syntax
 
-```
-declare express from 'express'
+`.fnr` files are mostly JavaScript with a cleaner surface:
+
+```js
+use express from 'express'
 
 const app = express()
-const port = 3000
+const PORT = env('PORT', '3000')
 
-fn handle_home_request(req, res) {
-  res.send('Hello from Fenrir Express!')
+fn greet(name) {
+  log(`Hello, ${name}!`)
 }
 
-app.get('/', handle_home_request)
+app.get('/', fn(req, res) {
+  res.json({ message: 'Hello from Fenrir' })
+})
 
-fn start_server() {
-  app.listen(port, () => {
-    log(`Server running at http://localhost:${port}`)
-  })
-}
+app.listen(PORT, fn() {
+  log(`🐺 Server running on http://localhost:${PORT}`)
+})
+```
 
-start_server()
+| Fenrir | JavaScript |
+|--------|------------|
+| `fn name() {}` | `function name() {}` |
+| `fn(args) {}` | `function(args) {}` |
+| `use X from 'mod'` | `import X from 'mod'` |
+| `log()` | `console.log()` |
+| `err()` | `console.error()` |
+| `warn()` | `console.warn()` |
+| `info()` | `console.info()` |
+
+<br/>
+
+## Standard Library
+
+All functions are globally available — no imports needed.
+
+| Category | Functions |
+|----------|-----------|
+| **I/O** | `readFile` `writeFile` `appendFile` `fileExists` `readDir` `readJSON` `writeJSON` `mkdir` `rm` |
+| **HTTP** | `get` `post` |
+| **System** | `exec` `run` `spawn` `env` `args` `exit` `cwd` |
+| **Time** | `now` `time` `sleep` `bench` |
+| **Array** | `range` `pick` `shuffle` `chunk` `unique` `flatten` `sum` `avg` `min` `max` `clamp` |
+| **String** | `capitalize` `truncate` `pad` `repeat` |
+| **Object** | `keys` `values` `entries` `merge` `clone` |
+| **Async** | `all` `race` `retry` |
+| **Types** | `isString` `isNumber` `isBool` `isArray` `isObject` `isNull` `isDefined` |
+| **Math** | `rand` `randInt` `abs` `ceil` `floor` `round` `sqrt` `pow` `PI` `E` |
+
+<br/>
+
+## Archive System
+
+```bash
+fenrir archive "before refactor"       # Save snapshot
+fenrir archives                        # List all snapshots
+fenrir rollback                        # Restore latest
+fenrir rollback 2024-01-15_14-30-00    # Restore specific
+fenrir clean 10                        # Keep last 10, delete rest
 ```
 
-With this example, you can see the message **"Hello from Fenrir Express!"** by going to http://localhost:3000 in your browser.
+<br/>
 
----
-### Contributing
+## Debug Mode
 
-- **Fenrir** is a community-driven project. To contribute:
+```bash
+FENRIR_DEBUG=1 fenrir main.fnr
+```
 
-1. **Use the project and provide feedback:** Report bugs or suggestions.
+Prints the transformed JavaScript before execution.
 
-2. **Contribute code:** Add new features or improve existing code.
+<br/>
 
----
+## Requirements
 
-NOTE: ⚠️ **Fenrir** is currently in BETA. You may encounter unexpected errors. Your feedback will greatly contribute to the development of the project.
+- Node.js **v18** or higher
+
+<br/>
 
 ---
-## Licence
-**Fenrir** is licensed under the [GPL](LICENSE) Licence.
+
+<div align="center">
+<sub>BSD-3-Clause License</sub>
+</div>

package/READMEs/turkish.md

@@ -0,0 +1,156 @@
+<div align="center">
+
+# Fenrir
+
+**Hafif bir Runtime**
+
+[![npm](https://img.shields.io/npm/v/fenrir-runtime?style=flat-square&color=000&labelColor=000)](https://www.npmjs.com/package/fenrir-runtime)
+
+
+<br/>
+
+🌐 &nbsp;[English](README.md)
+
+</div>
+
+---
+
+<br/>
+
+Fenrir, `.fnr` uzantılı dosyaları Node.js üzerinde temiz ve ifade edici bir söz dizimiyle çalıştıran minimal bir scripting runtime'ıdır. Dahili standart kütüphane, paket yönetimi ve anlık görüntü/geri alma arşiv sistemiyle birlikte gelir.
+
+<br/>
+
+## Özellikler
+
+```
+  Temiz söz dizimi   fn, use, log — uzun JS kalıpları yok
+  Dahili stdlib      Dosya I/O, HTTP, matematik — import olmadan global erişim
+  Paket yönetimi     fenrir install ile npm paket kur/kaldır
+  Arşiv sistemi      Anlık görüntü al, istediğin zaman geri dön
+```
+
+<br/>
+
+## Kurulum
+
+**npm ile**
+
+```bash
+npm install -g fenrir-runtime
+```
+
+**GitHub'dan**
+
+```bash
+git clone https://github.com/yourusername/fenrir.git
+cd fenrir
+npm install
+npm link
+```
+
+<br/>
+
+## Kullanım
+
+```bash
+fenrir main.fnr              # Dosya çalıştır
+fenrir install <paket>       # Paket kur
+fenrir remove  <paket>       # Paket kaldır
+fenrir archive "mesaj"       # Anlık görüntü kaydet
+fenrir archives              # Görüntüleri listele
+fenrir rollback              # Son görüntüye geri dön
+fenrir rollback <id>         # Belirli görüntüye geri dön
+fenrir clean   <n>           # Son n görüntüyü tut, kalanı sil
+fenrir help                  # Yardım göster
+```
+
+<br/>
+
+## Söz Dizimi
+
+`.fnr` dosyaları büyük ölçüde JavaScript'tir, birkaç daha temiz alternatifle:
+
+```js
+use express from 'express'
+
+const app = express()
+const PORT = env('PORT', '3000')
+
+fn selamla(isim) {
+  log(`Merhaba, ${isim}!`)
+}
+
+app.get('/', fn(req, res) {
+  res.json({ mesaj: 'Fenrir ile merhaba' })
+})
+
+app.listen(PORT, fn() {
+  log(`🐺 Sunucu http://localhost:${PORT} adresinde çalışıyor`)
+})
+```
+
+| Fenrir | JavaScript |
+|--------|------------|
+| `fn isim() {}` | `function isim() {}` |
+| `fn(args) {}` | `function(args) {}` |
+| `use X from 'mod'` | `import X from 'mod'` |
+| `log()` | `console.log()` |
+| `err()` | `console.error()` |
+| `warn()` | `console.warn()` |
+| `info()` | `console.info()` |
+
+<br/>
+
+## Standart Kütüphane
+
+Tüm fonksiyonlar global olarak kullanılabilir — import gerekmez.
+
+| Kategori | Fonksiyonlar |
+|----------|--------------|
+| **I/O** | `readFile` `writeFile` `appendFile` `fileExists` `readDir` `readJSON` `writeJSON` `mkdir` `rm` |
+| **HTTP** | `get` `post` |
+| **Sistem** | `exec` `run` `spawn` `env` `args` `exit` `cwd` |
+| **Zaman** | `now` `time` `sleep` `bench` |
+| **Dizi** | `range` `pick` `shuffle` `chunk` `unique` `flatten` `sum` `avg` `min` `max` `clamp` |
+| **String** | `capitalize` `truncate` `pad` `repeat` |
+| **Nesne** | `keys` `values` `entries` `merge` `clone` |
+| **Async** | `all` `race` `retry` |
+| **Tip** | `isString` `isNumber` `isBool` `isArray` `isObject` `isNull` `isDefined` |
+| **Math** | `rand` `randInt` `abs` `ceil` `floor` `round` `sqrt` `pow` `PI` `E` |
+
+<br/>
+
+## Arşiv Sistemi
+
+```bash
+fenrir archive "refactor öncesi"       # Anlık görüntü kaydet
+fenrir archives                        # Tüm görüntüleri listele
+fenrir rollback                        # En son görüntüye geri dön
+fenrir rollback 2024-01-15_14-30-00    # Belirli görüntüye geri dön
+fenrir clean 10                        # Son 10'u tut, kalanı sil
+```
+
+<br/>
+
+## Debug Modu
+
+```bash
+FENRIR_DEBUG=1 fenrir main.fnr
+```
+
+Çalıştırmadan önce dönüştürülmüş JavaScript kodunu ekrana basar.
+
+<br/>
+
+## Gereksinimler
+
+- Node.js **v18** veya üzeri
+
+<br/>
+
+---
+
+<div align="center">
+<sub>BSD-3-Clause License</sub>
+</div>

package/example/.fenrir/archives/2026-03-14_21-07-26/.metadata.json

@@ -0,0 +1,7 @@
+{
+  "timestamp": "2026-03-14T21:07:26.232Z",
+  "message": "example",
+  "files": 4,
+  "hash": "ff7d576c",
+  "gitHash": "16f34e66318bcd90ddcc07394161848d8fe96cb8"
+}

package/example/.fenrir/archives/2026-03-14_21-07-26/fenrir.json

@@ -0,0 +1,9 @@
+{
+  "name": "example",
+  "version": "0.1.0",
+  "description": "A Fenrir project",
+  "dependencies": {
+    "express": "^5.2.1"
+  },
+  "fenrirVersion": "0.1.0"
+}

package/example/.fenrir/archives/2026-03-14_21-07-26/main.fnr

@@ -0,0 +1,67 @@
+use express from 'express'
+
+const app = express()
+const PORT = env('PORT', '3000')
+
+app.use(express.json())
+
+const users = [
+  { id: 1, name: 'Alice', role: 'admin' },
+  { id: 2, name: 'Bob',   role: 'user'  },
+]
+
+fn logger(req, res, next) {
+  log(`[${time()}] ${req.method} ${req.url}`)
+  next()
+}
+
+fn notFound(req, res) {
+  res.status(404).json({ error: 'not found' })
+}
+
+app.use(logger)
+
+app.get('/', fn(req, res) {
+  res.json({
+    name: 'Fenrir API',
+    version: '0.2.0',
+    uptime: process.uptime(),
+  })
+})
+
+app.get('/users', fn(req, res) {
+  res.json({ users, count: users.length })
+})
+
+app.get('/users/:id', fn(req, res) {
+  const id = parseInt(req.params.id)
+  const user = users.find(u => u.id === id)
+  if (!user) return res.status(404).json({ error: 'user not found' })
+  res.json(user)
+})
+
+app.post('/users', fn(req, res) {
+  const { name, role } = req.body
+  if (!name) return res.status(400).json({ error: 'name is required' })
+  const user = { id: users.length + 1, name, role: role || 'user' }
+  users.push(user)
+  res.status(201).json(user)
+})
+
+app.delete('/users/:id', fn(req, res) {
+  const id = parseInt(req.params.id)
+  const idx = users.findIndex(u => u.id === id)
+  if (idx === -1) return res.status(404).json({ error: 'user not found' })
+  const removed = users.splice(idx, 1)[0]
+  res.json({ deleted: removed })
+})
+
+app.use(notFound)
+
+app.listen(PORT, fn() {
+  log(`🐺 Server running on http://localhost:${PORT}`)
+  log(`   GET    /users`)
+  log(`   GET    /users/:id`)
+  log(`   POST   /users`)
+  log(`   DELETE /users/:id`)
+})