bunite-core 0.0.1

package/src/native/win/process_helper_win.cpp

@@ -0,0 +1,26 @@
+#include "include/cef_app.h"
+
+#include <windows.h>
+
+class BuniteHelperApp : public CefApp {
+public:
+  void OnRegisterCustomSchemes(CefRawPtr<CefSchemeRegistrar> registrar) override {
+    registrar->AddCustomScheme(
+      "views",
+      CEF_SCHEME_OPTION_STANDARD |
+        CEF_SCHEME_OPTION_CORS_ENABLED |
+        CEF_SCHEME_OPTION_SECURE |
+        CEF_SCHEME_OPTION_CSP_BYPASSING |
+        CEF_SCHEME_OPTION_FETCH_ENABLED
+    );
+  }
+
+private:
+  IMPLEMENT_REFCOUNTING(BuniteHelperApp);
+};
+
+int APIENTRY wWinMain(HINSTANCE hInstance, HINSTANCE, PWSTR, int) {
+  CefMainArgs main_args(hInstance);
+  CefRefPtr<CefApp> app = new BuniteHelperApp();
+  return CefExecuteProcess(main_args, app, nullptr);
+}

package/src/preload/runtime.built.js

@@ -0,0 +1 @@
+var W=(()=>{let F;return()=>{if(!F){let q=Uint8Array.from(atob(__buniteSecretKeyBase64),(H)=>H.charCodeAt(0));F=crypto.subtle.importKey("raw",q,"AES-GCM",!1,["encrypt","decrypt"])}return F}})();async function X(F){let q=await W(),H=crypto.getRandomValues(new Uint8Array(12)),A=new Uint8Array(await crypto.subtle.encrypt({name:"AES-GCM",iv:H},q,F)),z=new Uint8Array(1+H.length+A.length);return z[0]=1,z.set(H,1),z.set(A,1+H.length),z}async function Y(F){if(F.length<29)throw Error("Invalid bunite RPC frame.");if(F[0]!==1)throw Error("Unsupported bunite RPC frame version.");let q=await W(),H=F.slice(1,13),A=F.slice(13);return new Uint8Array(await crypto.subtle.decrypt({name:"AES-GCM",iv:H},q,A))}function B(F){let q=[];function H(A){if(A===null||A===void 0)q.push(192);else if(A===!0)q.push(195);else if(A===!1)q.push(194);else if(typeof A==="number")if(Number.isInteger(A)&&A>=0&&A<128)q.push(A);else if(Number.isInteger(A)&&A>=-32&&A<0)q.push(A&255);else if(Number.isInteger(A)&&A>=0&&A<=65535)q.push(205,A>>8&255,A&255);else if(Number.isInteger(A)&&A>=0&&A<=4294967295)q.push(206,A>>24&255,A>>16&255,A>>8&255,A&255);else{let z=new ArrayBuffer(9),G=new DataView(z);G.setUint8(0,203),G.setFloat64(1,A);for(let J=0;J<9;J++)q.push(G.getUint8(J))}else if(typeof A==="string"){let z=new TextEncoder().encode(A);if(z.length<32)q.push(160|z.length);else if(z.length<256)q.push(217,z.length);else if(z.length<65536)q.push(218,z.length>>8&255,z.length&255);else q.push(219,z.length>>24&255,z.length>>16&255,z.length>>8&255,z.length&255);for(let G=0;G<z.length;G++)q.push(z[G])}else if(Array.isArray(A)){if(A.length<16)q.push(144|A.length);else if(A.length<65536)q.push(220,A.length>>8&255,A.length&255);else q.push(221,A.length>>24&255,A.length>>16&255,A.length>>8&255,A.length&255);A.forEach(H)}else if(typeof A==="object"){let z=Object.keys(A);if(z.length<16)q.push(128|z.length);else if(z.length<65536)q.push(222,z.length>>8&255,z.length&255);else q.push(223,z.length>>24&255,z.length>>16&255,z.length>>8&255,z.length&255);for(let G of z)H(G),H(A[G])}}return H(F),new Uint8Array(q)}function I(F){let q=0;function H(){let A=F[q++];if(A<=127)return A;if(A>=224)return A-256;if(A===192)return null;if(A===194)return!1;if(A===195)return!0;if(A===204)return F[q++];if(A===205){let z=F[q]<<8|F[q+1];return q+=2,z}if(A===206){let z=(F[q]<<24|F[q+1]<<16|F[q+2]<<8|F[q+3])>>>0;return q+=4,z}if(A===203){let z=new DataView(F.buffer,F.byteOffset+q,8);return q+=8,z.getFloat64(0)}if(A===208){let z=F[q++];return z>127?z-256:z}if(A===209){let z=F[q]<<8|F[q+1];return q+=2,z>32767?z-65536:z}if(A===210){let z=F[q]<<24|F[q+1]<<16|F[q+2]<<8|F[q+3];return q+=4,z}if((A&224)===160){let z=A&31,G=new TextDecoder().decode(F.subarray(q,q+z));return q+=z,G}if(A===217){let z=F[q++],G=new TextDecoder().decode(F.subarray(q,q+z));return q+=z,G}if(A===218){let z=F[q]<<8|F[q+1];q+=2;let G=new TextDecoder().decode(F.subarray(q,q+z));return q+=z,G}if(A===219){let z=(F[q]<<24|F[q+1]<<16|F[q+2]<<8|F[q+3])>>>0;q+=4;let G=new TextDecoder().decode(F.subarray(q,q+z));return q+=z,G}if((A&240)===144){let z=A&15,G=[];for(let J=0;J<z;J++)G.push(H());return G}if(A===220){let z=F[q]<<8|F[q+1];q+=2;let G=[];for(let J=0;J<z;J++)G.push(H());return G}if(A===221){let z=(F[q]<<24|F[q+1]<<16|F[q+2]<<8|F[q+3])>>>0;q+=4;let G=[];for(let J=0;J<z;J++)G.push(H());return G}if((A&240)===128){let z=A&15,G={};for(let J=0;J<z;J++)G[H()]=H();return G}if(A===222){let z=F[q]<<8|F[q+1];q+=2;let G={};for(let J=0;J<z;J++)G[H()]=H();return G}if(A===223){let z=(F[q]<<24|F[q+1]<<16|F[q+2]<<8|F[q+3])>>>0;q+=4;let G={};for(let J=0;J<z;J++)G[H()]=H();return G}if(A===196){let z=F[q++],G=F.slice(q,q+z);return q+=z,G}if(A===197){let z=F[q]<<8|F[q+1];q+=2;let G=F.slice(q,q+z);return q+=z,G}return}return H()}var N=window;N.__bunite??={};N.__buniteWebviewId=__buniteWebviewId;N.__buniteRpcSocketPort=__buniteRpcSocketPort;N.__bunite_encrypt=X;N.__bunite_decrypt=Y;N.bunite=N.__bunite;N.bunite.invoke=(()=>{let F=null,q=1,H=new Map;function A(){let G=N.__bunite?._socket;if(G&&G.readyState<=WebSocket.OPEN&&G!==F)return F=G,z(G),G;if(F&&F.readyState<=WebSocket.OPEN)return F;return F=new WebSocket(`ws://localhost:${__buniteRpcSocketPort}/socket?webviewId=${__buniteWebviewId}`),F.binaryType="arraybuffer",N.__bunite._socket=F,z(F),F}function z(G){G.addEventListener("message",async(J)=>{try{let Q=await Y(new Uint8Array(J.data)),M=I(Q);if(M?.type==="response"&&M.scope==="global"){let O=H.get(M.id);if(O)H.delete(M.id),clearTimeout(O.timeout),M.success?O.resolve(M.payload):O.reject(Error(M.error||"Unknown error"))}}catch{}})}return(G,J)=>new Promise((Q,M)=>{let O=A(),T=q++,Z=setTimeout(()=>{H.delete(T),M(Error(`bunite.invoke timed out: ${G}`))},15000);H.set(T,{resolve:Q,reject:M,timeout:Z});let _={type:"request",id:T,method:G,params:J??null,scope:"global"},U=async()=>{let $=await X(B(_));O.send($.buffer)};if(O.readyState===WebSocket.OPEN)U();else O.addEventListener("open",()=>U(),{once:!0})})})();

package/src/preload/runtime.ts

@@ -0,0 +1,215 @@
+// Preload runtime — built once at package build time, injected into every views:// page.
+// The config variables (__buniteWebviewId, __buniteRpcSocketPort, __buniteSecretKeyBase64)
+// are injected by inline.ts as a small preamble before this script.
+
+declare const __buniteWebviewId: number;
+declare const __buniteRpcSocketPort: number;
+declare const __buniteSecretKeyBase64: string;
+
+const RPC_FRAME_VERSION = 1;
+const RPC_IV_LENGTH = 12;
+
+// --- Crypto key (lazy) ---
+
+const getCryptoKey = (() => {
+  let keyPromise: Promise<CryptoKey>;
+  return () => {
+    if (!keyPromise) {
+      const raw = Uint8Array.from(atob(__buniteSecretKeyBase64), c => c.charCodeAt(0));
+      keyPromise = crypto.subtle.importKey("raw", raw, "AES-GCM", false, ["encrypt", "decrypt"]);
+    }
+    return keyPromise;
+  };
+})();
+
+async function buniteEncrypt(data: Uint8Array): Promise<Uint8Array> {
+  const key = await getCryptoKey();
+  const iv = crypto.getRandomValues(new Uint8Array(RPC_IV_LENGTH));
+  const encrypted = new Uint8Array(await crypto.subtle.encrypt({ name: "AES-GCM", iv }, key, data as unknown as ArrayBuffer));
+  const frame = new Uint8Array(1 + iv.length + encrypted.length);
+  frame[0] = RPC_FRAME_VERSION;
+  frame.set(iv, 1);
+  frame.set(encrypted, 1 + iv.length);
+  return frame;
+}
+
+async function buniteDecrypt(frame: Uint8Array): Promise<Uint8Array> {
+  if (frame.length < 1 + RPC_IV_LENGTH + 16) {
+    throw new Error("Invalid bunite RPC frame.");
+  }
+  if (frame[0] !== RPC_FRAME_VERSION) {
+    throw new Error("Unsupported bunite RPC frame version.");
+  }
+  const key = await getCryptoKey();
+  const iv = frame.slice(1, 1 + RPC_IV_LENGTH);
+  const encrypted = frame.slice(1 + RPC_IV_LENGTH);
+  return new Uint8Array(await crypto.subtle.decrypt({ name: "AES-GCM", iv }, key, encrypted));
+}
+
+// --- Minimal msgpack encoder/decoder ---
+
+function mpEncode(val: unknown): Uint8Array {
+  const parts: number[] = [];
+
+  function w(v: unknown): void {
+    if (v === null || v === undefined) {
+      parts.push(0xc0);
+    } else if (v === true) {
+      parts.push(0xc3);
+    } else if (v === false) {
+      parts.push(0xc2);
+    } else if (typeof v === "number") {
+      if (Number.isInteger(v) && v >= 0 && v < 128) {
+        parts.push(v);
+      } else if (Number.isInteger(v) && v >= -32 && v < 0) {
+        parts.push(v & 0xff);
+      } else if (Number.isInteger(v) && v >= 0 && v <= 0xffff) {
+        parts.push(0xcd, (v >> 8) & 0xff, v & 0xff);
+      } else if (Number.isInteger(v) && v >= 0 && v <= 0xffffffff) {
+        parts.push(0xce, (v >> 24) & 0xff, (v >> 16) & 0xff, (v >> 8) & 0xff, v & 0xff);
+      } else {
+        const b = new ArrayBuffer(9);
+        const dv = new DataView(b);
+        dv.setUint8(0, 0xcb);
+        dv.setFloat64(1, v);
+        for (let i = 0; i < 9; i++) parts.push(dv.getUint8(i));
+      }
+    } else if (typeof v === "string") {
+      const bytes = new TextEncoder().encode(v);
+      if (bytes.length < 32) parts.push(0xa0 | bytes.length);
+      else if (bytes.length < 256) parts.push(0xd9, bytes.length);
+      else if (bytes.length < 65536) parts.push(0xda, (bytes.length >> 8) & 0xff, bytes.length & 0xff);
+      else parts.push(0xdb, (bytes.length >> 24) & 0xff, (bytes.length >> 16) & 0xff, (bytes.length >> 8) & 0xff, bytes.length & 0xff);
+      for (let i = 0; i < bytes.length; i++) parts.push(bytes[i]);
+    } else if (Array.isArray(v)) {
+      if (v.length < 16) parts.push(0x90 | v.length);
+      else if (v.length < 65536) parts.push(0xdc, (v.length >> 8) & 0xff, v.length & 0xff);
+      else parts.push(0xdd, (v.length >> 24) & 0xff, (v.length >> 16) & 0xff, (v.length >> 8) & 0xff, v.length & 0xff);
+      v.forEach(w);
+    } else if (typeof v === "object") {
+      const keys = Object.keys(v as Record<string, unknown>);
+      if (keys.length < 16) parts.push(0x80 | keys.length);
+      else if (keys.length < 65536) parts.push(0xde, (keys.length >> 8) & 0xff, keys.length & 0xff);
+      else parts.push(0xdf, (keys.length >> 24) & 0xff, (keys.length >> 16) & 0xff, (keys.length >> 8) & 0xff, keys.length & 0xff);
+      for (const k of keys) { w(k); w((v as Record<string, unknown>)[k]); }
+    }
+  }
+
+  w(val);
+  return new Uint8Array(parts);
+}
+
+function mpDecode(buf: Uint8Array): unknown {
+  let pos = 0;
+
+  function r(): unknown {
+    const b = buf[pos++];
+    if (b <= 0x7f) return b;
+    if (b >= 0xe0) return b - 256;
+    if (b === 0xc0) return null;
+    if (b === 0xc2) return false;
+    if (b === 0xc3) return true;
+    if (b === 0xcc) return buf[pos++];
+    if (b === 0xcd) { const v = (buf[pos] << 8) | buf[pos + 1]; pos += 2; return v; }
+    if (b === 0xce) { const v = ((buf[pos] << 24) | (buf[pos + 1] << 16) | (buf[pos + 2] << 8) | buf[pos + 3]) >>> 0; pos += 4; return v; }
+    if (b === 0xcb) { const dv = new DataView(buf.buffer, buf.byteOffset + pos, 8); pos += 8; return dv.getFloat64(0); }
+    if (b === 0xd0) { const v = buf[pos++]; return v > 127 ? v - 256 : v; }
+    if (b === 0xd1) { const v = (buf[pos] << 8) | buf[pos + 1]; pos += 2; return v > 32767 ? v - 65536 : v; }
+    if (b === 0xd2) { const v = (buf[pos] << 24) | (buf[pos + 1] << 16) | (buf[pos + 2] << 8) | buf[pos + 3]; pos += 4; return v; }
+    // fixstr
+    if ((b & 0xe0) === 0xa0) { const len = b & 0x1f; const s = new TextDecoder().decode(buf.subarray(pos, pos + len)); pos += len; return s; }
+    if (b === 0xd9) { const len = buf[pos++]; const s = new TextDecoder().decode(buf.subarray(pos, pos + len)); pos += len; return s; }
+    if (b === 0xda) { const len = (buf[pos] << 8) | buf[pos + 1]; pos += 2; const s = new TextDecoder().decode(buf.subarray(pos, pos + len)); pos += len; return s; }
+    if (b === 0xdb) { const len = ((buf[pos] << 24) | (buf[pos + 1] << 16) | (buf[pos + 2] << 8) | buf[pos + 3]) >>> 0; pos += 4; const s = new TextDecoder().decode(buf.subarray(pos, pos + len)); pos += len; return s; }
+    // fixarray
+    if ((b & 0xf0) === 0x90) { const len = b & 0x0f; const arr: unknown[] = []; for (let i = 0; i < len; i++) arr.push(r()); return arr; }
+    if (b === 0xdc) { const len = (buf[pos] << 8) | buf[pos + 1]; pos += 2; const arr: unknown[] = []; for (let i = 0; i < len; i++) arr.push(r()); return arr; }
+    if (b === 0xdd) { const len = ((buf[pos] << 24) | (buf[pos + 1] << 16) | (buf[pos + 2] << 8) | buf[pos + 3]) >>> 0; pos += 4; const arr: unknown[] = []; for (let i = 0; i < len; i++) arr.push(r()); return arr; }
+    // fixmap
+    if ((b & 0xf0) === 0x80) { const len = b & 0x0f; const obj: Record<string, unknown> = {}; for (let i = 0; i < len; i++) { obj[r() as string] = r(); } return obj; }
+    if (b === 0xde) { const len = (buf[pos] << 8) | buf[pos + 1]; pos += 2; const obj: Record<string, unknown> = {}; for (let i = 0; i < len; i++) { obj[r() as string] = r(); } return obj; }
+    if (b === 0xdf) { const len = ((buf[pos] << 24) | (buf[pos + 1] << 16) | (buf[pos + 2] << 8) | buf[pos + 3]) >>> 0; pos += 4; const obj: Record<string, unknown> = {}; for (let i = 0; i < len; i++) { obj[r() as string] = r(); } return obj; }
+    // bin8, bin16
+    if (b === 0xc4) { const len = buf[pos++]; const bin = buf.slice(pos, pos + len); pos += len; return bin; }
+    if (b === 0xc5) { const len = (buf[pos] << 8) | buf[pos + 1]; pos += 2; const bin = buf.slice(pos, pos + len); pos += len; return bin; }
+    return undefined;
+  }
+
+  return r();
+}
+
+// --- Expose globals ---
+
+const w = window as any;
+w.__bunite ??= {};
+w.__buniteWebviewId = __buniteWebviewId;
+w.__buniteRpcSocketPort = __buniteRpcSocketPort;
+w.__bunite_encrypt = buniteEncrypt;
+w.__bunite_decrypt = buniteDecrypt;
+
+// --- bunite.invoke: global IPC ---
+
+w.bunite = w.__bunite;
+w.bunite.invoke = (() => {
+  let socket: WebSocket | null = null;
+  let nextId = 1;
+  const pending = new Map<number, { resolve: (v: unknown) => void; reject: (e: Error) => void; timeout: ReturnType<typeof setTimeout> }>();
+
+  function ensureSocket(): WebSocket {
+    // Reuse socket opened by BuniteView if available
+    const existing = w.__bunite?._socket;
+    if (existing && existing.readyState <= WebSocket.OPEN && existing !== socket) {
+      socket = existing;
+      attachListener(existing);
+      return existing;
+    }
+    if (socket && socket.readyState <= WebSocket.OPEN) return socket;
+    socket = new WebSocket(
+      `ws://localhost:${__buniteRpcSocketPort}/socket?webviewId=${__buniteWebviewId}`
+    );
+    socket.binaryType = "arraybuffer";
+    w.__bunite._socket = socket;
+    attachListener(socket);
+    return socket;
+  }
+
+  function attachListener(ws: WebSocket) {
+    ws.addEventListener("message", async (event) => {
+      try {
+        const decrypted = await buniteDecrypt(new Uint8Array(event.data as ArrayBuffer));
+        const packet = mpDecode(decrypted) as any;
+        if (packet?.type === "response" && packet.scope === "global") {
+          const p = pending.get(packet.id);
+          if (p) {
+            pending.delete(packet.id);
+            clearTimeout(p.timeout);
+            packet.success ? p.resolve(packet.payload) : p.reject(new Error(packet.error || "Unknown error"));
+          }
+        }
+      } catch { /* ignore malformed frames */ }
+    });
+  }
+
+  return (method: string, params?: unknown) =>
+    new Promise((resolve, reject) => {
+      const ws = ensureSocket();
+      const id = nextId++;
+      const timeout = setTimeout(() => {
+        pending.delete(id);
+        reject(new Error(`bunite.invoke timed out: ${method}`));
+      }, 15000);
+      pending.set(id, { resolve, reject, timeout });
+
+      const packet = { type: "request", id, method, params: params ?? null, scope: "global" };
+      const doSend = async () => {
+        const encrypted = await buniteEncrypt(mpEncode(packet));
+        ws.send(encrypted.buffer as ArrayBuffer);
+      };
+
+      if (ws.readyState === WebSocket.OPEN) {
+        doSend();
+      } else {
+        ws.addEventListener("open", () => doSend(), { once: true });
+      }
+    });
+})();

package/src/preload/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022", "DOM"],
+    "strict": true,
+    "exactOptionalPropertyTypes": false,
+    "skipLibCheck": true,
+    "noEmit": true
+  },
+  "include": ["runtime.ts"]
+}

package/src/shared/paths.ts

@@ -0,0 +1,133 @@
+import { dirname, join } from "node:path";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { ARCH, BIN_EXT, NATIVE_LIB_EXT, PLATFORM_TAG } from "./platform";
+
+const require = createRequire(import.meta.url);
+
+export type ResolvedNativeArtifacts = {
+  packageRoot: string;
+  source: "optional-package" | "local-build" | "missing";
+  nativePackageName: string | null;
+  cefPackageName: string | null;
+  nativeLibPath: string | null;
+  processHelperPath: string | null;
+  cefDir: string | null;
+};
+
+export function resolvePackageRoot(packageName: string): string | null {
+  try {
+    const packageJsonPath = require.resolve(`${packageName}/package.json`);
+    return dirname(packageJsonPath);
+  } catch {
+    return null;
+  }
+}
+
+export function resolveBunitePackageRoot(): string {
+  const packageJsonPath = require.resolve("bunite/package.json");
+  return dirname(packageJsonPath);
+}
+
+export function resolveFallbackCefDir(): string | null {
+  const envOverride = process.env.BUNITE_CEF_DIR ?? process.env.BUNITE_CEF_ROOT;
+  if (envOverride && existsSync(envOverride)) {
+    return envOverride;
+  }
+
+  const bunitePackageRoot = resolveBunitePackageRoot();
+  const localVendorPath = join(bunitePackageRoot, "vendors", "cef");
+  if (existsSync(localVendorPath)) {
+    return localVendorPath;
+  }
+
+  const upstreamVendorPath = "C:\\project\\electrobun\\package\\vendors\\cef";
+  if (existsSync(upstreamVendorPath)) {
+    return upstreamVendorPath;
+  }
+
+  return null;
+}
+
+export function resolveDefaultViewsRoot(): string | null {
+  const candidate = join(process.cwd(), "views");
+  return existsSync(candidate) ? candidate : null;
+}
+
+export function resolveNativeArtifacts(): ResolvedNativeArtifacts {
+  const packageRoot = resolveBunitePackageRoot();
+  const nativePackageName = `@bunite/native-${PLATFORM_TAG}-${ARCH}`;
+  const cefPackageName = `@bunite/cef-${PLATFORM_TAG}-${ARCH}`;
+  const nativePackageRoot = resolvePackageRoot(nativePackageName);
+  const cefPackageRoot = resolvePackageRoot(cefPackageName);
+
+  const packagedNativeLibPath = nativePackageRoot
+    ? join(nativePackageRoot, `libBuniteNative${NATIVE_LIB_EXT}`)
+    : null;
+  const packagedProcessHelperPath = nativePackageRoot
+    ? join(nativePackageRoot, `process_helper${BIN_EXT}`)
+    : null;
+  const packagedCefDir = cefPackageRoot ?? null;
+
+  if (
+    packagedNativeLibPath &&
+    packagedProcessHelperPath &&
+    existsSync(packagedNativeLibPath) &&
+    existsSync(packagedProcessHelperPath)
+  ) {
+    return {
+      packageRoot,
+      source: "optional-package",
+      nativePackageName,
+      cefPackageName: packagedCefDir && existsSync(packagedCefDir) ? cefPackageName : null,
+      nativeLibPath: packagedNativeLibPath,
+      processHelperPath: packagedProcessHelperPath,
+      cefDir: packagedCefDir && existsSync(packagedCefDir) ? packagedCefDir : null
+    };
+  }
+
+  const localBuildRoot = join(packageRoot, "native-build", `${PLATFORM_TAG}-${ARCH}`);
+  const localCefDir = join(localBuildRoot, "cef");
+  const directLocalNativeLibPath = join(localBuildRoot, `libBuniteNative${NATIVE_LIB_EXT}`);
+  const directLocalProcessHelperPath = join(localBuildRoot, `process_helper${BIN_EXT}`);
+
+  if (existsSync(directLocalNativeLibPath) && existsSync(directLocalProcessHelperPath)) {
+    const resolvedLocalCefDir = existsSync(localCefDir) ? localCefDir : resolveFallbackCefDir();
+    return {
+      packageRoot,
+      source: "local-build",
+      nativePackageName: null,
+      cefPackageName: null,
+      nativeLibPath: directLocalNativeLibPath,
+      processHelperPath: directLocalProcessHelperPath,
+      cefDir: resolvedLocalCefDir
+    };
+  }
+
+  const localBuildBinRoot = join(localBuildRoot, "Release");
+  const localNativeLibPath = join(localBuildBinRoot, `libBuniteNative${NATIVE_LIB_EXT}`);
+  const localProcessHelperPath = join(localBuildBinRoot, `process_helper${BIN_EXT}`);
+
+  if (existsSync(localNativeLibPath) && existsSync(localProcessHelperPath)) {
+    const resolvedLocalCefDir = existsSync(localCefDir) ? localCefDir : resolveFallbackCefDir();
+    return {
+      packageRoot,
+      source: "local-build",
+      nativePackageName: null,
+      cefPackageName: null,
+      nativeLibPath: localNativeLibPath,
+      processHelperPath: localProcessHelperPath,
+      cefDir: resolvedLocalCefDir
+    };
+  }
+
+  return {
+    packageRoot,
+    source: "missing",
+    nativePackageName: nativePackageRoot ? nativePackageName : null,
+    cefPackageName: cefPackageRoot ? cefPackageName : null,
+    nativeLibPath: null,
+    processHelperPath: null,
+    cefDir: null
+  };
+}

package/src/shared/platform.ts

@@ -0,0 +1,9 @@
+export const OS = process.platform;
+export const ARCH = process.arch;
+
+export const PLATFORM_TAG =
+  OS === "win32" ? "win" : OS === "darwin" ? "darwin" : OS;
+
+export const BIN_EXT = OS === "win32" ? ".exe" : "";
+export const NATIVE_LIB_EXT =
+  OS === "win32" ? ".dll" : OS === "darwin" ? ".dylib" : ".so";