pishoniq-tracker 0.0.0-stage → 2.0.0

package/dist/index.d.ts

@@ -0,0 +1,50 @@
+interface AutoCaptureOptions {
+    clicks?: boolean;
+    pageViews?: boolean;
+    scrollDepth?: boolean;
+    sessions?: boolean;
+}
+interface InitOptions {
+    apiKey: string;
+    /** Backend host to send events to, e.g. "https://analytics.example.com". Required — there is no default. */
+    host: string;
+    debug?: boolean;
+    /** Disable individual auto-captured event groups. Defaults to all enabled. */
+    autoCapture?: AutoCaptureOptions;
+    /** 0..1 — fraction of events to keep. Default 1 (no sampling). */
+    sampleRate?: number;
+    /** Flush interval in ms. Default 2000. Paused while tab is hidden. */
+    flushIntervalMs?: number;
+    /** Immediate flush threshold. Default 100. */
+    maxBatchSize?: number;
+    /** In-memory queue cap; oldest events dropped past it. Default 1000. */
+    maxQueueSize?: number;
+}
+interface EventPayload {
+    sessionId: string;
+    userId?: string;
+    event: string;
+    properties?: Record<string, unknown>;
+    timestamp: number;
+    url: string;
+    userAgent: string;
+    /** Payload version. Defaults to 1. Reserved for future breaking changes. */
+    schemaVersion?: number;
+}
+interface EventsBatchBody {
+    events: EventPayload[];
+}
+
+declare class PishonIQ {
+    static isInitialized(): boolean;
+    static init(options: InitOptions): void;
+    static track(event: string, properties?: Record<string, unknown>): void;
+    static identify(id: string, traits?: Record<string, unknown>): void;
+    static page(pageName?: string): void;
+    /** @internal Used by React integration to avoid duplicate page_view events */
+    static _setReactRouterActive(active: boolean): void;
+    /** @internal Reset SDK state (testing only) */
+    static _reset(): void;
+}
+
+export { type AutoCaptureOptions, type EventPayload, type EventsBatchBody, type InitOptions, PishonIQ, PishonIQ as default };

package/dist/index.js

@@ -0,0 +1,16 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var chunkPDDJOQBE_js = require('./chunk-PDDJOQBE.js');
+
+
+
+Object.defineProperty(exports, "PishonIQ", {
+  enumerable: true,
+  get: function () { return chunkPDDJOQBE_js.PishonIQ; }
+});
+Object.defineProperty(exports, "default", {
+  enumerable: true,
+  get: function () { return chunkPDDJOQBE_js.index_default; }
+});

package/dist/index.mjs

@@ -0,0 +1 @@
+export { PishonIQ, index_default as default } from './chunk-S3CPHTEK.mjs';

package/dist/react.d.mts

@@ -0,0 +1,30 @@
+import { AutoCaptureOptions, PishonIQ } from './index.mjs';
+import { ReactNode } from 'react';
+
+interface PishonIQProviderProps {
+    apiKey: string;
+    host: string;
+    debug?: boolean;
+    autoCapture?: AutoCaptureOptions;
+    sampleRate?: number;
+    children: ReactNode;
+}
+declare function PishonIQProvider({ apiKey, host, debug, autoCapture, sampleRate, children, }: PishonIQProviderProps): JSX.Element;
+/**
+ * Returns `track`/`identify`/`page` bound to the PishonIQ singleton.
+ *
+ * Route-change page views are NOT fired from here — they don't need a
+ * router dependency at all. `PishonIQProvider` patches `history.pushState`/
+ * `replaceState` once (see `src/tracker.ts`), and since React Router (and
+ * any other router built on the History API) calls those same native
+ * methods internally, navigations are already captured automatically,
+ * with or without react-router-dom installed. Call `page()` from this hook
+ * yourself only if you want to pass a custom page name.
+ */
+declare function usePishonIQ(): {
+    track: typeof PishonIQ.track;
+    identify: typeof PishonIQ.identify;
+    page: typeof PishonIQ.page;
+};
+
+export { PishonIQProvider, type PishonIQProviderProps, usePishonIQ };

package/dist/react.d.ts

@@ -0,0 +1,30 @@
+import { AutoCaptureOptions, PishonIQ } from './index.js';
+import { ReactNode } from 'react';
+
+interface PishonIQProviderProps {
+    apiKey: string;
+    host: string;
+    debug?: boolean;
+    autoCapture?: AutoCaptureOptions;
+    sampleRate?: number;
+    children: ReactNode;
+}
+declare function PishonIQProvider({ apiKey, host, debug, autoCapture, sampleRate, children, }: PishonIQProviderProps): JSX.Element;
+/**
+ * Returns `track`/`identify`/`page` bound to the PishonIQ singleton.
+ *
+ * Route-change page views are NOT fired from here — they don't need a
+ * router dependency at all. `PishonIQProvider` patches `history.pushState`/
+ * `replaceState` once (see `src/tracker.ts`), and since React Router (and
+ * any other router built on the History API) calls those same native
+ * methods internally, navigations are already captured automatically,
+ * with or without react-router-dom installed. Call `page()` from this hook
+ * yourself only if you want to pass a custom page name.
+ */
+declare function usePishonIQ(): {
+    track: typeof PishonIQ.track;
+    identify: typeof PishonIQ.identify;
+    page: typeof PishonIQ.page;
+};
+
+export { PishonIQProvider, type PishonIQProviderProps, usePishonIQ };

package/dist/react.js

@@ -0,0 +1,46 @@
+'use strict';
+
+var chunkPDDJOQBE_js = require('./chunk-PDDJOQBE.js');
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+function ensurePishonIQInit(apiKey, host, debug, autoCapture, sampleRate) {
+  if (typeof window === "undefined") return;
+  if (!chunkPDDJOQBE_js.index_default.isInitialized()) {
+    chunkPDDJOQBE_js.index_default.init({ apiKey, host, debug, autoCapture, sampleRate });
+  }
+}
+function PishonIQProvider({
+  apiKey,
+  host,
+  debug,
+  autoCapture,
+  sampleRate,
+  children
+}) {
+  const lastConfig = react.useRef(null);
+  const configKey = JSON.stringify([apiKey, host, debug, autoCapture, sampleRate]);
+  react.useEffect(() => {
+    if (lastConfig.current !== null && lastConfig.current !== configKey && chunkPDDJOQBE_js.index_default.isInitialized()) {
+      console.warn(
+        "[PishonIQ] Provider props changed after init; PishonIQ is a singleton and keeps the first configuration."
+      );
+    }
+    lastConfig.current = configKey;
+    ensurePishonIQInit(apiKey, host, debug, autoCapture, sampleRate);
+  }, [configKey, apiKey, host, debug, autoCapture, sampleRate]);
+  return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children });
+}
+function usePishonIQ() {
+  return react.useMemo(
+    () => ({
+      track: chunkPDDJOQBE_js.index_default.track.bind(chunkPDDJOQBE_js.index_default),
+      identify: chunkPDDJOQBE_js.index_default.identify.bind(chunkPDDJOQBE_js.index_default),
+      page: chunkPDDJOQBE_js.index_default.page.bind(chunkPDDJOQBE_js.index_default)
+    }),
+    []
+  );
+}
+
+exports.PishonIQProvider = PishonIQProvider;
+exports.usePishonIQ = usePishonIQ;

package/dist/react.mjs

@@ -0,0 +1,43 @@
+import { index_default } from './chunk-S3CPHTEK.mjs';
+import { useRef, useEffect, useMemo } from 'react';
+import { jsx, Fragment } from 'react/jsx-runtime';
+
+function ensurePishonIQInit(apiKey, host, debug, autoCapture, sampleRate) {
+  if (typeof window === "undefined") return;
+  if (!index_default.isInitialized()) {
+    index_default.init({ apiKey, host, debug, autoCapture, sampleRate });
+  }
+}
+function PishonIQProvider({
+  apiKey,
+  host,
+  debug,
+  autoCapture,
+  sampleRate,
+  children
+}) {
+  const lastConfig = useRef(null);
+  const configKey = JSON.stringify([apiKey, host, debug, autoCapture, sampleRate]);
+  useEffect(() => {
+    if (lastConfig.current !== null && lastConfig.current !== configKey && index_default.isInitialized()) {
+      console.warn(
+        "[PishonIQ] Provider props changed after init; PishonIQ is a singleton and keeps the first configuration."
+      );
+    }
+    lastConfig.current = configKey;
+    ensurePishonIQInit(apiKey, host, debug, autoCapture, sampleRate);
+  }, [configKey, apiKey, host, debug, autoCapture, sampleRate]);
+  return /* @__PURE__ */ jsx(Fragment, { children });
+}
+function usePishonIQ() {
+  return useMemo(
+    () => ({
+      track: index_default.track.bind(index_default),
+      identify: index_default.identify.bind(index_default),
+      page: index_default.page.bind(index_default)
+    }),
+    []
+  );
+}
+
+export { PishonIQProvider, usePishonIQ };

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "pishoniq-tracker",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.0.0",
+  "description": "PishonIQ analytics SDK for web applications",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    },
+    "./dist/browser.global.js": "./dist/browser.global.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run typecheck && npm test && npm run build"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "sdk",
+    "pishoniq",
+    "product-analytics"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pishoniq/pishoniq-sdk.git"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "jsdom": "^24.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.0"
+  },
+  "license": "MIT"
+}