@hellyeah/x-ray 0.1.0-beta.5

package/dist/svelte/index.js

@@ -0,0 +1,77 @@
+// src/client/queue.ts
+var initQueue = () => {
+  if (typeof window !== "undefined") {
+    window._hy = window._hy || [];
+  }
+};
+
+// src/client/utils.ts
+var DEFAULT_HOST = "https://xray-staging.hellyeahai.com";
+var isBrowser = () => typeof window !== "undefined" && typeof document !== "undefined";
+var isDevelopment = () => typeof process !== "undefined" && process.env?.NODE_ENV === "development";
+var getDefaultHost = () => DEFAULT_HOST;
+
+// src/client/generic.ts
+var inject = (props) => {
+  if (!isBrowser())
+    return;
+  const { websiteId, domains, autoTrack = true, src } = props;
+  const hostUrl = props.hostUrl || getDefaultHost();
+  const scriptSrc = src || `${hostUrl}/script.js`;
+  if (document.head.querySelector(`script[src*="${scriptSrc}"]`))
+    return;
+  initQueue();
+  const dataset = {
+    websiteId,
+    hostUrl
+  };
+  if (domains)
+    dataset.domains = domains;
+  if (!autoTrack)
+    dataset.autoTrack = "false";
+  const script = document.createElement("script");
+  script.src = scriptSrc;
+  script.defer = true;
+  for (const [key, value] of Object.entries(dataset)) {
+    script.dataset[key] = value;
+  }
+  script.onerror = () => {
+    const msg = isDevelopment() ? "Please check if any ad blockers are enabled and try again." : "Check that the hostUrl is correct and the script is accessible.";
+    console.log(`[x-ray] Failed to load script from ${scriptSrc}. ${msg}`);
+  };
+  document.head.appendChild(script);
+};
+var track = (name, data) => {
+  if (!isBrowser())
+    return;
+  if (window.hy) {
+    window.hy.track(name, data);
+  } else {
+    initQueue();
+    window._hy = window._hy || [];
+    window._hy.push(["track", name, data]);
+  }
+};
+var identify = (id, data) => {
+  if (!isBrowser())
+    return;
+  if (window.hy) {
+    window.hy.identify(id, data);
+  } else {
+    initQueue();
+    window._hy = window._hy || [];
+    window._hy.push(["identify", id, data]);
+  }
+};
+var pageview = () => {
+  track();
+};
+
+// src/svelte/index.ts
+var injectAnalytics = (props) => inject(props);
+export {
+  track,
+  pageview,
+  injectAnalytics,
+  identify
+};

package/dist/vue/index.cjs

@@ -0,0 +1,136 @@
+var import_node_module = require("node:module");
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/vue/index.ts
+var exports_vue = {};
+__export(exports_vue, {
+  track: () => track,
+  pageview: () => pageview,
+  identify: () => identify,
+  Analytics: () => Analytics
+});
+module.exports = __toCommonJS(exports_vue);
+var import_vue = require("vue");
+
+// src/client/queue.ts
+var initQueue = () => {
+  if (typeof window !== "undefined") {
+    window._hy = window._hy || [];
+  }
+};
+
+// src/client/utils.ts
+var DEFAULT_HOST = "https://xray-staging.hellyeahai.com";
+var isBrowser = () => typeof window !== "undefined" && typeof document !== "undefined";
+var isDevelopment = () => typeof process !== "undefined" && process.env?.NODE_ENV === "development";
+var getDefaultHost = () => DEFAULT_HOST;
+
+// src/client/generic.ts
+var inject = (props) => {
+  if (!isBrowser())
+    return;
+  const { websiteId, domains, autoTrack = true, src } = props;
+  const hostUrl = props.hostUrl || getDefaultHost();
+  const scriptSrc = src || `${hostUrl}/script.js`;
+  if (document.head.querySelector(`script[src*="${scriptSrc}"]`))
+    return;
+  initQueue();
+  const dataset = {
+    websiteId,
+    hostUrl
+  };
+  if (domains)
+    dataset.domains = domains;
+  if (!autoTrack)
+    dataset.autoTrack = "false";
+  const script = document.createElement("script");
+  script.src = scriptSrc;
+  script.defer = true;
+  for (const [key, value] of Object.entries(dataset)) {
+    script.dataset[key] = value;
+  }
+  script.onerror = () => {
+    const msg = isDevelopment() ? "Please check if any ad blockers are enabled and try again." : "Check that the hostUrl is correct and the script is accessible.";
+    console.log(`[x-ray] Failed to load script from ${scriptSrc}. ${msg}`);
+  };
+  document.head.appendChild(script);
+};
+var track = (name, data) => {
+  if (!isBrowser())
+    return;
+  if (window.hy) {
+    window.hy.track(name, data);
+  } else {
+    initQueue();
+    window._hy = window._hy || [];
+    window._hy.push(["track", name, data]);
+  }
+};
+var identify = (id, data) => {
+  if (!isBrowser())
+    return;
+  if (window.hy) {
+    window.hy.identify(id, data);
+  } else {
+    initQueue();
+    window._hy = window._hy || [];
+    window._hy.push(["identify", id, data]);
+  }
+};
+var pageview = () => {
+  track();
+};
+
+// src/vue/index.ts
+var Analytics = import_vue.defineComponent({
+  name: "Analytics",
+  props: {
+    websiteId: { type: String, required: true },
+    hostUrl: String,
+    domains: String,
+    autoTrack: { type: Boolean, default: true },
+    src: String
+  },
+  setup(props) {
+    import_vue.onMounted(() => {
+      inject(props);
+    });
+  },
+  render: () => null
+});

package/dist/vue/index.d.cts

@@ -0,0 +1,32 @@
+import { DefineComponent } from "vue";
+/** Props accepted by the `<Analytics />` component and `inject()`. */
+type AnalyticsProps = {
+	/** Your x-ray website ID. */
+	websiteId: string;
+	/** Base URL of your x-ray server. @defaultValue `"https://xray-staging.hellyeahai.com"` */
+	hostUrl?: string;
+	/** Restrict tracking to this domain only. */
+	domains?: string;
+	/** Auto-track events on `data-hy-event` elements. @defaultValue true */
+	autoTrack?: boolean;
+	/** Custom `src` for the tracker script (overrides the default `/script.js`). */
+	src?: string;
+};
+/** Arbitrary event data passed to `track()`. */
+type EventData = Record<string, string | number | boolean | null>;
+/**
+* Track a custom event. If the tracker script hasn't loaded yet, the call is
+* buffered in `window._hy` and replayed once it initialises.
+*/
+declare const track: (name?: string, data?: EventData) => void;
+/**
+* Identify the current user. Buffered if the tracker script hasn't loaded yet.
+*/
+declare const identify: (id: string, data?: EventData) => void;
+/**
+* Record a pageview. Equivalent to calling `track()` with no arguments — the
+* remote tracker interprets this as a pageview event.
+*/
+declare const pageview: () => void;
+declare const Analytics: DefineComponent<AnalyticsProps>;
+export { track, pageview, identify, AnalyticsProps, Analytics };

package/dist/vue/index.d.ts

@@ -0,0 +1,32 @@
+import { DefineComponent } from "vue";
+/** Props accepted by the `<Analytics />` component and `inject()`. */
+type AnalyticsProps = {
+	/** Your x-ray website ID. */
+	websiteId: string;
+	/** Base URL of your x-ray server. @defaultValue `"https://xray-staging.hellyeahai.com"` */
+	hostUrl?: string;
+	/** Restrict tracking to this domain only. */
+	domains?: string;
+	/** Auto-track events on `data-hy-event` elements. @defaultValue true */
+	autoTrack?: boolean;
+	/** Custom `src` for the tracker script (overrides the default `/script.js`). */
+	src?: string;
+};
+/** Arbitrary event data passed to `track()`. */
+type EventData = Record<string, string | number | boolean | null>;
+/**
+* Track a custom event. If the tracker script hasn't loaded yet, the call is
+* buffered in `window._hy` and replayed once it initialises.
+*/
+declare const track: (name?: string, data?: EventData) => void;
+/**
+* Identify the current user. Buffered if the tracker script hasn't loaded yet.
+*/
+declare const identify: (id: string, data?: EventData) => void;
+/**
+* Record a pageview. Equivalent to calling `track()` with no arguments — the
+* remote tracker interprets this as a pageview event.
+*/
+declare const pageview: () => void;
+declare const Analytics: DefineComponent<AnalyticsProps>;
+export { track, pageview, identify, AnalyticsProps, Analytics };

package/dist/vue/index.js

@@ -0,0 +1,95 @@
+// src/vue/index.ts
+import { defineComponent, onMounted } from "vue";
+
+// src/client/queue.ts
+var initQueue = () => {
+  if (typeof window !== "undefined") {
+    window._hy = window._hy || [];
+  }
+};
+
+// src/client/utils.ts
+var DEFAULT_HOST = "https://xray-staging.hellyeahai.com";
+var isBrowser = () => typeof window !== "undefined" && typeof document !== "undefined";
+var isDevelopment = () => typeof process !== "undefined" && process.env?.NODE_ENV === "development";
+var getDefaultHost = () => DEFAULT_HOST;
+
+// src/client/generic.ts
+var inject = (props) => {
+  if (!isBrowser())
+    return;
+  const { websiteId, domains, autoTrack = true, src } = props;
+  const hostUrl = props.hostUrl || getDefaultHost();
+  const scriptSrc = src || `${hostUrl}/script.js`;
+  if (document.head.querySelector(`script[src*="${scriptSrc}"]`))
+    return;
+  initQueue();
+  const dataset = {
+    websiteId,
+    hostUrl
+  };
+  if (domains)
+    dataset.domains = domains;
+  if (!autoTrack)
+    dataset.autoTrack = "false";
+  const script = document.createElement("script");
+  script.src = scriptSrc;
+  script.defer = true;
+  for (const [key, value] of Object.entries(dataset)) {
+    script.dataset[key] = value;
+  }
+  script.onerror = () => {
+    const msg = isDevelopment() ? "Please check if any ad blockers are enabled and try again." : "Check that the hostUrl is correct and the script is accessible.";
+    console.log(`[x-ray] Failed to load script from ${scriptSrc}. ${msg}`);
+  };
+  document.head.appendChild(script);
+};
+var track = (name, data) => {
+  if (!isBrowser())
+    return;
+  if (window.hy) {
+    window.hy.track(name, data);
+  } else {
+    initQueue();
+    window._hy = window._hy || [];
+    window._hy.push(["track", name, data]);
+  }
+};
+var identify = (id, data) => {
+  if (!isBrowser())
+    return;
+  if (window.hy) {
+    window.hy.identify(id, data);
+  } else {
+    initQueue();
+    window._hy = window._hy || [];
+    window._hy.push(["identify", id, data]);
+  }
+};
+var pageview = () => {
+  track();
+};
+
+// src/vue/index.ts
+var Analytics = defineComponent({
+  name: "Analytics",
+  props: {
+    websiteId: { type: String, required: true },
+    hostUrl: String,
+    domains: String,
+    autoTrack: { type: Boolean, default: true },
+    src: String
+  },
+  setup(props) {
+    onMounted(() => {
+      inject(props);
+    });
+  },
+  render: () => null
+});
+export {
+  track,
+  pageview,
+  identify,
+  Analytics
+};

package/package.json

@@ -0,0 +1,255 @@
+{
+  "name": "@hellyeah/x-ray",
+  "version": "0.1.0-beta.5",
+  "description": "Multi-platform analytics SDK for browser, React, Next.js, Remix, Vue, Svelte, Nuxt, Astro, and server environments",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/finalroundai/xray-sdk.git",
+    "directory": "packages/sdk"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "react",
+    "nextjs",
+    "remix",
+    "vue",
+    "svelte",
+    "sveltekit",
+    "nuxt",
+    "astro",
+    "server",
+    "xray"
+  ],
+  "sideEffects": false,
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "module-sync": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./react": {
+      "module-sync": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      },
+      "import": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      },
+      "require": {
+        "types": "./dist/react/index.d.cts",
+        "default": "./dist/react/index.cjs"
+      }
+    },
+    "./next": {
+      "module-sync": {
+        "types": "./dist/next/index.d.ts",
+        "default": "./dist/next/index.js"
+      },
+      "import": {
+        "types": "./dist/next/index.d.ts",
+        "default": "./dist/next/index.js"
+      },
+      "require": {
+        "types": "./dist/next/index.d.cts",
+        "default": "./dist/next/index.cjs"
+      }
+    },
+    "./server": {
+      "module-sync": {
+        "types": "./dist/server/index.d.ts",
+        "default": "./dist/server/index.js"
+      },
+      "import": {
+        "types": "./dist/server/index.d.ts",
+        "default": "./dist/server/index.js"
+      },
+      "require": {
+        "types": "./dist/server/index.d.cts",
+        "default": "./dist/server/index.cjs"
+      }
+    },
+    "./remix": {
+      "module-sync": {
+        "types": "./dist/remix/index.d.ts",
+        "default": "./dist/remix/index.js"
+      },
+      "import": {
+        "types": "./dist/remix/index.d.ts",
+        "default": "./dist/remix/index.js"
+      },
+      "require": {
+        "types": "./dist/remix/index.d.cts",
+        "default": "./dist/remix/index.cjs"
+      }
+    },
+    "./vue": {
+      "module-sync": {
+        "types": "./dist/vue/index.d.ts",
+        "default": "./dist/vue/index.js"
+      },
+      "import": {
+        "types": "./dist/vue/index.d.ts",
+        "default": "./dist/vue/index.js"
+      },
+      "require": {
+        "types": "./dist/vue/index.d.cts",
+        "default": "./dist/vue/index.cjs"
+      }
+    },
+    "./svelte": {
+      "module-sync": {
+        "types": "./dist/svelte/index.d.ts",
+        "default": "./dist/svelte/index.js"
+      },
+      "import": {
+        "types": "./dist/svelte/index.d.ts",
+        "default": "./dist/svelte/index.js"
+      },
+      "require": {
+        "types": "./dist/svelte/index.d.cts",
+        "default": "./dist/svelte/index.cjs"
+      }
+    },
+    "./nuxt": {
+      "module-sync": {
+        "types": "./dist/nuxt/index.d.ts",
+        "default": "./dist/nuxt/index.js"
+      },
+      "import": {
+        "types": "./dist/nuxt/index.d.ts",
+        "default": "./dist/nuxt/index.js"
+      },
+      "require": {
+        "types": "./dist/nuxt/index.d.cts",
+        "default": "./dist/nuxt/index.cjs"
+      }
+    },
+    "./astro": {
+      "module-sync": {
+        "types": "./dist/astro/index.d.ts",
+        "default": "./dist/astro/index.js"
+      },
+      "import": {
+        "types": "./dist/astro/index.d.ts",
+        "default": "./dist/astro/index.js"
+      },
+      "require": {
+        "types": "./dist/astro/index.d.cts",
+        "default": "./dist/astro/index.cjs"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "typesVersions": {
+    "*": {
+      "*": [
+        "dist/index.d.ts"
+      ],
+      "react": [
+        "dist/react/index.d.ts"
+      ],
+      "next": [
+        "dist/next/index.d.ts"
+      ],
+      "server": [
+        "dist/server/index.d.ts"
+      ],
+      "remix": [
+        "dist/remix/index.d.ts"
+      ],
+      "vue": [
+        "dist/vue/index.d.ts"
+      ],
+      "svelte": [
+        "dist/svelte/index.d.ts"
+      ],
+      "nuxt": [
+        "dist/nuxt/index.d.ts"
+      ],
+      "astro": [
+        "dist/astro/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "devDependencies": {
+    "@remix-run/react": "^2",
+    "@types/bun": "latest",
+    "@types/react": "^19",
+    "@types/react-dom": "^19.2.3",
+    "bunup": "^0.16.31",
+    "happy-dom": "^20.8.4",
+    "next": "^15",
+    "react": "^19",
+    "react-dom": "^19.2.4",
+    "vue": "^3"
+  },
+  "peerDependencies": {
+    "typescript": "^5",
+    "react": "^18 || ^19",
+    "next": "^14 || ^15",
+    "@remix-run/react": "^2",
+    "vue": "^3",
+    "svelte": "^4 || ^5",
+    "nuxt": "^3",
+    "astro": "^4 || ^5"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "next": {
+      "optional": true
+    },
+    "@remix-run/react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    },
+    "svelte": {
+      "optional": true
+    },
+    "nuxt": {
+      "optional": true
+    },
+    "astro": {
+      "optional": true
+    },
+    "typescript": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "prepublishOnly": "bun run typecheck && bun run test && bun run build",
+    "build": "NODE_ENV=production bunup",
+    "typecheck": "tsc --noEmit",
+    "test": "bun test",
+    "test:local": "bun run build && npm pack",
+    "release": "bun run build && npm publish --provenance"
+  }
+}