@effing/ffmpeg 0.4.0

package/README.md

@@ -0,0 +1,36 @@
+# @effing/ffmpeg
+
+FFmpeg binary downloader for the Effing monorepo. Downloads a platform-specific FFmpeg binary at install time from the [ffmpeg-static](https://github.com/eugeneware/ffmpeg-static) GitHub releases (currently tag **b6.0**, FFmpeg 6.0).
+
+## Usage
+
+```ts
+import { pathToFFmpeg } from "@effing/ffmpeg";
+
+// pathToFFmpeg is the absolute path to the binary, or null on unsupported platforms
+```
+
+## How it works
+
+The `install` lifecycle script (`node install.mjs`) runs during `pnpm install` and:
+
+1. Detects the current platform and architecture
+2. Skips the download if the binary already exists
+3. Downloads the gzipped binary from GitHub releases
+4. Decompresses it and sets executable permissions
+
+The binary is placed in the package root (`packages/ffmpeg/ffmpeg`). In the monorepo, pnpm symlinks mean all workspace consumers share the same binary.
+
+## Supported platforms
+
+| Platform | Architectures         |
+| -------- | --------------------- |
+| darwin   | x64, arm64            |
+| linux    | x64, ia32, arm64, arm |
+| win32    | x64, ia32             |
+
+## Environment variables
+
+| Variable              | Description                                                                               |
+| --------------------- | ----------------------------------------------------------------------------------------- |
+| `FFMPEG_BINARIES_URL` | Override the base URL for binary downloads (defaults to the ffmpeg-static GitHub release) |

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+declare const pathToFFmpeg: string | null;
+
+export { pathToFFmpeg };

package/dist/index.js

@@ -0,0 +1,25 @@
+// src/index.ts
+import os from "os";
+import path from "path";
+import { fileURLToPath } from "url";
+var __dirname = path.dirname(fileURLToPath(import.meta.url));
+var SUPPORTED = /* @__PURE__ */ new Set([
+  "darwin-x64",
+  "darwin-arm64",
+  "linux-x64",
+  "linux-ia32",
+  "linux-arm64",
+  "linux-arm",
+  "win32-x64",
+  "win32-ia32"
+]);
+var platform = os.platform();
+var arch = os.arch();
+var key = `${platform}-${arch}`;
+var binaryName = platform === "win32" ? "ffmpeg.exe" : "ffmpeg";
+var ffmpegPath = SUPPORTED.has(key) ? path.join(__dirname, "..", binaryName) : null;
+var pathToFFmpeg = ffmpegPath;
+export {
+  pathToFFmpeg
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import os from \"node:os\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst __dirname = path.dirname(fileURLToPath(import.meta.url));\n\nconst SUPPORTED = new Set([\n  \"darwin-x64\",\n  \"darwin-arm64\",\n  \"linux-x64\",\n  \"linux-ia32\",\n  \"linux-arm64\",\n  \"linux-arm\",\n  \"win32-x64\",\n  \"win32-ia32\",\n]);\n\nconst platform = os.platform();\nconst arch = os.arch();\nconst key = `${platform}-${arch}`;\n\nconst binaryName = platform === \"win32\" ? \"ffmpeg.exe\" : \"ffmpeg\";\n\nconst ffmpegPath: string | null = SUPPORTED.has(key)\n  ? path.join(__dirname, \"..\", binaryName)\n  : null;\n\nexport const pathToFFmpeg = ffmpegPath;\n"],"mappings":";AAAA,OAAO,QAAQ;AACf,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAE9B,IAAM,YAAY,KAAK,QAAQ,cAAc,YAAY,GAAG,CAAC;AAE7D,IAAM,YAAY,oBAAI,IAAI;AAAA,EACxB;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,CAAC;AAED,IAAM,WAAW,GAAG,SAAS;AAC7B,IAAM,OAAO,GAAG,KAAK;AACrB,IAAM,MAAM,GAAG,QAAQ,IAAI,IAAI;AAE/B,IAAM,aAAa,aAAa,UAAU,eAAe;AAEzD,IAAM,aAA4B,UAAU,IAAI,GAAG,IAC/C,KAAK,KAAK,WAAW,MAAM,UAAU,IACrC;AAEG,IAAM,eAAe;","names":[]}

package/install.mjs

@@ -0,0 +1,103 @@
+import { createWriteStream } from "node:fs";
+import { access, chmod } from "node:fs/promises";
+import https from "node:https";
+import os from "node:os";
+import path from "node:path";
+import { pipeline } from "node:stream/promises";
+import { fileURLToPath } from "node:url";
+import zlib from "node:zlib";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+const PLATFORM_MAP = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "win32",
+};
+
+const ARCH_MAP = {
+  x64: "x64",
+  ia32: "ia32",
+  arm64: "arm64",
+  arm: "arm",
+};
+
+const SUPPORTED = new Set([
+  "darwin-x64",
+  "darwin-arm64",
+  "linux-x64",
+  "linux-ia32",
+  "linux-arm64",
+  "linux-arm",
+  "win32-x64",
+  "win32-ia32",
+]);
+
+const platform = PLATFORM_MAP[os.platform()];
+const arch = ARCH_MAP[os.arch()];
+
+if (!platform || !arch || !SUPPORTED.has(`${platform}-${arch}`)) {
+  console.warn(
+    `@effing/ffmpeg: unsupported platform ${os.platform()}-${os.arch()}, skipping binary download`,
+  );
+  process.exit(0);
+}
+
+const binaryName = platform === "win32" ? "ffmpeg.exe" : "ffmpeg";
+const binaryPath = path.join(__dirname, binaryName);
+
+// Skip if binary already exists
+try {
+  await access(binaryPath);
+  console.log(`@effing/ffmpeg: binary already exists at ${binaryPath}`);
+  process.exit(0);
+} catch {
+  // Binary doesn't exist, proceed with download
+}
+
+const baseUrl =
+  process.env.FFMPEG_BINARIES_URL ||
+  "https://github.com/eugeneware/ffmpeg-static/releases/download/b6.0";
+
+const url = `${baseUrl}/ffmpeg-${platform}-${arch}.gz`;
+
+console.log(`@effing/ffmpeg: downloading ffmpeg from ${url}`);
+
+/**
+ * Follow redirects (GitHub releases redirect to S3/CDN).
+ * Returns a readable response stream.
+ */
+function get(url, redirects = 0) {
+  if (redirects > 5) {
+    throw new Error("Too many redirects");
+  }
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          res.resume(); // discard body
+          resolve(get(res.headers.location, redirects + 1));
+        } else if (res.statusCode !== 200) {
+          res.resume();
+          reject(new Error(`Download failed: HTTP ${res.statusCode} for ${url}`));
+        } else {
+          resolve(res);
+        }
+      })
+      .on("error", reject);
+  });
+}
+
+try {
+  const response = await get(url);
+  const gunzip = zlib.createGunzip();
+  const file = createWriteStream(binaryPath);
+
+  await pipeline(response, gunzip, file);
+  await chmod(binaryPath, 0o755);
+
+  console.log(`@effing/ffmpeg: binary installed to ${binaryPath}`);
+} catch (err) {
+  console.error(`@effing/ffmpeg: failed to download binary: ${err.message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@effing/ffmpeg",
+  "version": "0.4.0",
+  "description": "FFmpeg binary downloader for Effing",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "install.mjs"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "install": "node install.mjs"
+  },
+  "devDependencies": {
+    "tsup": "catalog:",
+    "typescript": "catalog:"
+  },
+  "keywords": [
+    "ffmpeg",
+    "binary"
+  ],
+  "license": "O'Saasy",
+  "publishConfig": {
+    "access": "public"
+  }
+}