@goliapkg/sentori-svelte 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Phase 45 sub-C — Svelte / SvelteKit adapter for Sentori.
+ *
+ * SvelteKit usage (preferred):
+ *
+ *     // hooks.client.ts
+ *     import { initSentori } from '@goliapkg/sentori-svelte'
+ *     initSentori({ token: 'st_pk_...', release: 'myapp@1.0.0' })
+ *
+ *     export const handleError = sentoriHandleError()
+ *
+ * What you get:
+ *   - `initSentori(opts)` — thin wrapper over the JS SDK init
+ *   - `sentoriHandleError()` — returns a SvelteKit `HandleClientError`
+ *     hook that captures into Sentori then returns the original
+ *     error metadata so SvelteKit's own error page still renders
+ *   - `traceNavigation(navigating)` — feed `$navigating` from
+ *     `$app/stores` and we open / finish `svelte.navigation` spans
+ *     per route transition (one trace per screen, same shape as
+ *     the Vue + RN adapters)
+ *
+ * Vanilla Svelte (no SvelteKit) — call `initSentori` from your app
+ * root + use the `<svelte:boundary>` element (Svelte 5+) or
+ * `onError` prop on your top-level component.
+ */
+import { type InitOptions } from '@goliapkg/sentori-javascript';
+export type SentoriSvelteOptions = InitOptions;
+export declare function initSentori(options: SentoriSvelteOptions): void;
+/**
+ * SvelteKit `handleError` hook factory. Returns a function with the
+ * `HandleClientError` shape (parameters typed loosely so we don't
+ * need to import SvelteKit's `@sveltejs/kit` types and force a
+ * peer dep).
+ */
+export declare function sentoriHandleError(): (input: {
+    error: unknown;
+    event?: unknown;
+    status?: number;
+    message?: string;
+}) => {
+    message: string;
+};
+type NavigatingLike = null | {
+    from?: {
+        url: {
+            pathname: string;
+        };
+    };
+    to?: {
+        url: {
+            pathname: string;
+        };
+    };
+};
+export declare function traceNavigation(navigating: NavigatingLike): void;
+export { addBreadcrumb, captureException, captureException as captureError, captureStep, getUser, setUser, } from '@goliapkg/sentori-javascript';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAA;AAGrC,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAA;AAE9C,wBAAgB,WAAW,CAAC,OAAO,EAAE,oBAAoB,GAAG,IAAI,CAE/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,IAAI,CAAC,KAAK,EAAE;IAC5C,KAAK,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAK;IAAE,OAAO,EAAE,MAAM,CAAA;CAAE,CAMxB;AAaD,KAAK,cAAc,GAAG,IAAI,GAAG;IAAE,IAAI,CAAC,EAAE;QAAE,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAAC,EAAE,CAAC,EAAE;QAAE,GAAG,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;CAAE,CAAA;AACzG,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,GAAG,IAAI,CAsBhE;AAED,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,IAAI,YAAY,EAChC,WAAW,EACX,OAAO,EACP,OAAO,GACR,MAAM,8BAA8B,CAAA"}

package/lib/index.js

@@ -0,0 +1,80 @@
+/**
+ * Phase 45 sub-C — Svelte / SvelteKit adapter for Sentori.
+ *
+ * SvelteKit usage (preferred):
+ *
+ *     // hooks.client.ts
+ *     import { initSentori } from '@goliapkg/sentori-svelte'
+ *     initSentori({ token: 'st_pk_...', release: 'myapp@1.0.0' })
+ *
+ *     export const handleError = sentoriHandleError()
+ *
+ * What you get:
+ *   - `initSentori(opts)` — thin wrapper over the JS SDK init
+ *   - `sentoriHandleError()` — returns a SvelteKit `HandleClientError`
+ *     hook that captures into Sentori then returns the original
+ *     error metadata so SvelteKit's own error page still renders
+ *   - `traceNavigation(navigating)` — feed `$navigating` from
+ *     `$app/stores` and we open / finish `svelte.navigation` spans
+ *     per route transition (one trace per screen, same shape as
+ *     the Vue + RN adapters)
+ *
+ * Vanilla Svelte (no SvelteKit) — call `initSentori` from your app
+ * root + use the `<svelte:boundary>` element (Svelte 5+) or
+ * `onError` prop on your top-level component.
+ */
+import { captureException as captureExceptionJs, captureStep, initSentori as initSentoriJs, } from '@goliapkg/sentori-javascript';
+import { setActiveSpan, startSpan } from '@goliapkg/sentori-core';
+export function initSentori(options) {
+    initSentoriJs(options);
+}
+/**
+ * SvelteKit `handleError` hook factory. Returns a function with the
+ * `HandleClientError` shape (parameters typed loosely so we don't
+ * need to import SvelteKit's `@sveltejs/kit` types and force a
+ * peer dep).
+ */
+export function sentoriHandleError() {
+    return ({ error, message }) => {
+        const e = error instanceof Error ? error : new Error(String(error));
+        captureExceptionJs(e);
+        return { message: message ?? e.message };
+    };
+}
+/**
+ * Trace page navigation. Pass SvelteKit's `$navigating` store value
+ * — when it transitions from null → some route, we open a span;
+ * when it transitions back to null, we finish it.
+ *
+ *     // +layout.svelte
+ *     import { traceNavigation } from '@goliapkg/sentori-svelte'
+ *     import { navigating } from '$app/stores'
+ *     $: traceNavigation($navigating)
+ */
+let _active = null;
+export function traceNavigation(navigating) {
+    if (navigating) {
+        if (_active) {
+            _active.finish({ status: 'ok' });
+            _active = null;
+        }
+        const from = navigating.from?.url.pathname ?? '/';
+        const to = navigating.to?.url.pathname ?? '/';
+        const span = startSpan('svelte.navigation', {
+            name: `${from} → ${to}`,
+            parent: null,
+            tags: { 'nav.from': from, 'nav.to': to },
+        });
+        _active = span;
+        setActiveSpan(span);
+        captureStep(`route:${to}`, {
+            breadcrumb: { type: 'navigation', message: `${from} → ${to}` },
+        });
+    }
+    else if (_active) {
+        _active.finish({ status: 'ok' });
+        _active = null;
+    }
+}
+export { addBreadcrumb, captureException, captureException as captureError, captureStep, getUser, setUser, } from '@goliapkg/sentori-javascript';
+//# 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;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EACL,gBAAgB,IAAI,kBAAkB,EACtC,WAAW,EACX,WAAW,IAAI,aAAa,GAE7B,MAAM,8BAA8B,CAAA;AACrC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAA;AAIlF,MAAM,UAAU,WAAW,CAAC,OAA6B;IACvD,aAAa,CAAC,OAAO,CAAC,CAAA;AACxB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB;IAMhC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,EAAE;QAC5B,MAAM,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAA;QACnE,kBAAkB,CAAC,CAAC,CAAC,CAAA;QACrB,OAAO,EAAE,OAAO,EAAE,OAAO,IAAI,CAAC,CAAC,OAAO,EAAE,CAAA;IAC1C,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;;GASG;AACH,IAAI,OAAO,GAAsB,IAAI,CAAA;AAErC,MAAM,UAAU,eAAe,CAAC,UAA0B;IACxD,IAAI,UAAU,EAAE,CAAC;QACf,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,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAA;QACjD,MAAM,EAAE,GAAG,UAAU,CAAC,EAAE,EAAE,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAA;QAC7C,MAAM,IAAI,GAAG,SAAS,CAAC,mBAAmB,EAAE;YAC1C,IAAI,EAAE,GAAG,IAAI,MAAM,EAAE,EAAE;YACvB,MAAM,EAAE,IAAI;YACZ,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE;SACzC,CAAC,CAAA;QACF,OAAO,GAAG,IAAI,CAAA;QACd,aAAa,CAAC,IAAI,CAAC,CAAA;QACnB,WAAW,CAAC,SAAS,EAAE,EAAE,EAAE;YACzB,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,MAAM,EAAE,EAAE,EAAE;SAC/D,CAAC,CAAA;IACJ,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAChC,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;AACH,CAAC;AAED,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,IAAI,YAAY,EAChC,WAAW,EACX,OAAO,EACP,OAAO,GACR,MAAM,8BAA8B,CAAA"}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@goliapkg/sentori-svelte",
+  "version": "0.1.0",
+  "description": "Svelte / SvelteKit adapter for Sentori — hooks.client + hooks.server init helpers, page navigation tracing.",
+  "license": "MIT",
+  "homepage": "https://sentori.golia.jp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goliajp/sentori.git",
+    "directory": "sdk/svelte"
+  },
+  "bugs": {
+    "url": "https://github.com/goliajp/sentori/issues"
+  },
+  "keywords": [
+    "sentori",
+    "svelte",
+    "sveltekit",
+    "error-tracking"
+  ],
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib/",
+    "src/",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "prepack": "bun run build"
+  },
+  "peerDependencies": {
+    "svelte": ">=4"
+  },
+  "peerDependenciesMeta": {
+    "svelte": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@goliapkg/sentori-core": "0.6.0",
+    "@goliapkg/sentori-javascript": "0.4.0"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/__tests__/smoke.test.ts

@@ -0,0 +1,34 @@
+import { describe, expect, test } from 'bun:test'
+
+import {
+  addBreadcrumb,
+  captureException,
+  initSentori,
+  sentoriHandleError,
+  traceNavigation,
+} from '../index.js'
+
+describe('@goliapkg/sentori-svelte exports', () => {
+  test('exports the SDK init + capture surface', () => {
+    expect(typeof initSentori).toBe('function')
+    expect(typeof captureException).toBe('function')
+    expect(typeof addBreadcrumb).toBe('function')
+  })
+
+  test('sentoriHandleError returns a SvelteKit-shaped handler', () => {
+    const handler = sentoriHandleError()
+    const result = handler({ error: new Error('boom'), message: 'custom' })
+    expect(result).toEqual({ message: 'custom' })
+
+    const result2 = handler({ error: 'string-thrown' })
+    expect(result2.message).toBe('string-thrown')
+  })
+
+  test('traceNavigation accepts null + nav-object shape without throwing', () => {
+    expect(() => {
+      traceNavigation(null)
+      traceNavigation({ from: { url: { pathname: '/a' } }, to: { url: { pathname: '/b' } } })
+      traceNavigation(null)
+    }).not.toThrow()
+  })
+})

package/src/index.ts

@@ -0,0 +1,103 @@
+/**
+ * Phase 45 sub-C — Svelte / SvelteKit adapter for Sentori.
+ *
+ * SvelteKit usage (preferred):
+ *
+ *     // hooks.client.ts
+ *     import { initSentori } from '@goliapkg/sentori-svelte'
+ *     initSentori({ token: 'st_pk_...', release: 'myapp@1.0.0' })
+ *
+ *     export const handleError = sentoriHandleError()
+ *
+ * What you get:
+ *   - `initSentori(opts)` — thin wrapper over the JS SDK init
+ *   - `sentoriHandleError()` — returns a SvelteKit `HandleClientError`
+ *     hook that captures into Sentori then returns the original
+ *     error metadata so SvelteKit's own error page still renders
+ *   - `traceNavigation(navigating)` — feed `$navigating` from
+ *     `$app/stores` and we open / finish `svelte.navigation` spans
+ *     per route transition (one trace per screen, same shape as
+ *     the Vue + RN adapters)
+ *
+ * Vanilla Svelte (no SvelteKit) — call `initSentori` from your app
+ * root + use the `<svelte:boundary>` element (Svelte 5+) or
+ * `onError` prop on your top-level component.
+ */
+
+import {
+  captureException as captureExceptionJs,
+  captureStep,
+  initSentori as initSentoriJs,
+  type InitOptions,
+} from '@goliapkg/sentori-javascript'
+import { setActiveSpan, startSpan, type SpanHandle } from '@goliapkg/sentori-core'
+
+export type SentoriSvelteOptions = InitOptions
+
+export function initSentori(options: SentoriSvelteOptions): void {
+  initSentoriJs(options)
+}
+
+/**
+ * SvelteKit `handleError` hook factory. Returns a function with the
+ * `HandleClientError` shape (parameters typed loosely so we don't
+ * need to import SvelteKit's `@sveltejs/kit` types and force a
+ * peer dep).
+ */
+export function sentoriHandleError(): (input: {
+  error: unknown
+  event?: unknown
+  status?: number
+  message?: string
+}) => { message: string } {
+  return ({ error, message }) => {
+    const e = error instanceof Error ? error : new Error(String(error))
+    captureExceptionJs(e)
+    return { message: message ?? e.message }
+  }
+}
+
+/**
+ * Trace page navigation. Pass SvelteKit's `$navigating` store value
+ * — when it transitions from null → some route, we open a span;
+ * when it transitions back to null, we finish it.
+ *
+ *     // +layout.svelte
+ *     import { traceNavigation } from '@goliapkg/sentori-svelte'
+ *     import { navigating } from '$app/stores'
+ *     $: traceNavigation($navigating)
+ */
+let _active: SpanHandle | null = null
+type NavigatingLike = null | { from?: { url: { pathname: string } }; to?: { url: { pathname: string } } }
+export function traceNavigation(navigating: NavigatingLike): void {
+  if (navigating) {
+    if (_active) {
+      _active.finish({ status: 'ok' })
+      _active = null
+    }
+    const from = navigating.from?.url.pathname ?? '/'
+    const to = navigating.to?.url.pathname ?? '/'
+    const span = startSpan('svelte.navigation', {
+      name: `${from} → ${to}`,
+      parent: null,
+      tags: { 'nav.from': from, 'nav.to': to },
+    })
+    _active = span
+    setActiveSpan(span)
+    captureStep(`route:${to}`, {
+      breadcrumb: { type: 'navigation', message: `${from} → ${to}` },
+    })
+  } else if (_active) {
+    _active.finish({ status: 'ok' })
+    _active = null
+  }
+}
+
+export {
+  addBreadcrumb,
+  captureException,
+  captureException as captureError,
+  captureStep,
+  getUser,
+  setUser,
+} from '@goliapkg/sentori-javascript'