@danypops/vehicle-core 0.5.0 → 0.6.1

package/dist/atomic-json.d.ts

@@ -18,11 +18,20 @@
  * happens).
  */
 export interface AtomicJsonFsAdapter {
-    writeFile(path: string, data: string): Promise<void>;
+    /** `mode` is a POSIX file-mode bitmask (e.g. 0o600); omitted means the platform/adapter's own default. */
+    writeFile(path: string, data: string, mode?: number): Promise<void>;
     rename(oldPath: string, newPath: string): Promise<void>;
     unlink(path: string): Promise<void>;
     readFile(path: string): Promise<string>;
 }
+export interface AtomicJsonWriteOptions {
+    /** POSIX file-mode bitmask for the written file (e.g. 0o600 for a secret/credential-adjacent file). Omitted means the adapter's own default. */
+    readonly mode?: number;
+    /** Pretty-prints with 2-space indentation (matching JSON.stringify(value, null, 2)) for a human-editable file. Defaults to false (compact). */
+    readonly pretty?: boolean;
+    /** Appends a trailing "\n" -- the common POSIX text-file convention. Defaults to false (exact JSON.stringify output, unchanged). */
+    readonly trailingNewline?: boolean;
+}
 export interface AtomicJsonWriterOptions {
     readonly fs: AtomicJsonFsAdapter;
     /** Defaults to Date.now. */
@@ -46,7 +55,7 @@ export interface AtomicJsonWriterOptions {
 }
 export interface AtomicJsonWriter {
     /** Serializes `value` to JSON and writes it to `filePath` atomically (temp file + rename). */
-    write(filePath: string, value: unknown): Promise<void>;
+    write(filePath: string, value: unknown, options?: AtomicJsonWriteOptions): Promise<void>;
     /** Reads and JSON.parses `filePath`. Returns undefined if the file doesn't exist (fs.readFile throws ENOENT); rethrows any other error. */
     read(filePath: string): Promise<unknown | undefined>;
 }

package/dist/atomic-json.js

@@ -61,19 +61,21 @@ export function createAtomicJsonWriter(options) {
         }
     }
     return {
-        async write(filePath, value) {
+        async write(filePath, value, options) {
             let serialized;
             try {
-                serialized = JSON.stringify(value);
+                serialized = options?.pretty ? JSON.stringify(value, null, 2) : JSON.stringify(value);
             }
             catch (error) {
                 throw new Error(`atomic-json: value for ${filePath} is not JSON-serializable`, { cause: error });
             }
             if (serialized === undefined)
                 throw new Error(`atomic-json: value for ${filePath} is not JSON-serializable`);
+            if (options?.trailingNewline)
+                serialized += "\n";
             const { dir, base } = dirAndBase(filePath);
             const tempPath = `${dir}/.${base}.${pid()}.${now()}.${random()}.tmp`;
-            await fsAdapter.writeFile(tempPath, serialized);
+            await fsAdapter.writeFile(tempPath, serialized, options?.mode);
             try {
                 await renameWithRetry(tempPath, filePath);
             }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@danypops/vehicle-core",
-	"version": "0.5.0",
+	"version": "0.6.1",
 	"description": "Vehicle's runtime-neutral wire contract: operation descriptors, schema codecs, failure shapes. Zero runtime dependencies, zero Bun-specific code -- the one thing every Vehicle client and server package depends on.",
 	"license": "MIT",
 	"type": "module",

package/src/atomic-json.ts

@@ -19,12 +19,22 @@
  */
 
 export interface AtomicJsonFsAdapter {
-	writeFile(path: string, data: string): Promise<void>;
+	/** `mode` is a POSIX file-mode bitmask (e.g. 0o600); omitted means the platform/adapter's own default. */
+	writeFile(path: string, data: string, mode?: number): Promise<void>;
 	rename(oldPath: string, newPath: string): Promise<void>;
 	unlink(path: string): Promise<void>;
 	readFile(path: string): Promise<string>;
 }
 
+export interface AtomicJsonWriteOptions {
+	/** POSIX file-mode bitmask for the written file (e.g. 0o600 for a secret/credential-adjacent file). Omitted means the adapter's own default. */
+	readonly mode?: number;
+	/** Pretty-prints with 2-space indentation (matching JSON.stringify(value, null, 2)) for a human-editable file. Defaults to false (compact). */
+	readonly pretty?: boolean;
+	/** Appends a trailing "\n" -- the common POSIX text-file convention. Defaults to false (exact JSON.stringify output, unchanged). */
+	readonly trailingNewline?: boolean;
+}
+
 export interface AtomicJsonWriterOptions {
 	readonly fs: AtomicJsonFsAdapter;
 	/** Defaults to Date.now. */
@@ -49,7 +59,7 @@ export interface AtomicJsonWriterOptions {
 
 export interface AtomicJsonWriter {
 	/** Serializes `value` to JSON and writes it to `filePath` atomically (temp file + rename). */
-	write(filePath: string, value: unknown): Promise<void>;
+	write(filePath: string, value: unknown, options?: AtomicJsonWriteOptions): Promise<void>;
 	/** Reads and JSON.parses `filePath`. Returns undefined if the file doesn't exist (fs.readFile throws ENOENT); rethrows any other error. */
 	read(filePath: string): Promise<unknown | undefined>;
 }
@@ -102,17 +112,18 @@ export function createAtomicJsonWriter(options: AtomicJsonWriterOptions): Atomic
 	}
 
 	return {
-		async write(filePath, value) {
+		async write(filePath, value, options) {
 			let serialized: string | undefined;
 			try {
-				serialized = JSON.stringify(value);
+				serialized = options?.pretty ? JSON.stringify(value, null, 2) : JSON.stringify(value);
 			} catch (error) {
 				throw new Error(`atomic-json: value for ${filePath} is not JSON-serializable`, { cause: error });
 			}
 			if (serialized === undefined) throw new Error(`atomic-json: value for ${filePath} is not JSON-serializable`);
+			if (options?.trailingNewline) serialized += "\n";
 			const { dir, base } = dirAndBase(filePath);
 			const tempPath = `${dir}/.${base}.${pid()}.${now()}.${random()}.tmp`;
-			await fsAdapter.writeFile(tempPath, serialized);
+			await fsAdapter.writeFile(tempPath, serialized, options?.mode);
 			try {
 				await renameWithRetry(tempPath, filePath);
 			} catch (error) {