@guckdev/sdk 0.3.0 → 0.4.0

package/dist/sdk/emit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/sdk/emit.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EAKV,MAAM,eAAe,CAAC;AA6DvB,eAAO,MAAM,IAAI,GAAU,OAAO,OAAO,CAAC,SAAS,CAAC,KAAG,OAAO,CAAC,IAAI,CAQlE,CAAC"}
+{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../src/sdk/emit.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,SAAS,EAKV,MAAM,eAAe,CAAC;AAgFvB,eAAO,MAAM,IAAI,GAAU,OAAO,OAAO,CAAC,SAAS,CAAC,KAAG,OAAO,CAAC,IAAI,CAyBlE,CAAC"}

package/dist/sdk/emit.js

@@ -1,6 +1,22 @@
 import { randomUUID } from "node:crypto";
 import { appendEvent, loadConfig, redactEvent, resolveStoreDir, } from "@guckdev/core";
 let cached;
+let writeDisabled = false;
+let warned = false;
+const isWriteError = (error) => {
+    if (!error || typeof error !== "object") {
+        return false;
+    }
+    const code = error.code;
+    return code === "EACCES" || code === "EPERM" || code === "EROFS";
+};
+const warnOnce = (message) => {
+    if (warned) {
+        return;
+    }
+    warned = true;
+    process.stderr.write(`${message}\n`);
+};
 const defaultRunId = process.env.GUCK_RUN_ID ?? randomUUID();
 const defaultSessionId = process.env.GUCK_SESSION_ID;
 const normalizeLevel = (level) => {
@@ -45,12 +61,28 @@ const getCached = () => {
     return cached;
 };
 export const emit = async (input) => {
+    if (writeDisabled) {
+        return;
+    }
     const { storeDir, config } = getCached();
     if (!config.enabled) {
         return;
     }
     const event = toEvent(input, { service: config.default_service });
     const redacted = redactEvent(config, event);
-    await appendEvent(storeDir, redacted);
+    try {
+        await appendEvent(storeDir, redacted);
+    }
+    catch (error) {
+        if (process.env.GUCK_STRICT_WRITE_ERRORS === "1") {
+            throw error;
+        }
+        if (isWriteError(error)) {
+            writeDisabled = true;
+            warnOnce("[guck] write disabled (permission error); set GUCK_STRICT_WRITE_ERRORS=1 to fail hard");
+            return;
+        }
+        throw error;
+    }
 };
 //# sourceMappingURL=emit.js.map

package/dist/sdk/emit.js.map

@@ -1 +1 @@
-{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/sdk/emit.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,WAAW,EAGX,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,eAAe,CAAC;AAEvB,IAAI,MAKS,CAAC;AAEd,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC;AAC7D,MAAM,gBAAgB,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAErD,MAAM,cAAc,GAAG,CAAC,KAAc,EAAa,EAAE;IACnD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,IACE,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,MAAM;QAChB,KAAK,KAAK,MAAM;QAChB,KAAK,KAAK,OAAO;QACjB,KAAK,KAAK,OAAO,EACjB,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,OAAO,GAAG,CACd,KAAyB,EACzB,QAA6B,EAClB,EAAE;IACb,OAAO;QACL,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,UAAU,EAAE;QAC5B,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACxC,KAAK,EAAE,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC;QAClC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,KAAK;QACzB,OAAO,EAAE,KAAK,CAAC,OAAO,IAAI,QAAQ,CAAC,OAAO;QAC1C,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,YAAY;QACpC,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,gBAAgB;QAChD,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE;KACxC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,SAAS,GAAG,GAAG,EAAE;IACrB,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,eAAe,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAChE,MAAM,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC7C,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,KAAyB,EAAiB,EAAE;IACrE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,OAAO;IACT,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACxC,CAAC,CAAC"}
+{"version":3,"file":"emit.js","sourceRoot":"","sources":["../../src/sdk/emit.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guckdev/sdk",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Guck JS SDK",
   "repository": {
     "type": "git",
@@ -37,7 +37,7 @@
     "node": ">=18"
   },
   "dependencies": {
-    "@guckdev/core": "0.3.0"
+    "@guckdev/core": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "25.2.2"

package/src/sdk/emit.ts

@@ -15,6 +15,25 @@ let cached:
     }
   | undefined;
 
+let writeDisabled = false;
+let warned = false;
+
+const isWriteError = (error: unknown): boolean => {
+  if (!error || typeof error !== "object") {
+    return false;
+  }
+  const code = (error as { code?: string }).code;
+  return code === "EACCES" || code === "EPERM" || code === "EROFS";
+};
+
+const warnOnce = (message: string): void => {
+  if (warned) {
+    return;
+  }
+  warned = true;
+  process.stderr.write(`${message}\n`);
+};
+
 const defaultRunId = process.env.GUCK_RUN_ID ?? randomUUID();
 const defaultSessionId = process.env.GUCK_SESSION_ID;
 
@@ -68,11 +87,28 @@ const getCached = () => {
 };
 
 export const emit = async (input: Partial<GuckEvent>): Promise<void> => {
+  if (writeDisabled) {
+    return;
+  }
   const { storeDir, config } = getCached();
   if (!config.enabled) {
     return;
   }
   const event = toEvent(input, { service: config.default_service });
   const redacted = redactEvent(config, event);
-  await appendEvent(storeDir, redacted);
+  try {
+    await appendEvent(storeDir, redacted);
+  } catch (error) {
+    if (process.env.GUCK_STRICT_WRITE_ERRORS === "1") {
+      throw error;
+    }
+    if (isWriteError(error)) {
+      writeDisabled = true;
+      warnOnce(
+        "[guck] write disabled (permission error); set GUCK_STRICT_WRITE_ERRORS=1 to fail hard",
+      );
+      return;
+    }
+    throw error;
+  }
 };