@solomei-ai/intent 1.9.3 → 1.11.0

package/dist/types/index.d.ts

@@ -6,13 +6,66 @@ type InitOptions = {
     geo?: boolean;
     sidMaxAgeSeconds?: number;
     debug?: boolean;
+    /**
+     * @internal - For development/debugging only. Only available in debug builds.
+     * Use `@solomei-ai/intent/debug` or `intent.debug.umd.min.js` to access this feature.
+     */
+    debugPanel?: boolean;
 };
-declare function setFlag(name: string, yes: boolean | undefined | string): void;
+/**
+ * Valid flag names for the Intent SDK
+ */
+type FlagName = 'intent:consent' | 'intent:geo' | 'intent:debug';
+/**
+ * Generic flag setter - prefer using specific functions like setConsent(), setGeo(), setDebug()
+ * @param name - The flag name to set
+ * @param yes - Boolean value to enable (true) or disable (false). Undefined will skip setting.
+ * @deprecated This entire function will be removed in v2.0.0 (February 2026 - 2 months).
+ *             Migrate to type-safe functions: setConsent(), setGeo(), or setDebug().
+ *             See migration guide in README for details.
+ */
+declare function setFlag(name: FlagName | string, yes: boolean | undefined | string): void;
+/**
+ * Set consent flag - controls whether the SDK tracks user activity
+ * @param granted - true to grant consent, false to revoke consent
+ */
+declare function setConsent(granted: boolean): void;
+/**
+ * Set geolocation flag - controls whether the SDK captures device location
+ * @param enabled - true to enable geolocation, false to disable
+ */
+declare function setGeo(enabled: boolean): void;
+/**
+ * Set debug flag - controls whether the SDK outputs debug logs
+ * @param enabled - true to enable debug logging, false to disable
+ */
+declare function setDebug(enabled: boolean): void;
+/**
+ * Toggle debug panel - controls whether the debug panel UI is shown
+ *
+ * **⚠️ WARNING: Only available in debug builds**
+ *
+ * This function is only available when using debug build variants:
+ * - ESM: `@solomei-ai/intent/debug` → `dist/esm/index.debug.js`
+ * - UMD: `intent.debug.umd.min.js`
+ *
+ * The debug panel exposes internal SDK behavior including:
+ * - Screenshots of user interactions
+ * - Event payloads and metadata
+ * - HTML content and element information
+ *
+ * **Production builds do not include this functionality.**
+ * Attempting to use this in production builds will result in a warning and no-op.
+ *
+ * @internal
+ * @param enabled - true to show debug panel, false to hide
+ */
+declare function setDebugPanel(enabled: boolean): void;
 declare function initIntent(opts?: InitOptions): void;
 declare function getIntentSessionId(): string | undefined;
 declare function ensureIntentSessionId(): void;
 declare function clearIntentSessionId(): void;
 declare function setIntentSessionMaxAge(seconds: number): void;
 
-export { clearIntentSessionId, ensureIntentSessionId, getIntentSessionId, initIntent, setFlag, setIntentSessionMaxAge };
-export type { InitOptions };
+export { clearIntentSessionId, ensureIntentSessionId, getIntentSessionId, initIntent, setConsent, setDebug, setDebugPanel, setFlag, setGeo, setIntentSessionMaxAge };
+export type { FlagName, InitOptions };

package/package.json

@@ -1,51 +1,67 @@
 {
   "name": "@solomei-ai/intent",
-  "version": "1.9.3",
+  "version": "1.11.0",
   "description": "Lightweight browser SDK for intent events (client-only).",
   "type": "module",
   "module": "dist/esm/index.js",
+  "browser": "dist/intent.umd.min.js",
   "types": "dist/types/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/types/index.d.ts",
       "import": "./dist/esm/index.js",
       "default": "./dist/esm/index.js"
+    },
+    "./debug": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.debug.js",
+      "default": "./dist/esm/index.debug.js"
     }
   },
   "unpkg": "dist/intent.umd.min.js",
   "jsdelivr": "dist/intent.umd.min.js",
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "LICENSE"
   ],
   "sideEffects": false,
+  "engines": {
+    "node": ">=24.0.0 <25.0.0"
+  },
   "scripts": {
     "build": "rollup -c",
+    "build:debug": "rollup -c rollup.config.debug.js",
     "build:dev": "rollup -c rollup.config.dev.js",
+    "build:all": "npm run build && npm run build:debug",
     "dev": "rollup -c -w",
     "clean": "rm -rf dist",
     "test": "vitest run",
-    "test:watch": "vitest"
+    "test:watch": "vitest",
+    "test:browser": "vitest run --config vitest.browser.config.ts"
   },
   "dependencies": {
-    "html2canvas-pro": "^1.5.13",
+    "html2canvas-pro": "^1.6.3",
     "js-cookie": "3.0.5"
   },
   "devDependencies": {
     "@babel/preset-env": "^7.28.5",
     "@rollup/plugin-babel": "^6.1.0",
-    "@rollup/plugin-commonjs": "^29.0.0",
     "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-replace": "^6.0.3",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^12.3.0",
     "@tsconfig/recommended": "^1.0.13",
     "@types/js-cookie": "^3.0.6",
-    "@vitest/ui": "^4.0.15",
+    "@vitest/browser-playwright": "^4.0.16",
+    "@vitest/coverage-v8": "^4.0.16",
+    "@vitest/ui": "^4.0.16",
     "eslint-config-xo-typescript": "^9.0.0",
     "happy-dom": "^20.0.11",
-    "rollup": "^4.53.3",
+    "rollup": "^4.54.0",
     "rollup-plugin-dts": "^6.3.0",
     "rollup-plugin-obfuscator": "^1.1.0",
     "typescript": "^5.9.3",
-    "vitest": "^4.0.15"
+    "vitest": "^4.0.16"
   }
 }