@nhtio/adk 1.20260609.0 → 1.20260610.0

package/batteries/media/engines/soffice.cjs

@@ -0,0 +1,246 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+require("../../../chunk-Ble4zEEl.js");
+const require_batteries_media_contracts = require("../contracts.cjs");
+const require_exceptions = require("../../../exceptions-CQi_lNs1.js");
+//#region src/batteries/media/engines/soffice.ts
+/**
+* The LibreOffice-backed {@link @nhtio/adk/batteries/media/contracts!MediaEngine}: document,
+* spreadsheet, and presentation conversion via the `soffice` binary.
+*
+* @module @nhtio/adk/batteries/media/engines/soffice
+*
+* @remarks
+* Document conversion is the one capability in the media battery with no mature
+* cross-environment equivalent, so this engine is binary-backed by design. It composes the
+* two BYO runtime contracts: a {@link @nhtio/adk/batteries/media/contracts!BinaryExecutor}
+* runs the invocation (bundled: `execa_executor`) and a
+* {@link @nhtio/adk/batteries/media/contracts!ScratchWorkspace} exchanges bytes with it
+* (bundled: `fs_workspace`). The executor and workspace must agree on path visibility —
+* that pairing is the consumer's composition decision.
+*
+* One engine, one capability kind: the conversion matrix is declared as convert capability
+* groups (each format silo converts within itself plus to PDF/HTML; PDF converts to
+* html/txt/docx/odt). The spreadsheet group covers ODS/legacy-xls to xlsx — what used to be
+* a separate "normalize" engine is just an edge in the matrix.
+*/
+var MIME_BY_TARGET = {
+	pdf: "application/pdf",
+	html: "text/html",
+	txt: "text/plain",
+	md: "text/markdown",
+	csv: "text/csv",
+	json: "application/json",
+	docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	doc: "application/msword",
+	rtf: "application/rtf",
+	odt: "application/vnd.oasis.opendocument.text",
+	xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	xls: "application/vnd.ms-excel",
+	ods: "application/vnd.oasis.opendocument.spreadsheet",
+	pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+	ppt: "application/vnd.ms-powerpoint",
+	odp: "application/vnd.oasis.opendocument.presentation"
+};
+var EXT_BY_MIME = {
+	"application/pdf": "pdf",
+	"application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+	"application/msword": "doc",
+	"application/rtf": "rtf",
+	"text/rtf": "rtf",
+	"application/vnd.oasis.opendocument.text": "odt",
+	"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+	"application/vnd.ms-excel": "xls",
+	"application/vnd.oasis.opendocument.spreadsheet": "ods",
+	"application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx",
+	"application/vnd.ms-powerpoint": "ppt",
+	"application/vnd.oasis.opendocument.presentation": "odp",
+	"text/plain": "txt",
+	"text/html": "html",
+	"text/csv": "csv"
+};
+/** Server-parity conversion matrix: same-silo targets plus pdf/html. */
+var TARGETS_BY_EXT = {
+	docx: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"odt",
+		"doc",
+		"rtf"
+	],
+	odt: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"docx",
+		"doc",
+		"rtf"
+	],
+	doc: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"docx",
+		"odt",
+		"rtf"
+	],
+	rtf: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"docx",
+		"odt",
+		"doc"
+	],
+	xlsx: [
+		"pdf",
+		"html",
+		"csv",
+		"json",
+		"ods",
+		"xls"
+	],
+	ods: [
+		"pdf",
+		"html",
+		"csv",
+		"json",
+		"xlsx",
+		"xls"
+	],
+	xls: [
+		"pdf",
+		"html",
+		"csv",
+		"json",
+		"xlsx",
+		"ods"
+	],
+	pptx: [
+		"pdf",
+		"html",
+		"odp",
+		"ppt"
+	],
+	odp: [
+		"pdf",
+		"html",
+		"pptx",
+		"ppt"
+	],
+	ppt: [
+		"pdf",
+		"html",
+		"pptx",
+		"odp"
+	],
+	pdf: [
+		"html",
+		"txt",
+		"docx",
+		"odt"
+	]
+};
+/** soffice convert-to filter token per target (md goes via txt; json via csv). */
+var CONVERT_TOKEN = {
+	md: "txt:Text",
+	json: "csv"
+};
+var validateOptions = (options, name) => {
+	if (typeof options?.path !== "string" || options.path.length === 0) throw new require_exceptions.E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires the soffice binary path`]);
+	if (!require_batteries_media_contracts.implementsBinaryExecutor(options.executor)) throw new require_exceptions.E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires an executor implementing the BinaryExecutor contract`]);
+	if (typeof options.workspace !== "function") throw new require_exceptions.E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires a workspace factory (e.g. fsScratchWorkspace({ root }))`]);
+};
+var runSoffice = async (options, bytes, inputExt, convertTo, outputExt, signal) => {
+	const workspace = await options.workspace();
+	if (!require_batteries_media_contracts.implementsScratchWorkspace(workspace)) throw new require_exceptions.E_INVALID_MEDIA_PIPELINE_CONFIG(["the workspace factory minted a value that does not implement ScratchWorkspace"]);
+	try {
+		const inputPath = await workspace.materialize(bytes, `input.${inputExt}`);
+		const result = await options.executor.exec({
+			cmd: options.path,
+			args: [
+				"--headless",
+				"--nologo",
+				"--nodefault",
+				"--norestore",
+				"--nolockcheck",
+				"--convert-to",
+				convertTo,
+				"--outdir",
+				workspace.dir(),
+				inputPath
+			],
+			timeoutMs: options.timeoutMs ?? 12e4,
+			signal
+		});
+		if (result.failed) {
+			const detail = result.stderr || result.stdout || `exit code ${result.exitCode}`;
+			throw new Error(`LibreOffice conversion failed: ${detail}`);
+		}
+		const files = await workspace.list();
+		const produced = files.find((f) => f.toLowerCase().endsWith(`.${outputExt}`) && f !== `input.${inputExt}`);
+		if (!produced) throw new Error(`LibreOffice reported success but produced no .${outputExt} output (files: ${files.join(", ")})`);
+		return workspace.read(`${workspace.dir()}/${produced}`);
+	} finally {
+		await workspace.dispose();
+	}
+};
+/** The MIME types of one extension group, for capability `from` declarations. */
+var MIMES_OF = (exts) => Object.entries(EXT_BY_MIME).filter(([, ext]) => exts.includes(ext)).map(([mime]) => mime);
+/**
+* Construct the LibreOffice engine.
+*
+* @param options - Binary path, executor, workspace factory, timeout.
+* @returns The engine, declaring one convert capability group per format silo.
+*/
+var sofficeEngine = (options) => {
+	validateOptions(options, "sofficeEngine");
+	const convert = async (request) => {
+		const inputExt = EXT_BY_MIME[request.mimeType.toLowerCase().split(";")[0].trim()];
+		if (!inputExt) throw new Error(`unsupported input MIME for conversion: ${request.mimeType}`);
+		const targets = TARGETS_BY_EXT[inputExt] ?? [];
+		if (!targets.includes(request.to)) throw new Error(`cannot convert ${inputExt} to ${request.to}; supported: ${targets.join(", ")}`);
+		const convertTo = CONVERT_TOKEN[request.to] ?? request.to;
+		const outputExt = request.to === "md" ? "txt" : request.to === "json" ? "csv" : request.to;
+		let bytes = await runSoffice(options, request.bytes, inputExt, convertTo, outputExt, request.signal);
+		let mimeType = MIME_BY_TARGET[request.to] ?? "application/octet-stream";
+		if (request.to === "json") {
+			const rows = new TextDecoder().decode(bytes).split(/\r?\n/).filter((line) => line.length > 0).map((line) => line.split(","));
+			bytes = new TextEncoder().encode(JSON.stringify(rows));
+			mimeType = MIME_BY_TARGET.json;
+		}
+		return { outputs: [{
+			bytes,
+			mimeType
+		}] };
+	};
+	const group = (exts, to) => ({
+		from: MIMES_OF(exts),
+		to,
+		convert
+	});
+	return {
+		id: "soffice",
+		converts: [
+			group(["docx"], TARGETS_BY_EXT.docx),
+			group(["odt"], TARGETS_BY_EXT.odt),
+			group(["doc"], TARGETS_BY_EXT.doc),
+			group(["rtf"], TARGETS_BY_EXT.rtf),
+			group(["xlsx"], TARGETS_BY_EXT.xlsx),
+			group(["ods"], TARGETS_BY_EXT.ods),
+			group(["xls"], TARGETS_BY_EXT.xls),
+			group(["pptx"], TARGETS_BY_EXT.pptx),
+			group(["odp"], TARGETS_BY_EXT.odp),
+			group(["ppt"], TARGETS_BY_EXT.ppt),
+			group(["pdf"], TARGETS_BY_EXT.pdf)
+		]
+	};
+};
+//#endregion
+exports.sofficeEngine = sofficeEngine;
+
+//# sourceMappingURL=soffice.cjs.map

package/batteries/media/engines/soffice.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"soffice.cjs","names":[],"sources":["../../../../src/batteries/media/engines/soffice.ts"],"sourcesContent":["/**\n * The LibreOffice-backed {@link @nhtio/adk/batteries/media/contracts!MediaEngine}: document,\n * spreadsheet, and presentation conversion via the `soffice` binary.\n *\n * @module @nhtio/adk/batteries/media/engines/soffice\n *\n * @remarks\n * Document conversion is the one capability in the media battery with no mature\n * cross-environment equivalent, so this engine is binary-backed by design. It composes the\n * two BYO runtime contracts: a {@link @nhtio/adk/batteries/media/contracts!BinaryExecutor}\n * runs the invocation (bundled: `execa_executor`) and a\n * {@link @nhtio/adk/batteries/media/contracts!ScratchWorkspace} exchanges bytes with it\n * (bundled: `fs_workspace`). The executor and workspace must agree on path visibility —\n * that pairing is the consumer's composition decision.\n *\n * One engine, one capability kind: the conversion matrix is declared as convert capability\n * groups (each format silo converts within itself plus to PDF/HTML; PDF converts to\n * html/txt/docx/odt). The spreadsheet group covers ODS/legacy-xls to xlsx — what used to be\n * a separate \"normalize\" engine is just an edge in the matrix.\n */\n\nimport { E_INVALID_MEDIA_PIPELINE_CONFIG } from '../exceptions'\nimport { implementsBinaryExecutor, implementsScratchWorkspace } from '../contracts'\nimport type {\n  MediaEngine,\n  ConvertCapability,\n  ConvertRequest,\n  ConvertResult,\n  BinaryExecutor,\n  ScratchWorkspaceFactory,\n} from '../contracts'\n\n/** Options for {@link sofficeEngine}. */\nexport interface SofficeEngineOptions {\n  /** Path (or resolvable name) of the soffice binary. */\n  path: string\n  /** Runs the soffice invocation. Required — no platform default. */\n  executor: BinaryExecutor\n  /** Mints a scratch dir per invocation whose paths the executor can open. Required. */\n  workspace: ScratchWorkspaceFactory\n  /** Per-invocation timeout. Default 120000. */\n  timeoutMs?: number\n}\n\nconst MIME_BY_TARGET: Record<string, string> = {\n  pdf: 'application/pdf',\n  html: 'text/html',\n  txt: 'text/plain',\n  md: 'text/markdown',\n  csv: 'text/csv',\n  json: 'application/json',\n  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  doc: 'application/msword',\n  rtf: 'application/rtf',\n  odt: 'application/vnd.oasis.opendocument.text',\n  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  xls: 'application/vnd.ms-excel',\n  ods: 'application/vnd.oasis.opendocument.spreadsheet',\n  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  ppt: 'application/vnd.ms-powerpoint',\n  odp: 'application/vnd.oasis.opendocument.presentation',\n}\n\nconst EXT_BY_MIME: Record<string, string> = {\n  'application/pdf': 'pdf',\n  'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',\n  'application/msword': 'doc',\n  'application/rtf': 'rtf',\n  'text/rtf': 'rtf',\n  'application/vnd.oasis.opendocument.text': 'odt',\n  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',\n  'application/vnd.ms-excel': 'xls',\n  'application/vnd.oasis.opendocument.spreadsheet': 'ods',\n  'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',\n  'application/vnd.ms-powerpoint': 'ppt',\n  'application/vnd.oasis.opendocument.presentation': 'odp',\n  'text/plain': 'txt',\n  'text/html': 'html',\n  'text/csv': 'csv',\n}\n\n/** Server-parity conversion matrix: same-silo targets plus pdf/html. */\nconst TARGETS_BY_EXT: Record<string, readonly string[]> = {\n  docx: ['pdf', 'html', 'txt', 'md', 'odt', 'doc', 'rtf'],\n  odt: ['pdf', 'html', 'txt', 'md', 'docx', 'doc', 'rtf'],\n  doc: ['pdf', 'html', 'txt', 'md', 'docx', 'odt', 'rtf'],\n  rtf: ['pdf', 'html', 'txt', 'md', 'docx', 'odt', 'doc'],\n  xlsx: ['pdf', 'html', 'csv', 'json', 'ods', 'xls'],\n  ods: ['pdf', 'html', 'csv', 'json', 'xlsx', 'xls'],\n  xls: ['pdf', 'html', 'csv', 'json', 'xlsx', 'ods'],\n  pptx: ['pdf', 'html', 'odp', 'ppt'],\n  odp: ['pdf', 'html', 'pptx', 'ppt'],\n  ppt: ['pdf', 'html', 'pptx', 'odp'],\n  pdf: ['html', 'txt', 'docx', 'odt'],\n}\n\n/** soffice convert-to filter token per target (md goes via txt; json via csv). */\nconst CONVERT_TOKEN: Record<string, string> = {\n  md: 'txt:Text',\n  json: 'csv',\n}\n\nconst validateOptions = (options: SofficeEngineOptions, name: string): void => {\n  if (typeof options?.path !== 'string' || options.path.length === 0) {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires the soffice binary path`])\n  }\n  if (!implementsBinaryExecutor(options.executor)) {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n      `${name} requires an executor implementing the BinaryExecutor contract`,\n    ])\n  }\n  if (typeof options.workspace !== 'function') {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n      `${name} requires a workspace factory (e.g. fsScratchWorkspace({ root }))`,\n    ])\n  }\n}\n\nconst runSoffice = async (\n  options: SofficeEngineOptions,\n  bytes: Uint8Array,\n  inputExt: string,\n  convertTo: string,\n  outputExt: string,\n  signal?: AbortSignal\n): Promise<Uint8Array> => {\n  const workspace = await options.workspace()\n  if (!implementsScratchWorkspace(workspace)) {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n      'the workspace factory minted a value that does not implement ScratchWorkspace',\n    ])\n  }\n  try {\n    const inputPath = await workspace.materialize(bytes, `input.${inputExt}`)\n    const result = await options.executor.exec({\n      cmd: options.path,\n      args: [\n        '--headless',\n        '--nologo',\n        '--nodefault',\n        '--norestore',\n        '--nolockcheck',\n        '--convert-to',\n        convertTo,\n        '--outdir',\n        workspace.dir(),\n        inputPath,\n      ],\n      timeoutMs: options.timeoutMs ?? 120_000,\n      signal,\n    })\n    if (result.failed) {\n      const detail = result.stderr || result.stdout || `exit code ${result.exitCode}`\n      throw new Error(`LibreOffice conversion failed: ${detail}`)\n    }\n    const files = await workspace.list()\n    const produced = files.find(\n      (f) => f.toLowerCase().endsWith(`.${outputExt}`) && f !== `input.${inputExt}`\n    )\n    if (!produced) {\n      throw new Error(\n        `LibreOffice reported success but produced no .${outputExt} output (files: ${files.join(', ')})`\n      )\n    }\n    return workspace.read(`${workspace.dir()}/${produced}`)\n  } finally {\n    await workspace.dispose()\n  }\n}\n\n/** The MIME types of one extension group, for capability `from` declarations. */\nconst MIMES_OF = (exts: readonly string[]): string[] =>\n  Object.entries(EXT_BY_MIME)\n    .filter(([, ext]) => exts.includes(ext))\n    .map(([mime]) => mime)\n\n/**\n * Construct the LibreOffice engine.\n *\n * @param options - Binary path, executor, workspace factory, timeout.\n * @returns The engine, declaring one convert capability group per format silo.\n */\nexport const sofficeEngine = (options: SofficeEngineOptions): MediaEngine => {\n  validateOptions(options, 'sofficeEngine')\n\n  const convert = async (request: ConvertRequest): Promise<ConvertResult> => {\n    const mime = request.mimeType.toLowerCase().split(';')[0].trim()\n    const inputExt = EXT_BY_MIME[mime]\n    if (!inputExt) throw new Error(`unsupported input MIME for conversion: ${request.mimeType}`)\n    const targets = TARGETS_BY_EXT[inputExt] ?? []\n    if (!targets.includes(request.to)) {\n      throw new Error(\n        `cannot convert ${inputExt} to ${request.to}; supported: ${targets.join(', ')}`\n      )\n    }\n    const convertTo = CONVERT_TOKEN[request.to] ?? request.to\n    const outputExt = request.to === 'md' ? 'txt' : request.to === 'json' ? 'csv' : request.to\n    let bytes = await runSoffice(\n      options,\n      request.bytes,\n      inputExt,\n      convertTo,\n      outputExt,\n      request.signal\n    )\n    let mimeType = MIME_BY_TARGET[request.to] ?? 'application/octet-stream'\n    if (request.to === 'json') {\n      // soffice emits CSV; lower to a JSON array-of-arrays for predictable structure.\n      const text = new TextDecoder().decode(bytes)\n      const rows = text\n        .split(/\\r?\\n/)\n        .filter((line) => line.length > 0)\n        .map((line) => line.split(','))\n      bytes = new TextEncoder().encode(JSON.stringify(rows))\n      mimeType = MIME_BY_TARGET.json\n    }\n    return { outputs: [{ bytes, mimeType }] }\n  }\n\n  // One capability group per uniform from×to block of the matrix.\n  const group = (exts: readonly string[], to: readonly string[]): ConvertCapability => ({\n    from: MIMES_OF(exts),\n    to,\n    convert,\n  })\n\n  return {\n    id: 'soffice',\n    converts: [\n      group(['docx'], TARGETS_BY_EXT.docx),\n      group(['odt'], TARGETS_BY_EXT.odt),\n      group(['doc'], TARGETS_BY_EXT.doc),\n      group(['rtf'], TARGETS_BY_EXT.rtf),\n      group(['xlsx'], TARGETS_BY_EXT.xlsx),\n      group(['ods'], TARGETS_BY_EXT.ods),\n      group(['xls'], TARGETS_BY_EXT.xls),\n      group(['pptx'], TARGETS_BY_EXT.pptx),\n      group(['odp'], TARGETS_BY_EXT.odp),\n      group(['ppt'], TARGETS_BY_EXT.ppt),\n      group(['pdf'], TARGETS_BY_EXT.pdf),\n    ],\n  }\n}\n"],"mappings":"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"}

package/batteries/media/engines/soffice.d.ts

@@ -0,0 +1,39 @@
+/**
+ * The LibreOffice-backed {@link @nhtio/adk/batteries/media/contracts!MediaEngine}: document,
+ * spreadsheet, and presentation conversion via the `soffice` binary.
+ *
+ * @module @nhtio/adk/batteries/media/engines/soffice
+ *
+ * @remarks
+ * Document conversion is the one capability in the media battery with no mature
+ * cross-environment equivalent, so this engine is binary-backed by design. It composes the
+ * two BYO runtime contracts: a {@link @nhtio/adk/batteries/media/contracts!BinaryExecutor}
+ * runs the invocation (bundled: `execa_executor`) and a
+ * {@link @nhtio/adk/batteries/media/contracts!ScratchWorkspace} exchanges bytes with it
+ * (bundled: `fs_workspace`). The executor and workspace must agree on path visibility —
+ * that pairing is the consumer's composition decision.
+ *
+ * One engine, one capability kind: the conversion matrix is declared as convert capability
+ * groups (each format silo converts within itself plus to PDF/HTML; PDF converts to
+ * html/txt/docx/odt). The spreadsheet group covers ODS/legacy-xls to xlsx — what used to be
+ * a separate "normalize" engine is just an edge in the matrix.
+ */
+import type { MediaEngine, BinaryExecutor, ScratchWorkspaceFactory } from "../contracts";
+/** Options for {@link sofficeEngine}. */
+export interface SofficeEngineOptions {
+    /** Path (or resolvable name) of the soffice binary. */
+    path: string;
+    /** Runs the soffice invocation. Required — no platform default. */
+    executor: BinaryExecutor;
+    /** Mints a scratch dir per invocation whose paths the executor can open. Required. */
+    workspace: ScratchWorkspaceFactory;
+    /** Per-invocation timeout. Default 120000. */
+    timeoutMs?: number;
+}
+/**
+ * Construct the LibreOffice engine.
+ *
+ * @param options - Binary path, executor, workspace factory, timeout.
+ * @returns The engine, declaring one convert capability group per format silo.
+ */
+export declare const sofficeEngine: (options: SofficeEngineOptions) => MediaEngine;

package/batteries/media/engines/soffice.mjs

@@ -0,0 +1,244 @@
+import { implementsBinaryExecutor, implementsScratchWorkspace } from "../contracts.mjs";
+import { t as E_INVALID_MEDIA_PIPELINE_CONFIG } from "../../../exceptions-C7FSHEnV.mjs";
+//#region src/batteries/media/engines/soffice.ts
+/**
+* The LibreOffice-backed {@link @nhtio/adk/batteries/media/contracts!MediaEngine}: document,
+* spreadsheet, and presentation conversion via the `soffice` binary.
+*
+* @module @nhtio/adk/batteries/media/engines/soffice
+*
+* @remarks
+* Document conversion is the one capability in the media battery with no mature
+* cross-environment equivalent, so this engine is binary-backed by design. It composes the
+* two BYO runtime contracts: a {@link @nhtio/adk/batteries/media/contracts!BinaryExecutor}
+* runs the invocation (bundled: `execa_executor`) and a
+* {@link @nhtio/adk/batteries/media/contracts!ScratchWorkspace} exchanges bytes with it
+* (bundled: `fs_workspace`). The executor and workspace must agree on path visibility —
+* that pairing is the consumer's composition decision.
+*
+* One engine, one capability kind: the conversion matrix is declared as convert capability
+* groups (each format silo converts within itself plus to PDF/HTML; PDF converts to
+* html/txt/docx/odt). The spreadsheet group covers ODS/legacy-xls to xlsx — what used to be
+* a separate "normalize" engine is just an edge in the matrix.
+*/
+var MIME_BY_TARGET = {
+	pdf: "application/pdf",
+	html: "text/html",
+	txt: "text/plain",
+	md: "text/markdown",
+	csv: "text/csv",
+	json: "application/json",
+	docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+	doc: "application/msword",
+	rtf: "application/rtf",
+	odt: "application/vnd.oasis.opendocument.text",
+	xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+	xls: "application/vnd.ms-excel",
+	ods: "application/vnd.oasis.opendocument.spreadsheet",
+	pptx: "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+	ppt: "application/vnd.ms-powerpoint",
+	odp: "application/vnd.oasis.opendocument.presentation"
+};
+var EXT_BY_MIME = {
+	"application/pdf": "pdf",
+	"application/vnd.openxmlformats-officedocument.wordprocessingml.document": "docx",
+	"application/msword": "doc",
+	"application/rtf": "rtf",
+	"text/rtf": "rtf",
+	"application/vnd.oasis.opendocument.text": "odt",
+	"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "xlsx",
+	"application/vnd.ms-excel": "xls",
+	"application/vnd.oasis.opendocument.spreadsheet": "ods",
+	"application/vnd.openxmlformats-officedocument.presentationml.presentation": "pptx",
+	"application/vnd.ms-powerpoint": "ppt",
+	"application/vnd.oasis.opendocument.presentation": "odp",
+	"text/plain": "txt",
+	"text/html": "html",
+	"text/csv": "csv"
+};
+/** Server-parity conversion matrix: same-silo targets plus pdf/html. */
+var TARGETS_BY_EXT = {
+	docx: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"odt",
+		"doc",
+		"rtf"
+	],
+	odt: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"docx",
+		"doc",
+		"rtf"
+	],
+	doc: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"docx",
+		"odt",
+		"rtf"
+	],
+	rtf: [
+		"pdf",
+		"html",
+		"txt",
+		"md",
+		"docx",
+		"odt",
+		"doc"
+	],
+	xlsx: [
+		"pdf",
+		"html",
+		"csv",
+		"json",
+		"ods",
+		"xls"
+	],
+	ods: [
+		"pdf",
+		"html",
+		"csv",
+		"json",
+		"xlsx",
+		"xls"
+	],
+	xls: [
+		"pdf",
+		"html",
+		"csv",
+		"json",
+		"xlsx",
+		"ods"
+	],
+	pptx: [
+		"pdf",
+		"html",
+		"odp",
+		"ppt"
+	],
+	odp: [
+		"pdf",
+		"html",
+		"pptx",
+		"ppt"
+	],
+	ppt: [
+		"pdf",
+		"html",
+		"pptx",
+		"odp"
+	],
+	pdf: [
+		"html",
+		"txt",
+		"docx",
+		"odt"
+	]
+};
+/** soffice convert-to filter token per target (md goes via txt; json via csv). */
+var CONVERT_TOKEN = {
+	md: "txt:Text",
+	json: "csv"
+};
+var validateOptions = (options, name) => {
+	if (typeof options?.path !== "string" || options.path.length === 0) throw new E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires the soffice binary path`]);
+	if (!implementsBinaryExecutor(options.executor)) throw new E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires an executor implementing the BinaryExecutor contract`]);
+	if (typeof options.workspace !== "function") throw new E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires a workspace factory (e.g. fsScratchWorkspace({ root }))`]);
+};
+var runSoffice = async (options, bytes, inputExt, convertTo, outputExt, signal) => {
+	const workspace = await options.workspace();
+	if (!implementsScratchWorkspace(workspace)) throw new E_INVALID_MEDIA_PIPELINE_CONFIG(["the workspace factory minted a value that does not implement ScratchWorkspace"]);
+	try {
+		const inputPath = await workspace.materialize(bytes, `input.${inputExt}`);
+		const result = await options.executor.exec({
+			cmd: options.path,
+			args: [
+				"--headless",
+				"--nologo",
+				"--nodefault",
+				"--norestore",
+				"--nolockcheck",
+				"--convert-to",
+				convertTo,
+				"--outdir",
+				workspace.dir(),
+				inputPath
+			],
+			timeoutMs: options.timeoutMs ?? 12e4,
+			signal
+		});
+		if (result.failed) {
+			const detail = result.stderr || result.stdout || `exit code ${result.exitCode}`;
+			throw new Error(`LibreOffice conversion failed: ${detail}`);
+		}
+		const files = await workspace.list();
+		const produced = files.find((f) => f.toLowerCase().endsWith(`.${outputExt}`) && f !== `input.${inputExt}`);
+		if (!produced) throw new Error(`LibreOffice reported success but produced no .${outputExt} output (files: ${files.join(", ")})`);
+		return workspace.read(`${workspace.dir()}/${produced}`);
+	} finally {
+		await workspace.dispose();
+	}
+};
+/** The MIME types of one extension group, for capability `from` declarations. */
+var MIMES_OF = (exts) => Object.entries(EXT_BY_MIME).filter(([, ext]) => exts.includes(ext)).map(([mime]) => mime);
+/**
+* Construct the LibreOffice engine.
+*
+* @param options - Binary path, executor, workspace factory, timeout.
+* @returns The engine, declaring one convert capability group per format silo.
+*/
+var sofficeEngine = (options) => {
+	validateOptions(options, "sofficeEngine");
+	const convert = async (request) => {
+		const inputExt = EXT_BY_MIME[request.mimeType.toLowerCase().split(";")[0].trim()];
+		if (!inputExt) throw new Error(`unsupported input MIME for conversion: ${request.mimeType}`);
+		const targets = TARGETS_BY_EXT[inputExt] ?? [];
+		if (!targets.includes(request.to)) throw new Error(`cannot convert ${inputExt} to ${request.to}; supported: ${targets.join(", ")}`);
+		const convertTo = CONVERT_TOKEN[request.to] ?? request.to;
+		const outputExt = request.to === "md" ? "txt" : request.to === "json" ? "csv" : request.to;
+		let bytes = await runSoffice(options, request.bytes, inputExt, convertTo, outputExt, request.signal);
+		let mimeType = MIME_BY_TARGET[request.to] ?? "application/octet-stream";
+		if (request.to === "json") {
+			const rows = new TextDecoder().decode(bytes).split(/\r?\n/).filter((line) => line.length > 0).map((line) => line.split(","));
+			bytes = new TextEncoder().encode(JSON.stringify(rows));
+			mimeType = MIME_BY_TARGET.json;
+		}
+		return { outputs: [{
+			bytes,
+			mimeType
+		}] };
+	};
+	const group = (exts, to) => ({
+		from: MIMES_OF(exts),
+		to,
+		convert
+	});
+	return {
+		id: "soffice",
+		converts: [
+			group(["docx"], TARGETS_BY_EXT.docx),
+			group(["odt"], TARGETS_BY_EXT.odt),
+			group(["doc"], TARGETS_BY_EXT.doc),
+			group(["rtf"], TARGETS_BY_EXT.rtf),
+			group(["xlsx"], TARGETS_BY_EXT.xlsx),
+			group(["ods"], TARGETS_BY_EXT.ods),
+			group(["xls"], TARGETS_BY_EXT.xls),
+			group(["pptx"], TARGETS_BY_EXT.pptx),
+			group(["odp"], TARGETS_BY_EXT.odp),
+			group(["ppt"], TARGETS_BY_EXT.ppt),
+			group(["pdf"], TARGETS_BY_EXT.pdf)
+		]
+	};
+};
+//#endregion
+export { sofficeEngine };
+
+//# sourceMappingURL=soffice.mjs.map

package/batteries/media/engines/soffice.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"soffice.mjs","names":[],"sources":["../../../../src/batteries/media/engines/soffice.ts"],"sourcesContent":["/**\n * The LibreOffice-backed {@link @nhtio/adk/batteries/media/contracts!MediaEngine}: document,\n * spreadsheet, and presentation conversion via the `soffice` binary.\n *\n * @module @nhtio/adk/batteries/media/engines/soffice\n *\n * @remarks\n * Document conversion is the one capability in the media battery with no mature\n * cross-environment equivalent, so this engine is binary-backed by design. It composes the\n * two BYO runtime contracts: a {@link @nhtio/adk/batteries/media/contracts!BinaryExecutor}\n * runs the invocation (bundled: `execa_executor`) and a\n * {@link @nhtio/adk/batteries/media/contracts!ScratchWorkspace} exchanges bytes with it\n * (bundled: `fs_workspace`). The executor and workspace must agree on path visibility —\n * that pairing is the consumer's composition decision.\n *\n * One engine, one capability kind: the conversion matrix is declared as convert capability\n * groups (each format silo converts within itself plus to PDF/HTML; PDF converts to\n * html/txt/docx/odt). The spreadsheet group covers ODS/legacy-xls to xlsx — what used to be\n * a separate \"normalize\" engine is just an edge in the matrix.\n */\n\nimport { E_INVALID_MEDIA_PIPELINE_CONFIG } from '../exceptions'\nimport { implementsBinaryExecutor, implementsScratchWorkspace } from '../contracts'\nimport type {\n  MediaEngine,\n  ConvertCapability,\n  ConvertRequest,\n  ConvertResult,\n  BinaryExecutor,\n  ScratchWorkspaceFactory,\n} from '../contracts'\n\n/** Options for {@link sofficeEngine}. */\nexport interface SofficeEngineOptions {\n  /** Path (or resolvable name) of the soffice binary. */\n  path: string\n  /** Runs the soffice invocation. Required — no platform default. */\n  executor: BinaryExecutor\n  /** Mints a scratch dir per invocation whose paths the executor can open. Required. */\n  workspace: ScratchWorkspaceFactory\n  /** Per-invocation timeout. Default 120000. */\n  timeoutMs?: number\n}\n\nconst MIME_BY_TARGET: Record<string, string> = {\n  pdf: 'application/pdf',\n  html: 'text/html',\n  txt: 'text/plain',\n  md: 'text/markdown',\n  csv: 'text/csv',\n  json: 'application/json',\n  docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',\n  doc: 'application/msword',\n  rtf: 'application/rtf',\n  odt: 'application/vnd.oasis.opendocument.text',\n  xlsx: 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet',\n  xls: 'application/vnd.ms-excel',\n  ods: 'application/vnd.oasis.opendocument.spreadsheet',\n  pptx: 'application/vnd.openxmlformats-officedocument.presentationml.presentation',\n  ppt: 'application/vnd.ms-powerpoint',\n  odp: 'application/vnd.oasis.opendocument.presentation',\n}\n\nconst EXT_BY_MIME: Record<string, string> = {\n  'application/pdf': 'pdf',\n  'application/vnd.openxmlformats-officedocument.wordprocessingml.document': 'docx',\n  'application/msword': 'doc',\n  'application/rtf': 'rtf',\n  'text/rtf': 'rtf',\n  'application/vnd.oasis.opendocument.text': 'odt',\n  'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': 'xlsx',\n  'application/vnd.ms-excel': 'xls',\n  'application/vnd.oasis.opendocument.spreadsheet': 'ods',\n  'application/vnd.openxmlformats-officedocument.presentationml.presentation': 'pptx',\n  'application/vnd.ms-powerpoint': 'ppt',\n  'application/vnd.oasis.opendocument.presentation': 'odp',\n  'text/plain': 'txt',\n  'text/html': 'html',\n  'text/csv': 'csv',\n}\n\n/** Server-parity conversion matrix: same-silo targets plus pdf/html. */\nconst TARGETS_BY_EXT: Record<string, readonly string[]> = {\n  docx: ['pdf', 'html', 'txt', 'md', 'odt', 'doc', 'rtf'],\n  odt: ['pdf', 'html', 'txt', 'md', 'docx', 'doc', 'rtf'],\n  doc: ['pdf', 'html', 'txt', 'md', 'docx', 'odt', 'rtf'],\n  rtf: ['pdf', 'html', 'txt', 'md', 'docx', 'odt', 'doc'],\n  xlsx: ['pdf', 'html', 'csv', 'json', 'ods', 'xls'],\n  ods: ['pdf', 'html', 'csv', 'json', 'xlsx', 'xls'],\n  xls: ['pdf', 'html', 'csv', 'json', 'xlsx', 'ods'],\n  pptx: ['pdf', 'html', 'odp', 'ppt'],\n  odp: ['pdf', 'html', 'pptx', 'ppt'],\n  ppt: ['pdf', 'html', 'pptx', 'odp'],\n  pdf: ['html', 'txt', 'docx', 'odt'],\n}\n\n/** soffice convert-to filter token per target (md goes via txt; json via csv). */\nconst CONVERT_TOKEN: Record<string, string> = {\n  md: 'txt:Text',\n  json: 'csv',\n}\n\nconst validateOptions = (options: SofficeEngineOptions, name: string): void => {\n  if (typeof options?.path !== 'string' || options.path.length === 0) {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([`${name} requires the soffice binary path`])\n  }\n  if (!implementsBinaryExecutor(options.executor)) {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n      `${name} requires an executor implementing the BinaryExecutor contract`,\n    ])\n  }\n  if (typeof options.workspace !== 'function') {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n      `${name} requires a workspace factory (e.g. fsScratchWorkspace({ root }))`,\n    ])\n  }\n}\n\nconst runSoffice = async (\n  options: SofficeEngineOptions,\n  bytes: Uint8Array,\n  inputExt: string,\n  convertTo: string,\n  outputExt: string,\n  signal?: AbortSignal\n): Promise<Uint8Array> => {\n  const workspace = await options.workspace()\n  if (!implementsScratchWorkspace(workspace)) {\n    throw new E_INVALID_MEDIA_PIPELINE_CONFIG([\n      'the workspace factory minted a value that does not implement ScratchWorkspace',\n    ])\n  }\n  try {\n    const inputPath = await workspace.materialize(bytes, `input.${inputExt}`)\n    const result = await options.executor.exec({\n      cmd: options.path,\n      args: [\n        '--headless',\n        '--nologo',\n        '--nodefault',\n        '--norestore',\n        '--nolockcheck',\n        '--convert-to',\n        convertTo,\n        '--outdir',\n        workspace.dir(),\n        inputPath,\n      ],\n      timeoutMs: options.timeoutMs ?? 120_000,\n      signal,\n    })\n    if (result.failed) {\n      const detail = result.stderr || result.stdout || `exit code ${result.exitCode}`\n      throw new Error(`LibreOffice conversion failed: ${detail}`)\n    }\n    const files = await workspace.list()\n    const produced = files.find(\n      (f) => f.toLowerCase().endsWith(`.${outputExt}`) && f !== `input.${inputExt}`\n    )\n    if (!produced) {\n      throw new Error(\n        `LibreOffice reported success but produced no .${outputExt} output (files: ${files.join(', ')})`\n      )\n    }\n    return workspace.read(`${workspace.dir()}/${produced}`)\n  } finally {\n    await workspace.dispose()\n  }\n}\n\n/** The MIME types of one extension group, for capability `from` declarations. */\nconst MIMES_OF = (exts: readonly string[]): string[] =>\n  Object.entries(EXT_BY_MIME)\n    .filter(([, ext]) => exts.includes(ext))\n    .map(([mime]) => mime)\n\n/**\n * Construct the LibreOffice engine.\n *\n * @param options - Binary path, executor, workspace factory, timeout.\n * @returns The engine, declaring one convert capability group per format silo.\n */\nexport const sofficeEngine = (options: SofficeEngineOptions): MediaEngine => {\n  validateOptions(options, 'sofficeEngine')\n\n  const convert = async (request: ConvertRequest): Promise<ConvertResult> => {\n    const mime = request.mimeType.toLowerCase().split(';')[0].trim()\n    const inputExt = EXT_BY_MIME[mime]\n    if (!inputExt) throw new Error(`unsupported input MIME for conversion: ${request.mimeType}`)\n    const targets = TARGETS_BY_EXT[inputExt] ?? []\n    if (!targets.includes(request.to)) {\n      throw new Error(\n        `cannot convert ${inputExt} to ${request.to}; supported: ${targets.join(', ')}`\n      )\n    }\n    const convertTo = CONVERT_TOKEN[request.to] ?? request.to\n    const outputExt = request.to === 'md' ? 'txt' : request.to === 'json' ? 'csv' : request.to\n    let bytes = await runSoffice(\n      options,\n      request.bytes,\n      inputExt,\n      convertTo,\n      outputExt,\n      request.signal\n    )\n    let mimeType = MIME_BY_TARGET[request.to] ?? 'application/octet-stream'\n    if (request.to === 'json') {\n      // soffice emits CSV; lower to a JSON array-of-arrays for predictable structure.\n      const text = new TextDecoder().decode(bytes)\n      const rows = text\n        .split(/\\r?\\n/)\n        .filter((line) => line.length > 0)\n        .map((line) => line.split(','))\n      bytes = new TextEncoder().encode(JSON.stringify(rows))\n      mimeType = MIME_BY_TARGET.json\n    }\n    return { outputs: [{ bytes, mimeType }] }\n  }\n\n  // One capability group per uniform from×to block of the matrix.\n  const group = (exts: readonly string[], to: readonly string[]): ConvertCapability => ({\n    from: MIMES_OF(exts),\n    to,\n    convert,\n  })\n\n  return {\n    id: 'soffice',\n    converts: [\n      group(['docx'], TARGETS_BY_EXT.docx),\n      group(['odt'], TARGETS_BY_EXT.odt),\n      group(['doc'], TARGETS_BY_EXT.doc),\n      group(['rtf'], TARGETS_BY_EXT.rtf),\n      group(['xlsx'], TARGETS_BY_EXT.xlsx),\n      group(['ods'], TARGETS_BY_EXT.ods),\n      group(['xls'], TARGETS_BY_EXT.xls),\n      group(['pptx'], TARGETS_BY_EXT.pptx),\n      group(['odp'], TARGETS_BY_EXT.odp),\n      group(['ppt'], TARGETS_BY_EXT.ppt),\n      group(['pdf'], TARGETS_BY_EXT.pdf),\n    ],\n  }\n}\n"],"mappings":"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"}