@guckdev/browser 0.7.3 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (3) hide show
  1. package/README.md +10 -75
  2. package/dist/index.d.ts.map +1 -1
  3. package/package.json +1 -1
package/README.md CHANGED
@@ -1,34 +1,11 @@
1
1
  # Guck (Browser SDK)
2
2
 
3
- Browser SDK for emitting Guck telemetry to a local MCP HTTP ingest endpoint.
3
+ Browser SDK for emitting Guck telemetry to your dev server at `/guck/emit`.
4
4
  This package is intended for **development only** and throws if used in production builds.
5
5
 
6
6
  ## Usage
7
7
 
8
- Start the MCP server with HTTP ingest enabled:
9
-
10
- ```sh
11
- guck mcp --http-port 7331
12
- ```
13
-
14
- Create a client and emit events:
15
-
16
- ```ts
17
- import { createBrowserClient } from "@guckdev/browser";
18
-
19
- const client = createBrowserClient({
20
- endpoint: "http://localhost:7331/guck/emit",
21
- service: "web-ui",
22
- sessionId: "dev-1",
23
- });
24
-
25
- await client.emit({ message: "hello from the browser" });
26
- ```
27
-
28
- ## Vite drop-in (dev)
29
-
30
- 1) `pnpm add -D @guckdev/vite`
31
- 2) Add the plugin in `vite.config.ts`:
8
+ 1) Add the Vite plugin:
32
9
 
33
10
  ```ts
34
11
  import { defineConfig } from "vite";
@@ -39,40 +16,18 @@ export default defineConfig({
39
16
  });
40
17
  ```
41
18
 
42
- 3) Use `/guck/emit` as the browser endpoint.
43
-
44
- The browser will POST to your Vite dev server (for example `http://localhost:5173/guck/emit`).
45
- The plugin forwards those requests to the shared MCP ingest at `http://127.0.0.1:7331/guck/emit`.
46
-
47
- ## Quick local setup (HTTPS dev host, no Vite plugin)
48
-
49
- 1) Start the MCP server with HTTP ingest:
50
-
51
- ```sh
52
- guck mcp --http-port 7331
53
- ```
54
-
55
- 2) If your app runs on HTTPS (e.g. `https://local.dev`), proxy the ingest
56
- endpoint through Caddy so the browser stays on HTTPS:
57
-
58
- ```caddyfile
59
- :443 {
60
- # your existing site config...
61
-
62
- handle_path /guck/emit {
63
- reverse_proxy 127.0.0.1:7331
64
- }
65
- }
66
- ```
67
-
68
- 3) Use the proxied endpoint:
19
+ 2) Create a client and emit events:
69
20
 
70
21
  ```ts
22
+ import { createBrowserClient } from "@guckdev/browser";
23
+
71
24
  const client = createBrowserClient({
72
- endpoint: "https://local.dev/guck/emit",
73
- service: "playground",
25
+ endpoint: "/guck/emit",
26
+ service: "web-ui",
74
27
  sessionId: "dev-1",
75
28
  });
29
+
30
+ await client.emit({ message: "hello from the browser" });
76
31
  ```
77
32
 
78
33
  ## Keep it out of production
@@ -83,7 +38,7 @@ Use a development-only import so the SDK never gets bundled for production:
83
38
  if (import.meta.env.DEV) {
84
39
  const { createBrowserClient } = await import("@guckdev/browser");
85
40
  const client = createBrowserClient({
86
- endpoint: "https://local.dev/guck/emit",
41
+ endpoint: "/guck/emit",
87
42
  service: "playground",
88
43
  sessionId: "dev-1",
89
44
  });
@@ -103,28 +58,8 @@ stop();
103
58
  ```
104
59
 
105
60
  Notes:
106
- - The HTTP ingest endpoint is CORS-enabled by default.
107
- - If your page is served over HTTPS, posting to an HTTP localhost endpoint may be blocked by mixed-content rules.
108
61
  - The SDK only runs when the endpoint host is local (`localhost`, `127.0.0.1`, `local.*`, `*.local`).
109
- - `createBrowserClient()` throws when `NODE_ENV` / `import.meta.env.PROD` indicates production.
110
62
  - `installAutoCapture()` should usually be called once at app startup; repeated calls will wrap console multiple times.
111
63
  - If you install it inside a component or test, call `stop()` on cleanup to avoid duplicate logging.
112
64
  - For SPAs, it's fine to call `installAutoCapture()` once in your app entry (e.g. `index.ts`) and never call `stop()`.
113
65
  - There is no prebuilt UMD/IIFE bundle yet; for vanilla JS you should use a bundler (Vite/Rollup/etc) or a native ESM import in a modern build.
114
-
115
- ### Caddy (HTTPS dev) proxy example
116
-
117
- If your frontend runs behind Caddy on HTTPS, proxy a path to the local ingest server
118
- so the browser stays on HTTPS:
119
-
120
- ```caddyfile
121
- :443 {
122
- # your existing site config...
123
-
124
- handle_path /guck/emit {
125
- reverse_proxy 127.0.0.1:7331
126
- }
127
- }
128
- ```
129
-
130
- Then point the client at `https://your-dev-host/guck/emit`.
package/dist/index.d.ts.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzE,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,kBAAkB,EAAE,CAAC,IAAI,CAAC,EAAE,kBAAkB,KAAK;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CACzE,CAAC;AA2KF,eAAO,MAAM,mBAAmB,GAAI,SAAS,oBAAoB,KAAG,aAmKnE,CAAC;AAEF,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,KAAK,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;AAEzE,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE,KAAK,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,KAAK,SAAS,GAAG;IACf,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,KAAK,oBAAoB,GAAG;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC,CAAC;AAEF,KAAK,kBAAkB,GAAG;IACxB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF,KAAK,aAAa,GAAG;IACnB,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,CAAC,SAAS,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,kBAAkB,EAAE,CAAC,IAAI,CAAC,EAAE,kBAAkB,KAAK;QAAE,IAAI,EAAE,MAAM,IAAI,CAAA;KAAE,CAAC;CACzE,CAAC;AA2KF,eAAO,MAAM,mBAAmB,YAAa,oBAAoB,KAAG,aAmKnE,CAAC;AAEF,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,aAAa,EAAE,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guckdev/browser",
3
- "version": "0.7.3",
3
+ "version": "0.10.1",
4
4
  "description": "Guck browser SDK",
5
5
  "repository": {
6
6
  "type": "git",