@nurdd/web-sdk 1.0.0

package/adapters/vue.js

@@ -0,0 +1,67 @@
+// Vue 3 adapter: a plugin + a composable. Vue is a peer dependency.
+import { inject, onBeforeUnmount, onMounted, watch, ref } from "vue";
+import { createSdk, getSdk, hasDefaultSdk, initSdk, setDefaultSdk } from "../src/sdk.js";
+
+const INJECTION_KEY = Symbol("nurdd-sdk");
+
+// app.use(NurddPlugin, { sdkKey, baseUrl })
+export const NurddPlugin = {
+    install(app, options) {
+        let sdk;
+        if (options?.sdk) sdk = options.sdk;
+        else if (hasDefaultSdk()) sdk = getSdk();
+        else if (options?.config || (options && options.sdkKey)) sdk = initSdk(options.config || options);
+        else throw new Error("[nurdd] NurddPlugin requires either { sdk } or a config with { sdkKey, baseUrl }");
+
+        sdk.init().catch(() => {});
+        app.provide(INJECTION_KEY, sdk);
+        app.config.globalProperties.$nurdd = sdk;
+    },
+};
+
+export function useNurdd() {
+    const sdk = inject(INJECTION_KEY, null);
+    if (sdk) return sdk;
+    if (hasDefaultSdk()) return getSdk();
+    throw new Error("[nurdd] useNurdd() called outside of an app where NurddPlugin was installed");
+}
+
+// Vue Router integration: pass `router.currentRoute` (a ref) to
+// automatically fire a `page_view` whenever the route changes.
+//
+//   import { useRoute } from 'vue-router'
+//   trackPageViews(useRoute())
+export function trackPageViews(routeRef) {
+    const sdk = useNurdd();
+    watch(routeRef, (to) => {
+        if (!to) return;
+        sdk.page(to.fullPath || to.path, {
+            name: to.name?.toString?.() || null,
+            params: to.params,
+            query: to.query,
+        });
+    }, { immediate: true });
+}
+
+export function useDeepLink(callback) {
+    const sdk = useNurdd();
+    let off = null;
+    onMounted(() => { off = sdk.onDeepLink((payload) => callback?.(payload)); });
+    onBeforeUnmount(() => { if (off) off(); off = null; });
+}
+
+export function useIdentity() {
+    const sdk = useNurdd();
+    const identity = ref(sdk.identity.current());
+    return {
+        identity,
+        async identify(externalUserId, traits) {
+            const r = await sdk.identify(externalUserId, traits);
+            identity.value = sdk.identity.current();
+            return r;
+        },
+        reset() { sdk.reset(); identity.value = null; },
+    };
+}
+
+export { createSdk, initSdk, getSdk, setDefaultSdk };