Initial Open Source Release

Author: aalsuwaidi

.gitignore

@@ -0,0 +1,18 @@
+# Binaries for programs and plugins
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binary, built with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# Dependency directories (remove the comment below to include it)
+# vendor/
+
+# Go workspace file
+go.work

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Marasi
+
+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.

README.md

@@ -0,0 +1,93 @@
+<div align="center">
+
+# Marasi
+
+[![GoDoc](https://godoc.org/github.com/tfkr-ae/marasi?status.png)](https://godoc.org/github.com/tfkr-ae/marasi)
+
+<img src="images/logo.svg" width="150" alt="Marasi">
+
+A Go library for building application security testing proxies.
+
+[marasi.app](https://marasi.app)
+</div>
+
+## Features
+
+- **HTTP/HTTPS Proxy**: TLS-capable proxy server with certificate management
+- **Request/Response Interception**: Modify traffic in real-time
+- **Lua Extensions**: Scriptable proxy behavior with built-in extensions
+- **Application Data Format**: SQLite-based storage for all proxy data (requests, responses, metadata)
+- **Launchpad**: Replay and modify HTTP requests
+- **Scope Management**: Filter traffic with inclusion/exclusion rules
+- **Waypoints**: Override hostnames for request routing
+- **Chrome Integration**: Auto-configure Chrome with proxy settings
+
+## Core Components
+
+### Proxy Engine
+- Built on [Google Martian Proxy](https://github.com/google/martian)
+- Automatic content decoding
+- Content prettification (JSON, XML, HTML)
+- Concurrent request/response processing
+
+### Extension System
+Lua based extension support, three built-in extensions:
+- **Compass**: Scope management and traffic filtering
+- **Checkpoint**: Request/response interception rules
+- **Workshop**: Lua development environment
+
+The ability to add custom extensions coming soon.
+
+
+### Application File Format
+SQLite-based application file format stores:
+- Complete request/response data with timing
+- Extension management and settings
+- Launchpad entries for request replay
+- Comprehensive logging system
+- User notes and hostname waypoints
+
+## Library Usage
+
+This library is designed for building web appilcation security proxies. 
+
+Basic integration (for full implementation see marasi-app):
+
+```go
+// Create proxy with options
+proxy, err := marasi.New(
+    marasi.WithConfigDir("/path/to/config"),
+    marasi.WithDatabase(repo),
+)
+
+// Set up handlers for your application
+proxy.WithOptions(
+    marasi.WithRequestHandler(func(req marasi.ProxyRequest) error {
+        // Handle Requests in your application
+        return nil
+    }),
+    marasi.WithResponseHandler(func(res marasi.ProxyResponse) error {
+        // Handle Responses in your application
+        return nil
+    }),
+    marasi.WithLogHandler(func(logItem marasi.Log) error {
+        // Handle log messages
+        return nil
+    }),
+    marasi.WithInterceptHandler(func(intercepted *marasi.Intercepted) error {
+        switch intercepted.Type {
+        case "request":
+        // Handle Request interception
+        case "response":
+        // Handle Response interception
+        }
+        return nil
+    }),
+)
+
+// Start proxy server
+listener, err := proxy.GetListener("127.0.0.1", "8080")
+proxy.Serve(listener)
+```
+# GitHub Discussion
+Use the [GitHub Discussion](https://github.com/tfkr-ae/marasi/discussions) to provide feedback, ask questions or discuss the project.

chrome.go

@@ -0,0 +1,93 @@
+package marasi
+
+import (
+	"fmt"
+	"os/exec"
+	"path"
+	"runtime"
+)
+
+// getChromePath determines the Chrome executable path based on the operating system.
+// It checks common installation locations for Chrome and Chromium on macOS, Windows, and Linux.
+//
+// Returns:
+//   - string: Path to Chrome executable, or empty string if not found
+func getChromePath() string {
+	var paths []string
+	switch runtime.GOOS {
+	case "darwin":
+		paths = []string{
+			`/Applications/Google Chrome.app/Contents/MacOS/Google Chrome`,
+			`/Applications/Chromium.app/Contents/MacOS/Chromium`,
+			`/usr/local/bin/chrome`,   // Alternative common symlink
+			`/usr/local/bin/chromium`, // Alternative common symlink for Chromium
+		}
+	case "windows":
+		paths = []string{
+			`C:\Program Files\Google\Chrome\Application\chrome.exe`,
+			`C:\Program Files (x86)\Google\Chrome\Application\chrome.exe`,
+			`C:\Program Files\Chromium\Application\chrome.exe`,
+		}
+	case "linux":
+		paths = []string{
+			`/usr/bin/google-chrome`,
+			`/usr/bin/chromium-browser`,
+			`/usr/bin/chromium`,
+			`/snap/bin/chromium`,
+		}
+	default:
+		return ""
+	}
+
+	// Find the first valid path
+	for _, path := range paths {
+		if _, err := exec.LookPath(path); err == nil {
+			return path
+		}
+	}
+	return ""
+}
+
+// StartChrome launches Chrome with proxy configuration and security settings.
+// It configures Chrome to use the proxy server, creates an isolated user profile,
+// and disables various Chrome features that might interfere with testing.
+//
+// Returns:
+//   - error: Chrome launch error if executable not found or process fails to start
+func (proxy *Proxy) StartChrome() error {
+	// Determine Chrome path based on OS
+	chromePath := getChromePath()
+	if chromePath == "" {
+		return fmt.Errorf("unsupported operating system")
+	}
+
+	// Set flags for Chrome
+	flags := []string{
+		fmt.Sprintf("--user-data-dir=%s", path.Join(proxy.ConfigDir, "chrome-profile")),
+		fmt.Sprintf("--proxy-server=http://%s:%s", proxy.Addr, proxy.Port),
+		fmt.Sprintf("--ignore-certificate-errors-spki-list=%s", proxy.SPKIHash),
+		"--disable-background-networking",
+		"--disable-client-side-phishing-detection",
+		"--disable-default-apps",
+		"--disable-features=NetworkPrediction,OmniboxUIExperimentMaxAutocompleteMatches",
+		"--disable-sync",
+		"--metrics-recording-only",
+		"--disable-domain-reliability",
+		"--no-first-run",
+		"--disable-component-update",
+		"--disable-suggestions-service",
+		"--disable-search-geolocation-disclosure",
+		"--disable-search-engine-choice",
+		"--disable-omnibox-autocomplete-offers", // Disables autocomplete suggestions
+		"--proxy-bypass-list=<-loopback>",
+		"about:blank",
+	}
+
+	// Start Chrome process
+	cmd := exec.Command(chromePath, flags...)
+	if err := cmd.Start(); err != nil {
+		return fmt.Errorf("starting chrome : %w", err)
+	}
+
+	return nil
+}