ooxml-core 0.10.0 → 0.12.0

package/dist/automation/node.cjs

@@ -0,0 +1,103 @@
+'use strict';
+
+var promises = require('fs/promises');
+var path = require('path');
+var crypto = require('crypto');
+
+// src/automation/node.ts
+function createFileOperations(rootDir = process.cwd()) {
+  const pending = /* @__PURE__ */ new Map();
+  const maxBytes = 64 * 1024 * 1024;
+  async function pathFor(file, extensions) {
+    const root = await promises.realpath(path.resolve(rootDir));
+    const path$1 = path.resolve(root, file);
+    const parent = await promises.realpath(path.dirname(path$1));
+    let actual = path.resolve(parent, path.basename(path$1));
+    const inside = (target) => {
+      const rel = path.relative(root, target);
+      if (rel === ".." || rel.startsWith("../") || rel.startsWith("..\\") || path.isAbsolute(rel))
+        throw new Error("Path is outside the configured root");
+    };
+    inside(actual);
+    try {
+      actual = await promises.realpath(actual);
+      inside(actual);
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+    if (!extensions.includes(path.extname(actual).toLowerCase()))
+      throw new Error("Unsupported file extension");
+    return actual;
+  }
+  async function read(path) {
+    const handle = await promises.open(path, "r");
+    try {
+      if ((await handle.stat()).size > maxBytes) throw new Error("File exceeds 64 MiB");
+      const bytes = await handle.readFile();
+      if (bytes.length > maxBytes) throw new Error("File exceeds 64 MiB");
+      return new Uint8Array(bytes);
+    } finally {
+      await handle.close();
+    }
+  }
+  async function write(path, bytes, replace) {
+    if (bytes.length > maxBytes) throw new Error("Output exceeds 64 MiB");
+    const temp = `${path}.${crypto.randomUUID()}.tmp`;
+    const handle = await promises.open(temp, "wx", 384);
+    try {
+      await handle.writeFile(bytes);
+      await handle.sync();
+    } catch (error) {
+      await handle.close();
+      await promises.unlink(temp).catch(() => {
+      });
+      throw error;
+    }
+    await handle.close();
+    try {
+      if (replace) await promises.rename(temp, path);
+      else await promises.link(temp, path);
+    } finally {
+      await promises.unlink(temp).catch(() => {
+      });
+    }
+  }
+  async function serial(path, action) {
+    if (process.platform === "win32") path = path.toLowerCase();
+    const before = pending.get(path) ?? Promise.resolve();
+    const current = before.catch(() => {
+    }).then(action);
+    pending.set(path, current);
+    try {
+      return await current;
+    } finally {
+      if (pending.get(path) === current) pending.delete(path);
+    }
+  }
+  return {
+    async inspect(file, extensions, inspect) {
+      const path = await pathFor(file, extensions);
+      return serial(path, async () => inspect(await read(path)));
+    },
+    async create(file, extensions, create) {
+      const path = await pathFor(file, extensions);
+      return serial(path, async () => {
+        await write(path, await create(), false);
+        return { filePath: path, saved: true };
+      });
+    },
+    async edit(file, extensions, edit, outputPath) {
+      const path$1 = await pathFor(file, extensions);
+      const output = outputPath ? await pathFor(outputPath, extensions) : path$1;
+      if (path.extname(output).toLowerCase() !== path.extname(path$1).toLowerCase())
+        throw new Error("Save-as must keep the source file extension");
+      return serial(path$1, async () => {
+        const { bytes, ...result } = await edit(await read(path$1));
+        await write(output, bytes, output === path$1);
+        return { ...result, filePath: output, saved: true };
+      });
+    }
+  };
+}
+
+exports.createFileOperations = createFileOperations;

package/dist/automation/node.d.ts

@@ -0,0 +1,16 @@
+export interface ByteEditResult {
+    bytes: Uint8Array;
+}
+/** Local filesystem boundary used by the repository-owned MCP adapters. */
+export declare function createFileOperations(rootDir?: string): {
+    inspect<T>(file: string, extensions: readonly string[], inspect: (bytes: Uint8Array) => Promise<T>): Promise<T>;
+    create(file: string, extensions: readonly string[], create: () => Promise<Uint8Array>): Promise<{
+        filePath: string;
+        saved: boolean;
+    }>;
+    edit<T extends ByteEditResult>(file: string, extensions: readonly string[], edit: (bytes: Uint8Array) => Promise<T>, outputPath?: string): Promise<Omit<T, "bytes"> & {
+        filePath: string;
+        saved: boolean;
+    }>;
+};
+//# sourceMappingURL=node.d.ts.map

package/dist/automation/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/automation/node.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,cAAc;IAC9B,KAAK,EAAE,UAAU,CAAC;CAClB;AAED,2EAA2E;AAC3E,wBAAgB,oBAAoB,CAAC,OAAO,SAAgB;YAmE5C,CAAC,QACR,MAAM,cACA,SAAS,MAAM,EAAE,WACpB,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC;iBAKxB,MAAM,cAAc,SAAS,MAAM,EAAE,UAAU,MAAM,OAAO,CAAC,UAAU,CAAC;;;;SAOhF,CAAC,SAAS,cAAc,QAC5B,MAAM,cACA,SAAS,MAAM,EAAE,QACvB,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC,CAAC,CAAC,eAC1B,MAAM;;;;EAarB"}

package/dist/automation/node.mjs

@@ -0,0 +1,101 @@
+import { realpath, open, unlink, rename, link } from 'fs/promises';
+import { extname, resolve, dirname, basename, relative, isAbsolute } from 'path';
+import { randomUUID } from 'crypto';
+
+// src/automation/node.ts
+function createFileOperations(rootDir = process.cwd()) {
+  const pending = /* @__PURE__ */ new Map();
+  const maxBytes = 64 * 1024 * 1024;
+  async function pathFor(file, extensions) {
+    const root = await realpath(resolve(rootDir));
+    const path = resolve(root, file);
+    const parent = await realpath(dirname(path));
+    let actual = resolve(parent, basename(path));
+    const inside = (target) => {
+      const rel = relative(root, target);
+      if (rel === ".." || rel.startsWith("../") || rel.startsWith("..\\") || isAbsolute(rel))
+        throw new Error("Path is outside the configured root");
+    };
+    inside(actual);
+    try {
+      actual = await realpath(actual);
+      inside(actual);
+    } catch (error) {
+      if (error.code !== "ENOENT") throw error;
+    }
+    if (!extensions.includes(extname(actual).toLowerCase()))
+      throw new Error("Unsupported file extension");
+    return actual;
+  }
+  async function read(path) {
+    const handle = await open(path, "r");
+    try {
+      if ((await handle.stat()).size > maxBytes) throw new Error("File exceeds 64 MiB");
+      const bytes = await handle.readFile();
+      if (bytes.length > maxBytes) throw new Error("File exceeds 64 MiB");
+      return new Uint8Array(bytes);
+    } finally {
+      await handle.close();
+    }
+  }
+  async function write(path, bytes, replace) {
+    if (bytes.length > maxBytes) throw new Error("Output exceeds 64 MiB");
+    const temp = `${path}.${randomUUID()}.tmp`;
+    const handle = await open(temp, "wx", 384);
+    try {
+      await handle.writeFile(bytes);
+      await handle.sync();
+    } catch (error) {
+      await handle.close();
+      await unlink(temp).catch(() => {
+      });
+      throw error;
+    }
+    await handle.close();
+    try {
+      if (replace) await rename(temp, path);
+      else await link(temp, path);
+    } finally {
+      await unlink(temp).catch(() => {
+      });
+    }
+  }
+  async function serial(path, action) {
+    if (process.platform === "win32") path = path.toLowerCase();
+    const before = pending.get(path) ?? Promise.resolve();
+    const current = before.catch(() => {
+    }).then(action);
+    pending.set(path, current);
+    try {
+      return await current;
+    } finally {
+      if (pending.get(path) === current) pending.delete(path);
+    }
+  }
+  return {
+    async inspect(file, extensions, inspect) {
+      const path = await pathFor(file, extensions);
+      return serial(path, async () => inspect(await read(path)));
+    },
+    async create(file, extensions, create) {
+      const path = await pathFor(file, extensions);
+      return serial(path, async () => {
+        await write(path, await create(), false);
+        return { filePath: path, saved: true };
+      });
+    },
+    async edit(file, extensions, edit, outputPath) {
+      const path = await pathFor(file, extensions);
+      const output = outputPath ? await pathFor(outputPath, extensions) : path;
+      if (extname(output).toLowerCase() !== extname(path).toLowerCase())
+        throw new Error("Save-as must keep the source file extension");
+      return serial(path, async () => {
+        const { bytes, ...result } = await edit(await read(path));
+        await write(output, bytes, output === path);
+        return { ...result, filePath: output, saved: true };
+      });
+    }
+  };
+}
+
+export { createFileOperations };

package/dist/automation/visio.d.ts

@@ -0,0 +1,30 @@
+import type { VisioShape } from '../visio/model.js';
+/** JSON-safe scene inspection without embedding binary images in tool responses. */
+export interface VisioShapeSummary {
+    id: string;
+    name: string;
+    kind: VisioShape['kind'];
+    width: number;
+    height: number;
+    transform: VisioShape['transform'];
+    text: string;
+    hidden: boolean;
+    shapeData: VisioShape['shapeData'];
+    hyperlinks: VisioShape['hyperlinks'];
+    children: VisioShapeSummary[];
+}
+export declare function inspectVisio(bytes: Uint8Array): Promise<{
+    pages: {
+        id: string;
+        name: string;
+        width: number;
+        height: number;
+        isBackground: boolean;
+        backgroundPageId: string | undefined;
+        shapes: VisioShapeSummary[];
+        connectors: import("../visio/model.js").VisioConnection[];
+        layers: import("../visio/model.js").VisioLayer[] | undefined;
+    }[];
+    diagnostics: import("../visio/model.js").VisioDiagnostic[];
+}>;
+//# sourceMappingURL=visio.d.ts.map

package/dist/automation/visio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"visio.d.ts","sourceRoot":"","sources":["../../src/automation/visio.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEpD,oFAAoF;AACpF,MAAM,WAAW,iBAAiB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,UAAU,CAAC,WAAW,CAAC,CAAC;IACnC,UAAU,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC;IACrC,QAAQ,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAkBD,wBAAsB,YAAY,CAAC,KAAK,EAAE,UAAU;;;;;;;;;;;;;GAgBnD"}

package/dist/automation/xlsx.d.ts

@@ -0,0 +1,25 @@
+export declare function inspectXlsx(bytes: Uint8Array): Promise<{
+    sheets: {
+        index: number;
+        name: string;
+    }[];
+    properties: import("../xlsx/model.js").WorkbookProperties;
+    warnings: string[];
+}>;
+export declare function createXlsx(names: readonly string[]): Promise<Uint8Array>;
+export declare function readXlsxRange(bytes: Uint8Array, sheetIndex: number, reference: string): Promise<{
+    cells: {
+        address: string;
+        value: string | number | boolean | import("../xlsx/model.js").CellError | null;
+        formula: string | undefined;
+    }[];
+    warnings: string[];
+}>;
+export declare function setXlsxCells(bytes: Uint8Array, sheetIndex: number, cells: readonly {
+    address: string;
+    input: string;
+}[]): Promise<{
+    bytes: Uint8Array<ArrayBufferLike>;
+    warnings: string[];
+}>;
+//# sourceMappingURL=xlsx.d.ts.map

package/dist/automation/xlsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xlsx.d.ts","sourceRoot":"","sources":["../../src/automation/xlsx.ts"],"names":[],"mappings":"AAOA,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU;;;;;;;GAOlD;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,CAAC,CAW9E;AAED,wBAAsB,aAAa,CAAC,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;;;;;;;GAoB3F;AAED,wBAAsB,YAAY,CACjC,KAAK,EAAE,UAAU,EACjB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAAE;;;GAgBpD"}