@mks2508/hyperdiff-napi 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { type IFFIAdapter } from '@mks2508/hyperdiff-utils';
+/**
+ * Create an N-API adapter for the Hyperdiff engine.
+ *
+ * Loads the precompiled hyperdiff.node addon.
+ * The addon handles all struct parsing in C — no JS pointer arithmetic needed.
+ *
+ * @returns IFFIAdapter implementation backed by .node addon
+ */
+export declare function createNapiAdapter(): IFFIAdapter;

package/dist/index.js

@@ -0,0 +1,100 @@
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+import "@mks2508/hyperdiff-utils";
+//#region src/index.ts
+/**
+* N-API adapter for the Hyperdiff Zig engine.
+*
+* Loads the compiled .node addon (which statically links libhyperdiff).
+* Works in both Node.js and Bun.
+*
+* The .node addon handles struct reading in C — so compute() returns
+* fully parsed JS objects directly (no pointer reading in JS).
+*/
+/**
+* Create an N-API adapter for the Hyperdiff engine.
+*
+* Loads the precompiled hyperdiff.node addon.
+* The addon handles all struct parsing in C — no JS pointer arithmetic needed.
+*
+* @returns IFFIAdapter implementation backed by .node addon
+*/
+function createNapiAdapter() {
+	const require = createRequire(import.meta.url);
+	let addon;
+	try {
+		addon = require(join(dirname(fileURLToPath(import.meta.url)), "..", "build", "Release", "hyperdiff.node"));
+	} catch {
+		throw new Error("@mks2508/hyperdiff-napi: Failed to load hyperdiff.node. Run `node-gyp rebuild` in core/packages/napi/ first. Requires: Zig build (libhyperdiff_static.a) + C compiler.");
+	}
+	let lastEdits = [];
+	let lastHunks = [];
+	let lastContents = [];
+	return {
+		runtime: "napi",
+		compute(oldText, newText, algorithm) {
+			const oldBuf = Buffer.from(oldText, "utf-8");
+			const newBuf = Buffer.from(newText, "utf-8");
+			const result = addon.compute(oldBuf, newBuf, algorithm);
+			lastEdits = result.edits;
+			return {
+				editsPtr: 0,
+				editCount: result.editCount,
+				errorCode: result.errorCode
+			};
+		},
+		free(_resultPtr) {},
+		ping() {
+			return addon.ping();
+		},
+		ceditSize() {
+			return addon.ceditSize();
+		},
+		abiVersion() {
+			return addon.abiVersion();
+		},
+		readEdits(_editsPtr, _editCount) {
+			return lastEdits;
+		},
+		metadata(oldText, newText, algorithm, contextLines, flags = 0) {
+			const oldBuf = Buffer.from(oldText, "utf-8");
+			const newBuf = Buffer.from(newText, "utf-8");
+			const result = addon.metadata(oldBuf, newBuf, algorithm, contextLines, flags);
+			lastHunks = result.hunks;
+			lastContents = result.contents;
+			return {
+				hunksPtr: 0,
+				hunkCount: result.hunkCount,
+				contentsPtr: 0,
+				contentCount: result.contentCount,
+				splitLineCount: result.splitLineCount,
+				unifiedLineCount: result.unifiedLineCount,
+				oldLineCount: result.oldLineCount,
+				newLineCount: result.newLineCount,
+				errorCode: result.errorCode
+			};
+		},
+		readHunks(_hunksPtr, _hunkCount) {
+			return lastHunks;
+		},
+		readContents(_contentsPtr, _contentCount) {
+			return lastContents;
+		},
+		metadataFree(_hunksPtr, _hunkCount, _contentsPtr, _contentCount) {},
+		patch(oldText, newText, algorithm, contextLines) {
+			const oldBuf = Buffer.from(oldText, "utf-8");
+			const newBuf = Buffer.from(newText, "utf-8");
+			return addon.patch(oldBuf, newBuf, algorithm, contextLines);
+		},
+		inlineDiff(oldLine, newLine, mode) {
+			const oldBuf = Buffer.from(oldLine, "utf-8");
+			const newBuf = Buffer.from(newLine, "utf-8");
+			return addon.inlineDiff(oldBuf, newBuf, mode);
+		}
+	};
+}
+//#endregion
+export { createNapiAdapter };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * N-API adapter for the Hyperdiff Zig engine.\n *\n * Loads the compiled .node addon (which statically links libhyperdiff).\n * Works in both Node.js and Bun.\n *\n * The .node addon handles struct reading in C — so compute() returns\n * fully parsed JS objects directly (no pointer reading in JS).\n */\nimport { createRequire } from 'node:module';\nimport { join, dirname } from 'node:path';\nimport { fileURLToPath } from 'node:url';\nimport {\n  type IRawDiffEdit,\n  type IRawDiffResult,\n  type IRawMetadataResult,\n  type IRawHunk,\n  type IRawContent,\n  type IFFIAdapter,\n} from '@mks2508/hyperdiff-utils';\n\n/** Native addon exports. */\ninterface INativeAddon {\n  compute(oldBuf: Buffer, newBuf: Buffer, algorithm: number): {\n    edits: IRawDiffEdit[];\n    editCount: number;\n    errorCode: number;\n  };\n  patch(oldBuf: Buffer, newBuf: Buffer, algorithm: number, contextLines: number): string;\n  inlineDiff(oldBuf: Buffer, newBuf: Buffer, mode: number): IRawDiffEdit[];\n  metadata(oldBuf: Buffer, newBuf: Buffer, algorithm: number, contextLines: number, flags: number): {\n    hunks: IRawHunk[];\n    contents: IRawContent[];\n    hunkCount: number;\n    contentCount: number;\n    splitLineCount: number;\n    unifiedLineCount: number;\n    oldLineCount: number;\n    newLineCount: number;\n    errorCode: number;\n  };\n  ping(): number;\n  ceditSize(): number;\n  abiVersion(): number;\n}\n\n/**\n * Create an N-API adapter for the Hyperdiff engine.\n *\n * Loads the precompiled hyperdiff.node addon.\n * The addon handles all struct parsing in C — no JS pointer arithmetic needed.\n *\n * @returns IFFIAdapter implementation backed by .node addon\n */\nexport function createNapiAdapter(): IFFIAdapter {\n  const require = createRequire(import.meta.url);\n\n  let addon: INativeAddon;\n  try {\n    // node-gyp outputs to build/Release/hyperdiff.node\n    const __dir = dirname(fileURLToPath(import.meta.url));\n    addon = require(join(__dir, '..', 'build', 'Release', 'hyperdiff.node'));\n  } catch {\n    throw new Error(\n      '@mks2508/hyperdiff-napi: Failed to load hyperdiff.node. ' +\n        'Run `node-gyp rebuild` in core/packages/napi/ first. ' +\n        'Requires: Zig build (libhyperdiff_static.a) + C compiler.',\n    );\n  }\n\n  // The N-API addon does struct parsing in C and returns JS objects directly.\n  // Cache last results for read* methods.\n  let lastEdits: IRawDiffEdit[] = [];\n  let lastHunks: IRawHunk[] = [];\n  let lastContents: IRawContent[] = [];\n\n  return {\n    runtime: 'napi',\n\n    compute(oldText: string, newText: string, algorithm: number): IRawDiffResult {\n      const oldBuf = Buffer.from(oldText, 'utf-8');\n      const newBuf = Buffer.from(newText, 'utf-8');\n\n      const result = addon.compute(oldBuf, newBuf, algorithm);\n      lastEdits = result.edits;\n\n      // N-API addon returns parsed objects (no raw pointer).\n      // editsPtr is not meaningful here — adapter handles it.\n      return {\n        editsPtr: 0,\n        editCount: result.editCount,\n        errorCode: result.errorCode,\n      };\n    },\n\n    free(_resultPtr: number): void {\n      // N-API addon frees Zig memory in C before returning. No-op here.\n    },\n\n    ping(): number {\n      return addon.ping();\n    },\n\n    ceditSize(): number {\n      return addon.ceditSize();\n    },\n\n    abiVersion(): number {\n      return addon.abiVersion();\n    },\n\n    readEdits(_editsPtr: number, _editCount: number): IRawDiffEdit[] {\n      // Already parsed by the C addon during compute().\n      return lastEdits;\n    },\n\n    metadata(oldText: string, newText: string, algorithm: number, contextLines: number, flags: number = 0): IRawMetadataResult {\n      const oldBuf = Buffer.from(oldText, 'utf-8');\n      const newBuf = Buffer.from(newText, 'utf-8');\n\n      const result = addon.metadata(oldBuf, newBuf, algorithm, contextLines, flags);\n\n      // N-API addon returns fully parsed JS objects + frees Zig memory in C.\n      // Cache hunks/contents for readHunks/readContents.\n      lastHunks = result.hunks;\n      lastContents = result.contents;\n\n      return {\n        hunksPtr: 0,\n        hunkCount: result.hunkCount,\n        contentsPtr: 0,\n        contentCount: result.contentCount,\n        splitLineCount: result.splitLineCount,\n        unifiedLineCount: result.unifiedLineCount,\n        oldLineCount: result.oldLineCount,\n        newLineCount: result.newLineCount,\n        errorCode: result.errorCode,\n      };\n    },\n\n    readHunks(_hunksPtr: number, _hunkCount: number): IRawHunk[] {\n      return lastHunks;\n    },\n\n    readContents(_contentsPtr: number, _contentCount: number): IRawContent[] {\n      return lastContents;\n    },\n\n    metadataFree(_hunksPtr: number, _hunkCount: number, _contentsPtr: number, _contentCount: number): void {\n      // N-API addon frees Zig memory in C before returning. No-op here.\n    },\n\n    patch(oldText: string, newText: string, algorithm: number, contextLines: number): string {\n      const oldBuf = Buffer.from(oldText, 'utf-8');\n      const newBuf = Buffer.from(newText, 'utf-8');\n      return addon.patch(oldBuf, newBuf, algorithm, contextLines);\n    },\n\n    inlineDiff(oldLine: string, newLine: string, mode: number): IRawDiffEdit[] {\n      const oldBuf = Buffer.from(oldLine, 'utf-8');\n      const newBuf = Buffer.from(newLine, 'utf-8');\n      return addon.inlineDiff(oldBuf, newBuf, mode);\n    },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAsDA,SAAgB,oBAAiC;CAC/C,MAAM,UAAU,cAAc,OAAO,KAAK,IAAI;CAE9C,IAAI;AACJ,KAAI;AAGF,UAAQ,QAAQ,KADF,QAAQ,cAAc,OAAO,KAAK,IAAI,CAAC,EACzB,MAAM,SAAS,WAAW,iBAAiB,CAAC;SAClE;AACN,QAAM,IAAI,MACR,yKAGD;;CAKH,IAAI,YAA4B,EAAE;CAClC,IAAI,YAAwB,EAAE;CAC9B,IAAI,eAA8B,EAAE;AAEpC,QAAO;EACL,SAAS;EAET,QAAQ,SAAiB,SAAiB,WAAmC;GAC3E,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;GAC5C,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;GAE5C,MAAM,SAAS,MAAM,QAAQ,QAAQ,QAAQ,UAAU;AACvD,eAAY,OAAO;AAInB,UAAO;IACL,UAAU;IACV,WAAW,OAAO;IAClB,WAAW,OAAO;IACnB;;EAGH,KAAK,YAA0B;EAI/B,OAAe;AACb,UAAO,MAAM,MAAM;;EAGrB,YAAoB;AAClB,UAAO,MAAM,WAAW;;EAG1B,aAAqB;AACnB,UAAO,MAAM,YAAY;;EAG3B,UAAU,WAAmB,YAAoC;AAE/D,UAAO;;EAGT,SAAS,SAAiB,SAAiB,WAAmB,cAAsB,QAAgB,GAAuB;GACzH,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;GAC5C,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;GAE5C,MAAM,SAAS,MAAM,SAAS,QAAQ,QAAQ,WAAW,cAAc,MAAM;AAI7E,eAAY,OAAO;AACnB,kBAAe,OAAO;AAEtB,UAAO;IACL,UAAU;IACV,WAAW,OAAO;IAClB,aAAa;IACb,cAAc,OAAO;IACrB,gBAAgB,OAAO;IACvB,kBAAkB,OAAO;IACzB,cAAc,OAAO;IACrB,cAAc,OAAO;IACrB,WAAW,OAAO;IACnB;;EAGH,UAAU,WAAmB,YAAgC;AAC3D,UAAO;;EAGT,aAAa,cAAsB,eAAsC;AACvE,UAAO;;EAGT,aAAa,WAAmB,YAAoB,cAAsB,eAA6B;EAIvG,MAAM,SAAiB,SAAiB,WAAmB,cAA8B;GACvF,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;GAC5C,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;AAC5C,UAAO,MAAM,MAAM,QAAQ,QAAQ,WAAW,aAAa;;EAG7D,WAAW,SAAiB,SAAiB,MAA8B;GACzE,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;GAC5C,MAAM,SAAS,OAAO,KAAK,SAAS,QAAQ;AAC5C,UAAO,MAAM,WAAW,QAAQ,QAAQ,KAAK;;EAEhD"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@mks2508/hyperdiff-napi",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "build/Release/hyperdiff.node"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "prebuild": "node scripts/configure.mjs",
+    "build:native": "node-gyp rebuild",
+    "build": "rm -rf dist && ../../../node_modules/.bin/rolldown --config rolldown.config.ts && ../../../node_modules/.bin/tsc --emitDeclarationOnly",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@mks2508/hyperdiff-utils": "workspace:*",
+    "node-gyp": "^10.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0"
+  },
+  "gypfile": true
+}