ChristopherHoffman · Oct 5, 2026 · Sep 10, 2026 · Sep 10, 2026 · Sep 10, 2026 · Sep 10, 2026
@@ -22,6 +22,14 @@ describe('Anonymous public print view', () => {
       // Registered before the visit so the attachment fetch is captured.
       cy.intercept('GET', '**/api/Prints/*/files*').as('attachments');
 
+      // The thumbnail map is authenticated-only, so a logged-out visitor must never
+      // even ask for it - that is what keeps a printer's photos off a public print.
+      cy.intercept(
+        'GET',
+        '**/api/Printers/thumbnails*',
+        cy.spy().as('thumbnailRequest')
+      );
+
       cy.visit(`/prints/${print.id}?devUserId=anonymous`);
 
       // 1) No bounce to home (#66).
@@ -41,6 +49,8 @@ describe('Anonymous public print view', () => {
       cy.get('[data-cy-edit-btn]').should('not.exist');
       cy.get('[data-cy-printer-link]').should('not.exist');
       cy.get('a[href*="/filament/"]').should('not.exist');
+      cy.get('app-printer-avatar img').should('not.exist');
+      cy.get('@thumbnailRequest').should('not.have.been.called');
 
       // 4) Cost absence is asserted but is NOT evidence of gating, and must
       //    not be cited as such. Material cost needs a recorded filament price

@@ -113,8 +113,8 @@
       "loadedInPrinter": {
         "id": 103,
         "name": "Resin Station",
-        "make": "Anycubic",
-        "model": "Photon Mono M7 Pro",
+        "make": "HeyGears",
+        "model": "Reflex RS Turbo",
         "isActive": true,
         "category": null
       },
@@ -200,8 +200,8 @@
       "loadedInPrinter": {
         "id": 101,
         "name": "Living Room",
-        "make": "Bambu Lab",
-        "model": "A1",
+        "make": "Snapmaker",
+        "model": "U1",
         "isActive": true,
         "category": null
       },
@@ -247,8 +247,8 @@
       "loadedInPrinter": {
         "id": 102,
         "name": "Workshop",
-        "make": "Prusa",
-        "model": "MK4S",
+        "make": "Anycubic",
+        "model": "Kobra S1",
         "isActive": true,
         "category": null
       },

@@ -15,3 +15,24 @@ and are committed here with permission.
 Fetched via `node scripts/fetch-demo-images.mjs`, which calls
 `GET https://api.3dprintlog.com/api/Prints/{id}/image/{imageId}`
 with header `allow-anonymous-request: true`.
+
+## Demo printer photos
+
+Photos of the machines `printers-summary.json` names, shown by `app-printer-avatar`
+wherever a printer appears. They belong to the repo owner and are committed here with
+permission.
+
+| File                         | Printer id | Machine                  |
+| ---------------------------- | ---------- | ------------------------ |
+| snapmaker_u1.jpg             | 101        | Snapmaker U1             |
+| anycubic_kobra_s1.jpg        | 102        | Anycubic Kobra S1        |
+| heygears_reflex_rs_turbo.jpg | 103        | HeyGears Reflex RS Turbo |
+
+`fetch-demo-images.mjs` does **not** refetch these - they were placed by hand, downscaled
+to the 720px-wide convention the print photos use. `PRINTER_IMAGE_MAP` in
+`cypress/fixtures/demo/manifest.ts` maps each printer id to its file, and
+`printer-thumbnails.json` points at `/api/Printers/{id}/thumbnail` so the capture harness
+serves them from the repo rather than from a real blob host.
+
+The fixture's makes and models were changed to match these photos. A screenshot showing a
+Snapmaker beside "(Bambu Lab A1)" is worse than no photo at all.
@@ -19,6 +19,7 @@ import {
   exists,
   FixtureRoute,
   imagesRendered,
+  imagesLoaded,
   noPlaceholders,
   rendered,
   visible,
@@ -37,6 +38,13 @@ export const FIXTURE_ROUTES: FixtureRoute[] = [
     url: '**/api/printers/summary*',
     fixture: 'demo/printers-summary.json',
   },
+  // Every surface that names a printer reads this map through PrinterThumbnailStore.
+  // Without a stub the capture run fails on an unhandled /api/** request.
+  {
+    method: 'GET',
+    url: '**/api/Printers/thumbnails*',
+    fixture: 'demo/printer-thumbnails.json',
+  },
   { method: 'GET', url: '**/api/Filaments?*', fixture: 'demo/filaments.json' },
   // The add-print form offers to attach the print to a project. The demo set has
   // no projects, and an empty list is the right state for a first-print figure:
@@ -91,6 +99,17 @@ export const PRINT_IMAGE_MAP: Record<string, string> = {
   '1005': 'demo/images/cat-headbands.jpg',
 };
 
+/**
+ * The three demo printers in printers-summary.json, each with a photo of the machine the
+ * fixture names. `printer-thumbnails.json` points at `/api/Printers/{id}/thumbnail`, which
+ * `stubApi` serves from this map.
+ */
+export const PRINTER_IMAGE_MAP: Record<string, string> = {
+  '101': 'demo/images/snapmaker_u1.jpg',
+  '102': 'demo/images/anycubic_kobra_s1.jpg',
+  '103': 'demo/images/heygears_reflex_rs_turbo.jpg',
+};
+
 /** The five demo prints in prints-summary.json. */
 const DEMO_PRINT_COUNT = 5;
 
@@ -135,6 +154,9 @@ const HOME_CAPTURE_TARGETS: CaptureTarget[] = [
       // 959.98px) the card view carrying app-print-card is never rendered.
       rendered('[cy-print-row]', DEMO_PRINT_COUNT),
       imagesRendered('app-print-image'),
+      // Decoded, not merely present: a photo still in flight is exactly what a
+      // capture loses silently.
+      imagesLoaded('app-printer-avatar'),
       rendered('app-filament-color-swatch', DEMO_MATERIAL_COUNT),
     ],
   },
@@ -147,6 +169,9 @@ const HOME_CAPTURE_TARGETS: CaptureTarget[] = [
     ready: [
       rendered('[cy-print-row]', DEMO_PRINT_COUNT),
       imagesRendered('app-print-image'),
+      // Decoded, not merely present: a photo still in flight is exactly what a
+      // capture loses silently.
+      imagesLoaded('app-printer-avatar'),
       rendered('app-filament-color-swatch', DEMO_MATERIAL_COUNT),
     ],
   },
@@ -183,6 +208,7 @@ export const HOME_CAPTURE_SET: CaptureSet = {
   targets: HOME_CAPTURE_TARGETS,
   fixtures: FIXTURE_ROUTES,
   printImages: PRINT_IMAGE_MAP,
+  printerImages: PRINTER_IMAGE_MAP,
   // The filter panel is hidden because the home crops want the data, not the
   // chrome - at every width, now that these are captured at desktop size. The
   // analytics tab's lone "Export this tab (CSV)" button goes for the same
@@ -223,6 +249,9 @@ const DOC_CAPTURE_TARGETS: CaptureTarget[] = [
     ready: [
       rendered('[cy-print-row]', DEMO_PRINT_COUNT),
       imagesRendered('app-print-image'),
+      // Decoded, not merely present: a photo still in flight is exactly what a
+      // capture loses silently.
+      imagesLoaded('app-printer-avatar'),
       rendered('app-filament-color-swatch', DEMO_MATERIAL_COUNT),
     ],
   }),
@@ -248,6 +277,9 @@ const DOC_CAPTURE_TARGETS: CaptureTarget[] = [
     ready: [
       rendered('[cy-print-row]', DEMO_PRINT_COUNT),
       imagesRendered('app-print-image'),
+      // Decoded, not merely present: a photo still in flight is exactly what a
+      // capture loses silently.
+      imagesLoaded('app-printer-avatar'),
       // The Materials column, which the caption below this figure describes.
       rendered('app-filament-color-swatch', DEMO_MATERIAL_COUNT),
     ],
@@ -278,6 +310,9 @@ const DOC_CAPTURE_TARGETS: CaptureTarget[] = [
     ready: [
       rendered('app-print-card', DEMO_PRINT_COUNT),
       imagesRendered('app-print-image'),
+      // Decoded, not merely present: a photo still in flight is exactly what a
+      // capture loses silently.
+      imagesLoaded('app-printer-avatar'),
       rendered('.material-chip', DEMO_MATERIAL_COUNT),
     ],
   }),
@@ -299,6 +334,7 @@ export const DOC_CAPTURE_SET: CaptureSet = {
   targets: DOC_CAPTURE_TARGETS,
   fixtures: FIXTURE_ROUTES,
   printImages: PRINT_IMAGE_MAP,
+  printerImages: PRINTER_IMAGE_MAP,
   // Deliberately no extra CSS. The docs are documenting the filter panel and
   // the tab actions the home crops hide, so hiding them here would document a
   // product that does not exist.

@@ -0,0 +1,5 @@
+[
+  { "printerId": 101, "thumbnailUrl": "/api/Printers/101/thumbnail" },
+  { "printerId": 102, "thumbnailUrl": "/api/Printers/102/thumbnail" },
+  { "printerId": 103, "thumbnailUrl": "/api/Printers/103/thumbnail" }
+]
@@ -1,11 +1,16 @@
 {
-  "paging": { "currentPage": 1, "totalPages": 1, "pageSize": 10, "totalCount": 3 },
+  "paging": {
+    "currentPage": 1,
+    "totalPages": 1,
+    "pageSize": 10,
+    "totalCount": 3
+  },
   "items": [
     {
       "id": 101,
       "name": "Living Room",
-      "make": "Bambu Lab",
-      "model": "A1",
+      "make": "Snapmaker",
+      "model": "U1",
       "isActive": true,
       "wattageW": 350,
       "printTimeInSeconds": null,
@@ -39,8 +44,8 @@
     {
       "id": 102,
       "name": "Workshop",
-      "make": "Prusa",
-      "model": "MK4S",
+      "make": "Anycubic",
+      "model": "Kobra S1",
       "isActive": true,
       "wattageW": 120,
       "printTimeInSeconds": null,
@@ -74,8 +79,8 @@
     {
       "id": 103,
       "name": "Resin Station",
-      "make": "Anycubic",
-      "model": "Photon Mono M7 Pro",
+      "make": "HeyGears",
+      "model": "Reflex RS Turbo",
       "isActive": true,
       "wattageW": 120,
       "printTimeInSeconds": null,

@@ -12,8 +12,8 @@
       "printer": {
         "id": 103,
         "name": "Resin Station",
-        "make": "Anycubic",
-        "model": "Photon Mono M7 Pro",
+        "make": "HeyGears",
+        "model": "Reflex RS Turbo",
         "isActive": true,
         "wattageW": 120,
         "printTimeInSeconds": null,
@@ -77,8 +77,8 @@
             "loadedInPrinter": {
               "id": 103,
               "name": "Resin Station",
-              "make": "Anycubic",
-              "model": "Photon Mono M7 Pro",
+              "make": "HeyGears",
+              "model": "Reflex RS Turbo",
               "isActive": true,
               "category": null
             },
@@ -118,8 +118,8 @@
       "printer": {
         "id": 102,
         "name": "Workshop",
-        "make": "Prusa",
-        "model": "MK4S",
+        "make": "Anycubic",
+        "model": "Kobra S1",
         "isActive": true,
         "wattageW": 120,
         "printTimeInSeconds": null,
@@ -183,8 +183,8 @@
             "loadedInPrinter": {
               "id": 101,
               "name": "Living Room",
-              "make": "Bambu Lab",
-              "model": "A1",
+              "make": "Snapmaker",
+              "model": "U1",
               "isActive": true,
               "category": null
             },
@@ -279,8 +279,8 @@
       "printer": {
         "id": 101,
         "name": "Living Room",
-        "make": "Bambu Lab",
-        "model": "A1",
+        "make": "Snapmaker",
+        "model": "U1",
         "isActive": true,
         "wattageW": 350,
         "printTimeInSeconds": null,
@@ -344,8 +344,8 @@
             "loadedInPrinter": {
               "id": 102,
               "name": "Workshop",
-              "make": "Prusa",
-              "model": "MK4S",
+              "make": "Anycubic",
+              "model": "Kobra S1",
               "isActive": true,
               "category": null
             },
@@ -386,8 +386,8 @@
       "printer": {
         "id": 102,
         "name": "Workshop",
-        "make": "Prusa",
-        "model": "MK4S",
+        "make": "Anycubic",
+        "model": "Kobra S1",
         "isActive": true,
         "wattageW": 120,
         "printTimeInSeconds": null,
@@ -489,8 +489,8 @@
       "printer": {
         "id": 101,
         "name": "Living Room",
-        "make": "Bambu Lab",
-        "model": "A1",
+        "make": "Snapmaker",
+        "model": "U1",
         "isActive": true,
         "wattageW": 350,
         "printTimeInSeconds": null,

@@ -65,6 +65,8 @@ export interface CaptureSet {
   fixtures: FixtureRoute[];
   /** defaultPrintImageId -> committed demo image. */
   printImages: Record<string, string>;
+  /** printerId -> committed demo photo, for the thumbnails the avatars render. */
+  printerImages: Record<string, string>;
   /** CSS appended to BASE_CAPTURE_CSS for this set only. */
   css?: string;
 }
@@ -142,6 +144,23 @@ export function imagesRendered(host: string, timeout = 10000): ReadyStep {
   };
 }
 
+/**
+ * Every `<img>` under `selector` has DECODED, not merely been created.
+ *
+ * `imagesRendered` compares host and `<img>` counts, which a still-loading image
+ * already satisfies - so it cannot detect the one race that actually loses a photo
+ * from a capture. This waits on the pixels.
+ */
+export function imagesLoaded(selector: string, timeout = 10000): ReadyStep {
+  return (scope) =>
+    cy.get(`${scope} ${selector} img`, { timeout }).should(($imgs) => {
+      $imgs.each((_, img) => {
+        expect((img as HTMLImageElement).complete).to.be.true;
+        expect((img as HTMLImageElement).naturalWidth).to.be.greaterThan(0);
+      });
+    });
+}
+
 // ---------------------------------------------------------------------------
 // Harness
 // ---------------------------------------------------------------------------
@@ -206,6 +225,25 @@ function stubApi(set: CaptureSet, unhandled: string[]) {
     }
     req.reply({ fixture: file });
   });
+  // Printer avatars. The thumbnails fixture points at these relative paths rather than
+  // at real blob SAS URLs, so the photos come from the repo and no capture depends on
+  // an external host. The glob cannot collide with the thumbnails map itself: minimatch
+  // `*` never crosses a `/`, so `Printers/*/thumbnail` needs the two segments this has
+  // and `Printers/thumbnails` has only one.
+  cy.intercept('GET', '**/api/Printers/*/thumbnail*', (req) => {
+    const id = req.url.match(/\/Printers\/(\d+)\/thumbnail/)?.[1] ?? '';
+    const file = set.printerImages[id];
+    if (!file) {
+      // Reported like a missed stub rather than falling back to some other machine's
+      // photo, which every readiness check would still pass.
+      unhandled.push(
+        `${req.method} ${req.url} (no demo photo for printer ${id})`
+      );
+      req.reply({ statusCode: 404, body: {} });
+      return;
+    }
+    req.reply({ fixture: file });
+  });
 }
 
 /**