@clearmist-labs/comic-archive-handler 1.1.1 → 1.3.0

package/docs/API.md

@@ -100,6 +100,22 @@ Reads one archive entry and returns its contents as a `Buffer`. Throws `Metadata
 const page = await cah.readArchiveEntry(comicBuffer, 'P00001.jpg');
 ```
 
+### `readArchiveEntries(input)`
+
+Reads every entry's contents and SHA256 in a single pass over the archive, yielding `{ path, size?, buffer, sha256 }` in archive iteration order. Prefer this over calling `readArchiveEntry`/`sha256ArchiveEntry` once per entry: zip and asar support real random access, but the sequential/CLI-driven formats (rar, 7z, ace, tar) re-scan the archive from the start on every such call — reading every entry that way costs O(n^2) instead of O(n) for those formats. It also avoids reading each entry's data twice (once for the hash, once for the buffer).
+
+**Options**
+
+- `input: ArchiveInput` - A filesystem path or archive `Buffer`.
+
+**Example**
+
+```js
+for await (const entry of cah.readArchiveEntries(comicBuffer)) {
+  console.log(entry.path, entry.sha256);
+}
+```
+
 ### `renameArchiveImagesSequentially(input, options?)`
 
 Renames image entries in natural-sort order to `P#####.<extension>`, while leaving other entries unchanged.
@@ -156,6 +172,23 @@ const cleaned = await cah.stripNonEssentialFiles(comicBuffer, {
 });
 ```
 
+### `removeArchiveEntry(input, entryPath, options?)`
+
+Removes a single named entry from an archive, leaving every other entry unchanged. Throws `MetadataNotFoundError` when no entry matches `entryPath`.
+
+**Options**
+
+- `input: ArchiveInput` - A filesystem path or archive `Buffer`.
+- `entryPath: string` - Exact archive entry path to remove.
+- `options.tempDir?: string` - Temporary staging directory for ASAR or 7z operations.
+- `options.output?: string | Writable` - Output destination. Without it, returns a `Buffer`.
+
+**Example**
+
+```js
+const trimmed = await cah.removeArchiveEntry(comicBuffer, 'thumbs.db');
+```
+
 ## Metadata
 
 `ComicMetadata` is the canonical metadata shape, covering every field defined by both bundled schemas (`schemas/ComicInfo v2.1.xsd` and `schemas/MetronInfo v1.1.xsd`) — see [`schemaVersions.ts`](../src/metadata/schemaVersions.ts) if those XSDs are ever upgraded. Conversion between ComicInfo.xml and MetronInfo.xml is intentionally lossy when a field has no equivalent in the target schema; the complete field mapping is maintained in `src/metadata/schema.ts`.
@@ -589,6 +622,7 @@ The following types are exported for TypeScript consumers.
 - `AddMetadataOptions` - Archive write options plus `overwrite?: boolean`.
 - `RenameOptions` - Archive write options plus `start?: number` and `pad?: number`.
 - `StripOptions` - Archive write options plus `extraKeepExtensions?: string[]`.
+- `RemoveEntryOptions` - Archive write options (no additional fields).
 - `ImageConvertOptions` - `webp?`, `jpeg?`, and `png?` format option groups.
 - `WebpOptions` - `quality?`, `effort?`, and `smartSubsample?`.
 - `JpegOptions` - `quality?`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clearmist-labs/comic-archive-handler",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "description": "Detect, convert, and manipulate comic book archives: container conversion, edit metadata, image re-encoding, perceptual + content hashing.",
   "keywords": [
     "7z",