pdfnative-cli - npm Package Compare versions

Comparing version

0.0.1

0.1.0

+555

dist/cli.cjs

		#!/usr/bin/env node
		'use strict';

		var pdfnative = require('pdfnative');
		var fs = require('fs');
		var promises = require('fs/promises');
		var module$1 = require('module');

		var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
		var __defProp = Object.defineProperty;
		var __getOwnPropNames = Object.getOwnPropertyNames;
		var __esm = (fn, res) => function __init() {
		return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
		};
		var __export = (target, all) => {
		for (var name in all)
		__defProp(target, name, { get: all[name], enumerable: true });
		};

		// src/utils/error.ts
		var CliError;
		var init_error = __esm({
		"src/utils/error.ts"() {
		CliError = class extends Error {
		exitCode;
		constructor(message, exitCode = 1) {
		super(message);
		this.name = "CliError";
		this.exitCode = exitCode;
		}
		};
		}
		});

		// src/utils/args.ts
		function parseArgs(argv) {
		const flags = {};
		const positionals = [];
		let i = 0;
		while (i < argv.length) {
		const token = argv[i];
		if (token === "--") {
		i++;
		while (i < argv.length) {
		positionals.push(argv[i]);
		i++;
		}
		break;
		}
		if (token.startsWith("--")) {
		const eqIdx = token.indexOf("=");
		if (eqIdx !== -1) {
		const key = token.slice(2, eqIdx);
		const value = token.slice(eqIdx + 1);
		flags[key] = value;
		} else {
		const key = token.slice(2);
		const next = argv[i + 1];
		if (next !== void 0 && !next.startsWith("-")) {
		flags[key] = next;
		i++;
		} else {
		flags[key] = true;
		}
		}
		} else if (token.startsWith("-") && token.length === 2) {
		const key = token.slice(1);
		const next = argv[i + 1];
		if (next !== void 0 && !next.startsWith("-")) {
		flags[key] = next;
		i++;
		} else {
		flags[key] = true;
		}
		} else {
		positionals.push(token);
		}
		i++;
		}
		return { flags, positionals };
		}
		function getStringFlag(flags, ...names) {
		for (const name of names) {
		const value = flags[name];
		if (value !== void 0) {
		if (typeof value !== "string") {
		throw new CliError(`Flag --${name} requires a value.`, 2);
		}
		return value;
		}
		}
		return void 0;
		}
		function hasFlag(flags, ...names) {
		return names.some((n) => flags[n] !== void 0);
		}
		var init_args = __esm({
		"src/utils/args.ts"() {
		init_error();
		}
		});
		var init_core_bridge = __esm({
		"src/core-bridge/index.ts"() {
		}
		});
		function validatePath(filePath) {
		const normalised = filePath.replace(/\\/g, "/");
		if (normalised.includes("../") \|\| normalised === "..") {
		throw new CliError(`Path traversal detected in path: ${filePath}`, 1);
		}
		}
		function readStdin() {
		return new Promise((resolve, reject) => {
		const chunks = [];
		process.stdin.on("data", (chunk) => chunks.push(chunk));
		process.stdin.on("end", () => resolve(Buffer.concat(chunks)));
		process.stdin.on("error", reject);
		});
		}
		async function readFileOrStdin(filePath) {
		if (filePath === void 0) {
		return readStdin();
		}
		validatePath(filePath);
		return promises.readFile(filePath);
		}
		function assertJsonSizeLimit(buf) {
		if (buf.length > JSON_SIZE_LIMIT) {
		throw new CliError(
		`JSON input exceeds the 50 MB limit (got ${(buf.length / 1024 / 1024).toFixed(1)} MB).`,
		1
		);
		}
		}
		async function writeOutput(data, filePath) {
		if (filePath === void 0) {
		await new Promise((resolve, reject) => {
		process.stdout.write(data, (err) => {
		if (err) reject(err);
		else resolve();
		});
		});
		return;
		}
		validatePath(filePath);
		await promises.writeFile(filePath, data);
		}
		async function writeStreamingOutput(chunks, filePath) {
		if (filePath === void 0) {
		for await (const chunk of chunks) {
		await new Promise((resolve, reject) => {
		process.stdout.write(chunk, (err) => {
		if (err) reject(err);
		else resolve();
		});
		});
		}
		return;
		}
		validatePath(filePath);
		const stream = fs.createWriteStream(filePath);
		await new Promise((resolve, reject) => {
		stream.on("error", reject);
		stream.on("finish", resolve);
		(async () => {
		for await (const chunk of chunks) {
		const ok = stream.write(chunk);
		if (!ok) {
		await new Promise((r) => stream.once("drain", r));
		}
		}
		stream.end();
		})().catch(reject);
		});
		}
		var JSON_SIZE_LIMIT;
		var init_io = __esm({
		"src/utils/io.ts"() {
		init_error();
		JSON_SIZE_LIMIT = 50 * 1024 * 1024;
		}
		});

		// src/commands/render.ts
		var render_exports = {};
		__export(render_exports, {
		render: () => render
		});
		async function render(args) {
		const inputPath = getStringFlag(args.flags, "input", "i");
		const outputPath = getStringFlag(args.flags, "output", "o");
		const useStream = hasFlag(args.flags, "stream");
		const conformance = getStringFlag(args.flags, "conformance");
		if (conformance !== void 0 && !VALID_CONFORMANCE.has(conformance)) {
		throw new CliError(
		`Invalid --conformance value "${conformance}". Valid values: 1b, 2b, 3b.`,
		2
		);
		}
		const inputBuf = await readFileOrStdin(inputPath);
		assertJsonSizeLimit(inputBuf);
		let params;
		try {
		params = JSON.parse(inputBuf.toString("utf8"));
		} catch (e) {
		const message = e instanceof Error ? e.message : String(e);
		throw new CliError(`Failed to parse JSON input: ${message}`, 1);
		}
		if (typeof params !== "object" \|\| params === null) {
		throw new CliError("JSON input must be a DocumentParams object.", 1);
		}
		if (conformance !== void 0) {
		params["pdfaConformance"] = conformance;
		}
		if (useStream) {
		const generator = pdfnative.buildDocumentPDFStream(params);
		await writeStreamingOutput(generator, outputPath);
		} else {
		const pdfBytes = pdfnative.buildDocumentPDFBytes(params);
		await writeOutput(pdfBytes, outputPath);
		}
		}
		var VALID_CONFORMANCE;
		var init_render = __esm({
		"src/commands/render.ts"() {
		init_core_bridge();
		init_args();
		init_io();
		init_error();
		VALID_CONFORMANCE = /* @__PURE__ */ new Set(["1b", "2b", "3b"]);
		}
		});

		// src/commands/sign.ts
		var sign_exports = {};
		__export(sign_exports, {
		sign: () => sign
		});
		function pemToDer(pem) {
		const body = pem.replace(/-----BEGIN [^-]+-----/g, "").replace(/-----END [^-]+-----/g, "").replace(/\s+/g, "");
		const binaryStr = atob(body);
		const bytes = new Uint8Array(binaryStr.length);
		for (let i = 0; i < binaryStr.length; i++) {
		bytes[i] = binaryStr.charCodeAt(i);
		}
		return bytes;
		}
		async function loadPem(envVar, filePath, label) {
		const fromEnv = process.env[envVar];
		if (fromEnv !== void 0 && fromEnv.trim().length > 0) {
		return fromEnv;
		}
		if (filePath !== void 0) {
		validatePath(filePath);
		const buf = await promises.readFile(filePath, "utf8");
		return buf;
		}
		throw new CliError(
		`Missing ${label}. Provide $${envVar} (env) or --${label.replace(/ /g, "-")} <path>.`,
		2
		);
		}
		async function sign(args) {
		const inputPath = getStringFlag(args.flags, "input", "i");
		const outputPath = getStringFlag(args.flags, "output", "o");
		const keyPath = getStringFlag(args.flags, "key");
		const certPath = getStringFlag(args.flags, "cert");
		const pdfBuf = await readFileOrStdin(inputPath);
		const pdfBytes = new Uint8Array(pdfBuf);
		const privateKeyPem = await loadPem("PDFNATIVE_SIGN_KEY", keyPath, "private key");
		const certPem = await loadPem("PDFNATIVE_SIGN_CERT", certPath, "certificate");
		let options;
		try {
		const keyDer = pemToDer(privateKeyPem);
		const certDer = pemToDer(certPem);
		const rsaKey = pdfnative.parseRsaPrivateKey(keyDer);
		const signerCert = pdfnative.parseCertificate(certDer);
		options = { rsaKey, signerCert, algorithm: "rsa-sha256" };
		} catch {
		throw new CliError("Failed to parse signing credentials. Verify key and certificate are valid PEM-encoded files.", 1);
		}
		const signedBytes = pdfnative.signPdfBytes(pdfBytes, options);
		await writeOutput(signedBytes, outputPath);
		}
		var init_sign = __esm({
		"src/commands/sign.ts"() {
		init_core_bridge();
		init_args();
		init_io();
		init_error();
		}
		});

		// src/commands/inspect.ts
		var inspect_exports = {};
		__export(inspect_exports, {
		inspect: () => inspect
		});
		function safeInfoString(value) {
		if (typeof value !== "string") return null;
		const trimmed = value.trim();
		if (trimmed.startsWith("(") && trimmed.endsWith(")")) {
		return trimmed.slice(1, -1);
		}
		if (/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/.test(trimmed)) {
		return null;
		}
		return trimmed \|\| null;
		}
		function extractVersion(reader) {
		const header = new TextDecoder("ascii", { fatal: false }).decode(
		reader.bytes.slice(0, 20)
		);
		const match = /^%PDF-(\d+\.\d+)/.exec(header);
		return match !== null ? match[1] : "unknown";
		}
		function extractEncrypted(reader) {
		const trailer = reader.trailer;
		return trailer.get("Encrypt") !== void 0;
		}
		function extractPdfaConformance(reader) {
		try {
		const catalog = reader.getCatalog();
		const metaRef = catalog.get("Metadata");
		if (metaRef === void 0) return null;
		const metaObj = reader.resolveValue(metaRef);
		if (typeof metaObj !== "object" \|\| metaObj === null \|\| !("streamData" in metaObj)) {
		return null;
		}
		const decoded = reader.decodeStream(
		metaObj
		);
		const xmp = new TextDecoder("utf-8", { fatal: false }).decode(decoded);
		const partMatch = /pdfaid:part[^>]*>(\d+)</.exec(xmp);
		const confMatch = /pdfaid:conformance[^>]*>([A-Za-z]+)</.exec(xmp);
		if (partMatch !== null && confMatch !== null) {
		return `${partMatch[1]}${confMatch[1].toLowerCase()}`;
		}
		} catch {
		}
		return null;
		}
		function countSignatures(reader) {
		try {
		const catalog = reader.getCatalog();
		const acroRef = catalog.get("AcroForm");
		if (acroRef === void 0) return 0;
		const acro = reader.resolveValue(acroRef);
		if (!(acro instanceof Map)) return 0;
		const fieldsVal = acro.get("Fields");
		if (!Array.isArray(fieldsVal)) return 0;
		let count = 0;
		for (const ref of fieldsVal) {
		const field = reader.resolveValue(ref);
		if (field instanceof Map && field.get("FT") === "/Sig") {
		count++;
		}
		}
		return count;
		} catch {
		return 0;
		}
		}
		async function inspect(args) {
		const inputPath = getStringFlag(args.flags, "input", "i");
		const format = getStringFlag(args.flags, "format", "f") ?? "json";
		if (format !== "json" && format !== "text") {
		throw new CliError(`Invalid --format value "${format}". Valid values: json, text.`, 2);
		}
		const inputBuf = await readFileOrStdin(inputPath);
		const pdfBytes = new Uint8Array(inputBuf);
		let reader;
		try {
		reader = pdfnative.openPdf(pdfBytes);
		} catch (e) {
		const message = e instanceof Error ? e.message : String(e);
		throw new CliError(`Failed to read PDF: ${message}`, 1);
		}
		const info = reader.getInfo();
		const result = {
		version: extractVersion(reader),
		pageCount: reader.pageCount,
		encrypted: extractEncrypted(reader),
		pdfaConformance: extractPdfaConformance(reader),
		signatures: countSignatures(reader),
		metadata: {
		title: info !== null ? safeInfoString(info.get("Title")) : null,
		author: info !== null ? safeInfoString(info.get("Author")) : null,
		creationDate: info !== null ? safeInfoString(info.get("CreationDate")) : null,
		subject: info !== null ? safeInfoString(info.get("Subject")) : null,
		producer: info !== null ? safeInfoString(info.get("Producer")) : null
		}
		};
		if (format === "json") {
		process.stdout.write(JSON.stringify(result, null, 2) + "\n");
		} else {
		const lines = [
		`Version: ${result.version}`,
		`Pages: ${result.pageCount}`,
		`Encrypted: ${result.encrypted ? "yes" : "no"}`,
		`PDF/A: ${result.pdfaConformance ?? "none"}`,
		`Signatures: ${result.signatures}`,
		`Title: ${result.metadata.title ?? "\u2014"}`,
		`Author: ${result.metadata.author ?? "\u2014"}`,
		`Created: ${result.metadata.creationDate ?? "\u2014"}`,
		`Subject: ${result.metadata.subject ?? "\u2014"}`,
		`Producer: ${result.metadata.producer ?? "\u2014"}`
		];
		process.stdout.write(lines.join("\n") + "\n");
		}
		}
		var init_inspect = __esm({
		"src/commands/inspect.ts"() {
		init_core_bridge();
		init_args();
		init_io();
		init_error();
		}
		});

		// src/index.ts
		init_args();
		init_error();
		var USAGE = `pdfnative-cli \u2014 Official CLI for pdfnative

		Usage:
		pdfnative <command> [options]

		Commands:
		render Render a JSON document definition to PDF
		sign Apply a digital signature to an existing PDF
		inspect Analyse a PDF and output metadata / conformance info

		Options:
		--help, -h Show this help message
		--version, -V Show version

		Run \`pdfnative <command> --help\` for per-command options.
		`;
		var RENDER_USAGE = `pdfnative render \u2014 Render a JSON DocumentParams to PDF

		Usage:
		pdfnative render [--input <file.json>] [--output <out.pdf>] [--stream] [--conformance <level>]

		Options:
		--input, -i Path to JSON input file (default: stdin)
		--output, -o Output PDF path (default: stdout)
		--stream Use streaming output for large documents
		--conformance PDF/A conformance level: 1b, 2b, or 3b
		--help, -h Show this help message
		`;
		var SIGN_USAGE = `pdfnative sign \u2014 Apply a digital signature to an existing PDF

		Usage:
		pdfnative sign [--input <file.pdf>] [--output <out.pdf>] [--key <key.pem>] [--cert <cert.pem>]

		Options:
		--input, -i Path to input PDF (default: stdin)
		--output, -o Signed PDF output path (default: stdout)
		--key Path to PEM private key file
		(overridden by $PDFNATIVE_SIGN_KEY env var)
		--cert Path to PEM certificate file
		(overridden by $PDFNATIVE_SIGN_CERT env var)
		--help, -h Show this help message

		Security: $PDFNATIVE_SIGN_KEY and $PDFNATIVE_SIGN_CERT env vars take precedence over file flags.
		`;
		var INSPECT_USAGE = `pdfnative inspect \u2014 Analyse a PDF and output metadata

		Usage:
		pdfnative inspect [--input <file.pdf>] [--format <fmt>]

		Options:
		--input, -i Path to input PDF (default: stdin)
		--format, -f Output format: json (default) or text
		--help, -h Show this help message
		`;
		function getVersion() {
		const require2 = module$1.createRequire((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src \|\| new URL('cli.cjs', document.baseURI).href)));
		const pkg = require2("../package.json");
		return pkg.version;
		}
		async function loadCommand(name) {
		switch (name) {
		case "render": {
		const m = await Promise.resolve().then(() => (init_render(), render_exports));
		return m.render;
		}
		case "sign": {
		const m = await Promise.resolve().then(() => (init_sign(), sign_exports));
		return m.sign;
		}
		case "inspect": {
		const m = await Promise.resolve().then(() => (init_inspect(), inspect_exports));
		return m.inspect;
		}
		default:
		return Promise.reject(new CliError(`Unknown command: ${name}. Run pdfnative --help for usage.`, 1));
		}
		}
		async function main() {
		const argv = process.argv.slice(2);
		const args = parseArgs(argv);
		if (hasFlag(args.flags, "help", "h") && args.positionals.length === 0) {
		process.stdout.write(USAGE);
		process.exit(0);
		}
		if (hasFlag(args.flags, "version", "V")) {
		process.stdout.write(getVersion() + "\n");
		process.exit(0);
		}
		const commandName = args.positionals[0];
		if (commandName === void 0) {
		process.stdout.write(USAGE);
		process.exit(0);
		}
		if (hasFlag(args.flags, "help", "h")) {
		switch (commandName) {
		case "render":
		process.stdout.write(RENDER_USAGE);
		break;
		case "sign":
		process.stdout.write(SIGN_USAGE);
		break;
		case "inspect":
		process.stdout.write(INSPECT_USAGE);
		break;
		default:
		process.stderr.write(`Unknown command: ${commandName}. Run pdfnative --help for usage.
		`);
		process.exit(1);
		}
		process.exit(0);
		}
		const commandArgs = parseArgs(argv.filter((_t, _i) => {
		if (_t === commandName && args.positionals[0] === commandName) {
		return false;
		}
		return true;
		}));
		const command = await loadCommand(commandName);
		await command(commandArgs);
		}
		main().catch((e) => {
		if (e instanceof CliError) {
		process.stderr.write(e.message + "\n");
		process.exit(e.exitCode);
		}
		const message = e instanceof Error ? e.message : String(e);
		process.stderr.write(`Error: ${message}
		`);
		process.exit(1);
		});
		//# sourceMappingURL=cli.cjs.map
		//# sourceMappingURL=cli.cjs.map

+1

dist/cli.cjs.map

+2

dist/cli.d.cts


		export { }

+2

dist/cli.d.ts


		export { }

+552

dist/cli.js

		#!/usr/bin/env node
		import { buildDocumentPDFStream, buildDocumentPDFBytes, parseRsaPrivateKey, parseCertificate, signPdfBytes, openPdf } from 'pdfnative';
		import { createWriteStream } from 'fs';
		import { readFile, writeFile } from 'fs/promises';
		import { createRequire } from 'module';

		var __defProp = Object.defineProperty;
		var __getOwnPropNames = Object.getOwnPropertyNames;
		var __esm = (fn, res) => function __init() {
		return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
		};
		var __export = (target, all) => {
		for (var name in all)
		__defProp(target, name, { get: all[name], enumerable: true });
		};

		// src/utils/error.ts
		var CliError;
		var init_error = __esm({
		"src/utils/error.ts"() {
		CliError = class extends Error {
		exitCode;
		constructor(message, exitCode = 1) {
		super(message);
		this.name = "CliError";
		this.exitCode = exitCode;
		}
		};
		}
		});

		// src/utils/args.ts
		function parseArgs(argv) {
		const flags = {};
		const positionals = [];
		let i = 0;
		while (i < argv.length) {
		const token = argv[i];
		if (token === "--") {
		i++;
		while (i < argv.length) {
		positionals.push(argv[i]);
		i++;
		}
		break;
		}
		if (token.startsWith("--")) {
		const eqIdx = token.indexOf("=");
		if (eqIdx !== -1) {
		const key = token.slice(2, eqIdx);
		const value = token.slice(eqIdx + 1);
		flags[key] = value;
		} else {
		const key = token.slice(2);
		const next = argv[i + 1];
		if (next !== void 0 && !next.startsWith("-")) {
		flags[key] = next;
		i++;
		} else {
		flags[key] = true;
		}
		}
		} else if (token.startsWith("-") && token.length === 2) {
		const key = token.slice(1);
		const next = argv[i + 1];
		if (next !== void 0 && !next.startsWith("-")) {
		flags[key] = next;
		i++;
		} else {
		flags[key] = true;
		}
		} else {
		positionals.push(token);
		}
		i++;
		}
		return { flags, positionals };
		}
		function getStringFlag(flags, ...names) {
		for (const name of names) {
		const value = flags[name];
		if (value !== void 0) {
		if (typeof value !== "string") {
		throw new CliError(`Flag --${name} requires a value.`, 2);
		}
		return value;
		}
		}
		return void 0;
		}
		function hasFlag(flags, ...names) {
		return names.some((n) => flags[n] !== void 0);
		}
		var init_args = __esm({
		"src/utils/args.ts"() {
		init_error();
		}
		});
		var init_core_bridge = __esm({
		"src/core-bridge/index.ts"() {
		}
		});
		function validatePath(filePath) {
		const normalised = filePath.replace(/\\/g, "/");
		if (normalised.includes("../") \|\| normalised === "..") {
		throw new CliError(`Path traversal detected in path: ${filePath}`, 1);
		}
		}
		function readStdin() {
		return new Promise((resolve, reject) => {
		const chunks = [];
		process.stdin.on("data", (chunk) => chunks.push(chunk));
		process.stdin.on("end", () => resolve(Buffer.concat(chunks)));
		process.stdin.on("error", reject);
		});
		}
		async function readFileOrStdin(filePath) {
		if (filePath === void 0) {
		return readStdin();
		}
		validatePath(filePath);
		return readFile(filePath);
		}
		function assertJsonSizeLimit(buf) {
		if (buf.length > JSON_SIZE_LIMIT) {
		throw new CliError(
		`JSON input exceeds the 50 MB limit (got ${(buf.length / 1024 / 1024).toFixed(1)} MB).`,
		1
		);
		}
		}
		async function writeOutput(data, filePath) {
		if (filePath === void 0) {
		await new Promise((resolve, reject) => {
		process.stdout.write(data, (err) => {
		if (err) reject(err);
		else resolve();
		});
		});
		return;
		}
		validatePath(filePath);
		await writeFile(filePath, data);
		}
		async function writeStreamingOutput(chunks, filePath) {
		if (filePath === void 0) {
		for await (const chunk of chunks) {
		await new Promise((resolve, reject) => {
		process.stdout.write(chunk, (err) => {
		if (err) reject(err);
		else resolve();
		});
		});
		}
		return;
		}
		validatePath(filePath);
		const stream = createWriteStream(filePath);
		await new Promise((resolve, reject) => {
		stream.on("error", reject);
		stream.on("finish", resolve);
		(async () => {
		for await (const chunk of chunks) {
		const ok = stream.write(chunk);
		if (!ok) {
		await new Promise((r) => stream.once("drain", r));
		}
		}
		stream.end();
		})().catch(reject);
		});
		}
		var JSON_SIZE_LIMIT;
		var init_io = __esm({
		"src/utils/io.ts"() {
		init_error();
		JSON_SIZE_LIMIT = 50 * 1024 * 1024;
		}
		});

		// src/commands/render.ts
		var render_exports = {};
		__export(render_exports, {
		render: () => render
		});
		async function render(args) {
		const inputPath = getStringFlag(args.flags, "input", "i");
		const outputPath = getStringFlag(args.flags, "output", "o");
		const useStream = hasFlag(args.flags, "stream");
		const conformance = getStringFlag(args.flags, "conformance");
		if (conformance !== void 0 && !VALID_CONFORMANCE.has(conformance)) {
		throw new CliError(
		`Invalid --conformance value "${conformance}". Valid values: 1b, 2b, 3b.`,
		2
		);
		}
		const inputBuf = await readFileOrStdin(inputPath);
		assertJsonSizeLimit(inputBuf);
		let params;
		try {
		params = JSON.parse(inputBuf.toString("utf8"));
		} catch (e) {
		const message = e instanceof Error ? e.message : String(e);
		throw new CliError(`Failed to parse JSON input: ${message}`, 1);
		}
		if (typeof params !== "object" \|\| params === null) {
		throw new CliError("JSON input must be a DocumentParams object.", 1);
		}
		if (conformance !== void 0) {
		params["pdfaConformance"] = conformance;
		}
		if (useStream) {
		const generator = buildDocumentPDFStream(params);
		await writeStreamingOutput(generator, outputPath);
		} else {
		const pdfBytes = buildDocumentPDFBytes(params);
		await writeOutput(pdfBytes, outputPath);
		}
		}
		var VALID_CONFORMANCE;
		var init_render = __esm({
		"src/commands/render.ts"() {
		init_core_bridge();
		init_args();
		init_io();
		init_error();
		VALID_CONFORMANCE = /* @__PURE__ */ new Set(["1b", "2b", "3b"]);
		}
		});

		// src/commands/sign.ts
		var sign_exports = {};
		__export(sign_exports, {
		sign: () => sign
		});
		function pemToDer(pem) {
		const body = pem.replace(/-----BEGIN [^-]+-----/g, "").replace(/-----END [^-]+-----/g, "").replace(/\s+/g, "");
		const binaryStr = atob(body);
		const bytes = new Uint8Array(binaryStr.length);
		for (let i = 0; i < binaryStr.length; i++) {
		bytes[i] = binaryStr.charCodeAt(i);
		}
		return bytes;
		}
		async function loadPem(envVar, filePath, label) {
		const fromEnv = process.env[envVar];
		if (fromEnv !== void 0 && fromEnv.trim().length > 0) {
		return fromEnv;
		}
		if (filePath !== void 0) {
		validatePath(filePath);
		const buf = await readFile(filePath, "utf8");
		return buf;
		}
		throw new CliError(
		`Missing ${label}. Provide $${envVar} (env) or --${label.replace(/ /g, "-")} <path>.`,
		2
		);
		}
		async function sign(args) {
		const inputPath = getStringFlag(args.flags, "input", "i");
		const outputPath = getStringFlag(args.flags, "output", "o");
		const keyPath = getStringFlag(args.flags, "key");
		const certPath = getStringFlag(args.flags, "cert");
		const pdfBuf = await readFileOrStdin(inputPath);
		const pdfBytes = new Uint8Array(pdfBuf);
		const privateKeyPem = await loadPem("PDFNATIVE_SIGN_KEY", keyPath, "private key");
		const certPem = await loadPem("PDFNATIVE_SIGN_CERT", certPath, "certificate");
		let options;
		try {
		const keyDer = pemToDer(privateKeyPem);
		const certDer = pemToDer(certPem);
		const rsaKey = parseRsaPrivateKey(keyDer);
		const signerCert = parseCertificate(certDer);
		options = { rsaKey, signerCert, algorithm: "rsa-sha256" };
		} catch {
		throw new CliError("Failed to parse signing credentials. Verify key and certificate are valid PEM-encoded files.", 1);
		}
		const signedBytes = signPdfBytes(pdfBytes, options);
		await writeOutput(signedBytes, outputPath);
		}
		var init_sign = __esm({
		"src/commands/sign.ts"() {
		init_core_bridge();
		init_args();
		init_io();
		init_error();
		}
		});

		// src/commands/inspect.ts
		var inspect_exports = {};
		__export(inspect_exports, {
		inspect: () => inspect
		});
		function safeInfoString(value) {
		if (typeof value !== "string") return null;
		const trimmed = value.trim();
		if (trimmed.startsWith("(") && trimmed.endsWith(")")) {
		return trimmed.slice(1, -1);
		}
		if (/[\x00-\x08\x0B\x0C\x0E-\x1F\x7F]/.test(trimmed)) {
		return null;
		}
		return trimmed \|\| null;
		}
		function extractVersion(reader) {
		const header = new TextDecoder("ascii", { fatal: false }).decode(
		reader.bytes.slice(0, 20)
		);
		const match = /^%PDF-(\d+\.\d+)/.exec(header);
		return match !== null ? match[1] : "unknown";
		}
		function extractEncrypted(reader) {
		const trailer = reader.trailer;
		return trailer.get("Encrypt") !== void 0;
		}
		function extractPdfaConformance(reader) {
		try {
		const catalog = reader.getCatalog();
		const metaRef = catalog.get("Metadata");
		if (metaRef === void 0) return null;
		const metaObj = reader.resolveValue(metaRef);
		if (typeof metaObj !== "object" \|\| metaObj === null \|\| !("streamData" in metaObj)) {
		return null;
		}
		const decoded = reader.decodeStream(
		metaObj
		);
		const xmp = new TextDecoder("utf-8", { fatal: false }).decode(decoded);
		const partMatch = /pdfaid:part[^>]*>(\d+)</.exec(xmp);
		const confMatch = /pdfaid:conformance[^>]*>([A-Za-z]+)</.exec(xmp);
		if (partMatch !== null && confMatch !== null) {
		return `${partMatch[1]}${confMatch[1].toLowerCase()}`;
		}
		} catch {
		}
		return null;
		}
		function countSignatures(reader) {
		try {
		const catalog = reader.getCatalog();
		const acroRef = catalog.get("AcroForm");
		if (acroRef === void 0) return 0;
		const acro = reader.resolveValue(acroRef);
		if (!(acro instanceof Map)) return 0;
		const fieldsVal = acro.get("Fields");
		if (!Array.isArray(fieldsVal)) return 0;
		let count = 0;
		for (const ref of fieldsVal) {
		const field = reader.resolveValue(ref);
		if (field instanceof Map && field.get("FT") === "/Sig") {
		count++;
		}
		}
		return count;
		} catch {
		return 0;
		}
		}
		async function inspect(args) {
		const inputPath = getStringFlag(args.flags, "input", "i");
		const format = getStringFlag(args.flags, "format", "f") ?? "json";
		if (format !== "json" && format !== "text") {
		throw new CliError(`Invalid --format value "${format}". Valid values: json, text.`, 2);
		}
		const inputBuf = await readFileOrStdin(inputPath);
		const pdfBytes = new Uint8Array(inputBuf);
		let reader;
		try {
		reader = openPdf(pdfBytes);
		} catch (e) {
		const message = e instanceof Error ? e.message : String(e);
		throw new CliError(`Failed to read PDF: ${message}`, 1);
		}
		const info = reader.getInfo();
		const result = {
		version: extractVersion(reader),
		pageCount: reader.pageCount,
		encrypted: extractEncrypted(reader),
		pdfaConformance: extractPdfaConformance(reader),
		signatures: countSignatures(reader),
		metadata: {
		title: info !== null ? safeInfoString(info.get("Title")) : null,
		author: info !== null ? safeInfoString(info.get("Author")) : null,
		creationDate: info !== null ? safeInfoString(info.get("CreationDate")) : null,
		subject: info !== null ? safeInfoString(info.get("Subject")) : null,
		producer: info !== null ? safeInfoString(info.get("Producer")) : null
		}
		};
		if (format === "json") {
		process.stdout.write(JSON.stringify(result, null, 2) + "\n");
		} else {
		const lines = [
		`Version: ${result.version}`,
		`Pages: ${result.pageCount}`,
		`Encrypted: ${result.encrypted ? "yes" : "no"}`,
		`PDF/A: ${result.pdfaConformance ?? "none"}`,
		`Signatures: ${result.signatures}`,
		`Title: ${result.metadata.title ?? "\u2014"}`,
		`Author: ${result.metadata.author ?? "\u2014"}`,
		`Created: ${result.metadata.creationDate ?? "\u2014"}`,
		`Subject: ${result.metadata.subject ?? "\u2014"}`,
		`Producer: ${result.metadata.producer ?? "\u2014"}`
		];
		process.stdout.write(lines.join("\n") + "\n");
		}
		}
		var init_inspect = __esm({
		"src/commands/inspect.ts"() {
		init_core_bridge();
		init_args();
		init_io();
		init_error();
		}
		});

		// src/index.ts
		init_args();
		init_error();
		var USAGE = `pdfnative-cli \u2014 Official CLI for pdfnative

		Usage:
		pdfnative <command> [options]

		Commands:
		render Render a JSON document definition to PDF
		sign Apply a digital signature to an existing PDF
		inspect Analyse a PDF and output metadata / conformance info

		Options:
		--help, -h Show this help message
		--version, -V Show version

		Run \`pdfnative <command> --help\` for per-command options.
		`;
		var RENDER_USAGE = `pdfnative render \u2014 Render a JSON DocumentParams to PDF

		Usage:
		pdfnative render [--input <file.json>] [--output <out.pdf>] [--stream] [--conformance <level>]

		Options:
		--input, -i Path to JSON input file (default: stdin)
		--output, -o Output PDF path (default: stdout)
		--stream Use streaming output for large documents
		--conformance PDF/A conformance level: 1b, 2b, or 3b
		--help, -h Show this help message
		`;
		var SIGN_USAGE = `pdfnative sign \u2014 Apply a digital signature to an existing PDF

		Usage:
		pdfnative sign [--input <file.pdf>] [--output <out.pdf>] [--key <key.pem>] [--cert <cert.pem>]

		Options:
		--input, -i Path to input PDF (default: stdin)
		--output, -o Signed PDF output path (default: stdout)
		--key Path to PEM private key file
		(overridden by $PDFNATIVE_SIGN_KEY env var)
		--cert Path to PEM certificate file
		(overridden by $PDFNATIVE_SIGN_CERT env var)
		--help, -h Show this help message

		Security: $PDFNATIVE_SIGN_KEY and $PDFNATIVE_SIGN_CERT env vars take precedence over file flags.
		`;
		var INSPECT_USAGE = `pdfnative inspect \u2014 Analyse a PDF and output metadata

		Usage:
		pdfnative inspect [--input <file.pdf>] [--format <fmt>]

		Options:
		--input, -i Path to input PDF (default: stdin)
		--format, -f Output format: json (default) or text
		--help, -h Show this help message
		`;
		function getVersion() {
		const require2 = createRequire(import.meta.url);
		const pkg = require2("../package.json");
		return pkg.version;
		}
		async function loadCommand(name) {
		switch (name) {
		case "render": {
		const m = await Promise.resolve().then(() => (init_render(), render_exports));
		return m.render;
		}
		case "sign": {
		const m = await Promise.resolve().then(() => (init_sign(), sign_exports));
		return m.sign;
		}
		case "inspect": {
		const m = await Promise.resolve().then(() => (init_inspect(), inspect_exports));
		return m.inspect;
		}
		default:
		return Promise.reject(new CliError(`Unknown command: ${name}. Run pdfnative --help for usage.`, 1));
		}
		}
		async function main() {
		const argv = process.argv.slice(2);
		const args = parseArgs(argv);
		if (hasFlag(args.flags, "help", "h") && args.positionals.length === 0) {
		process.stdout.write(USAGE);
		process.exit(0);
		}
		if (hasFlag(args.flags, "version", "V")) {
		process.stdout.write(getVersion() + "\n");
		process.exit(0);
		}
		const commandName = args.positionals[0];
		if (commandName === void 0) {
		process.stdout.write(USAGE);
		process.exit(0);
		}
		if (hasFlag(args.flags, "help", "h")) {
		switch (commandName) {
		case "render":
		process.stdout.write(RENDER_USAGE);
		break;
		case "sign":
		process.stdout.write(SIGN_USAGE);
		break;
		case "inspect":
		process.stdout.write(INSPECT_USAGE);
		break;
		default:
		process.stderr.write(`Unknown command: ${commandName}. Run pdfnative --help for usage.
		`);
		process.exit(1);
		}
		process.exit(0);
		}
		const commandArgs = parseArgs(argv.filter((_t, _i) => {
		if (_t === commandName && args.positionals[0] === commandName) {
		return false;
		}
		return true;
		}));
		const command = await loadCommand(commandName);
		await command(commandArgs);
		}
		main().catch((e) => {
		if (e instanceof CliError) {
		process.stderr.write(e.message + "\n");
		process.exit(e.exitCode);
		}
		const message = e instanceof Error ? e.message : String(e);
		process.stderr.write(`Error: ${message}
		`);
		process.exit(1);
		});
		//# sourceMappingURL=cli.js.map
		//# sourceMappingURL=cli.js.map

+1

dist/cli.js.map

+21

LICENSE

		MIT License

		Copyright (c) 2026 Nizoka — Plika (https://plika.app)

		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.

+258

README.md

		# pdfnative-cli

		[![CI](https://github.com/Nizoka/pdfnative-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/Nizoka/pdfnative-cli/actions/workflows/ci.yml)
		[![CodeQL](https://github.com/Nizoka/pdfnative-cli/actions/workflows/codeql.yml/badge.svg)](https://github.com/Nizoka/pdfnative-cli/actions/workflows/codeql.yml)
		[![npm version](https://img.shields.io/npm/v/pdfnative-cli)](https://www.npmjs.com/package/pdfnative-cli)
		[![npm downloads](https://img.shields.io/npm/dm/pdfnative-cli)](https://www.npmjs.com/package/pdfnative-cli)
		[![zero extra runtime dependencies](https://img.shields.io/badge/extra%20runtime%20deps-0-brightgreen)](https://www.npmjs.com/package/pdfnative-cli)
		[![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
		[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
		[![npm provenance](https://img.shields.io/badge/provenance-signed-blueviolet)](https://docs.npmjs.com/generating-provenance-statements)
		[![pdfnative](https://img.shields.io/npm/v/pdfnative?label=pdfnative&color=0066FF)](https://www.npmjs.com/package/pdfnative)
		[![website](https://img.shields.io/badge/pdfnative.dev-0066FF?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxyZWN0IHg9IjMiIHk9IjIiIHdpZHRoPSIxNCIgaGVpZ2h0PSIxOCIgcng9IjIiIGZpbGw9Im5vbmUiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMS41Ii8+PHBhdGggZD0iTTcgN2g2TTcgMTFoOE03IDE1aDQiIHN0cm9rZT0id2hpdGUiIHN0cm9rZS13aWR0aD0iMS41IiBzdHJva2UtbGluZWNhcD0icm91bmQiLz48L3N2Zz4=)](https://pdfnative.dev)

		Official CLI for the [`pdfnative`](https://github.com/Nizoka/pdfnative) library — render JSON to PDF, apply digital signatures, and inspect PDF conformance, directly from the terminal. Zero extra runtime dependencies.

		## Highlights

		- `render` — pipe a JSON document definition into a production-ready PDF (streaming supported)
		- `sign` — apply RSA or ECDSA digital signatures (CMS/PKCS#7) using key files or environment variables
		- `inspect` — analyse any PDF: version, page count, encryption, PDF/A conformance, signature count, metadata
		- Zero extra dependencies — `pdfnative` is the only runtime dependency; all PDF logic lives there
		- Streaming output — `--stream` on render emits PDF chunks progressively for large documents
		- Stdin / stdout — every command reads from stdin and writes to stdout by default, composable in shell pipelines
		- Secret-safe — signing keys are loaded from env vars (`PDFNATIVE_SIGN_KEY`/`PDFNATIVE_SIGN_CERT`) and never logged
		- ESM-first, TypeScript strict — built with tsup, typed declarations included
		- NPM provenance — signed builds via GitHub Actions OIDC

		## Supported Features

		\| Feature \| Status \| Notes \|
		\|---------\|--------\|-------\|
		\| Commands \| \| \|
		\| `render` JSON → PDF \| ✅ \| Streaming, PDF/A conformance, stdin/stdout \|
		\| `sign` digital signatures \| ✅ \| RSA + ECDSA, CMS/PKCS#7, env var secrets \|
		\| `inspect` PDF metadata \| ✅ \| Version, pages, encryption, signatures, PDFA \|
		\| Document Blocks \| \| \|
		\| Headings, paragraphs, lists \| ✅ \| Full text styling support \|
		\| Tables \| ✅ \| Headers, rows, multi-page \|
		\| Barcodes \| ✅ \| QR, Code 128, EAN-13, Data Matrix, PDF417 \|
		\| Hyperlinks \| ✅ \| URL validation, blue underlined text \|
		\| Form fields \| ✅ \| Text, checkbox, radio, dropdown, listbox \|
		\| Page breaks, spacers \| ✅ \| Explicit pagination control \|
		\| Table of contents \| ✅ \| Auto-generated with /GoTo links \|
		\| Advanced Layouts \| \| \|
		\| PDF/A archival (1b, 2b, 3b) \| ✅ \| `--conformance` flag \|
		\| Streaming output \| ✅ \| `--stream` for large documents \|
		\| Compression \| ✅ \| Via pdfnative API (50–90% reduction) \|
		\| Encryption (AES-128/256) \| ⚠️ \| Not exposed via CLI; use Node.js API \|
		\| Watermarks \| ⚠️ \| Not exposed via CLI; use Node.js API \|
		\| Custom headers/footers \| ⚠️ \| Not exposed via CLI; use `footerText` property \|
		\| Custom page sizes \| ⚠️ \| Not exposed via CLI; use Node.js API \|

		Note: Features marked ⚠️ are supported by `pdfnative` but not yet exposed through the CLI JSON interface. Use the `pdfnative` Node.js library directly for these features.

		## Installation

		```bash
		npm install --global pdfnative-cli
		```

		Or run without installing:

		```bash
		npx pdfnative-cli render --input doc.json --output report.pdf
		```

		Requirements: Node.js ≥ 20 \| Bun \| Deno (`node dist/cli.cjs`)

		## Documentation

		- 📘 [Quick Start](#quick-start) (below) — Get rendering in 5 minutes
		- 🏛️ [KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md) — Full CLI reference, architecture, integration patterns
		- 📚 [samples/README.md](samples/README.md) — 22 sample files organized by feature
		- 🔧 [pdfnative library](https://github.com/Nizoka/pdfnative) — Underlying PDF engine docs
		- ❓ [FAQ](docs/KNOWLEDGE_BASE.md#11-frequently-asked-questions) — Common questions & troubleshooting

		## Quick Start

		### Render a PDF from JSON

		```bash
		# From a file
		pdfnative render --input document.json --output report.pdf

		# From stdin
		cat document.json \| pdfnative render --output report.pdf

		# Streaming (large documents)
		pdfnative render --input big-doc.json --output report.pdf --stream

		# PDF/A conformance
		pdfnative render --input document.json --output archived.pdf --conformance 2b
		```

		`document.json` is a [`DocumentParams`](https://github.com/Nizoka/pdfnative) object:

		```json
		{
		"title": "Monthly Report",
		"blocks": [
		{ "type": "heading", "text": "Monthly Report", "level": 1 },
		{ "type": "paragraph", "text": "Summary for April 2026." },
		{ "type": "list", "style": "bullet", "items": ["Revenue: +18%", "NPS: 72"] }
		],
		"footerText": "Confidential",
		"metadata": { "author": "Finance Team", "subject": "April 2026 Report" }
		}
		```

		### Sign a PDF

		```bash
		# Keys from environment variables (recommended for CI/CD)
		export PDFNATIVE_SIGN_KEY="$(cat private.pem)"
		export PDFNATIVE_SIGN_CERT="$(cat cert.pem)"
		pdfnative sign --input document.pdf --output signed.pdf

		# Keys from files
		pdfnative sign --input document.pdf --output signed.pdf \
		--key private.pem --cert cert.pem
		```

		### Inspect a PDF

		```bash
		# JSON output (default)
		pdfnative inspect --input report.pdf

		# Human-readable
		pdfnative inspect --input report.pdf --format text

		# From stdin
		cat report.pdf \| pdfnative inspect
		```

		Example output:

		```json
		{
		"version": "1.7",
		"pageCount": 3,
		"encrypted": false,
		"pdfaConformance": "2b",
		"signatures": 1,
		"metadata": {
		"title": "Monthly Report",
		"author": "Nizoka",
		"creationDate": "2026-04-27T12:00:00+00:00"
		}
		}
		```

		## Examples

		Ready-to-run examples are in [`samples/`](samples/), organized by feature category:

		\| Category \| Examples \| Description \|
		\|----------\|----------\|-------------\|
		\| [`render/document/`](samples/render/document/) \| 5 files \| Minimal, report, all-blocks reference, invoice, technical spec \|
		\| [`render/table/`](samples/render/table/) \| 2 files \| Project status, financial summary \|
		\| [`render/barcode/`](samples/render/barcode/) \| 3 files \| QR code, Code 128 shipping label, EAN-13 product \|
		\| [`render/form/`](samples/render/form/) \| 2 files \| Contact form, survey \|
		\| [`render/toc/`](samples/render/toc/) \| 1 file \| Document with auto-generated table of contents \|
		\| [`render/link/`](samples/render/link/) \| 1 file \| Resource directory with hyperlinks \|
		\| [`render/watermark/`](samples/render/watermark/) \| 2 files \| Draft watermark, confidential watermark \|
		\| [`render/layout/`](samples/render/layout/) \| 3 files \| US Letter, A5 portrait, A4 landscape \|
		\| [`render/pdfa/`](samples/render/pdfa/) \| 3 files \| PDF/A-1b, PDF/A-2b, PDF/A-3b archival conformance \|
		\| [`sign/`](samples/sign/) \| 2 scripts \| Digital signature (Bash + PowerShell) \|
		\| [`inspect/`](samples/inspect/) \| 4 scripts \| JSON & text inspection (Bash + PowerShell) \|
		\| [`streaming/`](samples/streaming/) \| 1 script \| 200-section document via streaming render \|

		Render all samples at once:

		```bash
		node samples/run-all.js
		```

		See [`samples/README.md`](samples/README.md) for full descriptions, block type reference, and integration patterns (GitHub Actions, Docker, TypeScript).

		---

		## Command Reference

		### `pdfnative render`

		\| Flag \| Default \| Description \|
		\|------\|---------\|-------------\|
		\| `--input <file>` \| stdin \| Path to a JSON file containing `DocumentParams` \|
		\| `--output <file>` \| stdout \| Output PDF path \|
		\| `--stream` \| false \| Use streaming output (AsyncGenerator) \|
		\| `--conformance <level>` \| — \| PDF/A conformance level: `1b`, `2b`, or `3b` \|

		### `pdfnative sign`

		\| Flag \| Default \| Description \|
		\|------\|---------\|-------------\|
		\| `--input <file>` \| — (required) \| Path to the input PDF \|
		\| `--output <file>` \| stdout \| Output signed PDF path \|
		\| `--key <file>` \| `PDFNATIVE_SIGN_KEY` env \| Path to PEM private key (env var takes precedence) \|
		\| `--cert <file>` \| `PDFNATIVE_SIGN_CERT` env \| Path to PEM certificate (env var takes precedence) \|

		### `pdfnative inspect`

		\| Flag \| Default \| Description \|
		\|------\|---------\|-------------\|
		\| `--input <file>` \| stdin \| Path to the PDF to inspect \|
		\| `--format <fmt>` \| `json` \| Output format: `json` or `text` \|

		## Security

		- Signing keys are never logged — not in error messages, not in debug output.
		- Path traversal protection — all file path arguments are validated against `../` sequences.
		- JSON size cap — input is capped at 50 MB before parsing to prevent memory exhaustion.
		- Signed builds with NPM provenance — verify at npmjs.com or with `npm audit signatures`.

		See [SECURITY.md](SECURITY.md) for the full security policy and vulnerability disclosure procedure.

		## Getting Help

		Have a question?
		- 📖 Check the [FAQ](docs/KNOWLEDGE_BASE.md#11-frequently-asked-questions) first
		- 🔍 Search the samples: `grep -r "your-keyword" samples/`
		- 📚 Read [KNOWLEDGE_BASE.md](docs/KNOWLEDGE_BASE.md) for technical details
		- 💬 Open a discussion: [GitHub Discussions](https://github.com/Nizoka/pdfnative-cli/discussions)

		Found a bug?
		- 🐛 Open an issue: [GitHub Issues](https://github.com/Nizoka/pdfnative-cli/issues)
		- 🔐 Security issue? See [SECURITY.md](SECURITY.md) for responsible disclosure

		Want to contribute?
		- 🤝 See [CONTRIBUTING.md](CONTRIBUTING.md)
		- 📝 All PRs add value — tests, docs, translations, samples

		## Related Projects

		- [`pdfnative`](https://github.com/Nizoka/pdfnative) — the core PDF generation library
		- [`pdfnative-mcp`](https://github.com/Nizoka/pdfnative-mcp) — Model Context Protocol server for AI clients
		- [pdfnative.dev](https://pdfnative.dev) — documentation, live demos, benchmarks

		## Citation

		If you use pdfnative-cli in research or academic pipelines, please cite it:

		```bibtex
		@software{pdfnative_cli_2026,
		title = {pdfnative-cli: Official CLI for the pdfnative PDF generation library},
		author = {Nizoka},
		year = {2026},
		url = {https://github.com/Nizoka/pdfnative-cli},
		license = {MIT}
		}
		```

		See [CITATION.cff](CITATION.cff) for the full metadata (auto-detected by GitHub and Zenodo).

		## License

		MIT — see [LICENSE](LICENSE).

+72

-7

package.json

		{
		"name": "pdfnative-cli",
		"version": "0.0.1",
		"description": "Temporary placeholder for pdfnative-cli",
		"main": "index.js",
		"version": "0.1.0",
		"description": "Official CLI for pdfnative — render JSON to PDF, sign, and inspect. Zero extra runtime dependencies.",
		"type": "module",
		"bin": {
		"pdfnative": "./dist/cli.cjs"
		},
		"main": "./dist/cli.cjs",
		"module": "./dist/cli.js",
		"types": "./dist/cli.d.ts",
		"files": [
		"dist",
		"LICENSE",
		"README.md"
		],
		"sideEffects": false,
		"scripts": {
		"test": "echo \"Error: no test specified\" && exit 1"
		"build": "tsup",
		"dev": "tsup --watch",
		"test": "vitest run",
		"test:watch": "vitest",
		"test:coverage": "vitest run --coverage",
		"lint": "eslint src/",
		"typecheck": "tsc --noEmit",
		"typecheck:tests": "tsc --project tsconfig.test.json --noEmit",
		"typecheck:all": "npm run typecheck && npm run typecheck:tests",
		"prepublishOnly": "npm run build"
		},
		"keywords": [],
		"author": "",
		"license": "ISC"
		"keywords": [
		"pdf",
		"pdf-generation",
		"cli",
		"pdfnative",
		"pdf-render",
		"pdf-sign",
		"pdf-inspect",
		"zero-dependency",
		"typescript",
		"pdf-a",
		"digital-signature",
		"command-line"
		],
		"author": "Nizoka <hello@pdfnative.dev> (https://pdfnative.dev)",
		"license": "MIT",
		"repository": {
		"type": "git",
		"url": "https://github.com/Nizoka/pdfnative-cli.git"
		},
		"homepage": "https://github.com/Nizoka/pdfnative-cli#readme",
		"bugs": {
		"url": "https://github.com/Nizoka/pdfnative-cli/issues"
		},
		"funding": {
		"type": "individual",
		"url": "https://plika.app"
		},
		"engines": {
		"node": ">=20"
		},
		"publishConfig": {
		"access": "public",
		"provenance": true
		},
		"dependencies": {
		"pdfnative": "^1.0.4"
		},
		"devDependencies": {
		"@types/node": "^22.0.0",
		"@vitest/coverage-v8": "^2.1.9",
		"eslint": "^9.0.0",
		"tsup": "^8.0.0",
		"typescript": "^5.4.0",
		"typescript-eslint": "^8.57.2",
		"vitest": "^2.1.9"
		}
		}

pdfnative-cli - npm Package Compare versions

New alerts

Fixed alerts

Improved metrics

Worsened metrics

Dependency changes