@remnic/core 9.3.519 → 9.3.521

package/dist/index.d.ts

@@ -924,6 +924,8 @@ interface BinaryAssetRecord {
     originalPath: string;
     /** Path (or URL) in the backend storage. */
     mirroredPath: string;
+    /** Optional user-resolvable target to write into markdown links. */
+    redirectPath?: string;
     /** SHA-256 hex digest of file content. */
     contentHash: string;
     /** File size in bytes. */
@@ -976,15 +978,23 @@ interface BinaryStorageBackend {
     exists(remotePath: string): Promise<boolean>;
     /** Delete a file from the backend. */
     delete(remotePath: string): Promise<void>;
+    /** Return the user-resolvable markdown target for a stored backend path. */
+    getRedirectTarget?(remotePath: string): string;
 }
 declare class FilesystemBackend implements BinaryStorageBackend {
     readonly type = "filesystem";
     private readonly basePath;
     constructor(basePath: string);
     private resolveRemotePath;
+    private isInsideBase;
+    private realBasePathIfExists;
+    private ensureBaseDirectory;
+    private ensureSafeParentDirectory;
+    private resolveExistingRemotePath;
     upload(localPath: string, remotePath: string): Promise<string>;
     exists(remotePath: string): Promise<boolean>;
     delete(remotePath: string): Promise<void>;
+    getRedirectTarget(remotePath: string): string;
 }
 declare class NoneBackend implements BinaryStorageBackend {
     readonly type = "none";
@@ -1026,7 +1036,8 @@ declare function manifestDir(memoryDir: string): string;
 declare function manifestPath(memoryDir: string): string;
 /**
  * Read the manifest from disk. Returns a fresh empty manifest if the file
- * does not exist or contains invalid JSON (CLAUDE.md #18).
+ * does not exist. Existing invalid manifests fail closed so the pipeline does
+ * not overwrite state needed for safe cleanup.
  */
 declare function readManifest(memoryDir: string): Promise<BinaryLifecycleManifest>;
 /**
@@ -1051,10 +1062,16 @@ interface PipelineLogger {
     warn(msg: string): void;
     error(msg: string): void;
 }
+type ReadMarkdownFile = (filePath: string) => Promise<string>;
+type WriteMarkdownFile = (filePath: string, content: string) => Promise<void>;
 interface PipelineOptions {
     dryRun?: boolean;
     /** Force-clean all files past grace period, ignoring redirect status. */
     forceClean?: boolean;
+    /** Test hook for deterministic markdown read failures. */
+    readMarkdownFile?: ReadMarkdownFile;
+    /** Test hook for deterministic markdown write failures. */
+    writeMarkdownFile?: WriteMarkdownFile;
 }
 /**
  * Run the binary lifecycle pipeline: scan, mirror, redirect, clean.