@excitedjs/dreamux-utils 0.2.0-beta.84 → 0.2.0-beta.86

package/dist/fs.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Filesystem write helpers shared across Dreamux providers and host.
+ *
+ * Domain note: these are primitives (atomic write, future: tmpdir,
+ * safe unlink). Dreamux host-owned path/layout contracts live in
+ * `@excitedjs/dreamux` — do not add them here.
+ */
+/**
+ * Atomic write: tmpfile in same dir → write with O_CREAT|O_EXCL (fail loud on
+ * collision instead of clobbering) → rename over final path.
+ * Permissions applied at open (never chmod final path).
+ * Parent dir must exist.
+ */
+export declare function writeAtomic(dir: string, filename: string, data: string, mode?: number): Promise<void>;
+//# sourceMappingURL=fs.d.ts.map

package/dist/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;;;GAKG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE,MAAc,GACnB,OAAO,CAAC,IAAI,CAAC,CA2Bf"}

package/dist/fs.js

@@ -0,0 +1,50 @@
+/**
+ * Filesystem write helpers shared across Dreamux providers and host.
+ *
+ * Domain note: these are primitives (atomic write, future: tmpdir,
+ * safe unlink). Dreamux host-owned path/layout contracts live in
+ * `@excitedjs/dreamux` — do not add them here.
+ */
+import { randomBytes } from 'node:crypto';
+import { open, rename, rm } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Atomic write: tmpfile in same dir → write with O_CREAT|O_EXCL (fail loud on
+ * collision instead of clobbering) → rename over final path.
+ * Permissions applied at open (never chmod final path).
+ * Parent dir must exist.
+ */
+export async function writeAtomic(dir, filename, data, mode = 0o600) {
+    const suffix = process.pid.toString(16) +
+        '-' +
+        Date.now().toString(36) +
+        '-' +
+        randomBytes(4).toString('hex');
+    const tmp = join(dir, `${filename}.tmp-${suffix}`);
+    const final = join(dir, filename);
+    // O_CREAT | O_EXCL | O_WRONLY = 'wx' — a name collision throws instead of
+    // silently overwriting (infinitesimally unlikely given pid+time+random, but
+    // the invariant calls for it).
+    let fd = null;
+    try {
+        fd = await open(tmp, 'wx', mode);
+        await fd.writeFile(data);
+        await fd.close();
+        fd = null;
+        await rename(tmp, final);
+    }
+    catch (err) {
+        if (fd) {
+            try {
+                await fd.close();
+            }
+            catch { /* swallow */ }
+        }
+        try {
+            await rm(tmp, { force: true });
+        }
+        catch { /* swallow */ }
+        throw err;
+    }
+}
+//# sourceMappingURL=fs.js.map

package/dist/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../src/fs.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,QAAgB,EAChB,IAAY,EACZ,OAAe,KAAK;IAEpB,MAAM,MAAM,GACV,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,GAAG;QACH,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC;QACvB,GAAG;QACH,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,QAAQ,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAElC,0EAA0E;IAC1E,4EAA4E;IAC5E,+BAA+B;IAC/B,IAAI,EAAE,GAAiD,IAAI,CAAC;IAC5D,IAAI,CAAC;QACH,EAAE,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACjC,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;QACjB,EAAE,GAAG,IAAI,CAAC;QACV,MAAM,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,EAAE,EAAE,CAAC;YACP,IAAI,CAAC;gBAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,CAAC;YAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC;QAC/D,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export * from './config-validate.js';
 export * from './os.js';
+export * from './fs.js';
 export * from './completion-body.js';
 export * from './socket-budget.js';
 export * from './turn-render.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export * from './config-validate.js';
 export * from './os.js';
+export * from './fs.js';
 export * from './completion-body.js';
 export * from './socket-budget.js';
 export * from './turn-render.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,sBAAsB,CAAC;AACrC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excitedjs/dreamux-utils",
-  "version": "0.2.0-beta.84",
+  "version": "0.2.0-beta.86",
   "description": "Pure shared utilities for Dreamux providers and host: neutral config-validation primitives, OS/filesystem helpers, completion-body resolution, and inbound-turn render helpers. Depends on @excitedjs/dreamux-types only, never on @excitedjs/dreamux core (issue excitedjs/dreamux#209).",
   "license": "MIT",
   "repository": {
@@ -27,7 +27,7 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@excitedjs/dreamux-types": "0.2.0-beta.84"
+    "@excitedjs/dreamux-types": "0.2.0-beta.86"
   },
   "devDependencies": {
     "@types/node": "^22.10.0",