@tracewayapp/svelte 0.2.0

package/README.md

@@ -0,0 +1,72 @@
+# @tracewayapp/svelte
+
+Svelte integration for Traceway. Provides context setup and a helper function to capture errors.
+
+## Setup
+
+Call `setupTraceway` in your root component (e.g., `App.svelte`) to initialize Traceway and provide context to child components.
+
+```svelte
+<script>
+  import { setupTraceway } from "@tracewayapp/svelte";
+
+  setupTraceway({
+    connectionString: "your-token@https://your-server.com/api/report",
+    options: { debug: true }, // optional
+  });
+</script>
+
+<slot />
+```
+
+## getTraceway Helper
+
+Access capture methods from any child component.
+
+```svelte
+<script>
+  import { getTraceway } from "@tracewayapp/svelte";
+
+  const { captureException, captureMessage } = getTraceway();
+
+  function handleClick() {
+    try {
+      doSomething();
+    } catch (err) {
+      captureException(err);
+    }
+  }
+</script>
+
+<button on:click={handleClick}>Do Something</button>
+```
+
+## API
+
+### setupTraceway(options)
+
+Initializes Traceway and provides context to the component tree. Must be called during component initialization.
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `connectionString` | `string` | Traceway connection string (`token@url`) |
+| `options` | `TracewayFrontendOptions` | Optional SDK configuration |
+
+Returns `{ captureException, captureExceptionWithAttributes, captureMessage }`.
+
+### getTraceway()
+
+Returns `{ captureException, captureExceptionWithAttributes, captureMessage }`.
+
+Throws if used outside a component tree where `setupTraceway` has been called.
+
+## Global Error Handling
+
+Traceway automatically installs global error handlers (`window.onerror` and `onunhandledrejection`) when initialized. These capture uncaught errors and unhandled promise rejections.
+
+For Svelte-specific error handling, you can use Svelte's `onError` lifecycle function or wrap error-prone code in try/catch blocks using `captureException`.
+
+## Requirements
+
+- Svelte >= 4.0
+- `@tracewayapp/frontend` (installed automatically as dependency)

package/dist/index.d.mts

@@ -0,0 +1,19 @@
+import * as traceway from '@tracewayapp/frontend';
+import { TracewayFrontendOptions } from '@tracewayapp/frontend';
+
+interface TracewayOptions {
+    connectionString: string;
+    options?: TracewayFrontendOptions;
+}
+interface TracewayContextValue {
+    captureException: typeof traceway.captureException;
+    captureExceptionWithAttributes: typeof traceway.captureExceptionWithAttributes;
+    captureMessage: typeof traceway.captureMessage;
+}
+
+declare const TRACEWAY_KEY: unique symbol;
+declare function setupTraceway(options: TracewayOptions): TracewayContextValue;
+
+declare function getTraceway(): TracewayContextValue;
+
+export { TRACEWAY_KEY, type TracewayContextValue, type TracewayOptions, getTraceway, setupTraceway };

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import * as traceway from '@tracewayapp/frontend';
+import { TracewayFrontendOptions } from '@tracewayapp/frontend';
+
+interface TracewayOptions {
+    connectionString: string;
+    options?: TracewayFrontendOptions;
+}
+interface TracewayContextValue {
+    captureException: typeof traceway.captureException;
+    captureExceptionWithAttributes: typeof traceway.captureExceptionWithAttributes;
+    captureMessage: typeof traceway.captureMessage;
+}
+
+declare const TRACEWAY_KEY: unique symbol;
+declare function setupTraceway(options: TracewayOptions): TracewayContextValue;
+
+declare function getTraceway(): TracewayContextValue;
+
+export { TRACEWAY_KEY, type TracewayContextValue, type TracewayOptions, getTraceway, setupTraceway };

package/dist/index.js

@@ -0,0 +1,73 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  TRACEWAY_KEY: () => TRACEWAY_KEY,
+  getTraceway: () => getTraceway,
+  setupTraceway: () => setupTraceway
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/context.ts
+var import_svelte = require("svelte");
+var traceway = __toESM(require("@tracewayapp/frontend"));
+var TRACEWAY_KEY = /* @__PURE__ */ Symbol("traceway");
+function setupTraceway(options) {
+  const context = {
+    captureException: traceway.captureException,
+    captureExceptionWithAttributes: traceway.captureExceptionWithAttributes,
+    captureMessage: traceway.captureMessage
+  };
+  (0, import_svelte.setContext)(TRACEWAY_KEY, context);
+  (0, import_svelte.onMount)(() => {
+    traceway.init(options.connectionString, options.options);
+  });
+  return context;
+}
+
+// src/use-traceway.ts
+var import_svelte2 = require("svelte");
+function getTraceway() {
+  const context = (0, import_svelte2.getContext)(TRACEWAY_KEY);
+  if (!context) {
+    throw new Error(
+      "getTraceway must be used within a Svelte component tree that has called setupTraceway"
+    );
+  }
+  return context;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  TRACEWAY_KEY,
+  getTraceway,
+  setupTraceway
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/context.ts","../src/use-traceway.ts"],"sourcesContent":["export { setupTraceway, TRACEWAY_KEY } from \"./context.js\";\nexport { getTraceway } from \"./use-traceway.js\";\nexport type { TracewayOptions, TracewayContextValue } from \"./types.js\";\n","import { setContext, onMount } from \"svelte\";\nimport * as traceway from \"@tracewayapp/frontend\";\nimport type { TracewayOptions, TracewayContextValue } from \"./types.js\";\n\nexport const TRACEWAY_KEY = Symbol(\"traceway\");\n\nexport function setupTraceway(options: TracewayOptions): TracewayContextValue {\n  const context: TracewayContextValue = {\n    captureException: traceway.captureException,\n    captureExceptionWithAttributes: traceway.captureExceptionWithAttributes,\n    captureMessage: traceway.captureMessage,\n  };\n\n  setContext(TRACEWAY_KEY, context);\n\n  onMount(() => {\n    traceway.init(options.connectionString, options.options);\n  });\n\n  return context;\n}\n","import { getContext } from \"svelte\";\nimport { TRACEWAY_KEY } from \"./context.js\";\nimport type { TracewayContextValue } from \"./types.js\";\n\nexport function getTraceway(): TracewayContextValue {\n  const context = getContext<TracewayContextValue>(TRACEWAY_KEY);\n  if (!context) {\n    throw new Error(\n      \"getTraceway must be used within a Svelte component tree that has called setupTraceway\"\n    );\n  }\n  return context;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAoC;AACpC,eAA0B;AAGnB,IAAM,eAAe,uBAAO,UAAU;AAEtC,SAAS,cAAc,SAAgD;AAC5E,QAAM,UAAgC;AAAA,IACpC,kBAA2B;AAAA,IAC3B,gCAAyC;AAAA,IACzC,gBAAyB;AAAA,EAC3B;AAEA,gCAAW,cAAc,OAAO;AAEhC,6BAAQ,MAAM;AACZ,IAAS,cAAK,QAAQ,kBAAkB,QAAQ,OAAO;AAAA,EACzD,CAAC;AAED,SAAO;AACT;;;ACpBA,IAAAA,iBAA2B;AAIpB,SAAS,cAAoC;AAClD,QAAM,cAAU,2BAAiC,YAAY;AAC7D,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;","names":["import_svelte"]}

package/dist/index.mjs

@@ -0,0 +1,34 @@
+// src/context.ts
+import { setContext, onMount } from "svelte";
+import * as traceway from "@tracewayapp/frontend";
+var TRACEWAY_KEY = /* @__PURE__ */ Symbol("traceway");
+function setupTraceway(options) {
+  const context = {
+    captureException: traceway.captureException,
+    captureExceptionWithAttributes: traceway.captureExceptionWithAttributes,
+    captureMessage: traceway.captureMessage
+  };
+  setContext(TRACEWAY_KEY, context);
+  onMount(() => {
+    traceway.init(options.connectionString, options.options);
+  });
+  return context;
+}
+
+// src/use-traceway.ts
+import { getContext } from "svelte";
+function getTraceway() {
+  const context = getContext(TRACEWAY_KEY);
+  if (!context) {
+    throw new Error(
+      "getTraceway must be used within a Svelte component tree that has called setupTraceway"
+    );
+  }
+  return context;
+}
+export {
+  TRACEWAY_KEY,
+  getTraceway,
+  setupTraceway
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/context.ts","../src/use-traceway.ts"],"sourcesContent":["import { setContext, onMount } from \"svelte\";\nimport * as traceway from \"@tracewayapp/frontend\";\nimport type { TracewayOptions, TracewayContextValue } from \"./types.js\";\n\nexport const TRACEWAY_KEY = Symbol(\"traceway\");\n\nexport function setupTraceway(options: TracewayOptions): TracewayContextValue {\n  const context: TracewayContextValue = {\n    captureException: traceway.captureException,\n    captureExceptionWithAttributes: traceway.captureExceptionWithAttributes,\n    captureMessage: traceway.captureMessage,\n  };\n\n  setContext(TRACEWAY_KEY, context);\n\n  onMount(() => {\n    traceway.init(options.connectionString, options.options);\n  });\n\n  return context;\n}\n","import { getContext } from \"svelte\";\nimport { TRACEWAY_KEY } from \"./context.js\";\nimport type { TracewayContextValue } from \"./types.js\";\n\nexport function getTraceway(): TracewayContextValue {\n  const context = getContext<TracewayContextValue>(TRACEWAY_KEY);\n  if (!context) {\n    throw new Error(\n      \"getTraceway must be used within a Svelte component tree that has called setupTraceway\"\n    );\n  }\n  return context;\n}\n"],"mappings":";AAAA,SAAS,YAAY,eAAe;AACpC,YAAY,cAAc;AAGnB,IAAM,eAAe,uBAAO,UAAU;AAEtC,SAAS,cAAc,SAAgD;AAC5E,QAAM,UAAgC;AAAA,IACpC,kBAA2B;AAAA,IAC3B,gCAAyC;AAAA,IACzC,gBAAyB;AAAA,EAC3B;AAEA,aAAW,cAAc,OAAO;AAEhC,UAAQ,MAAM;AACZ,IAAS,cAAK,QAAQ,kBAAkB,QAAQ,OAAO;AAAA,EACzD,CAAC;AAED,SAAO;AACT;;;ACpBA,SAAS,kBAAkB;AAIpB,SAAS,cAAoC;AAClD,QAAM,UAAU,WAAiC,YAAY;AAC7D,MAAI,CAAC,SAAS;AACZ,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO;AACT;","names":[]}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@tracewayapp/svelte",
+  "version": "0.2.0",
+  "description": "Traceway Svelte integration with context and helper functions",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "dependencies": {
+    "@tracewayapp/frontend": "0.2.0"
+  },
+  "peerDependencies": {
+    "svelte": ">=4.0.0"
+  }
+}