@amalgm/live 0.2.26 → 0.2.28

package/dist-cjs/registration/user-ground.js

@@ -0,0 +1,183 @@
+"use strict";
+/**
+ * Login-time user-ground convergence.
+ *
+ * Core owns when this operation runs. Live owns what it means: either create
+ * one initial cloud graph or install the active graph, prove the local
+ * materialization carries the same portable records, then start Watch. Every
+ * filesystem, SQLite, content, and R2 effect is injected by the host.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.userGroundRecords = userGroundRecords;
+exports.convergeUserGround = convergeUserGround;
+const index_js_1 = require("../entities/index.js");
+const HASH = /^[0-9a-f]{64}$/;
+function required(value, name) {
+    const text = typeof value === 'string' ? value.trim() : '';
+    if (!text)
+        throw new Error(`user-ground ${name} is required`);
+    return text;
+}
+function normalizeIdentity(input) {
+    return {
+        userId: required(input?.userId, 'user id'),
+        userEmail: required(input?.userEmail, 'user email').toLowerCase(),
+        deviceId: required(input?.deviceId, 'device id'),
+    };
+}
+function assertCloud(value, resourceId, sha256Hex) {
+    const cloud = value;
+    if (!cloud || cloud.resourceId !== resourceId
+        || !Number.isSafeInteger(cloud.version) || Number(cloud.version) < 0
+        || typeof cloud.checksum !== 'string' || !HASH.test(cloud.checksum)) {
+        throw new Error('cloud user-ground head is invalid');
+    }
+    const snapshot = (0, index_js_1.snapshotFromRecords)(cloud.snapshot?.records || []);
+    if (snapshot.records.length === 0)
+        throw new Error('cloud user-ground graph is empty');
+    const checksum = sha256Hex((0, index_js_1.stableJson)(snapshot));
+    if (checksum !== cloud.checksum)
+        throw new Error('cloud user-ground snapshot checksum mismatch');
+    return {
+        resourceId,
+        version: Number(cloud.version),
+        checksum,
+        snapshot,
+    };
+}
+function controlPath(path) {
+    return path.replace(/\\/g, '/').split('/').includes('.amalgm');
+}
+function assertLocal(value, identity) {
+    const local = value;
+    if (!local
+        || local.userId !== identity.userId
+        || String(local.userEmail || '').toLowerCase() !== identity.userEmail
+        || local.deviceId !== identity.deviceId) {
+        throw new Error('local user-ground identity does not match login');
+    }
+    const localRoot = required(local.localRoot, 'local root');
+    const sqlitePath = required(local.sqlitePath, 'SQLite path');
+    if (!controlPath(sqlitePath)) {
+        throw new Error('local user-ground SQLite must live inside the reserved .amalgm control directory');
+    }
+    const snapshot = (0, index_js_1.snapshotFromRecords)(local.records || []);
+    if (snapshot.records.length === 0)
+        throw new Error('local user-ground graph is empty');
+    return {
+        ...identity,
+        localRoot,
+        sqlitePath,
+        records: snapshot.records,
+        ...(local.recordsBeyondSnapshot === true ? { recordsBeyondSnapshot: true } : {}),
+    };
+}
+/** Select the authenticated user's core root without materializing sibling
+ * workspace roots. The canonical email is the declared root name. */
+function userGroundRecords(records, userEmail) {
+    const snapshot = (0, index_js_1.snapshotFromRecords)(records);
+    const canonicalEmail = required(userEmail, 'user email').toLowerCase();
+    const roots = snapshot.records.filter((record) => record.status === 'active'
+        && record.parentUUID === null
+        && record.type === 'workspace'
+        && record.name.toLowerCase() === canonicalEmail);
+    if (roots.length !== 1) {
+        throw new Error('cloud registry must contain exactly one authenticated user-ground root');
+    }
+    const included = new Set([roots[0].uuid]);
+    let changed = true;
+    while (changed) {
+        changed = false;
+        for (const record of snapshot.records) {
+            if (record.parentUUID !== null && included.has(record.parentUUID) && !included.has(record.uuid)) {
+                included.add(record.uuid);
+                changed = true;
+            }
+        }
+    }
+    return snapshot.records.filter((record) => included.has(record.uuid));
+}
+function assertSameGraph(local, cloud) {
+    if (!(0, index_js_1.sameRecords)((0, index_js_1.travelingRecords)(userGroundRecords(local.records, local.userEmail)), userGroundRecords(cloud.snapshot.records, local.userEmail))) {
+        throw new Error('local user-ground graph does not match the active cloud core graph');
+    }
+}
+function assertWatch(value) {
+    const watch = value;
+    if (!watch || watch.active !== true || !Number.isSafeInteger(watch.roots) || Number(watch.roots) < 1) {
+        throw new Error('user-ground watcher coverage is not active');
+    }
+    return { active: true, roots: Number(watch.roots) };
+}
+/**
+ * Converge one login. No caller selects "new" versus "existing": the active
+ * cloud head decides. Initial publication is conditional, so two first
+ * machines cannot create two authorities.
+ */
+async function convergeUserGround(input, ports) {
+    const identity = normalizeIdentity(input);
+    const resourceId = (0, index_js_1.privateEntityResourceId)(identity.userId, ports.sha256Hex);
+    const found = await ports.cloud.lookup(resourceId);
+    let cloud;
+    let local;
+    let mode;
+    if (found === null || found === undefined) {
+        const initialized = assertLocal(await ports.local.initialize(identity), identity);
+        const snapshot = (0, index_js_1.snapshotFromRecords)((0, index_js_1.travelingRecords)(initialized.records));
+        const checksum = ports.sha256Hex((0, index_js_1.stableJson)(snapshot));
+        const published = await ports.cloud.publishInitial({ resourceId, checksum, snapshot });
+        cloud = assertCloud(published.current, resourceId, ports.sha256Hex);
+        if (published.created) {
+            assertSameGraph(initialized, cloud);
+            local = initialized;
+            mode = 'initialized';
+        }
+        else {
+            local = assertLocal(await ports.local.install(identity, cloud), identity);
+            assertSameGraph(local, cloud);
+            mode = 'materialized';
+        }
+    }
+    else {
+        cloud = assertCloud(found, resourceId, ports.sha256Hex);
+        const currentValue = await ports.local.inspect(identity);
+        if (currentValue !== null && currentValue !== undefined) {
+            const current = assertLocal(currentValue, identity);
+            if ((0, index_js_1.sameRecords)((0, index_js_1.travelingRecords)(userGroundRecords(current.records, identity.userEmail)), userGroundRecords(cloud.snapshot.records, identity.userEmail))) {
+                local = current;
+                mode = current.recordsBeyondSnapshot === true ? 'syncing' : 'current';
+            }
+            else if (current.recordsBeyondSnapshot === true) {
+                local = current;
+                mode = 'syncing';
+            }
+            else {
+                local = assertLocal(await ports.local.install(identity, cloud), identity);
+                assertSameGraph(local, cloud);
+                mode = 'materialized';
+            }
+        }
+        else {
+            local = assertLocal(await ports.local.install(identity, cloud), identity);
+            assertSameGraph(local, cloud);
+            mode = 'materialized';
+        }
+    }
+    const watch = assertWatch(await ports.local.watch(identity, cloud));
+    const finalLocal = assertLocal(await ports.local.inspect(identity), identity);
+    if (finalLocal.recordsBeyondSnapshot !== true)
+        assertSameGraph(finalLocal, cloud);
+    return {
+        ...identity,
+        localRoot: finalLocal.localRoot,
+        sqlitePath: finalLocal.sqlitePath,
+        cloudResourceId: cloud.resourceId,
+        cloudVersion: cloud.version,
+        cloudHead: cloud.checksum,
+        mode,
+        entityCount: userGroundRecords(cloud.snapshot.records, identity.userEmail).length,
+        watcherRoots: watch.roots,
+        watching: true,
+    };
+}
+//# sourceMappingURL=user-ground.js.map

package/dist-cjs/registration/user-ground.js.map

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

package/dist-cjs/transfer/artifacts.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * The immutable content artifact selected by an entity record.
+ *
+ * Registration owns identity and the graph. Transfer sees only the exact
+ * content head registration already produced. Containers and references have
+ * no independent byte artifact: their portable state is already in the graph.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.artifactKindForType = artifactKindForType;
+exports.assertTransferArtifact = assertTransferArtifact;
+exports.artifactForRecord = artifactForRecord;
+const CONTENT_HEAD = /^[0-9a-f]{64}$/;
+/** Registration's type is the only transfer selector. */
+function artifactKindForType(type) {
+    switch (type) {
+        case 'file.text':
+        case 'file.binary':
+            return 'file';
+        case 'link':
+            return 'link';
+        case 'repo.git':
+            return 'git';
+        case 'workspace':
+        case 'folder':
+        case 'reference':
+            return null;
+    }
+}
+function assertTransferArtifact(artifact) {
+    const expected = artifactKindForType(artifact.entityType);
+    if (expected === null || artifact.kind !== expected) {
+        throw new Error(`entity type ${artifact.entityType} cannot use ${artifact.kind} transfer`);
+    }
+}
+/**
+ * Select the one immutable artifact carried by a cloud entity record.
+ * Deleted records are tombstones. A not-yet-captured leaf has no artifact yet.
+ */
+function artifactForRecord(record) {
+    if (record.status === 'deleted')
+        return null;
+    const kind = artifactKindForType(record.type);
+    if (kind === null)
+        return null;
+    let contentHash;
+    switch (record.type) {
+        case 'file.text':
+        case 'file.binary':
+            contentHash = record.payloadVersion;
+            break;
+        case 'link':
+            contentHash = record.payloadVersion;
+            break;
+        case 'repo.git':
+            contentHash = record.transportVersion;
+            break;
+        case 'workspace':
+        case 'folder':
+        case 'reference':
+            return null;
+    }
+    if (contentHash === null)
+        return null;
+    if (!CONTENT_HEAD.test(contentHash)) {
+        throw new Error(`entity ${record.uuid} has an invalid transfer head`);
+    }
+    return {
+        entityId: record.uuid,
+        entityType: record.type,
+        kind,
+        contentHash,
+    };
+}
+//# sourceMappingURL=artifacts.js.map

package/dist-cjs/transfer/artifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifacts.js","sourceRoot":"","sources":["../../src/transfer/artifacts.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAiBH,kDAcC;AAED,wDAKC;AAMD,8CAiCC;AAxED,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAWtC,yDAAyD;AACzD,SAAgB,mBAAmB,CAAC,IAAgB;IAClD,QAAQ,IAAI,EAAE,CAAC;QACb,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa;YAChB,OAAO,MAAM,CAAC;QAChB,KAAK,MAAM;YACT,OAAO,MAAM,CAAC;QAChB,KAAK,UAAU;YACb,OAAO,KAAK,CAAC;QACf,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW;YACd,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,SAAgB,sBAAsB,CAAC,QAA0B;IAC/D,MAAM,QAAQ,GAAG,mBAAmB,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;IAC1D,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,MAAM,IAAI,KAAK,CAAC,eAAe,QAAQ,CAAC,UAAU,eAAe,QAAQ,CAAC,IAAI,WAAW,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,MAAyB;IACzD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IAE7C,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC/B,IAAI,WAA0B,CAAC;IAC/B,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,WAAW,CAAC;QACjB,KAAK,aAAa;YAChB,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC;YACpC,MAAM;QACR,KAAK,MAAM;YACT,WAAW,GAAG,MAAM,CAAC,cAAc,CAAC;YACpC,MAAM;QACR,KAAK,UAAU;YACb,WAAW,GAAG,MAAM,CAAC,gBAAgB,CAAC;YACtC,MAAM;QACR,KAAK,WAAW,CAAC;QACjB,KAAK,QAAQ,CAAC;QACd,KAAK,WAAW;YACd,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,IAAI,WAAW,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,UAAU,MAAM,CAAC,IAAI,+BAA+B,CAAC,CAAC;IACxE,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,IAAI;QACrB,UAAU,EAAE,MAAM,CAAC,IAAI;QACvB,IAAI;QACJ,WAAW;KACZ,CAAC;AACJ,CAAC"}

package/dist-cjs/transfer/batches.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Cold file transport batches.
+ *
+ * Content blocks are durable identities. They are not network requests.
+ * Adjacent missing blocks may cross the wire together while remaining
+ * independently addressed and verified at both ends.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILE_TRANSFER_BATCH_BYTES = void 0;
+exports.planChunkBatches = planChunkBatches;
+/** One batch may fill the existing binary frame bound. Hosts lower transfer
+ * concurrency when their memory budget cannot admit eight full batches. */
+exports.FILE_TRANSFER_BATCH_BYTES = 16 * 1024 * 1024;
+/** Group ascending, adjacent chunk indexes without crossing the byte bound. */
+function planChunkBatches(indexes, manifest) {
+    const offsets = [];
+    let offset = 0;
+    for (const chunk of manifest.chunks) {
+        offsets.push(offset);
+        offset += chunk.bytes;
+    }
+    const batches = [];
+    for (const index of [...indexes].sort((left, right) => left - right)) {
+        const chunk = manifest.chunks[index];
+        const chunkOffset = offsets[index];
+        if (!chunk || chunkOffset === undefined)
+            throw new Error(`content manifest has no chunk ${index}`);
+        const prior = batches.at(-1);
+        const adjacent = prior?.indexes.at(-1) === index - 1;
+        if (prior && adjacent && prior.bytes + chunk.bytes <= exports.FILE_TRANSFER_BATCH_BYTES) {
+            batches[batches.length - 1] = {
+                indexes: [...prior.indexes, index],
+                offset: prior.offset,
+                bytes: prior.bytes + chunk.bytes,
+            };
+        }
+        else {
+            batches.push({ indexes: [index], offset: chunkOffset, bytes: chunk.bytes });
+        }
+    }
+    return batches;
+}
+//# sourceMappingURL=batches.js.map

package/dist-cjs/transfer/batches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batches.js","sourceRoot":"","sources":["../../src/transfer/batches.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;AAeH,4CA6BC;AAxCD;2EAC2E;AAC9D,QAAA,yBAAyB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAQ1D,+EAA+E;AAC/E,SAAgB,gBAAgB,CAC9B,OAA0B,EAC1B,QAAyB;IAEzB,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC;IACxB,CAAC;IAED,MAAM,OAAO,GAAiB,EAAE,CAAC;IACjC,KAAK,MAAM,KAAK,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACrE,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,KAAK,IAAI,WAAW,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,iCAAiC,KAAK,EAAE,CAAC,CAAC;QACnG,MAAM,KAAK,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,QAAQ,GAAG,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,GAAG,CAAC,CAAC;QACrD,IAAI,KAAK,IAAI,QAAQ,IAAI,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,iCAAyB,EAAE,CAAC;YAChF,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,GAAG;gBAC5B,OAAO,EAAE,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC;gBAClC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK;aACjC,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist-cjs/transfer/download.js

@@ -0,0 +1,88 @@
+"use strict";
+/**
+ * Download one immutable artifact into a machine cache.
+ *
+ * The operation asks the cache which verified chunks it already owns, fetches
+ * only the gaps, verifies every fetched chunk, and then asks the cache to seal
+ * the complete artifact. Sealing must verify the whole byte count and content
+ * hash before returning a local handle.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.download = download;
+const content_js_1 = require("../contracts/content.js");
+const artifacts_js_1 = require("./artifacts.js");
+const batches_js_1 = require("./batches.js");
+const parallel_js_1 = require("./parallel.js");
+const checkedBatchChunks = (bytes, indexes, manifest, sha256Hex) => {
+    const chunks = [];
+    let offset = 0;
+    for (const index of indexes) {
+        const expected = manifest.chunks[index];
+        if (!expected)
+            throw new Error(`download manifest named an unknown chunk index`);
+        const chunk = bytes.subarray(offset, offset + expected.bytes);
+        if (chunk.byteLength !== expected.bytes || sha256Hex(chunk) !== expected.sha256) {
+            throw new Error(`downloaded content chunk ${index} failed verification`);
+        }
+        chunks.push(chunk);
+        offset += expected.bytes;
+    }
+    if (offset !== bytes.byteLength)
+        throw new Error('downloaded file batch has the wrong byte count');
+    return chunks;
+};
+/** Download one immutable artifact, fetching only machine-cache gaps. */
+async function download(artifact, ports, options = {}) {
+    (0, artifacts_js_1.assertTransferArtifact)(artifact);
+    const checked = (0, content_js_1.checkContentManifest)(await ports.getManifest(artifact), artifact.contentHash);
+    if (!checked.ok)
+        throw new Error(checked.error);
+    const manifest = checked.value;
+    const missing = [];
+    for (const [index, chunk] of manifest.chunks.entries()) {
+        if (!await ports.hasChunk(artifact, manifest, index))
+            missing.push(index);
+    }
+    if (artifact.kind === 'file' && ports.getChunkBatch) {
+        await (0, parallel_js_1.parallelForEach)((0, batches_js_1.planChunkBatches)(missing, manifest), options.concurrency ?? parallel_js_1.DEFAULT_TRANSFER_CONCURRENCY, async (batch) => {
+            const bytes = await ports.getChunkBatch(artifact, manifest, batch.indexes);
+            if (!(bytes instanceof Uint8Array))
+                throw new Error('downloaded file batch is not binary bytes');
+            const chunks = checkedBatchChunks(bytes, batch.indexes, manifest, ports.sha256Hex);
+            if (ports.putChunkBatch) {
+                await ports.putChunkBatch(artifact, manifest, batch.indexes, bytes);
+            }
+            else {
+                for (let offset = 0; offset < batch.indexes.length; offset += 1) {
+                    await ports.putChunk(artifact, manifest, batch.indexes[offset], chunks[offset]);
+                }
+            }
+        });
+    }
+    else {
+        await (0, parallel_js_1.parallelForEach)(missing, options.concurrency ?? parallel_js_1.DEFAULT_TRANSFER_CONCURRENCY, async (index) => {
+            const expected = manifest.chunks[index];
+            if (expected === undefined)
+                throw new Error('download manifest named an unknown chunk index');
+            const bytes = await ports.getChunk(artifact, manifest, index);
+            if (!(bytes instanceof Uint8Array)
+                || bytes.byteLength !== expected.bytes
+                || ports.sha256Hex(bytes) !== expected.sha256) {
+                throw new Error(`downloaded content chunk ${index} failed verification`);
+            }
+            await ports.putChunk(artifact, manifest, index, bytes);
+        });
+    }
+    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`);
+    }
+    return {
+        artifact,
+        manifest,
+        local: sealed.local,
+        downloadedChunks: missing.length,
+        reusedChunks: manifest.chunks.length - missing.length,
+    };
+}
+//# sourceMappingURL=download.js.map

package/dist-cjs/transfer/download.js.map

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

package/dist-cjs/transfer/index.js

@@ -0,0 +1,21 @@
+"use strict";
+/** Type-aware immutable content transfer operations. */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./artifacts.js"), exports);
+__exportStar(require("./upload.js"), exports);
+__exportStar(require("./download.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/transfer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/transfer/index.ts"],"names":[],"mappings":";AAAA,wDAAwD;;;;;;;;;;;;;;;;AAExD,iDAA+B;AAC/B,8CAA4B;AAC5B,gDAA8B"}

package/dist-cjs/transfer/parallel.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TRANSFER_CONCURRENCY = void 0;
+exports.parallelForEach = parallelForEach;
+/** Eight full-size frames keep one ordinary high-latency connection busy
+ * without making the SDK's default memory bound unreasonably large. Hosts
+ * with a stricter budget can always pass a smaller explicit window. */
+exports.DEFAULT_TRANSFER_CONCURRENCY = 8;
+/** Run a bounded number of independent effects without changing item order. */
+async function parallelForEach(items, concurrency, effect) {
+    if (!Number.isSafeInteger(concurrency) || concurrency < 1) {
+        throw new Error('transfer concurrency must be a positive integer');
+    }
+    let cursor = 0;
+    let failure;
+    const worker = async () => {
+        while (failure === undefined && cursor < items.length) {
+            const index = cursor;
+            cursor += 1;
+            const item = items[index];
+            if (item === undefined)
+                continue;
+            try {
+                await effect(item);
+            }
+            catch (error) {
+                failure ??= error;
+            }
+        }
+    };
+    await Promise.all(Array.from({ length: Math.min(concurrency, items.length) }, worker));
+    if (failure !== undefined)
+        throw failure;
+}
+//# sourceMappingURL=parallel.js.map

package/dist-cjs/transfer/parallel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parallel.js","sourceRoot":"","sources":["../../src/transfer/parallel.ts"],"names":[],"mappings":";;;AAMA,0CA2BC;AAjCD;;uEAEuE;AAC1D,QAAA,4BAA4B,GAAG,CAAC,CAAC;AAE9C,+EAA+E;AACxE,KAAK,UAAU,eAAe,CACnC,KAAmB,EACnB,WAAmB,EACnB,MAAkC;IAElC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,WAAW,CAAC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;QAC1D,MAAM,IAAI,KAAK,CAAC,iDAAiD,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,OAAgB,CAAC;IACrB,MAAM,MAAM,GAAG,KAAK,IAAmB,EAAE;QACvC,OAAO,OAAO,KAAK,SAAS,IAAI,MAAM,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,MAAM,CAAC;YACrB,MAAM,IAAI,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC1B,IAAI,IAAI,KAAK,SAAS;gBAAE,SAAS;YACjC,IAAI,CAAC;gBACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,KAAK,KAAK,CAAC;YACpB,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,CAAC,GAAG,CACf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,CACpE,CAAC;IACF,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC;AAC3C,CAAC"}

package/dist-cjs/transfer/upload.js

@@ -0,0 +1,161 @@
+"use strict";
+/**
+ * Upload one already-captured immutable artifact.
+ *
+ * The source is seekable so the operation can first derive its manifest and
+ * then reread only the chunks the authority reports missing. The manifest is
+ * committed last; until then a partial upload is invisible.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveUploadManifest = deriveUploadManifest;
+exports.upload = upload;
+const content_js_1 = require("../contracts/content.js");
+const artifacts_js_1 = require("./artifacts.js");
+const batches_js_1 = require("./batches.js");
+const parallel_js_1 = require("./parallel.js");
+const planChunks = (sizes) => {
+    let offset = 0;
+    return sizes.map((size, index) => {
+        const chunk = { index, offset, bytes: size };
+        offset += size;
+        return chunk;
+    });
+};
+const fixedSizes = (totalBytes, partBytes) => {
+    const sizes = [];
+    for (let remaining = totalBytes; remaining > 0; remaining -= partBytes) {
+        sizes.push(Math.min(remaining, partBytes));
+    }
+    return sizes;
+};
+/** Entity type selects semantic transfer framing. Files use reusable
+ * Syncthing-style blocks. A link target is one literal value. A Git transport
+ * is already a native incremental pack/state parcel, so the outer wire only
+ * segments it at the maximum frame size instead of re-chunking it as a file. */
+const artifactPartSizes = (artifact, totalBytes) => {
+    switch (artifact.kind) {
+        case 'file':
+            return (0, content_js_1.chunkSizes)(totalBytes);
+        case 'link':
+            if (totalBytes > content_js_1.MAX_CONTENT_BLOCK_BYTES)
+                throw new Error('link target exceeds the transfer frame bound');
+            return totalBytes === 0 ? [] : [totalBytes];
+        case 'git':
+            return fixedSizes(totalBytes, content_js_1.MAX_CONTENT_BLOCK_BYTES);
+    }
+};
+/** Derive the reusable upload evidence while capture already owns the bytes.
+ * A host persists this beside its immutable artifact so upload never has to
+ * rediscover block boundaries or reread the complete source just to prove the
+ * work registration already completed. */
+function deriveUploadManifest(artifact, bytes, sha256Hex) {
+    (0, artifacts_js_1.assertTransferArtifact)(artifact);
+    if (sha256Hex(bytes) !== artifact.contentHash) {
+        throw new Error(`captured artifact does not match ${artifact.contentHash}`);
+    }
+    const chunks = [];
+    let offset = 0;
+    for (const size of artifactPartSizes(artifact, bytes.byteLength)) {
+        const part = bytes.subarray(offset, offset + size);
+        chunks.push({ sha256: sha256Hex(part), bytes: size });
+        offset += size;
+    }
+    const checked = (0, content_js_1.manifestFromChunks)(artifact.contentHash, chunks);
+    if (!checked.ok)
+        throw new Error(checked.error);
+    return checked.value;
+}
+const readExact = async (source, chunk) => {
+    const bytes = await source.read(chunk.offset, chunk.bytes);
+    if (!(bytes instanceof Uint8Array) || bytes.byteLength !== chunk.bytes) {
+        throw new Error(`upload source returned the wrong byte count for chunk ${chunk.index}`);
+    }
+    return bytes;
+};
+const assertBatchChunks = (bytes, indexes, manifest, sha256Hex) => {
+    let offset = 0;
+    for (const index of indexes) {
+        const expected = manifest.chunks[index];
+        if (!expected)
+            throw new Error(`content manifest has no chunk ${index}`);
+        const chunk = bytes.subarray(offset, offset + expected.bytes);
+        if (chunk.byteLength !== expected.bytes || sha256Hex(chunk) !== expected.sha256) {
+            throw new Error(`upload source changed while reading chunk ${index}`);
+        }
+        offset += expected.bytes;
+    }
+    if (offset !== bytes.byteLength)
+        throw new Error('upload source returned the wrong byte count for a file batch');
+};
+/** Upload one immutable artifact, sending only authority-declared gaps. */
+async function upload(artifact, source, ports, options = {}) {
+    (0, artifacts_js_1.assertTransferArtifact)(artifact);
+    if (!Number.isSafeInteger(source.bytes) || source.bytes < 0) {
+        throw new Error('upload source byte count is invalid');
+    }
+    if (source.manifestVerified === true && source.manifest === undefined) {
+        throw new Error('verified upload manifest is missing');
+    }
+    const expectedSizes = artifactPartSizes(artifact, source.bytes);
+    let plan;
+    let manifest;
+    if (source.manifest !== undefined) {
+        const cached = (0, content_js_1.checkContentManifest)(source.manifest, artifact.contentHash);
+        if (!cached.ok || cached.value.bytes !== source.bytes
+            || cached.value.chunks.some((chunk, index) => chunk.bytes !== expectedSizes[index])
+            || cached.value.chunks.length !== expectedSizes.length) {
+            throw new Error('cached upload manifest is invalid');
+        }
+        manifest = cached.value;
+        plan = planChunks(manifest.chunks.map((chunk) => chunk.bytes));
+    }
+    else {
+        plan = planChunks(expectedSizes);
+        const chunks = [];
+        for (const chunk of plan) {
+            const bytes = await readExact(source, chunk);
+            chunks.push({ sha256: ports.sha256Hex(bytes), bytes: chunk.bytes });
+        }
+        const checked = (0, content_js_1.manifestFromChunks)(artifact.contentHash, chunks);
+        if (!checked.ok)
+            throw new Error(checked.error);
+        manifest = checked.value;
+    }
+    const missing = [...await ports.missingChunks(artifact, manifest)];
+    if (new Set(missing).size !== missing.length
+        || missing.some((index) => !Number.isSafeInteger(index) || index < 0 || index >= plan.length)) {
+        throw new Error('upload authority returned invalid missing chunk indexes');
+    }
+    if (missing.length > 0 && source.manifestVerified !== true) {
+        if (!source.verify || !await source.verify(artifact.contentHash)) {
+            throw new Error(`upload source does not match ${artifact.contentHash}`);
+        }
+    }
+    if (artifact.kind === 'file' && ports.putChunkBatch) {
+        await (0, parallel_js_1.parallelForEach)((0, batches_js_1.planChunkBatches)(missing, manifest), options.concurrency ?? parallel_js_1.DEFAULT_TRANSFER_CONCURRENCY, async (batch) => {
+            const bytes = await readExact(source, { index: batch.indexes[0], offset: batch.offset, bytes: batch.bytes });
+            assertBatchChunks(bytes, batch.indexes, manifest, ports.sha256Hex);
+            await ports.putChunkBatch(artifact, manifest, batch.indexes, bytes);
+        });
+    }
+    else {
+        await (0, parallel_js_1.parallelForEach)(missing, options.concurrency ?? parallel_js_1.DEFAULT_TRANSFER_CONCURRENCY, async (index) => {
+            const chunk = plan[index];
+            if (chunk === undefined)
+                throw new Error('upload authority returned an unknown chunk index');
+            const bytes = await readExact(source, chunk);
+            if (ports.sha256Hex(bytes) !== manifest.chunks[index]?.sha256) {
+                throw new Error(`upload source changed while reading chunk ${index}`);
+            }
+            await ports.putChunk(artifact, manifest, index, bytes);
+        });
+    }
+    await ports.putManifest(artifact, manifest);
+    return {
+        artifact,
+        manifest,
+        uploadedChunks: missing.length,
+        reusedChunks: manifest.chunks.length - missing.length,
+    };
+}
+//# sourceMappingURL=upload.js.map