@nodetool-ai/base-nodes 0.7.0-rc.11

package/dist/nodes/model3d/io.js

@@ -0,0 +1,162 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { BaseNode, prop } from "@nodetool-ai/node-sdk";
+import { promises as fs } from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { DEFAULT_FOLDER, DEFAULT_MODEL_3D } from "./defaults.js";
+import { dateName, extFormat, filePath, modelRef, modelRefToBytes } from "./utils.js";
+const MAX_NON_OVERWRITE_ATTEMPTS = 1000;
+async function writeWithSuffixWhenNeeded(fullPath, bytes) {
+    const parsed = path.parse(fullPath);
+    for (let i = 0; i < MAX_NON_OVERWRITE_ATTEMPTS; i++) {
+        const candidate = i === 0
+            ? path.join(parsed.dir, parsed.base)
+            : path.join(parsed.dir, `${parsed.name}-${i}${parsed.ext}`);
+        try {
+            await fs.writeFile(candidate, bytes, { flag: "wx" });
+            return candidate;
+        }
+        catch (error) {
+            if (error.code !== "EEXIST") {
+                const message = error instanceof Error ? error.message : String(error);
+                throw new Error(`Failed to write model file "${candidate}": ${message}`);
+            }
+        }
+    }
+    throw new Error(`Could not find an available filename for "${parsed.base}" after ${MAX_NON_OVERWRITE_ATTEMPTS} attempts`);
+}
+export class LoadModel3DFileNode extends BaseNode {
+    static nodeType = "nodetool.model3d.LoadModel3DFile";
+    static title = "Load Model 3D File";
+    static description = "Load a 3D model file from disk.\n    3d, mesh, model, input, load, file, obj, glb, stl, ply\n\n    Use cases:\n    - Load 3D models for processing\n    - Import meshes from CAD software\n    - Read 3D assets for a workflow";
+    static metadataOutputTypes = {
+        output: "model_3d"
+    };
+    async process() {
+        const p = filePath(String(this.path ?? ""));
+        const data = new Uint8Array(await fs.readFile(p));
+        return {
+            output: modelRef(data, { uri: pathToFileURL(p).toString(), format: extFormat(p) })
+        };
+    }
+}
+__decorate([
+    prop({
+        type: "str",
+        default: "",
+        title: "Path",
+        description: "Path to the 3D model file to read"
+    })
+], LoadModel3DFileNode.prototype, "path", void 0);
+export class SaveModel3DFileNode extends BaseNode {
+    static nodeType = "nodetool.model3d.SaveModel3DFile";
+    static title = "Save Model 3D File";
+    static description = "Save a 3D model to disk.\n    3d, mesh, model, output, save, file, export\n\n    Use cases:\n    - Save processed 3D models\n    - Export meshes to different formats\n    - Archive 3D model results";
+    static metadataOutputTypes = {
+        output: "model_3d"
+    };
+    async process(context) {
+        const folder = String(this.folder ?? ".");
+        const filename = dateName(String(this.filename ?? "model.glb"));
+        const overwrite = this.overwrite === true;
+        await fs.mkdir(path.resolve(folder), { recursive: true });
+        const bytes = await modelRefToBytes(this.model, context);
+        const full = path.resolve(folder, filename);
+        const targetPath = overwrite
+            ? full
+            : await writeWithSuffixWhenNeeded(full, bytes);
+        if (overwrite) {
+            await fs.writeFile(targetPath, bytes);
+        }
+        return {
+            output: modelRef(bytes, {
+                uri: pathToFileURL(targetPath).toString(),
+                format: extFormat(targetPath)
+            })
+        };
+    }
+}
+__decorate([
+    prop({
+        type: "model_3d",
+        default: DEFAULT_MODEL_3D,
+        title: "Model",
+        description: "The 3D model to save"
+    })
+], SaveModel3DFileNode.prototype, "model", void 0);
+__decorate([
+    prop({
+        type: "str",
+        default: "",
+        title: "Folder",
+        description: "Folder where the file will be saved"
+    })
+], SaveModel3DFileNode.prototype, "folder", void 0);
+__decorate([
+    prop({
+        type: "str",
+        default: "",
+        title: "Filename",
+        description: "\n        The name of the 3D model file.\n        You can use time and date variables to create unique names:\n        %Y - Year\n        %m - Month\n        %d - Day\n        %H - Hour\n        %M - Minute\n        %S - Second\n        "
+    })
+], SaveModel3DFileNode.prototype, "filename", void 0);
+__decorate([
+    prop({
+        type: "bool",
+        default: false,
+        title: "Overwrite",
+        description: "Overwrite the file if it already exists, otherwise file will be renamed"
+    })
+], SaveModel3DFileNode.prototype, "overwrite", void 0);
+export class SaveModel3DNode extends BaseNode {
+    static nodeType = "nodetool.model3d.SaveModel3D";
+    static title = "Save Model3D Asset";
+    static description = "Save a 3D model to an asset folder with customizable name format.\n    save, 3d, mesh, model, folder, naming, asset\n\n    Use cases:\n    - Save generated 3D models with timestamps\n    - Organize outputs into specific folders\n    - Create backups of processed models";
+    static metadataOutputTypes = {
+        output: "model_3d"
+    };
+    async process(context) {
+        const folder = String(this.folder ?? ".");
+        const name = dateName(String(this.name ?? "model.glb"));
+        const full = path.resolve(folder, name);
+        await fs.mkdir(path.dirname(full), { recursive: true });
+        const bytes = await modelRefToBytes(this.model, context);
+        await fs.writeFile(full, bytes);
+        return {
+            output: modelRef(bytes, {
+                uri: pathToFileURL(full).toString(),
+                format: extFormat(full)
+            })
+        };
+    }
+}
+__decorate([
+    prop({
+        type: "model_3d",
+        default: DEFAULT_MODEL_3D,
+        title: "Model",
+        description: "The 3D model to save."
+    })
+], SaveModel3DNode.prototype, "model", void 0);
+__decorate([
+    prop({
+        type: "folder",
+        default: DEFAULT_FOLDER,
+        title: "Folder",
+        description: "The asset folder to save the 3D model in."
+    })
+], SaveModel3DNode.prototype, "folder", void 0);
+__decorate([
+    prop({
+        type: "str",
+        default: "%Y-%m-%d_%H-%M-%S.glb",
+        title: "Name",
+        description: "\n        Name of the output file.\n        You can use time and date variables to create unique names:\n        %Y - Year\n        %m - Month\n        %d - Day\n        %H - Hour\n        %M - Minute\n        %S - Second\n        "
+    })
+], SaveModel3DNode.prototype, "name", void 0);
+//# sourceMappingURL=io.js.map

package/dist/nodes/model3d/io.js.map

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

package/dist/nodes/model3d/mesh-ops.d.ts

@@ -0,0 +1,40 @@
+export type TransformGlbOptions = {
+    translateX: number;
+    translateY: number;
+    translateZ: number;
+    rotateXDeg: number;
+    rotateYDeg: number;
+    rotateZDeg: number;
+    scaleX: number;
+    scaleY: number;
+    scaleZ: number;
+    uniformScale: number;
+};
+export type RecalculateNormalsOptions = {
+    mode: string;
+    fixWinding: boolean;
+};
+export type CenterGlbOptions = {
+    useCentroid: boolean;
+};
+export type NormalizeGlbOptions = {
+    centerMode: "bounds" | "centroid" | "none";
+    axisPreset: "keep" | "z_to_y" | "y_to_z";
+    scaleToSize: boolean;
+    targetSize: number;
+    placeOnGround: boolean;
+    groundAxis: "y" | "z";
+};
+export type RepairGlbOptions = {
+    mergeDuplicateVertices: boolean;
+    removeDegenerateFaces: boolean;
+    positionTolerance: number;
+};
+export declare function transformGlb(bytes: Uint8Array, options: TransformGlbOptions): Uint8Array | null;
+export declare function recalculateNormalsGlb(bytes: Uint8Array, options: RecalculateNormalsOptions): Uint8Array | null;
+export declare function centerGlb(bytes: Uint8Array, options: CenterGlbOptions): Uint8Array | null;
+export declare function flipNormalsGlb(bytes: Uint8Array): Uint8Array | null;
+export declare function normalizeGlb(bytes: Uint8Array, options: NormalizeGlbOptions): Uint8Array | null;
+export declare function extractLargestComponentGlb(bytes: Uint8Array): Uint8Array | null;
+export declare function repairGlb(bytes: Uint8Array, options: RepairGlbOptions): Uint8Array | null;
+//# sourceMappingURL=mesh-ops.d.ts.map

package/dist/nodes/model3d/mesh-ops.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mesh-ops.d.ts","sourceRoot":"","sources":["../../../src/nodes/model3d/mesh-ops.ts"],"names":[],"mappings":"AAcA,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,QAAQ,GAAG,UAAU,GAAG,MAAM,CAAC;IAC3C,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACzC,WAAW,EAAE,OAAO,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IACvB,UAAU,EAAE,GAAG,GAAG,GAAG,CAAC;CACvB,CAAC;AAOF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,sBAAsB,EAAE,OAAO,CAAC;IAChC,qBAAqB,EAAE,OAAO,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AA+VF,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,mBAAmB,GAC3B,UAAU,GAAG,IAAI,CA+DnB;AAED,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,yBAAyB,GACjC,UAAU,GAAG,IAAI,CA0HnB;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,gBAAgB,GACxB,UAAU,GAAG,IAAI,CA0EnB;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAqCnE;AAED,wBAAgB,YAAY,CAC1B,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,mBAAmB,GAC3B,UAAU,GAAG,IAAI,CAoHnB;AAED,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,GAAG,IAAI,CAgG/E;AAED,wBAAgB,SAAS,CACvB,KAAK,EAAE,UAAU,EACjB,OAAO,EAAE,gBAAgB,GACxB,UAAU,GAAG,IAAI,CA6BnB"}