@fogg/bug-reporter 1.0.0

package/examples/backend-local/README.md

@@ -0,0 +1,11 @@
+# Local Backend Example
+
+```bash
+cd examples/backend-local
+npm install
+npm start
+```
+
+Endpoints:
+- `POST /api/uploads` (multipart form)
+- `POST /api/bug-reports`

package/examples/backend-local/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "bug-reporter-backend-local-example",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "node src/server.mjs"
+  },
+  "dependencies": {
+    "cors": "^2.8.5",
+    "express": "^4.21.2",
+    "multer": "^1.4.5-lts.2"
+  }
+}

package/examples/backend-local/src/server.mjs

@@ -0,0 +1,31 @@
+import cors from "cors";
+import express from "express";
+import multer from "multer";
+import path from "node:path";
+
+const app = express();
+const port = Number(process.env.PORT || 4201);
+const root = path.resolve(process.cwd(), "examples/backend-local/public");
+const upload = multer({ dest: path.join(root, "uploads") });
+
+app.use(cors());
+app.use(express.json());
+app.use("/public", express.static(root));
+
+app.post("/api/uploads", upload.single("file"), (req, res) => {
+  if (!req.file) {
+    res.status(400).json({ error: "file is required" });
+    return;
+  }
+
+  const url = `http://localhost:${port}/public/uploads/${req.file.filename}`;
+  res.json({ url, key: `uploads/${req.file.filename}` });
+});
+
+app.post("/api/bug-reports", (req, res) => {
+  res.json({ id: crypto.randomUUID(), message: "received", payload: req.body });
+});
+
+app.listen(port, () => {
+  console.log(`Local example backend listening on http://localhost:${port}`);
+});

package/examples/backend-s3-presign/README.md

@@ -0,0 +1,14 @@
+# S3 Presign Example (Local Simulation)
+
+```bash
+cd examples/backend-s3-presign
+npm install
+npm start
+```
+
+Endpoints:
+- `POST /api/presign`
+- `POST /upload-form`
+- `POST /api/bug-reports`
+
+This simulates presigned uploads locally while preserving the SDK contract.

package/examples/backend-s3-presign/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "bug-reporter-backend-s3-example",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "node src/server.mjs"
+  },
+  "dependencies": {
+    "cors": "^2.8.5",
+    "express": "^4.21.2",
+    "multer": "^1.4.5-lts.2"
+  }
+}

package/examples/backend-s3-presign/src/server.mjs

@@ -0,0 +1,53 @@
+import cors from "cors";
+import express from "express";
+import multer from "multer";
+import path from "node:path";
+
+const app = express();
+const port = Number(process.env.PORT || 4202);
+const root = path.resolve(process.cwd(), "examples/backend-s3-presign/public");
+const objectDir = path.join(root, "objects");
+const upload = multer({ dest: objectDir });
+
+app.use(cors());
+app.use(express.json({ limit: "1mb" }));
+app.use("/objects", express.static(objectDir));
+
+app.post("/api/presign", (req, res) => {
+  const files = Array.isArray(req.body?.files) ? req.body.files : [];
+  const uploads = files.map((file) => {
+    const key = `${Date.now()}-${file.id}-${file.name.replace(/[^a-zA-Z0-9_.-]/g, "-")}`;
+    return {
+      id: file.id,
+      method: "POST",
+      uploadUrl: `http://localhost:${port}/upload-form`,
+      fields: { key },
+      key,
+      publicUrl: `http://localhost:${port}/objects/${key}`,
+      type: file.type
+    };
+  });
+
+  res.json({ uploads });
+});
+
+app.post("/upload-form", upload.single("file"), (req, res) => {
+  if (!req.file || typeof req.body?.key !== "string") {
+    res.status(400).json({ error: "missing file or key" });
+    return;
+  }
+
+  const finalPath = path.join(objectDir, req.body.key);
+  import("node:fs/promises")
+    .then((fs) => fs.rename(req.file.path, finalPath))
+    .then(() => res.status(204).send())
+    .catch(() => res.status(500).json({ error: "upload move failed" }));
+});
+
+app.post("/api/bug-reports", (req, res) => {
+  res.json({ id: crypto.randomUUID(), message: "received", payload: req.body });
+});
+
+app.listen(port, () => {
+  console.log(`Presign example backend listening on http://localhost:${port}`);
+});

package/examples/sandbox-vite/README.md

@@ -0,0 +1,25 @@
+# Vite Sandbox
+
+Small local app to manually test the `@fogg/bug-reporter` SDK.
+
+## Run
+
+From repo root:
+
+```bash
+npm run sandbox:vite
+```
+
+Or directly:
+
+```bash
+cd examples/sandbox-vite
+npm install
+npm run dev
+```
+
+The sandbox mocks:
+- `POST /sandbox/upload`
+- `POST /sandbox/report`
+
+So you can validate the full SDK flow without running a backend.

package/examples/sandbox-vite/index.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>bug-reporter sandbox</title>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>