@metamesh/cli 0.18.0 → 0.20.0

package/dist/authoring/export-capture.js

@@ -0,0 +1,76 @@
+import { randomUUID } from "node:crypto";
+import { open, realpath, rename, rm } from "node:fs/promises";
+import { basename, dirname, extname, join, resolve } from "node:path";
+import { write3mf, writeGlb, writeStl, } from "@metamesh/modeling/export";
+import { readCapturedRun } from "./artifacts.js";
+import { AuthoringError } from "./errors.js";
+/** Streams a captured model to an atomically published file using the public mesh writers. */
+export async function exportCapturedRun(directory, options) {
+    if (!(options.format === "3mf" || options.format === "stl" || options.format === "glb"))
+        throw new AuthoringError("invocation", "INVALID_EXPORT_FORMAT", "Choose 3mf, stl, or glb.");
+    if (typeof options.output !== "string" || options.output.trim() === "")
+        throw new AuthoringError("invocation", "EXPORT_OUTPUT_REQUIRED", "Choose an output file.");
+    const path = resolve(options.output);
+    if (extname(path).toLowerCase() !== `.${options.format}`)
+        throw new AuthoringError("invocation", "INVALID_EXPORT_OUTPUT", `The output file must have a .${options.format} extension.`);
+    const captured = await readCapturedRun(directory);
+    const resources = new Map(captured.resources.map((resource) => [resource.id, resource]));
+    const parts = captured.manifest.parts.map((part) => ({
+        id: part.id,
+        geometry: resources.get(part.resourceId),
+        transform: part.transform,
+        ...(part.color === undefined ? {} : { color: part.color }),
+    }));
+    const temporary = `${path}.${randomUUID()}.pending`;
+    const writer = { "3mf": write3mf, stl: writeStl, glb: writeGlb }[options.format];
+    const settings = {
+        name: options.name ?? basename(path).replace(/\.[^.]+$/, ""),
+        limits: captured.manifest.policy.limits,
+        ...(options.signal === undefined ? {} : { signal: options.signal }),
+    };
+    let file;
+    try {
+        const destination = join(await realpath(dirname(path)), basename(path));
+        const protectedFiles = await Promise.all([
+            "manifest.json",
+            ...captured.manifest.resources.flatMap((resource) => [
+                resource.positions.path,
+                resource.indices.path,
+            ]),
+        ].map((file) => realpath(resolve(captured.directory, file))));
+        const identity = (file) => process.platform === "win32" ? file.toLowerCase() : file;
+        if (protectedFiles.some((file) => identity(file) === identity(destination)))
+            throw new AuthoringError("invocation", "CAPTURE_OUTPUT_CONFLICT", "Export output cannot replace captured model files.");
+        options.signal?.throwIfAborted();
+        file = await open(temporary, "wx");
+        const report = await writer(parts, async (chunk) => {
+            let offset = 0;
+            while (offset < chunk.byteLength) {
+                const { bytesWritten } = await file.write(chunk, offset, chunk.byteLength - offset);
+                if (bytesWritten === 0)
+                    throw new Error("The export output stopped accepting bytes.");
+                offset += bytesWritten;
+            }
+        }, settings);
+        await file.close();
+        file = undefined;
+        options.signal?.throwIfAborted();
+        await rename(temporary, path);
+        return {
+            ...report,
+            path,
+            format: options.format,
+            runId: captured.manifest.runId,
+            sourceFingerprint: captured.manifest.source.fingerprint,
+        };
+    }
+    catch (error) {
+        if (file !== undefined)
+            await file.close().catch(() => undefined);
+        await rm(temporary, { force: true });
+        if (error instanceof AuthoringError)
+            throw error;
+        throw new AuthoringError("export", "EXPORT_FAILED", error instanceof Error ? error.message : String(error));
+    }
+}
+//# sourceMappingURL=export-capture.js.map

package/dist/authoring/export-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-capture.js","sourceRoot":"","sources":["../../src/authoring/export-capture.ts"],"names":[],"mappings":"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"}