@xsynaptic/astro-image-pipeline 0.0.0-stage → 0.1.0

package/dist/index.mjs

@@ -0,0 +1,296 @@
+import { d as parseImageName, l as isImageSource, n as isWithinSource, r as imageRecordsVariable, s as getImageStem } from "./image-presets-ZN7_n2p8.mjs";
+import { a as writeManifest, h as renderImage, i as writeBuildId, m as readSourceSize, o as UserError, r as readManifest, t as getImageCachePaths, u as formatList } from "./image-state-Bdi_-yWQ.mjs";
+import { createHash, randomUUID } from "node:crypto";
+import { promises } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+//#region src/dev-resolver.ts
+async function getModifiedTime(filePath) {
+	try {
+		return (await promises.stat(filePath)).mtimeMs;
+	} catch {
+		return;
+	}
+}
+function isWithinDirectory(directory, filePath) {
+	const relativePath = path.relative(directory, filePath);
+	return relativePath !== "" && relativePath.split(path.sep)[0] !== ".." && !path.isAbsolute(relativePath);
+}
+async function isNewerThanSource(target, sourcePath) {
+	const [sourceTime, targetTime] = await Promise.all([getModifiedTime(sourcePath), getModifiedTime(target)]);
+	return sourceTime !== void 0 && targetTime !== void 0 && targetTime >= sourceTime;
+}
+async function writeImage(target, data) {
+	const temporary = `${target}.${randomUUID()}.tmp`;
+	await promises.mkdir(path.dirname(target), { recursive: true });
+	await promises.writeFile(temporary, data);
+	await promises.rename(temporary, target);
+}
+function createDevImageResolver({ builtPath, cachePath, encoding, limitInputPixels, mediaPath, render = renderImage, sources }) {
+	const inFlight = /* @__PURE__ */ new Map();
+	async function resolveImage(name) {
+		const parsed = parseImageName(name);
+		if (!parsed) return;
+		const id = await sources.resolve(parsed.stem);
+		if (id === void 0) return;
+		const sourcePath = path.resolve(mediaPath, id);
+		if (!isWithinDirectory(mediaPath, sourcePath)) return;
+		if (builtPath) {
+			const built = path.join(builtPath, name);
+			if (await isNewerThanSource(built, sourcePath)) return built;
+		}
+		const target = path.join(cachePath, name);
+		if (await isNewerThanSource(target, sourcePath)) return target;
+		if (!isWithinSource(parsed, await readSourceSize(sourcePath))) return;
+		const { data } = await render(sourcePath, {
+			encoding,
+			format: parsed.format,
+			height: parsed.height,
+			limitInputPixels,
+			width: parsed.width
+		});
+		await writeImage(target, data);
+		return target;
+	}
+	async function resolveOnce(name) {
+		try {
+			return await resolveImage(name);
+		} finally {
+			inFlight.delete(name);
+		}
+	}
+	return function getDevImage(name) {
+		const pending = inFlight.get(name);
+		if (pending) return pending;
+		const request = resolveOnce(name);
+		inFlight.set(name, request);
+		return request;
+	};
+}
+//#endregion
+//#region src/image-records.ts
+async function listRecordFiles(recordsPath) {
+	try {
+		return (await promises.readdir(recordsPath)).filter((entry) => entry.endsWith(".ndjson")).toSorted((first, second) => first.localeCompare(second));
+	} catch {
+		return [];
+	}
+}
+function createRecordedValues() {
+	return {
+		conflicts: /* @__PURE__ */ new Map(),
+		values: /* @__PURE__ */ new Map()
+	};
+}
+function addRecordedValue(recorded, name, value) {
+	const existing = recorded.values.get(name);
+	if (existing === void 0) {
+		recorded.values.set(name, value);
+		return;
+	}
+	if (existing === value) return;
+	const conflict = recorded.conflicts.get(name) ?? /* @__PURE__ */ new Set([existing]);
+	recorded.conflicts.set(name, conflict.add(value));
+}
+function sortByName(entries) {
+	return new Map([...entries].toSorted(([first], [second]) => first.localeCompare(second)));
+}
+function describeConflicts(renditions, cards) {
+	const messages = [];
+	if (renditions.conflicts.size > 0) {
+		const conflicts = [...renditions.conflicts].map(([name, sourcePaths]) => `${name} (${[...sourcePaths].join(", ")})`);
+		messages.push(`${String(conflicts.length)} image names were recorded from more than one source:\n${formatList(conflicts.toSorted((first, second) => first.localeCompare(second)))}`);
+	}
+	if (cards.conflicts.size > 0) messages.push(`${String(cards.conflicts.size)} OpenGraph cards were recorded with different input:\n${formatList([...cards.conflicts.keys()].toSorted((first, second) => first.localeCompare(second)))}`);
+	return messages;
+}
+async function resetImageRecords(recordsPath) {
+	const buildRecordsPath = path.join(recordsPath, randomUUID());
+	await promises.rm(recordsPath, {
+		force: true,
+		recursive: true
+	});
+	await promises.mkdir(buildRecordsPath, { recursive: true });
+	return buildRecordsPath;
+}
+async function readImageRecords(recordsPath) {
+	const renditions = createRecordedValues();
+	const cards = createRecordedValues();
+	const recordFiles = await listRecordFiles(recordsPath);
+	for (const recordFile of recordFiles) {
+		const text = await promises.readFile(path.join(recordsPath, recordFile), "utf8");
+		for (const line of text.split("\n")) {
+			if (line === "") continue;
+			const record = JSON.parse(line);
+			if ("kind" in record) addRecordedValue(cards, record.name, JSON.stringify(record.card));
+			else addRecordedValue(renditions, record.name, record.sourcePath);
+		}
+	}
+	const messages = describeConflicts(renditions, cards);
+	if (messages.length > 0) throw new Error(messages.join("\n"));
+	return {
+		cards: sortByName([...cards.values].map(([name, value]) => [name, JSON.parse(value)])),
+		renditions: sortByName(renditions.values)
+	};
+}
+//#endregion
+//#region src/image-sources.ts
+async function readDirectory(directory) {
+	try {
+		return await promises.readdir(directory);
+	} catch {
+		return [];
+	}
+}
+function createDirectorySources(mediaPath) {
+	return { async resolve(stem) {
+		const directory = path.posix.dirname(stem);
+		const basename = path.posix.basename(stem);
+		const entry = (await readDirectory(path.join(mediaPath, directory))).find((name) => isImageSource(name) && getImageStem(name) === basename);
+		return entry === void 0 ? void 0 : path.posix.join(directory, entry);
+	} };
+}
+//#endregion
+//#region src/astro-integration.ts
+const sharpDefaultInputPixelLimit = 268402689;
+function decodeImageName(pathname) {
+	try {
+		return decodeURIComponent(pathname).replace(/^\/+/, "");
+	} catch {
+		return;
+	}
+}
+async function readPreviousManifest(cachePath) {
+	try {
+		return await readManifest(cachePath);
+	} catch (error) {
+		if (error instanceof UserError) return;
+		throw error;
+	}
+}
+async function readRecorded({ cachePath, isIncremental, logger, pageCount, recordsPath }) {
+	const recorded = await readImageRecords(recordsPath);
+	if (isIncremental) {
+		logger.warn("Incremental build: pages restored from cache record nothing, so the manifest keeps the previous build's names too; names only fall out on a full build");
+		const previous = await readPreviousManifest(cachePath);
+		return {
+			cards: new Map([...Object.entries(previous?.openGraphCards ?? {}), ...recorded.cards]),
+			renditions: new Map([...Object.entries(previous?.renditions ?? {}), ...recorded.renditions])
+		};
+	}
+	if (recorded.renditions.size === 0 && recorded.cards.size === 0 && pageCount > 0) throw new Error(`No image names were recorded while building ${String(pageCount)} pages; build image URLs with getName at render time, in a runtime that has node:fs`);
+	return recorded;
+}
+async function writeBuildManifest({ cachePath, distPath, logger, manifest, recorded: { cards, renditions } }) {
+	const buildId = randomUUID();
+	await writeManifest(cachePath, {
+		...manifest,
+		buildId,
+		distPath,
+		openGraphCards: Object.fromEntries(cards),
+		renditions: Object.fromEntries(renditions),
+		version: 4
+	});
+	await writeBuildId(distPath, buildId);
+	logger.info(`${String(renditions.size)} renditions from ${String(new Set(renditions.values()).size)} sources, ${String(cards.size)} OpenGraph cards`);
+}
+function createDevImageHandler(getDevImage, logger) {
+	return async function serveDevImage(request, response) {
+		const { pathname } = new URL(request.url ?? "/", "http://localhost");
+		const name = decodeImageName(pathname);
+		if (name === void 0) {
+			response.statusCode = 400;
+			response.end();
+			return;
+		}
+		try {
+			const filePath = await getDevImage(name);
+			if (!filePath) {
+				response.statusCode = 404;
+				response.end();
+				return;
+			}
+			response.setHeader("Cache-Control", "no-cache");
+			response.setHeader("Content-Type", filePath.endsWith(".webp") ? "image/webp" : "image/jpeg");
+			response.end(await promises.readFile(filePath));
+		} catch (error) {
+			logger.error(`${pathname}: ${error instanceof Error ? error.message : String(error)}`);
+			response.statusCode = 500;
+			response.end();
+		}
+	};
+}
+async function isBuiltFrom(cachePath, mediaPath) {
+	try {
+		return (await readManifest(cachePath))?.mediaPath === mediaPath;
+	} catch {
+		return false;
+	}
+}
+function imagePipeline({ baseUrl, cachePath, limitInputPixels = sharpDefaultInputPixelLimit, mediaPath, pipeline, sources }) {
+	if (baseUrl.replace(/\/+$/, "") === "") throw new Error("imagePipeline needs a baseUrl below the site root; at the root, every request and every root-relative URL would count as an image");
+	const absoluteMediaPath = path.resolve(mediaPath);
+	const absoluteCachePath = path.resolve(cachePath);
+	const { devPath, recordsPath, renditionsPath } = getImageCachePaths(absoluteCachePath);
+	let isIncremental = false;
+	let buildRecordsPath = recordsPath;
+	return {
+		hooks: {
+			"astro:build:done": async ({ dir, logger, pages }) => {
+				try {
+					const distPath = fileURLToPath(dir);
+					const recorded = await readRecorded({
+						cachePath: absoluteCachePath,
+						isIncremental,
+						logger,
+						pageCount: pages.length,
+						recordsPath: buildRecordsPath
+					});
+					await writeBuildManifest({
+						cachePath: absoluteCachePath,
+						distPath,
+						logger,
+						manifest: {
+							encoding: pipeline.encoding,
+							limitInputPixels,
+							mediaPath: absoluteMediaPath
+						},
+						recorded
+					});
+					await promises.rm(recordsPath, {
+						force: true,
+						recursive: true
+					});
+				} finally {
+					Reflect.deleteProperty(process.env, imageRecordsVariable);
+				}
+			},
+			"astro:config:setup": async ({ command, config }) => {
+				if (command !== "build") return;
+				isIncremental = config.experimental.incrementalBuild;
+				buildRecordsPath = await resetImageRecords(recordsPath);
+				process.env[imageRecordsVariable] = buildRecordsPath;
+			},
+			"astro:server:setup": async ({ logger, server }) => {
+				if (!baseUrl.startsWith("/")) return;
+				const mediaPathKey = createHash("sha256").update(absoluteMediaPath).digest("hex").slice(0, 8);
+				const serveDevImage = createDevImageHandler(createDevImageResolver({
+					builtPath: await isBuiltFrom(absoluteCachePath, absoluteMediaPath) ? renditionsPath : void 0,
+					cachePath: path.resolve(devPath, mediaPathKey),
+					encoding: pipeline.encoding,
+					limitInputPixels,
+					mediaPath: absoluteMediaPath,
+					sources: sources ?? createDirectorySources(absoluteMediaPath)
+				}), logger);
+				server.middlewares.use(baseUrl.replace(/\/+$/, ""), (request, response) => {
+					serveDevImage(request, response);
+				});
+			}
+		},
+		name: "@xsynaptic/astro-image-pipeline"
+	};
+}
+//#endregion
+export { imagePipeline as default };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["fs","fs","fs","fs"],"sources":["../src/dev-resolver.ts","../src/image-records.ts","../src/image-sources.ts","../src/astro-integration.ts"],"sourcesContent":["import { randomUUID } from 'node:crypto';\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport type { ResolvedImageEncoding } from './image-encoding.js';\nimport type { ImageSourceResolver } from './image-sources.js';\n\nimport { parseImageName } from './image-name.js';\nimport { isWithinSource } from './image-presets.js';\nimport { readSourceSize, renderImage } from './image-render.js';\n\ninterface DevImageOptions {\n\tbuiltPath: string | undefined;\n\tcachePath: string;\n\tencoding: ResolvedImageEncoding;\n\tlimitInputPixels: number;\n\tmediaPath: string;\n\trender?: typeof renderImage;\n\tsources: ImageSourceResolver;\n}\n\nasync function getModifiedTime(filePath: string) {\n\ttry {\n\t\tconst stats = await fs.stat(filePath);\n\n\t\treturn stats.mtimeMs;\n\t} catch {\n\t\treturn;\n\t}\n}\n\nfunction isWithinDirectory(directory: string, filePath: string) {\n\tconst relativePath = path.relative(directory, filePath);\n\n\treturn (\n\t\trelativePath !== '' &&\n\t\trelativePath.split(path.sep)[0] !== '..' &&\n\t\t!path.isAbsolute(relativePath)\n\t);\n}\n\nasync function isNewerThanSource(target: string, sourcePath: string) {\n\tconst [sourceTime, targetTime] = await Promise.all([\n\t\tgetModifiedTime(sourcePath),\n\t\tgetModifiedTime(target),\n\t]);\n\n\treturn sourceTime !== undefined && targetTime !== undefined && targetTime >= sourceTime;\n}\n\nasync function writeImage(target: string, data: Uint8Array) {\n\tconst temporary = `${target}.${randomUUID()}.tmp`;\n\n\tawait fs.mkdir(path.dirname(target), { recursive: true });\n\tawait fs.writeFile(temporary, data);\n\tawait fs.rename(temporary, target);\n}\n\nexport function createDevImageResolver({\n\tbuiltPath,\n\tcachePath,\n\tencoding,\n\tlimitInputPixels,\n\tmediaPath,\n\trender = renderImage,\n\tsources,\n}: DevImageOptions) {\n\tconst inFlight = new Map<string, Promise<string | undefined>>();\n\n\tasync function resolveImage(name: string) {\n\t\tconst parsed = parseImageName(name);\n\n\t\tif (!parsed) return;\n\n\t\tconst id = await sources.resolve(parsed.stem);\n\n\t\tif (id === undefined) return;\n\n\t\tconst sourcePath = path.resolve(mediaPath, id);\n\n\t\tif (!isWithinDirectory(mediaPath, sourcePath)) return;\n\n\t\tif (builtPath) {\n\t\t\tconst built = path.join(builtPath, name);\n\n\t\t\tif (await isNewerThanSource(built, sourcePath)) return built;\n\t\t}\n\n\t\tconst target = path.join(cachePath, name);\n\n\t\tif (await isNewerThanSource(target, sourcePath)) return target;\n\n\t\tif (!isWithinSource(parsed, await readSourceSize(sourcePath))) return;\n\n\t\tconst { data } = await render(sourcePath, {\n\t\t\tencoding,\n\t\t\tformat: parsed.format,\n\t\t\theight: parsed.height,\n\t\t\tlimitInputPixels,\n\t\t\twidth: parsed.width,\n\t\t});\n\n\t\tawait writeImage(target, data);\n\n\t\treturn target;\n\t}\n\n\tasync function resolveOnce(name: string) {\n\t\ttry {\n\t\t\treturn await resolveImage(name);\n\t\t} finally {\n\t\t\tinFlight.delete(name);\n\t\t}\n\t}\n\n\treturn function getDevImage(name: string) {\n\t\tconst pending = inFlight.get(name);\n\n\t\tif (pending) return pending;\n\n\t\tconst request = resolveOnce(name);\n\n\t\tinFlight.set(name, request);\n\n\t\treturn request;\n\t};\n}\n","import { randomUUID } from 'node:crypto';\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport type { OpenGraphCard } from './open-graph-cards.js';\n\nimport { formatList } from './format.js';\n\ninterface OpenGraphCardRecord {\n\tcard: OpenGraphCard;\n\tkind: 'open-graph-card';\n\tname: string;\n}\n\ninterface RenditionRecord {\n\tname: string;\n\tsourcePath: string;\n}\n\ntype ImageRecord = OpenGraphCardRecord | RenditionRecord;\n\ninterface RecordedValues {\n\tconflicts: Map<string, Set<string>>;\n\tvalues: Map<string, string>;\n}\n\nasync function listRecordFiles(recordsPath: string) {\n\ttry {\n\t\tconst entries = await fs.readdir(recordsPath);\n\n\t\treturn entries\n\t\t\t.filter((entry) => entry.endsWith('.ndjson'))\n\t\t\t.toSorted((first, second) => first.localeCompare(second));\n\t} catch {\n\t\treturn [];\n\t}\n}\n\nfunction createRecordedValues(): RecordedValues {\n\treturn { conflicts: new Map(), values: new Map() };\n}\n\nfunction addRecordedValue(recorded: RecordedValues, name: string, value: string) {\n\tconst existing = recorded.values.get(name);\n\n\tif (existing === undefined) {\n\t\trecorded.values.set(name, value);\n\t\treturn;\n\t}\n\n\tif (existing === value) return;\n\n\tconst conflict = recorded.conflicts.get(name) ?? new Set([existing]);\n\n\trecorded.conflicts.set(name, conflict.add(value));\n}\n\nfunction sortByName<Value>(entries: Iterable<[string, Value]>) {\n\treturn new Map([...entries].toSorted(([first], [second]) => first.localeCompare(second)));\n}\n\nfunction describeConflicts(renditions: RecordedValues, cards: RecordedValues) {\n\tconst messages: Array<string> = [];\n\n\tif (renditions.conflicts.size > 0) {\n\t\tconst conflicts = [...renditions.conflicts].map(\n\t\t\t([name, sourcePaths]) => `${name} (${[...sourcePaths].join(', ')})`,\n\t\t);\n\n\t\tmessages.push(\n\t\t\t`${String(conflicts.length)} image names were recorded from more than one source:\\n${formatList(conflicts.toSorted((first, second) => first.localeCompare(second)))}`,\n\t\t);\n\t}\n\n\tif (cards.conflicts.size > 0) {\n\t\tmessages.push(\n\t\t\t`${String(cards.conflicts.size)} OpenGraph cards were recorded with different input:\\n${formatList([...cards.conflicts.keys()].toSorted((first, second) => first.localeCompare(second)))}`,\n\t\t);\n\t}\n\n\treturn messages;\n}\n\nexport async function resetImageRecords(recordsPath: string) {\n\tconst buildRecordsPath = path.join(recordsPath, randomUUID());\n\n\tawait fs.rm(recordsPath, { force: true, recursive: true });\n\tawait fs.mkdir(buildRecordsPath, { recursive: true });\n\n\treturn buildRecordsPath;\n}\n\nexport async function readImageRecords(recordsPath: string) {\n\tconst renditions = createRecordedValues();\n\tconst cards = createRecordedValues();\n\n\tconst recordFiles = await listRecordFiles(recordsPath);\n\n\tfor (const recordFile of recordFiles) {\n\t\tconst text = await fs.readFile(path.join(recordsPath, recordFile), 'utf8');\n\n\t\tfor (const line of text.split('\\n')) {\n\t\t\tif (line === '') continue;\n\n\t\t\tconst record = JSON.parse(line) as ImageRecord;\n\n\t\t\tif ('kind' in record) {\n\t\t\t\taddRecordedValue(cards, record.name, JSON.stringify(record.card));\n\t\t\t} else {\n\t\t\t\taddRecordedValue(renditions, record.name, record.sourcePath);\n\t\t\t}\n\t\t}\n\t}\n\n\tconst messages = describeConflicts(renditions, cards);\n\n\tif (messages.length > 0) throw new Error(messages.join('\\n'));\n\n\treturn {\n\t\tcards: sortByName(\n\t\t\t[...cards.values].map(([name, value]): [string, OpenGraphCard] => [\n\t\t\t\tname,\n\t\t\t\tJSON.parse(value) as OpenGraphCard,\n\t\t\t]),\n\t\t),\n\t\trenditions: sortByName(renditions.values),\n\t};\n}\n","import { promises as fs } from 'node:fs';\nimport path from 'node:path';\n\nimport { getImageStem, isImageSource } from './image-name.js';\n\nexport interface ImageSourceResolver {\n\tresolve(stem: string): Promise<string | undefined>;\n}\n\nasync function readDirectory(directory: string) {\n\ttry {\n\t\treturn await fs.readdir(directory);\n\t} catch {\n\t\treturn [];\n\t}\n}\n\n// No directory cache, so files added while dev runs resolve without a restart\nexport function createDirectorySources(mediaPath: string): ImageSourceResolver {\n\treturn {\n\t\tasync resolve(stem) {\n\t\t\tconst directory = path.posix.dirname(stem);\n\t\t\tconst basename = path.posix.basename(stem);\n\t\t\tconst entries = await readDirectory(path.join(mediaPath, directory));\n\t\t\tconst entry = entries.find((name) => isImageSource(name) && getImageStem(name) === basename);\n\n\t\t\treturn entry === undefined ? undefined : path.posix.join(directory, entry);\n\t\t},\n\t};\n}\n","import type { AstroIntegration, AstroIntegrationLogger } from 'astro';\nimport type { IncomingMessage, ServerResponse } from 'node:http';\n\nimport { createHash, randomUUID } from 'node:crypto';\nimport { promises as fs } from 'node:fs';\nimport path from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nimport type { ResolvedImageEncoding } from './image-encoding.js';\nimport type { ImageSourceResolver } from './image-sources.js';\nimport type { ImageManifest } from './image-state.js';\nimport type { OpenGraphCard } from './open-graph-cards.js';\n\nimport { createDevImageResolver } from './dev-resolver.js';\nimport { imageRecordsVariable } from './image-recorder.js';\nimport { readImageRecords, resetImageRecords } from './image-records.js';\nimport { createDirectorySources } from './image-sources.js';\nimport {\n\tgetImageCachePaths,\n\timageManifestVersion,\n\treadManifest,\n\twriteBuildId,\n\twriteManifest,\n} from './image-state.js';\nimport { UserError } from './user-error.js';\n\nexport type { ImageSourceResolver } from './image-sources.js';\n\nexport interface ImagePipelineOptions {\n\tbaseUrl: string;\n\tcachePath: string;\n\tlimitInputPixels?: number;\n\tmediaPath: string;\n\tpipeline: { encoding: ResolvedImageEncoding };\n\tsources?: ImageSourceResolver;\n}\n\nconst sharpDefaultInputPixelLimit = 0x3f_ff * 0x3f_ff;\n\nfunction decodeImageName(pathname: string) {\n\ttry {\n\t\treturn decodeURIComponent(pathname).replace(/^\\/+/, '');\n\t} catch {\n\t\treturn;\n\t}\n}\n\nasync function readPreviousManifest(cachePath: string) {\n\ttry {\n\t\treturn await readManifest(cachePath);\n\t} catch (error) {\n\t\tif (error instanceof UserError) return;\n\n\t\tthrow error;\n\t}\n}\n\nasync function readRecorded({\n\tcachePath,\n\tisIncremental,\n\tlogger,\n\tpageCount,\n\trecordsPath,\n}: {\n\tcachePath: string;\n\tisIncremental: boolean;\n\tlogger: AstroIntegrationLogger;\n\tpageCount: number;\n\trecordsPath: string;\n}) {\n\tconst recorded = await readImageRecords(recordsPath);\n\n\t// Pages an incremental build skips still count in `pages`, but record nothing\n\tif (isIncremental) {\n\t\tlogger.warn(\n\t\t\t\"Incremental build: pages restored from cache record nothing, so the manifest keeps the previous build's names too; names only fall out on a full build\",\n\t\t);\n\n\t\tconst previous = await readPreviousManifest(cachePath);\n\n\t\treturn {\n\t\t\tcards: new Map([...Object.entries(previous?.openGraphCards ?? {}), ...recorded.cards]),\n\t\t\trenditions: new Map([...Object.entries(previous?.renditions ?? {}), ...recorded.renditions]),\n\t\t};\n\t}\n\n\tif (recorded.renditions.size === 0 && recorded.cards.size === 0 && pageCount > 0) {\n\t\tthrow new Error(\n\t\t\t`No image names were recorded while building ${String(pageCount)} pages; build image URLs with getName at render time, in a runtime that has node:fs`,\n\t\t);\n\t}\n\n\treturn recorded;\n}\n\nasync function writeBuildManifest({\n\tcachePath,\n\tdistPath,\n\tlogger,\n\tmanifest,\n\trecorded: { cards, renditions },\n}: {\n\tcachePath: string;\n\tdistPath: string;\n\tlogger: AstroIntegrationLogger;\n\tmanifest: Pick<ImageManifest, 'encoding' | 'limitInputPixels' | 'mediaPath'>;\n\trecorded: { cards: ReadonlyMap<string, OpenGraphCard>; renditions: ReadonlyMap<string, string> };\n}) {\n\tconst buildId = randomUUID();\n\n\tawait writeManifest(cachePath, {\n\t\t...manifest,\n\t\tbuildId,\n\t\tdistPath,\n\t\topenGraphCards: Object.fromEntries(cards),\n\t\trenditions: Object.fromEntries(renditions),\n\t\tversion: imageManifestVersion,\n\t});\n\tawait writeBuildId(distPath, buildId);\n\n\tlogger.info(\n\t\t`${String(renditions.size)} renditions from ${String(new Set(renditions.values()).size)} sources, ${String(cards.size)} OpenGraph cards`,\n\t);\n}\n\nfunction createDevImageHandler(\n\tgetDevImage: ReturnType<typeof createDevImageResolver>,\n\tlogger: AstroIntegrationLogger,\n) {\n\treturn async function serveDevImage(request: IncomingMessage, response: ServerResponse) {\n\t\tconst { pathname } = new URL(request.url ?? '/', 'http://localhost');\n\t\tconst name = decodeImageName(pathname);\n\n\t\tif (name === undefined) {\n\t\t\tresponse.statusCode = 400;\n\t\t\tresponse.end();\n\t\t\treturn;\n\t\t}\n\n\t\ttry {\n\t\t\tconst filePath = await getDevImage(name);\n\n\t\t\tif (!filePath) {\n\t\t\t\tresponse.statusCode = 404;\n\t\t\t\tresponse.end();\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\tresponse.setHeader('Cache-Control', 'no-cache');\n\t\t\tresponse.setHeader('Content-Type', filePath.endsWith('.webp') ? 'image/webp' : 'image/jpeg');\n\t\t\tresponse.end(await fs.readFile(filePath));\n\t\t} catch (error) {\n\t\t\tlogger.error(`${pathname}: ${error instanceof Error ? error.message : String(error)}`);\n\t\t\tresponse.statusCode = 500;\n\t\t\tresponse.end();\n\t\t}\n\t};\n}\n\nasync function isBuiltFrom(cachePath: string, mediaPath: string) {\n\ttry {\n\t\tconst manifest = await readManifest(cachePath);\n\n\t\treturn manifest?.mediaPath === mediaPath;\n\t} catch {\n\t\treturn false;\n\t}\n}\n\nexport default function imagePipeline({\n\tbaseUrl,\n\tcachePath,\n\tlimitInputPixels = sharpDefaultInputPixelLimit,\n\tmediaPath,\n\tpipeline,\n\tsources,\n}: ImagePipelineOptions): AstroIntegration {\n\tif (baseUrl.replace(/\\/+$/, '') === '') {\n\t\tthrow new Error(\n\t\t\t'imagePipeline needs a baseUrl below the site root; at the root, every request and every root-relative URL would count as an image',\n\t\t);\n\t}\n\n\tconst absoluteMediaPath = path.resolve(mediaPath);\n\tconst absoluteCachePath = path.resolve(cachePath);\n\tconst { devPath, recordsPath, renditionsPath } = getImageCachePaths(absoluteCachePath);\n\tlet isIncremental = false;\n\tlet buildRecordsPath = recordsPath;\n\n\treturn {\n\t\thooks: {\n\t\t\t'astro:build:done': async ({ dir, logger, pages }) => {\n\t\t\t\ttry {\n\t\t\t\t\tconst distPath = fileURLToPath(dir);\n\t\t\t\t\tconst recorded = await readRecorded({\n\t\t\t\t\t\tcachePath: absoluteCachePath,\n\t\t\t\t\t\tisIncremental,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t\tpageCount: pages.length,\n\t\t\t\t\t\trecordsPath: buildRecordsPath,\n\t\t\t\t\t});\n\n\t\t\t\t\tawait writeBuildManifest({\n\t\t\t\t\t\tcachePath: absoluteCachePath,\n\t\t\t\t\t\tdistPath,\n\t\t\t\t\t\tlogger,\n\t\t\t\t\t\tmanifest: {\n\t\t\t\t\t\t\tencoding: pipeline.encoding,\n\t\t\t\t\t\t\tlimitInputPixels,\n\t\t\t\t\t\t\tmediaPath: absoluteMediaPath,\n\t\t\t\t\t\t},\n\t\t\t\t\t\trecorded,\n\t\t\t\t\t});\n\t\t\t\t\tawait fs.rm(recordsPath, { force: true, recursive: true });\n\t\t\t\t} finally {\n\t\t\t\t\tReflect.deleteProperty(process.env, imageRecordsVariable);\n\t\t\t\t}\n\t\t\t},\n\t\t\t'astro:config:setup': async ({ command, config }) => {\n\t\t\t\tif (command !== 'build') return;\n\n\t\t\t\tisIncremental = config.experimental.incrementalBuild;\n\t\t\t\tbuildRecordsPath = await resetImageRecords(recordsPath);\n\t\t\t\tprocess.env[imageRecordsVariable] = buildRecordsPath;\n\t\t\t},\n\t\t\t'astro:server:setup': async ({ logger, server }) => {\n\t\t\t\t// An absolute base URL means dev fetches images from the live host\n\t\t\t\tif (!baseUrl.startsWith('/')) return;\n\n\t\t\t\tconst mediaPathKey = createHash('sha256')\n\t\t\t\t\t.update(absoluteMediaPath)\n\t\t\t\t\t.digest('hex')\n\t\t\t\t\t.slice(0, 8);\n\t\t\t\tconst getDevImage = createDevImageResolver({\n\t\t\t\t\tbuiltPath: (await isBuiltFrom(absoluteCachePath, absoluteMediaPath))\n\t\t\t\t\t\t? renditionsPath\n\t\t\t\t\t\t: undefined,\n\t\t\t\t\tcachePath: path.resolve(devPath, mediaPathKey),\n\t\t\t\t\tencoding: pipeline.encoding,\n\t\t\t\t\tlimitInputPixels,\n\t\t\t\t\tmediaPath: absoluteMediaPath,\n\t\t\t\t\tsources: sources ?? createDirectorySources(absoluteMediaPath),\n\t\t\t\t});\n\n\t\t\t\tconst serveDevImage = createDevImageHandler(getDevImage, logger);\n\n\t\t\t\tserver.middlewares.use(baseUrl.replace(/\\/+$/, ''), (request, response) => {\n\t\t\t\t\tvoid serveDevImage(request, response);\n\t\t\t\t});\n\t\t\t},\n\t\t},\n\t\tname: '@xsynaptic/astro-image-pipeline',\n\t};\n}\n"],"mappings":"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"}

package/dist/node.d.mts

@@ -0,0 +1,148 @@
+import { n as ResolvedImageEncoding } from "./image-encoding-CPYBEK0T.mjs";
+import { c as OpenGraphCardInput, n as ImageDimensions, o as OpenGraphCard, s as OpenGraphCardImage } from "./image-presets-CS7TnTsE.mjs";
+import { SharpInput, SharpOptions } from "sharp";
+//#region src/run-render-jobs.d.ts
+interface RenderJob {
+  key: string;
+  name: string;
+  render: () => Promise<Uint8Array>;
+}
+interface RenderCounts {
+  fresh: number;
+  overwritten: number;
+  rendered: number;
+  written: number;
+}
+interface RenderFailure {
+  message: string;
+  name: string;
+}
+interface RenderJobOptions {
+  concurrency?: number;
+  directory: string;
+  jobs: ReadonlyArray<RenderJob>;
+  onFailure?: 'report' | 'throw';
+  onProgress?: (progress: RenderCounts & {
+    done: number;
+    total: number;
+  }) => void;
+  onReplace?: (name: string) => Promise<void>;
+  signal?: AbortSignal;
+}
+export declare function runRenderJobs(options: RenderJobOptions): Promise<{
+  failures: RenderFailure[];
+  total: number;
+  fresh: number;
+  overwritten: number;
+  rendered: number;
+  written: number;
+}>;
+//#endregion
+//#region src/image-state.d.ts
+declare const imageManifestVersion = 4;
+interface ImageManifest {
+  buildId: string;
+  distPath: string;
+  encoding: ResolvedImageEncoding;
+  limitInputPixels: number;
+  mediaPath: string;
+  openGraphCards: Record<string, OpenGraphCard>;
+  renditions: Record<string, string>;
+  version: typeof imageManifestVersion;
+}
+export declare function getImageCachePaths(cachePath: string): {
+  devPath: string;
+  openGraphCardsPath: string;
+  recordsPath: string;
+  renditionsPath: string;
+};
+export declare function readManifest(cachePath: string): Promise<ImageManifest | undefined>;
+//#endregion
+//#region src/image-build.d.ts
+interface ImageRenderOptions extends Pick<RenderJobOptions, 'onFailure' | 'onProgress' | 'onReplace' | 'signal'> {
+  cachePath: string;
+}
+export declare function renderImages(options: ImageRenderOptions): Promise<{
+  failures: RenderFailure[];
+  total: number;
+  fresh: number;
+  overwritten: number;
+  rendered: number;
+  written: number;
+}>;
+//#endregion
+//#region src/image-render.d.ts
+export declare const engineVersions: {
+  aom?: string | undefined;
+  archive?: string | undefined;
+  cairo?: string | undefined;
+  cgif?: string | undefined;
+  exif?: string | undefined;
+  expat?: string | undefined;
+  ffi?: string | undefined;
+  fontconfig?: string | undefined;
+  freetype?: string | undefined;
+  fribidi?: string | undefined;
+  glib?: string | undefined;
+  harfbuzz?: string | undefined;
+  heif?: string | undefined;
+  highway?: string | undefined;
+  imagequant?: string | undefined;
+  lcms?: string | undefined;
+  mozjpeg?: string | undefined;
+  pango?: string | undefined;
+  pixman?: string | undefined;
+  png?: string | undefined;
+  "proxy-libintl"?: string | undefined;
+  rsvg?: string | undefined;
+  sharp: string;
+  spng?: string | undefined;
+  tiff?: string | undefined;
+  vips: string;
+  webp?: string | undefined;
+  xml?: string | undefined;
+  "zlib-ng"?: string | undefined;
+};
+export declare function openImageSource(input: SharpInput, options?: Omit<SharpOptions, 'autoOrient'>): import("sharp").Sharp;
+export declare function readSourceSize(sourcePath: string): Promise<{
+  height: number;
+  width: number;
+}>;
+//#endregion
+//#region src/open-graph-build.d.ts
+interface OpenGraphCardSource extends OpenGraphCardImage {
+  path: string;
+}
+interface OpenGraphCardRenderOptions<Decoded> extends Pick<RenderJobOptions, 'concurrency' | 'onFailure' | 'onProgress' | 'onReplace' | 'signal'> {
+  cachePath: string;
+  decode: (source: OpenGraphCardSource) => Promise<Decoded>;
+  render: (input: OpenGraphCardInput, decoded?: Decoded) => Promise<Uint8Array>;
+  templateVersion: string;
+}
+export declare function renderOpenGraphCards<Decoded>({ cachePath, decode, render, templateVersion, ...options }: OpenGraphCardRenderOptions<Decoded>): Promise<{
+  sources: number;
+  failures: RenderFailure[];
+  total: number;
+  fresh: number;
+  overwritten: number;
+  rendered: number;
+  written: number;
+}>;
+//#endregion
+//#region src/source-fingerprints.d.ts
+interface SourceFingerprint extends ImageDimensions {
+  sha256: string;
+}
+interface SourceFingerprints {
+  close(): void;
+  get(filePath: string): Promise<SourceFingerprint | undefined>;
+}
+export declare function createSourceFingerprints(cachePath: string): SourceFingerprints;
+//#endregion
+//#region src/user-error.d.ts
+export declare class UserError extends Error {
+  name: string;
+}
+//#endregion
+export type { OpenGraphCardRenderOptions, OpenGraphCardSource, RenderCounts, RenderFailure, RenderJob, SourceFingerprints };
+//# sourceMappingURL=node.d.mts.map