@xynogen/pix-runtime 0.8.1 → 0.8.2

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@xynogen/pix-runtime",
-	"version": "0.8.1",
+	"version": "0.8.2",
 	"description": "Pix shared runtime — versioned pix.json config, atomic persistence, typed change events",
 	"type": "module",
 	"main": "src/index.ts",
@@ -9,7 +9,7 @@
 	},
 	"files": [
 		"src",
-		"!src/**/*.test.ts",
+		"!src/**/*.test.*",
 		"README.md",
 		"DESIGN.md",
 		"LICENSE"
@@ -21,6 +21,7 @@
 	},
 	"exports": {
 		".": "./src/index.ts",
+		"./atomic-write": "./src/atomic-write.ts",
 		"./config": "./src/runtime.ts",
 		"./sections": "./src/sections/index.ts",
 		"./collapse": "./src/collapse.ts",

package/src/atomic-write.ts

@@ -0,0 +1,35 @@
+/**
+ * atomic-write.ts — write a file so readers never see a partial result.
+ *
+ * Writes to a unique sibling temp file, then renames over the target (rename is
+ * atomic on the same filesystem). A crash mid-write leaves the old file intact.
+ * Parent dirs are created.
+ *
+ * NOT a replacement for pix-runtime's ConfigStorage.writeAtomic, which adds a
+ * cross-process lock. Use this for plain single-writer files (per-tool JSON
+ * state, caches).
+ */
+
+import { mkdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+
+/** Atomically write `contents` to `target`. Mode defaults to 0o600. */
+export function writeFileAtomicSync(
+	target: string,
+	contents: string | Uint8Array,
+	mode = 0o600,
+): void {
+	mkdirSync(dirname(target), { recursive: true });
+	const tmp = `${target}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
+	try {
+		writeFileSync(tmp, contents, { mode });
+		renameSync(tmp, target);
+	} catch (err) {
+		try {
+			rmSync(tmp, { force: true });
+		} catch {
+			/* best-effort cleanup */
+		}
+		throw err;
+	}
+}

package/src/index.ts

@@ -1,3 +1,4 @@
+export { writeFileAtomicSync } from "./atomic-write.ts";
 export { collapseDelayMs, shouldCollapse } from "./collapse.ts";
 export type {
 	ConfigChange,