emdash 1.2.0 → 1.3.1

package/dist/digest-DlBa7kJl.mjs

@@ -0,0 +1,194 @@
+import { n as canonicalJson } from "./canonical-DjF_z6GI.mjs";
+import { SHA256 } from "@oslojs/crypto/sha2";
+import { encodeHexLowerCase } from "@oslojs/encoding";
+
+//#region src/transfer/format/digest.ts
+/**
+* SHA-256 hashing and the digests that identify packages, plans, receipts,
+* and verified target state.
+*
+* Digest rules (formatVersion "1"):
+* - `packageDigest = "sha256:" + hex(sha256(utf8(canonicalJson(manifest))))`
+* - `planDigest = "sha256:" + hex(sha256(utf8(canonicalJson(plan))))` over the
+*   complete {@link SiteImportPlan} including its `decisions`, `packageDigest`
+*   and `target.siteId`, so a plan cannot be replayed against another package
+*   or target.
+* - `receiptDigest` covers the receipt with its `receiptDigest` property
+*   removed.
+* - A record's hash is the hex SHA-256 of its canonical JSON (the NDJSON line
+*   without its newline).
+* - A chunk's logical hash is
+*   `hex(sha256(utf8(canonicalJson([[id, recordSha256], …]))))` over the
+*   records of one package record chunk, in chunk order, each record in its
+*   predicted target form (after declared transformations).
+* - `logicalDigest = "sha256:" + hex(sha256(utf8(canonicalJson(chunks))))`
+*   where `chunks` is `[[kind, seq, chunkLogicalSha256], …]` for every record
+*   chunk in package order (kinds in `RECORD_KINDS` order, then `seq`).
+*   `principal` chunks are excluded because principals are never written to
+*   a target. The two-level shape lets verification run in bounded steps and
+*   persist one hash per chunk instead of an in-progress hash state.
+*/
+const SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/;
+const SHA256_DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/;
+function isSha256Hex(value) {
+	return typeof value === "string" && SHA256_HEX_PATTERN.test(value);
+}
+function isSha256Digest(value) {
+	return typeof value === "string" && SHA256_DIGEST_PATTERN.test(value);
+}
+function toSha256Digest(hex) {
+	if (!isSha256Hex(hex)) throw new TypeError("Expected a lowercase hex SHA-256");
+	return `sha256:${hex}`;
+}
+function isDigestStreamConstructor(value) {
+	return typeof value === "function";
+}
+function isNodeCreateHash(value) {
+	return typeof value === "function";
+}
+function getDigestStream() {
+	const candidate = typeof globalThis.crypto === "object" ? Reflect.get(globalThis.crypto, "DigestStream") : void 0;
+	return isDigestStreamConstructor(candidate) ? candidate : void 0;
+}
+function isNodeRuntime() {
+	const processLike = Reflect.get(globalThis, "process");
+	if (typeof processLike !== "object" || processLike === null) return false;
+	const versions = Reflect.get(processLike, "versions");
+	return typeof versions === "object" && versions !== null && typeof Reflect.get(versions, "node") === "string";
+}
+let nodeCreateHash;
+function loadNodeCreateHash() {
+	nodeCreateHash ??= (async () => {
+		if (!isNodeRuntime()) return null;
+		try {
+			const nodeCrypto = await import("node:crypto");
+			return isNodeCreateHash(nodeCrypto.createHash) ? nodeCrypto.createHash : null;
+		} catch {
+			return null;
+		}
+	})();
+	return nodeCreateHash;
+}
+async function preferredBackend() {
+	if (getDigestStream()) return "digest-stream";
+	if (await loadNodeCreateHash()) return "node";
+	return "oslo";
+}
+var DigestStreamHasher = class {
+	backend = "digest-stream";
+	#stream;
+	#writer;
+	#failure;
+	constructor(DigestStream) {
+		this.#stream = new DigestStream("SHA-256");
+		this.#writer = this.#stream.getWriter();
+	}
+	update(chunk) {
+		this.#writer.write(chunk.slice()).catch((error) => {
+			this.#failure ??= error;
+		});
+	}
+	async digest() {
+		await this.#writer.close();
+		if (this.#failure !== void 0) throw this.#failure;
+		return encodeHexLowerCase(new Uint8Array(await this.#stream.digest));
+	}
+};
+var NodeHasher = class {
+	backend = "node";
+	#hash;
+	constructor(createHash) {
+		this.#hash = createHash("sha256");
+	}
+	update(chunk) {
+		this.#hash.update(chunk);
+	}
+	async digest() {
+		return this.#hash.digest("hex");
+	}
+};
+var OsloHasher = class {
+	backend = "oslo";
+	#hash = new SHA256();
+	update(chunk) {
+		this.#hash.update(chunk);
+	}
+	async digest() {
+		return encodeHexLowerCase(this.#hash.digest());
+	}
+};
+async function createSha256(options = {}) {
+	switch (options.backend ?? await preferredBackend()) {
+		case "digest-stream": {
+			const DigestStream = getDigestStream();
+			if (!DigestStream) throw new Error("crypto.DigestStream is not available");
+			return new DigestStreamHasher(DigestStream);
+		}
+		case "node": {
+			const createHash = await loadNodeCreateHash();
+			if (!createHash) throw new Error("node:crypto is not available");
+			return new NodeHasher(createHash);
+		}
+		case "oslo": return new OsloHasher();
+	}
+}
+const encoder = new TextEncoder();
+async function sha256Hex(data) {
+	const bytes = typeof data === "string" ? encoder.encode(data) : data;
+	const hasher = await createSha256();
+	hasher.update(bytes);
+	return hasher.digest();
+}
+/** `"sha256:" + hex(sha256(utf8(canonicalJson(value))))`. */
+async function canonicalDigest(value) {
+	return toSha256Digest(await sha256Hex(canonicalJson(value)));
+}
+/** Hex SHA-256 of a record's canonical JSON (its NDJSON line without the newline). */
+async function recordSha256(record) {
+	return sha256Hex(canonicalJson(record));
+}
+function packageDigest(manifest) {
+	return canonicalDigest(manifest);
+}
+function planDigest(plan) {
+	return canonicalDigest(plan);
+}
+/** Digest over a receipt without its own `receiptDigest` property. */
+function receiptDigest(receipt) {
+	const { receiptDigest: _ignored, ...rest } = receipt;
+	return canonicalDigest(rest);
+}
+/** Hex logical hash of one record chunk from its `[id, recordSha256]` pairs in chunk order. */
+async function chunkLogicalSha256(records) {
+	for (const [, sha] of records) if (!isSha256Hex(sha)) throw new TypeError("Expected a lowercase hex SHA-256");
+	return sha256Hex(canonicalJson(records.map(([id, sha]) => [id, sha])));
+}
+/** `logicalDigest` from `[kind, seq, chunkLogicalSha256]` tuples in package order. */
+async function logicalDigest(chunks) {
+	for (const [, , sha] of chunks) if (!isSha256Hex(sha)) throw new TypeError("Expected a lowercase hex SHA-256");
+	return canonicalDigest(chunks.map(([kind, seq, sha]) => [
+		kind,
+		seq,
+		sha
+	]));
+}
+/**
+* Pass-through stream that feeds every chunk to `hasher` and counts bytes.
+* Throws inside the stream as soon as more than `maxBytes` flow through.
+*/
+function createHashingStream(hasher, options = {}) {
+	let total = 0;
+	return {
+		stream: new TransformStream({ transform(chunk, controller) {
+			total += chunk.byteLength;
+			if (options.maxBytes !== void 0 && total > options.maxBytes) throw options.onLimitExceeded?.() ?? /* @__PURE__ */ new RangeError("Stream exceeded its declared size");
+			hasher.update(chunk);
+			controller.enqueue(chunk);
+		} }),
+		bytes: () => total
+	};
+}
+
+//#endregion
+export { isSha256Digest as a, planDigest as c, sha256Hex as d, toSha256Digest as f, createSha256 as i, receiptDigest as l, chunkLogicalSha256 as n, logicalDigest as o, createHashingStream as r, packageDigest as s, canonicalDigest as t, recordSha256 as u };
+//# sourceMappingURL=digest-DlBa7kJl.mjs.map

package/dist/digest-DlBa7kJl.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"digest-DlBa7kJl.mjs","names":["#stream","#writer","#failure","#hash"],"sources":["../src/transfer/format/digest.ts"],"sourcesContent":["/**\n * SHA-256 hashing and the digests that identify packages, plans, receipts,\n * and verified target state.\n *\n * Digest rules (formatVersion \"1\"):\n * - `packageDigest = \"sha256:\" + hex(sha256(utf8(canonicalJson(manifest))))`\n * - `planDigest = \"sha256:\" + hex(sha256(utf8(canonicalJson(plan))))` over the\n *   complete {@link SiteImportPlan} including its `decisions`, `packageDigest`\n *   and `target.siteId`, so a plan cannot be replayed against another package\n *   or target.\n * - `receiptDigest` covers the receipt with its `receiptDigest` property\n *   removed.\n * - A record's hash is the hex SHA-256 of its canonical JSON (the NDJSON line\n *   without its newline).\n * - A chunk's logical hash is\n *   `hex(sha256(utf8(canonicalJson([[id, recordSha256], …]))))` over the\n *   records of one package record chunk, in chunk order, each record in its\n *   predicted target form (after declared transformations).\n * - `logicalDigest = \"sha256:\" + hex(sha256(utf8(canonicalJson(chunks))))`\n *   where `chunks` is `[[kind, seq, chunkLogicalSha256], …]` for every record\n *   chunk in package order (kinds in `RECORD_KINDS` order, then `seq`).\n *   `principal` chunks are excluded because principals are never written to\n *   a target. The two-level shape lets verification run in bounded steps and\n *   persist one hash per chunk instead of an in-progress hash state.\n */\n\nimport { SHA256 } from \"@oslojs/crypto/sha2\";\nimport { encodeHexLowerCase } from \"@oslojs/encoding\";\n\nimport { canonicalJson } from \"./canonical.js\";\n\nexport type Sha256Digest = `sha256:${string}`;\n\nconst SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/;\nconst SHA256_DIGEST_PATTERN = /^sha256:[0-9a-f]{64}$/;\n\nexport function isSha256Hex(value: unknown): value is string {\n\treturn typeof value === \"string\" && SHA256_HEX_PATTERN.test(value);\n}\n\nexport function isSha256Digest(value: unknown): value is Sha256Digest {\n\treturn typeof value === \"string\" && SHA256_DIGEST_PATTERN.test(value);\n}\n\nexport function toSha256Digest(hex: string): Sha256Digest {\n\tif (!isSha256Hex(hex)) throw new TypeError(\"Expected a lowercase hex SHA-256\");\n\treturn `sha256:${hex}`;\n}\n\nexport function sha256HexOf(digest: Sha256Digest): string {\n\tif (!isSha256Digest(digest)) throw new TypeError(\"Expected a sha256: digest\");\n\treturn digest.slice(\"sha256:\".length);\n}\n\n/** Incremental SHA-256. `update` never retains the chunk after it returns. */\nexport interface Sha256Hasher {\n\treadonly backend: Sha256Backend;\n\tupdate(chunk: Uint8Array): void;\n\t/** Lowercase hex digest. The hasher must not be used afterwards. */\n\tdigest(): Promise<string>;\n}\n\nexport type Sha256Backend = \"digest-stream\" | \"node\" | \"oslo\";\n\ninterface DigestStreamLike extends WritableStream<ArrayBufferView | ArrayBuffer> {\n\treadonly digest: Promise<ArrayBuffer>;\n}\n\ntype DigestStreamConstructor = new (algorithm: string) => DigestStreamLike;\n\ninterface NodeHash {\n\tupdate(data: Uint8Array): unknown;\n\tdigest(encoding: \"hex\"): string;\n}\n\ntype NodeCreateHash = (algorithm: string) => NodeHash;\n\nfunction isDigestStreamConstructor(value: unknown): value is DigestStreamConstructor {\n\treturn typeof value === \"function\";\n}\n\nfunction isNodeCreateHash(value: unknown): value is NodeCreateHash {\n\treturn typeof value === \"function\";\n}\n\nfunction getDigestStream(): DigestStreamConstructor | undefined {\n\tconst candidate: unknown =\n\t\ttypeof globalThis.crypto === \"object\"\n\t\t\t? Reflect.get(globalThis.crypto, \"DigestStream\")\n\t\t\t: undefined;\n\treturn isDigestStreamConstructor(candidate) ? candidate : undefined;\n}\n\nfunction isNodeRuntime(): boolean {\n\tconst processLike: unknown = Reflect.get(globalThis, \"process\");\n\tif (typeof processLike !== \"object\" || processLike === null) return false;\n\tconst versions: unknown = Reflect.get(processLike, \"versions\");\n\treturn (\n\t\ttypeof versions === \"object\" &&\n\t\tversions !== null &&\n\t\ttypeof Reflect.get(versions, \"node\") === \"string\"\n\t);\n}\n\nlet nodeCreateHash: Promise<NodeCreateHash | null> | undefined;\n\nfunction loadNodeCreateHash(): Promise<NodeCreateHash | null> {\n\tnodeCreateHash ??= (async () => {\n\t\tif (!isNodeRuntime()) return null;\n\t\ttry {\n\t\t\tconst nodeCrypto: { createHash?: unknown } = await import(\"node:crypto\");\n\t\t\treturn isNodeCreateHash(nodeCrypto.createHash) ? nodeCrypto.createHash : null;\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t})();\n\treturn nodeCreateHash;\n}\n\nasync function preferredBackend(): Promise<Sha256Backend> {\n\tif (getDigestStream()) return \"digest-stream\";\n\tif (await loadNodeCreateHash()) return \"node\";\n\treturn \"oslo\";\n}\n\nclass DigestStreamHasher implements Sha256Hasher {\n\treadonly backend = \"digest-stream\";\n\treadonly #stream: DigestStreamLike;\n\treadonly #writer: WritableStreamDefaultWriter<ArrayBufferView | ArrayBuffer>;\n\t#failure: unknown;\n\n\tconstructor(DigestStream: DigestStreamConstructor) {\n\t\tthis.#stream = new DigestStream(\"SHA-256\");\n\t\tthis.#writer = this.#stream.getWriter();\n\t}\n\n\tupdate(chunk: Uint8Array): void {\n\t\t// DigestStream consumes its input asynchronously; copy so the caller\n\t\t// may reuse its buffer as soon as update() returns.\n\t\tthis.#writer.write(chunk.slice()).catch((error: unknown) => {\n\t\t\tthis.#failure ??= error;\n\t\t});\n\t}\n\n\tasync digest(): Promise<string> {\n\t\tawait this.#writer.close();\n\t\tif (this.#failure !== undefined) throw this.#failure;\n\t\treturn encodeHexLowerCase(new Uint8Array(await this.#stream.digest));\n\t}\n}\n\nclass NodeHasher implements Sha256Hasher {\n\treadonly backend = \"node\";\n\treadonly #hash: NodeHash;\n\n\tconstructor(createHash: NodeCreateHash) {\n\t\tthis.#hash = createHash(\"sha256\");\n\t}\n\n\tupdate(chunk: Uint8Array): void {\n\t\tthis.#hash.update(chunk);\n\t}\n\n\tasync digest(): Promise<string> {\n\t\treturn this.#hash.digest(\"hex\");\n\t}\n}\n\nclass OsloHasher implements Sha256Hasher {\n\treadonly backend = \"oslo\";\n\treadonly #hash = new SHA256();\n\n\tupdate(chunk: Uint8Array): void {\n\t\tthis.#hash.update(chunk);\n\t}\n\n\tasync digest(): Promise<string> {\n\t\treturn encodeHexLowerCase(this.#hash.digest());\n\t}\n}\n\n/**\n * Backends usable in this runtime, most preferred first: `crypto.DigestStream`\n * (workerd), `node:crypto`, then the pure-JS oslo implementation.\n */\nexport async function availableSha256Backends(): Promise<Sha256Backend[]> {\n\tconst backends: Sha256Backend[] = [];\n\tif (getDigestStream()) backends.push(\"digest-stream\");\n\tif (await loadNodeCreateHash()) backends.push(\"node\");\n\tbackends.push(\"oslo\");\n\treturn backends;\n}\n\nexport async function createSha256(\n\toptions: { backend?: Sha256Backend } = {},\n): Promise<Sha256Hasher> {\n\tconst backend = options.backend ?? (await preferredBackend());\n\tswitch (backend) {\n\t\tcase \"digest-stream\": {\n\t\t\tconst DigestStream = getDigestStream();\n\t\t\tif (!DigestStream) throw new Error(\"crypto.DigestStream is not available\");\n\t\t\treturn new DigestStreamHasher(DigestStream);\n\t\t}\n\t\tcase \"node\": {\n\t\t\tconst createHash = await loadNodeCreateHash();\n\t\t\tif (!createHash) throw new Error(\"node:crypto is not available\");\n\t\t\treturn new NodeHasher(createHash);\n\t\t}\n\t\tcase \"oslo\":\n\t\t\treturn new OsloHasher();\n\t}\n}\n\nconst encoder = new TextEncoder();\n\nexport async function sha256Hex(data: Uint8Array | string): Promise<string> {\n\tconst bytes = typeof data === \"string\" ? encoder.encode(data) : data;\n\tconst hasher = await createSha256();\n\thasher.update(bytes);\n\treturn hasher.digest();\n}\n\n/** `\"sha256:\" + hex(sha256(utf8(canonicalJson(value))))`. */\nexport async function canonicalDigest(value: unknown): Promise<Sha256Digest> {\n\treturn toSha256Digest(await sha256Hex(canonicalJson(value)));\n}\n\n/** Hex SHA-256 of a record's canonical JSON (its NDJSON line without the newline). */\nexport async function recordSha256(record: unknown): Promise<string> {\n\treturn sha256Hex(canonicalJson(record));\n}\n\nexport function packageDigest(manifest: unknown): Promise<Sha256Digest> {\n\treturn canonicalDigest(manifest);\n}\n\nexport function planDigest(plan: unknown): Promise<Sha256Digest> {\n\treturn canonicalDigest(plan);\n}\n\n/** Digest over a receipt without its own `receiptDigest` property. */\nexport function receiptDigest(receipt: Record<string, unknown>): Promise<Sha256Digest> {\n\tconst { receiptDigest: _ignored, ...rest } = receipt;\n\treturn canonicalDigest(rest);\n}\n\n/** Hex logical hash of one record chunk from its `[id, recordSha256]` pairs in chunk order. */\nexport async function chunkLogicalSha256(\n\trecords: ReadonlyArray<readonly [id: string, recordSha256: string]>,\n): Promise<string> {\n\tfor (const [, sha] of records) {\n\t\tif (!isSha256Hex(sha)) throw new TypeError(\"Expected a lowercase hex SHA-256\");\n\t}\n\treturn sha256Hex(canonicalJson(records.map(([id, sha]) => [id, sha])));\n}\n\n/** `logicalDigest` from `[kind, seq, chunkLogicalSha256]` tuples in package order. */\nexport async function logicalDigest(\n\tchunks: ReadonlyArray<readonly [kind: string, seq: number, chunkLogicalSha256: string]>,\n): Promise<Sha256Digest> {\n\tfor (const [, , sha] of chunks) {\n\t\tif (!isSha256Hex(sha)) throw new TypeError(\"Expected a lowercase hex SHA-256\");\n\t}\n\treturn canonicalDigest(chunks.map(([kind, seq, sha]) => [kind, seq, sha]));\n}\n\n/**\n * Pass-through stream that feeds every chunk to `hasher` and counts bytes.\n * Throws inside the stream as soon as more than `maxBytes` flow through.\n */\nexport function createHashingStream(\n\thasher: Sha256Hasher,\n\toptions: { maxBytes?: number; onLimitExceeded?: () => unknown } = {},\n): { stream: TransformStream<Uint8Array, Uint8Array>; bytes: () => number } {\n\tlet total = 0;\n\tconst stream = new TransformStream<Uint8Array, Uint8Array>({\n\t\ttransform(chunk, controller) {\n\t\t\ttotal += chunk.byteLength;\n\t\t\tif (options.maxBytes !== undefined && total > options.maxBytes) {\n\t\t\t\tthrow options.onLimitExceeded?.() ?? new RangeError(\"Stream exceeded its declared size\");\n\t\t\t}\n\t\t\thasher.update(chunk);\n\t\t\tcontroller.enqueue(chunk);\n\t\t},\n\t});\n\treturn { stream, bytes: () => total };\n}\n"],"mappings":"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"}

package/dist/direct-executor-5T8gkhvA.mjs

@@ -0,0 +1,117 @@
+import { l as runMigrations, o as getExactMigrationStatus } from "./runner-CLorw5vo.mjs";
+import { armMigrationLockTakeOver, clearMigrationLock, readMigrationLock } from "./database/migration-lock.mjs";
+import { d as setI18nConfig, r as getI18nConfig } from "./config-Cs_AwWXI.mjs";
+import { r as getCoreMigrationIdentity } from "./identity-BivQ8wkV.mjs";
+import { Kysely } from "kysely";
+
+//#region src/migrations/direct-executor.ts
+const LOCK_ID_PATTERN = /^[1-9]\d{0,15}$/;
+function createReport(target, status, executed, lockHeldSince = null) {
+	const report = {
+		target,
+		knownApplied: [...status.knownApplied],
+		pending: [...status.pending],
+		unknownApplied: [...status.unknownApplied],
+		executed: [...executed]
+	};
+	if (lockHeldSince !== null) report.lock = {
+		id: String(lockHeldSince),
+		heldSince: new Date(lockHeldSince).toISOString()
+	};
+	return report;
+}
+function confirmedLockId(lockId) {
+	if (!lockId || !LOCK_ID_PATTERN.test(lockId)) throw new Error("The migration lock id must be the one reported by status.");
+	return Number(lockId);
+}
+function lockMismatchError(current) {
+	return /* @__PURE__ */ new Error(current === null ? "The migration lock is not held." : "The migration lock has a different id now. Check the status again.");
+}
+async function releaseLock(db, lockId) {
+	const lock = confirmedLockId(lockId);
+	const heldSince = await readMigrationLock(db);
+	if (heldSince === lock && await clearMigrationLock(db, lock)) return;
+	throw lockMismatchError(heldSince === lock ? await readMigrationLock(db) : heldSince);
+}
+async function takeOverLock(db, lockId, pending) {
+	const lock = confirmedLockId(lockId);
+	if (!pending) return releaseLock(db, lockId);
+	const heldSince = await readMigrationLock(db);
+	if (heldSince !== lock) throw lockMismatchError(heldSince);
+	if (!armMigrationLockTakeOver(db, lock)) await releaseLock(db, lockId);
+}
+async function verifyRequest(request) {
+	const identity = await getCoreMigrationIdentity();
+	if (request.artifact.emdashVersion !== identity.emdashVersion || request.artifact.migrationSetFingerprint !== identity.fingerprint) throw new Error("Migration artifact does not match the loaded EmDash version and migration registry.");
+}
+async function executeRequest(db, target, request) {
+	const initialStatus = await getExactMigrationStatus(db);
+	if (request.action === "check") return createReport(target, initialStatus, [], await readMigrationLock(db));
+	if (request.action === "release-lock") {
+		await releaseLock(db, request.lockId);
+		return createReport(target, initialStatus, []);
+	}
+	if (initialStatus.unknownApplied.length > 0) throw new Error(`Cannot apply migrations with unknown applied migrations: ${initialStatus.unknownApplied.join(", ")}`);
+	if (request.action === "take-over-lock") await takeOverLock(db, request.lockId, initialStatus.pending.length > 0);
+	if (initialStatus.pending.length === 0) return createReport(target, initialStatus, []);
+	const result = await runMigrations(db);
+	return createReport(target, await getExactMigrationStatus(db), result.applied);
+}
+function createDirectMigrationExecutor(options) {
+	const target = Object.freeze({ ...options.target });
+	let used = false;
+	let disposed = false;
+	let activeDb;
+	let closePromise;
+	const closeActiveDb = () => {
+		if (!activeDb) return Promise.resolve();
+		closePromise ??= activeDb.destroy();
+		return closePromise;
+	};
+	return {
+		target,
+		async execute(request) {
+			if (disposed) throw new Error("Migration executor has been disposed.");
+			if (used) throw new Error("Migration executors are single-use.");
+			used = true;
+			if (request.action !== "check" && request.action !== "apply" && request.action !== "release-lock" && request.action !== "take-over-lock") throw new Error("Unsupported migration action.");
+			await verifyRequest(request);
+			const db = new Kysely({ dialect: await options.createDialect() });
+			activeDb = db;
+			if (disposed) {
+				await closeActiveDb();
+				throw new Error("Migration executor has been disposed.");
+			}
+			const previousI18n = getI18nConfig();
+			let executionFailed = false;
+			let executionError;
+			let report;
+			setI18nConfig(request.i18n);
+			try {
+				report = await executeRequest(db, target, request);
+			} catch (error) {
+				executionFailed = true;
+				executionError = error;
+			} finally {
+				setI18nConfig(previousI18n);
+				try {
+					await closeActiveDb();
+				} catch {
+					console.error("[migrations] Database close failed.");
+					closePromise = Promise.resolve();
+				}
+			}
+			if (executionFailed) throw executionError;
+			if (!report) throw new Error("Migration execution did not produce a report.");
+			return report;
+		},
+		dispose() {
+			disposed = true;
+			return closeActiveDb();
+		}
+	};
+}
+
+//#endregion
+export { createDirectMigrationExecutor as t };
+//# sourceMappingURL=direct-executor-5T8gkhvA.mjs.map

package/dist/direct-executor-5T8gkhvA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-executor-5T8gkhvA.mjs","names":[],"sources":["../src/migrations/direct-executor.ts"],"sourcesContent":["import { type Dialect, Kysely } from \"kysely\";\n\nimport {\n\tarmMigrationLockTakeOver,\n\tclearMigrationLock,\n\treadMigrationLock,\n} from \"../database/migration-lock.js\";\nimport {\n\tgetExactMigrationStatus,\n\trunMigrations,\n\ttype ExactMigrationStatus,\n} from \"../database/migrations/runner.js\";\nimport type { Database } from \"../database/types.js\";\nimport { getI18nConfig, setI18nConfig } from \"../i18n/config.js\";\nimport { getCoreMigrationIdentity } from \"./identity.js\";\nimport type {\n\tMigrationExecutor,\n\tMigrationReport,\n\tMigrationRequest,\n\tMigrationTarget,\n} from \"./protocol.js\";\n\nexport interface DirectMigrationExecutorOptions {\n\ttarget: MigrationTarget;\n\tcreateDialect: () => Dialect | Promise<Dialect>;\n}\n\nconst LOCK_ID_PATTERN = /^[1-9]\\d{0,15}$/;\n\nfunction createReport(\n\ttarget: MigrationTarget,\n\tstatus: ExactMigrationStatus,\n\texecuted: readonly string[],\n\tlockHeldSince: number | null = null,\n): MigrationReport {\n\tconst report: MigrationReport = {\n\t\ttarget,\n\t\tknownApplied: [...status.knownApplied],\n\t\tpending: [...status.pending],\n\t\tunknownApplied: [...status.unknownApplied],\n\t\texecuted: [...executed],\n\t};\n\tif (lockHeldSince !== null) {\n\t\treport.lock = {\n\t\t\tid: String(lockHeldSince),\n\t\t\theldSince: new Date(lockHeldSince).toISOString(),\n\t\t};\n\t}\n\treturn report;\n}\n\nfunction confirmedLockId(lockId: string | undefined): number {\n\tif (!lockId || !LOCK_ID_PATTERN.test(lockId)) {\n\t\tthrow new Error(\"The migration lock id must be the one reported by status.\");\n\t}\n\treturn Number(lockId);\n}\n\nfunction lockMismatchError(current: number | null): Error {\n\t// No lock ids here: the CLI's redaction can rewrite digits that match an\n\t// environment value.\n\treturn new Error(\n\t\tcurrent === null\n\t\t\t? \"The migration lock is not held.\"\n\t\t\t: \"The migration lock has a different id now. Check the status again.\",\n\t);\n}\n\nasync function releaseLock(db: Kysely<Database>, lockId: string | undefined): Promise<void> {\n\tconst lock = confirmedLockId(lockId);\n\t// Read before writing: on Postgres the lock column is a 32-bit integer that\n\t// a lock id does not fit, and no Postgres lock is ever held in it.\n\tconst heldSince = await readMigrationLock(db);\n\tif (heldSince === lock && (await clearMigrationLock(db, lock))) return;\n\tthrow lockMismatchError(heldSince === lock ? await readMigrationLock(db) : heldSince);\n}\n\nasync function takeOverLock(\n\tdb: Kysely<Database>,\n\tlockId: string | undefined,\n\tpending: boolean,\n): Promise<void> {\n\tconst lock = confirmedLockId(lockId);\n\t// With nothing pending no run takes the lock, so releasing it is enough.\n\tif (!pending) return releaseLock(db, lockId);\n\tconst heldSince = await readMigrationLock(db);\n\tif (heldSince !== lock) throw lockMismatchError(heldSince);\n\t// No run on this database takes the lock in its row, so nothing can claim\n\t// it between the release and this run.\n\tif (!armMigrationLockTakeOver(db, lock)) await releaseLock(db, lockId);\n}\n\nasync function verifyRequest(request: MigrationRequest): Promise<void> {\n\tconst identity = await getCoreMigrationIdentity();\n\tif (\n\t\trequest.artifact.emdashVersion !== identity.emdashVersion ||\n\t\trequest.artifact.migrationSetFingerprint !== identity.fingerprint\n\t) {\n\t\tthrow new Error(\n\t\t\t\"Migration artifact does not match the loaded EmDash version and migration registry.\",\n\t\t);\n\t}\n}\n\nasync function executeRequest(\n\tdb: Kysely<Database>,\n\ttarget: MigrationTarget,\n\trequest: MigrationRequest,\n): Promise<MigrationReport> {\n\tconst initialStatus = await getExactMigrationStatus(db);\n\tif (request.action === \"check\") {\n\t\treturn createReport(target, initialStatus, [], await readMigrationLock(db));\n\t}\n\tif (request.action === \"release-lock\") {\n\t\tawait releaseLock(db, request.lockId);\n\t\treturn createReport(target, initialStatus, []);\n\t}\n\n\tif (initialStatus.unknownApplied.length > 0) {\n\t\tthrow new Error(\n\t\t\t`Cannot apply migrations with unknown applied migrations: ${initialStatus.unknownApplied.join(\", \")}`,\n\t\t);\n\t}\n\tif (request.action === \"take-over-lock\") {\n\t\tawait takeOverLock(db, request.lockId, initialStatus.pending.length > 0);\n\t}\n\tif (initialStatus.pending.length === 0) {\n\t\treturn createReport(target, initialStatus, []);\n\t}\n\n\tconst result = await runMigrations(db);\n\tconst finalStatus = await getExactMigrationStatus(db);\n\treturn createReport(target, finalStatus, result.applied);\n}\n\nexport function createDirectMigrationExecutor(\n\toptions: DirectMigrationExecutorOptions,\n): MigrationExecutor {\n\tconst target = Object.freeze({ ...options.target });\n\tlet used = false;\n\tlet disposed = false;\n\tlet activeDb: Kysely<Database> | undefined;\n\tlet closePromise: Promise<void> | undefined;\n\n\tconst closeActiveDb = (): Promise<void> => {\n\t\tif (!activeDb) return Promise.resolve();\n\t\tclosePromise ??= activeDb.destroy();\n\t\treturn closePromise;\n\t};\n\n\treturn {\n\t\ttarget,\n\t\tasync execute(request) {\n\t\t\tif (disposed) {\n\t\t\t\tthrow new Error(\"Migration executor has been disposed.\");\n\t\t\t}\n\t\t\tif (used) {\n\t\t\t\tthrow new Error(\"Migration executors are single-use.\");\n\t\t\t}\n\t\t\tused = true;\n\n\t\t\tif (\n\t\t\t\trequest.action !== \"check\" &&\n\t\t\t\trequest.action !== \"apply\" &&\n\t\t\t\trequest.action !== \"release-lock\" &&\n\t\t\t\trequest.action !== \"take-over-lock\"\n\t\t\t) {\n\t\t\t\tthrow new Error(\"Unsupported migration action.\");\n\t\t\t}\n\t\t\tawait verifyRequest(request);\n\n\t\t\tconst dialect = await options.createDialect();\n\t\t\tconst db = new Kysely<Database>({ dialect });\n\t\t\tactiveDb = db;\n\t\t\tif (disposed) {\n\t\t\t\tawait closeActiveDb();\n\t\t\t\tthrow new Error(\"Migration executor has been disposed.\");\n\t\t\t}\n\t\t\tconst previousI18n = getI18nConfig();\n\t\t\tlet executionFailed = false;\n\t\t\tlet executionError: unknown;\n\t\t\tlet report: MigrationReport | undefined;\n\t\t\tsetI18nConfig(request.i18n);\n\n\t\t\ttry {\n\t\t\t\treport = await executeRequest(db, target, request);\n\t\t\t} catch (error) {\n\t\t\t\texecutionFailed = true;\n\t\t\t\texecutionError = error;\n\t\t\t} finally {\n\t\t\t\tsetI18nConfig(previousI18n);\n\t\t\t\ttry {\n\t\t\t\t\tawait closeActiveDb();\n\t\t\t\t} catch {\n\t\t\t\t\tconsole.error(\"[migrations] Database close failed.\");\n\t\t\t\t\tclosePromise = Promise.resolve();\n\t\t\t\t}\n\t\t\t}\n\n\t\t\tif (executionFailed) throw executionError;\n\t\t\tif (!report) throw new Error(\"Migration execution did not produce a report.\");\n\t\t\treturn report;\n\t\t},\n\t\tdispose() {\n\t\t\tdisposed = true;\n\t\t\treturn closeActiveDb();\n\t\t},\n\t};\n}\n"],"mappings":"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"}