@phtngyn/cms 0.1.0-beta.4 → 0.2.0-beta.1

package/src/Content.js

@@ -0,0 +1,291 @@
+import { a as ContentSource, i as ContentSnapshot, n as ContentApplyResult, r as ContentPlan } from "./ContentTransfer-CTzGGKFV.js";
+import { t as CMS_AUTHENTICATION_PATH, u as STUDIO_API_PATH } from "./HttpPaths-c9nLZ9H2.js";
+import { Result, Schema } from "effect";
+import { createHash } from "node:crypto";
+import { mkdir, readFile, readdir, writeFile } from "node:fs/promises";
+import { dirname, extname, relative, resolve, sep } from "node:path";
+
+//#region src/Content.ts
+var CmsContentError = class extends Error {
+	code;
+	conflicts;
+	issues;
+	constructor(code, message, options = {}) {
+		super(message, options.cause === void 0 ? void 0 : { cause: options.cause });
+		this.name = "CmsContentError";
+		this.code = code;
+		this.conflicts = options.conflicts;
+		this.issues = options.issues;
+	}
+};
+const plans = /* @__PURE__ */ new WeakMap();
+function createCmsContentClient(options) {
+	const baseUrl = contentBaseUrl(options.baseUrl);
+	const requestFetch = options.fetch ?? globalThis.fetch;
+	const identity = {};
+	let cookie;
+	const authenticate = async () => {
+		if (cookie) return cookie;
+		cookie = request(requestFetch, new URL(`${CMS_AUTHENTICATION_PATH}/sign-in/email`, baseUrl), {
+			method: "POST",
+			headers: {
+				accept: "application/json",
+				"content-type": "application/json",
+				origin: baseUrl.origin
+			},
+			body: JSON.stringify(options.credentials)
+		}).then(async (response) => {
+			if (!response.ok) throw new CmsContentError("authentication-required", `CMS sign-in failed (${response.status}).`);
+			const value = response.headers.get("set-cookie")?.split(";", 1)[0];
+			if (!value) throw new CmsContentError("authentication-required", "CMS sign-in did not return a session cookie.");
+			return value;
+		});
+		return cookie;
+	};
+	const contentRequest = async (path, schema, label, body) => {
+		const session = await authenticate();
+		const response = await request(requestFetch, new URL(`${STUDIO_API_PATH}/content/${path}`, baseUrl), {
+			method: body === void 0 ? "GET" : "POST",
+			headers: {
+				accept: "application/json",
+				cookie: session,
+				...body === void 0 ? void 0 : { "content-type": "application/json" }
+			},
+			...body === void 0 ? void 0 : { body: JSON.stringify(body) }
+		});
+		if (!response.ok) {
+			if (response.status === 401 || response.status === 403) throw new CmsContentError("authentication-required", `CMS content request was rejected (${response.status}).`);
+			if (response.status === 409) throw new CmsContentError("generation-changed", "The CMS changed after this content plan was created.");
+			throw new CmsContentError("network-error", `CMS content request failed (${response.status}).`);
+		}
+		let payload;
+		try {
+			payload = await response.json();
+		} catch (cause) {
+			throw new CmsContentError("invalid-response", "CMS returned an invalid JSON response.", { cause });
+		}
+		return decode(schema, payload, label);
+	};
+	const snapshot = async () => contentRequest("snapshot", ContentSnapshot, "content snapshot");
+	return {
+		plan: async (source, authoredOptions = {}) => {
+			const input = {
+				sources: source.sources,
+				overwrite: authoredOptions.overwrite ?? false,
+				publish: authoredOptions.publish ?? false
+			};
+			const [protocol, current] = await Promise.all([contentRequest("plan", ContentPlan, "content plan", input), snapshot()]);
+			const sourcePaths = new Set(source.sources.map((entry) => entry.sourcePath));
+			const entries = (action) => protocol.entries.filter((entry) => entry.action === action);
+			const plan = Object.freeze({
+				generation: protocol.generation,
+				creates: entries("create"),
+				updates: entries("update"),
+				publications: entries("publish"),
+				conflicts: entries("conflict"),
+				unchanged: entries("unchanged"),
+				issues: protocol.issues,
+				targetOnly: current.sources.filter((entry) => !sourcePaths.has(entry.sourcePath)),
+				valid: protocol.valid
+			});
+			plans.set(plan, {
+				client: identity,
+				input,
+				protocol
+			});
+			return plan;
+		},
+		apply: async (plan) => {
+			const state = plans.get(plan);
+			if (!state || state.client !== identity) throw new CmsContentError("content-conflict", "This content plan was not created by this client.");
+			if (!plan.valid) throw new CmsContentError("content-conflict", "The content plan is not valid.", {
+				conflicts: plan.conflicts,
+				issues: plan.issues
+			});
+			if (plan.conflicts.length) throw new CmsContentError("content-conflict", "The content plan contains conflicts.", { conflicts: plan.conflicts });
+			if (plan.issues.length) throw new CmsContentError("invalid-document", "The content plan contains invalid documents.", { issues: plan.issues });
+			return contentRequest("apply", ContentApplyResult, "content apply result", {
+				...state.input,
+				expectedGeneration: state.protocol.generation
+			});
+		},
+		diff: async (source) => diffSources(source.sources, (await snapshot()).sources),
+		export: async ({ directory }) => {
+			const value = await snapshot();
+			await writeContentDirectory(directory, value.sources);
+			return { sources: value.sources };
+		},
+		readDocument: async (documentId) => {
+			const document = (await snapshot()).sources.find((source) => source.documentId === documentId);
+			if (!document) throw new CmsContentError("document-not-found", `CMS document ${documentId} was not found.`);
+			return document;
+		}
+	};
+}
+async function readCmsContentDirectory(directory) {
+	try {
+		const root = resolve(directory);
+		const indexPath = resolve(root, ".cms-content.json");
+		let index;
+		try {
+			index = parseIndex(await readFile(indexPath, "utf8"));
+		} catch (cause) {
+			if (!isMissingFile(cause)) throw cause;
+		}
+		if (index) return { sources: await Promise.all(index.sources.map(async (entry) => decode(ContentSource, {
+			sourcePath: entry.sourcePath,
+			markdown: await readFile(safeContentPath(root, entry.sourcePath), "utf8"),
+			published: entry.published
+		}, "content source"))) };
+		const files = await markdownFiles(root);
+		if (!files.length) throw new CmsContentError("filesystem-error", `No Markdown files found in ${root}.`);
+		return { sources: await Promise.all(files.map(async (file) => decode(ContentSource, {
+			sourcePath: relative(root, file).replaceAll("\\", "/"),
+			markdown: await readFile(file, "utf8"),
+			published: true
+		}, "content source"))) };
+	} catch (cause) {
+		if (cause instanceof CmsContentError) throw cause;
+		throw new CmsContentError("filesystem-error", `Could not read CMS content from ${directory}.`, { cause });
+	}
+}
+function diffCmsContentSources(local, target) {
+	return diffSources(local, target);
+}
+const ContentHash = Schema.String.check(Schema.isPattern(/^[a-f0-9]{64}$/u));
+const ContentIndexEntry = Schema.Struct({
+	sourcePath: ContentSource.fields.sourcePath,
+	published: Schema.Boolean,
+	sha256: ContentHash
+});
+const ContentIndex = Schema.Struct({
+	version: Schema.Literal(1),
+	sources: Schema.Array(ContentIndexEntry),
+	exportSha256: ContentHash
+});
+async function writeContentDirectory(directory, sources) {
+	try {
+		const root = resolve(directory);
+		let previous;
+		try {
+			previous = parseIndex(await readFile(resolve(root, ".cms-content.json"), "utf8"));
+		} catch (cause) {
+			if (!isMissingFile(cause)) throw cause;
+		}
+		if (previous) {
+			const metadata = {
+				version: previous.version,
+				sources: previous.sources
+			};
+			if (sha256(JSON.stringify(metadata)) !== previous.exportSha256) throw new CmsContentError("filesystem-error", "The local .cms-content.json file has been edited.");
+			const previousByPath = new Map(previous.sources.map((entry) => [entry.sourcePath, entry]));
+			const incomingPaths = new Set(sources.map((source) => source.sourcePath));
+			for (const entry of previous.sources) if (!incomingPaths.has(entry.sourcePath)) throw new CmsContentError("filesystem-error", `CMS document ${entry.sourcePath} no longer exists; resolve the local file before exporting again.`);
+			for (const source of sources) try {
+				const local = await readFile(safeContentPath(root, source.sourcePath), "utf8");
+				const before = previousByPath.get(source.sourcePath);
+				if (before ? sha256(local) !== before.sha256 : local !== source.markdown) throw new CmsContentError("filesystem-error", `Local edits in ${source.sourcePath}; export was stopped.`);
+			} catch (cause) {
+				if (!isMissingFile(cause)) throw cause;
+			}
+		}
+		await mkdir(root, { recursive: true });
+		const entries = [];
+		for (const source of sources) {
+			const file = safeContentPath(root, source.sourcePath);
+			await mkdir(dirname(file), { recursive: true });
+			await writeFile(file, source.markdown);
+			entries.push({
+				sourcePath: source.sourcePath,
+				published: source.published,
+				sha256: sha256(source.markdown)
+			});
+		}
+		const metadata = {
+			version: 1,
+			sources: entries
+		};
+		const index = {
+			...metadata,
+			exportSha256: sha256(JSON.stringify(metadata))
+		};
+		await writeFile(resolve(root, ".cms-content.json"), `${JSON.stringify(index, void 0, 2)}\n`);
+	} catch (cause) {
+		throw new CmsContentError("filesystem-error", `Could not export CMS content to ${directory}.`, { cause });
+	}
+}
+function diffSources(local, target) {
+	const targetByPath = new Map(target.map((source) => [source.sourcePath, source]));
+	const localPaths = new Set(local.map((source) => source.sourcePath));
+	return {
+		changes: local.flatMap((source) => {
+			const current = targetByPath.get(source.sourcePath);
+			const markdownChanged = current?.markdown !== source.markdown;
+			const publicationChanged = current !== void 0 && current.published !== source.published;
+			return markdownChanged || publicationChanged ? [{
+				sourcePath: source.sourcePath,
+				local: source,
+				target: current,
+				markdownChanged,
+				publicationChanged
+			}] : [];
+		}),
+		targetOnly: target.filter((source) => !localPaths.has(source.sourcePath))
+	};
+}
+async function markdownFiles(directory) {
+	const entries = await readdir(directory, { withFileTypes: true });
+	return (await Promise.all(entries.map(async (entry) => {
+		const path = resolve(directory, entry.name);
+		if (entry.isDirectory()) return markdownFiles(path);
+		return entry.isFile() && [".md", ".mdc"].includes(extname(path)) ? [path] : [];
+	}))).flat().sort((left, right) => left.localeCompare(right));
+}
+function safeContentPath(root, sourcePath) {
+	const path = resolve(root, sourcePath);
+	if (!path.startsWith(`${root}${sep}`)) throw new CmsContentError("filesystem-error", `Unsafe content path: ${sourcePath}`);
+	return path;
+}
+function contentBaseUrl(value) {
+	let url;
+	try {
+		url = new URL(value);
+	} catch (cause) {
+		throw new CmsContentError("network-error", "CMS baseUrl is invalid.", { cause });
+	}
+	if (url.username || url.password || url.search || url.hash) throw new CmsContentError("network-error", "CMS baseUrl must be an origin without credentials, query, or fragment.");
+	if (url.protocol !== "https:" && !(url.protocol === "http:" && [
+		"localhost",
+		"127.0.0.1",
+		"[::1]"
+	].includes(url.hostname))) throw new CmsContentError("network-error", "Use HTTPS for CMS credentials; HTTP is allowed only on localhost.");
+	return new URL(url.origin);
+}
+async function request(fetch, input, init) {
+	try {
+		return await fetch(input, init);
+	} catch (cause) {
+		throw new CmsContentError("network-error", `Could not reach ${input.origin}.`, { cause });
+	}
+}
+function decode(schema, value, label) {
+	const decoded = Schema.decodeUnknownResult(schema)(value);
+	if (Result.isFailure(decoded)) throw new CmsContentError("invalid-response", `CMS returned an invalid ${label}.`, { cause: decoded.failure });
+	return decoded.success;
+}
+function sha256(value) {
+	return createHash("sha256").update(value).digest("hex");
+}
+function parseIndex(value) {
+	const decoded = Schema.decodeUnknownResult(ContentIndex)(JSON.parse(value));
+	if (Result.isFailure(decoded)) throw new CmsContentError("filesystem-error", "The .cms-content.json index is invalid.");
+	if (new Set(decoded.success.sources.map((entry) => entry.sourcePath)).size !== decoded.success.sources.length) throw new CmsContentError("filesystem-error", "The .cms-content.json index contains duplicate source paths.");
+	return decoded.success;
+}
+function isMissingFile(cause) {
+	return cause instanceof Error && "code" in cause && cause.code === "ENOENT";
+}
+
+//#endregion
+export { CmsContentError, createCmsContentClient, diffCmsContentSources, readCmsContentDirectory };
+//# sourceMappingURL=Content.js.map

package/src/Content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Content.js","names":["ContentSnapshotSchema","ProtocolContentPlanSchema","ContentApplyResultSchema","ContentSourceSchema"],"sources":["../../../src/Content.ts"],"sourcesContent":["/* oxlint-disable effecttsgo/async-function effecttsgo/extends-native-error effecttsgo/node-builtin-import -- This public Node-only API deliberately exposes Promises, native filesystem paths, and an Error subclass to ordinary deployment scripts. */\nimport type {\n  ContentApplyResult,\n  ContentPlan as ProtocolContentPlan,\n  ContentPlanEntry,\n  ContentSnapshotSource,\n  ContentSource,\n  ContentSnapshot,\n} from '@internal/protocol/ContentTransfer'\nimport {\n  ContentApplyResult as ContentApplyResultSchema,\n  ContentPlan as ProtocolContentPlanSchema,\n  ContentSource as ContentSourceSchema,\n  ContentSnapshot as ContentSnapshotSchema,\n} from '@internal/protocol/ContentTransfer'\nimport type { DocumentIssue } from '@internal/protocol/Documents'\nimport { CMS_AUTHENTICATION_PATH, STUDIO_API_PATH } from '@internal/protocol/HttpPaths'\nimport { Result, Schema } from 'effect'\nimport { createHash } from 'node:crypto'\nimport { readdir, readFile, mkdir, writeFile } from 'node:fs/promises'\nimport { dirname, extname, relative, resolve, sep } from 'node:path'\n\nexport type CmsContentErrorCode =\n  | 'authentication-required'\n  | 'content-conflict'\n  | 'filesystem-error'\n  | 'generation-changed'\n  | 'invalid-document'\n  | 'document-not-found'\n  | 'invalid-response'\n  | 'network-error'\n\nexport class CmsContentError extends Error {\n  readonly code: CmsContentErrorCode\n  readonly conflicts?: ReadonlyArray<CmsContentPlanEntry>\n  readonly issues?: ReadonlyArray<DocumentIssue>\n\n  constructor(\n    code: CmsContentErrorCode,\n    message: string,\n    options: {\n      readonly cause?: unknown\n      readonly conflicts?: ReadonlyArray<CmsContentPlanEntry>\n      readonly issues?: ReadonlyArray<DocumentIssue>\n    } = {},\n  ) {\n    super(message, options.cause === undefined ? undefined : { cause: options.cause })\n    this.name = 'CmsContentError'\n    this.code = code\n    this.conflicts = options.conflicts\n    this.issues = options.issues\n  }\n}\n\nexport interface CmsContentCredentials {\n  readonly email: string\n  readonly password: string\n}\n\nexport interface CmsContentClientOptions {\n  readonly baseUrl: string\n  readonly credentials: CmsContentCredentials\n  readonly fetch?: typeof globalThis.fetch\n}\n\nexport interface CmsContentSourceSet {\n  readonly sources: ReadonlyArray<ContentSource>\n}\n\nexport interface CmsContentDocument extends ContentSnapshotSource {}\n\nexport interface CmsContentPlanEntry extends ContentPlanEntry {}\n\nexport interface CmsContentPlan {\n  readonly generation: string\n  readonly creates: ReadonlyArray<CmsContentPlanEntry>\n  readonly updates: ReadonlyArray<CmsContentPlanEntry>\n  readonly publications: ReadonlyArray<CmsContentPlanEntry>\n  readonly conflicts: ReadonlyArray<CmsContentPlanEntry>\n  readonly unchanged: ReadonlyArray<CmsContentPlanEntry>\n  readonly issues: ReadonlyArray<DocumentIssue>\n  readonly targetOnly: ReadonlyArray<ContentSource>\n  readonly valid: boolean\n}\n\nexport interface CmsContentImportOptions {\n  readonly overwrite?: boolean\n  readonly publish?: boolean\n}\n\nexport interface CmsContentDiff {\n  readonly changes: ReadonlyArray<{\n    readonly sourcePath: string\n    readonly local?: ContentSource\n    readonly target?: ContentSource\n    readonly markdownChanged: boolean\n    readonly publicationChanged: boolean\n  }>\n  readonly targetOnly: ReadonlyArray<ContentSource>\n}\n\nexport interface CmsContentClient {\n  readonly plan: (source: CmsContentSourceSet, options?: CmsContentImportOptions) => Promise<CmsContentPlan>\n  readonly apply: (plan: CmsContentPlan) => Promise<ContentApplyResult>\n  readonly diff: (source: CmsContentSourceSet) => Promise<CmsContentDiff>\n  readonly export: (options: { readonly directory: string }) => Promise<CmsContentSourceSet>\n  readonly readDocument: (documentId: string) => Promise<CmsContentDocument>\n}\n\ninterface PlanState {\n  readonly client: object\n  readonly input: {\n    readonly sources: ReadonlyArray<ContentSource>\n    readonly overwrite: boolean\n    readonly publish: boolean\n  }\n  readonly protocol: ProtocolContentPlan\n}\n\ntype CmsContentRequestBody =\n  | PlanState['input']\n  | (PlanState['input'] & { readonly expectedGeneration: ProtocolContentPlan['generation'] })\n\nconst plans = new WeakMap<CmsContentPlan, PlanState>()\n\nexport function createCmsContentClient(options: CmsContentClientOptions): CmsContentClient {\n  const baseUrl = contentBaseUrl(options.baseUrl)\n  const requestFetch = options.fetch ?? globalThis.fetch\n  const identity = {}\n  let cookie: Promise<string> | undefined\n\n  const authenticate = async (): Promise<string> => {\n    if (cookie) return cookie\n\n    cookie = request(requestFetch, new URL(`${CMS_AUTHENTICATION_PATH}/sign-in/email`, baseUrl), {\n      method: 'POST',\n      headers: { accept: 'application/json', 'content-type': 'application/json', origin: baseUrl.origin },\n      body: JSON.stringify(options.credentials),\n    }).then(async (response) => {\n      if (!response.ok) throw new CmsContentError('authentication-required', `CMS sign-in failed (${response.status}).`)\n      const value = response.headers.get('set-cookie')?.split(';', 1)[0]\n\n      if (!value) throw new CmsContentError('authentication-required', 'CMS sign-in did not return a session cookie.')\n\n      return value\n    })\n\n    return cookie\n  }\n\n  const contentRequest = async <SchemaType extends Schema.ConstraintDecoder<unknown>>(\n    path: string,\n    schema: SchemaType,\n    label: string,\n    body?: CmsContentRequestBody,\n  ): Promise<SchemaType['Type']> => {\n    const session = await authenticate()\n\n    const response = await request(requestFetch, new URL(`${STUDIO_API_PATH}/content/${path}`, baseUrl), {\n      method: body === undefined ? 'GET' : 'POST',\n      headers: {\n        accept: 'application/json',\n        cookie: session,\n        ...(body === undefined ? undefined : { 'content-type': 'application/json' }),\n      },\n      ...(body === undefined ? undefined : { body: JSON.stringify(body) }),\n    })\n\n    if (!response.ok) {\n      if (response.status === 401 || response.status === 403)\n        throw new CmsContentError('authentication-required', `CMS content request was rejected (${response.status}).`)\n\n      if (response.status === 409)\n        throw new CmsContentError('generation-changed', 'The CMS changed after this content plan was created.')\n\n      throw new CmsContentError('network-error', `CMS content request failed (${response.status}).`)\n    }\n\n    let payload: unknown\n\n    try {\n      payload = await response.json()\n    } catch (cause) {\n      throw new CmsContentError('invalid-response', 'CMS returned an invalid JSON response.', { cause })\n    }\n\n    return decode(schema, payload, label)\n  }\n\n  const snapshot = async (): Promise<ContentSnapshot> =>\n    contentRequest('snapshot', ContentSnapshotSchema, 'content snapshot')\n\n  const client: CmsContentClient = {\n    plan: async (source, authoredOptions = {}) => {\n      const input = {\n        sources: source.sources,\n        overwrite: authoredOptions.overwrite ?? false,\n        publish: authoredOptions.publish ?? false,\n      }\n\n      const [protocol, current] = await Promise.all([\n        contentRequest('plan', ProtocolContentPlanSchema, 'content plan', input),\n        snapshot(),\n      ])\n\n      const sourcePaths = new Set(source.sources.map((entry) => entry.sourcePath))\n\n      const entries = (action: ContentPlanEntry['action']) =>\n        protocol.entries.filter((entry) => entry.action === action)\n\n      const plan: CmsContentPlan = Object.freeze({\n        generation: protocol.generation,\n        creates: entries('create'),\n        updates: entries('update'),\n        publications: entries('publish'),\n        conflicts: entries('conflict'),\n        unchanged: entries('unchanged'),\n        issues: protocol.issues,\n        targetOnly: current.sources.filter((entry) => !sourcePaths.has(entry.sourcePath)),\n        valid: protocol.valid,\n      })\n\n      plans.set(plan, { client: identity, input, protocol })\n\n      return plan\n    },\n    apply: async (plan) => {\n      const state = plans.get(plan)\n\n      if (!state || state.client !== identity)\n        throw new CmsContentError('content-conflict', 'This content plan was not created by this client.')\n\n      if (!plan.valid)\n        throw new CmsContentError('content-conflict', 'The content plan is not valid.', {\n          conflicts: plan.conflicts,\n          issues: plan.issues,\n        })\n\n      if (plan.conflicts.length)\n        throw new CmsContentError('content-conflict', 'The content plan contains conflicts.', {\n          conflicts: plan.conflicts,\n        })\n\n      if (plan.issues.length)\n        throw new CmsContentError('invalid-document', 'The content plan contains invalid documents.', {\n          issues: plan.issues,\n        })\n\n      return contentRequest('apply', ContentApplyResultSchema, 'content apply result', {\n        ...state.input,\n        expectedGeneration: state.protocol.generation,\n      })\n    },\n    diff: async (source) => diffSources(source.sources, (await snapshot()).sources),\n    export: async ({ directory }) => {\n      const value = await snapshot()\n      await writeContentDirectory(directory, value.sources)\n\n      return { sources: value.sources }\n    },\n    readDocument: async (documentId) => {\n      const document = (await snapshot()).sources.find((source) => source.documentId === documentId)\n\n      if (!document) throw new CmsContentError('document-not-found', `CMS document ${documentId} was not found.`)\n\n      return document\n    },\n  }\n\n  return client\n}\n\nexport async function readCmsContentDirectory(directory: string): Promise<CmsContentSourceSet> {\n  try {\n    const root = resolve(directory)\n    const indexPath = resolve(root, '.cms-content.json')\n    let index: ContentIndex | undefined\n\n    try {\n      index = parseIndex(await readFile(indexPath, 'utf8'))\n    } catch (cause) {\n      if (!isMissingFile(cause)) throw cause\n    }\n\n    if (index) {\n      const sources = await Promise.all(\n        index.sources.map(async (entry) =>\n          decode(\n            ContentSourceSchema,\n            {\n              sourcePath: entry.sourcePath,\n              markdown: await readFile(safeContentPath(root, entry.sourcePath), 'utf8'),\n              published: entry.published,\n            },\n            'content source',\n          ),\n        ),\n      )\n\n      return { sources }\n    }\n\n    const files = await markdownFiles(root)\n\n    if (!files.length) throw new CmsContentError('filesystem-error', `No Markdown files found in ${root}.`)\n\n    return {\n      sources: await Promise.all(\n        files.map(async (file) =>\n          decode(\n            ContentSourceSchema,\n            {\n              sourcePath: relative(root, file).replaceAll('\\\\', '/'),\n              markdown: await readFile(file, 'utf8'),\n              published: true,\n            },\n            'content source',\n          ),\n        ),\n      ),\n    }\n  } catch (cause) {\n    if (cause instanceof CmsContentError) throw cause\n    throw new CmsContentError('filesystem-error', `Could not read CMS content from ${directory}.`, { cause })\n  }\n}\n\nexport function diffCmsContentSources(\n  local: ReadonlyArray<ContentSource>,\n  target: ReadonlyArray<ContentSource>,\n): CmsContentDiff {\n  return diffSources(local, target)\n}\n\nconst ContentHash = Schema.String.check(Schema.isPattern(/^[a-f0-9]{64}$/u))\n\nconst ContentIndexEntry = Schema.Struct({\n  sourcePath: ContentSourceSchema.fields.sourcePath,\n  published: Schema.Boolean,\n  sha256: ContentHash,\n})\n\nconst ContentIndex = Schema.Struct({\n  version: Schema.Literal(1),\n  sources: Schema.Array(ContentIndexEntry),\n  exportSha256: ContentHash,\n})\n\ntype ContentIndex = typeof ContentIndex.Type\n\ntype ContentIndexEntry = typeof ContentIndexEntry.Type\n\nasync function writeContentDirectory(directory: string, sources: ReadonlyArray<ContentSource>): Promise<void> {\n  try {\n    const root = resolve(directory)\n    let previous: ContentIndex | undefined\n\n    try {\n      previous = parseIndex(await readFile(resolve(root, '.cms-content.json'), 'utf8'))\n    } catch (cause) {\n      if (!isMissingFile(cause)) throw cause\n    }\n\n    if (previous) {\n      const metadata = { version: previous.version, sources: previous.sources }\n\n      if (sha256(JSON.stringify(metadata)) !== previous.exportSha256)\n        throw new CmsContentError('filesystem-error', 'The local .cms-content.json file has been edited.')\n\n      const previousByPath = new Map(previous.sources.map((entry) => [entry.sourcePath, entry]))\n      const incomingPaths = new Set(sources.map((source) => source.sourcePath))\n\n      for (const entry of previous.sources)\n        if (!incomingPaths.has(entry.sourcePath))\n          throw new CmsContentError(\n            'filesystem-error',\n            `CMS document ${entry.sourcePath} no longer exists; resolve the local file before exporting again.`,\n          )\n\n      for (const source of sources) {\n        try {\n          const local = await readFile(safeContentPath(root, source.sourcePath), 'utf8')\n          const before = previousByPath.get(source.sourcePath)\n\n          if (before ? sha256(local) !== before.sha256 : local !== source.markdown)\n            throw new CmsContentError('filesystem-error', `Local edits in ${source.sourcePath}; export was stopped.`)\n        } catch (cause) {\n          if (!isMissingFile(cause)) throw cause\n        }\n      }\n    }\n\n    await mkdir(root, { recursive: true })\n    const entries: ContentIndexEntry[] = []\n\n    for (const source of sources) {\n      const file = safeContentPath(root, source.sourcePath)\n      await mkdir(dirname(file), { recursive: true })\n      await writeFile(file, source.markdown)\n      entries.push({ sourcePath: source.sourcePath, published: source.published, sha256: sha256(source.markdown) })\n    }\n\n    const metadata = { version: 1 as const, sources: entries }\n    const index: ContentIndex = { ...metadata, exportSha256: sha256(JSON.stringify(metadata)) }\n    await writeFile(resolve(root, '.cms-content.json'), `${JSON.stringify(index, undefined, 2)}\\n`)\n  } catch (cause) {\n    throw new CmsContentError('filesystem-error', `Could not export CMS content to ${directory}.`, { cause })\n  }\n}\n\nfunction diffSources(local: ReadonlyArray<ContentSource>, target: ReadonlyArray<ContentSource>): CmsContentDiff {\n  const targetByPath = new Map(target.map((source) => [source.sourcePath, source]))\n  const localPaths = new Set(local.map((source) => source.sourcePath))\n\n  return {\n    changes: local.flatMap((source) => {\n      const current = targetByPath.get(source.sourcePath)\n      const markdownChanged = current?.markdown !== source.markdown\n      const publicationChanged = current !== undefined && current.published !== source.published\n\n      return markdownChanged || publicationChanged\n        ? [{ sourcePath: source.sourcePath, local: source, target: current, markdownChanged, publicationChanged }]\n        : []\n    }),\n    targetOnly: target.filter((source) => !localPaths.has(source.sourcePath)),\n  }\n}\n\nasync function markdownFiles(directory: string): Promise<ReadonlyArray<string>> {\n  const entries = await readdir(directory, { withFileTypes: true })\n\n  const nested = await Promise.all(\n    entries.map(async (entry) => {\n      const path = resolve(directory, entry.name)\n\n      if (entry.isDirectory()) return markdownFiles(path)\n\n      return entry.isFile() && ['.md', '.mdc'].includes(extname(path)) ? [path] : []\n    }),\n  )\n\n  return nested.flat().sort((left, right) => left.localeCompare(right))\n}\n\nfunction safeContentPath(root: string, sourcePath: string): string {\n  const path = resolve(root, sourcePath)\n\n  if (!path.startsWith(`${root}${sep}`))\n    throw new CmsContentError('filesystem-error', `Unsafe content path: ${sourcePath}`)\n\n  return path\n}\n\nfunction contentBaseUrl(value: string): URL {\n  let url: URL\n\n  try {\n    url = new URL(value)\n  } catch (cause) {\n    throw new CmsContentError('network-error', 'CMS baseUrl is invalid.', { cause })\n  }\n\n  if (url.username || url.password || url.search || url.hash)\n    throw new CmsContentError('network-error', 'CMS baseUrl must be an origin without credentials, query, or fragment.')\n\n  if (\n    url.protocol !== 'https:' &&\n    !(url.protocol === 'http:' && ['localhost', '127.0.0.1', '[::1]'].includes(url.hostname))\n  )\n    throw new CmsContentError('network-error', 'Use HTTPS for CMS credentials; HTTP is allowed only on localhost.')\n\n  return new URL(url.origin)\n}\n\nasync function request(fetch: typeof globalThis.fetch, input: URL, init: RequestInit): Promise<Response> {\n  try {\n    return await fetch(input, init)\n  } catch (cause) {\n    throw new CmsContentError('network-error', `Could not reach ${input.origin}.`, { cause })\n  }\n}\n\n/* oxlint-disable anti-slop/no-unknown-parameters -- Untrusted JSON and filesystem values enter their explicit Schema decoder here. */\nfunction decode<SchemaType extends Schema.ConstraintDecoder<unknown>>(\n  schema: SchemaType,\n  value: unknown,\n  label: string,\n): SchemaType['Type'] {\n  const decoded = Schema.decodeUnknownResult(schema)(value)\n\n  if (Result.isFailure(decoded))\n    throw new CmsContentError('invalid-response', `CMS returned an invalid ${label}.`, { cause: decoded.failure })\n\n  return decoded.success\n}\n/* oxlint-enable anti-slop/no-unknown-parameters */\n\nfunction sha256(value: string): string {\n  return createHash('sha256').update(value).digest('hex')\n}\n\nfunction parseIndex(value: string): ContentIndex {\n  const decoded = Schema.decodeUnknownResult(ContentIndex)(JSON.parse(value))\n\n  if (Result.isFailure(decoded))\n    throw new CmsContentError('filesystem-error', 'The .cms-content.json index is invalid.')\n\n  const sourcePaths = new Set(decoded.success.sources.map((entry) => entry.sourcePath))\n\n  if (sourcePaths.size !== decoded.success.sources.length)\n    throw new CmsContentError('filesystem-error', 'The .cms-content.json index contains duplicate source paths.')\n\n  return decoded.success\n}\n\nfunction isMissingFile(cause: unknown): boolean {\n  return cause instanceof Error && 'code' in cause && cause.code === 'ENOENT'\n}\n\nexport type { ContentApplyResult, ContentSource }\n"],"mappings":"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"}

package/src/ContentTransfer-CRQet3QJ.d.ts

@@ -0,0 +1,48 @@
+import "./scalars-CA6kyipS.js";
+import { Schema } from "effect";
+//#region ../protocol/src/internal/documents/models.d.ts
+declare const DocumentIssue: Schema.Struct<{
+  readonly code: Schema.Literals<readonly ["document.collision", "document.id", "document.invalid", "i18n.missing-translation", "markdown.parse", "reference.document", "reference.component", "seo.invalid", "schema.option", "schema.constraint", "schema.required", "schema.type", "schema.unknown"]>;
+  readonly severity: Schema.Literals<readonly ["error", "warning"]>;
+  readonly message: Schema.NonEmptyString;
+  readonly sourcePath: Schema.optionalKey<Schema.brand<Schema.String, "SourcePath">>;
+  readonly collection: Schema.optionalKey<Schema.brand<Schema.String, "CollectionName">>;
+  readonly field: Schema.optionalKey<Schema.NonEmptyString>;
+  readonly key: Schema.optionalKey<Schema.brand<Schema.String, "PublicPath">>;
+  readonly locale: Schema.optionalKey<Schema.brand<Schema.String, "Locale">>;
+}>;
+interface DocumentIssue extends Schema.Schema.Type<typeof DocumentIssue> {}
+//#endregion
+//#region ../protocol/src/ContentTransfer.d.ts
+declare const ContentSource: Schema.Struct<{
+  readonly sourcePath: Schema.brand<Schema.String, "SourcePath">;
+  readonly markdown: Schema.String;
+  /** True only when this exact authored revision is published. */
+  readonly published: Schema.Boolean;
+}>;
+interface ContentSource extends Schema.Schema.Type<typeof ContentSource> {}
+declare const ContentSnapshotSource: Schema.Struct<{
+  readonly documentId: Schema.brand<Schema.String, "DocumentId">;
+  readonly sourcePath: Schema.brand<Schema.String, "SourcePath">;
+  readonly markdown: Schema.String;
+  /** True only when this exact authored revision is published. */
+  readonly published: Schema.Boolean;
+}>;
+interface ContentSnapshotSource extends Schema.Schema.Type<typeof ContentSnapshotSource> {}
+declare const ContentPlanEntry: Schema.Struct<{
+  readonly sourcePath: Schema.brand<Schema.String, "SourcePath">;
+  readonly action: Schema.Literals<readonly ["create", "update", "publish", "unchanged", "conflict"]>;
+  readonly currentRevisionId: Schema.NullOr<Schema.brand<Schema.String, "RevisionId">>;
+}>;
+interface ContentPlanEntry extends Schema.Schema.Type<typeof ContentPlanEntry> {}
+declare const ContentApplyResult: Schema.Struct<{
+  readonly created: Schema.Int;
+  readonly updated: Schema.Int;
+  readonly published: Schema.Int;
+  readonly unchanged: Schema.Int;
+  readonly generation: Schema.brand<Schema.String, "DocumentGeneration">;
+}>;
+interface ContentApplyResult extends Schema.Schema.Type<typeof ContentApplyResult> {}
+//#endregion
+export { DocumentIssue as a, ContentSource as i, ContentPlanEntry as n, ContentSnapshotSource as r, ContentApplyResult as t };
+//# sourceMappingURL=ContentTransfer-CRQet3QJ.d.ts.map

package/src/{ContentTransfer-C3Av9sWz.js → ContentTransfer-CTzGGKFV.js}

@@ -1,5 +1,5 @@
-import { c as RevisionId, d as SourcePath, t as DocumentGeneration } from "./scalars-B2lgGUnj.js";
-import { c as DocumentIssue } from "./models-Bah5B3bT.js";
+import { c as RevisionId, d as SourcePath, r as DocumentId, t as DocumentGeneration } from "./scalars-B2lgGUnj.js";
+import { c as DocumentIssue } from "./models-DgkGTFus.js";
 import { Schema } from "effect";
 
 //#region ../protocol/src/ContentTransfer.ts
@@ -9,9 +9,13 @@ const ContentSource = Schema.Struct({
 	/** True only when this exact authored revision is published. */
 	published: Schema.Boolean
 });
+const ContentSnapshotSource = Schema.Struct({
+	...ContentSource.fields,
+	documentId: DocumentId
+});
 const ContentSnapshot = Schema.Struct({
 	version: Schema.Literal(1),
-	sources: Schema.Array(ContentSource)
+	sources: Schema.Array(ContentSnapshotSource)
 });
 const ContentTransferInput = Schema.Struct({
 	sources: Schema.Array(ContentSource),
@@ -50,4 +54,4 @@ var ContentTransferConflict = class extends Schema.TaggedError()("Content.Transf
 
 //#endregion
 export { ContentSource as a, ContentSnapshot as i, ContentApplyResult as n, ContentTransferConflict as o, ContentPlan as r, ContentTransferInput as s, ContentApplyInput as t };
-//# sourceMappingURL=ContentTransfer-C3Av9sWz.js.map
+//# sourceMappingURL=ContentTransfer-CTzGGKFV.js.map

package/src/ContentTransfer-CTzGGKFV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentTransfer-CTzGGKFV.js","names":[],"sources":["../../../../protocol/src/ContentTransfer.ts"],"sourcesContent":["import { Schema } from 'effect'\nimport { DocumentGeneration, DocumentId, DocumentIssue, RevisionId, SourcePath } from './Documents'\n\nexport const ContentSource = Schema.Struct({\n  sourcePath: SourcePath,\n  markdown: Schema.String,\n  /** True only when this exact authored revision is published. */\n  published: Schema.Boolean,\n})\n\nexport interface ContentSource extends Schema.Schema.Type<typeof ContentSource> {}\n\nexport const ContentSnapshotSource = Schema.Struct({\n  ...ContentSource.fields,\n  documentId: DocumentId,\n})\n\nexport interface ContentSnapshotSource extends Schema.Schema.Type<typeof ContentSnapshotSource> {}\n\nexport const ContentSnapshot = Schema.Struct({\n  version: Schema.Literal(1),\n  sources: Schema.Array(ContentSnapshotSource),\n})\n\nexport interface ContentSnapshot extends Schema.Schema.Type<typeof ContentSnapshot> {}\n\nexport const ContentTransferInput = Schema.Struct({\n  sources: Schema.Array(ContentSource),\n  overwrite: Schema.Boolean,\n  publish: Schema.Boolean,\n})\n\nexport interface ContentTransferInput extends Schema.Schema.Type<typeof ContentTransferInput> {}\n\nexport const ContentPlanEntry = Schema.Struct({\n  sourcePath: SourcePath,\n  action: Schema.Literals(['create', 'update', 'publish', 'unchanged', 'conflict']),\n  currentRevisionId: Schema.NullOr(RevisionId),\n})\n\nexport interface ContentPlanEntry extends Schema.Schema.Type<typeof ContentPlanEntry> {}\n\nexport const ContentPlan = Schema.Struct({\n  generation: DocumentGeneration,\n  entries: Schema.Array(ContentPlanEntry),\n  issues: Schema.Array(DocumentIssue),\n  valid: Schema.Boolean,\n})\n\nexport interface ContentPlan extends Schema.Schema.Type<typeof ContentPlan> {}\n\nexport const ContentApplyInput = Schema.Struct({\n  ...ContentTransferInput.fields,\n  expectedGeneration: DocumentGeneration,\n})\n\nexport interface ContentApplyInput extends Schema.Schema.Type<typeof ContentApplyInput> {}\n\nexport const ContentApplyResult = Schema.Struct({\n  created: Schema.Int,\n  updated: Schema.Int,\n  published: Schema.Int,\n  unchanged: Schema.Int,\n  generation: DocumentGeneration,\n})\n\nexport interface ContentApplyResult extends Schema.Schema.Type<typeof ContentApplyResult> {}\n\nexport class ContentTransferConflict extends Schema.TaggedError<ContentTransferConflict>()('Content.TransferConflict', {\n  message: Schema.NonEmptyString,\n}) {}\n"],"mappings":";;;;;AAGA,MAAa,gBAAgB,OAAO,OAAO;CACzC,YAAY;CACZ,UAAU,OAAO;;CAEjB,WAAW,OAAO;AACpB,CAAC;AAID,MAAa,wBAAwB,OAAO,OAAO;CACjD,GAAG,cAAc;CACjB,YAAY;AACd,CAAC;AAID,MAAa,kBAAkB,OAAO,OAAO;CAC3C,SAAS,OAAO,QAAQ,CAAC;CACzB,SAAS,OAAO,MAAM,qBAAqB;AAC7C,CAAC;AAID,MAAa,uBAAuB,OAAO,OAAO;CAChD,SAAS,OAAO,MAAM,aAAa;CACnC,WAAW,OAAO;CAClB,SAAS,OAAO;AAClB,CAAC;AAID,MAAa,mBAAmB,OAAO,OAAO;CAC5C,YAAY;CACZ,QAAQ,OAAO,SAAS;EAAC;EAAU;EAAU;EAAW;EAAa;CAAU,CAAC;CAChF,mBAAmB,OAAO,OAAO,UAAU;AAC7C,CAAC;AAID,MAAa,cAAc,OAAO,OAAO;CACvC,YAAY;CACZ,SAAS,OAAO,MAAM,gBAAgB;CACtC,QAAQ,OAAO,MAAM,aAAa;CAClC,OAAO,OAAO;AAChB,CAAC;AAID,MAAa,oBAAoB,OAAO,OAAO;CAC7C,GAAG,qBAAqB;CACxB,oBAAoB;AACtB,CAAC;AAID,MAAa,qBAAqB,OAAO,OAAO;CAC9C,SAAS,OAAO;CAChB,SAAS,OAAO;CAChB,WAAW,OAAO;CAClB,WAAW,OAAO;CAClB,YAAY;AACd,CAAC;AAID,IAAa,0BAAb,cAA6C,OAAO,YAAqC,CAAC,CAAC,4BAA4B,EACrH,SAAS,OAAO,eAClB,CAAC,CAAC,CAAC,CAAC"}

package/src/{DocumentEngine-J7g-emdf.js → DocumentEngine-BbhfnTAc.js}

@@ -1,7 +1,7 @@
 import { d as SourcePath, o as PublicPath } from "./scalars-B2lgGUnj.js";
-import { c as resolveCmsComarkAttributes, d as createCmsComarkRenderData, l as withCmsComarkProps, o as normalizeCmsComponentBindings, u as cmsComarkTextContent } from "./Forms-Dj6NuW66.js";
-import { M as DocumentSeo, c as DocumentIssue, h as DocumentSourceMapping, n as CmsMarkdownDocument, r as CompiledDocument, t as CmsDocumentAnalysis, v as DocumentValidationResult } from "./models-Bah5B3bT.js";
-import { f as DOCUMENT_ENGINE_FINGERPRINT, l as validateCollectionBody, m as SOURCE_MAPPINGS_META_KEY, o as createAuthoringDocumentValidator, p as createDocumentParser } from "./Configuration-CDMYfTre.js";
+import { M as DocumentSeo, c as DocumentIssue, h as DocumentSourceMapping, n as CmsMarkdownDocument, r as CompiledDocument, t as CmsDocumentAnalysis, v as DocumentValidationResult } from "./models-DgkGTFus.js";
+import { c as resolveCmsComarkAttributes, d as createCmsComarkRenderData, l as withCmsComarkProps, o as normalizeCmsComponentBindings, u as cmsComarkTextContent } from "./Forms-02-p8qEw.js";
+import { f as DOCUMENT_ENGINE_FINGERPRINT, l as validateCollectionBody, m as SOURCE_MAPPINGS_META_KEY, o as createAuthoringDocumentValidator, p as createDocumentParser } from "./Configuration-CjVUBBwa.js";
 import { DateTime, Effect, Option, Predicate, Result, Schema } from "effect";
 
 //#region ../document/src/internal/document-address.ts
@@ -874,4 +874,4 @@ function errorMessage(cause) {
 
 //#endregion
 export { normalizeDocumentRelativePath as a, resolveDocumentAddress as c, localizeDocumentPath as i, referenceTarget as n, normalizePublicPath as o, DocumentCompilationFailed as r, parseDocumentAddress as s, createDocumentEngine as t };
-//# sourceMappingURL=DocumentEngine-J7g-emdf.js.map
+//# sourceMappingURL=DocumentEngine-BbhfnTAc.js.map