@sessionsight/goals 1.0.0 → 1.0.1

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+import type { GoalsConfig, IncrementOptions, DecrementOptions, IncrementResult } from './types.js';
+export declare class GoalsClient {
+    private apiUrl;
+    private secretApiKey;
+    private propertyId;
+    constructor(config: GoalsConfig);
+    increment(goalId: string, options?: IncrementOptions): Promise<IncrementResult>;
+    decrement(goalId: string, options?: DecrementOptions): Promise<IncrementResult>;
+    destroy(): void;
+}

package/dist/client.test.d.ts

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

package/dist/iife.d.ts

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import { GoalsClient } from './client.js';
+import type { GoalsConfig, IncrementOptions, DecrementOptions, IncrementResult } from './types.js';
+export { GoalsClient };
+export type { GoalsConfig, IncrementOptions, DecrementOptions, IncrementResult } from './types.js';
+declare const SessionSightGoals: {
+    init(config: GoalsConfig): void;
+    increment(goalId: string, options?: IncrementOptions): Promise<IncrementResult>;
+    decrement(goalId: string, options?: DecrementOptions): Promise<IncrementResult>;
+    destroy(): void;
+};
+export default SessionSightGoals;

package/dist/index.js

@@ -0,0 +1,142 @@
+// ../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_COOKIE_MAX_AGE = 365 * 24 * 60 * 60;
+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 GoalsClient {
+  apiUrl;
+  secretApiKey;
+  propertyId;
+  constructor(config) {
+    if (typeof window !== "undefined" && !("process" in globalThis)) {
+      throw new Error("@sessionsight/goals is a server-side SDK and cannot be used in the browser.");
+    }
+    if (!config.secretApiKey?.trim())
+      throw new Error("@sessionsight/goals: secretApiKey is required.");
+    if (!config.propertyId?.trim())
+      throw new Error("@sessionsight/goals: propertyId is required.");
+    this.secretApiKey = config.secretApiKey;
+    this.propertyId = config.propertyId;
+    this.apiUrl = normalizeApiUrl(config.apiUrl || "");
+  }
+  async increment(goalId, options) {
+    const amount = options?.amount ?? 1;
+    if (!Number.isFinite(amount) || amount <= 0) {
+      return { success: false, error: "amount must be a positive finite number" };
+    }
+    if (options?.value != null && (!Number.isFinite(options.value) || options.value < 0)) {
+      return { success: false, error: "value must be a non-negative finite number" };
+    }
+    try {
+      const res = await fetchWithTimeout(`${this.apiUrl}/v1/goals/increment`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": this.secretApiKey
+        },
+        body: JSON.stringify({
+          goalId,
+          propertyId: this.propertyId,
+          amount: options?.amount ?? 1,
+          ...options?.value != null ? { value: options.value } : {},
+          ...options?.currency ? { currency: options.currency } : {},
+          ...options?.visitorId ? { visitorId: options.visitorId } : {},
+          ...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 Goals] Failed to increment goal:", message);
+      return { success: false, error: message };
+    }
+  }
+  async decrement(goalId, options) {
+    const amount = options?.amount ?? 1;
+    if (!Number.isFinite(amount) || amount <= 0) {
+      return { success: false, error: "amount must be a positive finite number" };
+    }
+    try {
+      const res = await fetchWithTimeout(`${this.apiUrl}/v1/goals/decrement`, {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          "x-api-key": this.secretApiKey
+        },
+        body: JSON.stringify({
+          goalId,
+          propertyId: this.propertyId,
+          amount: options?.amount ?? 1,
+          ...options?.visitorId ? { visitorId: options.visitorId } : {},
+          ...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 Goals] Failed to decrement goal:", message);
+      return { success: false, error: message };
+    }
+  }
+  destroy() {}
+}
+
+// src/index.ts
+var instance = null;
+var SessionSightGoals = {
+  init(config) {
+    if (instance) {
+      console.warn("[SessionSight Goals] Already initialized. Call destroy() first.");
+      return;
+    }
+    instance = new GoalsClient(config);
+  },
+  async increment(goalId, options) {
+    if (!instance) {
+      console.warn("[SessionSight Goals] Not initialized. Call init() first.");
+      return { success: false, error: "Not initialized" };
+    }
+    return instance.increment(goalId, options);
+  },
+  async decrement(goalId, options) {
+    if (!instance) {
+      console.warn("[SessionSight Goals] Not initialized. Call init() first.");
+      return { success: false, error: "Not initialized" };
+    }
+    return instance.decrement(goalId, options);
+  },
+  destroy() {
+    if (instance) {
+      instance.destroy();
+      instance = null;
+    }
+  }
+};
+var src_default = SessionSightGoals;
+export {
+  src_default as default,
+  GoalsClient
+};

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+export interface GoalsConfig {
+    secretApiKey: string;
+    propertyId: string;
+    apiUrl?: string;
+}
+export interface IncrementOptions {
+    amount?: number;
+    value?: number;
+    currency?: string;
+    visitorId?: string;
+    metadata?: Record<string, string>;
+}
+export interface DecrementOptions {
+    amount?: number;
+    visitorId?: string;
+    metadata?: Record<string, string>;
+}
+export interface IncrementResult {
+    success: boolean;
+    error?: string;
+}

package/package.json

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

package/src/client.ts

@@ -1,104 +0,0 @@
-import type { GoalsConfig, IncrementOptions, DecrementOptions, IncrementResult } from './types.js';
-import { normalizeApiUrl } 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 GoalsClient {
-  private apiUrl: string;
-  private secretApiKey: string;
-  private propertyId: string;
-
-  constructor(config: GoalsConfig) {
-    if (typeof window !== 'undefined' && !('process' in globalThis)) {
-      throw new Error('@sessionsight/goals is a server-side SDK and cannot be used in the browser.');
-    }
-    if (!config.secretApiKey?.trim()) throw new Error('@sessionsight/goals: secretApiKey is required.');
-    if (!config.propertyId?.trim()) throw new Error('@sessionsight/goals: propertyId is required.');
-    this.secretApiKey = config.secretApiKey;
-    this.propertyId = config.propertyId;
-    this.apiUrl = normalizeApiUrl(config.apiUrl || '');
-  }
-
-  async increment(goalId: string, options?: IncrementOptions): Promise<IncrementResult> {
-    const amount = options?.amount ?? 1;
-    if (!Number.isFinite(amount) || amount <= 0) {
-      return { success: false, error: 'amount must be a positive finite number' };
-    }
-    if (options?.value != null && (!Number.isFinite(options.value) || options.value < 0)) {
-      return { success: false, error: 'value must be a non-negative finite number' };
-    }
-    try {
-      const res = await fetchWithTimeout(`${this.apiUrl}/v1/goals/increment`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'x-api-key': this.secretApiKey,
-        },
-        body: JSON.stringify({
-          goalId,
-          propertyId: this.propertyId,
-          amount: options?.amount ?? 1,
-          ...(options?.value != null ? { value: options.value } : {}),
-          ...(options?.currency ? { currency: options.currency } : {}),
-          ...(options?.visitorId ? { visitorId: options.visitorId } : {}),
-          ...(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 Goals] Failed to increment goal:', message);
-      return { success: false, error: message };
-    }
-  }
-
-  async decrement(goalId: string, options?: DecrementOptions): Promise<IncrementResult> {
-    const amount = options?.amount ?? 1;
-    if (!Number.isFinite(amount) || amount <= 0) {
-      return { success: false, error: 'amount must be a positive finite number' };
-    }
-    try {
-      const res = await fetchWithTimeout(`${this.apiUrl}/v1/goals/decrement`, {
-        method: 'POST',
-        headers: {
-          'Content-Type': 'application/json',
-          'x-api-key': this.secretApiKey,
-        },
-        body: JSON.stringify({
-          goalId,
-          propertyId: this.propertyId,
-          amount: options?.amount ?? 1,
-          ...(options?.visitorId ? { visitorId: options.visitorId } : {}),
-          ...(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 Goals] Failed to decrement goal:', 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,42 +0,0 @@
-import { GoalsClient } from './client.js';
-import type { GoalsConfig, IncrementOptions, DecrementOptions, IncrementResult } from './types.js';
-
-export { GoalsClient };
-export type { GoalsConfig, IncrementOptions, DecrementOptions, IncrementResult } from './types.js';
-
-let instance: GoalsClient | null = null;
-
-const SessionSightGoals = {
-  init(config: GoalsConfig): void {
-    if (instance) {
-      console.warn('[SessionSight Goals] Already initialized. Call destroy() first.');
-      return;
-    }
-    instance = new GoalsClient(config);
-  },
-
-  async increment(goalId: string, options?: IncrementOptions): Promise<IncrementResult> {
-    if (!instance) {
-      console.warn('[SessionSight Goals] Not initialized. Call init() first.');
-      return { success: false, error: 'Not initialized' };
-    }
-    return instance.increment(goalId, options);
-  },
-
-  async decrement(goalId: string, options?: DecrementOptions): Promise<IncrementResult> {
-    if (!instance) {
-      console.warn('[SessionSight Goals] Not initialized. Call init() first.');
-      return { success: false, error: 'Not initialized' };
-    }
-    return instance.decrement(goalId, options);
-  },
-
-  destroy(): void {
-    if (instance) {
-      instance.destroy();
-      instance = null;
-    }
-  },
-};
-
-export default SessionSightGoals;

package/src/types.ts

@@ -1,24 +0,0 @@
-export interface GoalsConfig {
-  secretApiKey: string;
-  propertyId: string;
-  apiUrl?: string;
-}
-
-export interface IncrementOptions {
-  amount?: number;
-  value?: number;
-  currency?: string;
-  visitorId?: string;
-  metadata?: Record<string, string>;
-}
-
-export interface DecrementOptions {
-  amount?: number;
-  visitorId?: string;
-  metadata?: Record<string, string>;
-}
-
-export interface IncrementResult {
-  success: boolean;
-  error?: string;
-}

package/test/client.test.ts

@@ -1,198 +0,0 @@
-import { test, expect, mock, beforeEach } from 'bun:test';
-import { GoalsClient } from '../src/client.js';
-
-const originalFetch = globalThis.fetch;
-
-beforeEach(() => {
-  globalThis.fetch = originalFetch;
-});
-
-test('increment sends correct request', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-    apiUrl: 'https://api.example.com',
-  });
-
-  const result = await client.increment('user-signups');
-
-  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/goals/increment');
-  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.goalId).toBe('user-signups');
-  expect(body.propertyId).toBe('prop-1');
-  expect(body.amount).toBe(1);
-});
-
-test('increment sends custom amount and metadata', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.increment('revenue', { amount: 49, metadata: { plan: 'pro' } });
-
-  const body = JSON.parse((mockFetch.mock.calls[0] as [string, RequestInit])[1].body as string);
-  expect(body.amount).toBe(49);
-  expect(body.metadata).toEqual({ plan: 'pro' });
-});
-
-test('increment returns error on non-ok response', async () => {
-  globalThis.fetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ error: 'Goal not found' }), { status: 404 }))
-  );
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  const result = await client.increment('nonexistent');
-  expect(result.success).toBe(false);
-  expect(result.error).toBe('Goal not found');
-});
-
-test('increment returns error on network failure', async () => {
-  globalThis.fetch = mock(() => Promise.reject(new Error('Network error')));
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  const result = await client.increment('user-signups');
-  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 GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-    apiUrl: 'https://api.example.com/',
-  });
-
-  await client.increment('test');
-  const url = (mockFetch.mock.calls[0] as [string, RequestInit])[0];
-  expect(url).toBe('https://api.example.com/v1/goals/increment');
-});
-
-test('increment sends value and currency for revenue attribution', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.increment('purchase', { value: 49.99, currency: 'USD', metadata: { sku: 'widget-pro' } });
-
-  const body = JSON.parse((mockFetch.mock.calls[0] as [string, RequestInit])[1].body as string);
-  expect(body.value).toBe(49.99);
-  expect(body.currency).toBe('USD');
-  expect(body.metadata).toEqual({ sku: 'widget-pro' });
-  expect(body.amount).toBe(1);
-});
-
-test('increment omits value and currency when not provided', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.increment('user-signups', { amount: 5 });
-
-  const body = JSON.parse((mockFetch.mock.calls[0] as [string, RequestInit])[1].body as string);
-  expect(body.value).toBeUndefined();
-  expect(body.currency).toBeUndefined();
-  expect(body.amount).toBe(5);
-});
-
-test('decrement sends correct request', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-    apiUrl: 'https://api.example.com',
-  });
-
-  const result = await client.decrement('user-signups');
-
-  expect(result).toEqual({ success: true });
-  const [url, opts] = mockFetch.mock.calls[0] as [string, RequestInit];
-  expect(url).toBe('https://api.example.com/v1/goals/decrement');
-  expect(opts.method).toBe('POST');
-  const body = JSON.parse(opts.body as string);
-  expect(body.goalId).toBe('user-signups');
-  expect(body.propertyId).toBe('prop-1');
-  expect(body.amount).toBe(1);
-});
-
-test('decrement sends custom amount and metadata', async () => {
-  const mockFetch = mock(() =>
-    Promise.resolve(new Response(JSON.stringify({ success: true }), { status: 200 }))
-  );
-  globalThis.fetch = mockFetch;
-
-  const client = new GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.decrement('inventory', { amount: 3, metadata: { reason: 'refund' } });
-
-  const body = JSON.parse((mockFetch.mock.calls[0] as [string, RequestInit])[1].body as string);
-  expect(body.amount).toBe(3);
-  expect(body.metadata).toEqual({ reason: 'refund' });
-});
-
-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 GoalsClient({
-    secretApiKey: 'sk_test_123',
-    propertyId: 'prop-1',
-  });
-
-  await client.increment('test');
-  const url = (mockFetch.mock.calls[0] as [string, RequestInit])[0];
-  expect(url).toBe('https://api.sessionsight.com/v1/goals/increment');
-});

package/tsconfig.json

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