@cuna_labs/cli 0.1.0

package/dist/sync/supervisor.d.ts

@@ -0,0 +1,107 @@
+export type SyncOperationKind = "create" | "update" | "delete" | "rename";
+export interface QueuedSyncOperation {
+    readonly operationId: string;
+    readonly path: string;
+    readonly kind: SyncOperationKind;
+    readonly byteLength: number;
+    readonly baseGeneration: number;
+    readonly acknowledged: boolean;
+}
+export interface QueueAdmission {
+    readonly admitted: boolean;
+    readonly coalescedOperationId?: string;
+    readonly dirty: boolean;
+    readonly reason?: "operation_limit" | "byte_limit";
+}
+export declare class BoundedOperationQueue {
+    #private;
+    constructor(maximumOperations?: number, maximumBytes?: number);
+    get size(): number;
+    get bytes(): number;
+    get dirty(): boolean;
+    get items(): readonly QueuedSyncOperation[];
+    enqueue(operation: QueuedSyncOperation): QueueAdmission;
+    shift(): QueuedSyncOperation | undefined;
+    markReconciled(): void;
+}
+export type SupervisorState = "recovering" | "reconciling" | "catching_up" | "live_unverified" | "converged" | "conflicted" | "paused" | "recovery_required" | "unknown";
+export interface SupervisorConfiguration {
+    readonly bindingId: string;
+    readonly bindingGeneration: number;
+    readonly canonicalRoot: string;
+    readonly policyDigest: string;
+    readonly epoch: string;
+}
+export interface ConvergenceReceipt {
+    readonly authority: "cuna_workspace_service";
+    readonly bindingId: string;
+    readonly bindingGeneration: number;
+    readonly epoch: string;
+    readonly policyDigest: string;
+    readonly localManifestRoot: string;
+    readonly canonicalManifestRoot: string;
+    readonly canonicalRevision: string;
+    readonly observedAt: string;
+    readonly expiresAt: string;
+}
+export interface SupervisorSnapshot {
+    readonly state: SupervisorState;
+    readonly dirty: boolean;
+    readonly incrementalApplyPaused: boolean;
+    readonly reason?: string;
+    readonly canonicalRevision?: string;
+    readonly evidenceExpiresAt?: string;
+}
+export declare class LocalSyncSupervisor {
+    #private;
+    readonly configuration: SupervisorConfiguration;
+    readonly operationQueue: BoundedOperationQueue;
+    readonly terminalQueue: BoundedOperationQueue;
+    constructor(configuration: SupervisorConfiguration, limits?: {
+        readonly syncOperations?: number;
+        readonly syncBytes?: number;
+        readonly terminalOperations?: number;
+        readonly terminalBytes?: number;
+        readonly clock?: () => number;
+    });
+    get snapshot(): SupervisorSnapshot;
+    subscribe(listener: (snapshot: SupervisorSnapshot) => void): () => void;
+    beginReconciliation(reason: string): void;
+    watcherOverflow(): void;
+    sequenceGap(): void;
+    budgetExhausted(reason: "disk" | "api_quota" | "network" | "queue"): void;
+    conflictObserved(): void;
+    markLiveUnverified(): void;
+    confirmConvergence(receipt: ConvergenceReceipt, now?: number): void;
+}
+export declare class SyncSupervisorRegistry {
+    #private;
+    connect(configuration: SupervisorConfiguration, clock?: () => number): {
+        readonly supervisor: LocalSyncSupervisor;
+        readonly created: boolean;
+    };
+    release(bindingId: string, supervisor: LocalSyncSupervisor): boolean;
+}
+export type ProgressStage = "enumerating" | "hashing" | "negotiating" | "uploading" | "verifying" | "committed";
+export interface ProgressReceipt {
+    readonly authority: "local_manifest" | "cuna_workspace_service";
+    readonly stage: ProgressStage;
+    readonly observedEntries: number;
+    readonly observedBytes: number;
+    readonly totalEntries?: number;
+    readonly totalBytes?: number;
+    readonly canonicalRevision?: string;
+    readonly observedAt: string;
+}
+export interface TruthfulProgress {
+    readonly stage: ProgressStage;
+    readonly observedEntries: number;
+    readonly observedBytes: number;
+    readonly totalEntries?: number;
+    readonly totalBytes?: number;
+    readonly percent?: number;
+    readonly ready: boolean;
+    readonly canonicalRevision?: string;
+}
+export declare function progressFromReceipt(receipt: ProgressReceipt): TruthfulProgress;
+//# sourceMappingURL=supervisor.d.ts.map

package/dist/sync/supervisor.d.ts.map

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

package/dist/sync/supervisor.js

@@ -0,0 +1,246 @@
+import { workspaceError } from "../workspace/errors.js";
+export class BoundedOperationQueue {
+    #maximumOperations;
+    #maximumBytes;
+    #items = [];
+    #bytes = 0;
+    #dirty = false;
+    constructor(maximumOperations = 10_000, maximumBytes = 256 * 1024 * 1024) {
+        if (!Number.isSafeInteger(maximumOperations) || maximumOperations < 1)
+            throw queueFailure("invalid_operation_limit");
+        if (!Number.isSafeInteger(maximumBytes) || maximumBytes < 1)
+            throw queueFailure("invalid_byte_limit");
+        this.#maximumOperations = maximumOperations;
+        this.#maximumBytes = maximumBytes;
+    }
+    get size() {
+        return this.#items.length;
+    }
+    get bytes() {
+        return this.#bytes;
+    }
+    get dirty() {
+        return this.#dirty;
+    }
+    get items() {
+        return Object.freeze([...this.#items]);
+    }
+    enqueue(operation) {
+        validateOperation(operation);
+        const candidate = this.#coalescingCandidate(operation);
+        const replacedBytes = candidate === undefined ? 0 : candidate.item.byteLength;
+        const nextSize = this.#items.length + (candidate === undefined ? 1 : 0);
+        const nextBytes = this.#bytes - replacedBytes + operation.byteLength;
+        if (nextSize > this.#maximumOperations || nextBytes > this.#maximumBytes) {
+            this.#dirty = true;
+            return Object.freeze({
+                admitted: false,
+                dirty: true,
+                reason: nextSize > this.#maximumOperations ? "operation_limit" : "byte_limit",
+            });
+        }
+        if (candidate === undefined)
+            this.#items.push(Object.freeze(operation));
+        else
+            this.#items[candidate.index] = Object.freeze(operation);
+        this.#bytes = nextBytes;
+        return Object.freeze({
+            admitted: true,
+            dirty: this.#dirty,
+            ...(candidate === undefined ? {} : { coalescedOperationId: candidate.item.operationId }),
+        });
+    }
+    shift() {
+        const item = this.#items.shift();
+        if (item !== undefined)
+            this.#bytes -= item.byteLength;
+        return item;
+    }
+    markReconciled() {
+        if (this.#items.length !== 0)
+            throw queueFailure("queue_not_drained");
+        this.#dirty = false;
+    }
+    #coalescingCandidate(operation) {
+        if (operation.kind !== "create" && operation.kind !== "update")
+            return undefined;
+        for (let index = this.#items.length - 1; index >= 0; index -= 1) {
+            const item = this.#items[index];
+            if (item === undefined)
+                continue;
+            if (item.path !== operation.path)
+                continue;
+            if (item.kind === "delete" || item.kind === "rename" || item.acknowledged)
+                return undefined;
+            if (item.baseGeneration !== operation.baseGeneration)
+                return undefined;
+            return { index, item };
+        }
+        return undefined;
+    }
+}
+export class LocalSyncSupervisor {
+    configuration;
+    operationQueue;
+    terminalQueue;
+    #listeners = new Set();
+    #clock;
+    #snapshot = Object.freeze({
+        state: "recovering",
+        dirty: false,
+        incrementalApplyPaused: true,
+    });
+    constructor(configuration, limits) {
+        this.configuration = Object.freeze({ ...configuration });
+        this.operationQueue = new BoundedOperationQueue(limits?.syncOperations, limits?.syncBytes);
+        this.terminalQueue = new BoundedOperationQueue(limits?.terminalOperations ?? 1_024, limits?.terminalBytes ?? 8 * 1024 * 1024);
+        this.#clock = limits?.clock ?? Date.now;
+    }
+    get snapshot() {
+        if (this.#snapshot.state === "converged" &&
+            this.#snapshot.evidenceExpiresAt !== undefined &&
+            Date.parse(this.#snapshot.evidenceExpiresAt) <= this.#clock()) {
+            return Object.freeze({
+                state: "unknown",
+                dirty: true,
+                incrementalApplyPaused: true,
+                reason: "convergence_evidence_expired",
+                evidenceExpiresAt: this.#snapshot.evidenceExpiresAt,
+            });
+        }
+        return this.#snapshot;
+    }
+    subscribe(listener) {
+        this.#listeners.add(listener);
+        listener(this.snapshot);
+        return () => this.#listeners.delete(listener);
+    }
+    beginReconciliation(reason) {
+        this.#publish({ state: "reconciling", dirty: true, incrementalApplyPaused: true, reason });
+    }
+    watcherOverflow() {
+        this.beginReconciliation("watcher_overflow");
+    }
+    sequenceGap() {
+        this.beginReconciliation("sequence_gap");
+    }
+    budgetExhausted(reason) {
+        this.#publish({ state: "paused", dirty: true, incrementalApplyPaused: true, reason: `${reason}_budget_exhausted` });
+    }
+    conflictObserved() {
+        this.#publish({ state: "conflicted", dirty: this.snapshot.dirty, incrementalApplyPaused: false, reason: "path_conflict" });
+    }
+    markLiveUnverified() {
+        this.#publish({ state: "live_unverified", dirty: this.snapshot.dirty, incrementalApplyPaused: false });
+    }
+    confirmConvergence(receipt, now = Date.now()) {
+        const observedAt = Date.parse(receipt.observedAt);
+        const expiresAt = Date.parse(receipt.expiresAt);
+        if (receipt.authority !== "cuna_workspace_service" ||
+            receipt.bindingId !== this.configuration.bindingId ||
+            receipt.bindingGeneration !== this.configuration.bindingGeneration ||
+            receipt.epoch !== this.configuration.epoch ||
+            receipt.policyDigest !== this.configuration.policyDigest ||
+            receipt.localManifestRoot !== receipt.canonicalManifestRoot ||
+            !Number.isFinite(observedAt) ||
+            !Number.isFinite(expiresAt) ||
+            observedAt > now ||
+            expiresAt <= observedAt ||
+            expiresAt <= now ||
+            !/^[A-Za-z0-9._:-]{1,256}$/u.test(receipt.canonicalRevision)) {
+            this.#publish({ state: "unknown", dirty: true, incrementalApplyPaused: true, reason: "convergence_evidence_invalid" });
+            return;
+        }
+        this.#publish({
+            state: "converged",
+            dirty: false,
+            incrementalApplyPaused: false,
+            canonicalRevision: receipt.canonicalRevision,
+            evidenceExpiresAt: receipt.expiresAt,
+        });
+    }
+    #publish(snapshot) {
+        this.#snapshot = Object.freeze({ ...snapshot });
+        for (const listener of this.#listeners)
+            listener(this.#snapshot);
+    }
+}
+export class SyncSupervisorRegistry {
+    #supervisors = new Map();
+    connect(configuration, clock = Date.now) {
+        const existing = this.#supervisors.get(configuration.bindingId);
+        if (existing !== undefined) {
+            if (!sameConfiguration(existing.configuration, configuration)) {
+                throw workspaceError("supervisor_conflict", "An incompatible supervisor already owns this binding.", "conflict", "configuration_mismatch");
+            }
+            return Object.freeze({ supervisor: existing, created: false });
+        }
+        const supervisor = new LocalSyncSupervisor(configuration, { clock });
+        this.#supervisors.set(configuration.bindingId, supervisor);
+        return Object.freeze({ supervisor, created: true });
+    }
+    release(bindingId, supervisor) {
+        if (this.#supervisors.get(bindingId) !== supervisor)
+            return false;
+        return this.#supervisors.delete(bindingId);
+    }
+}
+export function progressFromReceipt(receipt) {
+    validateCount(receipt.observedEntries);
+    validateCount(receipt.observedBytes);
+    if (receipt.totalEntries !== undefined)
+        validateCount(receipt.totalEntries);
+    if (receipt.totalBytes !== undefined)
+        validateCount(receipt.totalBytes);
+    if ((receipt.totalEntries !== undefined && receipt.observedEntries > receipt.totalEntries) ||
+        (receipt.totalBytes !== undefined && receipt.observedBytes > receipt.totalBytes) ||
+        !Number.isFinite(Date.parse(receipt.observedAt))) {
+        throw workspaceError("progress_invalid", "A progress receipt contradicts its measured bounds.", "integrity", "invalid_measurement");
+    }
+    const committed = receipt.stage === "committed";
+    if (committed &&
+        (receipt.authority !== "cuna_workspace_service" ||
+            receipt.canonicalRevision === undefined ||
+            !/^[A-Za-z0-9._:-]{1,256}$/u.test(receipt.canonicalRevision) ||
+            (receipt.totalEntries !== undefined && receipt.observedEntries !== receipt.totalEntries) ||
+            (receipt.totalBytes !== undefined && receipt.observedBytes !== receipt.totalBytes))) {
+        throw workspaceError("progress_unproven", "Committed progress requires a server admission receipt.", "integrity", "authority_missing");
+    }
+    const percent = receipt.totalBytes !== undefined && receipt.totalBytes > 0
+        ? Math.min(100, Math.floor((receipt.observedBytes / receipt.totalBytes) * 100))
+        : undefined;
+    return Object.freeze({
+        stage: receipt.stage,
+        observedEntries: receipt.observedEntries,
+        observedBytes: receipt.observedBytes,
+        ...(receipt.totalEntries === undefined ? {} : { totalEntries: receipt.totalEntries }),
+        ...(receipt.totalBytes === undefined ? {} : { totalBytes: receipt.totalBytes }),
+        ...(percent === undefined ? {} : { percent }),
+        ready: committed,
+        ...(receipt.canonicalRevision === undefined ? {} : { canonicalRevision: receipt.canonicalRevision }),
+    });
+}
+function sameConfiguration(left, right) {
+    return left.bindingGeneration === right.bindingGeneration &&
+        left.canonicalRoot === right.canonicalRoot &&
+        left.policyDigest === right.policyDigest &&
+        left.epoch === right.epoch;
+}
+function validateOperation(operation) {
+    if (operation.operationId.length === 0 ||
+        operation.path.length === 0 ||
+        !Number.isSafeInteger(operation.byteLength) ||
+        operation.byteLength < 0 ||
+        !Number.isSafeInteger(operation.baseGeneration) ||
+        operation.baseGeneration < 0)
+        throw queueFailure("invalid_operation");
+}
+function validateCount(value) {
+    if (!Number.isSafeInteger(value) || value < 0) {
+        throw workspaceError("progress_invalid", "A progress receipt contains an invalid measured count.", "integrity", "invalid_count");
+    }
+}
+function queueFailure(reason) {
+    return workspaceError("queue_invalid", "The bounded synchronization queue cannot accept the operation.", "policy", reason);
+}
+//# sourceMappingURL=supervisor.js.map

package/dist/sync/supervisor.js.map

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

package/dist/sync/workspace-sync-client.d.ts

@@ -0,0 +1,18 @@
+import type { HttpTransport } from "../api/http.js";
+import { type WorkspaceSyncBeginRequest, type WorkspaceSyncChangePage, type WorkspaceSyncChunkReceipt, type WorkspaceSyncChunkContent, type WorkspaceSyncCommitReceipt, type WorkspaceSyncCommitRequest, type WorkspaceSyncEnvelope, type WorkspaceSyncManifestPageRequest, type WorkspaceSyncManifestReceipt, type WorkspaceSyncReconcileReceipt, type WorkspaceSyncReconcileRequest, type WorkspaceSyncSession } from "./workspace-sync-protocol.js";
+export interface WorkspaceSyncClient {
+    begin(workspaceId: string, request: WorkspaceSyncBeginRequest, idempotencyKey: string, signal?: AbortSignal): Promise<WorkspaceSyncEnvelope<WorkspaceSyncSession>>;
+    manifest(syncId: string, request: WorkspaceSyncManifestPageRequest, idempotencyKey: string, signal?: AbortSignal): Promise<WorkspaceSyncEnvelope<WorkspaceSyncManifestReceipt>>;
+    chunk(syncId: string, digest: string, bytes: Uint8Array, idempotencyKey: string, signal?: AbortSignal): Promise<WorkspaceSyncEnvelope<WorkspaceSyncChunkReceipt>>;
+    downloadChunk(syncId: string, digest: string, readerVersion: number, signal?: AbortSignal): Promise<WorkspaceSyncEnvelope<WorkspaceSyncChunkContent>>;
+    commit(syncId: string, request: WorkspaceSyncCommitRequest, idempotencyKey: string, signal?: AbortSignal): Promise<WorkspaceSyncEnvelope<WorkspaceSyncCommitReceipt>>;
+    changes(syncId: string, options: {
+        readonly cursor?: string;
+        readonly limit?: number;
+        readonly readerVersion: number;
+        readonly signal?: AbortSignal;
+    }): Promise<WorkspaceSyncEnvelope<WorkspaceSyncChangePage>>;
+    reconcile(workspaceId: string, request: WorkspaceSyncReconcileRequest, idempotencyKey: string, signal?: AbortSignal): Promise<WorkspaceSyncEnvelope<WorkspaceSyncReconcileReceipt>>;
+}
+export declare function createWorkspaceSyncClient(transport: HttpTransport): WorkspaceSyncClient;
+//# sourceMappingURL=workspace-sync-client.d.ts.map

package/dist/sync/workspace-sync-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-sync-client.d.ts","sourceRoot":"","sources":["../../src/sync/workspace-sync-client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACpD,OAAO,EAYL,KAAK,yBAAyB,EAC9B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,0BAA0B,EAC/B,KAAK,qBAAqB,EAC1B,KAAK,gCAAgC,EACrC,KAAK,4BAA4B,EACjC,KAAK,6BAA6B,EAClC,KAAK,6BAA6B,EAClC,KAAK,oBAAoB,EAC1B,MAAM,8BAA8B,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,oBAAoB,CAAC,CAAC,CAAC;IACnK,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,gCAAgC,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,4BAA4B,CAAC,CAAC,CAAC;IAChL,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAAC;IAClK,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,yBAAyB,CAAC,CAAC,CAAC;IACtJ,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,0BAA0B,CAAC,CAAC,CAAC;IACtK,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE;QAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GAAG,OAAO,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC,CAAC;IAChN,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,6BAA6B,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC,6BAA6B,CAAC,CAAC,CAAC;CACrL;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,aAAa,GAAG,mBAAmB,CAyGvF"}

package/dist/sync/workspace-sync-client.js

@@ -0,0 +1,150 @@
+import { EXIT_CODES, CunaError } from "../core/errors.js";
+import { assertCanonicalUuid, encodeCanonicalUuid } from "../core/validation.js";
+import { WORKSPACE_SYNC_PROTOCOL, WORKSPACE_SYNC_LIMITS, decodeChangePage, decodeChunkContent, decodeChunkReceipt, decodeCommitReceipt, decodeEnvelope, decodeManifestReceipt, decodeReconcileReceipt, decodeWorkspaceSyncSession, sha256, } from "./workspace-sync-protocol.js";
+export function createWorkspaceSyncClient(transport) {
+    const client = {
+        async begin(workspaceId, request, idempotencyKey, signal) {
+            const safeWorkspace = encodeCanonicalUuid(workspaceId, "workspace ID");
+            assertCanonicalUuid(request.workspace_binding_id, "workspace binding ID");
+            if (request.workspace_binding_id === workspaceId)
+                throw invalidRequest("workspace_binding_id_domain");
+            assertCanonicalUuid(request.machine_id, "machine ID");
+            validateIdempotencyKey(idempotencyKey);
+            const response = decodeEnvelope(await transport.request({
+                method: "POST", path: `/v1/workspaces/${safeWorkspace}/sync-sessions`, body: request,
+                idempotencyKey, ...(signal === undefined ? {} : { signal }),
+            }), decodeWorkspaceSyncSession);
+            if (response.data.workspace_id !== workspaceId || response.data.machine_id !== request.machine_id || response.data.base_generation !== request.base_generation || response.data.exclusion_policy_digest !== request.exclusion_policy_digest || response.selected_protocol !== response.data.selected_protocol || response.selected_protocol < request.protocol.minimum || response.selected_protocol > request.protocol.maximum) {
+                throw scopeMismatch();
+            }
+            return response;
+        },
+        async manifest(syncId, request, idempotencyKey, signal) {
+            const safeSync = encodeCanonicalUuid(syncId, "workspace sync ID");
+            validateIdempotencyKey(idempotencyKey);
+            const response = decodeEnvelope(await transport.request({
+                method: "POST", path: `/v1/workspace-sync/${safeSync}/manifests`, body: request,
+                idempotencyKey, ...(signal === undefined ? {} : { signal }),
+            }), decodeManifestReceipt);
+            if (response.data.sync.id !== syncId || response.data.page_index !== request.page_index || response.selected_protocol !== response.data.sync.selected_protocol)
+                throw scopeMismatch();
+            return response;
+        },
+        async chunk(syncId, digest, bytes, idempotencyKey, signal) {
+            const safeSync = encodeCanonicalUuid(syncId, "workspace sync ID");
+            validateDigest(digest);
+            validateIdempotencyKey(idempotencyKey);
+            if (bytes.byteLength > WORKSPACE_SYNC_LIMITS.chunkBytes || sha256(bytes) !== digest) {
+                throw new CunaError({
+                    code: "cuna.workspace_sync.chunk_mismatch",
+                    message: "The workspace chunk does not match its declared digest and length.",
+                    exitCode: EXIT_CODES.policy,
+                });
+            }
+            const response = decodeEnvelope(await transport.request({
+                method: "PUT", path: `/v1/workspace-sync/${safeSync}/chunks/${digest}`,
+                body: bytes, contentType: "application/octet-stream", idempotencyKey,
+                ...(signal === undefined ? {} : { signal }),
+            }), decodeChunkReceipt);
+            if (response.data.digest !== digest || response.data.byte_length !== bytes.byteLength || response.selected_protocol !== response.data.selected_protocol)
+                throw scopeMismatch();
+            return response;
+        },
+        async downloadChunk(syncId, digest, readerVersion, signal) {
+            const safeSync = encodeCanonicalUuid(syncId, "workspace sync ID");
+            validateDigest(digest);
+            if (!Number.isSafeInteger(readerVersion) || readerVersion < 1 || readerVersion > WORKSPACE_SYNC_PROTOCOL.maximum) {
+                throw invalidRequest("reader_version");
+            }
+            const response = decodeEnvelope(await transport.request({
+                method: "GET",
+                path: `/v1/workspace-sync/${safeSync}/chunks/${digest}`,
+                query: { reader_version: String(readerVersion) },
+                ...(signal === undefined ? {} : { signal }),
+            }), decodeChunkContent);
+            if (response.data.digest !== digest ||
+                response.data.selected_protocol !== response.selected_protocol ||
+                response.data.minimum_reader > readerVersion)
+                throw scopeMismatch();
+            return response;
+        },
+        async commit(syncId, request, idempotencyKey, signal) {
+            const safeSync = encodeCanonicalUuid(syncId, "workspace sync ID");
+            validateIdempotencyKey(idempotencyKey);
+            const response = decodeEnvelope(await transport.request({
+                method: "POST", path: `/v1/workspace-sync/${safeSync}/commit`, body: request,
+                idempotencyKey, ...(signal === undefined ? {} : { signal }),
+            }), decodeCommitReceipt);
+            if (response.data.manifest_root !== request.manifest_root || response.selected_protocol !== response.data.selected_protocol)
+                throw scopeMismatch();
+            return response;
+        },
+        async changes(syncId, options) {
+            const safeSync = encodeCanonicalUuid(syncId, "workspace sync ID");
+            if (!Number.isSafeInteger(options.readerVersion) || options.readerVersion < 1)
+                throw invalidRequest("reader_version");
+            if (options.limit !== undefined && (!Number.isSafeInteger(options.limit) || options.limit < 1 || options.limit > WORKSPACE_SYNC_LIMITS.changePageEntries))
+                throw invalidRequest("limit");
+            if (options.cursor !== undefined && (options.cursor.length < 1 || options.cursor.length > 1_024 || containsAsciiControl(options.cursor)))
+                throw invalidRequest("cursor");
+            return decodeEnvelope(await transport.request({
+                method: "GET", path: `/v1/workspace-sync/${safeSync}/changes`,
+                query: {
+                    ...(options.cursor === undefined ? {} : { cursor: options.cursor }),
+                    ...(options.limit === undefined ? {} : { limit: String(options.limit) }),
+                    reader_version: String(options.readerVersion),
+                },
+                ...(options.signal === undefined ? {} : { signal: options.signal }),
+            }), decodeChangePage);
+        },
+        async reconcile(workspaceId, request, idempotencyKey, signal) {
+            const safeWorkspace = encodeCanonicalUuid(workspaceId, "workspace ID");
+            assertCanonicalUuid(request.workspace_binding_id, "workspace binding ID");
+            if (request.workspace_binding_id === workspaceId)
+                throw invalidRequest("workspace_binding_id_domain");
+            assertCanonicalUuid(request.machine_id, "machine ID");
+            validateIdempotencyKey(idempotencyKey);
+            const response = decodeEnvelope(await transport.request({
+                method: "POST", path: `/v1/workspaces/${safeWorkspace}/reconcile`, body: request,
+                idempotencyKey, ...(signal === undefined ? {} : { signal }),
+            }), decodeReconcileReceipt);
+            if (response.data.exclusion_policy_digest !== request.exclusion_policy_digest || response.selected_protocol < request.protocol.minimum || response.selected_protocol > request.protocol.maximum)
+                throw scopeMismatch();
+            return response;
+        },
+    };
+    return Object.freeze(client);
+}
+function validateIdempotencyKey(value) {
+    const length = Buffer.byteLength(value, "utf8");
+    if (length < 16 || length > 256 || containsAsciiControl(value))
+        throw invalidRequest("idempotency_key");
+}
+function containsAsciiControl(value) {
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code <= 0x1f || code === 0x7f)
+            return true;
+    }
+    return false;
+}
+function validateDigest(value) {
+    if (!/^[0-9a-f]{64}$/u.test(value))
+        throw invalidRequest("digest");
+}
+function invalidRequest(reason) {
+    return new CunaError({
+        code: "cuna.workspace_sync.invalid_request",
+        message: "The workspace synchronization request is malformed.",
+        exitCode: EXIT_CODES.usage,
+        details: { reason },
+    });
+}
+function scopeMismatch() {
+    return new CunaError({
+        code: "cuna.workspace_sync.scope_mismatch",
+        message: "Cuna returned workspace synchronization authority for a different scope.",
+        exitCode: EXIT_CODES.policy,
+    });
+}
+//# sourceMappingURL=workspace-sync-client.js.map

package/dist/sync/workspace-sync-client.js.map

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

package/dist/sync/workspace-sync-coordinator.d.ts

@@ -0,0 +1,76 @@
+import type { WorkspaceManifest } from "../workspace/manifest.js";
+import type { WorkspaceSyncClient } from "./workspace-sync-client.js";
+import { type WorkspaceSyncChangePage, type WorkspaceSyncCommitReceipt, type WorkspaceSyncReconcileReceipt } from "./workspace-sync-protocol.js";
+export type WorkspaceSyncPhase = "begin_pending" | "staging" | "commit_pending" | "committed" | "conflicted";
+export interface WorkspaceSyncCheckpoint {
+    readonly schema_version: 2;
+    readonly workspace_id: string;
+    readonly workspace_binding_id: string;
+    readonly machine_id: string;
+    readonly base_generation: number;
+    readonly exclusion_policy_digest: string;
+    readonly manifest_root: string;
+    readonly phase: WorkspaceSyncPhase;
+    readonly sync_id: string | null;
+    readonly selected_protocol: 1 | 2 | null;
+    readonly committed_generation: number | null;
+    readonly updated_at: string;
+}
+export interface WorkspaceSyncCheckpointStore {
+    load(): Promise<WorkspaceSyncCheckpoint | undefined>;
+    withLease<T>(operation: (transaction: WorkspaceSyncCheckpointTransaction) => Promise<T>): Promise<T>;
+}
+export interface WorkspaceSyncCheckpointTransaction {
+    load(): Promise<WorkspaceSyncCheckpoint | undefined>;
+    save(checkpoint: WorkspaceSyncCheckpoint): Promise<void>;
+}
+export interface WorkspaceChunkSource {
+    read(digest: string, expectedLength: number): Promise<Uint8Array>;
+}
+export interface WorkspaceSyncCoordinatorOptions {
+    readonly client: WorkspaceSyncClient;
+    readonly checkpointStore: WorkspaceSyncCheckpointStore;
+    readonly chunkSource: WorkspaceChunkSource;
+    readonly maximumConcurrentUploads?: number;
+    readonly maximumAttempts?: number;
+    readonly sleep?: (milliseconds: number, signal?: AbortSignal) => Promise<void>;
+    readonly now?: () => Date;
+}
+export interface SynchronizeWorkspaceInput {
+    readonly workspaceId: string;
+    readonly workspaceBindingId: string;
+    readonly machineId: string;
+    readonly baseGeneration: number;
+    readonly manifest: WorkspaceManifest;
+    readonly signal?: AbortSignal;
+}
+export declare class WorkspaceSyncCoordinator {
+    #private;
+    constructor(options: WorkspaceSyncCoordinatorOptions);
+    synchronize(input: SynchronizeWorkspaceInput): Promise<WorkspaceSyncCommitReceipt>;
+    reconcile(input: {
+        readonly workspaceId: string;
+        readonly workspaceBindingId: string;
+        readonly machineId: string;
+        readonly observedGeneration: number;
+        readonly exclusionPolicyDigest: string;
+        readonly manifestRoot: string;
+        readonly signal?: AbortSignal;
+    }): Promise<WorkspaceSyncReconcileReceipt>;
+    consumeChanges(input: {
+        readonly syncId: string;
+        readonly cursor?: string;
+        readonly readerVersion?: number;
+        readonly maximumPages?: number;
+        readonly onPage: (page: WorkspaceSyncChangePage) => Promise<void>;
+        readonly signal?: AbortSignal;
+    }): Promise<string | null>;
+}
+export declare class FileWorkspaceSyncCheckpointStore implements WorkspaceSyncCheckpointStore {
+    #private;
+    constructor(directory: string);
+    load(): Promise<WorkspaceSyncCheckpoint | undefined>;
+    withLease<T>(operation: (transaction: WorkspaceSyncCheckpointTransaction) => Promise<T>): Promise<T>;
+}
+export declare function createFilesystemChunkSource(root: string, manifest: WorkspaceManifest): Promise<WorkspaceChunkSource>;
+//# sourceMappingURL=workspace-sync-coordinator.d.ts.map