@alabjs/compiler 0.1.0

package/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "alab-napi"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+alab-compiler = { path = "../alab-compiler" }
+alab-router = { path = "../alab-router" }
+napi = { version = "2", features = ["napi8", "async"] }
+napi-derive.workspace = true
+tokio = { version = "1", features = ["rt"] }
+serde_json.workspace = true
+
+[build-dependencies]
+napi-build = "2"

package/build.rs

@@ -0,0 +1,5 @@
+extern crate napi_build;
+
+fn main() {
+    napi_build::setup();
+}

package/index.js

@@ -0,0 +1,70 @@
+/* eslint-disable */
+// prettier-ignore
+// Auto-generated by napi-rs — do not edit manually.
+// Loads the correct platform-specific native binary.
+
+const { existsSync } = require('fs')
+const { join } = require('path')
+const { platform, arch } = process
+
+let nativeBinding = null
+let loadError = null
+
+function isMusl() {
+  if (process.versions?.electron) return false
+  // Check /proc/self/maps for musl
+  try {
+    return require('fs').readFileSync('/proc/self/maps', 'utf8').includes('musl')
+  } catch {
+    return false
+  }
+}
+
+const targets = {
+  win32: { x64: 'win32-x64-msvc' },
+  darwin: { x64: 'darwin-x64', arm64: 'darwin-arm64' },
+  linux: {
+    x64: isMusl() ? 'linux-x64-musl' : 'linux-x64-gnu',
+    arm64: isMusl() ? 'linux-arm64-musl' : 'linux-arm64-gnu',
+  },
+}
+
+const target = targets[platform]?.[arch]
+
+if (target) {
+  const localFile = join(__dirname, `alab-napi.${target}.node`)
+
+  if (existsSync(localFile)) {
+    // Development: binary built locally via `cargo build`
+    try {
+      nativeBinding = require(localFile)
+    } catch (e) {
+      loadError = e
+    }
+  } else {
+    // Production: load from the scoped platform package
+    try {
+      nativeBinding = require(`@alabjs/compiler-${target}`)
+    } catch (e) {
+      loadError = e
+    }
+  }
+}
+
+if (!nativeBinding) {
+  const supported = Object.entries(targets)
+    .flatMap(([os, archs]) => Object.values(archs).map((t) => `${os}-${t}`))
+    .join(', ')
+
+  throw new Error(
+    `[alabjs] Failed to load the Rust compiler binary.\n` +
+    `  Platform: ${platform}-${arch}\n` +
+    `  Supported: ${supported}\n` +
+    (loadError ? `  Error: ${loadError.message}\n` : '') +
+    `\n` +
+    `  To build locally: cargo build --release -p alab-napi\n` +
+    `  Then copy: target/release/libalab_napi.dylib → crates/alab-napi/alab-napi.darwin-arm64.node`
+  )
+}
+
+module.exports = nativeBinding

package/npm/darwin-arm64/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@alabjs/compiler-darwin-arm64",
+  "version": "0.1.0",
+  "description": "AlabJS compiler binary for darwin-arm64",
+  "license": "MIT",
+  "main": "alab-napi.darwin-arm64.node",
+  "files": [
+    "alab-napi.darwin-arm64.node"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/alabjs.git"
+  }
+}

package/npm/darwin-x64/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@alabjs/compiler-darwin-x64",
+  "version": "0.1.0",
+  "description": "AlabJS compiler binary for darwin-x64",
+  "license": "MIT",
+  "main": "alab-napi.darwin-x64.node",
+  "files": [
+    "alab-napi.darwin-x64.node"
+  ],
+  "os": [
+    "darwin"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/alabjs.git"
+  }
+}

package/npm/linux-arm64-gnu/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@alabjs/compiler-linux-arm64-gnu",
+  "version": "0.1.0",
+  "description": "AlabJS compiler binary for linux-arm64-gnu",
+  "license": "MIT",
+  "main": "alab-napi.linux-arm64-gnu.node",
+  "files": [
+    "alab-napi.linux-arm64-gnu.node"
+  ],
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "arm64"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/alabjs.git"
+  }
+}

package/npm/linux-x64-gnu/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@alabjs/compiler-linux-x64-gnu",
+  "version": "0.1.0",
+  "description": "AlabJS compiler binary for linux-x64-gnu",
+  "license": "MIT",
+  "main": "alab-napi.linux-x64-gnu.node",
+  "files": [
+    "alab-napi.linux-x64-gnu.node"
+  ],
+  "os": [
+    "linux"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/alabjs.git"
+  }
+}

package/npm/win32-x64-msvc/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@alabjs/compiler-win32-x64-msvc",
+  "version": "0.1.0",
+  "description": "AlabJS compiler binary for win32-x64-msvc",
+  "license": "MIT",
+  "main": "alab-napi.win32-x64-msvc.node",
+  "files": [
+    "alab-napi.win32-x64-msvc.node"
+  ],
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/alabjs.git"
+  }
+}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@alabjs/compiler",
+  "version": "0.1.0",
+  "description": "AlabJS Rust compiler core — napi-rs native addon",
+  "license": "MIT",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "napi": {
+    "binaryName": "alab-napi",
+    "targets": [
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-apple-darwin",
+      "aarch64-apple-darwin",
+      "x86_64-pc-windows-msvc"
+    ]
+  },
+  "scripts": {
+    "build": "napi build --platform --release --js index.js --dts index.d.ts",
+    "build:debug": "napi build --platform --js index.js --dts index.d.ts",
+    "prepublishOnly": "napi prepublish -t npm",
+    "universal": "napi universal"
+  },
+  "optionalDependencies": {
+    "@alabjs/compiler-linux-x64-gnu": "0.1.0",
+    "@alabjs/compiler-linux-arm64-gnu": "0.1.0",
+    "@alabjs/compiler-darwin-x64": "0.1.0",
+    "@alabjs/compiler-darwin-arm64": "0.1.0",
+    "@alabjs/compiler-win32-x64-msvc": "0.1.0"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^3.0.0"
+  },
+  "engines": {
+    "node": ">= 22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thinkgrid-labs/alabjs.git"
+  }
+}

package/src/lib.rs

@@ -0,0 +1,118 @@
+#![deny(clippy::all)]
+
+use napi::bindgen_prelude::Buffer;
+use napi_derive::napi;
+use alab_compiler::{
+    compile, check_server_boundary, CompileOptions,
+    optimize_buffer, OptimizeOptions, OutputFormat,
+    extract_server_fns as alab_extract_server_fns,
+    server_fn_client_stub as alab_server_fn_client_stub,
+};
+use alab_router::scan_routes;
+
+/// Compile a TypeScript / TSX source string to JavaScript.
+///
+/// Returns a JSON string `{ code: string, map: string | null }`.
+/// Pass `source_map: true` to include a VLQ source map in `map`.
+#[napi]
+pub fn compile_source(source: String, filename: String, minify: bool, source_map: bool) -> napi::Result<String> {
+    let opts = CompileOptions { filename, source_map, minify };
+    let output = compile(&source, &opts)
+        .map_err(|e| napi::Error::from_reason(e.to_string()))?;
+    serde_json::to_string(&output)
+        .map_err(|e| napi::Error::from_reason(e.to_string()))
+}
+
+/// Check a source file for server-boundary violations.
+///
+/// Returns a JSON array of `{ import, source, offset }` objects.
+/// An empty array means no violations.
+#[napi]
+pub fn check_boundary(source: String, filename: String) -> napi::Result<String> {
+    let violations = check_server_boundary(&source, &filename);
+    serde_json::to_string(&violations)
+        .map_err(|e| napi::Error::from_reason(e.to_string()))
+}
+
+/// Scan an `app/` directory and return the full route manifest as JSON.
+///
+/// Returns `{ routes: Route[] }`.
+#[napi]
+pub fn build_routes(app_dir: String) -> napi::Result<String> {
+    let manifest = scan_routes(&app_dir);
+    serde_json::to_string(&manifest)
+        .map_err(|e| napi::Error::from_reason(e.to_string()))
+}
+
+/// Optimise a single image buffer — same interface as snapbolt-cli.
+///
+/// Runs on a Tokio blocking thread so it never blocks the Node.js event loop,
+/// keeping the server at full throughput even during heavy image processing.
+///
+/// - `input`   — raw image bytes (JPEG, PNG, GIF, or WebP)
+/// - `quality` — 1.0–100.0, defaults to 80
+/// - `width`   — target width in pixels; omit to keep original width
+/// - `height`  — target height in pixels; omit to keep original height
+/// - `format`  — `"webp"` (default), `"jpeg"`, or `"png"`
+///
+/// WebP encoding uses libwebp-sys when the crate is compiled with
+/// `--features native`; otherwise falls back to the pure-Rust encoder.
+/// Returns a Promise that resolves to the encoded bytes as a Node.js `Buffer`.
+#[napi]
+pub async fn optimize_image(
+    input: Buffer,
+    quality: Option<f64>,
+    width: Option<u32>,
+    height: Option<u32>,
+    format: Option<String>,
+) -> napi::Result<Buffer> {
+    let fmt = match format.as_deref() {
+        Some("jpeg") | Some("jpg") => OutputFormat::Jpeg,
+        Some("png")                => OutputFormat::Png,
+        _                          => OutputFormat::WebP,
+    };
+    let options = OptimizeOptions {
+        quality: quality.unwrap_or(80.0) as f32,
+        width,
+        height,
+        format: fmt,
+    };
+    // Move CPU-intensive work off the event loop thread.
+    let data: Vec<u8> = input.to_vec();
+    let result = tokio::task::spawn_blocking(move || optimize_buffer(&data, &options))
+        .await
+        .map_err(|e| napi::Error::from_reason(e.to_string()))?;
+
+    match result {
+        Ok((bytes, _mime)) => Ok(bytes.into()),
+        Err(e)             => Err(napi::Error::from_reason(e.to_string())),
+    }
+}
+
+/// Scan a `.server.ts` source file for `export const NAME = defineServerFn(handler)`
+/// declarations and return them as JSON.
+///
+/// Returns a JSON array of `{ name: string, endpoint: string }` objects.
+/// The caller (Vite plugin) uses the endpoint list to:
+///   1. Register `POST /_alabjs/fn/<name>` handlers in the production server.
+///   2. Replace handler bodies with thin fetch stubs in client bundles.
+#[napi]
+pub fn extract_server_fns(source: String, filename: String) -> napi::Result<String> {
+    let fns = alab_extract_server_fns(&source, &filename);
+    serde_json::to_string(&fns)
+        .map_err(|e| napi::Error::from_reason(e.to_string()))
+}
+
+/// Generate a client-side stub for a single server function.
+///
+/// Used by the Vite plugin during client builds to replace the real handler
+/// (which may contain DB calls and secrets) with a `fetch("/_alabjs/fn/<name>")`
+/// stub that works identically from the browser's perspective.
+///
+/// @param name     - The exported binding name (e.g. `"getUser"`)
+/// @param endpoint - The HTTP endpoint (e.g. `"/_alabjs/fn/getUser"`)
+/// @returns ES module snippet ready to be injected into the client bundle
+#[napi]
+pub fn server_fn_stub(name: String, endpoint: String) -> String {
+    alab_server_fn_client_stub(&name, &endpoint)
+}