@linxiraos/pi-utils 1.4.0 → 1.4.2

package/src/index.ts

@@ -22,6 +22,7 @@ export * from "./mermaid-ascii";
 export * from "./mime";
 export * from "./path";
 export * from "./path-tree";
+export * from "./ports";
 export * from "./peek-file";
 export * as postmortem from "./postmortem";
 export * from "./process-name";

package/src/ports.ts

@@ -0,0 +1,15 @@
+/**
+ * Default loopback ports for Zeta's local services.
+ *
+ * OMP installs on the same machine use 30141/30142/3847, and common developer
+ * tools squat on 3000/8080/8787/3847. Zeta therefore owns a dedicated block:
+ * three uncommon ports, at least two apart, so a side-by-side OMP install and
+ * unrelated services cannot take the gateway or the stats dashboard away.
+ *
+ * Every default in the repository derives from these constants. The standalone
+ * Electron shell (`desktop/src/main.ts`, not a Bun workspace package) carries
+ * literals that must match; its serve-discovery test asserts the values.
+ */
+export const ZETA_WEB_PORT = 43141;
+export const ZETA_GATEWAY_PORT = 43143;
+export const ZETA_STATS_PORT = 43147;

package/src/test-runtime.ts

@@ -0,0 +1,8 @@
+const BUN_TEST_ENTRY_PATTERN = /[._](?:test|spec)\.[cm]?[jt]sx?$/;
+
+/** True when the process is an explicitly marked test child or Bun is running a test entrypoint. */
+export function isBunTestRuntime(): boolean {
+	if (Bun.env.PI_TEST_RUNTIME === "1") return true;
+	const hasTestEnvironment = Bun.env.BUN_ENV === "test" || Bun.env.NODE_ENV === "test";
+	return hasTestEnvironment && BUN_TEST_ENTRY_PATTERN.test(Bun.main);
+}