Fixes #255: Add Browse and Export Script Example

packages/sdk/README.md

@@ -297,4 +297,7 @@ Program](https://bughunters.google.com/open-source-security).
 
 ## License
 
-Apache 2.0 — see [LICENSE](LICENSE) for details.
+Apache 2.0 — see [LICENSE](LICENSE) for details.
+## Examples
+
+- [Browse and Export](examples/browse-and-export/)

packages/sdk/examples/browse-and-export/README.md

@@ -0,0 +1,14 @@
+# Browse and Export
+
+A script example demonstrating how to list projects, list screens, and download HTML and screenshots to local files.
+
+## Setup
+
+1. Make sure you have the SDK installed and built.
+2. Set the `STITCH_API_KEY` environment variable.
+
+## Run
+
+```bash
+bun index.ts
+```

packages/sdk/examples/browse-and-export/index.ts

@@ -0,0 +1,71 @@
+import '../_require-key.js';
+import { stitch } from '@google/stitch-sdk';
+import fs from 'fs/promises';
+import path from 'path';
+
+const EXPORT_DIR = path.join(process.cwd(), 'exports');
+
+console.log('Fetching projects...');
+const projects = await stitch.projects();
+
+if (projects.length === 0) {
+  console.log('No projects found.');
+  process.exit(0);
+}
+
+const project = projects[0];
+console.log(`Using project: ${project.id}`);
+
+console.log('Fetching screens...');
+const screens = await project.screens();
+
+if (screens.length === 0) {
+  console.log('No screens found in this project.');
+  process.exit(0);
+}
+
+await fs.mkdir(EXPORT_DIR, { recursive: true });
+
+for (let i = 0; i < Math.min(screens.length, 3); i++) {
+  const screen = screens[i];
+  console.log(`\nExporting screen ${screen.id}...`);
+
+  try {
+    const htmlUrl = await screen.getHtml();
+    if (htmlUrl) {
+      let html = htmlUrl;
+      if (htmlUrl.startsWith('http')) {
+        const htmlResp = await fetch(htmlUrl);
+        html = await htmlResp.text();
+      }
+      const htmlPath = path.join(EXPORT_DIR, `${screen.id}.html`);
+      await fs.writeFile(htmlPath, html, 'utf-8');
+      console.log(`Saved HTML to ${htmlPath}`);
+    } else {
+      console.log('No HTML available for this screen.');
+    }
+  } catch (err) {
+    console.error(`Failed to export HTML for ${screen.id}:`, err);
+  }
+
+  try {
+    const imageUrl = await screen.getImage();
+    if (imageUrl) {
+      let imgBuffer;
+      if (imageUrl.startsWith('http')) {
+        const imgResp = await fetch(imageUrl);
+        imgBuffer = Buffer.from(await imgResp.arrayBuffer());
+      } else {
+        imgBuffer = Buffer.from(imageUrl, 'base64');
+      }
+      const imgPath = path.join(EXPORT_DIR, `${screen.id}.png`);
+      await fs.writeFile(imgPath, imgBuffer);
+      console.log(`Saved screenshot to ${imgPath}`);
+    } else {
+      console.log('No Image URL available for this screen.');
+    }
+  } catch (err) {
+    console.error(`Failed to export screenshot for ${screen.id}:`, err);
+  }
+}
+console.log('\nExport complete.');