@goliapkg/sentori-vue 0.1.0

package/lib/ErrorBoundary.d.ts

@@ -0,0 +1,22 @@
+export declare const SentoriErrorBoundary: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    /** Optional list of error names (`error.name`) to ignore — they
+     *  pass through to upper boundaries unchanged. */
+    ignore: {
+        type: () => readonly string[];
+        default: () => never[];
+    };
+}>, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}> | import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>[] | undefined, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    /** Optional list of error names (`error.name`) to ignore — they
+     *  pass through to upper boundaries unchanged. */
+    ignore: {
+        type: () => readonly string[];
+        default: () => never[];
+    };
+}>> & Readonly<{}>, {
+    ignore: readonly string[];
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/lib/ErrorBoundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.d.ts","sourceRoot":"","sources":["../src/ErrorBoundary.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,oBAAoB;IAG7B;sDACkD;;cACzB,MAAM,SAAS,MAAM,EAAE;;;;;;;;IAFhD;sDACkD;;cACzB,MAAM,SAAS,MAAM,EAAE;;;;;4EA+BlD,CAAA"}

package/lib/ErrorBoundary.js

@@ -0,0 +1,48 @@
+// Phase 45 sub-B — Vue error boundary component.
+//
+// Vue 3 doesn't ship a built-in ErrorBoundary like React. The
+// pattern is to use the `errorCaptured(err, instance, info)`
+// lifecycle hook on a wrapper component that returns `false` to
+// stop the error from propagating. Our wrapper captures into
+// Sentori and renders either the slot's children or a `fallback`
+// slot when the subtree threw.
+import { captureException } from '@goliapkg/sentori-javascript';
+import { defineComponent, h, ref } from 'vue';
+export const SentoriErrorBoundary = defineComponent({
+    name: 'SentoriErrorBoundary',
+    props: {
+        /** Optional list of error names (`error.name`) to ignore — they
+         *  pass through to upper boundaries unchanged. */
+        ignore: { type: Array, default: () => [] },
+    },
+    setup(_props, { slots }) {
+        const caughtError = ref(null);
+        const reset = () => {
+            caughtError.value = null;
+        };
+        return () => {
+            if (caughtError.value) {
+                if (slots.fallback) {
+                    return slots.fallback({ error: caughtError.value, reset });
+                }
+                // Default fallback: a hidden span so Vue doesn't render a
+                // crashed subtree. Apps that don't pass a fallback opt in
+                // to that minimal behaviour.
+                return h('span', { 'data-sentori-boundary-error': 'true' });
+            }
+            return slots.default?.();
+        };
+    },
+    errorCaptured(err, _instance, info) {
+        const e = err instanceof Error ? err : new Error(String(err));
+        if (this.ignore.includes(e.name)) {
+            return true; // propagate further
+        }
+        captureException(e, { tags: { 'vue.errorInfo': info } });
+        // Switch to fallback render and stop propagation.
+        this.$forceUpdate();
+        this.caughtError = { value: e };
+        return false;
+    },
+});
+//# sourceMappingURL=ErrorBoundary.js.map

package/lib/ErrorBoundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ErrorBoundary.js","sourceRoot":"","sources":["../src/ErrorBoundary.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,8DAA8D;AAC9D,6DAA6D;AAC7D,gEAAgE;AAChE,6DAA6D;AAC7D,iEAAiE;AACjE,+BAA+B;AAE/B,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC/D,OAAO,EAAE,eAAe,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,KAAK,CAAA;AAE7C,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;IAClD,IAAI,EAAE,sBAAsB;IAC5B,KAAK,EAAE;QACL;0DACkD;QAClD,MAAM,EAAE,EAAE,IAAI,EAAE,KAAgC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,EAAE;KACtE;IACD,KAAK,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE;QACrB,MAAM,WAAW,GAAG,GAAG,CAAe,IAAI,CAAC,CAAA;QAC3C,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,WAAW,CAAC,KAAK,GAAG,IAAI,CAAA;QAC1B,CAAC,CAAA;QACD,OAAO,GAAG,EAAE;YACV,IAAI,WAAW,CAAC,KAAK,EAAE,CAAC;gBACtB,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnB,OAAO,KAAK,CAAC,QAAQ,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;gBAC5D,CAAC;gBACD,0DAA0D;gBAC1D,0DAA0D;gBAC1D,6BAA6B;gBAC7B,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,6BAA6B,EAAE,MAAM,EAAE,CAAC,CAAA;YAC7D,CAAC;YACD,OAAO,KAAK,CAAC,OAAO,EAAE,EAAE,CAAA;QAC1B,CAAC,CAAA;IACH,CAAC;IACD,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,IAAI;QAChC,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QAC7D,IAAK,IAAI,CAAC,MAA4B,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YACxD,OAAO,IAAI,CAAA,CAAC,oBAAoB;QAClC,CAAC;QACD,gBAAgB,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE,CAAC,CAAA;QACxD,kDAAkD;QAClD,IAAI,CAAC,YAAY,EAAE,CAClB;QAAC,IAA4D,CAAC,WAAW,GAAG,EAAE,KAAK,EAAE,CAAC,EAAE,CAAA;QACzF,OAAO,KAAK,CAAA;IACd,CAAC;CACF,CAAC,CAAA"}

package/lib/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Phase 45 sub-B — Vue 3 adapter for Sentori.
+ *
+ * Plugin shape:
+ *
+ *     import { createApp } from 'vue'
+ *     import sentori from '@goliapkg/sentori-vue'
+ *
+ *     const app = createApp(App)
+ *     app.use(sentori, {
+ *       token: 'st_pk_…',
+ *       release: 'myapp@1.0.0',
+ *       sampling: { errors: 1.0 },
+ *     })
+ *
+ * What `app.use(sentori, opts)` does:
+ *   1. forwards `opts` to `@goliapkg/sentori-javascript`'s init
+ *   2. wires `app.config.errorHandler` so any error thrown inside
+ *      a render / lifecycle bubbles into `captureException`
+ *   3. tags every Sentori event with `tags.vue.version` so the
+ *      dashboard knows which framework is producing the data
+ *
+ * Router integration (Vue Router) lives in the `/router` subpath:
+ *
+ *     import { setupTraceNavigation } from '@goliapkg/sentori-vue/router'
+ *     setupTraceNavigation(router)
+ */
+import type { Plugin } from 'vue';
+import { type InitOptions } from '@goliapkg/sentori-javascript';
+export type SentoriVueOptions = InitOptions;
+declare const plugin: Plugin;
+export default plugin;
+export { plugin as sentori };
+export { addBreadcrumb, captureException, captureException as captureError, captureStep, getUser, setUser, } from '@goliapkg/sentori-javascript';
+export { SentoriErrorBoundary } from './ErrorBoundary.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAO,MAAM,EAAE,MAAM,KAAK,CAAA;AACtC,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAA;AAErC,MAAM,MAAM,iBAAiB,GAAG,WAAW,CAAA;AAE3C,QAAA,MAAM,MAAM,EAAE,MAqBb,CAAA;AAED,eAAe,MAAM,CAAA;AACrB,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,CAAA;AAE5B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,IAAI,YAAY,EAChC,WAAW,EACX,OAAO,EACP,OAAO,GACR,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/lib/index.js

@@ -0,0 +1,55 @@
+/**
+ * Phase 45 sub-B — Vue 3 adapter for Sentori.
+ *
+ * Plugin shape:
+ *
+ *     import { createApp } from 'vue'
+ *     import sentori from '@goliapkg/sentori-vue'
+ *
+ *     const app = createApp(App)
+ *     app.use(sentori, {
+ *       token: 'st_pk_…',
+ *       release: 'myapp@1.0.0',
+ *       sampling: { errors: 1.0 },
+ *     })
+ *
+ * What `app.use(sentori, opts)` does:
+ *   1. forwards `opts` to `@goliapkg/sentori-javascript`'s init
+ *   2. wires `app.config.errorHandler` so any error thrown inside
+ *      a render / lifecycle bubbles into `captureException`
+ *   3. tags every Sentori event with `tags.vue.version` so the
+ *      dashboard knows which framework is producing the data
+ *
+ * Router integration (Vue Router) lives in the `/router` subpath:
+ *
+ *     import { setupTraceNavigation } from '@goliapkg/sentori-vue/router'
+ *     setupTraceNavigation(router)
+ */
+import { captureException as captureExceptionJs, initSentori as initSentoriJs, } from '@goliapkg/sentori-javascript';
+const plugin = {
+    install(app, options) {
+        // 1. init the core JS SDK.
+        initSentoriJs(options);
+        // 2. Vue's global error handler. Sentori captureException
+        //    accepts an Error; Vue's handler receives `unknown`. Wrap
+        //    non-Error values so the SDK still gets a stack.
+        const previous = app.config.errorHandler;
+        app.config.errorHandler = (err, instance, info) => {
+            const e = err instanceof Error ? err : new Error(String(err));
+            captureExceptionJs(e, {
+                tags: {
+                    'vue.component': instance?.$options?.name ?? '<anonymous>',
+                    'vue.errorInfo': info,
+                },
+            });
+            // Chain to any previously installed handler so plugins layer.
+            if (previous)
+                previous(err, instance, info);
+        };
+    },
+};
+export default plugin;
+export { plugin as sentori };
+export { addBreadcrumb, captureException, captureException as captureError, captureStep, getUser, setUser, } from '@goliapkg/sentori-javascript';
+export { SentoriErrorBoundary } from './ErrorBoundary.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAGH,OAAO,EACL,gBAAgB,IAAI,kBAAkB,EACtC,WAAW,IAAI,aAAa,GAE7B,MAAM,8BAA8B,CAAA;AAIrC,MAAM,MAAM,GAAW;IACrB,OAAO,CAAC,GAAQ,EAAE,OAA0B;QAC1C,2BAA2B;QAC3B,aAAa,CAAC,OAAO,CAAC,CAAA;QAEtB,0DAA0D;QAC1D,8DAA8D;QAC9D,qDAAqD;QACrD,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,YAAY,CAAA;QACxC,GAAG,CAAC,MAAM,CAAC,YAAY,GAAG,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;YAChD,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YAC7D,kBAAkB,CAAC,CAAC,EAAE;gBACpB,IAAI,EAAE;oBACJ,eAAe,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,IAAI,aAAa;oBAC1D,eAAe,EAAE,IAAI;iBACtB;aACF,CAAC,CAAA;YACF,8DAA8D;YAC9D,IAAI,QAAQ;gBAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAA;QAC7C,CAAC,CAAA;IACH,CAAC;CACF,CAAA;AAED,eAAe,MAAM,CAAA;AACrB,OAAO,EAAE,MAAM,IAAI,OAAO,EAAE,CAAA;AAE5B,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,IAAI,YAAY,EAChC,WAAW,EACX,OAAO,EACP,OAAO,GACR,MAAM,8BAA8B,CAAA;AAErC,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA"}

package/lib/router.d.ts

@@ -0,0 +1,17 @@
+type RouterLike = {
+    beforeEach: (cb: (to: {
+        path: string;
+        name?: unknown;
+    }, from: {
+        path: string;
+    }) => void) => void;
+    afterEach: (cb: (to: {
+        path: string;
+        name?: unknown;
+    }, from: {
+        path: string;
+    }) => void) => void;
+};
+export declare function setupTraceNavigation(router: RouterLike): void;
+export {};
+//# sourceMappingURL=router.d.ts.map

package/lib/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAmBA,KAAK,UAAU,GAAG;IAChB,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,KAAK,IAAI,CAAA;IAChG,SAAS,EAAE,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,KAAK,IAAI,CAAA;CAChG,CAAA;AAID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CA4B7D"}

package/lib/router.js

@@ -0,0 +1,46 @@
+// Phase 45 sub-B — Vue Router auto-trace navigation.
+//
+//     import { createRouter } from 'vue-router'
+//     import { setupTraceNavigation } from '@goliapkg/sentori-vue/router'
+//
+//     const router = createRouter({ ... })
+//     setupTraceNavigation(router)
+//
+// On every route push, we open a `vue.navigation` span keyed by the
+// destination path, mark it active, and finish it on the next
+// `afterEach`. Sentori spans / fetch / xhr instrumentation in
+// `@goliapkg/sentori-javascript` automatically nest into it so each
+// screen's network requests cluster into one trace.
+import { setActiveSpan, startSpan } from '@goliapkg/sentori-core';
+import { captureStep } from '@goliapkg/sentori-javascript';
+let _active = null;
+export function setupTraceNavigation(router) {
+    router.beforeEach((to, from) => {
+        // Finish any still-open span from the previous transition that
+        // afterEach didn't reach (route guard rejected, etc.).
+        if (_active) {
+            _active.finish({ status: 'ok' });
+            _active = null;
+        }
+        const name = `${from.path || '/'} → ${to.path || '/'}`;
+        const span = startSpan('vue.navigation', {
+            name,
+            parent: null,
+            tags: { 'nav.from': from.path || '/', 'nav.to': to.path || '/' },
+        });
+        _active = span;
+        setActiveSpan(span);
+        // Phase 46 — also record into the session-trail buffer; no-op
+        // unless `init({ capture: { sessionTrail: true } })`.
+        captureStep(`route:${to.path || '/'}`, {
+            breadcrumb: { type: 'navigation', message: name },
+        });
+    });
+    router.afterEach(() => {
+        if (_active) {
+            _active.finish({ status: 'ok' });
+            _active = null;
+        }
+    });
+}
+//# sourceMappingURL=router.js.map

package/lib/router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.js","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAAA,qDAAqD;AACrD,EAAE;AACF,gDAAgD;AAChD,0EAA0E;AAC1E,EAAE;AACF,2CAA2C;AAC3C,mCAAmC;AACnC,EAAE;AACF,oEAAoE;AACpE,8DAA8D;AAC9D,8DAA8D;AAC9D,oEAAoE;AACpE,oDAAoD;AAEpD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAA;AAClF,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAA;AAS1D,IAAI,OAAO,GAAsB,IAAI,CAAA;AAErC,MAAM,UAAU,oBAAoB,CAAC,MAAkB;IACrD,MAAM,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,EAAE;QAC7B,+DAA+D;QAC/D,uDAAuD;QACvD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YAChC,OAAO,GAAG,IAAI,CAAA;QAChB,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,IAAI,IAAI,GAAG,MAAM,EAAE,CAAC,IAAI,IAAI,GAAG,EAAE,CAAA;QACtD,MAAM,IAAI,GAAG,SAAS,CAAC,gBAAgB,EAAE;YACvC,IAAI;YACJ,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,CAAC,IAAI,IAAI,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,IAAI,GAAG,EAAE;SACjE,CAAC,CAAA;QACF,OAAO,GAAG,IAAI,CAAA;QACd,aAAa,CAAC,IAAI,CAAC,CAAA;QACnB,8DAA8D;QAC9D,sDAAsD;QACtD,WAAW,CAAC,SAAS,EAAE,CAAC,IAAI,IAAI,GAAG,EAAE,EAAE;YACrC,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE;SAClD,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE;QACpB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;YAChC,OAAO,GAAG,IAAI,CAAA;QAChB,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@goliapkg/sentori-vue",
+  "version": "0.1.0",
+  "description": "Vue 3 adapter for Sentori — plugin, errorHandler hook, Vue Router auto-trace navigation, <SentoriErrorBoundary>.",
+  "license": "MIT",
+  "homepage": "https://sentori.golia.jp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goliajp/sentori.git",
+    "directory": "sdk/vue"
+  },
+  "bugs": {
+    "url": "https://github.com/goliajp/sentori/issues"
+  },
+  "keywords": [
+    "sentori",
+    "vue",
+    "vue3",
+    "error-tracking",
+    "error-boundary"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./router": {
+      "types": "./lib/router.d.ts",
+      "default": "./lib/router.js"
+    }
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepack": "bun run build"
+  },
+  "peerDependencies": {
+    "vue": ">=3.4",
+    "vue-router": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "vue-router": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@goliapkg/sentori-core": "0.6.0",
+    "@goliapkg/sentori-javascript": "0.4.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5",
+    "vue": "^3.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/ErrorBoundary.ts

@@ -0,0 +1,49 @@
+// Phase 45 sub-B — Vue error boundary component.
+//
+// Vue 3 doesn't ship a built-in ErrorBoundary like React. The
+// pattern is to use the `errorCaptured(err, instance, info)`
+// lifecycle hook on a wrapper component that returns `false` to
+// stop the error from propagating. Our wrapper captures into
+// Sentori and renders either the slot's children or a `fallback`
+// slot when the subtree threw.
+
+import { captureException } from '@goliapkg/sentori-javascript'
+import { defineComponent, h, ref } from 'vue'
+
+export const SentoriErrorBoundary = defineComponent({
+  name: 'SentoriErrorBoundary',
+  props: {
+    /** Optional list of error names (`error.name`) to ignore — they
+     *  pass through to upper boundaries unchanged. */
+    ignore: { type: Array as () => readonly string[], default: () => [] },
+  },
+  setup(_props, { slots }) {
+    const caughtError = ref<Error | null>(null)
+    const reset = () => {
+      caughtError.value = null
+    }
+    return () => {
+      if (caughtError.value) {
+        if (slots.fallback) {
+          return slots.fallback({ error: caughtError.value, reset })
+        }
+        // Default fallback: a hidden span so Vue doesn't render a
+        // crashed subtree. Apps that don't pass a fallback opt in
+        // to that minimal behaviour.
+        return h('span', { 'data-sentori-boundary-error': 'true' })
+      }
+      return slots.default?.()
+    }
+  },
+  errorCaptured(err, _instance, info) {
+    const e = err instanceof Error ? err : new Error(String(err))
+    if ((this.ignore as readonly string[]).includes(e.name)) {
+      return true // propagate further
+    }
+    captureException(e, { tags: { 'vue.errorInfo': info } })
+    // Switch to fallback render and stop propagation.
+    this.$forceUpdate()
+    ;(this as unknown as { caughtError: { value: Error | null } }).caughtError = { value: e }
+    return false
+  },
+})

package/src/__tests__/smoke.test.ts

@@ -0,0 +1,30 @@
+import { describe, expect, test } from 'bun:test'
+
+import plugin, {
+  SentoriErrorBoundary,
+  addBreadcrumb,
+  captureException,
+  sentori,
+} from '../index.js'
+import { setupTraceNavigation } from '../router.js'
+
+describe('@goliapkg/sentori-vue exports', () => {
+  test('default export is a Vue plugin with an install function', () => {
+    expect(typeof plugin.install).toBe('function')
+    expect(plugin).toBe(sentori)
+  })
+
+  test('SentoriErrorBoundary is a defineComponent', () => {
+    expect(SentoriErrorBoundary).toBeDefined()
+    expect(typeof SentoriErrorBoundary).toBe('object')
+  })
+
+  test('Vue Router helper is exported', () => {
+    expect(typeof setupTraceNavigation).toBe('function')
+  })
+
+  test('re-exports common SDK helpers', () => {
+    expect(typeof captureException).toBe('function')
+    expect(typeof addBreadcrumb).toBe('function')
+  })
+})

package/src/index.ts

@@ -0,0 +1,73 @@
+/**
+ * Phase 45 sub-B — Vue 3 adapter for Sentori.
+ *
+ * Plugin shape:
+ *
+ *     import { createApp } from 'vue'
+ *     import sentori from '@goliapkg/sentori-vue'
+ *
+ *     const app = createApp(App)
+ *     app.use(sentori, {
+ *       token: 'st_pk_…',
+ *       release: 'myapp@1.0.0',
+ *       sampling: { errors: 1.0 },
+ *     })
+ *
+ * What `app.use(sentori, opts)` does:
+ *   1. forwards `opts` to `@goliapkg/sentori-javascript`'s init
+ *   2. wires `app.config.errorHandler` so any error thrown inside
+ *      a render / lifecycle bubbles into `captureException`
+ *   3. tags every Sentori event with `tags.vue.version` so the
+ *      dashboard knows which framework is producing the data
+ *
+ * Router integration (Vue Router) lives in the `/router` subpath:
+ *
+ *     import { setupTraceNavigation } from '@goliapkg/sentori-vue/router'
+ *     setupTraceNavigation(router)
+ */
+
+import type { App, Plugin } from 'vue'
+import {
+  captureException as captureExceptionJs,
+  initSentori as initSentoriJs,
+  type InitOptions,
+} from '@goliapkg/sentori-javascript'
+
+export type SentoriVueOptions = InitOptions
+
+const plugin: Plugin = {
+  install(app: App, options: SentoriVueOptions) {
+    // 1. init the core JS SDK.
+    initSentoriJs(options)
+
+    // 2. Vue's global error handler. Sentori captureException
+    //    accepts an Error; Vue's handler receives `unknown`. Wrap
+    //    non-Error values so the SDK still gets a stack.
+    const previous = app.config.errorHandler
+    app.config.errorHandler = (err, instance, info) => {
+      const e = err instanceof Error ? err : new Error(String(err))
+      captureExceptionJs(e, {
+        tags: {
+          'vue.component': instance?.$options?.name ?? '<anonymous>',
+          'vue.errorInfo': info,
+        },
+      })
+      // Chain to any previously installed handler so plugins layer.
+      if (previous) previous(err, instance, info)
+    }
+  },
+}
+
+export default plugin
+export { plugin as sentori }
+
+export {
+  addBreadcrumb,
+  captureException,
+  captureException as captureError,
+  captureStep,
+  getUser,
+  setUser,
+} from '@goliapkg/sentori-javascript'
+
+export { SentoriErrorBoundary } from './ErrorBoundary.js'

package/src/router.ts

@@ -0,0 +1,55 @@
+// Phase 45 sub-B — Vue Router auto-trace navigation.
+//
+//     import { createRouter } from 'vue-router'
+//     import { setupTraceNavigation } from '@goliapkg/sentori-vue/router'
+//
+//     const router = createRouter({ ... })
+//     setupTraceNavigation(router)
+//
+// On every route push, we open a `vue.navigation` span keyed by the
+// destination path, mark it active, and finish it on the next
+// `afterEach`. Sentori spans / fetch / xhr instrumentation in
+// `@goliapkg/sentori-javascript` automatically nest into it so each
+// screen's network requests cluster into one trace.
+
+import { setActiveSpan, startSpan, type SpanHandle } from '@goliapkg/sentori-core'
+import { captureStep } from '@goliapkg/sentori-javascript'
+
+// Minimal duck type — accept anything that exposes `beforeEach` +
+// `afterEach`. Avoids hard-coding a vue-router version.
+type RouterLike = {
+  beforeEach: (cb: (to: { path: string; name?: unknown }, from: { path: string }) => void) => void
+  afterEach: (cb: (to: { path: string; name?: unknown }, from: { path: string }) => void) => void
+}
+
+let _active: SpanHandle | null = null
+
+export function setupTraceNavigation(router: RouterLike): void {
+  router.beforeEach((to, from) => {
+    // Finish any still-open span from the previous transition that
+    // afterEach didn't reach (route guard rejected, etc.).
+    if (_active) {
+      _active.finish({ status: 'ok' })
+      _active = null
+    }
+    const name = `${from.path || '/'} → ${to.path || '/'}`
+    const span = startSpan('vue.navigation', {
+      name,
+      parent: null,
+      tags: { 'nav.from': from.path || '/', 'nav.to': to.path || '/' },
+    })
+    _active = span
+    setActiveSpan(span)
+    // Phase 46 — also record into the session-trail buffer; no-op
+    // unless `init({ capture: { sessionTrail: true } })`.
+    captureStep(`route:${to.path || '/'}`, {
+      breadcrumb: { type: 'navigation', message: name },
+    })
+  })
+  router.afterEach(() => {
+    if (_active) {
+      _active.finish({ status: 'ok' })
+      _active = null
+    }
+  })
+}