@amalgm/live 0.2.59 → 0.2.60

package/dist/transfer/download.js

@@ -1,31 +1,232 @@
 /**
  * Download a set of immutable artifacts into a machine cache.
  *
- * The set is the primitive: one plan phase proves every manifest and asks the
- * cache which chunks are gaps, one fetch phase obtains every gap across the
- * whole set under a single bound, and one seal phase verifies each complete
- * artifact. A lone artifact is a set of one — there is no second path. This
- * shape removes per-artifact serialization: no artifact waits behind
- * another's plan or seal, only behind the shared fetch bound. Each chunk is
- * still its own storage request — the set changes scheduling, not the
- * request count.
+ * The set is the primitive and the plan is physical. Wave one proves every
+ * manifest: locally held ones are checked in place, missing ones are
+ * resolved as one want-list and fetched grouped by the pack that holds
+ * them. Wave two reads the proven manifests, asks the cache which chunks
+ * are gaps, resolves the whole gap list, and fetches it the same way: all
+ * members of one pack collapse into a few broad byte spans — approximately
+ * one read per pack — while standalone objects remain one read each. A
+ * lone artifact is a set of one; there is no second download path.
  *
- * Fetches complete in whatever order the network answers, but each artifact
+ * Spans complete in whatever order storage answers, but each artifact
  * stores its chunks in chunk order: a verified chunk waits until every
- * earlier gap of the same artifact has been stored. Gaps are admitted round
- * robin across artifacts, so one large artifact cannot occupy the whole
- * window while unrelated work waits. Held bytes stay inside the in-flight
- * byte bound.
+ * earlier gap of the same artifact is stored, so a host assembling a
+ * whole-file digest never re-reads what landed early. The scheduler admits
+ * fetch units strictly in fair plan order, and the plan orders units so a
+ * chunk's predecessor always lives in the same or an earlier unit — an
+ * artifact whose gaps do not line up ascending inside one pack falls back
+ * to per-object reads at its own positions — so ordered stores can never
+ * deadlock. Chains enter the plan round-robin by depth, so one multi-chunk
+ * artifact cannot monopolize the bounded window while unrelated artifacts
+ * wait. In-flight span bytes stay inside one explicit bound; raising request
+ * concurrency never silently raises memory.
  *
- * Every chunk keeps one content-addressed identity, whether its sealed
- * envelope lives alone or as a byte range inside an immutable pack. The
- * host's ports resolve and fetch those identities; parallelism, storage
- * layout, transport, and decryption are the host's concern, while the
- * verification laws here remain singular.
+ * Every object keeps one content-addressed identity whether its sealed
+ * envelope lives alone or as a byte range inside an immutable pack, and
+ * placement is immutable: a retried read may refresh its URL but never its
+ * geometry. Wrong or shifted bytes cannot leak — every dispensed slice is
+ * still an authenticated envelope the host opens and this engine
+ * hash-verifies before a single byte is stored.
  */
 import { CHUNK_BYTES, checkContentManifest } from '../contracts/content.js';
 import { assertTransferArtifact } from './artifacts.js';
 import { DEFAULT_TRANSFER_CONCURRENCY, parallelForEach, weightedParallelForEach, } from './parallel.js';
+import { planPackSpans, RANGE_MERGE_GAP_BYTES } from './ranges.js';
+import { resolveContentRefs } from './refs.js';
+function checkRefLocation(ref, object) {
+    if (ref === undefined || typeof ref.url !== 'string' || ref.url.length === 0) {
+        throw new Error(`content ref for ${object.kind} ${object.sha256} named no location`);
+    }
+    if ((ref.offset === undefined) !== (ref.length === undefined)) {
+        throw new Error(`content ref for ${object.kind} ${object.sha256} named half a byte range`);
+    }
+    if (ref.offset === undefined || ref.length === undefined)
+        return { url: ref.url, span: null };
+    if (!Number.isSafeInteger(ref.offset) || ref.offset < 0
+        || !Number.isSafeInteger(ref.length) || ref.length < 1) {
+        throw new Error(`content ref for ${object.kind} ${object.sha256} named an invalid byte range`);
+    }
+    return { url: ref.url, span: { offset: ref.offset, length: ref.length } };
+}
+/** Resolve one wave's want-list and fetch it as planned units: pack members
+ * as broad spans, standalone objects whole. Deadlock-frame law: dependencies
+ * only run backward along a chain, chains join pack grouping only when their
+ * refs ascend inside one pack, a pack's spans stay contiguous in ascending
+ * offset order, and admission is strictly FIFO — so a chunk's predecessor is
+ * always in the same unit earlier, or in an already-admitted one. */
+async function fetchWave(ports, chains, concurrency, maxInFlightBytes) {
+    // Fair admission is part of the set law: take one dependency depth from
+    // every artifact before taking the next. This preserves predecessor-first
+    // ordering within each chain without letting one large artifact occupy the
+    // whole byte window while unrelated work waits.
+    const flat = [];
+    const maxDepth = chains.reduce((maximum, chain) => Math.max(maximum, chain.length), 0);
+    for (let depth = 0; depth < maxDepth; depth += 1) {
+        chains.forEach((items, chain) => {
+            const item = items[depth];
+            if (item !== undefined)
+                flat.push({ chain, item });
+        });
+    }
+    if (flat.length === 0)
+        return { rangedReads: 0, packedObjects: 0, standaloneObjects: 0 };
+    const refs = await resolveContentRefs(ports, flat.map(({ item }) => item.object));
+    const byChain = chains.map(() => []);
+    flat.forEach(({ chain, item }, order) => {
+        const members = byChain[chain];
+        if (members === undefined)
+            throw new Error('download wave lost a chain');
+        members.push({ item, order, ...checkRefLocation(refs[order], item.object) });
+    });
+    // A chain rides pack grouping only when every gap sits in one pack with
+    // non-descending offsets; anything else falls back to per-object reads so
+    // store order can never depend on a later fetch unit.
+    const groups = new Map();
+    const singles = [];
+    for (const chain of byChain) {
+        const first = chain[0];
+        if (first === undefined)
+            continue;
+        const coherent = chain.every((member, index) => {
+            if (member.span === null || member.url !== first.url)
+                return false;
+            const previous = chain[index - 1];
+            return previous?.span == null || member.span.offset >= previous.span.offset;
+        });
+        if (!coherent) {
+            singles.push(...chain);
+            continue;
+        }
+        const members = groups.get(first.url);
+        if (members === undefined)
+            groups.set(first.url, [...chain]);
+        else
+            members.push(...chain);
+    }
+    const units = [];
+    let packedObjects = 0;
+    let standaloneObjects = 0;
+    for (const members of groups.values()) {
+        packedObjects += members.length;
+        members.sort((a, b) => (a.span?.offset ?? 0) - (b.span?.offset ?? 0) || a.order - b.order);
+        const spans = members.map((member) => {
+            if (member.span === null)
+                throw new Error('download wave grouped a standalone object');
+            return member.span;
+        });
+        const plan = planPackSpans(spans, RANGE_MERGE_GAP_BYTES, maxInFlightBytes);
+        const perSpan = plan.spans.map(() => []);
+        members.forEach((member, index) => {
+            const spanIndex = plan.memberSpan[index];
+            const list = spanIndex === undefined ? undefined : perSpan[spanIndex];
+            if (list === undefined)
+                throw new Error('download wave lost a span member');
+            list.push(member);
+        });
+        const primary = members.reduce((least, member) => Math.min(least, member.order), Number.MAX_SAFE_INTEGER);
+        plan.spans.forEach((span, index) => {
+            const list = perSpan[index];
+            const anchor = list?.[0];
+            if (list === undefined || anchor === undefined) {
+                throw new Error('download wave planned an empty span');
+            }
+            units.push({
+                url: anchor.url,
+                span,
+                members: list.map((member) => {
+                    if (member.span === null)
+                        throw new Error('download wave grouped a standalone object');
+                    return {
+                        item: member.item,
+                        offset: member.span.offset - span.offset,
+                        length: member.span.length,
+                    };
+                }),
+                refresh: anchor,
+                weight: Math.min(span.length, maxInFlightBytes),
+                primary,
+                secondary: index,
+                ranged: true,
+            });
+        });
+    }
+    for (const member of singles) {
+        if (member.span !== null) {
+            packedObjects += 1;
+            units.push({
+                url: member.url,
+                span: member.span,
+                members: [{ item: member.item, offset: 0, length: member.span.length }],
+                refresh: member,
+                weight: Math.min(member.span.length, maxInFlightBytes),
+                primary: member.order,
+                secondary: 0,
+                ranged: true,
+            });
+        }
+        else {
+            standaloneObjects += 1;
+            units.push({
+                url: member.url,
+                span: null,
+                members: [{ item: member.item, offset: 0, length: null }],
+                refresh: member,
+                weight: Math.max(1, Math.min(member.item.standaloneWeight, maxInFlightBytes)),
+                primary: member.order,
+                secondary: 0,
+                ranged: false,
+            });
+        }
+    }
+    units.sort((a, b) => a.primary - b.primary || a.secondary - b.secondary);
+    await weightedParallelForEach(units, concurrency, maxInFlightBytes, (unit) => unit.weight, async (unit) => {
+        let delivered = 0;
+        try {
+            const refresh = async () => {
+                const [fresh] = await ports.requestRefs([unit.refresh.item.object]);
+                const location = checkRefLocation(fresh, unit.refresh.item.object);
+                const before = unit.refresh.span;
+                const moved = (location.span === null) !== (before === null)
+                    || (location.span !== null && before !== null
+                        && (location.span.offset !== before.offset
+                            || location.span.length !== before.length));
+                if (moved) {
+                    throw new Error(`content ${unit.refresh.item.object.kind} `
+                        + `${unit.refresh.item.object.sha256} changed placement between fetch attempts`);
+                }
+                return location.url;
+            };
+            const bytes = await ports.fetchSpan(unit.url, unit.span, refresh);
+            if (!(bytes instanceof Uint8Array))
+                throw new Error('storage fetch answered no bytes');
+            if (unit.span !== null && bytes.byteLength !== unit.span.length) {
+                throw new Error('storage fetch answered the wrong byte count');
+            }
+            for (const member of unit.members) {
+                const sealed = member.length === null
+                    ? bytes
+                    : bytes.subarray(member.offset, member.offset + member.length);
+                if (member.length !== null && sealed.byteLength !== member.length) {
+                    throw new Error('storage span cannot cover a planned member');
+                }
+                await member.item.deliver(sealed);
+                delivered += 1;
+            }
+        }
+        catch (error) {
+            for (const member of unit.members.slice(delivered))
+                member.item.fail(error);
+            throw error;
+        }
+    });
+    return {
+        rangedReads: units.reduce((count, unit) => count + (unit.ranged ? 1 : 0), 0),
+        packedObjects,
+        standaloneObjects,
+    };
+}
 /** Download a set of immutable artifacts, fetching only machine-cache gaps.
  * Receipts return in input order; any failure fails the whole set after
  * letting in-flight effects settle. */
@@ -35,94 +236,148 @@ export async function downloadAll(artifacts, ports, options = {}) {
         ?? DEFAULT_TRANSFER_CONCURRENCY * CHUNK_BYTES;
     for (const artifact of artifacts)
         assertTransferArtifact(artifact);
-    const plans = new Array(artifacts.length);
+    // Wave one: prove every manifest. Held manifests are checked in place;
+    // missing ones fetch as one planned wave grouped by pack.
+    const manifests = new Array(artifacts.length);
+    let localManifests = 0;
+    const manifestChains = [];
+    artifacts.forEach((artifact, slot) => {
+        const local = ports.localManifest(artifact);
+        if (local !== null && local !== undefined) {
+            const checked = checkContentManifest(local, artifact.contentHash);
+            if (!checked.ok)
+                throw new Error(checked.error);
+            manifests[slot] = checked.value;
+            localManifests += 1;
+            return;
+        }
+        const object = { kind: 'manifest', sha256: artifact.contentHash };
+        manifestChains.push([{
+                object,
+                standaloneWeight: 1,
+                deliver: async (sealed) => {
+                    const plain = await ports.openEnvelope(object, sealed);
+                    let parsed;
+                    try {
+                        parsed = JSON.parse(new TextDecoder().decode(plain));
+                    }
+                    catch {
+                        throw new Error(`downloaded manifest for ${artifact.contentHash} is not valid JSON`);
+                    }
+                    const checked = checkContentManifest(parsed, artifact.contentHash);
+                    if (!checked.ok)
+                        throw new Error(checked.error);
+                    manifests[slot] = checked.value;
+                    await ports.manifestProven(artifact, checked.value);
+                },
+                fail: () => { },
+            }]);
+    });
+    const manifestWave = await fetchWave(ports, manifestChains, concurrency, maxInFlightBytes);
+    // Ask the cache which chunks are gaps, now that every manifest is proven.
+    const gaps = new Array(artifacts.length);
     await parallelForEach([...artifacts.keys()], concurrency, async (slot) => {
         const artifact = artifacts[slot];
-        if (artifact === undefined)
-            return;
-        const checked = checkContentManifest(await ports.getManifest(artifact), artifact.contentHash);
-        if (!checked.ok)
-            throw new Error(checked.error);
-        const manifest = checked.value;
+        const manifest = manifests[slot];
+        if (artifact === undefined || manifest === undefined) {
+            throw new Error('download set lost a manifest');
+        }
         const missing = [];
         for (const index of manifest.chunks.keys()) {
             if (!await ports.hasChunk(artifact, manifest, index))
                 missing.push(index);
         }
-        plans[slot] = { artifact, manifest, missing };
+        gaps[slot] = missing;
     });
-    const gaps = [];
-    const priorByPlan = new Map();
-    const maxGaps = plans.reduce((maximum, plan) => Math.max(maximum, plan?.missing.length ?? 0), 0);
-    for (let depth = 0; depth < maxGaps; depth += 1) {
-        for (const plan of plans) {
-            if (plan === undefined)
-                continue;
-            const index = plan.missing[depth];
-            if (index === undefined)
-                continue;
+    // Wave two: fetch every gap as one planned wave. Each artifact's gaps form
+    // one chain so chunks store in chunk order; `delivered` settles when a gap
+    // is stored, or rejects so no later chunk waits forever.
+    const blockChains = [];
+    artifacts.forEach((artifact, slot) => {
+        const manifest = manifests[slot];
+        const missing = gaps[slot];
+        if (manifest === undefined || missing === undefined || missing.length === 0)
+            return;
+        let prior;
+        const chain = [];
+        for (const index of missing) {
+            const expected = manifest.chunks[index];
+            if (expected === undefined)
+                throw new Error('download manifest named an unknown chunk index');
             let stored;
             let failed;
             const delivered = new Promise((resolve, reject) => {
                 stored = resolve;
                 failed = reject;
             });
-            // A failed effect may leave no later chunk admitted to observe the
-            // rejection; the set still fails through the effect's own throw.
+            // A failed unit may leave no later chunk admitted to observe the
+            // rejection; the set still fails through the unit's own throw.
             delivered.catch(() => { });
-            gaps.push({ plan, index, priorStored: priorByPlan.get(plan), stored, failed });
-            priorByPlan.set(plan, delivered);
-        }
-    }
-    await weightedParallelForEach(gaps, concurrency, maxInFlightBytes, ({ plan, index }) => plan.manifest.chunks[index]?.bytes ?? 0, async ({ plan, index, priorStored, stored, failed }) => {
-        try {
-            const expected = plan.manifest.chunks[index];
-            if (expected === undefined)
-                throw new Error('download manifest named an unknown chunk index');
-            const bytes = await ports.getChunk(plan.artifact, plan.manifest, index);
-            if (!(bytes instanceof Uint8Array)
-                || bytes.byteLength !== expected.bytes
-                || ports.sha256Hex(bytes) !== expected.sha256) {
-                throw new Error(`downloaded content chunk ${index} failed verification`);
-            }
-            if (priorStored !== undefined)
-                await priorStored;
-            await ports.putChunk(plan.artifact, plan.manifest, index, bytes);
-            stored();
-        }
-        catch (error) {
-            failed(error);
-            throw error;
+            const priorStored = prior;
+            chain.push({
+                object: { kind: 'block', sha256: expected.sha256 },
+                standaloneWeight: expected.bytes,
+                deliver: async (sealed) => {
+                    try {
+                        const plain = await ports.openEnvelope({ kind: 'block', sha256: expected.sha256 }, sealed);
+                        if (!(plain instanceof Uint8Array)
+                            || plain.byteLength !== expected.bytes
+                            || ports.sha256Hex(plain) !== expected.sha256) {
+                            throw new Error(`downloaded content chunk ${index} failed verification`);
+                        }
+                        if (priorStored !== undefined)
+                            await priorStored;
+                        await ports.putChunk(artifact, manifest, index, plain);
+                        stored();
+                    }
+                    catch (error) {
+                        failed(error);
+                        throw error;
+                    }
+                },
+                fail: failed,
+            });
+            prior = delivered;
         }
+        blockChains.push(chain);
     });
+    const blockWave = await fetchWave(ports, blockChains, concurrency, maxInFlightBytes);
     const receipts = new Array(artifacts.length);
-    await parallelForEach([...plans.keys()], concurrency, async (slot) => {
-        const plan = plans[slot];
-        if (plan === undefined)
-            return;
-        const sealed = await ports.sealArtifact(plan.artifact, plan.manifest);
-        if (sealed.bytes !== plan.manifest.bytes || sealed.contentHash !== plan.manifest.contentHash) {
-            throw new Error(`downloaded artifact ${plan.artifact.contentHash} failed verification`);
+    await parallelForEach([...artifacts.keys()], concurrency, async (slot) => {
+        const artifact = artifacts[slot];
+        const manifest = manifests[slot];
+        const missing = gaps[slot];
+        if (artifact === undefined || manifest === undefined || missing === undefined) {
+            throw new Error('download set lost a manifest');
+        }
+        const sealed = await ports.sealArtifact(artifact, manifest);
+        if (sealed.bytes !== manifest.bytes || sealed.contentHash !== manifest.contentHash) {
+            throw new Error(`downloaded artifact ${artifact.contentHash} failed verification`);
         }
         receipts[slot] = {
-            artifact: plan.artifact,
-            manifest: plan.manifest,
+            artifact,
+            manifest,
             local: sealed.local,
-            downloadedChunks: plan.missing.length,
-            reusedChunks: plan.manifest.chunks.length - plan.missing.length,
+            downloadedChunks: missing.length,
+            reusedChunks: manifest.chunks.length - missing.length,
         };
     });
-    return receipts.map((receipt) => {
-        if (receipt === undefined)
-            throw new Error('download set lost an artifact receipt');
-        return receipt;
-    });
-}
-/** Download one immutable artifact — a set of one. */
-export async function download(artifact, ports, options = {}) {
-    const [receipt] = await downloadAll([artifact], ports, options);
-    if (receipt === undefined)
-        throw new Error('download set lost an artifact receipt');
-    return receipt;
+    return {
+        receipts: receipts.map((receipt) => {
+            if (receipt === undefined)
+                throw new Error('download set lost an artifact receipt');
+            return receipt;
+        }),
+        shape: {
+            localManifests,
+            fetchedManifests: manifestChains.length,
+            packedManifests: manifestWave.packedObjects,
+            standaloneManifests: manifestWave.standaloneObjects,
+            manifestSpans: manifestWave.rangedReads,
+            packedBlocks: blockWave.packedObjects,
+            standaloneBlocks: blockWave.standaloneObjects,
+            blockSpans: blockWave.rangedReads,
+        },
+    };
 }
 //# sourceMappingURL=download.js.map

package/dist/transfer/download.js.map

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

package/dist/transfer/ranges.d.ts

@@ -1,47 +1,32 @@
 /**
- * Ranged pack reading.
+ * Pack span planning.
  *
- * Sealed envelopes of many small objects live inside one immutable pack.
- * Requests for ranges of the same pack URL made in the same event-loop turn
- * merge into minimal byte spans — one ranged GET per span — and every
- * requester receives exactly its envelope slice. A small hole between wanted
- * ranges is cheaper to read through than to split a request over, so spans
- * merge across gaps up to RANGE_MERGE_GAP_BYTES. Wrong or shifted bytes can
- * never leak: every dispensed slice is still an authenticated envelope the
- * caller opens and hash-verifies.
+ * Sealed envelopes of many small objects live inside one immutable pack. A
+ * download wave knows every member it needs before any byte moves, so the
+ * members of one pack are planned into a few broad byte spans — one ranged
+ * GET per span — instead of a request per member. A small hole between
+ * wanted ranges is cheaper to read through than to split a request over, so
+ * spans merge across gaps up to RANGE_MERGE_GAP_BYTES; a span never grows
+ * past the caller's byte cap, so one planned read always fits the wave's
+ * in-flight memory bound. Wrong or shifted bytes can never leak: every
+ * dispensed slice is still an authenticated envelope the reader opens and
+ * hash-verifies.
  */
-import type { ContentRef } from './refs.js';
 /** Read through holes up to this size rather than splitting a range request. */
 export declare const RANGE_MERGE_GAP_BYTES: number;
-/** Merged span bytes one fetcher may hold in flight at once. Admission of
- * spans — not just of the objects above them — is byte-bounded, so a wide
- * same-turn fan-out can never hold every pack's sealed bytes at once. */
-export declare const SPAN_FETCH_MAX_IN_FLIGHT_BYTES: number;
 export interface ByteSpan {
     readonly offset: number;
     readonly length: number;
 }
-export interface SpanPlan {
+export interface PackSpanPlan {
     /** Minimal disjoint fetch spans, ascending by offset. */
-    readonly spans: ByteSpan[];
-    /** Aligned with the input: which span serves each request, and where the
-     * request's bytes start inside that span. */
-    readonly slices: Array<{
-        readonly span: number;
-        readonly start: number;
-    }>;
+    readonly spans: readonly ByteSpan[];
+    /** Aligned with the input: which span holds each member. */
+    readonly memberSpan: readonly number[];
 }
-/** Merge wanted ranges into minimal fetch spans. Pure planning — no IO. */
-export declare function planSpans(requests: readonly ByteSpan[], mergeGap: number): SpanPlan;
-export interface SpanFetcherPorts {
-    /** Return exactly the requested bytes: the whole object when span is null,
-     * otherwise precisely span.length bytes starting at span.offset. */
-    fetchSpan(url: string, span: ByteSpan | null): Promise<Uint8Array>;
-}
-export interface SpanFetcher {
-    /** The sealed envelope bytes a ref names — a whole standalone object, or
-     * one exact slice of a pack. */
-    fetch(ref: ContentRef): Promise<Uint8Array>;
-}
-export declare function createSpanFetcher(ports: SpanFetcherPorts): SpanFetcher;
+/** Plan one pack's wanted member ranges into broad fetch spans. Pure
+ * planning — no IO. Members merge across holes up to `mergeGap`; a span
+ * stops growing at `maxSpanBytes`, except that a single member larger than
+ * the cap still gets exactly one span of its own. */
+export declare function planPackSpans(members: readonly ByteSpan[], mergeGap: number, maxSpanBytes: number): PackSpanPlan;
 //# sourceMappingURL=ranges.d.ts.map

package/dist/transfer/ranges.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ranges.d.ts","sourceRoot":"","sources":["../../src/transfer/ranges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAE5C,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAE/C;;yEAEyE;AACzE,eAAO,MAAM,8BAA8B,QAAmB,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,QAAQ;IACvB,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC;IAC3B;iDAC6C;IAC7C,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3E;AAQD,2EAA2E;AAC3E,wBAAgB,SAAS,CAAC,QAAQ,EAAE,SAAS,QAAQ,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAwBnF;AAED,MAAM,WAAW,gBAAgB;IAC/B;wEACoE;IACpE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CACpE;AAED,MAAM,WAAW,WAAW;IAC1B;oCACgC;IAChC,KAAK,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC7C;AAQD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAyFtE"}
+{"version":3,"file":"ranges.d.ts","sourceRoot":"","sources":["../../src/transfer/ranges.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,gFAAgF;AAChF,eAAO,MAAM,qBAAqB,QAAY,CAAC;AAE/C,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,yDAAyD;IACzD,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;CACxC;AAQD;;;qDAGqD;AACrD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,SAAS,QAAQ,EAAE,EAC5B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,YAAY,CA6Bd"}