heliumts 0.2.2

package/LICENSE

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

package/README.md

@@ -0,0 +1,356 @@
+[![Status](https://img.shields.io/badge/status-active-success.svg)]()
+[![GitHub Issues](https://img.shields.io/github/issues/heliobentes/heliumjs)](https://github.com/heliobentes/heliumjs/issues)
+[![GitHub Pull Requests](https://img.shields.io/github/issues-pr/heliobentes/heliumjs)](https://github.com/heliobentes/heliumjs/pulls)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](/LICENSE)
+
+# HeliumTS
+
+HeliumTS is a blazing fast 🚀 and opinionated full-stack React + Vite framework designed for simplicity and type safety. It provides seamless RPC communication and file-based routing.
+
+## Table of Contents
+
+1. [Getting Started](#1-getting-started)
+   - [Installation](#11-installation)
+   - [Running the Development Server](#12-running-the-development-server)
+   - [Building for Production](#13-building-for-production)
+   - [Starting the Production Server](#14-starting-the-production-server)
+2. [Project Structure](#2-project-structure)
+3. [Core Concepts](#3-core-concepts)
+   - [RPC (Remote Procedure Calls)](#31-rpc-remote-procedure-calls)
+   - [Routing](#32-routing)
+   - [Custom HTTP Handlers](#33-custom-http-handlers)
+   - [Middleware](#34-middleware)
+   - [Configuration](#35-heliumconfigts)
+   - [Static Site Generation (SSG)](#36-static-site-generation-ssg)
+4. [CLI Reference](#4-cli-reference)
+5. [More Documentation](#5-more-documentation)
+6. [Contributing](#6-contributing)
+7. [License](#7-license)
+
+## 1. Getting Started
+
+### 1.1. Installation
+
+An installation script is coming soon! Meanwhile, follow these steps to set up a new HeliumTS project.
+
+#### 1.1.1. Install React + Vite
+
+```bash
+npm create vite@latest my-helium-app -- --template react-ts
+```
+#### 1.1.2. Install HeliumJS
+
+```bash
+npm install heliumts
+```
+
+#### 1.1.3. Setup Vite Config
+Create or update `vite.config.ts` in the project root to include Helium's Vite plugin:
+
+```typescript
+import react from '@vitejs/plugin-react';
+import helium from 'heliumts/vite';
+import { defineConfig } from 'vite';
+
+export default defineConfig({
+    plugins: [react(), helium()]
+});
+```
+
+#### 1.1.4. Delete **main.tsx**
+Delete the `src/main.tsx` file created by Vite, as HeliumTS handles the client entry point automatically.
+Also, remove its reference from `index.html` if present.
+```html
+<!-- Remove this from index.html -->
+<script type="module" src="/src/main.tsx"></script>
+```
+
+#### 1.1.5. Update `src/App.tsx`
+Replace the contents of `src/App.tsx` with the following content:
+```tsx
+import { type AppShellProps } from "heliumts/client";
+
+export default function App({ Component, pageProps }: AppShellProps) {
+    return <Component {...pageProps} />;
+}
+```
+
+### 1.2. Running the Development Server
+
+```bash
+npx helium dev
+```
+### 1.3. Building for Production
+
+```bash
+npx helium build
+```
+### 1.4. Starting the Production Server
+
+```bash
+npx helium start
+```
+
+Check the working Example APP at: [https://github.com/heliobentes/heliumjs-example-app](https://github.com/heliobentes/heliumjs-example-app)
+
+## 2. Project Structure
+
+A typical HeliumTS project looks like this:
+
+```
+src/
+  pages/             # Client-side pages (Next.js pages router style)
+    index.tsx
+    [id].tsx         # Dynamic routes
+    [...slug].tsx    # Catch-all routes
+    _layout.tsx      # Root layout
+    (protected)/     # Route group (e.g., for auth)
+      dashboard.tsx
+  server/            # Server-side logic
+    tasks.ts         # RPC methods for tasks
+    auth.ts          # Auth-related methods
+    webhooks.ts      # Webhook HTTP handlers
+    _middleware.ts   # Server middleware
+  components/        # React components
+  types/             # Shared types
+helium.config.ts     # Helium configuration
+package.json         # NPM package file
+vite.config.ts       # Vite configuration
+```
+
+## 3. Core Concepts
+
+Using HeliumTS makes it easy to build full-stack applications with minimal boilerplate. It removes the need for separate API routes and REST endpoints by enabling direct RPC calls from the client to server methods using websocket.
+
+No more `Axios` or `fetch` calls! Just define your server methods and call them directly from your React components with full type safety.
+
+### 3.1. RPC (Remote Procedure Calls)
+
+Define server-side functions using `defineMethod` and call them from the client using `useCall` or `useFetch`.
+
+**Server (`src/server/tasks.ts`):**
+
+```typescript
+import { defineMethod } from "heliumts/server";
+
+// Getting tasks
+export const getTasks = defineMethod(async (args: { status: string }) => {
+    // Add your own database logic here
+    return [{ id: 1, name: "Task 1", status: args.status }];
+});
+
+// Creating a new task
+export const createTask = defineMethod(async (args: { name: string }) => {
+    // Add your own create task logic
+    return { id: 2, name: args.name };
+});
+```
+
+**Client (`src/pages/tasks.tsx`):**
+
+```tsx
+import { useFetch, useCall } from "heliumts/client";
+import { getTasks, createTask } from "heliumts/server";
+
+export default function TasksPage() {
+    // Fetch data (auto-runs on mount)
+    // Data is typed based on server method return type
+    const { data, isLoading } = useFetch(getTasks, { status: "open" });
+
+    // Mutation (callable function)
+    // The call function is typed based on server method args and return type
+    const { call: add, isCalling } = useCall(createTask, {
+        invalidate: [getTasks] // Auto-refresh getTasks after success everywhere it's used
+    });
+
+    return (
+        <div>
+            <button onClick={() => add({ name: "New Task" })}>
+                {isCalling ? "Adding..." : "Add Task"}
+            </button>
+            {data?.map(task => <div key={task.id}>{task.name}</div>)}
+        </div>
+    );
+}
+```
+
+### 3.2. Routing
+
+Helium uses file-based routing in the `src/pages` directory similar to
+[**Next.js Pages Router**](https://nextjs.org/docs/pages).
+
+-   `src/pages/index.tsx` -> `/`
+-   `src/pages/about.tsx` -> `/about`
+-   `src/pages/users/[id].tsx` -> `/users/:id` (dynamic routes)
+-   `src/pages/_layout.tsx` -> Wraps all pages
+-   `src/pages/(protected)/dashboard.tsx` -> `/dashboard` (route group) 
+-   `src/pages/[...slug].tsx` -> Catch-all route
+
+**Link Component:**
+
+Helium provides a `Link` component for client-side navigation:
+
+```tsx
+import { Link } from "heliumts/client";
+
+<Link href="/about">Go to About</Link>
+```
+
+**useRouter Hook:**
+
+Access routing information and navigation methods:
+
+```tsx
+import { useRouter } from "heliumts/client";
+
+function MyComponent() {
+    const router = useRouter();
+    
+    // Access current route
+    console.log(router.path);           // "/users/123"
+    console.log(router.params.id);      // "123"
+    console.log(router.searchParams);   // URLSearchParams
+    console.log(router.status);         // 200 | 404
+    
+    // Navigate programmatically
+    router.push("/dashboard");
+    router.replace("/login");
+    
+    // Listen to route changes
+    router.on("navigation", (event) => {
+        console.log(`Navigated to ${event.to}`);
+    });
+}
+```
+
+See [Routing Documentation](./docs/routing.md) for detailed information including dynamic routes, layouts, and navigation.
+
+### 3.3. Custom HTTP Handlers
+
+For cases when you need to listen to webhooks or create REST endpoints, use `defineHTTPRequest`.
+
+Useful for integrating with third-party services like Stripe, GitHub, and Auth clients.
+
+#### 3.3.1. Stripe Webhook Example
+**Server (`src/server/webhooks.ts`):**
+
+```typescript
+import { defineHTTPRequest } from "heliumts/server";
+
+export const stripeWebhook = defineHTTPRequest("POST", "/webhooks/stripe", async (req, ctx) => {
+    const body = await req.json();
+    // Handle webhook
+    return { received: true };
+});
+```
+#### 3.3.2. Better Auth Example
+**Server (`src/server/auth.ts`):**
+
+```typescript
+import { defineHTTPRequest } from "heliumts/server";
+
+export const authHandler = defineHTTPRequest("ALL", "/auth/:provider", async (req, ctx) => {
+    // Call the better-auth handler directly
+    return auth.handler(await req.toWebRequest());
+});
+``` 
+***`toWebRequest()`** converts Helium's `Request` to a standard web `Request` object.
+
+### 3.4. Middleware
+
+You can define a middleware to intercept requests to the server.
+
+**Server (`src/server/_middleware.ts`):**
+
+```typescript
+import { middleware } from "heliumts/server";
+
+export default middleware(async (ctx, next) => {
+    console.log("Request received");
+    // Add your database connection or auth logic here
+    return next();
+});
+```
+
+### 3.5. helium.config.ts
+Helium's configuration file allows you to customize server settings including RPC encoding, compression, security, and proxy configuration.
+
+```typescript
+import type { HeliumConfig } from "heliumts/server";
+
+const config: HeliumConfig = {
+    trustProxyDepth: 1,  // Trust 1 proxy level (e.g., Vercel)
+    rpc: {
+        encoding: "msgpack",  // or "json"
+        compression: {
+            enabled: true,
+            threshold: 1024,
+        },
+        security: {
+            maxConnectionsPerIP: 10,
+            maxMessagesPerWindow: 100,
+            rateLimitWindowMs: 60000,
+            tokenValidityMs: 30000,
+        },
+    },
+};
+
+export default config;
+``` 
+See [Configuration Documentation](./docs/helium-config.md) for detailed options.
+
+### 3.6 Static Site Generation (SSG)
+HeliumTS supports Static Site Generation (SSG) through pre-rendering pages at build time.
+
+Add a `"use ssg";` directive at the top of your page component to enable SSG:
+
+**SSG page: (`src/pages/about.tsx`)**
+```tsx
+"use ssg";
+
+import React from "react";
+
+export default function AboutPage() {
+    return (
+        <div>
+            <h1>About Us</h1>
+            <p>This page is statically generated at build time.</p>
+        </div>
+    );
+}
+```
+
+During build, Helium validates SSG pages and generates optimized static HTML files.
+
+See [SSG Documentation](./docs/ssg.md) for detailed information including limitations, hybrid rendering, and best practices.
+
+## 4.CLI Reference
+
+-   `helium dev`: Starts Vite in development mode.
+-   `helium build`:
+    1.  Builds the client using Vite.
+    2.  Scans `src/server` for exports.
+    3.  Bundles the server using esbuild.
+    4.  Transpiles `helium.config.ts` to `dist/helium.config.js` (if present).
+-   `helium start`: Runs the bundled server (`dist/server.js`).
+
+## 5. More Documentation
+
+### Core Features
+-   [Routing & useRouter](./docs/routing.md) - File-based routing, dynamic routes, navigation, and the useRouter hook
+-   [Configuration](./docs/helium-config.md) - Configure RPC encoding, compression, security, and proxy settings
+-   [Static Site Generation](./docs/ssg.md) - Pre-render pages at build time for better performance
+-   [Route Groups](./docs/route-groups.md) - Organize routes with shared layouts without affecting URLs
+
+### Deployment & Advanced
+-   [Context API](./docs/context-api.md) - Access request metadata including client IPs and headers
+-   [Proxy Configuration](./docs/proxy-configuration.md) - Configure IP detection for rate limiting behind proxies
+-   [HTTP Handlers & Webhooks](./docs/http-handlers.md) - Create custom HTTP endpoints for webhooks and REST APIs
+-   [Production Deployment](./docs/production-deployment.md) - Deploy to production platforms (Digital Ocean, Docker, etc.)
+
+## 6. Contributing
+
+Contributions are welcome! Please read the [contributing guide](./CONTRIBUTING.md) for details.
+
+## 7. License
+This project is licensed under the MIT License. See the [LICENSE](./LICENSE) file for details.

package/dist/bin/helium.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=helium.d.ts.map

package/dist/bin/helium.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helium.d.ts","sourceRoot":"","sources":["../../src/bin/helium.ts"],"names":[],"mappings":""}

package/dist/bin/helium.js

@@ -0,0 +1,236 @@
+#!/usr/bin/env node
+import { cac } from "cac";
+import { spawn } from "child_process";
+import { build as esbuild } from "esbuild";
+import fs from "fs";
+import path from "path";
+import { build as viteBuild } from "vite";
+import { log } from "../utils/logger.js";
+import { scanServerExports } from "../vite/scanner.js";
+import { generateStaticPages } from "../vite/ssg.js";
+import { generateServerManifest } from "../vite/virtualServerModule.js";
+const cli = cac("helium");
+const root = process.cwd();
+cli.command("dev", "Start development server").action(async () => {
+    const vite = spawn("vite", [], { stdio: "inherit", shell: true });
+    vite.on("close", (code) => {
+        process.exit(code || 0);
+    });
+});
+cli.command("build", "Build for production").action(async () => {
+    log("info", "--------------------------------");
+    log("info", "Building client...");
+    try {
+        const result = await viteBuild({
+            root,
+            logLevel: "silent",
+            build: {
+                outDir: "dist",
+            },
+        });
+        // Display build output
+        if (result && "output" in result) {
+            const outputs = result.output;
+            const zlib = await import("zlib");
+            for (const chunk of outputs) {
+                if (chunk.type === "asset" || chunk.type === "chunk") {
+                    const fileName = chunk.fileName;
+                    const content = "code" in chunk ? chunk.code : chunk.source;
+                    const size = Buffer.byteLength(content, "utf-8");
+                    const sizeKB = (size / 1024).toFixed(2);
+                    // Calculate gzipped size
+                    const gzipped = zlib.gzipSync(content);
+                    const gzipSizeKB = (gzipped.length / 1024).toFixed(2);
+                    log("info", `  ${fileName.padEnd(35)} ${sizeKB.padStart(8)} kB │ gzip: ${gzipSizeKB.padStart(7)} kB`);
+                }
+            }
+        }
+        log("info", "Client build complete.");
+        // Generate static pages for SSG
+        log("info", "--------------------------------");
+        try {
+            // Read the generated index.html as a template for SSG
+            const distDir = path.join(root, "dist");
+            const htmlPath = path.join(distDir, "index.html");
+            if (fs.existsSync(htmlPath)) {
+                let htmlTemplate = fs.readFileSync(htmlPath, "utf-8");
+                // Clean up the template for SSG:
+                // 1. Remove the build-time HELIUM_CONNECTION_TOKEN (SSG pages don't need it)
+                htmlTemplate = htmlTemplate.replace(/<script>window\.HELIUM_CONNECTION_TOKEN = "build-time-placeholder";<\/script>/g, "");
+                // 2. Clear any existing content in root div from SPA build
+                htmlTemplate = htmlTemplate.replace(/<div\s+id="root"[^>]*>.*?<\/div>/s, '<div id="root"></div>');
+                await generateStaticPages(null, root, htmlTemplate, distDir);
+            }
+            else {
+                log("warn", "index.html not found in dist, skipping SSG");
+            }
+        }
+        catch (e) {
+            log("warn", "SSG generation failed:", e);
+            // Don't fail the build if SSG fails
+        }
+        log("info", "--------------------------------");
+    }
+    catch (e) {
+        log("error", "Client build failed:", e);
+        process.exit(1);
+    }
+    log("info", "Building server...");
+    // Generate server entry
+    const serverExports = scanServerExports(root);
+    const manifestCode = generateServerManifest(serverExports.methods, serverExports.httpHandlers, serverExports.middleware);
+    // Create the main server module that will be imported after env is loaded
+    const serverModuleCode = `
+import { startProdServer, loadConfig } from 'heliumts/server';
+${manifestCode}
+
+export async function start() {
+    const config = await loadConfig();
+
+    startProdServer({
+        config,
+        registerHandlers: (registry, httpRouter) => {
+            registerAll(registry);
+            httpRouter.registerRoutes(httpHandlers);
+            if (middlewareHandler) {
+                registry.setMiddleware(middlewareHandler);
+                httpRouter.setMiddleware(middlewareHandler);
+            }
+        }
+    });
+}
+`;
+    // Create the entry loader that loads env first, then imports the server module
+    const entryCode = `
+// Load environment variables FIRST, before any other imports
+import './env-loader.js';
+// Now import and start the server (this ensures handlers load after env)
+import { start } from './server-module.js';
+await start();
+`;
+    const envLoaderCode = `
+import { loadEnvFiles, injectEnvToProcess, log } from 'heliumts/server';
+const envRoot = process.cwd();
+log('info', \`Loading .env files from: \${envRoot}\`);
+const envVars = loadEnvFiles({ mode: 'production' });
+injectEnvToProcess(envVars);
+if (Object.keys(envVars).length > 0) {
+    log('info', \`Loaded \${Object.keys(envVars).length} environment variable(s) from .env files\`);
+} else {
+    log('info', 'No .env files found (using platform environment variables if available)');
+}
+`;
+    const heliumDir = path.join(root, "node_modules", ".helium");
+    if (!fs.existsSync(heliumDir)) {
+        fs.mkdirSync(heliumDir, { recursive: true });
+    }
+    const entryPath = path.join(heliumDir, "server-entry.ts");
+    const envLoaderPath = path.join(heliumDir, "env-loader.ts");
+    const serverModuleSrcPath = path.join(heliumDir, "server-module.ts");
+    fs.writeFileSync(entryPath, entryCode);
+    fs.writeFileSync(envLoaderPath, envLoaderCode);
+    fs.writeFileSync(serverModuleSrcPath, serverModuleCode);
+    // Bundle with esbuild
+    try {
+        const serverBuild = await esbuild({
+            entryPoints: [entryPath],
+            outfile: path.join(root, "dist", "server.js"),
+            bundle: true,
+            platform: "node",
+            format: "esm",
+            external: [
+                // External common database and heavy dependencies
+                "mongodb",
+                "mongoose",
+                "pg",
+                "mysql",
+                "mysql2",
+                "sqlite3",
+                "better-sqlite3",
+                "redis",
+                // Node.js built-ins are automatically external, but let's be explicit
+                "crypto",
+                "fs",
+                "path",
+                "http",
+                "https",
+                "stream",
+                "zlib",
+                "util",
+            ],
+            target: "node18",
+            metafile: true,
+            banner: {
+                js: "import { createRequire } from 'module'; const require = createRequire(import.meta.url);",
+            },
+        });
+        // Display server build output
+        const serverOutputPath = path.relative(root, path.join(root, "dist", "server.js"));
+        const serverStats = fs.statSync(path.join(root, "dist", "server.js"));
+        const serverSizeKB = (serverStats.size / 1024).toFixed(2);
+        log("info", `  ${serverOutputPath.padEnd(35)} ${serverSizeKB.padStart(8)} kB`);
+        log("info", "Server build complete.");
+        // Transpile helium.config.ts to helium.config.js if it exists
+        const configTsPath = path.join(root, "helium.config.ts");
+        if (fs.existsSync(configTsPath)) {
+            log("info", "Transpiling helium.config.ts...");
+            try {
+                await esbuild({
+                    entryPoints: [configTsPath],
+                    outfile: path.join(root, "dist", "helium.config.js"),
+                    bundle: false,
+                    platform: "node",
+                    format: "esm",
+                    target: "node18",
+                });
+                log("info", "Config file transpiled to dist/helium.config.js");
+            }
+            catch (e) {
+                log("warn", "Failed to transpile config file:", e);
+                log("warn", "You may need to manually rename helium.config.ts to helium.config.js");
+            }
+        }
+        else {
+            // Check if .js or .mjs config exists and copy it to dist
+            const configJsPath = path.join(root, "helium.config.js");
+            const configMjsPath = path.join(root, "helium.config.mjs");
+            if (fs.existsSync(configJsPath)) {
+                fs.copyFileSync(configJsPath, path.join(root, "dist", "helium.config.js"));
+                log("info", "Copied helium.config.js to dist/");
+            }
+            else if (fs.existsSync(configMjsPath)) {
+                fs.copyFileSync(configMjsPath, path.join(root, "dist", "helium.config.mjs"));
+                log("info", "Copied helium.config.mjs to dist/");
+            }
+        }
+        log("info", "--------------------------------");
+        log("info", "✓ Build finished successfully.");
+        log("info", "▶ Run 'helium start' to start the production server.");
+        // Exit cleanly after build completes
+        process.exit(0);
+    }
+    catch (e) {
+        log("error", "Server build failed:", e);
+        process.exit(1);
+    }
+});
+cli.command("start", "Start production server").action(async () => {
+    const serverPath = path.join(root, "dist", "server.js");
+    if (!fs.existsSync(serverPath)) {
+        log("error", 'Server build not found. Run "helium build" first.');
+        process.exit(1);
+    }
+    // When running in production, look for config in dist directory first
+    // This allows the transpiled config to be found
+    const server = spawn("node", [serverPath], {
+        stdio: "inherit",
+        shell: true,
+        env: { ...process.env, HELIUM_CONFIG_DIR: path.join(root, "dist") },
+    });
+    server.on("close", (code) => {
+        process.exit(code || 0);
+    });
+});
+cli.help();
+cli.parse();
+//# sourceMappingURL=helium.js.map

package/dist/bin/helium.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helium.js","sourceRoot":"","sources":["../../src/bin/helium.ts"],"names":[],"mappings":"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"}