@orkestrel/scaffold 0.0.107 → 0.0.109

package/dist/src/server/index.js

@@ -1,6 +1,6 @@
 import { createRequire } from "node:module";
 import { andOf, arrayOf, attempt, boundsOf, compareValues, compileGuard, holds, isArray, isBoolean, isDefined, isError, isFunction, isInteger, isNonNegativeInteger, isNumber, isRecord, isString, parseJSON, parseJSONAs, parseStringField, recordOf, recordShape, stringOf, stringShape, unionOf, whereOf } from "@orkestrel/contract";
-import { CANON_PATHS, CATALOG_AGENT_PATH, CATALOG_CLOSING_MARKER, CATALOG_OPENING_MARKER, CONTROL_CHARACTER_PATTERN, DEPENDENCY_NAME_PATTERN, EXECUTABLE_PATHS, HOST_INVENTORY_PATH, HOST_PATHS, MAX_ARTIFACT_BYTES, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, REFERENCE_PATHS, ScaffoldError, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeTotal, contentToHex, extractRangeMajor, extractVersion, inferGroup, insertManifestDependencies, isAudit, isCatalogEntry, isCollection, isDependency, isDependencyName, isFloorPath, isHex, isManifestScript, isMirror, isPath, isPlan, isRetainedPath, isSnapshot, iterateAnswers, matchesDriftReachability, matchesRange, nameToGuide, planToFindings, renderSkillPointer, replaceManifestOverrides, replaceManifestRanges, replaceManifestScripts } from "../core/index.js";
+import { CANON_PATHS, CATALOG_AGENT_PATH, CATALOG_END_MARKER, CATALOG_START_MARKER, CONTROL_CHARACTER_PATTERN, DEPENDENCY_NAME_PATTERN, EXECUTABLE_PATHS, HOST_INVENTORY_PATH, HOST_PATHS, MAX_ARTIFACT_BYTES, MAX_COLLECTION_ITEMS, MAX_DEPENDENCY_NAME_LENGTH, MAX_MANIFEST_BYTES, MAX_PATH_LENGTH, MAX_RANGE_LENGTH, MAX_REGISTRY_BYTES, MAX_TOTAL_ARTIFACT_BYTES, MAX_TOTAL_REGISTRY_BYTES, REFERENCE_PATHS, ScaffoldError, bytesToHex, catalogToLayers, cloneValue, compareVersions, computeBytes, computeTotal, contentToHex, extractRangeMajor, extractVersion, inferGroup, insertManifestDependencies, isAudit, isCatalogEntry, isCollection, isDependency, isDependencyName, isFloorPath, isHex, isManifestScript, isMirror, isPath, isPlan, isRetainedPath, isSnapshot, iterateAnswers, matchesDriftReachability, matchesRange, nameToGuide, planToFindings, renderSkillPointer, replaceManifestOverrides, replaceManifestRanges, replaceManifestScripts } from "../core/index.js";
 import { createHash, randomUUID } from "node:crypto";
 import { chmodSync, closeSync, constants, copyFileSync, fstatSync, linkSync, lstatSync, mkdirSync, mkdtempSync, openSync, opendirSync, readSync, readdirSync, readlinkSync, realpathSync, renameSync, rmSync, rmdirSync, writeFileSync } from "node:fs";
 import { tmpdir } from "node:os";
@@ -8,7 +8,7 @@ import { basename, dirname, extname, join, parse, relative, resolve, sep } from
 import { fileURLToPath } from "node:url";
 import { createMarkdown, flattenText, isTableNode } from "@orkestrel/markdown";
 import { Emitter } from "@orkestrel/emitter";
-//#region src/server/constants.ts
+// src/server/constants.ts
 /**
 * Matches the drive prefix a Windows host path may open with.
 *
@@ -161,8 +161,7 @@ var UNREADABLE_VERSION_NOTE = "the answer carries no readable latest version";
 * smaller document instead of the whole packument.
 */
 var PACKUMENT_MEDIA_TYPE = "application/vnd.npm.install-v1+json";
-//#endregion
-//#region src/server/helpers.ts
+// src/server/helpers.ts
 /**
 * Tests whether a caught filesystem error reports an absent path.
 *
@@ -1990,8 +1989,7 @@ function matchesPrecondition(precondition) {
 	if (precondition.digest === void 0) return true;
 	return computeFileDigest(precondition.path) === precondition.digest;
 }
-//#endregion
-//#region src/server/validators.ts
+// src/server/validators.ts
 /**
 * Narrows a value to a path naming a location on this host.
 *
@@ -2393,8 +2391,7 @@ var isUpstreamOptions = recordOf({
 	on: isUpstreamHooks,
 	error: isFunction
 }, true);
-//#endregion
-//#region src/server/WriteTransaction.ts
+// src/server/WriteTransaction.ts
 /**
 * Represents one staged, reversible mutation of one target directory.
 *
@@ -2852,7 +2849,7 @@ var WriteTransaction = class {
 		renameSync(expectation.path, backup);
 	}
 	#recover(promoted, taken) {
-		const restoring = [...[...taken].reverse().flatMap((path) => {
+		const restoreFailures = [...[...taken].reverse().flatMap((path) => {
 			const restored = attempt(() => renameSync(this.#resolve(this.#backup, path), this.#expectation(path).path));
 			return restored.success ? [] : [restored.error];
 		}), ...[...promoted].reverse().flatMap((path) => {
@@ -2866,20 +2863,20 @@ var WriteTransaction = class {
 			});
 			return restored.success ? [] : [restored.error];
 		})];
-		const cleared = restoring.length === 0 ? attempt(() => rmSync(this.#root, {
+		const cleared = restoreFailures.length === 0 ? attempt(() => rmSync(this.#root, {
 			recursive: true,
 			force: true
 		})) : void 0;
-		const clearing = cleared === void 0 || cleared.success ? [] : [cleared.error];
-		const removing = [...this.#created].reverse().flatMap((created) => {
+		const clearFailures = cleared === void 0 || cleared.success ? [] : [cleared.error];
+		const removeFailures = [...this.#created].reverse().flatMap((created) => {
 			const path = isString(created) ? created : created.path;
 			const removed = attempt(() => rmdirSync(path));
 			return !removed.success && !matchesMissingPath(removed.error) ? [removed.error] : [];
 		});
 		return [
-			...restoring,
-			...clearing,
-			...removing
+			...restoreFailures,
+			...clearFailures,
+			...removeFailures
 		];
 	}
 	#stagePath(path) {
@@ -2902,8 +2899,7 @@ var WriteTransaction = class {
 		if (!this.#open) throw new ScaffoldError("WRITE", "This write transaction is closed.", { target: this.#target });
 	}
 };
-//#endregion
-//#region src/server/Materializer.ts
+// src/server/Materializer.ts
 /**
 * Represents the mutation spine: read the vendored host, re-derive the target, stage, swap.
 *
@@ -3767,8 +3763,8 @@ var Materializer = class {
 				""
 			];
 			const layer = placed.get(entry.name);
-			const edges = entry.dependencies.map((dependency) => `\`${dependency.name}\` \`${dependency.range}\``).join(", ");
-			const peers = entry.peers.map((dependency) => `\`${dependency.name}\` \`${dependency.range}\``).join(", ");
+			const edges = entry.dependencies.map((dependency) => `\`${dependency.name}\` \`${dependency.range.replaceAll("|", "\\|")}\``).join(", ");
+			const peers = entry.peers.map((dependency) => `\`${dependency.name}\` \`${dependency.range.replaceAll("|", "\\|")}\``).join(", ");
 			return [
 				`\`${entry.name}\``,
 				`\`${entry.version}\``,
@@ -3791,10 +3787,10 @@ var Materializer = class {
 			...rows
 		].map((row) => `| ${row.map((cell, column) => cell.padEnd(widths[column] ?? cell.length)).join(" | ")} |`).join("\n");
 		return (text) => {
-			const opening = text.indexOf(CATALOG_OPENING_MARKER);
-			const closing = text.indexOf(CATALOG_CLOSING_MARKER, opening + CATALOG_OPENING_MARKER.length);
-			if (opening < 0 || closing < 0) throw this.#error("TARGET", "The catalog agent file carries no marked region.", { path: CATALOG_AGENT_PATH });
-			return `${text.slice(0, opening + CATALOG_OPENING_MARKER.length)}\n\n${table}\n\n${text.slice(closing)}`;
+			const start = text.indexOf(CATALOG_START_MARKER);
+			const end = text.indexOf(CATALOG_END_MARKER, start + CATALOG_START_MARKER.length);
+			if (start < 0 || end < 0) throw this.#error("TARGET", "The catalog agent file carries no marked region.", { path: CATALOG_AGENT_PATH });
+			return `${text.slice(0, start + CATALOG_START_MARKER.length)}\n\n${table}\n\n${text.slice(end)}`;
 		};
 	}
 	#cell(note) {
@@ -3839,8 +3835,7 @@ var Materializer = class {
 		return error;
 	}
 };
-//#endregion
-//#region src/server/ReadAllowance.ts
+// src/server/ReadAllowance.ts
 /**
 * Represents the byte allowance one upstream call spends across every read it makes.
 *
@@ -3899,8 +3894,7 @@ var ReadAllowance = class {
 		this.#remaining -= bytes;
 	}
 };
-//#endregion
-//#region src/server/Upstream.ts
+// src/server/Upstream.ts
 /**
 * Represents the reading spine: one bounded, unauthenticated, redirect-free request per answer.
 *
@@ -4606,7 +4600,6 @@ var Upstream = class {
 		return error;
 	}
 };
-//#endregion
 export { BRANCH_PATTERN, DEFAULT_BRANCH, DEFAULT_REGISTRY_BASE, DEFAULT_REPOSITORY_BASE, DEFAULT_UPSTREAM_CONCURRENCY, DEFAULT_UPSTREAM_RETRIES, DEFAULT_UPSTREAM_TIMEOUT, DIGEST_PATTERN, DRIVE_PATTERN, INVALID_SEGMENT_CHARACTER_PATTERN, MANIFEST_NAME, MAX_BRANCH_LENGTH, MAX_ENDPOINT_LENGTH, MAX_INVENTORY_PATHS, MAX_PATH_DEPTH, MAX_PATH_SEGMENT_BYTES, MAX_UPSTREAM_CONCURRENCY, MAX_UPSTREAM_RETRIES, MAX_UPSTREAM_TIMEOUT, Materializer, ORKESTREL_SCOPE, PACKUMENT_MEDIA_TYPE, RESERVED_SEGMENT_PATTERN, ReadAllowance, SCAFFOLD_REPOSITORY, UNREADABLE_VERSION_NOTE, Upstream, WriteTransaction, climbRealPath, collectIndexed, computeDigest, computeFileDigest, computeManifestDigest, decodeHexText, filesToHost, hexToDigest, isBranch, isCatalogEntries, isDependencies, isDependencyNames, isDigest, isEndpoint, isExactCaseFile, isFilesystemPath, isHost, isHostManifest, isInventory, isManifestEntry, isManifestRegionSet, isMaterializerHooks, isMaterializerOptions, isMirrors, isPaths, isPhysicalDirectory, isPhysicalFile, isTimeout, isUpstreamHooks, isUpstreamOptions, isVacant, isWorktree, listAncestors, listCanonPaths, listDirectories, listFiles, matchesAnchor, matchesExecutablePath, matchesExpectation, matchesGitPath, matchesMissingPath, matchesPrecondition, matchesProtectedPath, matchesSensitivePath, pathToStorage, pruneEmptiedDirectories, readAnchor, readExpectation, readFileHex, readFileText, readHostFloor, readHostManifest, readManifestEntry, readSnapshot, readSurfaceBaseline, readSurfaceCollisions, resolveContainedPath, resolveRealPath, stageBytes, stageHost, stageInventory };
 
 //# sourceMappingURL=index.js.map