@watchupltd/svelte 0.1.0 → 0.1.1

package/dist/index.d.mts

@@ -1,4 +1,25 @@
 export { getWatchup } from './context.mjs';
 export { traceAction, trackClick } from './action.mjs';
-export { ErrorPayload, EventPayload, TracePayload, WatchupOptions } from '@watchupltd/browser';
+import { WatchupUser } from '@watchupltd/browser';
+export { ErrorPayload, EventPayload, TracePayload, WatchupOptions, WatchupUser } from '@watchupltd/browser';
 import 'svelte/action';
+
+/**
+ * Attach a user to all subsequent errors and traces.
+ * Call this after login, inside a Svelte component or store subscription.
+ *
+ * @example
+ * import { identify } from '@watchupltd/svelte';
+ * identify({ id: $user.id, email: $user.email, name: $user.name });
+ */
+declare function identify(user: WatchupUser): void;
+/**
+ * Remove the current user context (e.g. after logout).
+ *
+ * @example
+ * import { clearUser } from '@watchupltd/svelte';
+ * clearUser();
+ */
+declare function clearUser(): void;
+
+export { clearUser, identify };

package/dist/index.d.ts

@@ -1,4 +1,25 @@
 export { getWatchup } from './context.js';
 export { traceAction, trackClick } from './action.js';
-export { ErrorPayload, EventPayload, TracePayload, WatchupOptions } from '@watchupltd/browser';
+import { WatchupUser } from '@watchupltd/browser';
+export { ErrorPayload, EventPayload, TracePayload, WatchupOptions, WatchupUser } from '@watchupltd/browser';
 import 'svelte/action';
+
+/**
+ * Attach a user to all subsequent errors and traces.
+ * Call this after login, inside a Svelte component or store subscription.
+ *
+ * @example
+ * import { identify } from '@watchupltd/svelte';
+ * identify({ id: $user.id, email: $user.email, name: $user.name });
+ */
+declare function identify(user: WatchupUser): void;
+/**
+ * Remove the current user context (e.g. after logout).
+ *
+ * @example
+ * import { clearUser } from '@watchupltd/svelte';
+ * clearUser();
+ */
+declare function clearUser(): void;
+
+export { clearUser, identify };

package/dist/index.js

@@ -52,7 +52,17 @@ var traceAction = (node, params) => {
   };
 };
 
+// src/identify.ts
+function identify(user) {
+  getWatchup().setUser(user);
+}
+function clearUser() {
+  getWatchup().clearUser();
+}
+
+exports.clearUser = clearUser;
 exports.getWatchup = getWatchup;
+exports.identify = identify;
 exports.traceAction = traceAction;
 exports.trackClick = trackClick;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context.ts","../src/action.ts"],"names":["getContext"],"mappings":";;;;;AAOA,IAAM,GAAA,0BAAa,SAAS,CAAA;AAkBrB,SAAS,UAAA,GAAsB;AACpC,EAAA,MAAM,QAAA,GAAWA,kBAAgC,GAAG,CAAA;AACpD,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;;;ACRO,IAAM,UAAA,GAAoD,CAC/D,IAAA,EACA,MAAA,KACG;AACH,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,UAAA,EAAW;AAAA,EACvB,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,UAAU,MAAM;AACpB,IAAA,OAAA,CAAQ,KAAA,CAAM,MAAA,CAAO,KAAA,EAAO,MAAA,CAAO,UAAU,CAAA;AAAA,EAC/C,CAAA;AAEA,EAAA,IAAA,CAAK,gBAAA,CAAiB,SAAS,OAAO,CAAA;AAEtC,EAAA,OAAO;AAAA,IACL,OAAO,SAAA,EAAW;AAChB,MAAA,MAAA,GAAS,SAAA;AAAA,IACX,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,IAAA,CAAK,mBAAA,CAAoB,SAAS,OAAO,CAAA;AAAA,IAC3C;AAAA,GACF;AACF;AAsBO,IAAM,WAAA,GAGT,CAAC,IAAA,EAAM,MAAA,KAAW;AACpB,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,UAAA,EAAW;AAAA,EACvB,CAAA,CAAA,MAAQ;AACN,IAAA,MAAA,CAAO,OAAO,MAAM;AAAA,IAAC,CAAC,CAAA;AACtB,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,UAAA,CAAW,MAAA,CAAO,IAAI,CAAA;AAC1C,EAAA,MAAA,CAAO,OAAO,MAAM,GAAA,CAAI,EAAE,MAAA,EAAQ,IAAA,EAAM,CAAC,CAAA;AAEzC,EAAA,OAAO;AAAA,IACL,OAAA,GAAU;AAAA,IAEV;AAAA,GACF;AACF","file":"index.js","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// @watchupltd/svelte  ·  context helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport { getContext, setContext } from 'svelte';\nimport type { Watchup }          from '@watchupltd/browser';\n\nconst KEY = Symbol('watchup');\n\n/** Called internally by WatchupProvider. */\nexport function _setWatchupContext(instance: Watchup): void {\n  setContext(KEY, instance);\n}\n\n/**\n * Returns the `Watchup` instance from the nearest `<WatchupProvider>`.\n * Call this at component initialisation time (not inside event handlers).\n *\n * @example\n * <script>\n *   import { getWatchup } from '@watchupltd/svelte';\n *   const watchup = getWatchup();\n * </script>\n * <button on:click={() => watchup.track('button.clicked')}>Click me</button>\n */\nexport function getWatchup(): Watchup {\n  const instance = getContext<Watchup | undefined>(KEY);\n  if (!instance) {\n    throw new Error(\n      '[watchup] getWatchup() must be called inside a component ' +\n      'that is a descendant of <WatchupProvider>.',\n    );\n  }\n  return instance;\n}\n","// ─────────────────────────────────────────────────────────────────────────────\n// @watchupltd/svelte  ·  Svelte actions\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { Action }  from 'svelte/action';\nimport type { Watchup } from '@watchupltd/browser';\nimport { getWatchup }  from './context.js';\n\ninterface TrackClickParams {\n  /** Event name sent to Watchup. */\n  event:       string;\n  /** Optional properties merged into the event payload. */\n  properties?: Record<string, unknown>;\n}\n\n/**\n * Svelte action that tracks a click event.\n *\n * @example\n * <script>\n *   import { trackClick } from '@watchupltd/svelte';\n * </script>\n * <button use:trackClick={{ event: 'cta.clicked', properties: { variant: 'A' } }}>\n *   Get started\n * </button>\n */\nexport const trackClick: Action<HTMLElement, TrackClickParams> = (\n  node,\n  params,\n) => {\n  let watchup: Watchup;\n  try {\n    watchup = getWatchup();\n  } catch {\n    // No provider in tree — silently no-op\n    return {};\n  }\n\n  const handler = () => {\n    watchup.track(params.event, params.properties);\n  };\n\n  node.addEventListener('click', handler);\n\n  return {\n    update(newParams) {\n      params = newParams;\n    },\n    destroy() {\n      node.removeEventListener('click', handler);\n    },\n  };\n};\n\n/**\n * Svelte action that traces the time between `mount` and when `done()` is\n * called, emitting a trace span.\n *\n * @example\n * <script>\n *   import { traceAction } from '@watchupltd/svelte';\n *\n *   let done: () => void;\n *\n *   async function load() {\n *     const data = await fetchData();\n *     done?.();\n *     return data;\n *   }\n * </script>\n * <div use:traceAction={{ span: 'dashboard load', onDone: (fn) => (done = fn) }}>\n *   ...\n * </div>\n */\nexport const traceAction: Action<\n  HTMLElement,\n  { span: string; onDone: (endFn: () => void) => void }\n> = (node, params) => {\n  let watchup: Watchup;\n  try {\n    watchup = getWatchup();\n  } catch {\n    params.onDone(() => {});\n    return {};\n  }\n\n  const end = watchup.startTrace(params.span);\n  params.onDone(() => end({ status: 'ok' }));\n\n  return {\n    destroy() {\n      // If destroyed before done() was called, mark as cancelled\n    },\n  };\n};\n"]}
+{"version":3,"sources":["../src/context.ts","../src/action.ts","../src/identify.ts"],"names":["getContext"],"mappings":";;;;;AAOA,IAAM,GAAA,0BAAa,SAAS,CAAA;AAkBrB,SAAS,UAAA,GAAsB;AACpC,EAAA,MAAM,QAAA,GAAWA,kBAAgC,GAAG,CAAA;AACpD,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,KAAA;AAAA,MACR;AAAA,KAEF;AAAA,EACF;AACA,EAAA,OAAO,QAAA;AACT;;;ACRO,IAAM,UAAA,GAAoD,CAC/D,IAAA,EACA,MAAA,KACG;AACH,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,UAAA,EAAW;AAAA,EACvB,CAAA,CAAA,MAAQ;AAEN,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,UAAU,MAAM;AACpB,IAAA,OAAA,CAAQ,KAAA,CAAM,MAAA,CAAO,KAAA,EAAO,MAAA,CAAO,UAAU,CAAA;AAAA,EAC/C,CAAA;AAEA,EAAA,IAAA,CAAK,gBAAA,CAAiB,SAAS,OAAO,CAAA;AAEtC,EAAA,OAAO;AAAA,IACL,OAAO,SAAA,EAAW;AAChB,MAAA,MAAA,GAAS,SAAA;AAAA,IACX,CAAA;AAAA,IACA,OAAA,GAAU;AACR,MAAA,IAAA,CAAK,mBAAA,CAAoB,SAAS,OAAO,CAAA;AAAA,IAC3C;AAAA,GACF;AACF;AAsBO,IAAM,WAAA,GAGT,CAAC,IAAA,EAAM,MAAA,KAAW;AACpB,EAAA,IAAI,OAAA;AACJ,EAAA,IAAI;AACF,IAAA,OAAA,GAAU,UAAA,EAAW;AAAA,EACvB,CAAA,CAAA,MAAQ;AACN,IAAA,MAAA,CAAO,OAAO,MAAM;AAAA,IAAC,CAAC,CAAA;AACtB,IAAA,OAAO,EAAC;AAAA,EACV;AAEA,EAAA,MAAM,GAAA,GAAM,OAAA,CAAQ,UAAA,CAAW,MAAA,CAAO,IAAI,CAAA;AAC1C,EAAA,MAAA,CAAO,OAAO,MAAM,GAAA,CAAI,EAAE,MAAA,EAAQ,IAAA,EAAM,CAAC,CAAA;AAEzC,EAAA,OAAO;AAAA,IACL,OAAA,GAAU;AAAA,IAEV;AAAA,GACF;AACF;;;AC/EO,SAAS,SAAS,IAAA,EAAyB;AAChD,EAAA,UAAA,EAAW,CAAE,QAAQ,IAAI,CAAA;AAC3B;AASO,SAAS,SAAA,GAAkB;AAChC,EAAA,UAAA,GAAa,SAAA,EAAU;AACzB","file":"index.js","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// @watchupltd/svelte  ·  context helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport { getContext, setContext } from 'svelte';\nimport type { Watchup }          from '@watchupltd/browser';\n\nconst KEY = Symbol('watchup');\n\n/** Called internally by WatchupProvider. */\nexport function _setWatchupContext(instance: Watchup): void {\n  setContext(KEY, instance);\n}\n\n/**\n * Returns the `Watchup` instance from the nearest `<WatchupProvider>`.\n * Call this at component initialisation time (not inside event handlers).\n *\n * @example\n * <script>\n *   import { getWatchup } from '@watchupltd/svelte';\n *   const watchup = getWatchup();\n * </script>\n * <button on:click={() => watchup.track('button.clicked')}>Click me</button>\n */\nexport function getWatchup(): Watchup {\n  const instance = getContext<Watchup | undefined>(KEY);\n  if (!instance) {\n    throw new Error(\n      '[watchup] getWatchup() must be called inside a component ' +\n      'that is a descendant of <WatchupProvider>.',\n    );\n  }\n  return instance;\n}\n","// ─────────────────────────────────────────────────────────────────────────────\n// @watchupltd/svelte  ·  Svelte actions\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { Action }  from 'svelte/action';\nimport type { Watchup } from '@watchupltd/browser';\nimport { getWatchup }  from './context.js';\n\ninterface TrackClickParams {\n  /** Event name sent to Watchup. */\n  event:       string;\n  /** Optional properties merged into the event payload. */\n  properties?: Record<string, unknown>;\n}\n\n/**\n * Svelte action that tracks a click event.\n *\n * @example\n * <script>\n *   import { trackClick } from '@watchupltd/svelte';\n * </script>\n * <button use:trackClick={{ event: 'cta.clicked', properties: { variant: 'A' } }}>\n *   Get started\n * </button>\n */\nexport const trackClick: Action<HTMLElement, TrackClickParams> = (\n  node,\n  params,\n) => {\n  let watchup: Watchup;\n  try {\n    watchup = getWatchup();\n  } catch {\n    // No provider in tree — silently no-op\n    return {};\n  }\n\n  const handler = () => {\n    watchup.track(params.event, params.properties);\n  };\n\n  node.addEventListener('click', handler);\n\n  return {\n    update(newParams) {\n      params = newParams;\n    },\n    destroy() {\n      node.removeEventListener('click', handler);\n    },\n  };\n};\n\n/**\n * Svelte action that traces the time between `mount` and when `done()` is\n * called, emitting a trace span.\n *\n * @example\n * <script>\n *   import { traceAction } from '@watchupltd/svelte';\n *\n *   let done: () => void;\n *\n *   async function load() {\n *     const data = await fetchData();\n *     done?.();\n *     return data;\n *   }\n * </script>\n * <div use:traceAction={{ span: 'dashboard load', onDone: (fn) => (done = fn) }}>\n *   ...\n * </div>\n */\nexport const traceAction: Action<\n  HTMLElement,\n  { span: string; onDone: (endFn: () => void) => void }\n> = (node, params) => {\n  let watchup: Watchup;\n  try {\n    watchup = getWatchup();\n  } catch {\n    params.onDone(() => {});\n    return {};\n  }\n\n  const end = watchup.startTrace(params.span);\n  params.onDone(() => end({ status: 'ok' }));\n\n  return {\n    destroy() {\n      // If destroyed before done() was called, mark as cancelled\n    },\n  };\n};\n","// ─────────────────────────────────────────────────────────────────────────────\n// @watchupltd/svelte  ·  user identification helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { WatchupUser } from '@watchupltd/browser';\nimport { getWatchup } from './context.js';\n\n/**\n * Attach a user to all subsequent errors and traces.\n * Call this after login, inside a Svelte component or store subscription.\n *\n * @example\n * import { identify } from '@watchupltd/svelte';\n * identify({ id: $user.id, email: $user.email, name: $user.name });\n */\nexport function identify(user: WatchupUser): void {\n  getWatchup().setUser(user);\n}\n\n/**\n * Remove the current user context (e.g. after logout).\n *\n * @example\n * import { clearUser } from '@watchupltd/svelte';\n * clearUser();\n */\nexport function clearUser(): void {\n  getWatchup().clearUser();\n}\n"]}

package/dist/index.mjs

@@ -1,4 +1,15 @@
 export { traceAction, trackClick } from './chunk-A275SBSC.mjs';
+import { getWatchup } from './chunk-JOD5F3DS.mjs';
 export { getWatchup } from './chunk-JOD5F3DS.mjs';
+
+// src/identify.ts
+function identify(user) {
+  getWatchup().setUser(user);
+}
+function clearUser() {
+  getWatchup().clearUser();
+}
+
+export { clearUser, identify };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs"}
+{"version":3,"sources":["../src/identify.ts"],"names":[],"mappings":";;;;;AAeO,SAAS,SAAS,IAAA,EAAyB;AAChD,EAAA,UAAA,EAAW,CAAE,QAAQ,IAAI,CAAA;AAC3B;AASO,SAAS,SAAA,GAAkB;AAChC,EAAA,UAAA,GAAa,SAAA,EAAU;AACzB","file":"index.mjs","sourcesContent":["// ─────────────────────────────────────────────────────────────────────────────\n// @watchupltd/svelte  ·  user identification helpers\n// ─────────────────────────────────────────────────────────────────────────────\n\nimport type { WatchupUser } from '@watchupltd/browser';\nimport { getWatchup } from './context.js';\n\n/**\n * Attach a user to all subsequent errors and traces.\n * Call this after login, inside a Svelte component or store subscription.\n *\n * @example\n * import { identify } from '@watchupltd/svelte';\n * identify({ id: $user.id, email: $user.email, name: $user.name });\n */\nexport function identify(user: WatchupUser): void {\n  getWatchup().setUser(user);\n}\n\n/**\n * Remove the current user context (e.g. after logout).\n *\n * @example\n * import { clearUser } from '@watchupltd/svelte';\n * clearUser();\n */\nexport function clearUser(): void {\n  getWatchup().clearUser();\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@watchupltd/svelte",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Official Watchup SDK for Svelte / SvelteKit — provider, context, and actions",
   "license": "MIT",
   "author": "Watchup Ltd",
@@ -9,18 +9,24 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types":   "./dist/index.d.ts",
-      "import":  "./dist/index.mjs",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
       "require": "./dist/index.js"
     },
     "./WatchupProvider.svelte": "./src/WatchupProvider.svelte"
   },
-  "files": ["dist", "src/WatchupProvider.svelte", "README.md"],
-  "sideEffects": ["./src/WatchupProvider.svelte"],
+  "files": [
+    "dist",
+    "src/WatchupProvider.svelte",
+    "README.md"
+  ],
+  "sideEffects": [
+    "./src/WatchupProvider.svelte"
+  ],
   "scripts": {
-    "build":     "tsup",
+    "build": "tsup",
     "typecheck": "tsc --noEmit",
-    "dev":       "tsup --watch"
+    "dev": "tsup --watch"
   },
   "peerDependencies": {
     "@watchupltd/browser": "^0.1.0",
@@ -28,8 +34,8 @@
   },
   "devDependencies": {
     "@watchupltd/browser": "*",
-    "svelte":              "^4.2.18",
-    "tsup":                "^8.0.2",
-    "typescript":          "^5.4.5"
+    "svelte": "^4.2.18",
+    "tsup": "^8.0.2",
+    "typescript": "^5.4.5"
   }
 }