@sessionsight/feedback 1.0.0 → 1.0.1

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+import type { FeedbackConfig, FeedbackOptions, FeedbackResult } from './types.js';
+export declare class FeedbackClient {
+    private apiUrl;
+    private secretApiKey;
+    private propertyId;
+    constructor(config: FeedbackConfig);
+    submit(feedbackTypeId: string, options?: FeedbackOptions): Promise<FeedbackResult>;
+    destroy(): void;
+}

package/dist/iife.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+import { FeedbackClient } from './client.js';
+import type { FeedbackConfig, FeedbackOptions, FeedbackResult } from './types.js';
+export { FeedbackClient };
+export type { FeedbackConfig, FeedbackOptions, FeedbackResult } from './types.js';
+declare const SessionSightFeedback: {
+    init(config: FeedbackConfig): void;
+    submit(feedbackTypeId: string, options?: FeedbackOptions): Promise<FeedbackResult>;
+    destroy(): void;
+};
+export default SessionSightFeedback;

package/dist/index.js

@@ -0,0 +1,177 @@
+// ../sdk-shared/src/index.ts
+var DEFAULT_API_URL = "https://api.sessionsight.com";
+function normalizeApiUrl(url) {
+  const normalized = (url || DEFAULT_API_URL).replace(/\/$/, "");
+  if (normalized.startsWith("http://") && !normalized.startsWith("http://localhost")) {
+    console.warn("SessionSight: API URL uses http:// instead of https://. Data will be transmitted unencrypted.");
+  }
+  return normalized;
+}
+var VISITOR_STORAGE_KEY = "sessionsight_visitor_id";
+var VISITOR_COOKIE_NAME = "ss_vid";
+var VISITOR_COOKIE_MAX_AGE = 365 * 24 * 60 * 60;
+function readCookie(name) {
+  if (typeof document === "undefined")
+    return null;
+  try {
+    const escaped = name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    const match = document.cookie.match(new RegExp("(?:^|; )" + escaped + "=([^;]*)"));
+    return match ? decodeURIComponent(match[1]) : null;
+  } catch {
+    return null;
+  }
+}
+function setCookie(name, value, maxAge) {
+  if (typeof document === "undefined")
+    return;
+  try {
+    const secure = location.protocol === "https:" ? "; Secure" : "";
+    document.cookie = `${name}=${value}; path=/; max-age=${maxAge}; SameSite=Lax${secure}`;
+  } catch {}
+}
+function generateUUID() {
+  if (typeof crypto !== "undefined" && crypto.randomUUID) {
+    return crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    return (c === "x" ? r : r & 3 | 8).toString(16);
+  });
+}
+var UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function isValidUUID(id) {
+  return UUID_RE.test(id);
+}
+function hasLocalStorage() {
+  try {
+    const key = "__ss_test__";
+    localStorage.setItem(key, "1");
+    localStorage.removeItem(key);
+    return true;
+  } catch {
+    return false;
+  }
+}
+function shouldSuppressPersistentId() {
+  if (typeof navigator !== "undefined") {
+    if (navigator.globalPrivacyControl === true)
+      return true;
+    if (navigator.doNotTrack === "1")
+      return true;
+  }
+  return false;
+}
+function getOrCreateVisitorId(providedId) {
+  if (providedId)
+    return providedId;
+  if (shouldSuppressPersistentId()) {
+    return generateUUID();
+  }
+  const canStore = typeof window !== "undefined" && hasLocalStorage();
+  const cookieId = readCookie(VISITOR_COOKIE_NAME);
+  if (cookieId && isValidUUID(cookieId)) {
+    if (canStore)
+      localStorage.setItem(VISITOR_STORAGE_KEY, cookieId);
+    return cookieId;
+  }
+  if (canStore) {
+    const stored = localStorage.getItem(VISITOR_STORAGE_KEY);
+    if (stored && isValidUUID(stored)) {
+      setCookie(VISITOR_COOKIE_NAME, stored, VISITOR_COOKIE_MAX_AGE);
+      return stored;
+    }
+  }
+  const id = generateUUID();
+  if (canStore)
+    localStorage.setItem(VISITOR_STORAGE_KEY, id);
+  setCookie(VISITOR_COOKIE_NAME, id, VISITOR_COOKIE_MAX_AGE);
+  return id;
+}
+var registry = new Map;
+
+// src/client.ts
+var FETCH_TIMEOUT_MS = 1e4;
+function fetchWithTimeout(url, options) {
+  const controller = new AbortController;
+  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
+  return fetch(url, { ...options, signal: controller.signal }).finally(() => clearTimeout(timer));
+}
+
+class FeedbackClient {
+  apiUrl;
+  secretApiKey;
+  propertyId;
+  constructor(config) {
+    if (typeof window !== "undefined" && !("process" in globalThis)) {
+      throw new Error("@sessionsight/feedback is a server-side SDK and cannot be used in the browser.");
+    }
+    if (!config.secretApiKey?.trim())
+      throw new Error("@sessionsight/feedback: secretApiKey is required.");
+    if (!config.propertyId?.trim())
+      throw new Error("@sessionsight/feedback: propertyId is required.");
+    this.secretApiKey = config.secretApiKey;
+    this.propertyId = config.propertyId;
+    this.apiUrl = normalizeApiUrl(config.apiUrl || "");
+  }
+  async submit(feedbackTypeId, options) {
+    try {
+      const res = await fetchWithTimeout(`${this.apiUrl}/v1/feedback/submit`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": this.secretApiKey
+        },
+        body: JSON.stringify({
+          feedbackTypeId,
+          propertyId: this.propertyId,
+          visitorId: options?.visitorId || getOrCreateVisitorId(),
+          ...options?.userId ? { userId: options.userId } : {},
+          ...options?.sessionId ? { sessionId: options.sessionId } : {},
+          ...options?.option ? { option: options.option } : {},
+          ...options?.message ? { message: options.message } : {},
+          ...options?.metadata ? { metadata: options.metadata } : {}
+        })
+      });
+      if (!res.ok) {
+        const data = await res.json().catch(() => ({}));
+        return { success: false, error: data.error || `HTTP ${res.status}` };
+      }
+      return { success: true };
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Unknown error";
+      console.warn("[SessionSight Feedback] Failed to submit feedback:", message);
+      return { success: false, error: message };
+    }
+  }
+  destroy() {}
+}
+
+// src/index.ts
+var instance = null;
+var SessionSightFeedback = {
+  init(config) {
+    if (instance) {
+      console.warn("[SessionSight Feedback] Already initialized. Call destroy() first.");
+      return;
+    }
+    instance = new FeedbackClient(config);
+  },
+  async submit(feedbackTypeId, options) {
+    if (!instance) {
+      console.warn("[SessionSight Feedback] Not initialized. Call init() first.");
+      return { success: false, error: "Not initialized" };
+    }
+    return instance.submit(feedbackTypeId, options);
+  },
+  destroy() {
+    if (instance) {
+      instance.destroy();
+      instance = null;
+    }
+  }
+};
+var src_default = SessionSightFeedback;
+export {
+  src_default as default,
+  FeedbackClient
+};

package/dist/sessionsight-feedback.js

@@ -0,0 +1 @@
+(()=>{class d{apiUrl;secretApiKey;propertyId;constructor(t){this.secretApiKey=t.secretApiKey,this.propertyId=t.propertyId,this.apiUrl=(t.apiUrl||"https://api.sessionsight.com").replace(/\/$/,"")}async submit(t,e){try{let a=await fetch(`${this.apiUrl}/v1/feedback/submit`,{method:"POST",headers:{"Content-Type":"application/json","x-api-key":this.secretApiKey},body:JSON.stringify({feedbackTypeId:t,propertyId:this.propertyId,...e?.userId?{userId:e.userId}:{},...e?.option?{option:e.option}:{},...e?.message?{message:e.message}:{},...e?.metadata?{metadata:e.metadata}:{}})});if(!a.ok)return{success:!1,error:(await a.json().catch(()=>({}))).error||`HTTP ${a.status}`};return{success:!0}}catch(a){let i=a instanceof Error?a.message:"Unknown error";return console.warn("[SessionSight Feedback] Failed to submit feedback:",i),{success:!1,error:i}}}destroy(){}}var l=null,F={init(t){l=new d(t)},async submit(t,e){if(!l)return console.warn("[SessionSight Feedback] Not initialized. Call init() first."),{success:!1,error:"Not initialized"};return l.submit(t,e)},destroy(){if(l)l.destroy(),l=null}},b=F;globalThis.SessionSightFeedback=b;})();

package/dist/types.d.ts

@@ -0,0 +1,17 @@
+export interface FeedbackConfig {
+    secretApiKey: string;
+    propertyId: string;
+    apiUrl?: string;
+}
+export interface FeedbackOptions {
+    userId?: string;
+    visitorId?: string;
+    sessionId?: string;
+    option?: string;
+    message?: string;
+    metadata?: Record<string, string>;
+}
+export interface FeedbackResult {
+    success: boolean;
+    error?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sessionsight/feedback",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "User feedback and survey SDK for SessionSight.",
   "author": "SessionSight",
   "license": "MIT",
@@ -19,6 +19,9 @@
     "user-feedback",
     "sessionsight"
   ],
+  "files": [
+    "dist"
+  ],
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",

package/src/client.ts

@@ -1,64 +0,0 @@
-import type { FeedbackConfig, FeedbackOptions, FeedbackResult } from './types.js';
-import { normalizeApiUrl, getOrCreateVisitorId } from '@sessionsight/sdk-shared';
-
-const FETCH_TIMEOUT_MS = 10_000;
-
-function fetchWithTimeout(url: string, options: RequestInit): Promise<Response> {
-  const controller = new AbortController();
-  const timer = setTimeout(() => controller.abort(), FETCH_TIMEOUT_MS);
-  return fetch(url, { ...options, signal: controller.signal }).finally(() => clearTimeout(timer));
-}
-
-export class FeedbackClient {
-  private apiUrl: string;
-  private secretApiKey: string;
-  private propertyId: string;
-
-  constructor(config: FeedbackConfig) {
-    if (typeof window !== 'undefined' && !('process' in globalThis)) {
-      throw new Error('@sessionsight/feedback is a server-side SDK and cannot be used in the browser.');
-    }
-    if (!config.secretApiKey?.trim()) throw new Error('@sessionsight/feedback: secretApiKey is required.');
-    if (!config.propertyId?.trim()) throw new Error('@sessionsight/feedback: propertyId is required.');
-    this.secretApiKey = config.secretApiKey;
-    this.propertyId = config.propertyId;
-    this.apiUrl = normalizeApiUrl(config.apiUrl || '');
-  }
-
-  async submit(feedbackTypeId: string, options?: FeedbackOptions): Promise<FeedbackResult> {
-    try {
-      const res = await fetchWithTimeout(`${this.apiUrl}/v1/feedback/submit`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'x-api-key': this.secretApiKey,
-        },
-        body: JSON.stringify({
-          feedbackTypeId,
-          propertyId: this.propertyId,
-          visitorId: options?.visitorId || getOrCreateVisitorId(),
-          ...(options?.userId ? { userId: options.userId } : {}),
-          ...(options?.sessionId ? { sessionId: options.sessionId } : {}),
-          ...(options?.option ? { option: options.option } : {}),
-          ...(options?.message ? { message: options.message } : {}),
-          ...(options?.metadata ? { metadata: options.metadata } : {}),
-        }),
-      });
-
-      if (!res.ok) {
-        const data = await res.json().catch(() => ({}));
-        return { success: false, error: (data as any).error || `HTTP ${res.status}` };
-      }
-
-      return { success: true };
-    } catch (err) {
-      const message = err instanceof Error ? err.message : 'Unknown error';
-      console.warn('[SessionSight Feedback] Failed to submit feedback:', message);
-      return { success: false, error: message };
-    }
-  }
-
-  destroy(): void {
-    // No-op for now; reserved for future cleanup (e.g., batching, intervals)
-  }
-}

package/src/index.ts

@@ -1,34 +0,0 @@
-import { FeedbackClient } from './client.js';
-import type { FeedbackConfig, FeedbackOptions, FeedbackResult } from './types.js';
-
-export { FeedbackClient };
-export type { FeedbackConfig, FeedbackOptions, FeedbackResult } from './types.js';
-
-let instance: FeedbackClient | null = null;
-
-const SessionSightFeedback = {
-  init(config: FeedbackConfig): void {
-    if (instance) {
-      console.warn('[SessionSight Feedback] Already initialized. Call destroy() first.');
-      return;
-    }
-    instance = new FeedbackClient(config);
-  },
-
-  async submit(feedbackTypeId: string, options?: FeedbackOptions): Promise<FeedbackResult> {
-    if (!instance) {
-      console.warn('[SessionSight Feedback] Not initialized. Call init() first.');
-      return { success: false, error: 'Not initialized' };
-    }
-    return instance.submit(feedbackTypeId, options);
-  },
-
-  destroy(): void {
-    if (instance) {
-      instance.destroy();
-      instance = null;
-    }
-  },
-};
-
-export default SessionSightFeedback;

package/src/types.ts

@@ -1,19 +0,0 @@
-export interface FeedbackConfig {
-  secretApiKey: string;
-  propertyId: string;
-  apiUrl?: string;
-}
-
-export interface FeedbackOptions {
-  userId?: string;
-  visitorId?: string;
-  sessionId?: string;
-  option?: string;
-  message?: string;
-  metadata?: Record<string, string>;
-}
-
-export interface FeedbackResult {
-  success: boolean;
-  error?: string;
-}

package/test/client.test.ts

@@ -1,150 +0,0 @@
-import { test, expect, mock, beforeEach } from 'bun:test';
-import { FeedbackClient } from '../src/client.js';
-
-const originalFetch = globalThis.fetch;
-
-beforeEach(() => {
-  globalThis.fetch = originalFetch;
-});
-
-test('submit sends correct request', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new FeedbackClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-    apiUrl: 'https://api.example.com',
-  });
-
-  const result = await client.submit('bug-report', {
-    userId: 'user_456',
-    option: 'critical',
-    message: 'Page crashes on Safari',
-    metadata: { page: '/checkout' },
-  });
-
-  expect(result).toEqual({ success: true });
-  expect(mockFetch).toHaveBeenCalledTimes(1);
-
-  const [url, opts] = mockFetch.mock.calls[0] as [string, RequestInit];
-  expect(url).toBe('https://api.example.com/v1/feedback/submit');
-  expect(opts.method).toBe('POST');
-  expect(opts.headers).toEqual({
-    'Content-Type': 'application/json',
-    'x-api-key': 'sk_test_123',
-  });
-  const body = JSON.parse(opts.body as string);
-  expect(body.feedbackTypeId).toBe('bug-report');
-  expect(body.propertyId).toBe('prop-1');
-  expect(body.userId).toBe('user_456');
-  expect(body.option).toBe('critical');
-  expect(body.message).toBe('Page crashes on Safari');
-  expect(body.metadata).toEqual({ page: '/checkout' });
-});
-
-test('submit with no options sends minimal payload', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new FeedbackClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.submit('general');
-
-  const body = JSON.parse((mockFetch.mock.calls[0] as [string, RequestInit])[1].body as string);
-  expect(body.feedbackTypeId).toBe('general');
-  expect(body.propertyId).toBe('prop-1');
-  expect(body.userId).toBeUndefined();
-  expect(body.option).toBeUndefined();
-  expect(body.message).toBeUndefined();
-  expect(body.metadata).toBeUndefined();
-});
-
-test('submit returns error on non-ok response', async () => {
-  globalThis.fetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ error: 'Feedback type not found' }), { status: 404 }))
-  );
-
-  const client = new FeedbackClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  const result = await client.submit('nonexistent');
-  expect(result.success).toBe(false);
-  expect(result.error).toBe('Feedback type not found');
-});
-
-test('submit returns error on network failure', async () => {
-  globalThis.fetch = mock(() => Promise.reject(new Error('Network error')));
-
-  const client = new FeedbackClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  const result = await client.submit('bug-report');
-  expect(result.success).toBe(false);
-  expect(result.error).toBe('Network error');
-});
-
-test('strips trailing slash from apiUrl', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new FeedbackClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-    apiUrl: 'https://api.example.com/',
-  });
-
-  await client.submit('test');
-  const url = (mockFetch.mock.calls[0] as [string, RequestInit])[0];
-  expect(url).toBe('https://api.example.com/v1/feedback/submit');
-});
-
-test('uses default apiUrl when not provided', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new FeedbackClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.submit('test');
-  const url = (mockFetch.mock.calls[0] as [string, RequestInit])[0];
-  expect(url).toBe('https://api.sessionsight.com/v1/feedback/submit');
-});
-
-test('submit only includes provided optional fields', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new FeedbackClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.submit('star-rating', { option: '5' });
-
-  const body = JSON.parse((mockFetch.mock.calls[0] as [string, RequestInit])[1].body as string);
-  expect(body.feedbackTypeId).toBe('star-rating');
-  expect(body.option).toBe('5');
-  expect(body.userId).toBeUndefined();
-  expect(body.message).toBeUndefined();
-  expect(body.metadata).toBeUndefined();
-});

package/tsconfig.json

@@ -1,14 +0,0 @@
-{
-  "extends": "../../tsconfig.json",
-  "compilerOptions": {
-    "outDir": "./dist",
-    "declaration": true,
-    "noEmit": false,
-    "rootDir": "./src",
-    "lib": ["ES2022", "DOM"],
-    "module": "ESNext",
-    "moduleResolution": "bundler"
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["src/**/*.test.ts"]
-}