:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.
Python ab-testingai-analyticsanalyticscdpdata-warehouseexperimentsfeature-flagsjavascriptproduct-analyticspythonreactsession-replaysurveystypescriptweb-analytics
// Single source of truth for native modules (and their runtime-required
// transitive deps). pnpm hoists these to the root node_modules; the packaged
// app needs real copies next to the bundle.
//
// - scripts/before-pack.ts stages them from the hoisted root into the app's
// local node_modules before electron-builder collects files.
// - electron-builder.ts re-includes them (`files`) and unpacks the
// binary-bearing ones from the asar (`asarUnpack`).
// - electron.vite.config.ts marks the native ones external so Vite leaves
// them to be resolved from node_modules at runtime.
// Staged + packaged on every platform.
export const runtimeNativeModules = [
"node-pty",
"node-addon-api",
"@parcel/watcher",
"better-sqlite3",
"bindings",
"file-uri-to-path",
"prebuild-install",
"micromatch",
"is-glob",
"detect-libc",
"braces",
"picomatch",
"is-extglob",
"fill-range",
"to-regex-range",
"is-number",
];
// The base native modules that must exist when packaging; a missing one is a
// broken build, not a warning. before-pack stages these with copyRequiredDep.
export const requiredNativeModules = [
"node-pty",
"@parcel/watcher",
"better-sqlite3",
];
// file-icon is only used on macOS; koffi only reads the macOS window list.
export const macOnlyNativeModules = ["file-icon", "koffi"];
// The subset that ships compiled .node binaries and must be unpacked from asar.
const asarUnpackModules = [
"node-pty",
"@parcel/watcher",
"file-icon",
"better-sqlite3",
"bindings",
"file-uri-to-path",
"koffi",
"@koromix/koffi",
];
// Modules Vite must not bundle (resolved from the staged node_modules at runtime).
export const buildExternals = [
"node-pty",
"@parcel/watcher",
"file-icon",
"better-sqlite3",
"koffi",
];
// electron-builder ships whole scopes, so the platform-specific
// @parcel/watcher-<plat>-<arch> and @koromix/koffi-<plat>-<arch> packages that
// before-pack stages are covered by the parent scope's glob.
const scopeOf = (name: string) => {
if (name.startsWith("@parcel/")) return "@parcel";
if (name.startsWith("@koromix/")) return "@koromix";
return name;
};
/**
* Scopes that hold only arch-specific packages, named by `watcherPackageFor` and
* `koffiPackageFor` rather than by any list here.
*
* They still need a glob. electron-builder's `files` drops all of node_modules
* and then re-includes these globs, so a scope nobody names is stripped and its
* prebuilt binary never reaches the app — silently, because the failure only
* shows up as the feature not working in a packaged build. @parcel earns its glob
* via `@parcel/watcher` above; @koromix has no such entry.
*/
const stagedOnlyScopes = ["@koromix"];
export const packagedFileGlobs = [
...new Set([
...[...runtimeNativeModules, ...macOnlyNativeModules].map(scopeOf),
...stagedOnlyScopes,
]),
].map((scope) => `node_modules/${scope}/**/*`);
export const asarUnpackGlobs = asarUnpackModules.map(
(name) => `node_modules/${scopeOf(name)}/**`,
);
// Mirrors electron-builder's Arch enum (ia32=0, x64=1, armv7l=2, arm64=3).
const ARCH_X64 = 1;
const ARCH_ARM64 = 3;
// The platform-specific @parcel/watcher prebuild before-pack must stage, keyed
// by electron-builder's platform name and arch. The name is "windows", not
// "win" (electron-builder's Platform.WINDOWS.name); matching "win" silently
// skips staging and ships a broken Windows app. Returns null for an
// unrecognized platform.
export function watcherPackageFor(
platformName: string,
arch: number,
): string | null {
if (platformName === "mac") {
return arch === ARCH_X64
? "@parcel/watcher-darwin-x64"
: "@parcel/watcher-darwin-arm64";
}
if (platformName === "windows") {
return arch === ARCH_ARM64
? "@parcel/watcher-win32-arm64"
: "@parcel/watcher-win32-x64";
}
if (platformName === "linux") {
return arch === ARCH_ARM64
? "@parcel/watcher-linux-arm64-glibc"
: "@parcel/watcher-linux-x64-glibc";
}
return null;
}
// koffi's loader requires its optional per-platform prebuild package by name,
// so the packaged app must stage the matching one beside it.
export function koffiPackageFor(
platformName: string,
arch: number,
): string | null {
if (platformName !== "mac") return null;
return arch === ARCH_X64
? "@koromix/koffi-darwin-x64"
: "@koromix/koffi-darwin-arm64";
}