@atcute/car 3.1.3 → 5.0.0

package/README.md

@@ -1,7 +1,6 @@
 # @atcute/car
 
-lightweight [DASL CAR (content-addressable archives)][dasl-car] and atproto repository decoder
-library for AT Protocol.
+lightweight [DASL CAR (content-addressable archives)][dasl-car] codec library for AT Protocol.
 
 [dasl-car]: https://dasl.ing/car.html
 
@@ -10,50 +9,34 @@ library for AT Protocol.
 ### streaming usage
 
 ```ts
-import { CarReader, RepoReader } from '@atcute/car/v4';
+import { fromStream } from '@atcute/car';
 
 const stream = new ReadableStream({
 	/* ... */
 });
 
-// read AT Protocol repository exports
-{
-	await using repo = RepoReader.fromStream(stream);
+await using car = fromStream(stream);
 
-	for await (const entry of repo) {
-		entry;
-		// ^? RepoEntry { collection: 'app.bsky.feed.post', rkey: '3lprcc55bb222', ... }
-	}
-
-	repo.missingBlocks;
-	//   ^? []
-}
-
-// read generic CAR archives
-{
-	await using car = CarReader.fromStream(stream);
-
-	const roots = await car.roots();
+const roots = await car.roots();
 
-	for await (const entry of car) {
-		entry;
-		// ^? CarEntry { cid: CidLink {}, bytes: Uint8Array {}, ... }
-	}
+for await (const entry of car) {
+	entry;
+	// ^? CarEntry { cid: CidLink {}, bytes: Uint8Array {}, ... }
 }
 ```
 
 ### streaming usage (for runtimes without `await using` yet)
 
 ```ts
-const repo = RepoReader.fromStream(stream);
+const car = fromStream(stream);
 
 try {
-	for await (const entry of repo) {
+	for await (const entry of car) {
 		entry;
-		// ^? RepoEntry
+		// ^? CarEntry { ... }
 	}
 } finally {
-	await repo.dispose();
+	await car.dispose();
 }
 ```
 
@@ -64,28 +47,13 @@ const buffer = Uint8Array.from([
 	/* ... */
 ]);
 
-// read AT Protocol repository exports
-{
-	const repo = RepoReader.fromUint8Array(buffer);
-
-	for (const entry of repo) {
-		entry;
-		// ^? RepoEntry { collection: 'app.bsky.feed.post', rkey: '3lprcc55bb222', ... }
-	}
-
-	repo.missingBlocks;
-	//   ^? []
-}
-
 // read generic CAR archives
-{
-	const car = CarReader.fromUint8Array(buffer);
+const car = fromUint8Array(buffer);
 
-	const roots = car.roots;
+const roots = car.roots;
 
-	for (const entry of car) {
-		entry;
-		// ^? CarEntry { cid: CidLink {}, bytes: Uint8Array {}, ... }
-	}
+for (const entry of car) {
+	entry;
+	// ^? CarEntry { cid: CidLink {}, bytes: Uint8Array {}, ... }
 }
 ```

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from './reader.js';
+export * from './streamed-reader.js';
+export * from './writer.js';
+export * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AAErC,cAAc,aAAa,CAAC;AAE5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from './reader.js';
+export * from './streamed-reader.js';
+export * from './writer.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AAErC,cAAc,aAAa,CAAC;AAE5B,cAAc,YAAY,CAAC"}

package/dist/{v4/car-reader/sync-car-reader.d.ts → reader.d.ts}

@@ -1,11 +1,11 @@
-import * as CBOR from '@atcute/cbor';
+import type { CidLink } from '@atcute/cid';
 import { type CarEntry, type CarHeader } from './types.js';
 export interface SyncCarReader {
     readonly header: CarHeader;
-    readonly roots: CBOR.CidLink[];
+    readonly roots: CidLink[];
     /** @deprecated do for..of on the reader directly */
     iterate(): Generator<CarEntry>;
     [Symbol.iterator](): Iterator<CarEntry>;
 }
 export declare const fromUint8Array: (buffer: Uint8Array) => SyncCarReader;
-//# sourceMappingURL=sync-car-reader.d.ts.map
+//# sourceMappingURL=reader.d.ts.map

package/dist/reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.d.ts","sourceRoot":"","sources":["../lib/reader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAS1E,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;IAE1B,oDAAoD;IACpD,OAAO,IAAI,SAAS,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,CAAC;CACxC;AAED,eAAO,MAAM,cAAc,GAAI,QAAQ,UAAU,KAAG,aA0CnD,CAAC"}

package/dist/{v4/car-reader/sync-car-reader.js → reader.js}

@@ -117,9 +117,7 @@ const readCid = (reader) => {
             contents: digest,
         },
         bytes: bytes,
-        // @ts-expect-error
-        _str: undefined,
     };
     return cid;
 };
-//# sourceMappingURL=sync-car-reader.js.map
+//# sourceMappingURL=reader.js.map

package/dist/reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reader.js","sourceRoot":"","sources":["../lib/reader.ts"],"names":[],"mappings":"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"}

package/dist/{v4/car-reader/stream-car-reader.d.ts → streamed-reader.d.ts}

@@ -1,12 +1,12 @@
-import * as CBOR from '@atcute/cbor';
+import type { CidLink } from '@atcute/cid';
 import { type CarEntry, type CarHeader } from './types.js';
 export interface StreamedCarReader {
     header(): Promise<CarHeader>;
-    roots(): Promise<CBOR.CidLink[]>;
+    roots(): Promise<CidLink[]>;
     dispose(): Promise<void>;
     [Symbol.asyncDispose](): Promise<void>;
     [Symbol.asyncIterator](): AsyncIterator<CarEntry>;
 }
 export declare const carEntryTransform: () => ReadableWritablePair<CarEntry, Uint8Array>;
 export declare const fromStream: (stream: ReadableStream<Uint8Array>) => StreamedCarReader;
-//# sourceMappingURL=stream-car-reader.d.ts.map
+//# sourceMappingURL=streamed-reader.d.ts.map

package/dist/streamed-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamed-reader.d.ts","sourceRoot":"","sources":["../lib/streamed-reader.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAO,OAAO,EAAE,MAAM,aAAa,CAAC;AAIhD,OAAO,EAAiB,KAAK,QAAQ,EAAE,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IACjC,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAE5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzB,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC;CAClD;AAED,eAAO,MAAM,iBAAiB,QAAO,oBAAoB,CAAC,QAAQ,EAAE,UAAU,CA6B7E,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,QAAQ,cAAc,CAAC,UAAU,CAAC,KAAG,iBAgM/D,CAAC"}

package/dist/{v4/car-reader/stream-car-reader.js → streamed-reader.js}

@@ -105,8 +105,6 @@ export const fromStream = (stream) => {
                 contents: digest,
             },
             bytes: bytes,
-            // @ts-expect-error
-            _str: undefined,
         };
         return cid;
     };
@@ -177,4 +175,4 @@ export const fromStream = (stream) => {
         },
     };
 };
-//# sourceMappingURL=stream-car-reader.js.map
+//# sourceMappingURL=streamed-reader.js.map

package/dist/streamed-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"streamed-reader.js","sourceRoot":"","sources":["../lib/streamed-reader.ts"],"names":[],"mappings":"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"}

package/dist/{v4/car-reader/types.d.ts → types.d.ts}

@@ -1,7 +1,7 @@
-import * as CID from '@atcute/cid';
+import { type Cid, type CidLink } from '@atcute/cid';
 export interface CarV1Header {
     version: 1;
-    roots: CID.CidLink[];
+    roots: CidLink[];
 }
 export declare const isCarV1Header: (value: unknown) => value is CarV1Header;
 export interface CarHeader {
@@ -14,11 +14,20 @@ export interface CarHeader {
 export interface CarEntry {
     entryStart: number;
     entryEnd: number;
-    cid: CID.Cid;
+    cid: Cid;
     cidStart: number;
     cidEnd: number;
     bytes: Uint8Array;
     bytesStart: number;
     bytesEnd: number;
 }
+/**
+ * represents a block to be written to a CAR file
+ */
+export interface CarBlock {
+    /** the CID of the block (as bytes) */
+    cid: Uint8Array;
+    /** the block data */
+    data: Uint8Array;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,GAAG,EAAE,KAAK,OAAO,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,WAAW;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,WAOvD,CAAC;AAEF,MAAM,WAAW,SAAS;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAElB,IAAI,EAAE,WAAW,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IAEjB,GAAG,EAAE,GAAG,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IAEf,KAAK,EAAE,UAAU,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,QAAQ;IACxB,sCAAsC;IACtC,GAAG,EAAE,UAAU,CAAC;IAChB,qBAAqB;IACrB,IAAI,EAAE,UAAU,CAAC;CACjB"}

package/dist/{v4/car-reader/types.js → types.js}

@@ -1,10 +1,9 @@
-import * as CBOR from '@atcute/cbor';
-import * as CID from '@atcute/cid';
+import { CidLinkWrapper } from '@atcute/cid';
 export const isCarV1Header = (value) => {
     if (value === null || typeof value !== 'object') {
         return false;
     }
     const { version, roots } = value;
-    return version === 1 && Array.isArray(roots) && roots.every((root) => root instanceof CBOR.CidLinkWrapper);
+    return version === 1 && Array.isArray(roots) && roots.every((root) => root instanceof CidLinkWrapper);
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA0B,MAAM,aAAa,CAAC;AAOrE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAc,EAAwB,EAAE;IACrE,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACjD,OAAO,KAAK,CAAC;IACd,CAAC;IAED,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,KAAoB,CAAC;IAChD,OAAO,OAAO,KAAK,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,YAAY,cAAc,CAAC,CAAC;AACvG,CAAC,CAAC"}

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../lib/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM,EAAE;IACpB,CAAC,SAAS,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAKzD,CAAC"}

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../lib/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAEf,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;AACF,CAAC,CAAC"}

package/dist/writer.d.ts

@@ -0,0 +1,26 @@
+import type { CidLink } from '@atcute/cid';
+import type { CarBlock } from './types.js';
+/**
+ * creates an async generator that yields CAR file chunks
+ * @param root root CIDs for the CAR file
+ * @param blocks async iterable of blocks to write
+ * @yields Uint8Array chunks of the CAR file (header, then entries)
+ *
+ * @example
+ * ```typescript
+ * const blocks = async function* () {
+ *   yield { cid: commitCid.bytes, data: commitBytes };
+ *   yield { cid: nodeCid.bytes, data: nodeBytes };
+ * };
+ *
+ * // Stream chunks
+ * for await (const chunk of writeCarStream([rootCid], blocks())) {
+ *   stream.write(chunk);
+ * }
+ *
+ * // Or collect into array (requires Array.fromAsync or polyfill)
+ * const chunks = await Array.fromAsync(writeCarStream([rootCid], blocks()));
+ * ```
+ */
+export declare function writeCarStream(roots: CidLink[], blocks: AsyncIterable<CarBlock> | Iterable<CarBlock>): AsyncGenerator<Uint8Array<ArrayBuffer>>;
+//# sourceMappingURL=writer.d.ts.map

package/dist/writer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../lib/writer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAI3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAqD3C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAuB,cAAc,CACpC,KAAK,EAAE,OAAO,EAAE,EAChB,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,GAClD,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAQzC"}

package/dist/writer.js

@@ -0,0 +1,77 @@
+import * as CBOR from '@atcute/cbor';
+import { allocUnsafe } from '@atcute/uint8array';
+import * as varint from '@atcute/varint';
+/**
+ * encodes a number as an unsigned varint (variable-length integer)
+ * @param n the number to encode
+ * @returns the varint-encoded bytes
+ */
+const encodeVarint = (n) => {
+    const length = varint.encodingLength(n);
+    const buf = allocUnsafe(length);
+    varint.encode(n, buf, 0);
+    return buf;
+};
+/**
+ * serializes a CAR v1 header
+ * @internal
+ * @param roots array of root CIDs (typically just one)
+ * @returns the serialized header bytes
+ */
+export const serializeCarHeader = (roots) => {
+    const headerData = CBOR.encode({
+        version: 1,
+        roots: roots,
+    });
+    const headerSize = encodeVarint(headerData.length);
+    const result = allocUnsafe(headerSize.length + headerData.length);
+    result.set(headerSize, 0);
+    result.set(headerData, headerSize.length);
+    return result;
+};
+/**
+ * serializes a single CAR entry (block)
+ * @internal
+ * @param cid the CID of the block (as bytes)
+ * @param data the block data
+ * @returns the serialized entry bytes
+ */
+export const serializeCarEntry = (cid, data) => {
+    const entrySize = encodeVarint(cid.length + data.length);
+    const result = allocUnsafe(entrySize.length + cid.length + data.length);
+    result.set(entrySize, 0);
+    result.set(cid, entrySize.length);
+    result.set(data, entrySize.length + cid.length);
+    return result;
+};
+/**
+ * creates an async generator that yields CAR file chunks
+ * @param root root CIDs for the CAR file
+ * @param blocks async iterable of blocks to write
+ * @yields Uint8Array chunks of the CAR file (header, then entries)
+ *
+ * @example
+ * ```typescript
+ * const blocks = async function* () {
+ *   yield { cid: commitCid.bytes, data: commitBytes };
+ *   yield { cid: nodeCid.bytes, data: nodeBytes };
+ * };
+ *
+ * // Stream chunks
+ * for await (const chunk of writeCarStream([rootCid], blocks())) {
+ *   stream.write(chunk);
+ * }
+ *
+ * // Or collect into array (requires Array.fromAsync or polyfill)
+ * const chunks = await Array.fromAsync(writeCarStream([rootCid], blocks()));
+ * ```
+ */
+export async function* writeCarStream(roots, blocks) {
+    // Emit header first
+    yield serializeCarHeader(roots);
+    // Then emit each block entry
+    for await (const block of blocks) {
+        yield serializeCarEntry(block.cid, block.data);
+    }
+}
+//# sourceMappingURL=writer.js.map

package/dist/writer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer.js","sourceRoot":"","sources":["../lib/writer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,cAAc,CAAC;AAErC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAIzC;;;;GAIG;AACH,MAAM,YAAY,GAAG,CAAC,CAAS,EAA2B,EAAE;IAC3D,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,GAAG,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACzB,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAyB,EAA2B,EAAE;IACxF,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC;QAC9B,OAAO,EAAE,CAAC;QACV,KAAK,EAAE,KAAK;KACZ,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,WAAW,CAAC,UAAU,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IAElE,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IAE1C,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAe,EAAE,IAAgB,EAA2B,EAAE;IAC/F,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,WAAW,CAAC,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;IAExE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACzB,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC;IAEhD,OAAO,MAAM,CAAC;AACf,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACpC,KAAgB,EAChB,MAAoD;IAEpD,oBAAoB;IACpB,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAC;IAEhC,6BAA6B;IAC7B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAClC,MAAM,iBAAiB,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAChD,CAAC;AACF,CAAC"}

package/lib/index.ts

@@ -0,0 +1,6 @@
+export * from './reader.js';
+export * from './streamed-reader.js';
+
+export * from './writer.js';
+
+export * from './types.js';

package/lib/{v4/car-reader/sync-car-reader.ts → reader.ts}

@@ -1,4 +1,5 @@
 import * as CBOR from '@atcute/cbor';
+import type { CidLink } from '@atcute/cid';
 import * as CID from '@atcute/cid';
 import * as varint from '@atcute/varint';
 
@@ -13,7 +14,7 @@ interface SyncByteReader {
 
 export interface SyncCarReader {
 	readonly header: CarHeader;
-	readonly roots: CBOR.CidLink[];
+	readonly roots: CidLink[];
 
 	/** @deprecated do for..of on the reader directly */
 	iterate(): Generator<CarEntry>;
@@ -165,8 +166,6 @@ const readCid = (reader: SyncByteReader): CID.Cid => {
 			contents: digest,
 		},
 		bytes: bytes,
-		// @ts-expect-error
-		_str: undefined,
 	};
 
 	return cid;

package/lib/{v4/car-reader/stream-car-reader.ts → streamed-reader.ts}

@@ -1,4 +1,5 @@
 import * as CBOR from '@atcute/cbor';
+import type { Cid, CidLink } from '@atcute/cid';
 import * as CID from '@atcute/cid';
 import { concat } from '@atcute/uint8array';
 
@@ -6,7 +7,7 @@ import { isCarV1Header, type CarEntry, type CarHeader } from './types.js';
 
 export interface StreamedCarReader {
 	header(): Promise<CarHeader>;
-	roots(): Promise<CBOR.CidLink[]>;
+	roots(): Promise<CidLink[]>;
 
 	dispose(): Promise<void>;
 
@@ -110,7 +111,7 @@ export const fromStream = (stream: ReadableStream<Uint8Array>): StreamedCarReade
 		return buffer;
 	};
 
-	const readCid = async (): Promise<CID.Cid> => {
+	const readCid = async (): Promise<Cid> => {
 		const head = await readExact(4);
 
 		const version = head[0];
@@ -138,7 +139,7 @@ export const fromStream = (stream: ReadableStream<Uint8Array>): StreamedCarReade
 		const bytes = concat([head, await readExact(digestSize)]);
 		const digest = bytes.subarray(4, 4 + digestSize);
 
-		const cid: CID.Cid = {
+		const cid: Cid = {
 			version: version,
 			codec: codec,
 			digest: {
@@ -146,8 +147,6 @@ export const fromStream = (stream: ReadableStream<Uint8Array>): StreamedCarReade
 				contents: digest,
 			},
 			bytes: bytes,
-			// @ts-expect-error
-			_str: undefined,
 		};
 
 		return cid;
@@ -188,7 +187,7 @@ export const fromStream = (stream: ReadableStream<Uint8Array>): StreamedCarReade
 			return (_header = { data, headerStart, headerEnd, dataStart, dataEnd });
 		},
 
-		async roots(): Promise<CBOR.CidLink[]> {
+		async roots(): Promise<CidLink[]> {
 			const header = await this.header();
 
 			return header.data.roots;

package/lib/{v4/car-reader/types.ts → types.ts}

@@ -1,9 +1,8 @@
-import * as CBOR from '@atcute/cbor';
-import * as CID from '@atcute/cid';
+import { CidLinkWrapper, type Cid, type CidLink } from '@atcute/cid';
 
 export interface CarV1Header {
 	version: 1;
-	roots: CID.CidLink[];
+	roots: CidLink[];
 }
 
 export const isCarV1Header = (value: unknown): value is CarV1Header => {
@@ -12,7 +11,7 @@ export const isCarV1Header = (value: unknown): value is CarV1Header => {
 	}
 
 	const { version, roots } = value as CarV1Header;
-	return version === 1 && Array.isArray(roots) && roots.every((root) => root instanceof CBOR.CidLinkWrapper);
+	return version === 1 && Array.isArray(roots) && roots.every((root) => root instanceof CidLinkWrapper);
 };
 
 export interface CarHeader {
@@ -28,7 +27,7 @@ export interface CarEntry {
 	entryStart: number;
 	entryEnd: number;
 
-	cid: CID.Cid;
+	cid: Cid;
 	cidStart: number;
 	cidEnd: number;
 
@@ -36,3 +35,13 @@ export interface CarEntry {
 	bytesStart: number;
 	bytesEnd: number;
 }
+
+/**
+ * represents a block to be written to a CAR file
+ */
+export interface CarBlock {
+	/** the CID of the block (as bytes) */
+	cid: Uint8Array;
+	/** the block data */
+	data: Uint8Array;
+}

package/lib/writer.ts

@@ -0,0 +1,92 @@
+import * as CBOR from '@atcute/cbor';
+import type { CidLink } from '@atcute/cid';
+import { allocUnsafe } from '@atcute/uint8array';
+import * as varint from '@atcute/varint';
+
+import type { CarBlock } from './types.js';
+
+/**
+ * encodes a number as an unsigned varint (variable-length integer)
+ * @param n the number to encode
+ * @returns the varint-encoded bytes
+ */
+const encodeVarint = (n: number): Uint8Array<ArrayBuffer> => {
+	const length = varint.encodingLength(n);
+	const buf = allocUnsafe(length);
+	varint.encode(n, buf, 0);
+	return buf;
+};
+
+/**
+ * serializes a CAR v1 header
+ * @internal
+ * @param roots array of root CIDs (typically just one)
+ * @returns the serialized header bytes
+ */
+export const serializeCarHeader = (roots: readonly CidLink[]): Uint8Array<ArrayBuffer> => {
+	const headerData = CBOR.encode({
+		version: 1,
+		roots: roots,
+	});
+
+	const headerSize = encodeVarint(headerData.length);
+	const result = allocUnsafe(headerSize.length + headerData.length);
+
+	result.set(headerSize, 0);
+	result.set(headerData, headerSize.length);
+
+	return result;
+};
+
+/**
+ * serializes a single CAR entry (block)
+ * @internal
+ * @param cid the CID of the block (as bytes)
+ * @param data the block data
+ * @returns the serialized entry bytes
+ */
+export const serializeCarEntry = (cid: Uint8Array, data: Uint8Array): Uint8Array<ArrayBuffer> => {
+	const entrySize = encodeVarint(cid.length + data.length);
+	const result = allocUnsafe(entrySize.length + cid.length + data.length);
+
+	result.set(entrySize, 0);
+	result.set(cid, entrySize.length);
+	result.set(data, entrySize.length + cid.length);
+
+	return result;
+};
+
+/**
+ * creates an async generator that yields CAR file chunks
+ * @param root root CIDs for the CAR file
+ * @param blocks async iterable of blocks to write
+ * @yields Uint8Array chunks of the CAR file (header, then entries)
+ *
+ * @example
+ * ```typescript
+ * const blocks = async function* () {
+ *   yield { cid: commitCid.bytes, data: commitBytes };
+ *   yield { cid: nodeCid.bytes, data: nodeBytes };
+ * };
+ *
+ * // Stream chunks
+ * for await (const chunk of writeCarStream([rootCid], blocks())) {
+ *   stream.write(chunk);
+ * }
+ *
+ * // Or collect into array (requires Array.fromAsync or polyfill)
+ * const chunks = await Array.fromAsync(writeCarStream([rootCid], blocks()));
+ * ```
+ */
+export async function* writeCarStream(
+	roots: CidLink[],
+	blocks: AsyncIterable<CarBlock> | Iterable<CarBlock>,
+): AsyncGenerator<Uint8Array<ArrayBuffer>> {
+	// Emit header first
+	yield serializeCarHeader(roots);
+
+	// Then emit each block entry
+	for await (const block of blocks) {
+		yield serializeCarEntry(block.cid, block.data);
+	}
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "type": "module",
   "name": "@atcute/car",
-  "version": "3.1.3",
-  "description": "lightweight DASL CAR and atproto repository decoder for AT Protocol.",
+  "version": "5.0.0",
+  "description": "lightweight DASL CAR (content-addressable archives) codec for AT Protocol.",
   "keywords": [
     "atproto",
     "dasl",
@@ -20,26 +20,23 @@
     "!lib/**/*.test.ts"
   ],
   "exports": {
-    ".": "./dist/v3/index.js",
-    "./v4": "./dist/v4/index.js",
-    "./v4/car-reader": "./dist/v4/car-reader/index.js",
-    "./v4/repo-reader": "./dist/v4/repo-reader/index.js"
+    ".": "./dist/index.js"
   },
   "sideEffects": false,
   "devDependencies": {
-    "@types/bun": "^1.2.21",
+    "@vitest/coverage-v8": "^3.2.4",
+    "vitest": "^3.2.4",
     "@atcute/multibase": "^1.1.6"
   },
   "dependencies": {
-    "yocto-queue": "^1.2.1",
+    "@atcute/cid": "^2.2.6",
     "@atcute/cbor": "^2.2.7",
-    "@atcute/cid": "^2.2.5",
     "@atcute/uint8array": "^1.0.5",
     "@atcute/varint": "^1.0.3"
   },
   "scripts": {
     "build": "tsc --project tsconfig.build.json",
-    "test": "bun test --coverage",
+    "test": "vitest --coverage",
     "prepublish": "rm -rf dist; pnpm run build"
   }
 }