@s8fy/xdoc 0.3.12

package/LICENSE

@@ -0,0 +1,8 @@
+PolyForm Noncommercial License 1.0.0
+https://polyformproject.org/licenses/noncommercial/1.0.0
+
+Required Notice: Copyright (c) 2025-PRESENT hustcer
+
+This module is source-available, not open source. No commercial use is granted
+to third parties under this module's default license unless separately
+licensed.

package/README.md

@@ -0,0 +1,49 @@
+# `@s8fy/xdoc`
+
+Install the native `xdoc` CLI through npm:
+
+```sh
+npm install --global @s8fy/xdoc
+xdoc --version
+```
+
+The base package selects an exact, platform-specific optional dependency. No
+binary is downloaded by an install script.
+
+## Supported platforms
+
+| Operating system  | Architecture | Binary package           |
+| ----------------- | ------------ | ------------------------ |
+| Linux             | arm64        | `@s8fy/xdoc-linux-arm64` |
+| Linux             | x64          | `@s8fy/xdoc-linux-x64`   |
+| macOS 26 or newer | arm64        | `@s8fy/xdoc-macos-arm64` |
+| Windows           | x64          | `@s8fy/xdoc-windows-x64` |
+
+Installation fails with an actionable error on any unsupported operating
+system, architecture, or operating system version. The minimum supported
+Node.js version is 22. The macOS requirement reflects the deployment target of
+the current upstream native binary.
+
+The locked v0.3.10 macOS asset predates the native deployment-target fix and
+must not be published as compatible with older macOS releases. The npm
+preflight and smoke jobs intentionally run on macOS 15, so this asset will fail
+closed. Cut a new upstream xdoc release with `MACOSX_DEPLOYMENT_TARGET=13.0`,
+then update `minimumOsVersion` to `13.0` and `minimumKernelMajor` to `22` in
+`platforms.json` together with the version and release lock. macOS 13 is the
+current lower bound because the statically linked PDFium archive has a macOS
+13 deployment target.
+
+## Source and issue reporting
+
+This directory contains only the npm packaging and release automation. The
+native binaries come from the private `hustcer/pptx` repository and are locked
+to reviewed GitHub Release SHA-256 digests in `release-lock.json`.
+
+- Report npm installation, package selection, or launcher issues in the
+  [`hustcer/workers` issue tracker](https://github.com/hustcer/workers/issues).
+- Report native `xdoc` behavior through the upstream project's normal support
+  channel.
+
+Each platform package preserves the upstream `LICENSE` and all bundled PDFium
+third-party license notices. This software is distributed under the PolyForm
+Noncommercial License 1.0.0 unless separately licensed.

package/lib/check-platform.cjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+"use strict";
+
+const { assertRuntimeSupport } = require("./platform.cjs");
+
+try {
+  assertRuntimeSupport();
+} catch (error) {
+  const message = error instanceof Error ? error.message : String(error);
+  console.error(`xdoc install error: ${message}`);
+  process.exitCode = 1;
+}

package/lib/index.cjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const { constants } = require("node:os");
+const { resolveBinaryPath } = require("./platform.cjs");
+
+function execute(
+  args = process.argv.slice(2),
+  { os = process.platform, cpu = process.arch, resolve = require.resolve, spawn = spawnSync } = {},
+) {
+  const executable = resolveBinaryPath({ os, cpu, resolve });
+  const result = spawn(executable, args, { stdio: "inherit" });
+
+  if (result.error) {
+    throw new Error(`Failed to start the xdoc binary: ${result.error.message}`, {
+      cause: result.error,
+    });
+  }
+
+  if (typeof result.status === "number") {
+    return { exitCode: result.status, signal: null };
+  }
+
+  if (result.signal) {
+    const signalNumber = constants.signals[result.signal];
+    return {
+      exitCode: typeof signalNumber === "number" ? 128 + signalNumber : 1,
+      signal: result.signal,
+    };
+  }
+
+  return { exitCode: 1, signal: null };
+}
+
+function main() {
+  try {
+    const result = execute();
+
+    if (result.signal && process.platform !== "win32") {
+      try {
+        process.kill(process.pid, result.signal);
+      } catch (cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        console.error(`xdoc launcher warning: failed to propagate ${result.signal}: ${message}`);
+      }
+    }
+
+    process.exitCode = result.exitCode;
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`xdoc launcher error: ${message}`);
+    process.exitCode = 1;
+  }
+}
+
+if (require.main === module) {
+  main();
+}
+
+module.exports = { execute, main };

package/lib/platform.cjs

@@ -0,0 +1,80 @@
+"use strict";
+
+const { release: systemRelease } = require("node:os");
+const platformsDocument = require("../platforms.json");
+
+const platforms = Object.freeze(
+  platformsDocument.platforms.map((platform) => Object.freeze({ ...platform })),
+);
+
+function platformId(os = process.platform, cpu = process.arch) {
+  const osName = os === "darwin" ? "macos" : os === "win32" ? "windows" : os;
+  return `${osName}-${cpu}`;
+}
+
+function supportedPlatformIds() {
+  return platforms.map((platform) => platform.id);
+}
+
+function getPlatform(os = process.platform, cpu = process.arch) {
+  const id = platformId(os, cpu);
+  const platform = platforms.find((candidate) => candidate.id === id);
+
+  if (!platform) {
+    throw new Error(
+      `@s8fy/xdoc does not support ${os}/${cpu} (${id}). Supported platforms: ${supportedPlatformIds().join(", ")}.`,
+    );
+  }
+
+  return platform;
+}
+
+function assertRuntimeSupport({
+  os = process.platform,
+  cpu = process.arch,
+  kernelRelease = systemRelease(),
+} = {}) {
+  const platform = getPlatform(os, cpu);
+  if (platform.minimumKernelMajor !== undefined) {
+    const kernelMajor = Number.parseInt(kernelRelease, 10);
+    if (!Number.isInteger(kernelMajor)) {
+      throw new Error(
+        `Unable to determine whether ${os}/${cpu} meets the minimum operating system version.`,
+      );
+    }
+    if (kernelMajor < platform.minimumKernelMajor) {
+      throw new Error(
+        `@s8fy/xdoc ${platform.id} requires macOS ${platform.minimumOsVersion} or newer.`,
+      );
+    }
+  }
+  return platform;
+}
+
+function resolveBinaryPath({
+  os = process.platform,
+  cpu = process.arch,
+  resolve = require.resolve,
+  kernelRelease = systemRelease(),
+} = {}) {
+  const platform = assertRuntimeSupport({ os, cpu, kernelRelease });
+  const request = `${platform.packageName}/bin/${platform.binaryName}`;
+
+  try {
+    return resolve(request);
+  } catch (cause) {
+    throw new Error(
+      `The xdoc binary package "${platform.packageName}" is missing. Reinstall @s8fy/xdoc with optional dependencies enabled and without --omit=optional.`,
+      { cause },
+    );
+  }
+}
+
+module.exports = {
+  assertRuntimeSupport,
+  getPlatform,
+  platformId,
+  platforms,
+  resolveBinaryPath,
+  supportedPlatformIds,
+};

package/lib/version.cjs

@@ -0,0 +1,8 @@
+"use strict";
+
+function containsExactVersion(output, expectedVersion) {
+  const escaped = expectedVersion.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  return new RegExp(`(^|\\s)v?${escaped}(?=\\s|$)`).test(output);
+}
+
+module.exports = { containsExactVersion };

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@s8fy/xdoc",
+  "version": "0.3.12",
+  "description": "The xdoc CLI packaged for installation through npm.",
+  "keywords": [
+    "cli",
+    "document",
+    "pdf",
+    "pptx",
+    "xdoc"
+  ],
+  "homepage": "https://github.com/hustcer/workers/tree/main/xdoc-npm#readme",
+  "bugs": {
+    "url": "https://github.com/hustcer/workers/issues"
+  },
+  "license": "PolyForm-Noncommercial-1.0.0",
+  "author": "hustcer",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/hustcer/workers.git",
+    "directory": "xdoc-npm"
+  },
+  "bin": {
+    "xdoc": "lib/index.cjs"
+  },
+  "files": [
+    "lib",
+    "platforms.json"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true,
+    "registry": "https://registry.npmjs.org"
+  },
+  "scripts": {
+    "preinstall": "node lib/check-platform.cjs",
+    "test": "node --test tests/*.test.cjs"
+  },
+  "optionalDependencies": {
+    "@s8fy/xdoc-linux-arm64": "0.3.12",
+    "@s8fy/xdoc-linux-x64": "0.3.12",
+    "@s8fy/xdoc-macos-arm64": "0.3.12",
+    "@s8fy/xdoc-windows-x64": "0.3.12"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  },
+  "preferUnplugged": true,
+  "xdoc": {
+    "releaseTag": "v0.3.12",
+    "sourceRepository": "hustcer/pptx"
+  }
+}

package/platforms.json

@@ -0,0 +1,43 @@
+{
+  "schemaVersion": "xdoc-npm-platforms/v1",
+  "platforms": [
+    {
+      "id": "linux-arm64",
+      "os": "linux",
+      "cpu": "arm64",
+      "packageName": "@s8fy/xdoc-linux-arm64",
+      "assetName": "xdoc-linux-arm64.tar.gz",
+      "archiveType": "tar.gz",
+      "binaryName": "xdoc"
+    },
+    {
+      "id": "linux-x64",
+      "os": "linux",
+      "cpu": "x64",
+      "packageName": "@s8fy/xdoc-linux-x64",
+      "assetName": "xdoc-linux-x64.tar.gz",
+      "archiveType": "tar.gz",
+      "binaryName": "xdoc"
+    },
+    {
+      "id": "macos-arm64",
+      "os": "darwin",
+      "cpu": "arm64",
+      "packageName": "@s8fy/xdoc-macos-arm64",
+      "assetName": "xdoc-macos-arm64.tar.gz",
+      "archiveType": "tar.gz",
+      "binaryName": "xdoc",
+      "minimumOsVersion": "13.0",
+      "minimumKernelMajor": 22
+    },
+    {
+      "id": "windows-x64",
+      "os": "win32",
+      "cpu": "x64",
+      "packageName": "@s8fy/xdoc-windows-x64",
+      "assetName": "xdoc-windows-x64.zip",
+      "archiveType": "zip",
+      "binaryName": "xdoc.exe"
+    }
+  ]
+}