@goliapkg/sentori-solid 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Phase 45 sub-D — SolidJS adapter for Sentori.
+ *
+ *     import { initSentori, captureException } from '@goliapkg/sentori-solid'
+ *
+ *     initSentori({ token: 'st_pk_...', release: 'myapp@1.0.0' })
+ *
+ * What's in this package vs `@goliapkg/sentori-javascript`:
+ *
+ *   - `initSentori` / `captureException` re-exported as-is (no
+ *     Solid-specific transform needed; Solid uses ES2020 modules
+ *     and the JS SDK is framework-agnostic)
+ *   - `wrapWithBoundary(props)` — adapter that hands an error
+ *     callback to Solid's built-in `<ErrorBoundary>` so anything
+ *     thrown in render lands in Sentori. Apps import Solid's
+ *     `<ErrorBoundary>` directly; this is just the `onCatch`
+ *     callback they pass.
+ *   - `traceSolidRouter(routerLocation)` — pass `useLocation()`
+ *     from `@solidjs/router` and we open a `solid.navigation` span
+ *     per route. SDK consumers wire it inside a `createEffect`.
+ *
+ * SolidJS is a small enough framework that we deliberately don't
+ * ship a giant API. Most users will just need `initSentori` +
+ * `captureException`.
+ */
+import { type InitOptions } from '@goliapkg/sentori-javascript';
+export type SentoriSolidOptions = InitOptions;
+export declare function initSentori(options: SentoriSolidOptions): void;
+/**
+ * Callback to wire into Solid's built-in `<ErrorBoundary onCatch={...}>`.
+ *
+ *     import { ErrorBoundary } from 'solid-js'
+ *     import { sentoriOnCatch } from '@goliapkg/sentori-solid'
+ *
+ *     <ErrorBoundary fallback={...} onCatch={sentoriOnCatch}>
+ *       <App />
+ *     </ErrorBoundary>
+ *
+ * (Solid's `<ErrorBoundary>` exposes the onCatch hook via
+ * `solidjs.ErrorBoundary`; the callback fires on `Error` thrown in
+ * render / lifecycle and is the SolidJS-idiomatic place to forward
+ * into a monitoring service.)
+ */
+export declare function sentoriOnCatch(err: unknown): void;
+export declare function traceSolidRouter(pathname: string): 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;AAGH,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,8BAA8B,CAAA;AAErC,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAA;AAE7C,wBAAgB,WAAW,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAE9D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI,CAGjD;AAeD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAkBvD;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,84 @@
+/**
+ * Phase 45 sub-D — SolidJS adapter for Sentori.
+ *
+ *     import { initSentori, captureException } from '@goliapkg/sentori-solid'
+ *
+ *     initSentori({ token: 'st_pk_...', release: 'myapp@1.0.0' })
+ *
+ * What's in this package vs `@goliapkg/sentori-javascript`:
+ *
+ *   - `initSentori` / `captureException` re-exported as-is (no
+ *     Solid-specific transform needed; Solid uses ES2020 modules
+ *     and the JS SDK is framework-agnostic)
+ *   - `wrapWithBoundary(props)` — adapter that hands an error
+ *     callback to Solid's built-in `<ErrorBoundary>` so anything
+ *     thrown in render lands in Sentori. Apps import Solid's
+ *     `<ErrorBoundary>` directly; this is just the `onCatch`
+ *     callback they pass.
+ *   - `traceSolidRouter(routerLocation)` — pass `useLocation()`
+ *     from `@solidjs/router` and we open a `solid.navigation` span
+ *     per route. SDK consumers wire it inside a `createEffect`.
+ *
+ * SolidJS is a small enough framework that we deliberately don't
+ * ship a giant API. Most users will just need `initSentori` +
+ * `captureException`.
+ */
+import { setActiveSpan, startSpan } from '@goliapkg/sentori-core';
+import { captureException as captureExceptionJs, captureStep, initSentori as initSentoriJs, } from '@goliapkg/sentori-javascript';
+export function initSentori(options) {
+    initSentoriJs(options);
+}
+/**
+ * Callback to wire into Solid's built-in `<ErrorBoundary onCatch={...}>`.
+ *
+ *     import { ErrorBoundary } from 'solid-js'
+ *     import { sentoriOnCatch } from '@goliapkg/sentori-solid'
+ *
+ *     <ErrorBoundary fallback={...} onCatch={sentoriOnCatch}>
+ *       <App />
+ *     </ErrorBoundary>
+ *
+ * (Solid's `<ErrorBoundary>` exposes the onCatch hook via
+ * `solidjs.ErrorBoundary`; the callback fires on `Error` thrown in
+ * render / lifecycle and is the SolidJS-idiomatic place to forward
+ * into a monitoring service.)
+ */
+export function sentoriOnCatch(err) {
+    const e = err instanceof Error ? err : new Error(String(err));
+    captureExceptionJs(e);
+}
+/**
+ * Trace navigation by calling this from a `createEffect` whenever
+ * `useLocation().pathname` changes:
+ *
+ *     import { useLocation } from '@solidjs/router'
+ *     import { createEffect } from 'solid-js'
+ *     import { traceSolidRouter } from '@goliapkg/sentori-solid'
+ *
+ *     const loc = useLocation()
+ *     createEffect(() => traceSolidRouter(loc.pathname))
+ */
+let _active = null;
+let _lastPath = null;
+export function traceSolidRouter(pathname) {
+    if (pathname === _lastPath)
+        return;
+    if (_active) {
+        _active.finish({ status: 'ok' });
+        _active = null;
+    }
+    const from = _lastPath ?? '/';
+    const span = startSpan('solid.navigation', {
+        name: `${from} → ${pathname}`,
+        parent: null,
+        tags: { 'nav.from': from, 'nav.to': pathname },
+    });
+    _active = span;
+    setActiveSpan(span);
+    captureStep(`route:${pathname}`, {
+        breadcrumb: { type: 'navigation', message: `${from} → ${pathname}` },
+    });
+    _lastPath = pathname;
+}
+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,EAAE,aAAa,EAAE,SAAS,EAAmB,MAAM,wBAAwB,CAAA;AAClF,OAAO,EACL,gBAAgB,IAAI,kBAAkB,EACtC,WAAW,EACX,WAAW,IAAI,aAAa,GAE7B,MAAM,8BAA8B,CAAA;AAIrC,MAAM,UAAU,WAAW,CAAC,OAA4B;IACtD,aAAa,CAAC,OAAO,CAAC,CAAA;AACxB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,GAAY;IACzC,MAAM,CAAC,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;IAC7D,kBAAkB,CAAC,CAAC,CAAC,CAAA;AACvB,CAAC;AAED;;;;;;;;;;GAUG;AACH,IAAI,OAAO,GAAsB,IAAI,CAAA;AACrC,IAAI,SAAS,GAAkB,IAAI,CAAA;AACnC,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAM;IAClC,IAAI,OAAO,EAAE,CAAC;QACZ,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;QAChC,OAAO,GAAG,IAAI,CAAA;IAChB,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,IAAI,GAAG,CAAA;IAC7B,MAAM,IAAI,GAAG,SAAS,CAAC,kBAAkB,EAAE;QACzC,IAAI,EAAE,GAAG,IAAI,MAAM,QAAQ,EAAE;QAC7B,MAAM,EAAE,IAAI;QACZ,IAAI,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE;KAC/C,CAAC,CAAA;IACF,OAAO,GAAG,IAAI,CAAA;IACd,aAAa,CAAC,IAAI,CAAC,CAAA;IACnB,WAAW,CAAC,SAAS,QAAQ,EAAE,EAAE;QAC/B,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,MAAM,QAAQ,EAAE,EAAE;KACrE,CAAC,CAAA;IACF,SAAS,GAAG,QAAQ,CAAA;AACtB,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-solid",
+  "version": "0.1.0",
+  "description": "SolidJS adapter for Sentori — ErrorBoundary helper, solid-router navigation tracing.",
+  "license": "MIT",
+  "homepage": "https://sentori.golia.jp",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goliajp/sentori.git",
+    "directory": "sdk/solid"
+  },
+  "bugs": {
+    "url": "https://github.com/goliajp/sentori/issues"
+  },
+  "keywords": [
+    "sentori",
+    "solid",
+    "solidjs",
+    "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": {
+    "solid-js": ">=1.8"
+  },
+  "peerDependenciesMeta": {
+    "solid-js": {
+      "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,33 @@
+import { describe, expect, test } from 'bun:test'
+
+import {
+  addBreadcrumb,
+  captureException,
+  initSentori,
+  sentoriOnCatch,
+  traceSolidRouter,
+} from '../index.js'
+
+describe('@goliapkg/sentori-solid exports', () => {
+  test('exports the SDK init + capture surface', () => {
+    expect(typeof initSentori).toBe('function')
+    expect(typeof captureException).toBe('function')
+    expect(typeof addBreadcrumb).toBe('function')
+  })
+
+  test('sentoriOnCatch normalises non-Error throws', () => {
+    expect(() => {
+      sentoriOnCatch(new Error('explicit'))
+      sentoriOnCatch('strung')
+      sentoriOnCatch({ unexpected: 'shape' })
+    }).not.toThrow()
+  })
+
+  test('traceSolidRouter is idempotent across same pathname', () => {
+    expect(() => {
+      traceSolidRouter('/a')
+      traceSolidRouter('/a')
+      traceSolidRouter('/b')
+    }).not.toThrow()
+  })
+})

package/src/index.ts

@@ -0,0 +1,101 @@
+/**
+ * Phase 45 sub-D — SolidJS adapter for Sentori.
+ *
+ *     import { initSentori, captureException } from '@goliapkg/sentori-solid'
+ *
+ *     initSentori({ token: 'st_pk_...', release: 'myapp@1.0.0' })
+ *
+ * What's in this package vs `@goliapkg/sentori-javascript`:
+ *
+ *   - `initSentori` / `captureException` re-exported as-is (no
+ *     Solid-specific transform needed; Solid uses ES2020 modules
+ *     and the JS SDK is framework-agnostic)
+ *   - `wrapWithBoundary(props)` — adapter that hands an error
+ *     callback to Solid's built-in `<ErrorBoundary>` so anything
+ *     thrown in render lands in Sentori. Apps import Solid's
+ *     `<ErrorBoundary>` directly; this is just the `onCatch`
+ *     callback they pass.
+ *   - `traceSolidRouter(routerLocation)` — pass `useLocation()`
+ *     from `@solidjs/router` and we open a `solid.navigation` span
+ *     per route. SDK consumers wire it inside a `createEffect`.
+ *
+ * SolidJS is a small enough framework that we deliberately don't
+ * ship a giant API. Most users will just need `initSentori` +
+ * `captureException`.
+ */
+
+import { setActiveSpan, startSpan, type SpanHandle } from '@goliapkg/sentori-core'
+import {
+  captureException as captureExceptionJs,
+  captureStep,
+  initSentori as initSentoriJs,
+  type InitOptions,
+} from '@goliapkg/sentori-javascript'
+
+export type SentoriSolidOptions = InitOptions
+
+export function initSentori(options: SentoriSolidOptions): void {
+  initSentoriJs(options)
+}
+
+/**
+ * Callback to wire into Solid's built-in `<ErrorBoundary onCatch={...}>`.
+ *
+ *     import { ErrorBoundary } from 'solid-js'
+ *     import { sentoriOnCatch } from '@goliapkg/sentori-solid'
+ *
+ *     <ErrorBoundary fallback={...} onCatch={sentoriOnCatch}>
+ *       <App />
+ *     </ErrorBoundary>
+ *
+ * (Solid's `<ErrorBoundary>` exposes the onCatch hook via
+ * `solidjs.ErrorBoundary`; the callback fires on `Error` thrown in
+ * render / lifecycle and is the SolidJS-idiomatic place to forward
+ * into a monitoring service.)
+ */
+export function sentoriOnCatch(err: unknown): void {
+  const e = err instanceof Error ? err : new Error(String(err))
+  captureExceptionJs(e)
+}
+
+/**
+ * Trace navigation by calling this from a `createEffect` whenever
+ * `useLocation().pathname` changes:
+ *
+ *     import { useLocation } from '@solidjs/router'
+ *     import { createEffect } from 'solid-js'
+ *     import { traceSolidRouter } from '@goliapkg/sentori-solid'
+ *
+ *     const loc = useLocation()
+ *     createEffect(() => traceSolidRouter(loc.pathname))
+ */
+let _active: SpanHandle | null = null
+let _lastPath: null | string = null
+export function traceSolidRouter(pathname: string): void {
+  if (pathname === _lastPath) return
+  if (_active) {
+    _active.finish({ status: 'ok' })
+    _active = null
+  }
+  const from = _lastPath ?? '/'
+  const span = startSpan('solid.navigation', {
+    name: `${from} → ${pathname}`,
+    parent: null,
+    tags: { 'nav.from': from, 'nav.to': pathname },
+  })
+  _active = span
+  setActiveSpan(span)
+  captureStep(`route:${pathname}`, {
+    breadcrumb: { type: 'navigation', message: `${from} → ${pathname}` },
+  })
+  _lastPath = pathname
+}
+
+export {
+  addBreadcrumb,
+  captureException,
+  captureException as captureError,
+  captureStep,
+  getUser,
+  setUser,
+} from '@goliapkg/sentori-javascript'