@demicodes/host-local 0.17.2 → 0.17.4

package/dist/index.d.mts

@@ -50,6 +50,8 @@ interface LocalHostOptions {
   storeRoot?: string;
   /** Where command artifacts land as plain files; defaults next to the store. */
   commandArtifactsDir?: string;
+  /** Bring-your-own persistence, e.g. to wrap or gate writes; defaults to a LocalHostStore rooted at storeRoot. */
+  store?: HostStore;
 }
 declare class LocalHost implements Host {
   readonly defaultCwd: string;
@@ -60,6 +62,17 @@ declare class LocalHost implements Host {
   constructor(defaultCwd: string, options?: LocalHostOptions);
 }
 //#endregion
+//#region src/local-store.d.ts
+declare class LocalHostStore implements HostStore {
+  readonly root: string;
+  constructor(root: string);
+  readJson<T>(key: string): Promise<T | null>;
+  writeJson<T>(key: string, value: T): Promise<void>;
+  delete(key: string): Promise<void>;
+  list(prefix: string): Promise<string[]>;
+  private pathForKey;
+}
+//#endregion
 //#region src/local-agent-server.d.ts
 interface CreateLocalAgentServerOptions {
   /** Same LocalHost instance the harness was built with. */
@@ -106,4 +119,4 @@ interface LocalAgentServerHandle {
  */
 declare function createLocalAgentServer(options: CreateLocalAgentServerOptions): LocalAgentServerHandle;
 //#endregion
-export { COMMAND_BRIDGE_SHIM_SOURCE, CommandBridgeHandle, CommandBridgeOptions, CreateLocalAgentServerOptions, LocalAgentServerHandle, LocalHost, LocalHostOptions, MaterializeCommandBridgeShimsOptions, bridgeBinDirFor, createLocalAgentServer, defaultBridgeSocketPath, materializeCommandBridgeShims, resolveDemiHome, startCommandBridge };
+export { COMMAND_BRIDGE_SHIM_SOURCE, CommandBridgeHandle, CommandBridgeOptions, CreateLocalAgentServerOptions, LocalAgentServerHandle, LocalHost, LocalHostOptions, LocalHostStore, MaterializeCommandBridgeShimsOptions, bridgeBinDirFor, createLocalAgentServer, defaultBridgeSocketPath, materializeCommandBridgeShims, resolveDemiHome, startCommandBridge };

package/dist/index.mjs

@@ -284,7 +284,14 @@ var LocalHostStore = class {
 	async writeJson(key, value) {
 		const path = this.pathForKey(key);
 		await mkdir(dirname(path), { recursive: true });
-		await writeFile(path, stringifyPortableJson(value, 2), "utf8");
+		const temp = `${path}.${randomUUID()}.tmp`;
+		try {
+			await writeFile(temp, stringifyPortableJson(value, 2), "utf8");
+			await rename(temp, path);
+		} catch (error) {
+			await rm(temp, { force: true });
+			throw error;
+		}
 	}
 	async delete(key) {
 		await rm(this.pathForKey(key), {
@@ -343,7 +350,7 @@ var LocalHost = class {
 		this.commandArtifactsDir = resolve(options.commandArtifactsDir ?? join(storeRoot, "command-artifacts"));
 		this.fs = new LocalHostFileSystem(this.defaultCwd);
 		this.process = new LocalHostProcess(this.defaultCwd);
-		this.store = new LocalHostStore(storeRoot);
+		this.store = options.store ?? new LocalHostStore(storeRoot);
 	}
 };
 var LocalHostProcess = class {
@@ -650,4 +657,4 @@ function createLocalAgentServer(options) {
 	};
 }
 //#endregion
-export { COMMAND_BRIDGE_SHIM_SOURCE, LocalHost, bridgeBinDirFor, createLocalAgentServer, defaultBridgeSocketPath, materializeCommandBridgeShims, resolveDemiHome, startCommandBridge };
+export { COMMAND_BRIDGE_SHIM_SOURCE, LocalHost, LocalHostStore, bridgeBinDirFor, createLocalAgentServer, defaultBridgeSocketPath, materializeCommandBridgeShims, resolveDemiHome, startCommandBridge };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@demicodes/host-local",
   "description": "Node LocalHost and open-box local AgentServer assembly (command bridge on by default).",
-  "version": "0.17.2",
+  "version": "0.17.4",
   "private": false,
   "type": "module",
   "exports": {
@@ -11,10 +11,10 @@
     }
   },
   "dependencies": {
-    "@demicodes/agent": "^0.17.2",
-    "@demicodes/provider": "^0.17.2",
-    "@demicodes/shell": "^0.17.2",
-    "@demicodes/utils": "^0.17.2"
+    "@demicodes/agent": "^0.17.4",
+    "@demicodes/provider": "^0.17.4",
+    "@demicodes/shell": "^0.17.4",
+    "@demicodes/utils": "^0.17.4"
   },
   "license": "Apache-2.0",
   "main": "./dist/index.mjs",