@3leaps/docprims 0.1.3

package/LICENSE

@@ -0,0 +1,6 @@
+MIT OR Apache-2.0
+
+This package is part of the docprims repository.
+See the repository root for full license texts:
+- LICENSE-MIT
+- LICENSE-APACHE

package/README.md

@@ -0,0 +1,29 @@
+# docprims (TypeScript bindings)
+
+TypeScript/Node.js bindings for docprims using a Node-API (N-API) native addon (napi-rs).
+
+## Platform support (v0.1.x)
+
+Supported:
+
+- macOS: arm64
+- Linux: glibc and musl (Alpine)
+- Windows: x64 (msvc)
+
+## Local development
+
+The native addon is built from Rust:
+
+```bash
+npm install
+npm run build
+npm run build:native
+npm run test:ci
+```
+
+## API (minimal)
+
+- `extractFile(path, options?)` -> parsed v0 extract object
+- `extractBytes(sourceUri, data, options?)` -> parsed v0 extract object
+
+The `*Json` variants return the raw JSON string.

package/dist/errors.d.ts

@@ -0,0 +1,15 @@
+export declare const DocprimsErrorCode: {
+    readonly Ok: 0;
+    readonly Usage: 64;
+    readonly DataInvalid: 60;
+    readonly ResourceLimit: 70;
+    readonly Io: 74;
+    readonly Internal: 1;
+};
+export type DocprimsErrorCode = (typeof DocprimsErrorCode)[keyof typeof DocprimsErrorCode];
+export declare class DocprimsError extends Error {
+    readonly code: DocprimsErrorCode;
+    readonly codeName: string;
+    constructor(code: DocprimsErrorCode, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,iBAAiB;;;;;;;CAOpB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAC5B,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,OAAO,iBAAiB,CAAC,CAAC;AAM5D,qBAAa,aAAc,SAAQ,KAAK;IACvC,SAAgB,IAAI,EAAE,iBAAiB,CAAC;IACxC,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM;CAMpD"}

package/dist/errors.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocprimsError = exports.DocprimsErrorCode = void 0;
+exports.DocprimsErrorCode = {
+    Ok: 0,
+    Usage: 64,
+    DataInvalid: 60,
+    ResourceLimit: 70,
+    Io: 74,
+    Internal: 1,
+};
+const errorCodeNames = Object.fromEntries(Object.entries(exports.DocprimsErrorCode).map(([k, v]) => [v, k]));
+class DocprimsError extends Error {
+    code;
+    codeName;
+    constructor(code, message) {
+        super(message);
+        this.name = "DocprimsError";
+        this.code = code;
+        this.codeName = errorCodeNames[code] ?? `Unknown(${code})`;
+    }
+}
+exports.DocprimsError = DocprimsError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAa,QAAA,iBAAiB,GAAG;IAChC,EAAE,EAAE,CAAC;IACL,KAAK,EAAE,EAAE;IACT,WAAW,EAAE,EAAE;IACf,aAAa,EAAE,EAAE;IACjB,EAAE,EAAE,EAAE;IACN,QAAQ,EAAE,CAAC;CACF,CAAC;AAKX,MAAM,cAAc,GAA2B,MAAM,CAAC,WAAW,CAChE,MAAM,CAAC,OAAO,CAAC,yBAAiB,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CACzD,CAAC;AAEF,MAAa,aAAc,SAAQ,KAAK;IACvB,IAAI,CAAoB;IACxB,QAAQ,CAAS;IAEjC,YAAY,IAAuB,EAAE,OAAe;QACnD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,WAAW,IAAI,GAAG,CAAC;IAC5D,CAAC;CACD;AAVD,sCAUC"}

package/dist/ffi.d.ts

@@ -0,0 +1,15 @@
+export declare function loadDocprims(): DocprimsLib;
+export type DocprimsCallJsonResult = {
+    code: number;
+    json?: string;
+    message?: string;
+};
+export type DocprimsLib = {
+    docprimsVersion: () => string;
+    docprimsAbiVersion: () => number;
+    docprimsExtractFileJson: (path: string, optionsJson: string) => DocprimsCallJsonResult;
+    docprimsExtractBytesJson: (sourceUri: string, data: Uint8Array, optionsJson: string) => DocprimsCallJsonResult;
+};
+export declare function callJsonReturn(fn: () => DocprimsCallJsonResult): unknown;
+export declare function callJsonString(fn: () => DocprimsCallJsonResult): string;
+//# sourceMappingURL=ffi.d.ts.map

package/dist/ffi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffi.d.ts","sourceRoot":"","sources":["../src/ffi.ts"],"names":[],"mappings":"AAQA,wBAAgB,YAAY,IAAI,WAAW,CAO1C;AAcD,MAAM,MAAM,sBAAsB,GAAG;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACzB,eAAe,EAAE,MAAM,MAAM,CAAC;IAC9B,kBAAkB,EAAE,MAAM,MAAM,CAAC;IACjC,uBAAuB,EAAE,CACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,KACf,sBAAsB,CAAC;IAC5B,wBAAwB,EAAE,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,WAAW,EAAE,MAAM,KACf,sBAAsB,CAAC;CAC5B,CAAC;AAUF,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,sBAAsB,GAAG,OAAO,CAMxE;AAED,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,sBAAsB,GAAG,MAAM,CAMvE"}

package/dist/ffi.js

@@ -0,0 +1,53 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadDocprims = loadDocprims;
+exports.callJsonReturn = callJsonReturn;
+exports.callJsonString = callJsonString;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const errors_1 = require("./errors");
+const native_1 = require("./native");
+let cached = null;
+function loadDocprims() {
+    if (cached)
+        return cached;
+    const packageRoot = findPackageRoot(__dirname);
+    const api = (0, native_1.loadNativeBinding)(packageRoot);
+    cached = api;
+    return cached;
+}
+function findPackageRoot(startDir) {
+    let current = startDir;
+    for (let i = 0; i < 8; i++) {
+        const candidate = node_path_1.default.join(current, "package.json");
+        if (node_fs_1.default.existsSync(candidate))
+            return current;
+        const parent = node_path_1.default.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    throw new Error("Could not locate package root (package.json not found)");
+}
+function raiseDocprimsError(code, message) {
+    const codeNameSuffix = ` (code=${code})`;
+    throw new errors_1.DocprimsError(code, message && message.length > 0 ? message : `docprims error${codeNameSuffix}`);
+}
+function callJsonReturn(fn) {
+    const r = fn();
+    if (r.code !== errors_1.DocprimsErrorCode.Ok) {
+        raiseDocprimsError(r.code, r.message);
+    }
+    return JSON.parse(r.json);
+}
+function callJsonString(fn) {
+    const r = fn();
+    if (r.code !== errors_1.DocprimsErrorCode.Ok) {
+        raiseDocprimsError(r.code, r.message);
+    }
+    return r.json;
+}
+//# sourceMappingURL=ffi.js.map

package/dist/ffi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffi.js","sourceRoot":"","sources":["../src/ffi.ts"],"names":[],"mappings":";;;;;AAQA,oCAOC;AA0CD,wCAMC;AAED,wCAMC;AAvED,sDAAyB;AACzB,0DAA6B;AAE7B,qCAA4D;AAC5D,qCAA6C;AAE7C,IAAI,MAAM,GAAuB,IAAI,CAAC;AAEtC,SAAgB,YAAY;IAC3B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,MAAM,WAAW,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IAC/C,MAAM,GAAG,GAAgB,IAAA,0BAAiB,EAAC,WAAW,CAAC,CAAC;IACxD,MAAM,GAAG,GAAG,CAAC;IACb,OAAO,MAAM,CAAC;AACf,CAAC;AAED,SAAS,eAAe,CAAC,QAAgB;IACxC,IAAI,OAAO,GAAG,QAAQ,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,SAAS,GAAG,mBAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACrD,IAAI,iBAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,OAAO,CAAC;QAC7C,MAAM,MAAM,GAAG,mBAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,OAAO;YAAE,MAAM;QAC9B,OAAO,GAAG,MAAM,CAAC;IAClB,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wDAAwD,CAAC,CAAC;AAC3E,CAAC;AAsBD,SAAS,kBAAkB,CAAC,IAAY,EAAE,OAAgB;IACzD,MAAM,cAAc,GAAG,UAAU,IAAI,GAAG,CAAC;IACzC,MAAM,IAAI,sBAAa,CACtB,IAAyB,EACzB,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,cAAc,EAAE,CAC3E,CAAC;AACH,CAAC;AAED,SAAgB,cAAc,CAAC,EAAgC;IAC9D,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;IACf,IAAI,CAAC,CAAC,IAAI,KAAK,0BAAiB,CAAC,EAAE,EAAE,CAAC;QACrC,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,IAAc,CAAC,CAAC;AACrC,CAAC;AAED,SAAgB,cAAc,CAAC,EAAgC;IAC9D,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC;IACf,IAAI,CAAC,CAAC,IAAI,KAAK,0BAAiB,CAAC,EAAE,EAAE,CAAC;QACrC,kBAAkB,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,CAAC,IAAc,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import type { DocprimsExtractV0, ExtractOptions } from "./types";
+export declare function version(): string;
+export declare function abiVersion(): number;
+export declare function extractFileJson(filePath: string, options?: ExtractOptions): string;
+export declare function extractBytesJson(sourceUri: string, data: Uint8Array, options?: ExtractOptions): string;
+export declare function extractFile(filePath: string, options?: ExtractOptions): DocprimsExtractV0;
+export declare function extractBytes(sourceUri: string, data: Uint8Array, options?: ExtractOptions): DocprimsExtractV0;
+export { DocprimsError, DocprimsErrorCode } from "./errors";
+export type { DocprimsExtractV0, ExtractOptions, ExtractLimits } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AASjE,wBAAgB,OAAO,IAAI,MAAM,CAEhC;AAED,wBAAgB,UAAU,IAAI,MAAM,CAEnC;AAED,wBAAgB,eAAe,CAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACtB,MAAM,CAIR;AAED,wBAAgB,gBAAgB,CAC/B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,cAAc,GACtB,MAAM,CAQR;AAED,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,cAAc,GACtB,iBAAiB,CAInB;AAED,wBAAgB,YAAY,CAC3B,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,cAAc,GACtB,iBAAiB,CAQnB;AAED,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC5D,YAAY,EAAE,iBAAiB,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DocprimsErrorCode = exports.DocprimsError = void 0;
+exports.version = version;
+exports.abiVersion = abiVersion;
+exports.extractFileJson = extractFileJson;
+exports.extractBytesJson = extractBytesJson;
+exports.extractFile = extractFile;
+exports.extractBytes = extractBytes;
+const ffi_1 = require("./ffi");
+function optsToJson(opts) {
+    if (!opts)
+        return "";
+    return JSON.stringify(opts);
+}
+function version() {
+    return (0, ffi_1.loadDocprims)().docprimsVersion();
+}
+function abiVersion() {
+    return (0, ffi_1.loadDocprims)().docprimsAbiVersion();
+}
+function extractFileJson(filePath, options) {
+    return (0, ffi_1.callJsonString)(() => (0, ffi_1.loadDocprims)().docprimsExtractFileJson(filePath, optsToJson(options)));
+}
+function extractBytesJson(sourceUri, data, options) {
+    return (0, ffi_1.callJsonString)(() => (0, ffi_1.loadDocprims)().docprimsExtractBytesJson(sourceUri, data, optsToJson(options)));
+}
+function extractFile(filePath, options) {
+    return (0, ffi_1.callJsonReturn)(() => (0, ffi_1.loadDocprims)().docprimsExtractFileJson(filePath, optsToJson(options)));
+}
+function extractBytes(sourceUri, data, options) {
+    return (0, ffi_1.callJsonReturn)(() => (0, ffi_1.loadDocprims)().docprimsExtractBytesJson(sourceUri, data, optsToJson(options)));
+}
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "DocprimsError", { enumerable: true, get: function () { return errors_1.DocprimsError; } });
+Object.defineProperty(exports, "DocprimsErrorCode", { enumerable: true, get: function () { return errors_1.DocprimsErrorCode; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AASA,0BAEC;AAED,gCAEC;AAED,0CAOC;AAED,4CAYC;AAED,kCAOC;AAED,oCAYC;AA3DD,+BAAqE;AAErE,SAAS,UAAU,CAAC,IAAqB;IACxC,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC;AAED,SAAgB,OAAO;IACtB,OAAO,IAAA,kBAAY,GAAE,CAAC,eAAe,EAAE,CAAC;AACzC,CAAC;AAED,SAAgB,UAAU;IACzB,OAAO,IAAA,kBAAY,GAAE,CAAC,kBAAkB,EAAE,CAAC;AAC5C,CAAC;AAED,SAAgB,eAAe,CAC9B,QAAgB,EAChB,OAAwB;IAExB,OAAO,IAAA,oBAAc,EAAC,GAAG,EAAE,CAC1B,IAAA,kBAAY,GAAE,CAAC,uBAAuB,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CACrE,CAAC;AACH,CAAC;AAED,SAAgB,gBAAgB,CAC/B,SAAiB,EACjB,IAAgB,EAChB,OAAwB;IAExB,OAAO,IAAA,oBAAc,EAAC,GAAG,EAAE,CAC1B,IAAA,kBAAY,GAAE,CAAC,wBAAwB,CACtC,SAAS,EACT,IAAI,EACJ,UAAU,CAAC,OAAO,CAAC,CACnB,CACD,CAAC;AACH,CAAC;AAED,SAAgB,WAAW,CAC1B,QAAgB,EAChB,OAAwB;IAExB,OAAO,IAAA,oBAAc,EAAC,GAAG,EAAE,CAC1B,IAAA,kBAAY,GAAE,CAAC,uBAAuB,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAChD,CAAC;AACxB,CAAC;AAED,SAAgB,YAAY,CAC3B,SAAiB,EACjB,IAAgB,EAChB,OAAwB;IAExB,OAAO,IAAA,oBAAc,EAAC,GAAG,EAAE,CAC1B,IAAA,kBAAY,GAAE,CAAC,wBAAwB,CACtC,SAAS,EACT,IAAI,EACJ,UAAU,CAAC,OAAO,CAAC,CACnB,CACoB,CAAC;AACxB,CAAC;AAED,mCAA4D;AAAnD,uGAAA,aAAa,OAAA;AAAE,2GAAA,iBAAiB,OAAA"}

package/dist/native/index.d.ts

@@ -0,0 +1,14 @@
+/* tslint:disable */
+/* eslint-disable */
+
+/* auto-generated by NAPI-RS */
+
+export interface DocprimsCallJsonResult {
+  code: number
+  json?: string
+  message?: string
+}
+export declare function docprimsVersion(): string
+export declare function docprimsAbiVersion(): number
+export declare function docprimsExtractFileJson(path: string, optionsJson: string): DocprimsCallJsonResult
+export declare function docprimsExtractBytesJson(sourceUri: string, data: Buffer, optionsJson: string): DocprimsCallJsonResult

package/dist/native/index.js

@@ -0,0 +1,318 @@
+/* tslint:disable */
+/* eslint-disable */
+/* prettier-ignore */
+
+/* auto-generated by NAPI-RS */
+
+const { existsSync, readFileSync } = require('fs')
+const { join } = require('path')
+
+const { platform, arch } = process
+
+let nativeBinding = null
+let localFileExisted = false
+let loadError = null
+
+function isMusl() {
+  // For Node 10
+  if (!process.report || typeof process.report.getReport !== 'function') {
+    try {
+      const lddPath = require('child_process').execSync('which ldd').toString().trim()
+      return readFileSync(lddPath, 'utf8').includes('musl')
+    } catch (e) {
+      return true
+    }
+  } else {
+    const { glibcVersionRuntime } = process.report.getReport().header
+    return !glibcVersionRuntime
+  }
+}
+
+switch (platform) {
+  case 'android':
+    switch (arch) {
+      case 'arm64':
+        localFileExisted = existsSync(join(__dirname, 'docprims.android-arm64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.android-arm64.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-android-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm':
+        localFileExisted = existsSync(join(__dirname, 'docprims.android-arm-eabi.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.android-arm-eabi.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-android-arm-eabi')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Android ${arch}`)
+    }
+    break
+  case 'win32':
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(
+          join(__dirname, 'docprims.win32-x64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.win32-x64-msvc.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-win32-x64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'ia32':
+        localFileExisted = existsSync(
+          join(__dirname, 'docprims.win32-ia32-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.win32-ia32-msvc.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-win32-ia32-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'docprims.win32-arm64-msvc.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.win32-arm64-msvc.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-win32-arm64-msvc')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Windows: ${arch}`)
+    }
+    break
+  case 'darwin':
+    localFileExisted = existsSync(join(__dirname, 'docprims.darwin-universal.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./docprims.darwin-universal.node')
+      } else {
+        nativeBinding = require('@3leaps/docprims-darwin-universal')
+      }
+      break
+    } catch {}
+    switch (arch) {
+      case 'x64':
+        localFileExisted = existsSync(join(__dirname, 'docprims.darwin-x64.node'))
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.darwin-x64.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-darwin-x64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      case 'arm64':
+        localFileExisted = existsSync(
+          join(__dirname, 'docprims.darwin-arm64.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.darwin-arm64.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-darwin-arm64')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on macOS: ${arch}`)
+    }
+    break
+  case 'freebsd':
+    if (arch !== 'x64') {
+      throw new Error(`Unsupported architecture on FreeBSD: ${arch}`)
+    }
+    localFileExisted = existsSync(join(__dirname, 'docprims.freebsd-x64.node'))
+    try {
+      if (localFileExisted) {
+        nativeBinding = require('./docprims.freebsd-x64.node')
+      } else {
+        nativeBinding = require('@3leaps/docprims-freebsd-x64')
+      }
+    } catch (e) {
+      loadError = e
+    }
+    break
+  case 'linux':
+    switch (arch) {
+      case 'x64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-x64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-x64-musl.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-x64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-x64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-x64-gnu.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-x64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-arm64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-arm64-musl.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-arm64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-arm64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-arm64-gnu.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-arm64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'arm':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-arm-musleabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-arm-musleabihf.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-arm-musleabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-arm-gnueabihf.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-arm-gnueabihf.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-arm-gnueabihf')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 'riscv64':
+        if (isMusl()) {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-riscv64-musl.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-riscv64-musl.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-riscv64-musl')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        } else {
+          localFileExisted = existsSync(
+            join(__dirname, 'docprims.linux-riscv64-gnu.node')
+          )
+          try {
+            if (localFileExisted) {
+              nativeBinding = require('./docprims.linux-riscv64-gnu.node')
+            } else {
+              nativeBinding = require('@3leaps/docprims-linux-riscv64-gnu')
+            }
+          } catch (e) {
+            loadError = e
+          }
+        }
+        break
+      case 's390x':
+        localFileExisted = existsSync(
+          join(__dirname, 'docprims.linux-s390x-gnu.node')
+        )
+        try {
+          if (localFileExisted) {
+            nativeBinding = require('./docprims.linux-s390x-gnu.node')
+          } else {
+            nativeBinding = require('@3leaps/docprims-linux-s390x-gnu')
+          }
+        } catch (e) {
+          loadError = e
+        }
+        break
+      default:
+        throw new Error(`Unsupported architecture on Linux: ${arch}`)
+    }
+    break
+  default:
+    throw new Error(`Unsupported OS: ${platform}, architecture: ${arch}`)
+}
+
+if (!nativeBinding) {
+  if (loadError) {
+    throw loadError
+  }
+  throw new Error(`Failed to load native binding`)
+}
+
+const { docprimsVersion, docprimsAbiVersion, docprimsExtractFileJson, docprimsExtractBytesJson } = nativeBinding
+
+module.exports.docprimsVersion = docprimsVersion
+module.exports.docprimsAbiVersion = docprimsAbiVersion
+module.exports.docprimsExtractFileJson = docprimsExtractFileJson
+module.exports.docprimsExtractBytesJson = docprimsExtractBytesJson

package/dist/native.d.ts

@@ -0,0 +1,3 @@
+import type { DocprimsLib } from "./ffi";
+export declare function loadNativeBinding(packageRoot: string): DocprimsLib;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AAyDzC,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,CAiClE"}

package/dist/native.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadNativeBinding = loadNativeBinding;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+function isMusl() {
+    // Best-effort detection for Node on Linux.
+    // If `process.report` isn't available, default to musl (safer for container environments).
+    const report = process.report;
+    if (!report || typeof report.getReport !== "function")
+        return true;
+    try {
+        const r = report.getReport();
+        return !r?.header?.glibcVersionRuntime;
+    }
+    catch {
+        return true;
+    }
+}
+function bindingIdForRuntime() {
+    const platform = process.platform;
+    const arch = process.arch;
+    if (platform === "darwin") {
+        if (arch !== "arm64") {
+            throw new Error(`Unsupported platform for docprims: ${platform}/${arch}. ` +
+                "macOS x64 is not supported by docprims.");
+        }
+        return "darwin-arm64";
+    }
+    if (platform === "win32") {
+        if (arch === "x64")
+            return "win32-x64-msvc";
+        throw new Error(`Unsupported platform for docprims: ${platform}/${arch}`);
+    }
+    if (platform === "linux") {
+        const abi = isMusl() ? "musl" : "gnu";
+        if (arch === "x64")
+            return `linux-x64-${abi}`;
+        if (arch === "arm64")
+            return `linux-arm64-${abi}`;
+        throw new Error(`Unsupported platform for docprims: ${platform}/${arch}`);
+    }
+    throw new Error(`Unsupported platform for docprims: ${platform}/${arch}`);
+}
+function packageNameForBindingId(bindingId) {
+    return `@3leaps/docprims-${bindingId}`;
+}
+function localNodeFilename(bindingId) {
+    return `docprims.${bindingId}.node`;
+}
+function loadNativeBinding(packageRoot) {
+    const bindingId = bindingIdForRuntime();
+    const localNode = node_path_1.default.join(packageRoot, "dist", "native", localNodeFilename(bindingId));
+    const pkg = packageNameForBindingId(bindingId);
+    // Prefer local build (git checkout / local path installs).
+    if (node_fs_1.default.existsSync(localNode)) {
+        // biome-ignore lint/suspicious/noExplicitAny: napi binding is runtime-loaded
+        return require(localNode);
+    }
+    // Otherwise require the platform package (npm optional dependency).
+    try {
+        // biome-ignore lint/suspicious/noExplicitAny: napi binding is runtime-loaded
+        return require(pkg);
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        throw new Error("Failed to load docprims native addon for this platform.\n" +
+            `Expected: ${pkg}\n` +
+            "\n" +
+            "If you are installing from a git checkout or local path, build the native addon first:\n" +
+            "  npm run build:native\n" +
+            "\n" +
+            "If you are installing from npm, the platform prebuild package may be missing or failed to install.\n" +
+            `Original error: ${msg}`);
+    }
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,54 @@
+export type ExtractLimits = {
+    max_input_bytes?: number;
+    max_output_bytes?: number;
+    max_blocks?: number;
+};
+export type ExtractOptions = {
+    limits?: ExtractLimits;
+};
+export type DocprimsExtractV0 = {
+    schema_id: string;
+    schema_version: string;
+    generator: {
+        name: string;
+        version: string;
+    };
+    source: {
+        uri: string;
+        format: {
+            family: string;
+            kind: string;
+        };
+        sha256?: string | null;
+    };
+    document: {
+        quality: {
+            status: "complete" | "partial";
+            reason?: string | null;
+        };
+        text: string;
+        blocks: Array<{
+            id: string;
+            kind: string;
+            text: string;
+            doc_text_range: {
+                start_byte: number;
+                end_byte: number;
+            };
+            loc: {
+                kind: string;
+                container: {
+                    kind: "file" | "archive";
+                    path: string;
+                    part?: string | null;
+                };
+                hints: Record<string, unknown>;
+            };
+            children: string[];
+            role?: string | null;
+        }>;
+        warnings: string[];
+        metadata?: unknown;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,CAAC,EAAE,aAAa,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7C,MAAM,EAAE;QACP,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACzC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,QAAQ,EAAE;QACT,OAAO,EAAE;YAAE,MAAM,EAAE,UAAU,GAAG,SAAS,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QACpE,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,KAAK,CAAC;YACb,EAAE,EAAE,MAAM,CAAC;YACX,IAAI,EAAE,MAAM,CAAC;YACb,IAAI,EAAE,MAAM,CAAC;YACb,cAAc,EAAE;gBAAE,UAAU,EAAE,MAAM,CAAC;gBAAC,QAAQ,EAAE,MAAM,CAAA;aAAE,CAAC;YACzD,GAAG,EAAE;gBACJ,IAAI,EAAE,MAAM,CAAC;gBACb,SAAS,EAAE;oBACV,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;oBACzB,IAAI,EAAE,MAAM,CAAC;oBACb,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;iBACrB,CAAC;gBACF,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;aAC/B,CAAC;YACF,QAAQ,EAAE,MAAM,EAAE,CAAC;YACnB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;SACrB,CAAC,CAAC;QACH,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC;CACF,CAAC"}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/native/Cargo.toml

@@ -0,0 +1,25 @@
+[package]
+name = "docprims-ts-napi"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+repository.workspace = true
+authors.workspace = true
+rust-version.workspace = true
+description = "Node-API addon for @3leaps/docprims (TypeScript bindings)"
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+napi = { version = "2.16.16", default-features = false, features = ["napi8"] }
+napi-derive = "2.16.13"
+serde = { workspace = true, features = ["derive"] }
+serde_json.workspace = true
+
+docprims-core.workspace = true
+docprims-text.workspace = true
+docprims-ooxml.workspace = true
+
+[build-dependencies]
+napi-build = "2.0.1"

package/native/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    napi_build::setup();
+}

package/native/src/lib.rs

@@ -0,0 +1,214 @@
+use std::path::Path;
+
+use napi::bindgen_prelude::Buffer;
+use napi_derive::napi;
+
+use docprims_core::{DocprimsError, ExtractLimits};
+
+#[repr(i32)]
+#[derive(Debug, Clone, Copy, PartialEq, Eq)]
+pub enum DocprimsErrorCode {
+    Ok = 0,
+    Usage = 64,
+    DataInvalid = 60,
+    ResourceLimit = 70,
+    Io = 74,
+    Internal = 1,
+}
+
+fn map_err(e: &DocprimsError) -> DocprimsErrorCode {
+    match e {
+        DocprimsError::UnknownFormat(_) => DocprimsErrorCode::DataInvalid,
+        DocprimsError::Malformed(_) => DocprimsErrorCode::DataInvalid,
+        DocprimsError::Parse(_) => DocprimsErrorCode::DataInvalid,
+        DocprimsError::ResourceLimit(_) => DocprimsErrorCode::ResourceLimit,
+        DocprimsError::Io(_) => DocprimsErrorCode::Io,
+        _ => DocprimsErrorCode::Internal,
+    }
+}
+
+#[napi(object)]
+pub struct DocprimsCallJsonResult {
+    pub code: i32,
+    pub json: Option<String>,
+    pub message: Option<String>,
+}
+
+fn ok_json(json: String) -> DocprimsCallJsonResult {
+    DocprimsCallJsonResult {
+        code: DocprimsErrorCode::Ok as i32,
+        json: Some(json),
+        message: None,
+    }
+}
+
+fn err_json(code: DocprimsErrorCode, msg: impl Into<String>) -> DocprimsCallJsonResult {
+    DocprimsCallJsonResult {
+        code: code as i32,
+        json: None,
+        message: Some(msg.into()),
+    }
+}
+
+#[derive(Debug, serde::Deserialize)]
+struct DocprimsExtractOptions {
+    #[serde(default)]
+    limits: Option<ExtractLimitsOverrides>,
+}
+
+#[derive(Debug, Default, serde::Deserialize)]
+struct ExtractLimitsOverrides {
+    #[serde(default)]
+    max_input_bytes: Option<usize>,
+    #[serde(default)]
+    max_output_bytes: Option<usize>,
+    #[serde(default)]
+    max_blocks: Option<usize>,
+}
+
+fn parse_limits(options_json: &str) -> Result<ExtractLimits, DocprimsErrorCode> {
+    if options_json.trim().is_empty() {
+        return Ok(ExtractLimits::default());
+    }
+
+    let opts: DocprimsExtractOptions =
+        serde_json::from_str(options_json).map_err(|_| DocprimsErrorCode::Usage)?;
+
+    let mut limits = ExtractLimits::default();
+    if let Some(overrides) = opts.limits {
+        if let Some(v) = overrides.max_input_bytes {
+            limits.max_input_bytes = v;
+        }
+        if let Some(v) = overrides.max_output_bytes {
+            limits.max_output_bytes = v;
+        }
+        if let Some(v) = overrides.max_blocks {
+            limits.max_blocks = v;
+        }
+    }
+    Ok(limits)
+}
+
+fn ext_lowercase(s: &str) -> String {
+    Path::new(s)
+        .extension()
+        .and_then(|e| e.to_str())
+        .map(|e| e.to_lowercase())
+        .unwrap_or_default()
+}
+
+#[napi]
+pub fn docprims_version() -> String {
+    env!("CARGO_PKG_VERSION").to_string()
+}
+
+#[napi]
+pub fn docprims_abi_version() -> u32 {
+    1
+}
+
+#[napi]
+pub fn docprims_extract_file_json(path: String, options_json: String) -> DocprimsCallJsonResult {
+    let limits = match parse_limits(&options_json) {
+        Ok(l) => l,
+        Err(code) => return err_json(code, "invalid options_json"),
+    };
+
+    let ext = ext_lowercase(&path);
+    let extracted = match ext.as_str() {
+        "docx" => docprims_ooxml::extract_docx_v0(&path, limits),
+        "xlsx" => docprims_ooxml::extract_xlsx_v0(&path, limits),
+        "pptx" => docprims_ooxml::extract_pptx_v0(&path, limits),
+        "md" | "markdown" => docprims_text::extract_markdown_v0(&path, limits),
+        "html" | "htm" => docprims_text::extract_html_v0(&path, limits),
+        "xml" => docprims_text::extract_xml_v0(&path, limits),
+        _ => Err(DocprimsError::UnknownFormat(ext)),
+    };
+
+    match extracted {
+        Ok(extract) => match serde_json::to_string(&extract) {
+            Ok(s) => ok_json(s),
+            Err(e) => err_json(
+                DocprimsErrorCode::Internal,
+                format!("error serializing result: {e}"),
+            ),
+        },
+        Err(e) => {
+            let code = map_err(&e);
+            err_json(code, e.to_string())
+        }
+    }
+}
+
+#[napi]
+pub fn docprims_extract_bytes_json(
+    source_uri: String,
+    data: Buffer,
+    options_json: String,
+) -> DocprimsCallJsonResult {
+    let limits = match parse_limits(&options_json) {
+        Ok(l) => l,
+        Err(code) => return err_json(code, "invalid options_json"),
+    };
+
+    if data.len() > limits.max_input_bytes {
+        return err_json(
+            DocprimsErrorCode::ResourceLimit,
+            format!(
+                "input exceeds max_input_bytes ({} > {})",
+                data.len(),
+                limits.max_input_bytes
+            ),
+        );
+    }
+
+    let ext = ext_lowercase(&source_uri);
+    if ext.is_empty() {
+        return err_json(
+            DocprimsErrorCode::DataInvalid,
+            "unsupported format: missing extension in source_uri",
+        );
+    }
+
+    let bytes = data.as_ref();
+    let extracted = match ext.as_str() {
+        "docx" => {
+            docprims_ooxml::extract_docx_v0_reader(std::io::Cursor::new(bytes), &source_uri, limits)
+        }
+        "xlsx" => {
+            docprims_ooxml::extract_xlsx_v0_reader(std::io::Cursor::new(bytes), &source_uri, limits)
+        }
+        "pptx" => {
+            docprims_ooxml::extract_pptx_v0_reader(std::io::Cursor::new(bytes), &source_uri, limits)
+        }
+        "md" | "markdown" => match std::str::from_utf8(bytes) {
+            Ok(s) => docprims_text::markdown::extract_v0_str(s, &source_uri, limits),
+            Err(_) => Err(DocprimsError::Malformed(
+                "non-utf8 markdown input".to_string(),
+            )),
+        },
+        "html" | "htm" => match std::str::from_utf8(bytes) {
+            Ok(s) => docprims_text::html::extract_v0_str(s, &source_uri, limits),
+            Err(_) => Err(DocprimsError::Malformed("non-utf8 html input".to_string())),
+        },
+        "xml" => match std::str::from_utf8(bytes) {
+            Ok(s) => docprims_text::xml::extract_v0_str(s, &source_uri, limits),
+            Err(_) => Err(DocprimsError::Malformed("non-utf8 xml input".to_string())),
+        },
+        _ => Err(DocprimsError::UnknownFormat(ext)),
+    };
+
+    match extracted {
+        Ok(extract) => match serde_json::to_string(&extract) {
+            Ok(s) => ok_json(s),
+            Err(e) => err_json(
+                DocprimsErrorCode::Internal,
+                format!("error serializing result: {e}"),
+            ),
+        },
+        Err(e) => {
+            let code = map_err(&e);
+            err_json(code, e.to_string())
+        }
+    }
+}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@3leaps/docprims",
+  "version": "0.1.3",
+  "description": "GPL-free document text extraction (TypeScript bindings via Node-API native addon)",
+  "license": "MIT OR Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/3leaps/docprims.git",
+    "directory": "bindings/typescript/docprims"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist/",
+    "native/",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "napi": {
+    "name": "docprims",
+    "triples": {
+      "defaults": false,
+      "additional": [
+        "x86_64-unknown-linux-gnu",
+        "x86_64-unknown-linux-musl",
+        "aarch64-unknown-linux-gnu",
+        "aarch64-unknown-linux-musl",
+        "aarch64-apple-darwin",
+        "x86_64-pc-windows-msvc"
+      ]
+    }
+  },
+  "scripts": {
+    "clean": "node scripts/clean.js",
+    "build:native": "napi build --cargo-cwd native --release --platform --strip dist/native",
+    "build": "tsc -p tsconfig.build.json",
+    "build:test": "tsc -p tsconfig.test.json",
+    "test": "npm run clean && npm run build && npm run build:native && npm run build:test && node scripts/run-tests.js",
+    "test:ci": "npm run clean && npm run build && npm run build:native && npm run build:test && node scripts/run-tests.js",
+    "typecheck": "tsc -p tsconfig.build.json --noEmit"
+  },
+  "dependencies": {},
+  "optionalDependencies": {
+    "@3leaps/docprims-linux-x64-gnu": "0.1.3",
+    "@3leaps/docprims-linux-x64-musl": "0.1.3",
+    "@3leaps/docprims-linux-arm64-gnu": "0.1.3",
+    "@3leaps/docprims-linux-arm64-musl": "0.1.3",
+    "@3leaps/docprims-darwin-arm64": "0.1.3",
+    "@3leaps/docprims-win32-x64-msvc": "0.1.3"
+  },
+  "devDependencies": {
+    "@napi-rs/cli": "^2.18.4",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.6.3"
+  }
+}