crumbtrail 0.1.1 → 0.2.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Crumbtrail
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# crumbtrail
+
+The setup wizard for [Crumbtrail](https://crumbtrail.dev). It finds your app, wires
+in the SDK, and confirms the first event actually arrives — so you don't have to
+read an integration guide to get started.
+
+```bash
+npx crumbtrail
+```
+
+That's the whole install. There's nothing to add to `package.json` first.
+
+## What it does
+
+Running `npx crumbtrail` walks the full path in one pass:
+
+1. **Detects** your stack — Next.js, Vite, React, Vue, Svelte, Express, Hono, Node,
+   and non-JS services like Django, Rails, Go and .NET.
+2. **Logs you in** (opens a browser, or use `--no-browser` for a device code).
+3. **Provisions** a project and service, and mints an ingest key.
+4. **Installs** the right SDK package and **injects** the setup code into your entry
+   file. This is the only step that writes to your repo, and it always runs last.
+5. **Verifies** the wiring end to end, then waits for your first real event.
+
+In a monorepo, run it from the repo root: it scans every workspace and service,
+shows you what it found, and wires the ones you pick.
+
+## Usage
+
+```
+crumbtrail [options]        Run the setup wizard (detect → login → wire → verify)
+crumbtrail login           Log in and cache a token, nothing else
+crumbtrail logout          Delete the cached token
+```
+
+| Option | Description |
+| --- | --- |
+| `--yes`, `-y` | Skip confirmations (required with `--project` in CI) |
+| `--project <id>` | Attach to an existing project instead of creating one |
+| `--only <name>` | Monorepo: wire only this service (repeatable) |
+| `--all` | Monorepo: wire every service it can, no prompts |
+| `--workspace <dir>` | Wire just one package dir instead of the whole repo |
+| `--no-browser` | Use the device-code login flow |
+| `--skip-verify` | Don't wait for the first event |
+| `--endpoint <url>` | Cloud endpoint (else `$CRUMBTRAIL_BASE_URL`, else the default) |
+| `--version`, `-v` | Print the version |
+
+### Non-interactive / CI
+
+Outside a TTY the wizard refuses to guess. Pass `--yes` and an existing
+`--project <id>`:
+
+```bash
+npx crumbtrail --yes --project prj_1234abcd --only web --skip-verify
+```
+
+## What it writes
+
+Only two kinds of change, both in the package it's wiring:
+
+- the SDK import and `Crumbtrail.init(...)` call in your entry file
+- `CRUMBTRAIL_KEY` appended to that package's `.env`
+
+It won't touch a package that is already wired, and it never edits libraries or
+config-only packages.
+
+## Prefer to wire it by hand?
+
+Nothing here is magic — see [`crumbtrail-core`](https://www.npmjs.com/package/crumbtrail-core)
+for the three-line manual setup.
+
+## Links
+
+- **Website** — https://crumbtrail.dev
+- **Docs** — https://crumbtrail.dev/docs
+- **How it works** — https://crumbtrail.dev/how-it-works
+- **Pricing** — https://crumbtrail.dev/pricing
+- **Source** — https://github.com/crumbtrail-dev/crumbtrail-js
+- **Issues** — https://github.com/crumbtrail-dev/crumbtrail-js/issues
+
+## License
+
+MIT

package/dist/bug-widget-LGIRLS76-WB3MQGAH.js

@@ -0,0 +1,199 @@
+// ../core/dist/bug-widget-LGIRLS76.js
+var WIDGET_CSS = `
+  :host {
+    all: initial;
+    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+    font-size: 14px;
+    color: #e0e0e0;
+  }
+
+  .bl-trigger {
+    position: fixed;
+    bottom: 20px;
+    right: 20px;
+    width: 48px;
+    height: 48px;
+    border-radius: 50%;
+    background: #dc2626;
+    border: none;
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    box-shadow: 0 2px 8px rgba(0,0,0,0.3);
+    z-index: 2147483647;
+    transition: transform 0.15s ease, background 0.15s ease;
+  }
+  .bl-trigger:hover {
+    transform: scale(1.1);
+    background: #ef4444;
+  }
+  .bl-trigger svg {
+    width: 24px;
+    height: 24px;
+    fill: white;
+  }
+
+  .bl-popover {
+    position: fixed;
+    bottom: 80px;
+    right: 20px;
+    width: 320px;
+    background: #1e1e1e;
+    border: 1px solid #333;
+    border-radius: 12px;
+    box-shadow: 0 8px 32px rgba(0,0,0,0.4);
+    z-index: 2147483647;
+    padding: 16px;
+    display: none;
+  }
+  .bl-popover.open {
+    display: block;
+  }
+
+  .bl-popover h3 {
+    margin: 0 0 12px;
+    font-size: 15px;
+    font-weight: 600;
+    color: #f5f5f5;
+  }
+
+  .bl-note {
+    width: 100%;
+    min-height: 60px;
+    background: #2a2a2a;
+    border: 1px solid #444;
+    border-radius: 8px;
+    color: #e0e0e0;
+    padding: 8px 10px;
+    font-size: 13px;
+    font-family: inherit;
+    resize: vertical;
+    box-sizing: border-box;
+  }
+  .bl-note::placeholder {
+    color: #777;
+  }
+  .bl-note:focus {
+    outline: none;
+    border-color: #dc2626;
+  }
+
+  .bl-actions {
+    display: flex;
+    gap: 8px;
+    margin-top: 12px;
+    align-items: center;
+  }
+
+  .bl-btn {
+    padding: 8px 16px;
+    border-radius: 8px;
+    border: none;
+    cursor: pointer;
+    font-size: 13px;
+    font-weight: 500;
+    transition: background 0.15s ease;
+  }
+  .bl-submit {
+    background: #dc2626;
+    color: white;
+    flex: 1;
+  }
+  .bl-submit:hover {
+    background: #ef4444;
+  }
+  .bl-submit:disabled {
+    opacity: 0.5;
+    cursor: not-allowed;
+  }
+
+  .bl-status {
+    font-size: 11px;
+    color: #777;
+    margin-top: 8px;
+  }
+
+  .bl-hint {
+    font-size: 11px;
+    color: #555;
+    margin-top: 8px;
+    text-align: center;
+  }
+`;
+var BUG_SVG = `<svg viewBox="0 0 24 24"><path d="M20 8h-2.81a5.985 5.985 0 0 0-1.82-1.96L17 4.41 15.59 3l-2.17 2.17C12.96 5.06 12.49 5 12 5s-.96.06-1.41.17L8.41 3 7 4.41l1.62 1.63C7.88 6.55 7.26 7.22 6.81 8H4v2h2.09c-.05.33-.09.66-.09 1v1H4v2h2v1c0 .34.04.67.09 1H4v2h2.81c1.04 1.79 2.97 3 5.19 3s4.15-1.21 5.19-3H20v-2h-2.09c.05-.33.09-.66.09-1v-1h2v-2h-2v-1c0-.34-.04-.67-.09-1H20V8zm-6 8h-4v-2h4v2zm0-4h-4v-2h4v2z"/></svg>`;
+function mountWidget(logger) {
+  const host = document.createElement("div");
+  host.id = "crumbtrail-widget";
+  const shadow = host.attachShadow({ mode: "closed" });
+  const style = document.createElement("style");
+  style.textContent = WIDGET_CSS;
+  shadow.appendChild(style);
+  const trigger = document.createElement("button");
+  trigger.className = "bl-trigger";
+  trigger.innerHTML = BUG_SVG;
+  trigger.title = "Flag a bug (Ctrl+Shift+B)";
+  shadow.appendChild(trigger);
+  const popover = document.createElement("div");
+  popover.className = "bl-popover";
+  popover.innerHTML = `
+    <h3>Flag a Bug</h3>
+    <textarea class="bl-note" placeholder="What went wrong? (optional)"></textarea>
+    <div class="bl-actions">
+      <button class="bl-btn bl-submit">Send Bug Report</button>
+    </div>
+    <div class="bl-status"></div>
+    <div class="bl-hint">Ctrl+Shift+B to toggle</div>
+  `;
+  shadow.appendChild(popover);
+  const noteInput = popover.querySelector(".bl-note");
+  const submitBtn = popover.querySelector(".bl-submit");
+  const statusEl = popover.querySelector(".bl-status");
+  let isOpen = false;
+  function toggle() {
+    isOpen = !isOpen;
+    popover.classList.toggle("open", isOpen);
+    if (isOpen) {
+      noteInput.focus();
+    } else {
+      reset();
+    }
+  }
+  function reset() {
+    noteInput.value = "";
+    statusEl.textContent = "";
+  }
+  trigger.addEventListener("click", toggle);
+  submitBtn.addEventListener("click", async () => {
+    submitBtn.disabled = true;
+    statusEl.textContent = "Sending...";
+    try {
+      const { bugId } = await logger.flagBug({
+        note: noteInput.value || void 0
+      });
+      statusEl.textContent = `Saved: ${bugId}`;
+      setTimeout(() => {
+        toggle();
+        submitBtn.disabled = false;
+      }, 1500);
+    } catch {
+      statusEl.textContent = "Failed to send";
+      submitBtn.disabled = false;
+    }
+  });
+  function onKeyDown(e) {
+    if (e.ctrlKey && e.shiftKey && e.key === "B") {
+      e.preventDefault();
+      toggle();
+    }
+  }
+  document.addEventListener("keydown", onKeyDown);
+  document.body.appendChild(host);
+  return () => {
+    document.removeEventListener("keydown", onKeyDown);
+    host.remove();
+  };
+}
+export {
+  mountWidget
+};