@vellora/native 0.1.0-alpha.0

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+/** The only platforms this phase ships prebuilds for. */
+export declare const SUPPORTED_PLATFORMS: readonly ["macOS arm64 (darwin-arm64)", "macOS x64 (darwin-x64)", "linux x64 glibc (linux-x64-gnu)", "linux arm64 glibc (linux-arm64-gnu)"];
+/**
+ * Host-tag → prebuild package map. Pre-enumerates the full intended matrix so adding a target later
+ * is purely additive (publish the package, flip its value from `null`): no loader-shape or consumer
+ * change. Published in the launch matrix: `darwin-arm64`, `darwin-x64`, `linux-x64-gnu`,
+ * `linux-arm64-gnu`. Reserved (no published package yet): `linux-x64-musl`, `linux-arm64-musl`.
+ */
+export declare const RESOLUTION_TABLE: Readonly<Record<string, string | null>>;
+/**
+ * Render options forwarded to `vellora-core`. Producer is fixed to `vellora`; only the document
+ * title and a deterministic creation date `[year, month, day]` (never wall-clock) are caller-supplied.
+ */
+export interface RenderOpts {
+    title?: string;
+    creationDate?: [number, number, number];
+}
+/** Surface of the native addon: the smoke export plus the async `render` binding. */
+export interface VelloraAddon {
+    coreName(): string;
+    render(html: Uint8Array, opts?: RenderOpts): Promise<Uint8Array>;
+    /** Test-only: forces a worker-thread panic to verify panic-to-rejection. Not a public API. */
+    __forcePanicForTest?(): Promise<void>;
+}
+/** napi-rs platform tag, e.g. `darwin-arm64`, `linux-x64-gnu`, `linux-arm64-musl`. */
+export declare function platformTag(platform?: string, arch?: string): string;
+/** Build the actionable error thrown when no compatible addon exists for the host. */
+export declare function unsupportedPlatformError(platform: string, arch: string, tag?: string): Error;
+/** Resolve and cache the host addon. Throws an actionable error on an unsupported platform. */
+export declare function addon(): VelloraAddon;
+/** Smoke export: proves the addon loads and is callable in-process. */
+export declare function coreName(): string;
+/**
+ * Render document HTML *content* bytes to a PDF on the libuv threadpool, off the Node main thread.
+ * `html` is always content (never a file path); the returned `Uint8Array` is JS-owned and starts
+ * with `%PDF-`. Rejects with an `Error` carrying the `vellora-core` diagnostic — for a located
+ * diagnostic the error also exposes `{ feature, line, col, hint }` as machine-readable properties.
+ */
+export declare function render(html: Uint8Array, opts?: RenderOpts): Promise<Uint8Array>;

package/dist/index.js

@@ -0,0 +1,105 @@
+/**
+ * @vellora/native — platform loader.
+ *
+ * Resolves the correct prebuilt napi-rs `.node` addon for the host (a locally built addon in dev,
+ * or a per-platform `optionalDependencies` package once published), and throws a clear, actionable
+ * error when no compatible addon is found. Re-exports the addon's async, thread-safe `render`
+ * function (libuv-threadpool, per-call isolated) unchanged.
+ */
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const require = createRequire(import.meta.url);
+// Both `src/` (vitest) and `dist/` (built) live one level under the package root, where the
+// locally built `.node` is emitted, so `..` resolves to the package dir in both cases.
+const PKG_DIR = join(dirname(fileURLToPath(import.meta.url)), "..");
+/** The only platforms this phase ships prebuilds for. */
+export const SUPPORTED_PLATFORMS = [
+    "macOS arm64 (darwin-arm64)",
+    "macOS x64 (darwin-x64)",
+    "linux x64 glibc (linux-x64-gnu)",
+    "linux arm64 glibc (linux-arm64-gnu)",
+];
+/**
+ * Host-tag → prebuild package map. Pre-enumerates the full intended matrix so adding a target later
+ * is purely additive (publish the package, flip its value from `null`): no loader-shape or consumer
+ * change. Published in the launch matrix: `darwin-arm64`, `darwin-x64`, `linux-x64-gnu`,
+ * `linux-arm64-gnu`. Reserved (no published package yet): `linux-x64-musl`, `linux-arm64-musl`.
+ */
+export const RESOLUTION_TABLE = {
+    "darwin-arm64": "@vellora/native-darwin-arm64",
+    "darwin-x64": "@vellora/native-darwin-x64",
+    "linux-x64-gnu": "@vellora/native-linux-x64-gnu",
+    "linux-arm64-gnu": "@vellora/native-linux-arm64-gnu",
+    // Reserved for a later phase: no published package yet (musl needs a native-musl build host).
+    "linux-x64-musl": null,
+    "linux-arm64-musl": null,
+};
+function isMusl() {
+    try {
+        const report = process.report?.getReport();
+        return !report?.header?.glibcVersionRuntime;
+    }
+    catch {
+        return false;
+    }
+}
+/** napi-rs platform tag, e.g. `darwin-arm64`, `linux-x64-gnu`, `linux-arm64-musl`. */
+export function platformTag(platform = process.platform, arch = process.arch) {
+    if (platform === "linux") {
+        return `linux-${arch}-${isMusl() ? "musl" : "gnu"}`;
+    }
+    return `${platform}-${arch}`;
+}
+/** Build the actionable error thrown when no compatible addon exists for the host. */
+export function unsupportedPlatformError(platform, arch, tag = platformTag(platform, arch)) {
+    const windowsNote = platform === "win32"
+        ? "\nWindows is not supported yet — prebuilt Windows binaries are a planned fast-follow."
+        : "";
+    return new Error(`@vellora/native: no compatible prebuilt addon for ${platform}-${arch} (resolved tag "${tag}").
+Supported platforms: ${SUPPORTED_PLATFORMS.join(", ")}.${windowsNote}
+To build locally, install the Rust toolchain and run \`npm run build\` at the repo root (which runs \`napi build\` for the vellora-napi crate).`);
+}
+function loadAddon() {
+    const tag = platformTag();
+    // 1) Dev: a locally built `.node` next to the package takes precedence.
+    const localPath = join(PKG_DIR, `vellora.${tag}.node`);
+    if (existsSync(localPath)) {
+        return require(localPath);
+    }
+    // 2) Published: resolve the matching prebuild package via the resolution table. Only the
+    // host-matching entry is required; a missing sibling optional package must not break the load.
+    const pkg = RESOLUTION_TABLE[tag];
+    if (pkg) {
+        try {
+            return require(pkg);
+        }
+        catch {
+            // The optional prebuild package is absent on this host; fall through to the actionable error.
+        }
+    }
+    throw unsupportedPlatformError(process.platform, process.arch, tag);
+}
+let cached;
+/** Resolve and cache the host addon. Throws an actionable error on an unsupported platform. */
+export function addon() {
+    if (!cached) {
+        cached = loadAddon();
+    }
+    return cached;
+}
+/** Smoke export: proves the addon loads and is callable in-process. */
+export function coreName() {
+    return addon().coreName();
+}
+/**
+ * Render document HTML *content* bytes to a PDF on the libuv threadpool, off the Node main thread.
+ * `html` is always content (never a file path); the returned `Uint8Array` is JS-owned and starts
+ * with `%PDF-`. Rejects with an `Error` carrying the `vellora-core` diagnostic — for a located
+ * diagnostic the error also exposes `{ feature, line, col, hint }` as machine-readable properties.
+ */
+export function render(html, opts) {
+    return addon().render(html, opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "@vellora/native",
+  "version": "0.1.0-alpha.0",
+  "description": "Prebuilt napi-rs addon loader for vellora — alpha.",
+  "keywords": [
+    "html-to-pdf",
+    "pdf",
+    "pdf-generation",
+    "invoice",
+    "boleto",
+    "receipt",
+    "pdfa",
+    "pdfua",
+    "tagged-pdf",
+    "no-puppeteer",
+    "no-chromium",
+    "serverless",
+    "wkhtmltopdf-alternative",
+    "napi-rs",
+    "nodejs"
+  ],
+  "homepage": "https://github.com/diomalta/vellora#readme",
+  "bugs": "https://github.com/diomalta/vellora/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/diomalta/vellora.git",
+    "directory": "packages/native"
+  },
+  "license": "MIT",
+  "author": "Diego Malta <diohmalta@gmail.com>",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "sideEffects": false,
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "THIRD-PARTY-NOTICES.md",
+    "LICENSE-DejaVu.txt"
+  ],
+  "napi": {
+    "binaryName": "vellora",
+    "targets": [
+      "aarch64-apple-darwin",
+      "x86_64-apple-darwin",
+      "x86_64-unknown-linux-gnu",
+      "aarch64-unknown-linux-gnu",
+      "x86_64-unknown-linux-musl"
+    ]
+  },
+  "scripts": {
+    "build:addon": "napi build --release --platform --manifest-path ../../crates/vellora-napi/Cargo.toml --output-dir . --no-js",
+    "build": "tsc"
+  },
+  "optionalDependencies": {
+    "@vellora/native-darwin-arm64": "0.1.0-alpha.0",
+    "@vellora/native-darwin-x64": "0.1.0-alpha.0",
+    "@vellora/native-linux-x64-gnu": "0.1.0-alpha.0",
+    "@vellora/native-linux-arm64-gnu": "0.1.0-alpha.0",
+    "@vellora/native-linux-x64-musl": "0.1.0-alpha.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}