@atcute/car 3.1.3 → 5.1.0

package/README.md

@@ -1,7 +1,13 @@
 # @atcute/car
 
-lightweight [DASL CAR (content-addressable archives)][dasl-car] and atproto repository decoder
-library for AT Protocol.
+content-addressable archive (CAR) codec for AT Protocol.
+
+```sh
+npm install @atcute/car
+```
+
+this library implements DASL's [CAR][dasl-car] format used by AT Protocol to store and transfer
+repository data.
 
 [dasl-car]: https://dasl.ing/car.html
 
@@ -10,50 +16,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', ... }
-	}
+const roots = await car.roots();
 
-	repo.missingBlocks;
-	//   ^? []
-}
-
-// read generic CAR archives
-{
-	await using car = CarReader.fromStream(stream);
-
-	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 +54,28 @@ const buffer = Uint8Array.from([
 	/* ... */
 ]);
 
-// read AT Protocol repository exports
-{
-	const repo = RepoReader.fromUint8Array(buffer);
+// read generic CAR archives
+const car = fromUint8Array(buffer);
 
-	for (const entry of repo) {
-		entry;
-		// ^? RepoEntry { collection: 'app.bsky.feed.post', rkey: '3lprcc55bb222', ... }
-	}
+const roots = car.roots;
 
-	repo.missingBlocks;
-	//   ^? []
+for (const entry of car) {
+	entry;
+	// ^? CarEntry { cid: CidLink {}, bytes: Uint8Array {}, ... }
 }
+```
 
-// read generic CAR archives
-{
-	const car = CarReader.fromUint8Array(buffer);
+### writing
 
-	const roots = car.roots;
+```ts
+import { writeCarStream } from '@atcute/car';
 
-	for (const entry of car) {
-		entry;
-		// ^? CarEntry { cid: CidLink {}, bytes: Uint8Array {}, ... }
-	}
+const blocks = async function* () {
+	yield { cid: commitCid.bytes, data: commitBytes };
+	yield { cid: nodeCid.bytes, data: nodeBytes };
+};
+
+for await (const chunk of writeCarStream([rootCid], blocks())) {
+	stream.write(chunk);
 }
 ```

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":"AAEA,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AAErC,cAAc,aAAa,CAAC;AAE5B,cAAc,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// implements github:darobin/dasl.ing@cc66c35 (2025-10-20)
+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,0DAA0D;AAE1D,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
+export declare const fromUint8Array: (buffer: Uint8Array<ArrayBufferLike>) => SyncCarReader;
+//# 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,wDA0C1B,CAAC"}

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

@@ -90,11 +90,11 @@ const readHeader = (reader) => {
     return { data, headerStart, headerEnd, dataStart, dataEnd };
 };
 const readCid = (reader) => {
-    const head = reader.exactly(4, false);
-    const version = head[0];
-    const codec = head[1];
-    const digestType = head[2];
-    const digestSize = head[3];
+    const bytes = reader.exactly(36, true);
+    const version = bytes[0];
+    const codec = bytes[1];
+    const digestType = bytes[2];
+    const digestSize = bytes[3];
     if (version !== CID.CID_VERSION) {
         throw new RangeError(`incorrect cid version (got v${version})`);
     }
@@ -104,22 +104,17 @@ const readCid = (reader) => {
     if (digestType !== CID.HASH_SHA256) {
         throw new RangeError(`incorrect cid digest type (got 0x${digestType.toString(16)})`);
     }
-    if (digestSize !== 32 && digestSize !== 0) {
+    if (digestSize !== 32) {
         throw new RangeError(`incorrect cid digest size (got ${digestSize})`);
     }
-    const bytes = reader.exactly(4 + digestSize, true);
-    const digest = bytes.subarray(4, 4 + digestSize);
-    const cid = {
+    return {
         version: version,
         codec: codec,
         digest: {
             codec: digestType,
-            contents: digest,
+            contents: bytes.subarray(4, 36),
         },
         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
+export declare const carEntryTransform: () => ReadableWritablePair<CarEntry, Uint8Array<ArrayBufferLike>>;
+export declare const fromStream: (stream: ReadableStream<Uint8Array<ArrayBufferLike>>) => StreamedCarReader;
+//# 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;AAGhD,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,mEA6B7B,CAAC;AAEF,eAAO,MAAM,UAAU,4EA0LtB,CAAC"}

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

@@ -1,6 +1,5 @@
 import * as CBOR from '@atcute/cbor';
 import * as CID from '@atcute/cid';
-import { concat } from '@atcute/uint8array';
 import { isCarV1Header } from './types.js';
 export const carEntryTransform = () => {
     const transform = new TransformStream();
@@ -77,11 +76,11 @@ export const fromStream = (stream) => {
         return buffer;
     };
     const readCid = async () => {
-        const head = await readExact(4);
-        const version = head[0];
-        const codec = head[1];
-        const digestType = head[2];
-        const digestSize = head[3];
+        const bytes = await readExact(36);
+        const version = bytes[0];
+        const codec = bytes[1];
+        const digestType = bytes[2];
+        const digestSize = bytes[3];
         if (version !== CID.CID_VERSION) {
             throw new RangeError(`incorrect cid version (got v${version})`);
         }
@@ -91,24 +90,18 @@ export const fromStream = (stream) => {
         if (digestType !== CID.HASH_SHA256) {
             throw new RangeError(`incorrect cid digest type (got 0x${digestType.toString(16)})`);
         }
-        if (digestSize !== 32 && digestSize !== 0) {
+        if (digestSize !== 32) {
             throw new RangeError(`incorrect cid digest size (got ${digestSize})`);
         }
-        // concatenate and have digest refer back to this buffer
-        const bytes = concat([head, await readExact(digestSize)]);
-        const digest = bytes.subarray(4, 4 + digestSize);
-        const cid = {
+        return {
             version: version,
             codec: codec,
             digest: {
                 codec: digestType,
-                contents: digest,
+                contents: bytes.subarray(4, 36),
             },
             bytes: bytes,
-            // @ts-expect-error
-            _str: undefined,
         };
-        return cid;
     };
     return {
         [Symbol.asyncDispose]() {
@@ -177,4 +170,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,0CAOzB,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,CAAC;IACtE,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;AAAA,CACtG,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,CAAC;IAC3B,IAAI,CAAC,SAAS,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;AAAA,CACD,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,CAAC;IAC5D,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;AAAA,CACX,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAyB,EAA2B,EAAE,CAAC;IACzF,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;AAAA,CACd,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,GAAe,EAAE,IAAgB,EAA2B,EAAE,CAAC;IAChG,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;AAAA,CACd,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,cAAc,CACpC,KAAgB,EAChB,MAAoD,EACV;IAC1C,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;AAAA,CACD"}

package/lib/index.ts

@@ -0,0 +1,8 @@
+// implements github:darobin/dasl.ing@cc66c35 (2025-10-20)
+
+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>;
@@ -131,12 +132,12 @@ const readHeader = (reader: SyncByteReader): CarHeader => {
 };
 
 const readCid = (reader: SyncByteReader): CID.Cid => {
-	const head = reader.exactly(4, false);
+	const bytes = reader.exactly(36, true);
 
-	const version = head[0];
-	const codec = head[1];
-	const digestType = head[2];
-	const digestSize = head[3];
+	const version = bytes[0];
+	const codec = bytes[1];
+	const digestType = bytes[2];
+	const digestSize = bytes[3];
 
 	if (version !== CID.CID_VERSION) {
 		throw new RangeError(`incorrect cid version (got v${version})`);
@@ -150,24 +151,17 @@ const readCid = (reader: SyncByteReader): CID.Cid => {
 		throw new RangeError(`incorrect cid digest type (got 0x${digestType.toString(16)})`);
 	}
 
-	if (digestSize !== 32 && digestSize !== 0) {
+	if (digestSize !== 32) {
 		throw new RangeError(`incorrect cid digest size (got ${digestSize})`);
 	}
 
-	const bytes = reader.exactly(4 + digestSize, true);
-	const digest = bytes.subarray(4, 4 + digestSize);
-
-	const cid: CID.Cid = {
+	return {
 		version: version,
 		codec: codec,
 		digest: {
 			codec: digestType,
-			contents: digest,
+			contents: bytes.subarray(4, 36),
 		},
 		bytes: bytes,
-		// @ts-expect-error
-		_str: undefined,
 	};
-
-	return cid;
 };

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

@@ -1,12 +1,12 @@
 import * as CBOR from '@atcute/cbor';
+import type { Cid, CidLink } from '@atcute/cid';
 import * as CID from '@atcute/cid';
-import { concat } from '@atcute/uint8array';
 
 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,13 +110,13 @@ export const fromStream = (stream: ReadableStream<Uint8Array>): StreamedCarReade
 		return buffer;
 	};
 
-	const readCid = async (): Promise<CID.Cid> => {
-		const head = await readExact(4);
+	const readCid = async (): Promise<Cid> => {
+		const bytes = await readExact(36);
 
-		const version = head[0];
-		const codec = head[1];
-		const digestType = head[2];
-		const digestSize = head[3];
+		const version = bytes[0];
+		const codec = bytes[1];
+		const digestType = bytes[2];
+		const digestSize = bytes[3];
 
 		if (version !== CID.CID_VERSION) {
 			throw new RangeError(`incorrect cid version (got v${version})`);
@@ -130,27 +130,19 @@ export const fromStream = (stream: ReadableStream<Uint8Array>): StreamedCarReade
 			throw new RangeError(`incorrect cid digest type (got 0x${digestType.toString(16)})`);
 		}
 
-		if (digestSize !== 32 && digestSize !== 0) {
+		if (digestSize !== 32) {
 			throw new RangeError(`incorrect cid digest size (got ${digestSize})`);
 		}
 
-		// concatenate and have digest refer back to this buffer
-		const bytes = concat([head, await readExact(digestSize)]);
-		const digest = bytes.subarray(4, 4 + digestSize);
-
-		const cid: CID.Cid = {
+		return {
 			version: version,
 			codec: codec,
 			digest: {
 				codec: digestType,
-				contents: digest,
+				contents: bytes.subarray(4, 36),
 			},
 			bytes: bytes,
-			// @ts-expect-error
-			_str: undefined,
 		};
-
-		return cid;
 	};
 
 	return {
@@ -188,7 +180,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;