@sessionvision/core 0.2.0

package/dist/vue/utils/dom.d.ts

@@ -0,0 +1,51 @@
+/**
+ * DOM utility functions for element inspection and event handling
+ */
+/**
+ * Get the visible text content of an element, truncated to maxLength
+ */
+export declare function getElementText(element: Element, maxLength?: number): string;
+/**
+ * Get CSS classes of an element as a space-separated string
+ */
+export declare function getElementClasses(element: Element): string;
+/**
+ * Get the tag name of an element in lowercase
+ */
+export declare function getElementTag(element: Element): string;
+/**
+ * Get the ID of an element, or null if not present
+ */
+export declare function getElementId(element: Element): string | null;
+/**
+ * Get the href attribute for anchor elements
+ */
+export declare function getElementHref(element: Element): string | null;
+/**
+ * Check if an element should be ignored for tracking
+ */
+export declare function shouldIgnoreElement(element: Element): boolean;
+/**
+ * Check if an element is interactive (clickable, input, etc.)
+ */
+export declare function isInteractiveElement(element: Element): boolean;
+/**
+ * Get the closest interactive parent element
+ */
+export declare function getInteractiveParent(element: Element): Element | null;
+/**
+ * Safe document ready check
+ */
+export declare function onDocumentReady(callback: () => void): void;
+/**
+ * Get the current page URL
+ */
+export declare function getCurrentUrl(): string;
+/**
+ * Get the document referrer
+ */
+export declare function getReferrer(): string;
+/**
+ * Get the document title
+ */
+export declare function getDocumentTitle(): string;

package/dist/vue/utils/pii.d.ts

@@ -0,0 +1,26 @@
+/**
+ * PII (Personally Identifiable Information) detection utility
+ * Detects and masks sensitive data patterns in text
+ */
+/**
+ * Check if text contains PII
+ */
+export declare function containsPII(text: string): boolean;
+/**
+ * Mask PII in text
+ */
+export declare function maskPII(text: string): string;
+/**
+ * Detect which types of PII are present in text
+ */
+export declare function detectPIITypes(text: string): string[];
+/**
+ * Check if a string looks like a password field value
+ * (all masked characters or very short alphanumeric)
+ */
+export declare function looksLikePassword(value: string): boolean;
+/**
+ * Safely mask a value that might be sensitive
+ * Returns masked version if PII detected, original otherwise
+ */
+export declare function safeMaskValue(value: string, alwaysMask?: boolean): string;

package/dist/vue/utils/selector.d.ts

@@ -0,0 +1,12 @@
+/**
+ * CSS Selector generation utility
+ * Generates stable, unique selectors for DOM elements
+ */
+/**
+ * Generate a CSS selector for an element
+ * Priority:
+ * 1. data-sessionvision-id attribute
+ * 2. ID attribute (if unique)
+ * 3. Path-based selector with classes
+ */
+export declare function generateSelector(element: Element): string;

package/dist/vue/utils/storage.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Storage utility for localStorage and sessionStorage operations
+ * Provides safe access with error handling for environments where storage is unavailable
+ */
+/**
+ * Check if localStorage is available
+ */
+export declare function isLocalStorageAvailable(): boolean;
+/**
+ * Check if sessionStorage is available
+ */
+export declare function isSessionStorageAvailable(): boolean;
+/**
+ * Get a value from localStorage
+ */
+export declare function getLocalStorage<T>(key: string): T | null;
+/**
+ * Set a value in localStorage
+ */
+export declare function setLocalStorage<T>(key: string, value: T): boolean;
+/**
+ * Remove a value from localStorage
+ */
+export declare function removeLocalStorage(key: string): boolean;
+/**
+ * Get a value from sessionStorage
+ */
+export declare function getSessionStorage<T>(key: string): T | null;
+/**
+ * Set a value in sessionStorage
+ */
+export declare function setSessionStorage<T>(key: string, value: T): boolean;
+/**
+ * Remove a value from sessionStorage
+ */
+export declare function removeSessionStorage(key: string): boolean;
+/**
+ * Get a raw string value from localStorage (without JSON parsing)
+ */
+export declare function getLocalStorageRaw(key: string): string | null;
+/**
+ * Set a raw string value in localStorage (without JSON stringifying)
+ */
+export declare function setLocalStorageRaw(key: string, value: string): boolean;

package/dist/vue/utils/uuid.d.ts

@@ -0,0 +1,13 @@
+/**
+ * UUID v4 generation utility
+ * Generates cryptographically random UUIDs when available, falls back to Math.random
+ */
+/**
+ * Generate a UUID v4 string
+ * Uses crypto.randomUUID() when available, falls back to manual generation
+ */
+export declare function generateUUID(): string;
+/**
+ * Validate a UUID string format
+ */
+export declare function isValidUUID(uuid: string): boolean;

package/dist/vue/vue/composables.d.ts

@@ -0,0 +1,4 @@
+import type { EventProperties, SessionVisionAPI, UserTraits } from '../types';
+export declare function useSessionVision(): SessionVisionAPI;
+export declare function useCapture(): (eventName: string, properties?: EventProperties) => void;
+export declare function useIdentify(): (userId: string, traits?: UserTraits) => void;

package/dist/vue/vue/index.d.ts

@@ -0,0 +1,2 @@
+export { createSessionVision } from './plugin';
+export { useSessionVision, useCapture, useIdentify } from './composables';

package/dist/vue/vue/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { InjectionKey, Plugin } from 'vue';
+import type { SessionVisionAPI, SessionVisionConfig } from '../types';
+export declare const sessionVisionKey: InjectionKey<SessionVisionAPI>;
+export declare function createSessionVision(apiKey: string, options?: Omit<SessionVisionConfig, 'apiHost'>): Plugin;

package/package.json

@@ -0,0 +1,109 @@
+{
+  "name": "@sessionvision/core",
+  "version": "0.2.0",
+  "description": "Session Vision client-side tracking library",
+  "type": "module",
+  "main": "dist/sessionvision.cjs.js",
+  "module": "dist/sessionvision.esm.js",
+  "types": "dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/sessionvision.esm.js",
+      "require": "./dist/sessionvision.cjs.js",
+      "types": "./dist/types/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.esm.js",
+      "require": "./dist/react/index.cjs.js",
+      "types": "./dist/react/index.d.ts"
+    },
+    "./vue": {
+      "import": "./dist/vue/index.esm.js",
+      "require": "./dist/vue/index.cjs.js",
+      "types": "./dist/vue/index.d.ts"
+    },
+    "./stub": {
+      "import": "./dist/stub-template.ts",
+      "types": "./dist/stub-template.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "rollup -c && node scripts/generate-stub-export.js",
+    "build:watch": "rollup -c -w",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "test:e2e": "playwright test",
+    "test:e2e:ui": "playwright test --ui",
+    "test:e2e:headed": "playwright test --headed",
+    "test:e2e:debug": "playwright test --debug",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write 'src/**/*.ts'",
+    "format:check": "prettier --check 'src/**/*.ts'",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "session-recording",
+    "product-analytics"
+  ],
+  "author": "Session Vision",
+  "license": "MIT",
+  "devDependencies": {
+    "@testing-library/jest-dom": "^6.5.0",
+    "@testing-library/react": "^16.0.1",
+    "@testing-library/user-event": "^14.5.2",
+    "@eslint/js": "^9.18.0",
+    "@playwright/test": "^1.41.0",
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-replace": "^5.0.5",
+    "@rollup/plugin-terser": "^0.4.4",
+    "@rollup/plugin-typescript": "^11.1.6",
+    "@types/jest": "^29.5.12",
+    "@types/react": "^18.3.12",
+    "@types/react-dom": "^18.3.0",
+    "@vue/test-utils": "^2.4.6",
+    "eslint": "^9.18.0",
+    "eslint-config-prettier": "^10.0.1",
+    "jest": "^29.7.0",
+    "jest-environment-jsdom": "^29.7.0",
+    "prettier": "^3.4.2",
+    "rollup": "^4.9.6",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "ts-jest": "^29.1.2",
+    "tslib": "^2.6.2",
+    "typescript": "^5.3.3",
+    "typescript-eslint": "^8.21.0",
+    "vue": "^3.5.12"
+  },
+  "peerDependencies": {
+    "react": ">=17.0.0",
+    "vue": ">=3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "vue": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "browserslist": [
+    "last 2 Chrome versions",
+    "last 2 Firefox versions",
+    "last 2 Safari versions",
+    "last 2 Edge versions"
+  ]
+}