@maayn/veld 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Adhamzineldin
+
+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,66 @@
+# Veld — npm package
+
+> Contract-first, multi-stack API code generator.
+
+## Install
+
+```bash
+npm install veld
+# or
+npx veld generate
+```
+
+## Usage
+
+After installing, the `veld` CLI is available:
+
+```bash
+veld init                    # Scaffold a new project
+veld generate                # Generate from veld.config.json
+veld generate --dry-run      # Preview what would be generated
+veld watch                   # Auto-regenerate on file changes
+veld validate                # Check contracts for errors
+veld clean                   # Remove generated output
+veld openapi                 # Export OpenAPI 3.0 spec
+```
+
+## How it works
+
+This npm package is a thin wrapper around the Veld Go binary. On `npm install`,
+a postinstall script downloads the correct pre-built binary for your platform
+from [GitHub Releases](https://github.com/veld-dev/veld/releases).
+
+**Supported platforms:**
+- Linux (x64, arm64)
+- macOS (x64, Apple Silicon)
+- Windows (x64)
+
+If the download fails (e.g. behind a corporate proxy), the installer falls back
+to `go install github.com/veld-dev/veld/cmd/veld@latest`.
+
+## Alternative installation
+
+```bash
+# Go (no npm needed)
+go install github.com/veld-dev/veld/cmd/veld@latest
+
+# Homebrew
+brew install veld
+
+# pip
+pip install veld
+
+# Composer (PHP)
+composer require veld-dev/veld
+```
+
+## Links
+
+- [Documentation](https://github.com/veld-dev/veld)
+- [VS Code Extension](https://marketplace.visualstudio.com/items?itemName=veld-dev.veld-vscode)
+- [JetBrains Plugin](https://plugins.jetbrains.com/plugin/veld)
+
+## License
+
+MIT
+

package/bin/veld.js

@@ -0,0 +1,57 @@
+#!/usr/bin/env node
+
+/**
+ * Veld CLI — npm wrapper
+ *
+ * This thin wrapper spawns the platform-specific Veld binary that was
+ * downloaded during `npm install` (postinstall). All CLI arguments are
+ * forwarded as-is.
+ */
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+const os = require("os");
+
+function getBinaryName() {
+  return os.platform() === "win32" ? "veld.exe" : "veld";
+}
+
+function getBinaryPath() {
+  // Check local node_modules/.veld-bin first (postinstall puts it here)
+  const localBin = path.join(__dirname, "..", "bin-platform", getBinaryName());
+  if (fs.existsSync(localBin)) {
+    return localBin;
+  }
+
+  // Fallback: check if veld is on PATH
+  const envPath = os.platform() === "win32" ? "veld.exe" : "veld";
+  return envPath;
+}
+
+try {
+  const binary = getBinaryPath();
+  const args = process.argv.slice(2);
+
+  const result = execFileSync(binary, args, {
+    stdio: "inherit",
+    env: process.env,
+  });
+
+  process.exit(0);
+} catch (err) {
+  if (err.status !== undefined) {
+    process.exit(err.status);
+  }
+  console.error("Error: Could not run veld binary.");
+  console.error("Try reinstalling: npm install veld");
+  console.error("");
+  console.error("Or install manually:");
+  console.error("  go install github.com/veld-dev/veld/cmd/veld@latest");
+  console.error("");
+  console.error(err.message);
+  process.exit(1);
+}
+

package/install.js

@@ -0,0 +1,185 @@
+/**
+ * Veld CLI — postinstall script
+ *
+ * Downloads the correct pre-built Veld binary for the current platform
+ * from GitHub Releases. Falls back to `go install` if the download fails.
+ *
+ * Supported platforms:
+ *   - linux-amd64, linux-arm64
+ *   - darwin-amd64, darwin-arm64
+ *   - windows-amd64
+ */
+
+"use strict";
+
+const https = require("https");
+const http = require("http");
+const fs = require("fs");
+const path = require("path");
+const os = require("os");
+const { execSync } = require("child_process");
+const zlib = require("zlib");
+
+const VERSION = "0.1.0";
+const GITHUB_REPO = "veld-dev/veld";
+const BASE_URL = `https://github.com/${GITHUB_REPO}/releases/download/v${VERSION}`;
+
+function getPlatformKey() {
+  const platform = os.platform();
+  const arch = os.arch();
+
+  const platformMap = {
+    linux: "linux",
+    darwin: "darwin",
+    win32: "windows",
+  };
+
+  const archMap = {
+    x64: "amd64",
+    arm64: "arm64",
+  };
+
+  const p = platformMap[platform];
+  const a = archMap[arch];
+
+  if (!p || !a) {
+    return null;
+  }
+
+  return `${p}-${a}`;
+}
+
+function getBinaryName() {
+  return os.platform() === "win32" ? "veld.exe" : "veld";
+}
+
+function getDownloadUrl(platformKey) {
+  const ext = os.platform() === "win32" ? ".zip" : ".tar.gz";
+  return `${BASE_URL}/veld-${platformKey}${ext}`;
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const get = url.startsWith("https") ? https.get : http.get;
+    get(url, (res) => {
+      // Follow redirects (GitHub sends 302)
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return download(res.headers.location).then(resolve).catch(reject);
+      }
+      if (res.statusCode !== 200) {
+        reject(new Error(`HTTP ${res.statusCode} downloading ${url}`));
+        return;
+      }
+      const chunks = [];
+      res.on("data", (chunk) => chunks.push(chunk));
+      res.on("end", () => resolve(Buffer.concat(chunks)));
+      res.on("error", reject);
+    }).on("error", reject);
+  });
+}
+
+async function extractTarGz(buffer, destDir) {
+  // Write to temp file and use tar
+  const tmpFile = path.join(os.tmpdir(), `veld-${Date.now()}.tar.gz`);
+  fs.writeFileSync(tmpFile, buffer);
+  fs.mkdirSync(destDir, { recursive: true });
+  try {
+    execSync(`tar -xzf "${tmpFile}" -C "${destDir}"`, { stdio: "pipe" });
+  } finally {
+    fs.unlinkSync(tmpFile);
+  }
+}
+
+async function extractZip(buffer, destDir) {
+  // Write to temp file and use PowerShell / unzip
+  const tmpFile = path.join(os.tmpdir(), `veld-${Date.now()}.zip`);
+  fs.writeFileSync(tmpFile, buffer);
+  fs.mkdirSync(destDir, { recursive: true });
+  try {
+    if (os.platform() === "win32") {
+      execSync(
+        `powershell -Command "Expand-Archive -Force -Path '${tmpFile}' -DestinationPath '${destDir}'"`,
+        { stdio: "pipe" }
+      );
+    } else {
+      execSync(`unzip -o "${tmpFile}" -d "${destDir}"`, { stdio: "pipe" });
+    }
+  } finally {
+    fs.unlinkSync(tmpFile);
+  }
+}
+
+async function tryGoInstall() {
+  console.log("Attempting fallback: go install github.com/veld-dev/veld/cmd/veld@latest");
+  try {
+    execSync("go install github.com/veld-dev/veld/cmd/veld@latest", {
+      stdio: "inherit",
+    });
+    console.log("✓ Installed veld via go install");
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function main() {
+  const platformKey = getPlatformKey();
+
+  if (!platformKey) {
+    console.warn(
+      `Warning: Unsupported platform ${os.platform()}-${os.arch()}.`
+    );
+    console.warn("Attempting go install fallback...");
+    if (await tryGoInstall()) return;
+    console.warn("Install veld manually: go install github.com/veld-dev/veld/cmd/veld@latest");
+    return;
+  }
+
+  const url = getDownloadUrl(platformKey);
+  const destDir = path.join(__dirname, "bin-platform");
+  const binaryName = getBinaryName();
+  const binaryPath = path.join(destDir, binaryName);
+
+  // Skip if already downloaded
+  if (fs.existsSync(binaryPath)) {
+    console.log(`✓ veld binary already exists at ${binaryPath}`);
+    return;
+  }
+
+  console.log(`Downloading veld ${VERSION} for ${platformKey}...`);
+  console.log(`  ${url}`);
+
+  try {
+    const buffer = await download(url);
+
+    if (os.platform() === "win32") {
+      await extractZip(buffer, destDir);
+    } else {
+      await extractTarGz(buffer, destDir);
+    }
+
+    // Make binary executable on Unix
+    if (os.platform() !== "win32") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    if (fs.existsSync(binaryPath)) {
+      console.log(`✓ veld ${VERSION} installed successfully`);
+    } else {
+      throw new Error("Binary not found after extraction");
+    }
+  } catch (err) {
+    console.warn(`Warning: Could not download pre-built binary: ${err.message}`);
+    console.warn("");
+
+    if (await tryGoInstall()) return;
+
+    console.warn("Install veld manually:");
+    console.warn("  go install github.com/veld-dev/veld/cmd/veld@latest");
+    console.warn("");
+    console.warn("Or download from: https://github.com/veld-dev/veld/releases");
+  }
+}
+
+main();
+

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@maayn/veld",
+  "version": "0.1.1",
+  "description": "Contract-first, multi-stack API code generator. Write .veld contracts once, generate typed frontend SDKs and backend service interfaces.",
+  "keywords": [
+    "veld",
+    "api",
+    "code-generation",
+    "contract-first",
+    "typescript",
+    "sdk",
+    "schema"
+  ],
+  "homepage": "https://github.com/veld-dev/veld",
+  "bugs": {
+    "url": "https://github.com/veld-dev/veld/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/veld-dev/veld.git"
+  },
+  "license": "MIT",
+  "bin": {
+    "veld": "./bin/veld.js"
+  },
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "files": [
+    "bin/",
+    "install.js",
+    "README.md",
+    "LICENSE"
+  ]
+}