mcp-3d-printer-server 1.2.5 → 1.2.11

package/dist/printers/bambu-node-guard.d.ts

@@ -0,0 +1,2 @@
+export declare function isKnownBambuNodeInternalError(reason: unknown): boolean;
+export declare function installBambuNodeRejectionGuard(): void;

package/dist/printers/bambu-node-guard.js

@@ -0,0 +1,38 @@
+/**
+ * Unpatched bambu-node 3.22.21 parses every MQTT report in an async listener and
+ * throws from it for printers or state transitions it does not model: H2S/H2D/
+ * H2C/H2D Pro/P2S serial prefixes, a get_version reply without an ota module, and
+ * transitions such as PAUSE -> IDLE after a cancel. Those throws become unhandled
+ * promise rejections, which terminate Node by default. bambu-printer-mcp avoids
+ * this with a postinstall patch; this package does not install one.
+ *
+ * Safety checks here never rely on bambu-node's model or job tracking: they read
+ * fresh raw MQTT reports. Only these exact internal errors originating inside
+ * bambu-node are logged and ignored. Every other unhandled rejection is rethrown,
+ * preserving Node's default crash behavior.
+ */
+const KNOWN_INTERNAL_ERRORS = new Set([
+    "Printer model not supported!",
+    "OTA module version data not found, unable to determine printer model!",
+    "Edge case detected while updating printer status!",
+]);
+let installed = false;
+export function isKnownBambuNodeInternalError(reason) {
+    return (reason instanceof Error &&
+        KNOWN_INTERNAL_ERRORS.has(reason.message) &&
+        typeof reason.stack === "string" &&
+        /[\\/]bambu-node[\\/]/.test(reason.stack));
+}
+export function installBambuNodeRejectionGuard() {
+    if (installed)
+        return;
+    installed = true;
+    process.on("unhandledRejection", (reason) => {
+        if (isKnownBambuNodeInternalError(reason)) {
+            console.error(`[bambu-node] Ignored internal status-tracking error: ${reason.message} ` +
+                "Safety checks use fresh raw MQTT reports instead.");
+            return;
+        }
+        throw reason;
+    });
+}

package/dist/printers/bambu.d.ts

@@ -1,7 +1,13 @@
 import { PrinterImplementation } from "../types.js";
-interface BambuPrintOptionsInternal {
+import { type PrintFileInspection } from "../safety/print-file.js";
+import { type ConfirmHardware } from "../safety/confirmation.js";
+import { type ExpectedPeakTemperatures, type PrintSafetyOptions } from "../safety/expected-peaks.js";
+export interface BambuPrintOptionsInternal {
     projectName: string;
     filePath: string;
+    bambuModel?: string;
+    /** Requested nozzle diameters; compared with the sliced file when supplied. */
+    nozzleDiameters?: number[];
     useAMS?: boolean;
     plateIndex?: number;
     bedType?: string;
@@ -10,18 +16,39 @@ interface BambuPrintOptionsInternal {
     vibrationCalibration?: boolean;
     layerInspect?: boolean;
     timelapse?: boolean;
+    /** Positional mapping: project filament position -> absolute AMS tray (254 = external spool). */
     amsMapping?: number[];
     md5?: string;
+    expectedPeaks?: ExpectedPeakTemperatures;
 }
+export type BambuSafetyOptions = PrintSafetyOptions;
 export declare class BambuImplementation extends PrinterImplementation {
+    private readonly confirm?;
     private printerStore;
-    constructor(apiClient: any);
+    constructor(apiClient: any, confirm?: ConfirmHardware | undefined);
+    confirmHardwareAction(message: string, physicalCheck?: boolean): Promise<void>;
+    private finishedJobIdentity;
+    confirmPrintPreflight(serial: string, status: any, inspection: PrintFileInspection): Promise<string | undefined>;
+    assertBedClearance(status: any, confirmedFinishedJob: string | undefined): void;
     private getPrinter;
+    /** Safety reads never use the display cache or configured-serial model inference. */
+    getSafetyStatus(host: string, serial: string, token: string): Promise<any>;
+    /** Raw gcode_file printing cannot remap spools: verify the material already at the nozzle. */
+    private validateLoadedGcodeState;
     private resolveProjectFileMetadata;
     getStatus(host: string, port: string, apiKey: string): Promise<any>;
     print3mf(host: string, serial: string, token: string, options: BambuPrintOptionsInternal): Promise<any>;
+    private print3mfPrepared;
+    /**
+     * A published print command is not proof the printer took it. Listen to the
+     * reports the printer pushes anyway (no extra pushall polling on weak P1
+     * boards): a new command-verification HMS means the firmware refused the
+     * command; PREPARE/SLICING/RUNNING means it started. Attach before publishing.
+     */
+    private watchDispatch;
+    /** Stop is never gated or queued behind pending checked operations. */
     cancelJob(host: string, port: string, apiKey: string): Promise<any>;
-    setTemperature(host: string, port: string, apiKey: string, component: string, temperature: number): Promise<{
+    setTemperature(host: string, port: string, apiKey: string, component: string, temperature: unknown, options?: BambuSafetyOptions): Promise<{
         status: string;
         message: string;
         command: string;
@@ -34,12 +61,32 @@ export declare class BambuImplementation extends PrinterImplementation {
         name: string;
         exists: boolean;
     }>;
-    uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean): Promise<Record<string, unknown>>;
-    startJob(host: string, port: string, apiKey: string, filename: string): Promise<{
+    uploadFile(host: string, port: string, apiKey: string, filePath: string, filename: string, print: boolean, options?: BambuSafetyOptions): Promise<{
+        status: string;
+        uploaded: boolean;
+        printRequested: boolean;
+        dispatch: "started" | "unconfirmed";
+        remotePath: string;
+        sha256: string;
+        message: string;
+    } | {
+        status: string;
+        uploaded: boolean;
+        remotePath: string;
+        printRequested: boolean;
+    }>;
+    private printRawPrepared;
+    startJob(host: string, port: string, apiKey: string, filename: string, options?: BambuSafetyOptions): Promise<{
         status: string;
+        uploaded: boolean;
+        printRequested: boolean;
+        dispatch: "started" | "unconfirmed";
+        remotePath: string;
+        sha256: string;
         message: string;
-        file: string;
     }>;
+    private ftpsOptions;
+    private ftpDownload;
     /**
      * Upload a file to the printer via FTP using basic-ftp directly.
      * Bypasses bambu-js's sendFile which has a double-path bug (ensureDir CDs
@@ -50,4 +97,3 @@ export declare class BambuImplementation extends PrinterImplementation {
     private extractBambuCredentials;
     disconnectAll(): Promise<void>;
 }
-export {};