@stll/anonymize 2.4.2 → 2.5.0

package/dist/native-runtime.mjs

@@ -0,0 +1,55 @@
+import { assertNativeBindingVersion } from "./native.mjs";
+import { N as setNativeBindingOverride, f as loadNativeAnonymizeBinding } from "./native-node2.mjs";
+//#region src/native-runtime.ts
+/**
+* Runtime-aware selection of the native binding.
+*
+* Node uses the fast NAPI addon (`stella_anonymize_napi.node`). Bun cannot run
+* it: the addon calls libuv functions Bun's NAPI shim does not implement
+* (`uv_get_osfhandle`), which aborts the process. The `@stll/anonymize-wasm`
+* binding exposes the identical `NativeAnonymizeBinding` surface and runs
+* cleanly under both runtimes.
+*
+* The wasm binding loads asynchronously, but most consumers (the docx and pdf
+* packages, `getDefaultNativePipeline`) call `loadNativeAnonymizeBinding()`
+* synchronously. So under Bun an entry point calls `preloadNativeBinding()`
+* once (async) at startup; it installs the wasm binding as the loader override,
+* after which every synchronous `loadNativeAnonymizeBinding()` returns it. On
+* Node this is a no-op and the NAPI path is unchanged.
+*/
+const isBunRuntime = () => typeof globalThis.Bun !== "undefined";
+let wasmBindingPromise;
+const loadWasmBinding = async () => {
+	return (await import("@stll/anonymize-wasm")).getBinding();
+};
+/**
+* Resolve the default native binding for the current runtime: the NAPI addon on
+* Node, the wasm binding on Bun (loaded and cached once).
+*/
+const loadDefaultNativeBinding = async (options = {}) => {
+	if (!isBunRuntime()) return loadNativeAnonymizeBinding(options);
+	wasmBindingPromise ??= loadWasmBinding();
+	const binding = await wasmBindingPromise;
+	if (options.expectedVersion !== void 0) assertNativeBindingVersion({
+		binding,
+		expectedVersion: options.expectedVersion
+	});
+	return binding;
+};
+let preloadPromise;
+/**
+* Under Bun, load the wasm binding once and install it as the synchronous
+* loader override so every `loadNativeAnonymizeBinding()` caller uses it. A
+* no-op on Node. Idempotent and safe to await from every entry point.
+*/
+const preloadNativeBinding = async () => {
+	if (!isBunRuntime()) return;
+	preloadPromise ??= (async () => {
+		setNativeBindingOverride(await loadDefaultNativeBinding());
+	})();
+	return preloadPromise;
+};
+//#endregion
+export { isBunRuntime, loadDefaultNativeBinding, preloadNativeBinding };
+
+//# sourceMappingURL=native-runtime.mjs.map

package/dist/native-runtime.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"native-runtime.mjs","names":[],"sources":["../src/native-runtime.ts"],"sourcesContent":["import type { NativeAnonymizeBinding } from \"./native\";\nimport {\n  assertNativeBindingVersion,\n  loadNativeAnonymizeBinding,\n  setNativeBindingOverride,\n  type LoadNativeBindingOptions,\n} from \"./native-node\";\n\n/**\n * Runtime-aware selection of the native binding.\n *\n * Node uses the fast NAPI addon (`stella_anonymize_napi.node`). Bun cannot run\n * it: the addon calls libuv functions Bun's NAPI shim does not implement\n * (`uv_get_osfhandle`), which aborts the process. The `@stll/anonymize-wasm`\n * binding exposes the identical `NativeAnonymizeBinding` surface and runs\n * cleanly under both runtimes.\n *\n * The wasm binding loads asynchronously, but most consumers (the docx and pdf\n * packages, `getDefaultNativePipeline`) call `loadNativeAnonymizeBinding()`\n * synchronously. So under Bun an entry point calls `preloadNativeBinding()`\n * once (async) at startup; it installs the wasm binding as the loader override,\n * after which every synchronous `loadNativeAnonymizeBinding()` returns it. On\n * Node this is a no-op and the NAPI path is unchanged.\n */\nexport const isBunRuntime = (): boolean =>\n  typeof (globalThis as { Bun?: unknown }).Bun !== \"undefined\";\n\nlet wasmBindingPromise: Promise<NativeAnonymizeBinding> | undefined;\n\nconst loadWasmBinding = async (): Promise<NativeAnonymizeBinding> => {\n  // Dynamic so Node never pulls the wasm binding into its module graph, and so\n  // the specifier is only resolved on the runtime that needs it.\n  const wasm = await import(\"@stll/anonymize-wasm\");\n  return wasm.getBinding();\n};\n\n/**\n * Resolve the default native binding for the current runtime: the NAPI addon on\n * Node, the wasm binding on Bun (loaded and cached once).\n */\nexport const loadDefaultNativeBinding = async (\n  options: LoadNativeBindingOptions = {},\n): Promise<NativeAnonymizeBinding> => {\n  if (!isBunRuntime()) {\n    return loadNativeAnonymizeBinding(options);\n  }\n  wasmBindingPromise ??= loadWasmBinding();\n  const binding = await wasmBindingPromise;\n  if (options.expectedVersion !== undefined) {\n    assertNativeBindingVersion({\n      binding,\n      expectedVersion: options.expectedVersion,\n    });\n  }\n  return binding;\n};\n\nlet preloadPromise: Promise<void> | undefined;\n\n/**\n * Under Bun, load the wasm binding once and install it as the synchronous\n * loader override so every `loadNativeAnonymizeBinding()` caller uses it. A\n * no-op on Node. Idempotent and safe to await from every entry point.\n */\nexport const preloadNativeBinding = async (): Promise<void> => {\n  if (!isBunRuntime()) {\n    return;\n  }\n  preloadPromise ??= (async () => {\n    setNativeBindingOverride(await loadDefaultNativeBinding());\n  })();\n  return preloadPromise;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAwBA,MAAa,qBACX,OAAQ,WAAiC,QAAQ;AAEnD,IAAI;AAEJ,MAAM,kBAAkB,YAA6C;CAInE,QAAO,MADY,OAAO,wBAAA,CACd,WAAW;AACzB;;;;;AAMA,MAAa,2BAA2B,OACtC,UAAoC,CAAC,MACD;CACpC,IAAI,CAAC,aAAa,GAChB,OAAO,2BAA2B,OAAO;CAE3C,uBAAuB,gBAAgB;CACvC,MAAM,UAAU,MAAM;CACtB,IAAI,QAAQ,oBAAoB,KAAA,GAC9B,2BAA2B;EACzB;EACA,iBAAiB,QAAQ;CAC3B,CAAC;CAEH,OAAO;AACT;AAEA,IAAI;;;;;;AAOJ,MAAa,uBAAuB,YAA2B;CAC7D,IAAI,CAAC,aAAa,GAChB;CAEF,oBAAoB,YAAY;EAC9B,yBAAyB,MAAM,yBAAyB,CAAC;CAC3D,EAAA,CAAG;CACH,OAAO;AACT"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stll/anonymize",
-  "version": "2.4.2",
+  "version": "2.5.0",
   "description": "Deterministic PII detection and anonymization with regex, deny lists, and coreference resolution",
   "keywords": [
     "anonymization",
@@ -27,6 +27,16 @@
       "import": "./dist/capabilities.mjs",
       "default": "./dist/capabilities.mjs"
     },
+    "./agent-surface": {
+      "types": "./dist/agent-surface.d.mts",
+      "import": "./dist/agent-surface.mjs",
+      "default": "./dist/agent-surface.mjs"
+    },
+    "./feedback": {
+      "types": "./dist/feedback.d.mts",
+      "import": "./dist/feedback.mjs",
+      "default": "./dist/feedback.mjs"
+    },
     "./native": {
       "types": "./dist/native.d.mts",
       "import": "./dist/native.mjs",
@@ -36,6 +46,11 @@
       "types": "./dist/native-node.d.mts",
       "import": "./dist/native-node.mjs",
       "default": "./dist/native-node.mjs"
+    },
+    "./native-runtime": {
+      "types": "./dist/native-runtime.d.mts",
+      "import": "./dist/native-runtime.mjs",
+      "default": "./dist/native-runtime.mjs"
     }
   },
   "types": "dist/index.d.mts",
@@ -89,11 +104,12 @@
     }
   },
   "optionalDependencies": {
-    "@stll/anonymize-darwin-arm64": "2.4.2",
-    "@stll/anonymize-darwin-x64": "2.4.2",
-    "@stll/anonymize-linux-arm64-gnu": "2.4.2",
-    "@stll/anonymize-linux-x64-gnu": "2.4.2",
-    "@stll/anonymize-win32-x64-msvc": "2.4.2"
+    "@stll/anonymize-wasm": "2.5.0",
+    "@stll/anonymize-darwin-arm64": "2.5.0",
+    "@stll/anonymize-darwin-x64": "2.5.0",
+    "@stll/anonymize-linux-arm64-gnu": "2.5.0",
+    "@stll/anonymize-linux-x64-gnu": "2.5.0",
+    "@stll/anonymize-win32-x64-msvc": "2.5.0"
   },
   "devDependencies": {
     "@napi-rs/cli": "^3.7.3",