@apocaliss92/nodedreame 1.4.0 → 1.5.0

package/dist/index.d.cts

@@ -1289,6 +1289,19 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      * forwarded verbatim.
      */
     fetchLatestMap(opts?: Omit<VacuumGetMapInput, 'filename'>): Promise<VacuumMap | null>;
+    /**
+     * Seed {@link mapFilename} from the CLOUD SHADOW (the last value the robot
+     * pushed for siid 6 piid 3) WITHOUT waking it — so a docked/idle robot can
+     * surface its LAST cleaning map without a fresh clean. Emits the usual
+     * `propertyChanged`/`stateChanged` (so a map-watching consumer re-renders) and
+     * returns the resolved {@link mapFilename} (null when the model has no map or
+     * the shadow carries no map path yet).
+     *
+     * NOTE: the shadow holds the last LIVE-PATH filename; its OSS blob may have
+     * expired, in which case a follow-up {@link fetchLatestMap} rejects — treat
+     * that as "no saved map available".
+     */
+    refreshSavedMapFilename(): Promise<string | null>;
     /**
      * The current room/segment id, derived from the most-recently-decoded map's
      * active-segment set (`sa`). `null` when no map has been fetched or no

package/dist/index.d.ts

@@ -1289,6 +1289,19 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
      * forwarded verbatim.
      */
     fetchLatestMap(opts?: Omit<VacuumGetMapInput, 'filename'>): Promise<VacuumMap | null>;
+    /**
+     * Seed {@link mapFilename} from the CLOUD SHADOW (the last value the robot
+     * pushed for siid 6 piid 3) WITHOUT waking it — so a docked/idle robot can
+     * surface its LAST cleaning map without a fresh clean. Emits the usual
+     * `propertyChanged`/`stateChanged` (so a map-watching consumer re-renders) and
+     * returns the resolved {@link mapFilename} (null when the model has no map or
+     * the shadow carries no map path yet).
+     *
+     * NOTE: the shadow holds the last LIVE-PATH filename; its OSS blob may have
+     * expired, in which case a follow-up {@link fetchLatestMap} rejects — treat
+     * that as "no saved map available".
+     */
+    refreshSavedMapFilename(): Promise<string | null>;
     /**
      * The current room/segment id, derived from the most-recently-decoded map's
      * active-segment set (`sa`). `null` when no map has been fetched or no

package/dist/index.js

@@ -2839,6 +2839,23 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
     if (filename === null) return null;
     return this.getMap({ filename, ...opts });
   }
+  /**
+   * Seed {@link mapFilename} from the CLOUD SHADOW (the last value the robot
+   * pushed for siid 6 piid 3) WITHOUT waking it — so a docked/idle robot can
+   * surface its LAST cleaning map without a fresh clean. Emits the usual
+   * `propertyChanged`/`stateChanged` (so a map-watching consumer re-renders) and
+   * returns the resolved {@link mapFilename} (null when the model has no map or
+   * the shadow carries no map path yet).
+   *
+   * NOTE: the shadow holds the last LIVE-PATH filename; its OSS blob may have
+   * expired, in which case a follow-up {@link fetchLatestMap} rejects — treat
+   * that as "no saved map available".
+   */
+  async refreshSavedMapFilename() {
+    if (!this.#caps.canMap) return null;
+    await this.refreshCachedProperties([VACUUM_PROP.MAP_PATH]);
+    return this.mapFilename;
+  }
   /**
    * The current room/segment id, derived from the most-recently-decoded map's
    * active-segment set (`sa`). `null` when no map has been fetched or no