saasco-sdk 0.1.12 → 0.1.14

package/README.md

@@ -35,8 +35,8 @@ export const saasco = new Saasco({ projectId: 'YOUR-PROJECT-ID' });
 
 ## Init Automatic Page View Tracking
 
-When you initial the lib Saasco will automatically start tracking all page views in your app. There is no other configuration. It will automatically track url changes, even for SPAs like NextJs and Vue.
-You can also [manually track pages](https://www.notion.so/Manual-Page-Tracking-in-SPAs-2442fc7586dc4208ae8f669eb7561b1a?pvs=21) by opting our of automatic page tracking. For most use cases you don't need to do this.
+When you initiate the lib Saasco will automatically start tracking all page views in your app. There is no other configuration. It will automatically track url changes, even for SPAs like NextJs and Vue.
+You can also [manually track pages](https://www.notion.so/Manual-Page-Tracking-in-SPAs-2442fc7586dc4208ae8f669eb7561b1a?pvs=21) by opting out of automatic page tracking. For most use cases you don't need to do this.
 
 ```ts
 // ./app/index
@@ -228,6 +228,12 @@ Any property that starts with `$` is a property that has been generated by the S
 | $utmContent             | Last Touch UTM Content      | The UTM content tag from the URL a customer clicked during their last interaction.     |
 | $unsubscribed           | Unsubscribed                | Whether the user has unsubscribed from all notifications                               |
 
+### Reserved Integration Properties
+
+| Property          | Display Name       | Description                                      |
+| ----------------- | ------------------ | ------------------------------------------------ |
+| $stripeCustomerId | Stripe Customer Id | The Stripe customer ID associated with this user |
+
 ### Reserved event properties
 
 Properties used to calculate revenue for different traffic sources and LTV for users.

package/index.cjs.js

@@ -6,6 +6,8 @@ var tslib = require('tslib');
 var uuid = require('@lukeed/uuid');
 var zod = require('zod');
 
+var version = "0.1.14";
+
 const timezones = {
   'Asia/Barnaul': 'RU',
   'Africa/Nouakchott': 'MR',
@@ -434,10 +436,39 @@ const timezones = {
   'Asia/Calcutta': 'IN'
 };
 
-var version = "0.1.12";
+function getBrowserContext() {
+  var _a;
+  const isBrowser = typeof window !== 'undefined';
+  if (!isBrowser) return;
+  const customNavigator = navigator;
+  const $locale = (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages) && (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages.length) ? customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages[0] : (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.userLanguage) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.language) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.browserLanguage) || 'en';
+  // https://caniuse.com/?search=Intl.DateTimeFormat().resolvedOptions().timeZone
+  // Only has 96.63% global support, so we need to check for undefined
+  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  const $location = timezones[timezone] || ((_a = $locale === null || $locale === void 0 ? void 0 : $locale.split('-')) === null || _a === void 0 ? void 0 : _a[1]) || 'undefined';
+  const $href = window.location.href;
+  const $pathname = window.location.pathname;
+  const $referrer = document.referrer;
+  const $screenDPI = window.devicePixelRatio;
+  const $screenHeight = screen.height;
+  const $screenWidth = screen.width;
+  const $title = document.title;
+  const $userAgent = window.navigator.userAgent;
+  return {
+    $locale,
+    $location,
+    $href,
+    $pathname,
+    $referrer,
+    $screenDPI,
+    $screenHeight,
+    $screenWidth,
+    $title,
+    $userAgent
+  };
+}
 
 const isBrowser = typeof window !== 'undefined';
-let userId = null;
 const PREF = 'saasco-sdk';
 const data = {};
 function storeData(key, value, ttl) {
@@ -503,35 +534,11 @@ function setAnonmousId({
   storeData(`anonymous-id`, anonymousId, 1000 * 60 * 60 * 24 * 365);
   return anonymousId;
 }
-function getBrowserContext() {
-  var _a;
-  if (!isBrowser) return {};
-  const customNavigator = navigator;
-  const $locale = (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages) && (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages.length) ? customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages[0] : (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.userLanguage) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.language) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.browserLanguage) || 'en';
-  // https://caniuse.com/?search=Intl.DateTimeFormat().resolvedOptions().timeZone
-  // Only has 96.63% global support, so we need to check for undefined
-  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-  const $location = timezones[timezone] || ((_a = $locale === null || $locale === void 0 ? void 0 : $locale.split('-')) === null || _a === void 0 ? void 0 : _a[1]) || 'undefined';
-  const $href = window.location.href;
-  const $pathname = window.location.pathname;
-  const $referrer = document.referrer;
-  const $screenDPI = window.devicePixelRatio;
-  const $screenHeight = screen.height;
-  const $screenWidth = screen.width;
-  const $title = document.title;
-  const $userAgent = window.navigator.userAgent;
-  return {
-    $locale,
-    $location,
-    $href,
-    $pathname,
-    $referrer,
-    $screenDPI,
-    $screenHeight,
-    $screenWidth,
-    $title,
-    $userAgent
-  };
+function getUserId() {
+  return retrieveData(`user-id`);
+}
+function setUserId(userId) {
+  storeData(`user-id`, userId, 1000 * 60 * 60 * 24 * 365);
 }
 class Saasco {
   /**
@@ -555,9 +562,6 @@ class Saasco {
     this.config.enabled = this.config.enabled === undefined ? true : this.config.enabled;
   }
   init() {
-    if (!this.config.projectId) {
-      return this.error("Unable to initialize Saasco. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
-    }
     if (this.isInitialized) {
       this.log('Saasco is already initialized. Please check your code to ensure that init() is not being called multiple times.');
       return;
@@ -613,9 +617,9 @@ class Saasco {
       version,
       sessionId: getSessionId(),
       anonymousId: getAnonymousId(),
-      distinctId: userId,
+      distinctId: getUserId(),
       projectId: this.config.projectId,
-      payload: JSON.stringify(Object.assign(Object.assign({}, browserContext), {
+      payload: JSON.stringify(Object.assign(Object.assign({}, browserContext || {}), {
         properties: properties || {}
       })),
       context: JSON.stringify(context || {})
@@ -642,7 +646,7 @@ class Saasco {
     // When the user gets identified as null this will reset the users session and anonymous id
     // This should only be called when distinctId is null and there is an existing userId.
     // This means the user has logged out and we should reset the session and anonymous IDs
-    const userIdChangedToNull = distinctId === null && !!userId;
+    const userIdChangedToNull = distinctId === null && !!getUserId();
     if (userIdChangedToNull) this.log('User ID change to null. Session reset');
     const reset = userIdChangedToNull;
     setSessionId({
@@ -652,7 +656,7 @@ class Saasco {
       reset
     });
     // set the distinct Id to the userId
-    userId = distinctId;
+    setUserId(distinctId);
     // No distinctId provided so we don't track the user
     if (!distinctId) return;
     const data = {
@@ -691,13 +695,13 @@ class Saasco {
           body: JSON.stringify(data)
         });
         if (!response.ok) {
-          throw new Error(response.status.toString());
+          const errorBody = yield response.json();
+          throw new Error(`${errorBody.message}: ${errorBody.errors ? `[${errorBody.errors.join(', ')}]` : ''}` || JSON.stringify(errorBody));
         }
         return response;
       } catch (error) {
-        const errorMessage = 'Error with Saasco request: ' + error.message;
-        console.error(errorMessage, path, data);
-        return errorMessage;
+        this.error(`\nError Message: "${error.message}"`, `\nPath: "/${path}"`, `\nRequest Data: ${JSON.stringify(data, null, 2)}`);
+        return error.message;
       }
     });
   }
@@ -812,6 +816,9 @@ function coerceReservedProperties(properties) {
   }, {
     key: 'displayName',
     coerceFrom: ['display_name', 'displayName', 'user_display_name', 'userDisplayName', 'full_name', 'fullName', 'user_full_name', 'userFullName', 'complete_name', 'completeName', 'user_complete_name', 'userCompleteName', 'name', 'username']
+  }, {
+    key: '$stripeCustomerId',
+    coerceFrom: ['stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId']
   }];
   return coerce.reduce((acc, {
     key,
@@ -859,6 +866,61 @@ function coerceValue(properties, keys, schema) {
   return coercedValue;
 }
 
+const browserContextSchema = zod.z.object({
+  $locale: zod.z.string(),
+  $location: zod.z.string(),
+  $href: zod.z.string(),
+  $pathname: zod.z.string(),
+  $referrer: zod.z.string(),
+  $screenDPI: zod.z.number(),
+  $screenHeight: zod.z.number(),
+  $screenWidth: zod.z.number(),
+  $title: zod.z.string(),
+  $userAgent: zod.z.string()
+});
+const serverContextSchema = zod.z.object({
+  $city: zod.z.string().optional(),
+  $country: zod.z.string().optional(),
+  $continent: zod.z.string().optional(),
+  $latitude: zod.z.number().optional(),
+  $longitude: zod.z.number().optional(),
+  $timezone: zod.z.string().optional(),
+  $userAgent: zod.z.string().optional(),
+  $referrer: zod.z.string().optional(),
+  $ip: zod.z.string().optional(),
+  $processedAt: zod.z.string().datetime().optional(),
+  $identityHash: zod.z.string().optional()
+});
+const trackedEventTypesSchema = zod.z.enum(['SHORTLINK_REDIRECT']);
+const trackedEventSchema = zod.z.object({
+  id: zod.z.string().uuid(),
+  timestamp: zod.z.string().datetime(),
+  projectId: zod.z.string(),
+  version: zod.z.string(),
+  type: trackedEventTypesSchema,
+  payload: zod.z.object({
+    browserContext: browserContextSchema.optional(),
+    serverContext: serverContextSchema.optional(),
+    properties: zod.z.record(zod.z.string(), zod.z.any()).optional()
+  })
+});
+/**
+ * Creates a zod for tracking any type of event.
+ * Includes the base tracking schema and extends with any new schema
+ * @param type
+ * @param payloadSchema
+ * @returns
+ */
+function createTrackedEventTypeSchema(type, payloadSchema) {
+  const typeSchema = zod.z.literal(type);
+  return trackedEventSchema.extend({
+    type: typeSchema,
+    payload: zod.z.object(Object.assign(Object.assign({}, trackedEventSchema.shape.payload.shape), {
+      properties: payloadSchema
+    }))
+  });
+}
+
 const tbAny = zod.z.union([zod.z.string(), zod.z.number(), zod.z.array(zod.z.union([zod.z.string(), zod.z.number()]))]);
 const tinyBirdBaseSchema = zod.z.object({
   meta: zod.z.array(zod.z.object({
@@ -1037,7 +1099,11 @@ const reservedPropertiesSchema = zod.z.object({
   username: zod.z.string().nullish(),
   website: zod.z.string().nullish(),
   $id: zod.z.string().nullish(),
-  $lastSeen: zod.z.string().nullish()
+  $lastSeen: zod.z.string().nullish(),
+  // Stripe Properties
+  $stripeCustomerId: zod.z.string().nullish(),
+  $stripeTotalPayments: zod.z.number().or(zod.z.string()).nullish(),
+  $stripeTotalSpent: zod.z.number().or(zod.z.string()).nullish()
 });
 const contactPropertiesSchema = reservedPropertiesSchema.optional().and(zod.z.record(zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean(), zod.z.date(), zod.z.null(), zod.z.array(zod.z.union([zod.z.string(), zod.z.number(), zod.z.boolean(), zod.z.date(), zod.z.null()]))])));
 const analyticsUserRawSchema = zod.z.object({
@@ -1088,11 +1154,14 @@ exports.analyticsEventSchema = analyticsEventSchema;
 exports.analyticsUserRawSchema = analyticsUserRawSchema;
 exports.analyticsUserSchema = analyticsUserSchema;
 exports.baseTopRequestSchema = baseTopRequestSchema;
+exports.browserContextSchema = browserContextSchema;
 exports.coerceReservedProperties = coerceReservedProperties;
 exports.contactPropertiesSchema = contactPropertiesSchema;
+exports.createTrackedEventTypeSchema = createTrackedEventTypeSchema;
 exports.currentUsersRequestSchema = currentUsersRequestSchema;
 exports.currentUsersResponseSchema = currentUsersResponseSchema;
 exports.getAnalyticsUserParamsSchema = getAnalyticsUserParamsSchema;
+exports.getBrowserContext = getBrowserContext;
 exports.idenfitySchema = idenfitySchema;
 exports.kpiSchema = kpiSchema;
 exports.kpisRequestSchema = kpisRequestSchema;
@@ -1104,6 +1173,7 @@ exports.latestIdentifiesRequestSchema = latestIdentifiesRequestSchema;
 exports.latestIdentifiesResponseSchema = latestIdentifiesResponseSchema;
 exports.listUsersParamsSchema = listUsersParamsSchema;
 exports.reservedPropertiesSchema = reservedPropertiesSchema;
+exports.serverContextSchema = serverContextSchema;
 exports.tbAny = tbAny;
 exports.timezones = timezones;
 exports.tinyBirdBaseSchema = tinyBirdBaseSchema;
@@ -1114,4 +1184,6 @@ exports.topLocationsResponseSchema = topLocationsResponseSchema;
 exports.topPagesResponseSchema = topPagesResponseSchema;
 exports.topSourcesResponseSchema = topSourcesResponseSchema;
 exports.topSourcesSchema = topSourcesSchema;
+exports.trackedEventSchema = trackedEventSchema;
+exports.trackedEventTypesSchema = trackedEventTypesSchema;
 exports.userEventsResponseSchema = userEventsResponseSchema;

package/index.esm.js

@@ -2,6 +2,8 @@ import { __awaiter } from 'tslib';
 import { v4 } from '@lukeed/uuid';
 import { z } from 'zod';
 
+var version = "0.1.14";
+
 const timezones = {
   'Asia/Barnaul': 'RU',
   'Africa/Nouakchott': 'MR',
@@ -430,10 +432,39 @@ const timezones = {
   'Asia/Calcutta': 'IN'
 };
 
-var version = "0.1.12";
+function getBrowserContext() {
+  var _a;
+  const isBrowser = typeof window !== 'undefined';
+  if (!isBrowser) return;
+  const customNavigator = navigator;
+  const $locale = (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages) && (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages.length) ? customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages[0] : (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.userLanguage) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.language) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.browserLanguage) || 'en';
+  // https://caniuse.com/?search=Intl.DateTimeFormat().resolvedOptions().timeZone
+  // Only has 96.63% global support, so we need to check for undefined
+  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
+  const $location = timezones[timezone] || ((_a = $locale === null || $locale === void 0 ? void 0 : $locale.split('-')) === null || _a === void 0 ? void 0 : _a[1]) || 'undefined';
+  const $href = window.location.href;
+  const $pathname = window.location.pathname;
+  const $referrer = document.referrer;
+  const $screenDPI = window.devicePixelRatio;
+  const $screenHeight = screen.height;
+  const $screenWidth = screen.width;
+  const $title = document.title;
+  const $userAgent = window.navigator.userAgent;
+  return {
+    $locale,
+    $location,
+    $href,
+    $pathname,
+    $referrer,
+    $screenDPI,
+    $screenHeight,
+    $screenWidth,
+    $title,
+    $userAgent
+  };
+}
 
 const isBrowser = typeof window !== 'undefined';
-let userId = null;
 const PREF = 'saasco-sdk';
 const data = {};
 function storeData(key, value, ttl) {
@@ -499,35 +530,11 @@ function setAnonmousId({
   storeData(`anonymous-id`, anonymousId, 1000 * 60 * 60 * 24 * 365);
   return anonymousId;
 }
-function getBrowserContext() {
-  var _a;
-  if (!isBrowser) return {};
-  const customNavigator = navigator;
-  const $locale = (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages) && (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages.length) ? customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.languages[0] : (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.userLanguage) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.language) || (customNavigator === null || customNavigator === void 0 ? void 0 : customNavigator.browserLanguage) || 'en';
-  // https://caniuse.com/?search=Intl.DateTimeFormat().resolvedOptions().timeZone
-  // Only has 96.63% global support, so we need to check for undefined
-  const timezone = Intl.DateTimeFormat().resolvedOptions().timeZone;
-  const $location = timezones[timezone] || ((_a = $locale === null || $locale === void 0 ? void 0 : $locale.split('-')) === null || _a === void 0 ? void 0 : _a[1]) || 'undefined';
-  const $href = window.location.href;
-  const $pathname = window.location.pathname;
-  const $referrer = document.referrer;
-  const $screenDPI = window.devicePixelRatio;
-  const $screenHeight = screen.height;
-  const $screenWidth = screen.width;
-  const $title = document.title;
-  const $userAgent = window.navigator.userAgent;
-  return {
-    $locale,
-    $location,
-    $href,
-    $pathname,
-    $referrer,
-    $screenDPI,
-    $screenHeight,
-    $screenWidth,
-    $title,
-    $userAgent
-  };
+function getUserId() {
+  return retrieveData(`user-id`);
+}
+function setUserId(userId) {
+  storeData(`user-id`, userId, 1000 * 60 * 60 * 24 * 365);
 }
 class Saasco {
   /**
@@ -551,9 +558,6 @@ class Saasco {
     this.config.enabled = this.config.enabled === undefined ? true : this.config.enabled;
   }
   init() {
-    if (!this.config.projectId) {
-      return this.error("Unable to initialize Saasco. Project ID is required but has not been provided. If you are using an env variable make sure it's set correctly.");
-    }
     if (this.isInitialized) {
       this.log('Saasco is already initialized. Please check your code to ensure that init() is not being called multiple times.');
       return;
@@ -609,9 +613,9 @@ class Saasco {
       version,
       sessionId: getSessionId(),
       anonymousId: getAnonymousId(),
-      distinctId: userId,
+      distinctId: getUserId(),
       projectId: this.config.projectId,
-      payload: JSON.stringify(Object.assign(Object.assign({}, browserContext), {
+      payload: JSON.stringify(Object.assign(Object.assign({}, browserContext || {}), {
         properties: properties || {}
       })),
       context: JSON.stringify(context || {})
@@ -638,7 +642,7 @@ class Saasco {
     // When the user gets identified as null this will reset the users session and anonymous id
     // This should only be called when distinctId is null and there is an existing userId.
     // This means the user has logged out and we should reset the session and anonymous IDs
-    const userIdChangedToNull = distinctId === null && !!userId;
+    const userIdChangedToNull = distinctId === null && !!getUserId();
     if (userIdChangedToNull) this.log('User ID change to null. Session reset');
     const reset = userIdChangedToNull;
     setSessionId({
@@ -648,7 +652,7 @@ class Saasco {
       reset
     });
     // set the distinct Id to the userId
-    userId = distinctId;
+    setUserId(distinctId);
     // No distinctId provided so we don't track the user
     if (!distinctId) return;
     const data = {
@@ -687,13 +691,13 @@ class Saasco {
           body: JSON.stringify(data)
         });
         if (!response.ok) {
-          throw new Error(response.status.toString());
+          const errorBody = yield response.json();
+          throw new Error(`${errorBody.message}: ${errorBody.errors ? `[${errorBody.errors.join(', ')}]` : ''}` || JSON.stringify(errorBody));
         }
         return response;
       } catch (error) {
-        const errorMessage = 'Error with Saasco request: ' + error.message;
-        console.error(errorMessage, path, data);
-        return errorMessage;
+        this.error(`\nError Message: "${error.message}"`, `\nPath: "/${path}"`, `\nRequest Data: ${JSON.stringify(data, null, 2)}`);
+        return error.message;
       }
     });
   }
@@ -808,6 +812,9 @@ function coerceReservedProperties(properties) {
   }, {
     key: 'displayName',
     coerceFrom: ['display_name', 'displayName', 'user_display_name', 'userDisplayName', 'full_name', 'fullName', 'user_full_name', 'userFullName', 'complete_name', 'completeName', 'user_complete_name', 'userCompleteName', 'name', 'username']
+  }, {
+    key: '$stripeCustomerId',
+    coerceFrom: ['stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId', 'stripe_customer_id', 'stripeCustomerId']
   }];
   return coerce.reduce((acc, {
     key,
@@ -855,6 +862,61 @@ function coerceValue(properties, keys, schema) {
   return coercedValue;
 }
 
+const browserContextSchema = z.object({
+  $locale: z.string(),
+  $location: z.string(),
+  $href: z.string(),
+  $pathname: z.string(),
+  $referrer: z.string(),
+  $screenDPI: z.number(),
+  $screenHeight: z.number(),
+  $screenWidth: z.number(),
+  $title: z.string(),
+  $userAgent: z.string()
+});
+const serverContextSchema = z.object({
+  $city: z.string().optional(),
+  $country: z.string().optional(),
+  $continent: z.string().optional(),
+  $latitude: z.number().optional(),
+  $longitude: z.number().optional(),
+  $timezone: z.string().optional(),
+  $userAgent: z.string().optional(),
+  $referrer: z.string().optional(),
+  $ip: z.string().optional(),
+  $processedAt: z.string().datetime().optional(),
+  $identityHash: z.string().optional()
+});
+const trackedEventTypesSchema = z.enum(['SHORTLINK_REDIRECT']);
+const trackedEventSchema = z.object({
+  id: z.string().uuid(),
+  timestamp: z.string().datetime(),
+  projectId: z.string(),
+  version: z.string(),
+  type: trackedEventTypesSchema,
+  payload: z.object({
+    browserContext: browserContextSchema.optional(),
+    serverContext: serverContextSchema.optional(),
+    properties: z.record(z.string(), z.any()).optional()
+  })
+});
+/**
+ * Creates a zod for tracking any type of event.
+ * Includes the base tracking schema and extends with any new schema
+ * @param type
+ * @param payloadSchema
+ * @returns
+ */
+function createTrackedEventTypeSchema(type, payloadSchema) {
+  const typeSchema = z.literal(type);
+  return trackedEventSchema.extend({
+    type: typeSchema,
+    payload: z.object(Object.assign(Object.assign({}, trackedEventSchema.shape.payload.shape), {
+      properties: payloadSchema
+    }))
+  });
+}
+
 const tbAny = z.union([z.string(), z.number(), z.array(z.union([z.string(), z.number()]))]);
 const tinyBirdBaseSchema = z.object({
   meta: z.array(z.object({
@@ -1033,7 +1095,11 @@ const reservedPropertiesSchema = z.object({
   username: z.string().nullish(),
   website: z.string().nullish(),
   $id: z.string().nullish(),
-  $lastSeen: z.string().nullish()
+  $lastSeen: z.string().nullish(),
+  // Stripe Properties
+  $stripeCustomerId: z.string().nullish(),
+  $stripeTotalPayments: z.number().or(z.string()).nullish(),
+  $stripeTotalSpent: z.number().or(z.string()).nullish()
 });
 const contactPropertiesSchema = reservedPropertiesSchema.optional().and(z.record(z.union([z.string(), z.number(), z.boolean(), z.date(), z.null(), z.array(z.union([z.string(), z.number(), z.boolean(), z.date(), z.null()]))])));
 const analyticsUserRawSchema = z.object({
@@ -1078,4 +1144,4 @@ const latestIdentifiesResponseSchema = tinyBirdBaseSchema.extend({
   }))
 });
 
-export { Saasco, TinybirdJobResponseSchema, analyticsEventSchema, analyticsUserRawSchema, analyticsUserSchema, baseTopRequestSchema, coerceReservedProperties, contactPropertiesSchema, currentUsersRequestSchema, currentUsersResponseSchema, getAnalyticsUserParamsSchema, idenfitySchema, kpiSchema, kpisRequestSchema, kpisResponseSchema, latestEventItemSchema, latestEventsRequestSchema, latestEventsResponseSchema, latestIdentifiesRequestSchema, latestIdentifiesResponseSchema, listUsersParamsSchema, reservedPropertiesSchema, tbAny, timezones, tinyBirdBaseSchema, topActionsResponseSchema, topBrowsersResponseSchema, topDevicesResponseSchema, topLocationsResponseSchema, topPagesResponseSchema, topSourcesResponseSchema, topSourcesSchema, userEventsResponseSchema };
+export { Saasco, TinybirdJobResponseSchema, analyticsEventSchema, analyticsUserRawSchema, analyticsUserSchema, baseTopRequestSchema, browserContextSchema, coerceReservedProperties, contactPropertiesSchema, createTrackedEventTypeSchema, currentUsersRequestSchema, currentUsersResponseSchema, getAnalyticsUserParamsSchema, getBrowserContext, idenfitySchema, kpiSchema, kpisRequestSchema, kpisResponseSchema, latestEventItemSchema, latestEventsRequestSchema, latestEventsResponseSchema, latestIdentifiesRequestSchema, latestIdentifiesResponseSchema, listUsersParamsSchema, reservedPropertiesSchema, serverContextSchema, tbAny, timezones, tinyBirdBaseSchema, topActionsResponseSchema, topBrowsersResponseSchema, topDevicesResponseSchema, topLocationsResponseSchema, topPagesResponseSchema, topSourcesResponseSchema, topSourcesSchema, trackedEventSchema, trackedEventTypesSchema, userEventsResponseSchema };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "saasco-sdk",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "dependencies": {
     "tslib": "^2.3.0",
     "@lukeed/uuid": "^2.0.1",

package/src/index.d.ts

@@ -1,4 +1,6 @@
 export * from './lib/analytics';
 export * from './lib/coerceReservedProperties';
+export * from './lib/getBrowserContext';
 export * from './lib/timezones';
+export * from './lib/tracking';
 export * from './lib/types';

package/src/lib/analytics.d.ts

@@ -1,6 +1,7 @@
 declare global {
     interface Window {
         saascoAutoPageTrackingActive?: boolean;
+        saasco: Saasco;
     }
 }
 export declare class Saasco {
@@ -37,14 +38,14 @@ export declare class Saasco {
      */
     track(name: string, properties?: Record<string, any>, context?: {
         active?: boolean;
-    }): void | Promise<string | Response | undefined>;
+    }): void | Promise<any>;
     /**
      * The page method lets you record page views on your website
      * This records the page title and path and names the event useing the reserved property "Page Viewed"
      *
      * Before implementing this make sure you have disabled the autoPageTracking in the config or you will get duplicate page views
      */
-    page(): void | Promise<string | Response | undefined>;
+    page(): void | Promise<any>;
     /**
      * The identify method lets you tie a user to their actions and record traits about them.
      * We recommend you call this when the user logs in and when any traits get updated.

package/src/lib/getBrowserContext.d.ts

@@ -0,0 +1,2 @@
+import { BrowserContext } from './tracking/types';
+export declare function getBrowserContext(): BrowserContext | undefined;

package/src/lib/tracking/index.d.ts

@@ -0,0 +1 @@
+export * from './types';