@arcships/light-ocr-runtime 0.1.7 → 0.1.8

package/package.json

@@ -4,7 +4,7 @@
   },
   "description": "Model-free Node.js runtime for light-ocr",
   "engines": {
-    "node": "^22.0.0 || ^24.0.0"
+    "node": ">=22.0.0"
   },
   "exports": {
     ".": {
@@ -28,12 +28,14 @@
   "module": "./src/index.mjs",
   "name": "@arcships/light-ocr-runtime",
   "optionalDependencies": {
-    "@arcships/light-ocr-darwin-arm64": "0.5.7",
-    "@arcships/light-ocr-darwin-x64": "0.5.7",
-    "@arcships/light-ocr-linux-arm64-gnu": "0.5.7",
-    "@arcships/light-ocr-linux-x64-gnu": "0.5.7",
-    "@arcships/light-ocr-win32-arm64": "0.5.7",
-    "@arcships/light-ocr-win32-x64": "0.5.7"
+    "@arcships/light-ocr-darwin-arm64": "0.5.8",
+    "@arcships/light-ocr-darwin-x64": "0.5.8",
+    "@arcships/light-ocr-linux-arm64-gnu": "0.5.8",
+    "@arcships/light-ocr-linux-arm64-musl": "0.5.8",
+    "@arcships/light-ocr-linux-x64-gnu": "0.5.8",
+    "@arcships/light-ocr-linux-x64-musl": "0.5.8",
+    "@arcships/light-ocr-win32-arm64": "0.5.8",
+    "@arcships/light-ocr-win32-x64": "0.5.8"
   },
   "publishConfig": {
     "access": "public",
@@ -45,5 +47,5 @@
   },
   "type": "commonjs",
   "types": "./src/index.d.ts",
-  "version": "0.1.7"
+  "version": "0.1.8"
 }

package/src/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-const { loadNative } = require('./load-native.cjs');
+const { loadNative, platformIdentity } = require('./load-native.cjs');
 
 class OcrError extends Error {
   constructor(code, message, detail) {
@@ -174,4 +174,4 @@ async function createEngine(options) {
   }
 }
 
-module.exports = { createEngine, OcrError, loadNative };
+module.exports = { createEngine, OcrError, loadNative, platformIdentity };

package/src/index.d.ts

@@ -289,4 +289,15 @@ export interface DetectionResult {
   readonly timingUs: TimingUs;
 }
 
+/** Resolved host platform identity used to select the native package. */
+export interface PlatformIdentity {
+  readonly id: string;
+  readonly os: string;
+  readonly architecture: string;
+  /** Present for Linux hosts; `"glibc"` or `"musl"`. */
+  readonly libc?: 'glibc' | 'musl';
+}
+
+export function platformIdentity(): PlatformIdentity;
+
 export function createEngine(options: CreateEngineOptions): Promise<OcrEngine>;

package/src/index.mjs

@@ -2,3 +2,4 @@ import cjs from './index.cjs';
 
 export const createEngine = cjs.createEngine;
 export const OcrError = cjs.OcrError;
+export const platformIdentity = cjs.platformIdentity;

package/src/load-native.cjs

@@ -104,6 +104,22 @@ function adapterError(code, message, detail, cause) {
   return error;
 }
 
+// Detect musl Linux (Alpine and friends). Only reached when the host does not
+// report glibcVersionRuntime through process.report. The musl dynamic linker
+// path is the primary signal; the ldd output check covers hosts with a
+// non-standard loader location.
+function isMuslLinux() {
+  if (process.platform !== 'linux') return false;
+  const loader = process.arch === 'arm64'
+    ? '/lib/ld-musl-aarch64.so.1'
+    : '/lib/ld-musl-x86_64.so.1';
+  if (fs.existsSync(loader)) return true;
+  const ldd = spawnSync('ldd', ['--version'], { encoding: 'utf8', timeout: 5000 });
+  if (ldd.error) return false;
+  const output = `${ldd.stdout || ''}${ldd.stderr || ''}`;
+  return output.toLowerCase().includes('musl');
+}
+
 function platformIdentity() {
   const key = `${process.platform}-${process.arch}`;
   const identities = {
@@ -117,9 +133,12 @@ function platformIdentity() {
     if (report?.header?.glibcVersionRuntime) {
       return { id: 'linux-x64', os: 'linux', architecture: 'x86_64', libc: 'glibc' };
     }
+    if (isMuslLinux()) {
+      return { id: 'linux-x64-musl', os: 'linux', architecture: 'x86_64', libc: 'musl' };
+    }
     throw adapterError(
       'unsupported_platform',
-      'light-ocr currently supports Linux x64 with glibc only',
+      'light-ocr currently supports Linux x64 with glibc or musl only',
       key,
     );
   }
@@ -128,9 +147,12 @@ function platformIdentity() {
     if (report?.header?.glibcVersionRuntime) {
       return { id: 'linux-arm64', os: 'linux', architecture: 'arm64', libc: 'glibc' };
     }
+    if (isMuslLinux()) {
+      return { id: 'linux-arm64-musl', os: 'linux', architecture: 'arm64', libc: 'musl' };
+    }
     throw adapterError(
       'unsupported_platform',
-      'light-ocr currently supports Linux arm64 with glibc only',
+      'light-ocr currently supports Linux arm64 with glibc or musl only',
       key,
     );
   }
@@ -149,6 +171,8 @@ function platformPackage() {
     'windows-x64': '@arcships/light-ocr-win32-x64',
     'linux-x64': '@arcships/light-ocr-linux-x64-gnu',
     'linux-arm64': '@arcships/light-ocr-linux-arm64-gnu',
+    'linux-x64-musl': '@arcships/light-ocr-linux-x64-musl',
+    'linux-arm64-musl': '@arcships/light-ocr-linux-arm64-musl',
   };
   return packages[platformIdentity().id];
 }
@@ -606,4 +630,4 @@ const macOSSignature = Object.freeze({
   signerMatchesHost,
 });
 
-module.exports = { loadNative, validateRuntimeDescriptor, macOSSignature };
+module.exports = { loadNative, validateRuntimeDescriptor, macOSSignature, platformIdentity };

package/src/metadata.cjs

@@ -1,3 +1,3 @@
 'use strict';
 
-module.exports = Object.freeze({ coreVersion: '0.5.7' });
+module.exports = Object.freeze({ coreVersion: '0.5.8' });