Fix: #356 - Triplex should run offline (#378)

* fixed: #356

- added ignore of Statsig error prompted to the stderr (fork.ts). fetch errors are always reported to the stderr.
- added catch statement in Statsig initialisation and gate fallback (fg.ts)

* fixed blocking projectCache

* better Statsig error catching

* fixed linting problems

* docs(changeset): fixed #356 - triplex should run offline

Author: Bellian

.changeset/hungry-spies-cheat.md

@@ -0,0 +1,6 @@
+---
+"@triplex/lib": patch
+"triplex-vsce": patch
+---
+
+fixed #356 - triplex should run offline

apps/vscode/src/extension/editor/project.ts

@@ -13,6 +13,8 @@ import { type Args } from "../../project";
 import { fork } from "../util/fork";
 import { getPort } from "../util/port";
 
+const PROJECT_RETRY_TIME = 1000;
+
 export interface TriplexProject {
   /** Number of active sessions of this project */
   active: number;
@@ -65,32 +67,40 @@ export async function resolveProject(
       userId: vscode.env.machineId,
     };
 
-    const p = await fork<Args>(
-      process.env.NODE_ENV === "production"
-        ? join(context.extensionPath, "dist/project.js")
-        : join(context.extensionPath, "src/project/index.ts"),
-      {
-        cwd: context.extensionPath,
-        data: args,
-      },
-    );
+    try {
+      const projectProcess = await fork<Args>(
+        process.env.NODE_ENV === "production"
+          ? join(context.extensionPath, "dist/project.js")
+          : join(context.extensionPath, "src/project/index.ts"),
+        {
+          cwd: context.extensionPath,
+          data: args,
+        },
+      );
 
-    const project: TriplexProject = {
-      active: 1,
-      args,
-      dispose: () => {
-        project.active -= 1;
+      const project: TriplexProject = {
+        active: 1,
+        args,
+        dispose: () => {
+          project.active -= 1;
 
-        if (project.active === 0) {
-          projectCache.delete(cwd);
-          p.kill();
-        }
-      },
-      on: p.on,
-      ports,
-    };
+          if (project.active === 0) {
+            projectCache.delete(cwd);
+            projectProcess.kill();
+          }
+        },
+        on: projectProcess.on,
+        ports,
+      };
 
-    resolve(project);
+      resolve(project);
+      // eslint-disable-next-line unicorn/prefer-optional-catch-binding, @typescript-eslint/no-unused-vars
+    } catch (error) {
+      // free up the cache on failure to initialize after standdown time.
+      setTimeout(() => {
+        projectCache.delete(cwd);
+      }, PROJECT_RETRY_TIME);
+    }
   });
 
   projectCache.set(cwd, projectResolver);

apps/vscode/src/extension/util/fork.ts

@@ -92,7 +92,11 @@ export function fork<TData extends Record<string, unknown>>(
 
     fork.stderr?.on("data", (data) => {
       const err = data.toString();
-      if (err.includes("inspector")) {
+      if (
+        err.includes("inspector") ||
+        (err.includes("Statsig") && err.includes("fetch failed")) || // excludes Statsig fetch errors
+        (err.includes("Statsig") && err.includes("Timeout")) // excludes Statsig timeout error
+      ) {
         // Ignore inspector errors.
         return;
       }

packages/lib/src/fg.tsx

@@ -12,7 +12,7 @@ import { type FGEnvironment } from "./types";
 
 const overrideAdapter = new LocalOverrideAdapter();
 
-let instance: StatsigClient;
+let instance: StatsigClient | undefined;
 
 export async function initFeatureGates({
   environment,
@@ -40,19 +40,23 @@ export async function initFeatureGates({
     return;
   }
 
-  const client = new StatsigClient(
-    "client-RoO8UZOrk5aM4zXe3AP7vQjy66PWeumvN2PfQ2P6xt7",
-    { userID: userId },
-    {
-      environment: { tier: environment },
-      networkConfig: { preventAllNetworkTraffic: environment === "local" },
-      overrideAdapter,
-    },
-  );
+  try {
+    const client = new StatsigClient(
+      "client-RoO8UZOrk5aM4zXe3AP7vQjy66PWeumvN2PfQ2P6xt7",
+      { userID: userId },
+      {
+        environment: { tier: environment },
+        networkConfig: { networkTimeoutMs: 2500, preventAllNetworkTraffic: environment === "local" },
+        overrideAdapter,
+      },
+    );
 
-  await client.initializeAsync();
-
-  instance = client;
+    await client.initializeAsync();
+  } catch (error) {
+    // Ignore initialization errors to prevent blocking app startup but report to console for now
+    // eslint-disable-next-line no-console
+    console.log("[Statsig] Failed to initialize Statsig:", error);
+  }
 
   if (typeof document !== "undefined") {
     document.documentElement.setAttribute("data-fg-user", userId);
@@ -69,7 +73,7 @@ export async function initFeatureGates({
 }
 
 export function fg(key: string): boolean {
-  return instance.checkGate(key);
+  return instance?.checkGate(key) ?? false; // Default to false if not initialized
 }
 
 export function overrideFg(key: string, value: boolean) {