feat(config): js catcher options support

README.md

@@ -35,6 +35,34 @@ export default defineNuxtConfig({
 })
 ```
 
+## Passing additional options
+
+You can pass `user`, `context`, `beforeSend` and other [JS Catcher options](https://github.com/codex-team/hawk.javascript?tab=readme-ov-file#usage) via `catcherOptions` config property.
+
+```ts
+export default defineNuxtConfig({
+  modules: [
+    '@hawk.so/nuxt'
+  ],
+
+  hawk: {
+    token: process.env.HAWK_TOKEN,
+    catcherOptions: {
+      context: {
+        // any data you want to send with all events
+        appName: 'Hawk Nuxt Playground',
+      },
+      // method for filtering/modifying an event to be sent
+      beforeSend: (event) => {
+        event.context.appVersion = '1.0.0'
+
+        return event
+      },
+    },
+  },
+})
+```
+
 ## Contribution
 
 <details>

package.json

@@ -30,7 +30,7 @@
   },
   "dependencies": {
     "@hawk.so/javascript": "^3.0.2",
-    "@hawk.so/vite-plugin": "^1.0.3",
+    "@hawk.so/vite-plugin": "^1.0.4",
     "@nuxt/kit": "^3.13.2"
   },
   "devDependencies": {

playground/nuxt.config.ts

@@ -1,7 +1,20 @@
 export default defineNuxtConfig({
   modules: ['../src/module'],
+
   hawk: {
     token: process.env.HAWK_TOKEN,
+    catcherOptions: {
+      context: {
+        appName: 'Hawk Nuxt Playground',
+      },
+      beforeSend: (event) => {
+        event.context.appVersion = '1.0.0'
+
+        return event
+      },
+    },
   },
+
   devtools: { enabled: true },
+  compatibilityDate: '2024-10-07',
 })

src/module.ts

@@ -1,4 +1,4 @@
-import { defineNuxtModule, addPlugin, createResolver, updateRuntimeConfig, useRuntimeConfig, addImportsDir } from '@nuxt/kit'
+import { defineNuxtModule, addPlugin, createResolver, updateRuntimeConfig, useRuntimeConfig, addImportsDir, addTemplate } from '@nuxt/kit'
 import hawkVitePlugin from '@hawk.so/vite-plugin'
 import type { HawkModuleConfig } from './types'
 
@@ -12,6 +12,23 @@ export default defineNuxtModule<HawkModuleConfig>({
     const resolver = createResolver(import.meta.url)
     const runtimeConfig = useRuntimeConfig()
 
+    /**
+     * Since we can't pass functions via the nuxt.config.js, we need to create a template
+     * @see https://nuxt.com/docs/guide/going-further/runtime-config#serialization
+     * @see https://nuxt.com/docs/guide/going-further/modules#adding-templatesvirtual-files
+     */
+    addTemplate({
+      filename: 'hawk-before-send.mjs',
+      getContents: () => {
+        if (config.catcherOptions?.beforeSend) {
+          return `export default ${config.catcherOptions.beforeSend.toString()}`
+        }
+        else {
+          return `export default (event) => event`
+        }
+      },
+    })
+
     /**
      * Add runtimeConfig.public.hawk
      */

src/runtime/plugin.client.ts

@@ -1,5 +1,6 @@
 import HawkCatcher from '@hawk.so/javascript'
 import type { HawkModuleConfig } from '../types'
+import beforeSend from '#build/hawk-before-send.mjs'
 import { defineNuxtPlugin, useRuntimeConfig } from '#app'
 
 /**
@@ -30,11 +31,13 @@ export default defineNuxtPlugin((nuxtApp) => {
   const runtimeConfig = useRuntimeConfig()
   const hawkConfig = runtimeConfig.public.hawk as HawkModuleConfig
 
-  const hawkInstance = new HawkCatcher({
+  const hawkInstance = new HawkCatcher(Object.assign({}, hawkConfig.catcherOptions, {
     token: hawkConfig.token,
     vue: nuxtApp.vueApp,
     release: getReleaseId(),
-  })
+  }, {
+    beforeSend,
+  }))
 
   /**
    * @todo use NuxtApp to extract useful information:

src/types.ts

@@ -1,3 +1,5 @@
+import type { HawkInitialSettings } from '@hawk.so/javascript'
+
 /**
  * Nuxt module configuration
  */
@@ -6,4 +8,10 @@ export interface HawkModuleConfig {
    * Hawk Integration token
    */
   token: string
+
+  /**
+   * Any additional options supported by Hawk JavaScript Catcher
+   * @see https://github.com/codex-team/hawk.javascript?tab=readme-ov-file#usage
+   */
+  catcherOptions?: Omit<HawkInitialSettings, 'token' | 'vue' | 'release'>
 }