ushman-ledger 1.2.0 → 1.2.2

package/dist/storage/filesystem.js

@@ -11,11 +11,36 @@ export const LEDGER_ROOT_SEGMENTS = ['.lab', 'ledger'];
 export const LEDGER_STALE_TEMP_MS = 60_000;
 const atomicWriteTestHooks = new Map();
 const resolveAtomicWriteKey = (filePath) => path.resolve(filePath);
-const consumeAtomicWriteTestHook = (filePath) => {
+const getAtomicWriteTestHook = (filePath) => {
     const key = resolveAtomicWriteKey(filePath);
-    const hook = atomicWriteTestHooks.get(key);
-    atomicWriteTestHooks.delete(key);
-    return hook;
+    return {
+        hook: atomicWriteTestHooks.get(key),
+        key,
+    };
+};
+const runAtomicWriteTestHook = async (filePath) => {
+    const { hook, key } = getAtomicWriteTestHook(filePath);
+    if (!hook?.beforeRename) {
+        atomicWriteTestHooks.delete(key);
+        return;
+    }
+    try {
+        await hook.beforeRename();
+        atomicWriteTestHooks.delete(key);
+    }
+    catch (error) {
+        if (!hook.retainOnThrow) {
+            atomicWriteTestHooks.delete(key);
+        }
+        throw error;
+    }
+};
+const runAtomicWriteWriteTestHook = async (filePath) => {
+    const { hook } = getAtomicWriteTestHook(filePath);
+    if (!hook?.beforeWrite) {
+        return;
+    }
+    await hook.beforeWrite();
 };
 export const resolveLedgerPaths = (workspaceRoot) => {
     const root = path.join(workspaceRoot, ...LEDGER_ROOT_SEGMENTS);
@@ -83,7 +108,7 @@ export const writeAtomicTextFile = async (filePath, text) => {
     finally {
         await handle.close();
     }
-    await consumeAtomicWriteTestHook(filePath)?.beforeRename?.();
+    await runAtomicWriteTestHook(filePath);
     try {
         await rename(tempPath, filePath);
     }
@@ -92,6 +117,86 @@ export const writeAtomicTextFile = async (filePath, text) => {
         throw error;
     }
 };
+export const createAtomicTextFileWriter = async (filePath) => {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    const tempPath = `${filePath}.tmp.${process.pid}.${Date.now()}.${randomUUID()}`;
+    const handle = await open(tempPath, 'w');
+    let completed = false;
+    let pendingWriteError;
+    let writeChain = Promise.resolve();
+    const finalizeHandle = async () => {
+        if (completed) {
+            return false;
+        }
+        completed = true;
+        return true;
+    };
+    const waitForWrites = async () => {
+        await writeChain;
+        if (pendingWriteError) {
+            throw pendingWriteError;
+        }
+    };
+    return {
+        abort: async () => {
+            if (!(await finalizeHandle())) {
+                return;
+            }
+            let writeError;
+            try {
+                await waitForWrites();
+            }
+            catch (error) {
+                writeError = error;
+            }
+            await handle.close();
+            await rm(tempPath, { force: true });
+            if (writeError) {
+                throw writeError;
+            }
+        },
+        close: async () => {
+            if (!(await finalizeHandle())) {
+                return;
+            }
+            try {
+                await waitForWrites();
+            }
+            catch (error) {
+                await handle.close();
+                await rm(tempPath, { force: true });
+                throw error;
+            }
+            try {
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            await runAtomicWriteTestHook(filePath);
+            try {
+                await rename(tempPath, filePath);
+            }
+            catch (error) {
+                await rm(tempPath, { force: true });
+                throw error;
+            }
+        },
+        write: async (chunk) => {
+            const nextWrite = writeChain.then(async () => {
+                if (completed || chunk.length === 0) {
+                    return;
+                }
+                await runAtomicWriteWriteTestHook(filePath);
+                await handle.writeFile(chunk, 'utf8');
+            });
+            writeChain = nextWrite.catch((error) => {
+                pendingWriteError ??= error;
+            });
+            await nextWrite;
+        },
+    };
+};
 export const writeAtomicJsonFile = async (filePath, value) => {
     await writeAtomicTextFile(filePath, `${stableStringify(value, true)}\n`);
 };

package/dist/text-lines.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Visit each logical line in `text`, normalizing trailing `\r` from CRLF input.
+ *
+ * The final unterminated line is still visited, which keeps diff parsing stable for
+ * patch content that does not end with a trailing newline.
+ */
+export declare const forEachLine: (text: string, visit: (line: string) => void) => void;
+//# sourceMappingURL=text-lines.d.ts.map

package/dist/text-lines.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-lines.d.ts","sourceRoot":"","sources":["../src/text-lines.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,SAatE,CAAC"}

package/dist/text-lines.js

@@ -0,0 +1,20 @@
+/**
+ * Visit each logical line in `text`, normalizing trailing `\r` from CRLF input.
+ *
+ * The final unterminated line is still visited, which keeps diff parsing stable for
+ * patch content that does not end with a trailing newline.
+ */
+export const forEachLine = (text, visit) => {
+    let lineStart = 0;
+    for (let index = 0; index <= text.length; index += 1) {
+        if (index !== text.length && text.charCodeAt(index) !== 10) {
+            continue;
+        }
+        let line = text.slice(lineStart, index);
+        if (line.endsWith('\r')) {
+            line = line.slice(0, -1);
+        }
+        visit(line);
+        lineStart = index + 1;
+    }
+};

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const LEDGER_LIBRARY_VERSION = "1.1.0";
+export declare const LEDGER_LIBRARY_VERSION: string;
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,UAAU,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,sBAAsB,QAAsB,CAAC"}

package/dist/version.js

@@ -1 +1,2 @@
-export const LEDGER_LIBRARY_VERSION = '1.1.0';
+import packageJson from '../package.json' with { type: 'json' };
+export const LEDGER_LIBRARY_VERSION = packageJson.version;

package/package.json

@@ -12,11 +12,11 @@
     "dependencies": {
         "safe-stable-stringify": "^2.5.0",
         "tar": "^7.5.15",
-        "valibot": "^1.4.0"
+        "valibot": "^1.4.1"
     },
     "description": "Append-only workspace ledger library and CLI for Ushman v4.",
     "devDependencies": {
-        "@biomejs/biome": "^2.4.15",
+        "@biomejs/biome": "^2.4.16",
         "@types/bun": "^1.3.14",
         "@types/node": "^25.9.1",
         "typescript": "^6.0.3"
@@ -37,7 +37,9 @@
     },
     "files": [
         "dist",
+        "ARCHITECTURE.md",
         "CHANGELOG.md",
+        "TROUBLESHOOTING.md",
         "README.md",
         "AGENTS.md",
         "LICENSE.md"
@@ -68,5 +70,5 @@
     },
     "type": "module",
     "types": "dist/index.d.ts",
-    "version": "1.2.0"
+    "version": "1.2.2"
 }