@shware/analytics 3.6.2 → 3.6.4

package/dist/track/gtag.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/track/gtag.ts"],"sourcesContent":["/** reference: https://support.google.com/analytics/answer/13316687 */\nconst reservedWebEventNames = [\n  'app_remove',\n  'app_store_refund',\n  'app_store_subscription_cancel',\n  'app_store_subscription_renew',\n  'click',\n  'error',\n  'file_download',\n  'first_open',\n  'first_visit',\n  'form_start',\n  'form_submit',\n  'in_app_purchase',\n  'page_view',\n  'scroll',\n  'session_start',\n  'user_engagement',\n  'view_complete',\n  'video_progress',\n  'video_start',\n  'view_search_results',\n] as const;\n\nconst reservedAppEventNames = [\n  'ad_activeview',\n  'ad_click',\n  'ad_exposure',\n  'ad_impression',\n  'ad_query',\n  'ad_reward',\n  'adunit_exposure',\n  'app_clear_data',\n  'app_exception',\n  'app_install',\n  'app_remove',\n  'app_store_refund',\n  'app_update',\n  'app_upgrade',\n  'dynamic_link_app_open',\n  'dynamic_link_app_update',\n  'dynamic_link_first_open',\n  'error',\n  'firebase_campaign',\n  'firebase_in_app_message_action',\n  'firebase_in_app_message_dismiss',\n  'firebase_in_app_message_impression',\n  'first_open',\n  'first_visit',\n  'in_app_purchase',\n  'notification_dismiss',\n  'notification_foreground',\n  'notification_open',\n  'notification_receive',\n  'notification_send',\n  'os_update',\n  'screen_view',\n  'session_start',\n  'user_engagement',\n] as const;\n\nexport const reservedEventNames = [...reservedWebEventNames, ...reservedAppEventNames] as const;\n\ntype ReservedWebEventNames = (typeof reservedWebEventNames)[number];\ntype ReservedAppEventNames = (typeof reservedAppEventNames)[number];\nexport type ReservedEventNames = ReservedWebEventNames | ReservedAppEventNames;\n\nexport type ReservedEventValues =\n  | 'cid'\n  | 'currency'\n  | 'customer_id'\n  | 'customerid'\n  | 'dclid'\n  | 'gclid'\n  | 'session_id'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'srsltid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`\n  | `gtag.${string}`;\n\nexport type ReservedUserPropertiesNames =\n  | 'cid'\n  | 'customer_id'\n  | 'customerid'\n  | 'first_open_after_install'\n  | 'first_open_time'\n  | 'first_visit_time'\n  | 'google_allow_ad_personalization_signals'\n  | 'last_advertising_id_reset'\n  | 'last_deep_link_referrer'\n  | 'last_gclid'\n  | 'lifetime_user_engagement'\n  | 'non_personalized_ads'\n  | 'session_id'\n  | 'session_number'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`;\n\nexport type UserPropertiesValue = string | boolean | number | null | undefined;\nexport type UserProperties = {\n  [key: string]: UserPropertiesValue;\n} & {\n  [key in ReservedUserPropertiesNames]?: never;\n};\n\n/**\n * reference: https://support.google.com/analytics/answer/14078702\n * You must turn on user-provided data collection in Google Analytics.\n *\n * Validate your user-provided data implementation: https://support.google.com/analytics/answer/14171683\n *\n * Usage: gtag('set', 'user_data', { email: 'abc@abc.com' })\n *\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n * */\ntype UserProvidedDataAddress = {\n  first_name?: string;\n  last_name?: string;\n  street?: string;\n  city?: string;\n  /** User province, state, or region. Example: `Hampshire` */\n  region?: string;\n  postal_code?: string;\n  /**\n   * User country code.\n   * Example: 'UK'. Use 2-letter country codes, per the ISO 3166-1 alpha-2 standard.\n   */\n  country?: string;\n};\n\n/**\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n */\nexport type UserProvidedData = {\n  email?: string | string[];\n  /**\n   * User phone number. Must be in E.164 format, which means it must be 11 to 15 digits including a\n   * plus sign (+) prefix and country code with no dashes, parentheses, or spaces.\n   *\n   * Example: ‘+11231234567’\n   */\n  phone_number?: string | string[];\n  address?: UserProvidedDataAddress | UserProvidedDataAddress[];\n};\n\nexport type GaId = `G-${Uppercase<string>}`;\nexport type GtmId = `GTM-${Uppercase<string>}`;\n\nexport type CampaignMedium =\n  | 'email'\n  | 'organic'\n  | 'cpc'\n  | 'banner'\n  | 'social'\n  | 'referral'\n  | 'affiliate'\n  | 'video'\n  | 'display'\n  | 'sms'\n  | 'push'\n  | 'qr'\n  | 'audio'\n  | (string & {});\n\nexport type CampaignSource =\n  | 'google' // don't need to set\n  | 'googleads'\n  | 'bing'\n  | 'bingads'\n  | 'metaads'\n  | 'facebook'\n  | 'twitter'\n  | 'linkedin'\n  | 'instagram'\n  | 'tiktok'\n  | 'youtube'\n  | 'newsletter'\n  | `website_${string}`\n  | `affiliate_${string}`\n  | (string & {});\n\nexport type Campaign = {\n  id?: string;\n  name?: string;\n  term?: string;\n  content?: string;\n  medium?: CampaignMedium;\n  source?: CampaignSource;\n};\n\nexport type Config = {\n  allow_google_signals?: boolean;\n  allow_ad_personalization_signals?: boolean;\n\n  campaign_content?: string;\n  campaign_id?: string;\n  campaign_medium?: CampaignMedium;\n  campaign_name?: string;\n  campaign_source?: CampaignSource;\n  campaign_term?: string;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  campaign?: Campaign;\n\n  client_id?: string;\n  content_group?: string;\n\n  cookie_domain?: 'none' | 'auto' | string;\n  cookie_expires?: number;\n  cookie_flags?: string;\n  cookie_path?: string;\n  cookie_prefix?: string;\n  cookie_update?: boolean;\n\n  ignore_referrer?: boolean;\n  language?: string;\n\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n\n  send_page_view?: boolean;\n  screen_resolution?: `${number}x${number}`;\n  user_id?: string;\n  user_properties?: UserProperties;\n};\n\nexport type Item = {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n};\n\nexport type PromotionItem = {\n  creative_name?: string;\n  creative_slot?: string;\n  promotion_id?: string;\n  promotion_name?: string;\n};\n\nexport type SurveyProperties = {\n  id?: string;\n  feature?: Lowercase<string>;\n  trigger?: Lowercase<string>;\n};\n\nexport type SurveyQA = {\n  q1: string;\n  a1: string;\n  q2?: string;\n  a2?: string;\n  q3?: string;\n  a3?: string;\n  q4?: string;\n  a4?: string;\n  q5?: string;\n  a5?: string;\n  q6?: string;\n  a6?: string;\n  completed?: boolean;\n};\n\nexport type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | number;\nexport type CASTScore = 1 | 2 | 3 | 4 | 5 | number;\nexport type CESScore = 1 | 2 | 3 | 4 | 5 | number;\n\n/** ref: https://support.google.com/analytics/answer/9216061 */\nexport type EnhancedMeasurementEvents = {\n  page_view: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n    previous_page_path?: string;\n    engagement_time_msec?: number;\n  };\n  // Scrolls: the first time a user reaches the bottom of each page\n  // (i.e., when a 90% vertical depth becomes visible)\n  scroll: {\n    engagement_time_msec: number;\n  };\n  // Outbound clicks\n  click: {\n    link_id: string;\n    link_url: string;\n    link_text: string; // added\n    link_domain: string;\n    link_classes: string;\n    outbound: boolean;\n  };\n  // Site search\n  view_search_results: {\n    search_term: string;\n  };\n  // Video engagement\n  video_start: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_progress: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_complete: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  // File downloads:\n  file_download: {\n    file_extension: string;\n    file_name: string;\n    link_classes: string;\n    link_id: string;\n    link_text: string;\n    link_url: string;\n  };\n  // Form interactions\n  form_start: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n  };\n  form_submit: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n    form_submit_text: string;\n  };\n};\n\n/** ref: https://support.google.com/analytics/answer/9234069  */\nexport type AutomaticallyCollectedEvents = EnhancedMeasurementEvents & {\n  first_visit: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n  };\n  first_open: {\n    screen_name: string;\n    screen_class: string;\n  };\n  in_app_purchase: {\n    product_id: string;\n    price: number;\n    value: number;\n    currency: string;\n    quantity: number;\n    subscription?: boolean;\n    free_trial?: boolean;\n    introductory_price?: number;\n  };\n  notification_dismiss: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_foreground: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_open: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_receive: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  // Note: The 'screen_view' event is automatically sent only when using Android or iOS native SDKs.\n  // If you are using React Native, you need to send this event manually; it should not be ignored.\n  session_start: undefined;\n  user_engagement: {\n    engagement_time_msec: number;\n    trigger: 'pagehide' | 'visibilitychange' | 'background';\n  };\n};\n\n/**\n * ref: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n * ref: https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Event\n * */\nexport type RecommendedEvents = {\n  // Google Analytics 4 Recommended Events\n  add_payment_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    payment_type?: string;\n    items: Item[];\n  };\n  add_shipping_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    shipping_tier?: string;\n    items: Item[];\n  };\n  add_to_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  add_to_wishlist: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  begin_checkout: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    items: Item[];\n    source?: string; // added\n  };\n  close_convert_lead: {\n    currency: string;\n    value: number;\n  };\n  close_unconvert_lead: {\n    currency: string;\n    value: number;\n    unconvert_lead_reason?: string;\n  };\n  disqualify_lead: {\n    currency: string;\n    value: number;\n    disqualified_lead_reason?: string;\n  };\n  earn_virtual_currency: {\n    virtual_currency_name?: string;\n    value?: number;\n  };\n  generate_lead: {\n    currency: string;\n    value: number;\n    lead_source?: string;\n  };\n  join_group: {\n    group_id?: string;\n  };\n  level_end: {\n    level_name?: string;\n    success?: boolean;\n  };\n  level_start: {\n    level_name?: string;\n  };\n  level_up: {\n    level?: number;\n    level_name?: string;\n    character?: string;\n  };\n  login: {\n    method?:\n      | 'google'\n      | 'apple'\n      | 'facebook'\n      | 'twitter'\n      | 'linkedin'\n      | 'github'\n      | 'microsoft'\n      | 'wechat'\n      | 'onetap'\n      | 'phone'\n      | 'email'\n      | (string & {});\n    source?: string; // added\n  };\n  post_score: {\n    score: number;\n    level?: number;\n    character?: string;\n  };\n  purchase: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number; // Shipping cost associated with a transaction.\n    tax?: number;\n    items?: Item[];\n    source?: string; // added\n  };\n  qualify_lead: {\n    currency: string;\n    value: number;\n  };\n  refund: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number;\n    tax?: number;\n    items?: Item[];\n  };\n  remove_from_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  search: {\n    search_term: string;\n  };\n  select_content: {\n    content_type?: string;\n    content_id?: string;\n  };\n  select_item: {\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  select_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items?: (Item & PromotionItem)[];\n  };\n  share: {\n    method?: string;\n    content_type?: string;\n    item_id?: string;\n    system_activity_type?: string; // added\n    platform_post_id?: string; // added\n  };\n  sign_up: {\n    method?: string;\n    source?: string; // added\n  };\n  spend_virtual_currency: {\n    value: number;\n    virtual_currency_name: string;\n    item_name?: string;\n  };\n  tutorial_begin: undefined;\n  tutorial_complete: undefined;\n  unlock_achievement: {\n    achievement_id: string;\n  };\n  view_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item_list: {\n    currency: string;\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  view_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items: (Item & PromotionItem)[];\n  };\n  working_lead: {\n    currency: string;\n    value: number;\n    lead_status?: string;\n  };\n\n  // Firebase Analytics events, event_name 40 characters limit, 25 parameters limit\n  ad_impression: {\n    value?: number;\n    currency?: string;\n    ad_format?: string;\n    ad_platform?: string;\n    ad_source?: string;\n    ad_unit_name?: string;\n  };\n  app_open: undefined;\n  campaign_details: {\n    source: string;\n    medium: string;\n    campaign: string;\n    term?: string;\n    content?: string;\n    aclid?: string;\n    cp1?: string;\n  };\n  screen_view: {\n    screen_name?: string;\n    screen_class?: string;\n    previous_screen_class?: string; // added\n    engagement_time_msec?: number;\n  };\n};\n\n/**\n * Extra commonly used events that are NOT part of the GA standard event set.\n * Added to satisfy additional analytics needs.\n */\nexport type AddedRecommendedEvents = {\n  logout: undefined;\n  trial_begin: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  subscribe: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  // survey\n  survey_shown: SurveyProperties;\n  survey_sent: SurveyProperties & SurveyQA;\n  survey_dismissed: SurveyProperties;\n  /**\n   * Net promoter score: Get an industry-recognized benchmark\n   * How likely are you to recommend us to a friend?\n   * */\n  nps_shown: SurveyProperties;\n  nps_sent: SurveyProperties & { score: NPSScore; feedback?: string };\n  nps_dismissed: SurveyProperties;\n  /**\n   * Customer satisfaction score: Works best after a checkout or support flow\n   * How satisfied are you with xxx?\n   * */\n  cast_shown: SurveyProperties;\n  cast_sent: SurveyProperties & { score: CASTScore; feedback?: string };\n  cast_dismissed: SurveyProperties;\n  /**\n   * Customer effort score: Works well with churn surveys\n   * How easy is it to use the feature?\n   * */\n  ces_shown: SurveyProperties;\n  ces_sent: SurveyProperties & { score: CESScore; feedback?: string };\n  ces_dismissed: SurveyProperties;\n};\n\nexport type StandardEvents = AutomaticallyCollectedEvents &\n  RecommendedEvents &\n  AddedRecommendedEvents;\n\n/**\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/config\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n */\nexport interface Gtag {\n  /**\n   * To disable advertising features based on third-party advertising identifiers, set\n   * allow_google_signals to false.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow Google signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_google_signals', allow: boolean): void;\n\n  /**\n   * Set to false to disable advertising personalization features.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow ad personalization signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_ad_personalization_signals', allow: boolean): void;\n\n  /**\n   * Used for A/B testing and content-targeted ads. Use campaign_content to differentiate ads or\n   * links that point to the same URL.\n   */\n  gtag(event: 'set', option: 'campaign_content', content: string): void;\n\n  /**\n   * Used to identify which campaign this referral references. Use campaign_id to identify a\n   * specific campaign.\n   */\n  gtag(event: 'set', option: 'campaign_id', id: string): void;\n\n  /** Use campaign_medium to identify a medium such as email or cost-per-click. */\n  gtag(event: 'set', option: 'campaign_medium', medium: CampaignMedium): void;\n\n  /**\n   * Used for keyword analysis. Use campaign_name to identify a specific product promotion or\n   * strategic campaign.\n   */\n  gtag(event: 'set', option: 'campaign_name', name: string): void;\n\n  /** Use campaign_source to identify a search engine, newsletter name, or other source. */\n  gtag(event: 'set', option: 'campaign_source', source: CampaignSource): void;\n\n  /** Used for paid search. Use campaign_term to note the keywords for this ad. */\n  gtag(event: 'set', option: 'campaign_term', term: string): void;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  gtag(event: 'set', option: 'campaign', params: Campaign): void;\n\n  /**\n   * Pseudonymously identifies a browser instance. By default, this value is stored as part of the\n   * first-party Analytics cookie with a two-year expiration.\n   */\n  gtag(event: 'set', option: 'client_id', id: string): void;\n\n  /** example: gtag('set', 'content_group', '/news/sports'); */\n  gtag(event: 'set', option: 'content_group', group: string): void;\n\n  /**\n   * Specifies the domain used to store the analytics cookie.\n   * Set to 'none' to set the cookie without specifying a domain.\n   * Set to 'auto' (the default value) to set the cookie to the top level domain plus one\n   * subdomain (eTLD +1). For example, if cookie_domain is set to 'auto' https://example.com would\n   * use example.com for the domain, and https://subdomain.example.com would also use example.com\n   * for the domain.\n   *\n   * @param event\n   * @param option\n   * @param domain - The domain used to store the analytics cookie.\n   * @default 'auto'\n   */\n  gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | string): void;\n\n  /**\n   * Every time a hit is sent to Google Analytics, the cookie expiration time is updated to be the\n   * current time plus the value of the cookie_expires field. This means that if you use the default\n   * value time of two years (63,072,000 seconds), and a user visits your site every month, their\n   * cookie will never expire.\n   *\n   * If you set the cookie_expires time to 0 (zero) seconds, the cookie turns into a session-based\n   * cookie and expires once the current browser session ends.\n   *\n   * Caution: If you set the cookie to expire too quickly, you will inflate your user count and\n   * decrease the quality of your measurement.\n   *\n   * @param event\n   * @param option\n   * @param expires - The number of seconds until the cookie expires.\n   * @default 63072000\n   */\n  gtag(event: 'set', option: 'cookie_expires', expires: number): void;\n\n  /**\n   * Appends additional flags to the cookie when set. Flags must be separated by semicolons. See\n   * [write a new cookie](https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie#write_a_new_cookie) for some examples of flags to set.\n   */\n  gtag(event: 'set', option: 'cookie_flags', flags: string): void;\n\n  /** Specifies the subpath used to store the analytics cookie. */\n  gtag(event: 'set', option: 'cookie_path', path: string): void;\n\n  /** Specifies a prefix to prepend to analytics cookie names. */\n  gtag(event: 'set', option: 'cookie_prefix', prefix: string): void;\n\n  /**\n   * When cookie_update is set to true, gtag.js will update cookies on each page load. This will\n   * update the cookie expiration to be set relative to the most recent visit to the site. For\n   * example, if cookie expiration is set to one week, and a user visits using the same browser\n   * every five days, the cookie expiration will be updated on each visit and will effectively\n   * never expire.\n   *\n   * When set to false, cookies are not updated on each page load. This has the effect of cookie\n   * expiration being relative to the first time a user visited the site.\n   *\n   * @param event\n   * @param option\n   * @param update - Whether to update the cookie on each page load.\n   * @default true\n   */\n  gtag(event: 'set', option: 'cookie_update', update: boolean): void;\n\n  /**\n   * Set to true to indicate to Analytics that the referrer shouldn't be displayed as a traffic\n   * source. [Learn when to use this field](https://support.google.com/analytics/answer/10327750#set-parameter)\n   *\n   * @param event\n   * @param option\n   * @param ignore - Whether to ignore the referrer.\n   * @default false\n   */\n  gtag(event: 'set', option: 'ignore_referrer', ignore: boolean): void;\n\n  /**\n   * Specifies the language preference of the user. Defaults to the user's `navigator.language` value.\n   *\n   * @param event\n   * @param option\n   * @param language - The language preference of the user.\n   * @default navigator.language\n   */\n  gtag(event: 'set', option: 'language', language: string): void;\n\n  /**\n   * Specifies the full URL of the page. Defaults to the user's `document.location` value.\n   *\n   * @param event\n   * @param option\n   * @param location - The full URL of the page. Character limit 1000\n   * @default document.location\n   */\n  gtag(event: 'set', option: 'page_location', location: string): void;\n\n  /**\n   * Specifies which referral source brought traffic to a page. This value is also used to compute\n   * the traffic source. The format of this value is a URL. Defaults to the user's `document.referrer`\n   * value.\n   *\n   * @param event\n   * @param option\n   * @param referrer - The referral source. Character limit 420\n   * @default document.referrer\n   */\n  gtag(event: 'set', option: 'page_referrer', referrer: string): void;\n\n  /**\n   * The title of the page or document. Defaults to the user's `document.title` value.\n   *\n   * @param event\n   * @param option\n   * @param title - The title of the page or document. Character limit 300\n   * @default document.title\n   */\n  gtag(event: 'set', option: 'page_title', title: string): void;\n\n  /**\n   * Set to false to prevent the default snippet from sending a page_view.\n   *\n   * @param event\n   * @param option\n   * @param send - Whether to send a page_view.\n   * @default true\n   */\n  gtag(event: 'set', option: 'send_page_view', send: boolean): void;\n\n  /**\n   * Specifies the resolution of the screen. Should be two positive integers separated by an x. For\n   * example, for an 800px by 600px screen, the value would be 800x600. Calculated from the user's\n   * window.screen value.\n   *\n   * @param event\n   * @param option\n   * @param resolution - The resolution of the screen.\n   * @default window.screen\n   */\n  gtag(event: 'set', option: 'screen_resolution', resolution: `${number}x${number}`): void;\n\n  /**\n   * Specifies a known identifier for a user provided by the site owner/library user. It must not\n   * itself be PII (personally identifiable information). The value should never be persisted in\n   * Google Analytics cookies or other Analytics-provided storage.\n   *\n   * @param event\n   * @param option\n   * @param userId - The user ID. Character limit 256\n   */\n  gtag(event: 'set', option: 'user_id', userId: string): void;\n\n  /**\n   * User properties are attributes that can be used to describe segments of your user base, such\n   * as language preference or geographic location. Up to 25 additional user properties can be set\n   * per project.\n   *\n   * @param event\n   * @param option\n   * @param properties\n   */\n  gtag(event: 'set', option: 'user_properties', properties: UserProperties): void;\n\n  gtag(event: 'set', option: 'user_data', data: UserProvidedData): void;\n\n  /**\n   * gtag('config', ...) Set for a single stream\n   * gtag('set', ...) Set globally\n   */\n  gtag(event: 'config', gaId: GaId, config?: Config): void;\n\n  gtag<T extends string>(\n    event: 'event',\n    eventName: T extends keyof StandardEvents ? T : string,\n    eventParams?: T extends keyof StandardEvents\n      ? StandardEvents[T]\n      : Record<string, string | number | boolean | null | undefined>\n  ): void;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,qBAAqB,CAAC,GAAG,uBAAuB,GAAG,qBAAqB;","names":[]}
+{"version":3,"sources":["../../src/track/gtag.ts"],"sourcesContent":["/** reference: https://support.google.com/analytics/answer/13316687 */\nconst reservedWebEventNames = [\n  'app_remove',\n  'app_store_refund',\n  'app_store_subscription_cancel',\n  'app_store_subscription_renew',\n  'click',\n  'error',\n  'file_download',\n  'first_open',\n  'first_visit',\n  'form_start',\n  'form_submit',\n  'in_app_purchase',\n  'page_view',\n  'scroll',\n  'session_start',\n  'user_engagement',\n  'view_complete',\n  'video_progress',\n  'video_start',\n  'view_search_results',\n] as const;\n\nconst reservedAppEventNames = [\n  'ad_activeview',\n  'ad_click',\n  'ad_exposure',\n  'ad_impression',\n  'ad_query',\n  'ad_reward',\n  'adunit_exposure',\n  'app_clear_data',\n  'app_exception',\n  'app_install',\n  'app_remove',\n  'app_store_refund',\n  'app_update',\n  'app_upgrade',\n  'dynamic_link_app_open',\n  'dynamic_link_app_update',\n  'dynamic_link_first_open',\n  'error',\n  'firebase_campaign',\n  'firebase_in_app_message_action',\n  'firebase_in_app_message_dismiss',\n  'firebase_in_app_message_impression',\n  'first_open',\n  'first_visit',\n  'in_app_purchase',\n  'notification_dismiss',\n  'notification_foreground',\n  'notification_open',\n  'notification_receive',\n  'notification_send',\n  'os_update',\n  'screen_view',\n  'session_start',\n  'user_engagement',\n] as const;\n\nexport const reservedEventNames = [...reservedWebEventNames, ...reservedAppEventNames] as const;\n\ntype ReservedWebEventNames = (typeof reservedWebEventNames)[number];\ntype ReservedAppEventNames = (typeof reservedAppEventNames)[number];\nexport type ReservedEventNames = ReservedWebEventNames | ReservedAppEventNames;\n\nexport type ReservedEventValues =\n  | 'cid'\n  | 'currency'\n  | 'customer_id'\n  | 'customerid'\n  | 'dclid'\n  | 'gclid'\n  | 'session_id'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'srsltid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`\n  | `gtag.${string}`;\n\nexport type ReservedUserPropertiesNames =\n  | 'cid'\n  | 'customer_id'\n  | 'customerid'\n  | 'first_open_after_install'\n  | 'first_open_time'\n  | 'first_visit_time'\n  | 'google_allow_ad_personalization_signals'\n  | 'last_advertising_id_reset'\n  | 'last_deep_link_referrer'\n  | 'last_gclid'\n  | 'lifetime_user_engagement'\n  | 'non_personalized_ads'\n  | 'session_id'\n  | 'session_number'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`;\n\nexport type UserPropertiesValue = string | boolean | number | null | undefined;\nexport type UserProperties = {\n  [key: string]: UserPropertiesValue;\n} & {\n  [key in ReservedUserPropertiesNames]?: never;\n};\n\n/**\n * reference: https://support.google.com/analytics/answer/14078702\n * You must turn on user-provided data collection in Google Analytics.\n *\n * Validate your user-provided data implementation: https://support.google.com/analytics/answer/14171683\n *\n * Usage: gtag('set', 'user_data', { email: 'abc@abc.com' })\n *\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n * */\ntype UserProvidedDataAddress = {\n  first_name?: string;\n  last_name?: string;\n  street?: string;\n  city?: string;\n  /** User province, state, or region. Example: `Hampshire` */\n  region?: string;\n  postal_code?: string;\n  /**\n   * User country code.\n   * Example: 'UK'. Use 2-letter country codes, per the ISO 3166-1 alpha-2 standard.\n   */\n  country?: string;\n};\n\n/**\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n */\nexport type UserProvidedData = {\n  email?: string | string[];\n  /**\n   * User phone number. Must be in E.164 format, which means it must be 11 to 15 digits including a\n   * plus sign (+) prefix and country code with no dashes, parentheses, or spaces.\n   *\n   * Example: ‘+11231234567’\n   */\n  phone_number?: string | string[];\n  address?: UserProvidedDataAddress | UserProvidedDataAddress[];\n};\n\nexport type GaId = `G-${Uppercase<string>}`;\nexport type GtmId = `GTM-${Uppercase<string>}`;\n\nexport type CampaignMedium =\n  | 'email'\n  | 'organic'\n  | 'cpc'\n  | 'banner'\n  | 'social'\n  | 'referral'\n  | 'affiliate'\n  | 'video'\n  | 'display'\n  | 'sms'\n  | 'push'\n  | 'qr'\n  | 'audio'\n  | (string & {});\n\nexport type CampaignSource =\n  | 'google' // don't need to set\n  | 'googleads'\n  | 'bing'\n  | 'bingads'\n  | 'metaads'\n  | 'facebook'\n  | 'twitter'\n  | 'linkedin'\n  | 'instagram'\n  | 'tiktok'\n  | 'youtube'\n  | 'newsletter'\n  | `website_${string}`\n  | `affiliate_${string}`\n  | (string & {});\n\nexport type Campaign = {\n  id?: string;\n  name?: string;\n  term?: string;\n  content?: string;\n  medium?: CampaignMedium;\n  source?: CampaignSource;\n};\n\nexport type Config = {\n  allow_google_signals?: boolean;\n  allow_ad_personalization_signals?: boolean;\n\n  campaign_content?: string;\n  campaign_id?: string;\n  campaign_medium?: CampaignMedium;\n  campaign_name?: string;\n  campaign_source?: CampaignSource;\n  campaign_term?: string;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  campaign?: Campaign;\n\n  client_id?: string;\n  content_group?: string;\n\n  cookie_domain?: 'none' | 'auto' | (string & {});\n  cookie_expires?: number;\n  cookie_flags?: string;\n  cookie_path?: string;\n  cookie_prefix?: string;\n  cookie_update?: boolean;\n\n  ignore_referrer?: boolean;\n  language?: string;\n\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n\n  send_page_view?: boolean;\n  screen_resolution?: `${number}x${number}`;\n  user_id?: string;\n  user_properties?: UserProperties;\n};\n\nexport type Item = {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n};\n\nexport type PromotionItem = {\n  creative_name?: string;\n  creative_slot?: string;\n  promotion_id?: string;\n  promotion_name?: string;\n};\n\nexport type SurveyProperties = {\n  id?: string;\n  feature?: Lowercase<string>;\n  trigger?: Lowercase<string>;\n};\n\nexport type SurveyQA = {\n  q1: string;\n  a1: string;\n  q2?: string;\n  a2?: string;\n  q3?: string;\n  a3?: string;\n  q4?: string;\n  a4?: string;\n  q5?: string;\n  a5?: string;\n  q6?: string;\n  a6?: string;\n  completed?: boolean;\n};\n\nexport type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | (number & {});\nexport type CASTScore = 1 | 2 | 3 | 4 | 5 | (number & {});\nexport type CESScore = 1 | 2 | 3 | 4 | 5 | (number & {});\n\n/** ref: https://support.google.com/analytics/answer/9216061 */\nexport type EnhancedMeasurementEvents = {\n  page_view: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n    previous_page_path?: string;\n    engagement_time_msec?: number;\n  };\n  // Scrolls: the first time a user reaches the bottom of each page\n  // (i.e., when a 90% vertical depth becomes visible)\n  scroll: {\n    engagement_time_msec: number;\n  };\n  // Outbound clicks\n  click: {\n    link_id: string;\n    link_url: string;\n    link_text: string; // added\n    link_domain: string;\n    link_classes: string;\n    outbound: boolean;\n  };\n  // Site search\n  view_search_results: {\n    search_term: string;\n  };\n  // Video engagement\n  video_start: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_progress: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_complete: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  // File downloads:\n  file_download: {\n    file_extension: string;\n    file_name: string;\n    link_classes: string;\n    link_id: string;\n    link_text: string;\n    link_url: string;\n  };\n  // Form interactions\n  form_start: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n  };\n  form_submit: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n    form_submit_text: string;\n  };\n};\n\n/** ref: https://support.google.com/analytics/answer/9234069  */\nexport type AutomaticallyCollectedEvents = EnhancedMeasurementEvents & {\n  first_visit: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n  };\n  first_open: {\n    screen_name: string;\n    screen_class: string;\n  };\n  in_app_purchase: {\n    product_id: string;\n    price: number;\n    value: number;\n    currency: string;\n    quantity: number;\n    subscription?: boolean;\n    free_trial?: boolean;\n    introductory_price?: number;\n  };\n  notification_dismiss: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_foreground: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_open: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_receive: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  // Note: The 'screen_view' event is automatically sent only when using Android or iOS native SDKs.\n  // If you are using React Native, you need to send this event manually; it should not be ignored.\n  session_start: undefined;\n  user_engagement: {\n    engagement_time_msec: number;\n    trigger: 'pagehide' | 'visibilitychange' | 'background';\n  };\n};\n\n/**\n * ref: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n * ref: https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Event\n * */\nexport type RecommendedEvents = {\n  // Google Analytics 4 Recommended Events\n  add_payment_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    payment_type?: string;\n    items: Item[];\n  };\n  add_shipping_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    shipping_tier?: string;\n    items: Item[];\n  };\n  add_to_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  add_to_wishlist: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  begin_checkout: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    items: Item[];\n    source?: string; // added\n  };\n  close_convert_lead: {\n    currency: string;\n    value: number;\n  };\n  close_unconvert_lead: {\n    currency: string;\n    value: number;\n    unconvert_lead_reason?: string;\n  };\n  disqualify_lead: {\n    currency: string;\n    value: number;\n    disqualified_lead_reason?: string;\n  };\n  earn_virtual_currency: {\n    virtual_currency_name?: string;\n    value?: number;\n  };\n  generate_lead: {\n    currency: string;\n    value: number;\n    lead_source?: string;\n  };\n  join_group: {\n    group_id?: string;\n  };\n  level_end: {\n    level_name?: string;\n    success?: boolean;\n  };\n  level_start: {\n    level_name?: string;\n  };\n  level_up: {\n    level?: number;\n    level_name?: string;\n    character?: string;\n  };\n  login: {\n    method?:\n      | 'google'\n      | 'apple'\n      | 'facebook'\n      | 'twitter'\n      | 'linkedin'\n      | 'github'\n      | 'microsoft'\n      | 'wechat'\n      | 'onetap'\n      | 'phone'\n      | 'email'\n      | (string & {});\n    source?: string; // added\n  };\n  post_score: {\n    score: number;\n    level?: number;\n    character?: string;\n  };\n  purchase: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number; // Shipping cost associated with a transaction.\n    tax?: number;\n    items?: Item[];\n    source?: string; // added\n  };\n  qualify_lead: {\n    currency: string;\n    value: number;\n  };\n  refund: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number;\n    tax?: number;\n    items?: Item[];\n  };\n  remove_from_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  search: {\n    search_term: string;\n  };\n  select_content: {\n    content_type?: string;\n    content_id?: string;\n  };\n  select_item: {\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  select_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items?: (Item & PromotionItem)[];\n  };\n  share: {\n    method?: string;\n    content_type?: string;\n    item_id?: string;\n    system_activity_type?: string; // added\n    platform_post_id?: string; // added\n  };\n  sign_up: {\n    method?: string;\n    source?: string; // added\n  };\n  spend_virtual_currency: {\n    value: number;\n    virtual_currency_name: string;\n    item_name?: string;\n  };\n  tutorial_begin: undefined;\n  tutorial_complete: undefined;\n  unlock_achievement: {\n    achievement_id: string;\n  };\n  view_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item_list: {\n    currency: string;\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  view_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items: (Item & PromotionItem)[];\n  };\n  working_lead: {\n    currency: string;\n    value: number;\n    lead_status?: string;\n  };\n\n  // Firebase Analytics events, event_name 40 characters limit, 25 parameters limit\n  ad_impression: {\n    value?: number;\n    currency?: string;\n    ad_format?: string;\n    ad_platform?: string;\n    ad_source?: string;\n    ad_unit_name?: string;\n  };\n  app_open: undefined;\n  campaign_details: {\n    source: string;\n    medium: string;\n    campaign: string;\n    term?: string;\n    content?: string;\n    aclid?: string;\n    cp1?: string;\n  };\n  screen_view: {\n    screen_name?: string;\n    screen_class?: string;\n    previous_screen_class?: string; // added\n    engagement_time_msec?: number;\n  };\n};\n\n/**\n * Extra commonly used events that are NOT part of the GA standard event set.\n * Added to satisfy additional analytics needs.\n */\nexport type AddedRecommendedEvents = {\n  logout: undefined;\n  trial_begin: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  subscribe: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  // survey\n  survey_shown: SurveyProperties;\n  survey_sent: SurveyProperties & SurveyQA;\n  survey_dismissed: SurveyProperties;\n  /**\n   * Net promoter score: Get an industry-recognized benchmark\n   * How likely are you to recommend us to a friend?\n   * */\n  nps_shown: SurveyProperties;\n  nps_sent: SurveyProperties & { score: NPSScore; feedback?: string };\n  nps_dismissed: SurveyProperties;\n  /**\n   * Customer satisfaction score: Works best after a checkout or support flow\n   * How satisfied are you with xxx?\n   * */\n  cast_shown: SurveyProperties;\n  cast_sent: SurveyProperties & { score: CASTScore; feedback?: string };\n  cast_dismissed: SurveyProperties;\n  /**\n   * Customer effort score: Works well with churn surveys\n   * How easy is it to use the feature?\n   * */\n  ces_shown: SurveyProperties;\n  ces_sent: SurveyProperties & { score: CESScore; feedback?: string };\n  ces_dismissed: SurveyProperties;\n};\n\nexport type StandardEvents = AutomaticallyCollectedEvents &\n  RecommendedEvents &\n  AddedRecommendedEvents;\n\n/**\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/config\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n */\nexport interface Gtag {\n  /**\n   * To disable advertising features based on third-party advertising identifiers, set\n   * allow_google_signals to false.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow Google signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_google_signals', allow: boolean): void;\n\n  /**\n   * Set to false to disable advertising personalization features.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow ad personalization signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_ad_personalization_signals', allow: boolean): void;\n\n  /**\n   * Used for A/B testing and content-targeted ads. Use campaign_content to differentiate ads or\n   * links that point to the same URL.\n   */\n  gtag(event: 'set', option: 'campaign_content', content: string): void;\n\n  /**\n   * Used to identify which campaign this referral references. Use campaign_id to identify a\n   * specific campaign.\n   */\n  gtag(event: 'set', option: 'campaign_id', id: string): void;\n\n  /** Use campaign_medium to identify a medium such as email or cost-per-click. */\n  gtag(event: 'set', option: 'campaign_medium', medium: CampaignMedium): void;\n\n  /**\n   * Used for keyword analysis. Use campaign_name to identify a specific product promotion or\n   * strategic campaign.\n   */\n  gtag(event: 'set', option: 'campaign_name', name: string): void;\n\n  /** Use campaign_source to identify a search engine, newsletter name, or other source. */\n  gtag(event: 'set', option: 'campaign_source', source: CampaignSource): void;\n\n  /** Used for paid search. Use campaign_term to note the keywords for this ad. */\n  gtag(event: 'set', option: 'campaign_term', term: string): void;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  gtag(event: 'set', option: 'campaign', params: Campaign): void;\n\n  /**\n   * Pseudonymously identifies a browser instance. By default, this value is stored as part of the\n   * first-party Analytics cookie with a two-year expiration.\n   */\n  gtag(event: 'set', option: 'client_id', id: string): void;\n\n  /** example: gtag('set', 'content_group', '/news/sports'); */\n  gtag(event: 'set', option: 'content_group', group: string): void;\n\n  /**\n   * Specifies the domain used to store the analytics cookie.\n   * Set to 'none' to set the cookie without specifying a domain.\n   * Set to 'auto' (the default value) to set the cookie to the top level domain plus one\n   * subdomain (eTLD +1). For example, if cookie_domain is set to 'auto' https://example.com would\n   * use example.com for the domain, and https://subdomain.example.com would also use example.com\n   * for the domain.\n   *\n   * @param event\n   * @param option\n   * @param domain - The domain used to store the analytics cookie.\n   * @default 'auto'\n   */\n  gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | (string & {})): void;\n\n  /**\n   * Every time a hit is sent to Google Analytics, the cookie expiration time is updated to be the\n   * current time plus the value of the cookie_expires field. This means that if you use the default\n   * value time of two years (63,072,000 seconds), and a user visits your site every month, their\n   * cookie will never expire.\n   *\n   * If you set the cookie_expires time to 0 (zero) seconds, the cookie turns into a session-based\n   * cookie and expires once the current browser session ends.\n   *\n   * Caution: If you set the cookie to expire too quickly, you will inflate your user count and\n   * decrease the quality of your measurement.\n   *\n   * @param event\n   * @param option\n   * @param expires - The number of seconds until the cookie expires.\n   * @default 63072000\n   */\n  gtag(event: 'set', option: 'cookie_expires', expires: number): void;\n\n  /**\n   * Appends additional flags to the cookie when set. Flags must be separated by semicolons. See\n   * [write a new cookie](https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie#write_a_new_cookie) for some examples of flags to set.\n   */\n  gtag(event: 'set', option: 'cookie_flags', flags: string): void;\n\n  /** Specifies the subpath used to store the analytics cookie. */\n  gtag(event: 'set', option: 'cookie_path', path: string): void;\n\n  /** Specifies a prefix to prepend to analytics cookie names. */\n  gtag(event: 'set', option: 'cookie_prefix', prefix: string): void;\n\n  /**\n   * When cookie_update is set to true, gtag.js will update cookies on each page load. This will\n   * update the cookie expiration to be set relative to the most recent visit to the site. For\n   * example, if cookie expiration is set to one week, and a user visits using the same browser\n   * every five days, the cookie expiration will be updated on each visit and will effectively\n   * never expire.\n   *\n   * When set to false, cookies are not updated on each page load. This has the effect of cookie\n   * expiration being relative to the first time a user visited the site.\n   *\n   * @param event\n   * @param option\n   * @param update - Whether to update the cookie on each page load.\n   * @default true\n   */\n  gtag(event: 'set', option: 'cookie_update', update: boolean): void;\n\n  /**\n   * Set to true to indicate to Analytics that the referrer shouldn't be displayed as a traffic\n   * source. [Learn when to use this field](https://support.google.com/analytics/answer/10327750#set-parameter)\n   *\n   * @param event\n   * @param option\n   * @param ignore - Whether to ignore the referrer.\n   * @default false\n   */\n  gtag(event: 'set', option: 'ignore_referrer', ignore: boolean): void;\n\n  /**\n   * Specifies the language preference of the user. Defaults to the user's `navigator.language` value.\n   *\n   * @param event\n   * @param option\n   * @param language - The language preference of the user.\n   * @default navigator.language\n   */\n  gtag(event: 'set', option: 'language', language: string): void;\n\n  /**\n   * Specifies the full URL of the page. Defaults to the user's `document.location` value.\n   *\n   * @param event\n   * @param option\n   * @param location - The full URL of the page. Character limit 1000\n   * @default document.location\n   */\n  gtag(event: 'set', option: 'page_location', location: string): void;\n\n  /**\n   * Specifies which referral source brought traffic to a page. This value is also used to compute\n   * the traffic source. The format of this value is a URL. Defaults to the user's `document.referrer`\n   * value.\n   *\n   * @param event\n   * @param option\n   * @param referrer - The referral source. Character limit 420\n   * @default document.referrer\n   */\n  gtag(event: 'set', option: 'page_referrer', referrer: string): void;\n\n  /**\n   * The title of the page or document. Defaults to the user's `document.title` value.\n   *\n   * @param event\n   * @param option\n   * @param title - The title of the page or document. Character limit 300\n   * @default document.title\n   */\n  gtag(event: 'set', option: 'page_title', title: string): void;\n\n  /**\n   * Set to false to prevent the default snippet from sending a page_view.\n   *\n   * @param event\n   * @param option\n   * @param send - Whether to send a page_view.\n   * @default true\n   */\n  gtag(event: 'set', option: 'send_page_view', send: boolean): void;\n\n  /**\n   * Specifies the resolution of the screen. Should be two positive integers separated by an x. For\n   * example, for an 800px by 600px screen, the value would be 800x600. Calculated from the user's\n   * window.screen value.\n   *\n   * @param event\n   * @param option\n   * @param resolution - The resolution of the screen.\n   * @default window.screen\n   */\n  gtag(event: 'set', option: 'screen_resolution', resolution: `${number}x${number}`): void;\n\n  /**\n   * Specifies a known identifier for a user provided by the site owner/library user. It must not\n   * itself be PII (personally identifiable information). The value should never be persisted in\n   * Google Analytics cookies or other Analytics-provided storage.\n   *\n   * @param event\n   * @param option\n   * @param userId - The user ID. Character limit 256\n   */\n  gtag(event: 'set', option: 'user_id', userId: string): void;\n\n  /**\n   * User properties are attributes that can be used to describe segments of your user base, such\n   * as language preference or geographic location. Up to 25 additional user properties can be set\n   * per project.\n   *\n   * @param event\n   * @param option\n   * @param properties\n   */\n  gtag(event: 'set', option: 'user_properties', properties: UserProperties): void;\n\n  gtag(event: 'set', option: 'user_data', data: UserProvidedData): void;\n\n  /**\n   * gtag('config', ...) Set for a single stream\n   * gtag('set', ...) Set globally\n   */\n  gtag(event: 'config', gaId: GaId, config?: Config): void;\n\n  gtag<T extends string>(\n    event: 'event',\n    eventName: T extends keyof StandardEvents ? T : string,\n    eventParams?: T extends keyof StandardEvents\n      ? StandardEvents[T]\n      : Record<string, string | number | boolean | null | undefined>\n  ): void;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AACA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,qBAAqB,CAAC,GAAG,uBAAuB,GAAG,qBAAqB;","names":[]}

package/dist/track/gtag.d.cts

@@ -89,7 +89,7 @@ type Config = {
     campaign?: Campaign;
     client_id?: string;
     content_group?: string;
-    cookie_domain?: 'none' | 'auto' | string;
+    cookie_domain?: 'none' | 'auto' | (string & {});
     cookie_expires?: number;
     cookie_flags?: string;
     cookie_path?: string;
@@ -151,9 +151,9 @@ type SurveyQA = {
     a6?: string;
     completed?: boolean;
 };
-type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | number;
-type CASTScore = 1 | 2 | 3 | 4 | 5 | number;
-type CESScore = 1 | 2 | 3 | 4 | 5 | number;
+type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | (number & {});
+type CASTScore = 1 | 2 | 3 | 4 | 5 | (number & {});
+type CESScore = 1 | 2 | 3 | 4 | 5 | (number & {});
 /** ref: https://support.google.com/analytics/answer/9216061 */
 type EnhancedMeasurementEvents = {
     page_view: {
@@ -618,7 +618,7 @@ interface Gtag {
      * @param domain - The domain used to store the analytics cookie.
      * @default 'auto'
      */
-    gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | string): void;
+    gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | (string & {})): void;
     /**
      * Every time a hit is sent to Google Analytics, the cookie expiration time is updated to be the
      * current time plus the value of the cookie_expires field. This means that if you use the default

package/dist/track/gtag.d.ts

@@ -89,7 +89,7 @@ type Config = {
     campaign?: Campaign;
     client_id?: string;
     content_group?: string;
-    cookie_domain?: 'none' | 'auto' | string;
+    cookie_domain?: 'none' | 'auto' | (string & {});
     cookie_expires?: number;
     cookie_flags?: string;
     cookie_path?: string;
@@ -151,9 +151,9 @@ type SurveyQA = {
     a6?: string;
     completed?: boolean;
 };
-type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | number;
-type CASTScore = 1 | 2 | 3 | 4 | 5 | number;
-type CESScore = 1 | 2 | 3 | 4 | 5 | number;
+type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | (number & {});
+type CASTScore = 1 | 2 | 3 | 4 | 5 | (number & {});
+type CESScore = 1 | 2 | 3 | 4 | 5 | (number & {});
 /** ref: https://support.google.com/analytics/answer/9216061 */
 type EnhancedMeasurementEvents = {
     page_view: {
@@ -618,7 +618,7 @@ interface Gtag {
      * @param domain - The domain used to store the analytics cookie.
      * @default 'auto'
      */
-    gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | string): void;
+    gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | (string & {})): void;
     /**
      * Every time a hit is sent to Google Analytics, the cookie expiration time is updated to be the
      * current time plus the value of the cookie_expires field. This means that if you use the default

package/dist/track/gtag.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/track/gtag.ts"],"sourcesContent":["/** reference: https://support.google.com/analytics/answer/13316687 */\nconst reservedWebEventNames = [\n  'app_remove',\n  'app_store_refund',\n  'app_store_subscription_cancel',\n  'app_store_subscription_renew',\n  'click',\n  'error',\n  'file_download',\n  'first_open',\n  'first_visit',\n  'form_start',\n  'form_submit',\n  'in_app_purchase',\n  'page_view',\n  'scroll',\n  'session_start',\n  'user_engagement',\n  'view_complete',\n  'video_progress',\n  'video_start',\n  'view_search_results',\n] as const;\n\nconst reservedAppEventNames = [\n  'ad_activeview',\n  'ad_click',\n  'ad_exposure',\n  'ad_impression',\n  'ad_query',\n  'ad_reward',\n  'adunit_exposure',\n  'app_clear_data',\n  'app_exception',\n  'app_install',\n  'app_remove',\n  'app_store_refund',\n  'app_update',\n  'app_upgrade',\n  'dynamic_link_app_open',\n  'dynamic_link_app_update',\n  'dynamic_link_first_open',\n  'error',\n  'firebase_campaign',\n  'firebase_in_app_message_action',\n  'firebase_in_app_message_dismiss',\n  'firebase_in_app_message_impression',\n  'first_open',\n  'first_visit',\n  'in_app_purchase',\n  'notification_dismiss',\n  'notification_foreground',\n  'notification_open',\n  'notification_receive',\n  'notification_send',\n  'os_update',\n  'screen_view',\n  'session_start',\n  'user_engagement',\n] as const;\n\nexport const reservedEventNames = [...reservedWebEventNames, ...reservedAppEventNames] as const;\n\ntype ReservedWebEventNames = (typeof reservedWebEventNames)[number];\ntype ReservedAppEventNames = (typeof reservedAppEventNames)[number];\nexport type ReservedEventNames = ReservedWebEventNames | ReservedAppEventNames;\n\nexport type ReservedEventValues =\n  | 'cid'\n  | 'currency'\n  | 'customer_id'\n  | 'customerid'\n  | 'dclid'\n  | 'gclid'\n  | 'session_id'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'srsltid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`\n  | `gtag.${string}`;\n\nexport type ReservedUserPropertiesNames =\n  | 'cid'\n  | 'customer_id'\n  | 'customerid'\n  | 'first_open_after_install'\n  | 'first_open_time'\n  | 'first_visit_time'\n  | 'google_allow_ad_personalization_signals'\n  | 'last_advertising_id_reset'\n  | 'last_deep_link_referrer'\n  | 'last_gclid'\n  | 'lifetime_user_engagement'\n  | 'non_personalized_ads'\n  | 'session_id'\n  | 'session_number'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`;\n\nexport type UserPropertiesValue = string | boolean | number | null | undefined;\nexport type UserProperties = {\n  [key: string]: UserPropertiesValue;\n} & {\n  [key in ReservedUserPropertiesNames]?: never;\n};\n\n/**\n * reference: https://support.google.com/analytics/answer/14078702\n * You must turn on user-provided data collection in Google Analytics.\n *\n * Validate your user-provided data implementation: https://support.google.com/analytics/answer/14171683\n *\n * Usage: gtag('set', 'user_data', { email: 'abc@abc.com' })\n *\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n * */\ntype UserProvidedDataAddress = {\n  first_name?: string;\n  last_name?: string;\n  street?: string;\n  city?: string;\n  /** User province, state, or region. Example: `Hampshire` */\n  region?: string;\n  postal_code?: string;\n  /**\n   * User country code.\n   * Example: 'UK'. Use 2-letter country codes, per the ISO 3166-1 alpha-2 standard.\n   */\n  country?: string;\n};\n\n/**\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n */\nexport type UserProvidedData = {\n  email?: string | string[];\n  /**\n   * User phone number. Must be in E.164 format, which means it must be 11 to 15 digits including a\n   * plus sign (+) prefix and country code with no dashes, parentheses, or spaces.\n   *\n   * Example: ‘+11231234567’\n   */\n  phone_number?: string | string[];\n  address?: UserProvidedDataAddress | UserProvidedDataAddress[];\n};\n\nexport type GaId = `G-${Uppercase<string>}`;\nexport type GtmId = `GTM-${Uppercase<string>}`;\n\nexport type CampaignMedium =\n  | 'email'\n  | 'organic'\n  | 'cpc'\n  | 'banner'\n  | 'social'\n  | 'referral'\n  | 'affiliate'\n  | 'video'\n  | 'display'\n  | 'sms'\n  | 'push'\n  | 'qr'\n  | 'audio'\n  | (string & {});\n\nexport type CampaignSource =\n  | 'google' // don't need to set\n  | 'googleads'\n  | 'bing'\n  | 'bingads'\n  | 'metaads'\n  | 'facebook'\n  | 'twitter'\n  | 'linkedin'\n  | 'instagram'\n  | 'tiktok'\n  | 'youtube'\n  | 'newsletter'\n  | `website_${string}`\n  | `affiliate_${string}`\n  | (string & {});\n\nexport type Campaign = {\n  id?: string;\n  name?: string;\n  term?: string;\n  content?: string;\n  medium?: CampaignMedium;\n  source?: CampaignSource;\n};\n\nexport type Config = {\n  allow_google_signals?: boolean;\n  allow_ad_personalization_signals?: boolean;\n\n  campaign_content?: string;\n  campaign_id?: string;\n  campaign_medium?: CampaignMedium;\n  campaign_name?: string;\n  campaign_source?: CampaignSource;\n  campaign_term?: string;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  campaign?: Campaign;\n\n  client_id?: string;\n  content_group?: string;\n\n  cookie_domain?: 'none' | 'auto' | string;\n  cookie_expires?: number;\n  cookie_flags?: string;\n  cookie_path?: string;\n  cookie_prefix?: string;\n  cookie_update?: boolean;\n\n  ignore_referrer?: boolean;\n  language?: string;\n\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n\n  send_page_view?: boolean;\n  screen_resolution?: `${number}x${number}`;\n  user_id?: string;\n  user_properties?: UserProperties;\n};\n\nexport type Item = {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n};\n\nexport type PromotionItem = {\n  creative_name?: string;\n  creative_slot?: string;\n  promotion_id?: string;\n  promotion_name?: string;\n};\n\nexport type SurveyProperties = {\n  id?: string;\n  feature?: Lowercase<string>;\n  trigger?: Lowercase<string>;\n};\n\nexport type SurveyQA = {\n  q1: string;\n  a1: string;\n  q2?: string;\n  a2?: string;\n  q3?: string;\n  a3?: string;\n  q4?: string;\n  a4?: string;\n  q5?: string;\n  a5?: string;\n  q6?: string;\n  a6?: string;\n  completed?: boolean;\n};\n\nexport type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | number;\nexport type CASTScore = 1 | 2 | 3 | 4 | 5 | number;\nexport type CESScore = 1 | 2 | 3 | 4 | 5 | number;\n\n/** ref: https://support.google.com/analytics/answer/9216061 */\nexport type EnhancedMeasurementEvents = {\n  page_view: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n    previous_page_path?: string;\n    engagement_time_msec?: number;\n  };\n  // Scrolls: the first time a user reaches the bottom of each page\n  // (i.e., when a 90% vertical depth becomes visible)\n  scroll: {\n    engagement_time_msec: number;\n  };\n  // Outbound clicks\n  click: {\n    link_id: string;\n    link_url: string;\n    link_text: string; // added\n    link_domain: string;\n    link_classes: string;\n    outbound: boolean;\n  };\n  // Site search\n  view_search_results: {\n    search_term: string;\n  };\n  // Video engagement\n  video_start: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_progress: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_complete: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  // File downloads:\n  file_download: {\n    file_extension: string;\n    file_name: string;\n    link_classes: string;\n    link_id: string;\n    link_text: string;\n    link_url: string;\n  };\n  // Form interactions\n  form_start: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n  };\n  form_submit: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n    form_submit_text: string;\n  };\n};\n\n/** ref: https://support.google.com/analytics/answer/9234069  */\nexport type AutomaticallyCollectedEvents = EnhancedMeasurementEvents & {\n  first_visit: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n  };\n  first_open: {\n    screen_name: string;\n    screen_class: string;\n  };\n  in_app_purchase: {\n    product_id: string;\n    price: number;\n    value: number;\n    currency: string;\n    quantity: number;\n    subscription?: boolean;\n    free_trial?: boolean;\n    introductory_price?: number;\n  };\n  notification_dismiss: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_foreground: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_open: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_receive: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  // Note: The 'screen_view' event is automatically sent only when using Android or iOS native SDKs.\n  // If you are using React Native, you need to send this event manually; it should not be ignored.\n  session_start: undefined;\n  user_engagement: {\n    engagement_time_msec: number;\n    trigger: 'pagehide' | 'visibilitychange' | 'background';\n  };\n};\n\n/**\n * ref: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n * ref: https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Event\n * */\nexport type RecommendedEvents = {\n  // Google Analytics 4 Recommended Events\n  add_payment_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    payment_type?: string;\n    items: Item[];\n  };\n  add_shipping_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    shipping_tier?: string;\n    items: Item[];\n  };\n  add_to_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  add_to_wishlist: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  begin_checkout: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    items: Item[];\n    source?: string; // added\n  };\n  close_convert_lead: {\n    currency: string;\n    value: number;\n  };\n  close_unconvert_lead: {\n    currency: string;\n    value: number;\n    unconvert_lead_reason?: string;\n  };\n  disqualify_lead: {\n    currency: string;\n    value: number;\n    disqualified_lead_reason?: string;\n  };\n  earn_virtual_currency: {\n    virtual_currency_name?: string;\n    value?: number;\n  };\n  generate_lead: {\n    currency: string;\n    value: number;\n    lead_source?: string;\n  };\n  join_group: {\n    group_id?: string;\n  };\n  level_end: {\n    level_name?: string;\n    success?: boolean;\n  };\n  level_start: {\n    level_name?: string;\n  };\n  level_up: {\n    level?: number;\n    level_name?: string;\n    character?: string;\n  };\n  login: {\n    method?:\n      | 'google'\n      | 'apple'\n      | 'facebook'\n      | 'twitter'\n      | 'linkedin'\n      | 'github'\n      | 'microsoft'\n      | 'wechat'\n      | 'onetap'\n      | 'phone'\n      | 'email'\n      | (string & {});\n    source?: string; // added\n  };\n  post_score: {\n    score: number;\n    level?: number;\n    character?: string;\n  };\n  purchase: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number; // Shipping cost associated with a transaction.\n    tax?: number;\n    items?: Item[];\n    source?: string; // added\n  };\n  qualify_lead: {\n    currency: string;\n    value: number;\n  };\n  refund: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number;\n    tax?: number;\n    items?: Item[];\n  };\n  remove_from_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  search: {\n    search_term: string;\n  };\n  select_content: {\n    content_type?: string;\n    content_id?: string;\n  };\n  select_item: {\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  select_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items?: (Item & PromotionItem)[];\n  };\n  share: {\n    method?: string;\n    content_type?: string;\n    item_id?: string;\n    system_activity_type?: string; // added\n    platform_post_id?: string; // added\n  };\n  sign_up: {\n    method?: string;\n    source?: string; // added\n  };\n  spend_virtual_currency: {\n    value: number;\n    virtual_currency_name: string;\n    item_name?: string;\n  };\n  tutorial_begin: undefined;\n  tutorial_complete: undefined;\n  unlock_achievement: {\n    achievement_id: string;\n  };\n  view_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item_list: {\n    currency: string;\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  view_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items: (Item & PromotionItem)[];\n  };\n  working_lead: {\n    currency: string;\n    value: number;\n    lead_status?: string;\n  };\n\n  // Firebase Analytics events, event_name 40 characters limit, 25 parameters limit\n  ad_impression: {\n    value?: number;\n    currency?: string;\n    ad_format?: string;\n    ad_platform?: string;\n    ad_source?: string;\n    ad_unit_name?: string;\n  };\n  app_open: undefined;\n  campaign_details: {\n    source: string;\n    medium: string;\n    campaign: string;\n    term?: string;\n    content?: string;\n    aclid?: string;\n    cp1?: string;\n  };\n  screen_view: {\n    screen_name?: string;\n    screen_class?: string;\n    previous_screen_class?: string; // added\n    engagement_time_msec?: number;\n  };\n};\n\n/**\n * Extra commonly used events that are NOT part of the GA standard event set.\n * Added to satisfy additional analytics needs.\n */\nexport type AddedRecommendedEvents = {\n  logout: undefined;\n  trial_begin: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  subscribe: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  // survey\n  survey_shown: SurveyProperties;\n  survey_sent: SurveyProperties & SurveyQA;\n  survey_dismissed: SurveyProperties;\n  /**\n   * Net promoter score: Get an industry-recognized benchmark\n   * How likely are you to recommend us to a friend?\n   * */\n  nps_shown: SurveyProperties;\n  nps_sent: SurveyProperties & { score: NPSScore; feedback?: string };\n  nps_dismissed: SurveyProperties;\n  /**\n   * Customer satisfaction score: Works best after a checkout or support flow\n   * How satisfied are you with xxx?\n   * */\n  cast_shown: SurveyProperties;\n  cast_sent: SurveyProperties & { score: CASTScore; feedback?: string };\n  cast_dismissed: SurveyProperties;\n  /**\n   * Customer effort score: Works well with churn surveys\n   * How easy is it to use the feature?\n   * */\n  ces_shown: SurveyProperties;\n  ces_sent: SurveyProperties & { score: CESScore; feedback?: string };\n  ces_dismissed: SurveyProperties;\n};\n\nexport type StandardEvents = AutomaticallyCollectedEvents &\n  RecommendedEvents &\n  AddedRecommendedEvents;\n\n/**\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/config\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n */\nexport interface Gtag {\n  /**\n   * To disable advertising features based on third-party advertising identifiers, set\n   * allow_google_signals to false.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow Google signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_google_signals', allow: boolean): void;\n\n  /**\n   * Set to false to disable advertising personalization features.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow ad personalization signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_ad_personalization_signals', allow: boolean): void;\n\n  /**\n   * Used for A/B testing and content-targeted ads. Use campaign_content to differentiate ads or\n   * links that point to the same URL.\n   */\n  gtag(event: 'set', option: 'campaign_content', content: string): void;\n\n  /**\n   * Used to identify which campaign this referral references. Use campaign_id to identify a\n   * specific campaign.\n   */\n  gtag(event: 'set', option: 'campaign_id', id: string): void;\n\n  /** Use campaign_medium to identify a medium such as email or cost-per-click. */\n  gtag(event: 'set', option: 'campaign_medium', medium: CampaignMedium): void;\n\n  /**\n   * Used for keyword analysis. Use campaign_name to identify a specific product promotion or\n   * strategic campaign.\n   */\n  gtag(event: 'set', option: 'campaign_name', name: string): void;\n\n  /** Use campaign_source to identify a search engine, newsletter name, or other source. */\n  gtag(event: 'set', option: 'campaign_source', source: CampaignSource): void;\n\n  /** Used for paid search. Use campaign_term to note the keywords for this ad. */\n  gtag(event: 'set', option: 'campaign_term', term: string): void;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  gtag(event: 'set', option: 'campaign', params: Campaign): void;\n\n  /**\n   * Pseudonymously identifies a browser instance. By default, this value is stored as part of the\n   * first-party Analytics cookie with a two-year expiration.\n   */\n  gtag(event: 'set', option: 'client_id', id: string): void;\n\n  /** example: gtag('set', 'content_group', '/news/sports'); */\n  gtag(event: 'set', option: 'content_group', group: string): void;\n\n  /**\n   * Specifies the domain used to store the analytics cookie.\n   * Set to 'none' to set the cookie without specifying a domain.\n   * Set to 'auto' (the default value) to set the cookie to the top level domain plus one\n   * subdomain (eTLD +1). For example, if cookie_domain is set to 'auto' https://example.com would\n   * use example.com for the domain, and https://subdomain.example.com would also use example.com\n   * for the domain.\n   *\n   * @param event\n   * @param option\n   * @param domain - The domain used to store the analytics cookie.\n   * @default 'auto'\n   */\n  gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | string): void;\n\n  /**\n   * Every time a hit is sent to Google Analytics, the cookie expiration time is updated to be the\n   * current time plus the value of the cookie_expires field. This means that if you use the default\n   * value time of two years (63,072,000 seconds), and a user visits your site every month, their\n   * cookie will never expire.\n   *\n   * If you set the cookie_expires time to 0 (zero) seconds, the cookie turns into a session-based\n   * cookie and expires once the current browser session ends.\n   *\n   * Caution: If you set the cookie to expire too quickly, you will inflate your user count and\n   * decrease the quality of your measurement.\n   *\n   * @param event\n   * @param option\n   * @param expires - The number of seconds until the cookie expires.\n   * @default 63072000\n   */\n  gtag(event: 'set', option: 'cookie_expires', expires: number): void;\n\n  /**\n   * Appends additional flags to the cookie when set. Flags must be separated by semicolons. See\n   * [write a new cookie](https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie#write_a_new_cookie) for some examples of flags to set.\n   */\n  gtag(event: 'set', option: 'cookie_flags', flags: string): void;\n\n  /** Specifies the subpath used to store the analytics cookie. */\n  gtag(event: 'set', option: 'cookie_path', path: string): void;\n\n  /** Specifies a prefix to prepend to analytics cookie names. */\n  gtag(event: 'set', option: 'cookie_prefix', prefix: string): void;\n\n  /**\n   * When cookie_update is set to true, gtag.js will update cookies on each page load. This will\n   * update the cookie expiration to be set relative to the most recent visit to the site. For\n   * example, if cookie expiration is set to one week, and a user visits using the same browser\n   * every five days, the cookie expiration will be updated on each visit and will effectively\n   * never expire.\n   *\n   * When set to false, cookies are not updated on each page load. This has the effect of cookie\n   * expiration being relative to the first time a user visited the site.\n   *\n   * @param event\n   * @param option\n   * @param update - Whether to update the cookie on each page load.\n   * @default true\n   */\n  gtag(event: 'set', option: 'cookie_update', update: boolean): void;\n\n  /**\n   * Set to true to indicate to Analytics that the referrer shouldn't be displayed as a traffic\n   * source. [Learn when to use this field](https://support.google.com/analytics/answer/10327750#set-parameter)\n   *\n   * @param event\n   * @param option\n   * @param ignore - Whether to ignore the referrer.\n   * @default false\n   */\n  gtag(event: 'set', option: 'ignore_referrer', ignore: boolean): void;\n\n  /**\n   * Specifies the language preference of the user. Defaults to the user's `navigator.language` value.\n   *\n   * @param event\n   * @param option\n   * @param language - The language preference of the user.\n   * @default navigator.language\n   */\n  gtag(event: 'set', option: 'language', language: string): void;\n\n  /**\n   * Specifies the full URL of the page. Defaults to the user's `document.location` value.\n   *\n   * @param event\n   * @param option\n   * @param location - The full URL of the page. Character limit 1000\n   * @default document.location\n   */\n  gtag(event: 'set', option: 'page_location', location: string): void;\n\n  /**\n   * Specifies which referral source brought traffic to a page. This value is also used to compute\n   * the traffic source. The format of this value is a URL. Defaults to the user's `document.referrer`\n   * value.\n   *\n   * @param event\n   * @param option\n   * @param referrer - The referral source. Character limit 420\n   * @default document.referrer\n   */\n  gtag(event: 'set', option: 'page_referrer', referrer: string): void;\n\n  /**\n   * The title of the page or document. Defaults to the user's `document.title` value.\n   *\n   * @param event\n   * @param option\n   * @param title - The title of the page or document. Character limit 300\n   * @default document.title\n   */\n  gtag(event: 'set', option: 'page_title', title: string): void;\n\n  /**\n   * Set to false to prevent the default snippet from sending a page_view.\n   *\n   * @param event\n   * @param option\n   * @param send - Whether to send a page_view.\n   * @default true\n   */\n  gtag(event: 'set', option: 'send_page_view', send: boolean): void;\n\n  /**\n   * Specifies the resolution of the screen. Should be two positive integers separated by an x. For\n   * example, for an 800px by 600px screen, the value would be 800x600. Calculated from the user's\n   * window.screen value.\n   *\n   * @param event\n   * @param option\n   * @param resolution - The resolution of the screen.\n   * @default window.screen\n   */\n  gtag(event: 'set', option: 'screen_resolution', resolution: `${number}x${number}`): void;\n\n  /**\n   * Specifies a known identifier for a user provided by the site owner/library user. It must not\n   * itself be PII (personally identifiable information). The value should never be persisted in\n   * Google Analytics cookies or other Analytics-provided storage.\n   *\n   * @param event\n   * @param option\n   * @param userId - The user ID. Character limit 256\n   */\n  gtag(event: 'set', option: 'user_id', userId: string): void;\n\n  /**\n   * User properties are attributes that can be used to describe segments of your user base, such\n   * as language preference or geographic location. Up to 25 additional user properties can be set\n   * per project.\n   *\n   * @param event\n   * @param option\n   * @param properties\n   */\n  gtag(event: 'set', option: 'user_properties', properties: UserProperties): void;\n\n  gtag(event: 'set', option: 'user_data', data: UserProvidedData): void;\n\n  /**\n   * gtag('config', ...) Set for a single stream\n   * gtag('set', ...) Set globally\n   */\n  gtag(event: 'config', gaId: GaId, config?: Config): void;\n\n  gtag<T extends string>(\n    event: 'event',\n    eventName: T extends keyof StandardEvents ? T : string,\n    eventParams?: T extends keyof StandardEvents\n      ? StandardEvents[T]\n      : Record<string, string | number | boolean | null | undefined>\n  ): void;\n}\n"],"mappings":";AACA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,qBAAqB,CAAC,GAAG,uBAAuB,GAAG,qBAAqB;","names":[]}
+{"version":3,"sources":["../../src/track/gtag.ts"],"sourcesContent":["/** reference: https://support.google.com/analytics/answer/13316687 */\nconst reservedWebEventNames = [\n  'app_remove',\n  'app_store_refund',\n  'app_store_subscription_cancel',\n  'app_store_subscription_renew',\n  'click',\n  'error',\n  'file_download',\n  'first_open',\n  'first_visit',\n  'form_start',\n  'form_submit',\n  'in_app_purchase',\n  'page_view',\n  'scroll',\n  'session_start',\n  'user_engagement',\n  'view_complete',\n  'video_progress',\n  'video_start',\n  'view_search_results',\n] as const;\n\nconst reservedAppEventNames = [\n  'ad_activeview',\n  'ad_click',\n  'ad_exposure',\n  'ad_impression',\n  'ad_query',\n  'ad_reward',\n  'adunit_exposure',\n  'app_clear_data',\n  'app_exception',\n  'app_install',\n  'app_remove',\n  'app_store_refund',\n  'app_update',\n  'app_upgrade',\n  'dynamic_link_app_open',\n  'dynamic_link_app_update',\n  'dynamic_link_first_open',\n  'error',\n  'firebase_campaign',\n  'firebase_in_app_message_action',\n  'firebase_in_app_message_dismiss',\n  'firebase_in_app_message_impression',\n  'first_open',\n  'first_visit',\n  'in_app_purchase',\n  'notification_dismiss',\n  'notification_foreground',\n  'notification_open',\n  'notification_receive',\n  'notification_send',\n  'os_update',\n  'screen_view',\n  'session_start',\n  'user_engagement',\n] as const;\n\nexport const reservedEventNames = [...reservedWebEventNames, ...reservedAppEventNames] as const;\n\ntype ReservedWebEventNames = (typeof reservedWebEventNames)[number];\ntype ReservedAppEventNames = (typeof reservedAppEventNames)[number];\nexport type ReservedEventNames = ReservedWebEventNames | ReservedAppEventNames;\n\nexport type ReservedEventValues =\n  | 'cid'\n  | 'currency'\n  | 'customer_id'\n  | 'customerid'\n  | 'dclid'\n  | 'gclid'\n  | 'session_id'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'srsltid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`\n  | `gtag.${string}`;\n\nexport type ReservedUserPropertiesNames =\n  | 'cid'\n  | 'customer_id'\n  | 'customerid'\n  | 'first_open_after_install'\n  | 'first_open_time'\n  | 'first_visit_time'\n  | 'google_allow_ad_personalization_signals'\n  | 'last_advertising_id_reset'\n  | 'last_deep_link_referrer'\n  | 'last_gclid'\n  | 'lifetime_user_engagement'\n  | 'non_personalized_ads'\n  | 'session_id'\n  | 'session_number'\n  | 'sessionid'\n  | 'sfmc_id'\n  | 'sid'\n  | 'uid'\n  | 'user_id'\n  | 'userid'\n  | `_${string}`\n  | `firebase_${string}`\n  | `ga_${string}`\n  | `google_${string}`;\n\nexport type UserPropertiesValue = string | boolean | number | null | undefined;\nexport type UserProperties = {\n  [key: string]: UserPropertiesValue;\n} & {\n  [key in ReservedUserPropertiesNames]?: never;\n};\n\n/**\n * reference: https://support.google.com/analytics/answer/14078702\n * You must turn on user-provided data collection in Google Analytics.\n *\n * Validate your user-provided data implementation: https://support.google.com/analytics/answer/14171683\n *\n * Usage: gtag('set', 'user_data', { email: 'abc@abc.com' })\n *\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n * */\ntype UserProvidedDataAddress = {\n  first_name?: string;\n  last_name?: string;\n  street?: string;\n  city?: string;\n  /** User province, state, or region. Example: `Hampshire` */\n  region?: string;\n  postal_code?: string;\n  /**\n   * User country code.\n   * Example: 'UK'. Use 2-letter country codes, per the ISO 3166-1 alpha-2 standard.\n   */\n  country?: string;\n};\n\n/**\n * To standardize the hash results, before hashing one of these values, you must:\n *\n * - Remove leading and trailing whitespaces.\n * - Convert the text to lowercase.\n * - Format phone numbers according to the E164 standard.\n * - Remove all periods (.) that precede the domain name in gmail.com and googlemail.com email addresses.\n */\nexport type UserProvidedData = {\n  email?: string | string[];\n  /**\n   * User phone number. Must be in E.164 format, which means it must be 11 to 15 digits including a\n   * plus sign (+) prefix and country code with no dashes, parentheses, or spaces.\n   *\n   * Example: ‘+11231234567’\n   */\n  phone_number?: string | string[];\n  address?: UserProvidedDataAddress | UserProvidedDataAddress[];\n};\n\nexport type GaId = `G-${Uppercase<string>}`;\nexport type GtmId = `GTM-${Uppercase<string>}`;\n\nexport type CampaignMedium =\n  | 'email'\n  | 'organic'\n  | 'cpc'\n  | 'banner'\n  | 'social'\n  | 'referral'\n  | 'affiliate'\n  | 'video'\n  | 'display'\n  | 'sms'\n  | 'push'\n  | 'qr'\n  | 'audio'\n  | (string & {});\n\nexport type CampaignSource =\n  | 'google' // don't need to set\n  | 'googleads'\n  | 'bing'\n  | 'bingads'\n  | 'metaads'\n  | 'facebook'\n  | 'twitter'\n  | 'linkedin'\n  | 'instagram'\n  | 'tiktok'\n  | 'youtube'\n  | 'newsletter'\n  | `website_${string}`\n  | `affiliate_${string}`\n  | (string & {});\n\nexport type Campaign = {\n  id?: string;\n  name?: string;\n  term?: string;\n  content?: string;\n  medium?: CampaignMedium;\n  source?: CampaignSource;\n};\n\nexport type Config = {\n  allow_google_signals?: boolean;\n  allow_ad_personalization_signals?: boolean;\n\n  campaign_content?: string;\n  campaign_id?: string;\n  campaign_medium?: CampaignMedium;\n  campaign_name?: string;\n  campaign_source?: CampaignSource;\n  campaign_term?: string;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  campaign?: Campaign;\n\n  client_id?: string;\n  content_group?: string;\n\n  cookie_domain?: 'none' | 'auto' | (string & {});\n  cookie_expires?: number;\n  cookie_flags?: string;\n  cookie_path?: string;\n  cookie_prefix?: string;\n  cookie_update?: boolean;\n\n  ignore_referrer?: boolean;\n  language?: string;\n\n  page_location?: string;\n  page_referrer?: string;\n  page_title?: string;\n\n  send_page_view?: boolean;\n  screen_resolution?: `${number}x${number}`;\n  user_id?: string;\n  user_properties?: UserProperties;\n};\n\nexport type Item = {\n  item_id: string;\n  item_name: string;\n  affiliation?: 'Google Store' | (string & {});\n  coupon?: string;\n  discount?: number;\n  index?: number;\n  item_brand?: string;\n  item_category?: string;\n  item_category2?: string;\n  item_category3?: string;\n  item_category4?: string;\n  item_category5?: string;\n  item_list_id?: string;\n  item_list_name?: string;\n  item_variant?: string;\n  location_id?: string;\n  price?: number;\n  quantity?: number;\n};\n\nexport type PromotionItem = {\n  creative_name?: string;\n  creative_slot?: string;\n  promotion_id?: string;\n  promotion_name?: string;\n};\n\nexport type SurveyProperties = {\n  id?: string;\n  feature?: Lowercase<string>;\n  trigger?: Lowercase<string>;\n};\n\nexport type SurveyQA = {\n  q1: string;\n  a1: string;\n  q2?: string;\n  a2?: string;\n  q3?: string;\n  a3?: string;\n  q4?: string;\n  a4?: string;\n  q5?: string;\n  a5?: string;\n  q6?: string;\n  a6?: string;\n  completed?: boolean;\n};\n\nexport type NPSScore = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 10 | (number & {});\nexport type CASTScore = 1 | 2 | 3 | 4 | 5 | (number & {});\nexport type CESScore = 1 | 2 | 3 | 4 | 5 | (number & {});\n\n/** ref: https://support.google.com/analytics/answer/9216061 */\nexport type EnhancedMeasurementEvents = {\n  page_view: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n    previous_page_path?: string;\n    engagement_time_msec?: number;\n  };\n  // Scrolls: the first time a user reaches the bottom of each page\n  // (i.e., when a 90% vertical depth becomes visible)\n  scroll: {\n    engagement_time_msec: number;\n  };\n  // Outbound clicks\n  click: {\n    link_id: string;\n    link_url: string;\n    link_text: string; // added\n    link_domain: string;\n    link_classes: string;\n    outbound: boolean;\n  };\n  // Site search\n  view_search_results: {\n    search_term: string;\n  };\n  // Video engagement\n  video_start: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_progress: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  video_complete: {\n    video_current_time: number;\n    video_duration: number;\n    video_percent: number;\n    video_provider: 'youtube' | 'vimeo' | 'html5' | (string & {});\n    video_title: string;\n    video_url: string;\n    visible: boolean;\n  };\n  // File downloads:\n  file_download: {\n    file_extension: string;\n    file_name: string;\n    link_classes: string;\n    link_id: string;\n    link_text: string;\n    link_url: string;\n  };\n  // Form interactions\n  form_start: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n  };\n  form_submit: {\n    form_id: string;\n    form_name: string;\n    form_destination: string;\n    form_submit_text: string;\n  };\n};\n\n/** ref: https://support.google.com/analytics/answer/9234069  */\nexport type AutomaticallyCollectedEvents = EnhancedMeasurementEvents & {\n  first_visit: {\n    page_path: string;\n    page_title: string;\n    page_referrer?: string;\n    page_location?: string;\n  };\n  first_open: {\n    screen_name: string;\n    screen_class: string;\n  };\n  in_app_purchase: {\n    product_id: string;\n    price: number;\n    value: number;\n    currency: string;\n    quantity: number;\n    subscription?: boolean;\n    free_trial?: boolean;\n    introductory_price?: number;\n  };\n  notification_dismiss: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_foreground: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_open: {\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  notification_receive: {\n    // Android only\n    topic: string;\n    label: string;\n    message_id: string;\n    message_name: string;\n    message_type: string;\n    message_time: number;\n    message_device_time: number;\n    message_channel: string;\n  };\n  // Note: The 'screen_view' event is automatically sent only when using Android or iOS native SDKs.\n  // If you are using React Native, you need to send this event manually; it should not be ignored.\n  session_start: undefined;\n  user_engagement: {\n    engagement_time_msec: number;\n    trigger: 'pagehide' | 'visibilitychange' | 'background';\n  };\n};\n\n/**\n * ref: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n * ref: https://firebase.google.com/docs/reference/android/com/google/firebase/analytics/FirebaseAnalytics.Event\n * */\nexport type RecommendedEvents = {\n  // Google Analytics 4 Recommended Events\n  add_payment_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    payment_type?: string;\n    items: Item[];\n  };\n  add_shipping_info: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    shipping_tier?: string;\n    items: Item[];\n  };\n  add_to_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  add_to_wishlist: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  begin_checkout: {\n    currency: string;\n    value: number;\n    coupon?: string;\n    items: Item[];\n    source?: string; // added\n  };\n  close_convert_lead: {\n    currency: string;\n    value: number;\n  };\n  close_unconvert_lead: {\n    currency: string;\n    value: number;\n    unconvert_lead_reason?: string;\n  };\n  disqualify_lead: {\n    currency: string;\n    value: number;\n    disqualified_lead_reason?: string;\n  };\n  earn_virtual_currency: {\n    virtual_currency_name?: string;\n    value?: number;\n  };\n  generate_lead: {\n    currency: string;\n    value: number;\n    lead_source?: string;\n  };\n  join_group: {\n    group_id?: string;\n  };\n  level_end: {\n    level_name?: string;\n    success?: boolean;\n  };\n  level_start: {\n    level_name?: string;\n  };\n  level_up: {\n    level?: number;\n    level_name?: string;\n    character?: string;\n  };\n  login: {\n    method?:\n      | 'google'\n      | 'apple'\n      | 'facebook'\n      | 'twitter'\n      | 'linkedin'\n      | 'github'\n      | 'microsoft'\n      | 'wechat'\n      | 'onetap'\n      | 'phone'\n      | 'email'\n      | (string & {});\n    source?: string; // added\n  };\n  post_score: {\n    score: number;\n    level?: number;\n    character?: string;\n  };\n  purchase: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number; // Shipping cost associated with a transaction.\n    tax?: number;\n    items?: Item[];\n    source?: string; // added\n  };\n  qualify_lead: {\n    currency: string;\n    value: number;\n  };\n  refund: {\n    currency: string;\n    value: number;\n    transaction_id: string;\n    coupon?: string;\n    shipping?: number;\n    tax?: number;\n    items?: Item[];\n  };\n  remove_from_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  search: {\n    search_term: string;\n  };\n  select_content: {\n    content_type?: string;\n    content_id?: string;\n  };\n  select_item: {\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  select_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items?: (Item & PromotionItem)[];\n  };\n  share: {\n    method?: string;\n    content_type?: string;\n    item_id?: string;\n    system_activity_type?: string; // added\n    platform_post_id?: string; // added\n  };\n  sign_up: {\n    method?: string;\n    source?: string; // added\n  };\n  spend_virtual_currency: {\n    value: number;\n    virtual_currency_name: string;\n    item_name?: string;\n  };\n  tutorial_begin: undefined;\n  tutorial_complete: undefined;\n  unlock_achievement: {\n    achievement_id: string;\n  };\n  view_cart: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item: {\n    currency: string;\n    value: number;\n    items: Item[];\n  };\n  view_item_list: {\n    currency: string;\n    item_list_id?: string;\n    item_list_name?: string;\n    items: Item[];\n  };\n  view_promotion: {\n    creative_name?: string;\n    creative_slot?: string;\n    promotion_id?: string;\n    promotion_name?: string;\n    items: (Item & PromotionItem)[];\n  };\n  working_lead: {\n    currency: string;\n    value: number;\n    lead_status?: string;\n  };\n\n  // Firebase Analytics events, event_name 40 characters limit, 25 parameters limit\n  ad_impression: {\n    value?: number;\n    currency?: string;\n    ad_format?: string;\n    ad_platform?: string;\n    ad_source?: string;\n    ad_unit_name?: string;\n  };\n  app_open: undefined;\n  campaign_details: {\n    source: string;\n    medium: string;\n    campaign: string;\n    term?: string;\n    content?: string;\n    aclid?: string;\n    cp1?: string;\n  };\n  screen_view: {\n    screen_name?: string;\n    screen_class?: string;\n    previous_screen_class?: string; // added\n    engagement_time_msec?: number;\n  };\n};\n\n/**\n * Extra commonly used events that are NOT part of the GA standard event set.\n * Added to satisfy additional analytics needs.\n */\nexport type AddedRecommendedEvents = {\n  logout: undefined;\n  trial_begin: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  subscribe: {\n    currency: string;\n    value: number;\n    source?: string; // added\n    items?: Item[]; // added, the plan(s) enrolled (first item's id maps to OpenAI plan_id)\n  };\n  // survey\n  survey_shown: SurveyProperties;\n  survey_sent: SurveyProperties & SurveyQA;\n  survey_dismissed: SurveyProperties;\n  /**\n   * Net promoter score: Get an industry-recognized benchmark\n   * How likely are you to recommend us to a friend?\n   * */\n  nps_shown: SurveyProperties;\n  nps_sent: SurveyProperties & { score: NPSScore; feedback?: string };\n  nps_dismissed: SurveyProperties;\n  /**\n   * Customer satisfaction score: Works best after a checkout or support flow\n   * How satisfied are you with xxx?\n   * */\n  cast_shown: SurveyProperties;\n  cast_sent: SurveyProperties & { score: CASTScore; feedback?: string };\n  cast_dismissed: SurveyProperties;\n  /**\n   * Customer effort score: Works well with churn surveys\n   * How easy is it to use the feature?\n   * */\n  ces_shown: SurveyProperties;\n  ces_sent: SurveyProperties & { score: CESScore; feedback?: string };\n  ces_dismissed: SurveyProperties;\n};\n\nexport type StandardEvents = AutomaticallyCollectedEvents &\n  RecommendedEvents &\n  AddedRecommendedEvents;\n\n/**\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/config\n * reference: https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag\n */\nexport interface Gtag {\n  /**\n   * To disable advertising features based on third-party advertising identifiers, set\n   * allow_google_signals to false.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow Google signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_google_signals', allow: boolean): void;\n\n  /**\n   * Set to false to disable advertising personalization features.\n   *\n   * @param event\n   * @param option\n   * @param allow - Whether to allow ad personalization signals.\n   * @default true\n   */\n  gtag(event: 'set', option: 'allow_ad_personalization_signals', allow: boolean): void;\n\n  /**\n   * Used for A/B testing and content-targeted ads. Use campaign_content to differentiate ads or\n   * links that point to the same URL.\n   */\n  gtag(event: 'set', option: 'campaign_content', content: string): void;\n\n  /**\n   * Used to identify which campaign this referral references. Use campaign_id to identify a\n   * specific campaign.\n   */\n  gtag(event: 'set', option: 'campaign_id', id: string): void;\n\n  /** Use campaign_medium to identify a medium such as email or cost-per-click. */\n  gtag(event: 'set', option: 'campaign_medium', medium: CampaignMedium): void;\n\n  /**\n   * Used for keyword analysis. Use campaign_name to identify a specific product promotion or\n   * strategic campaign.\n   */\n  gtag(event: 'set', option: 'campaign_name', name: string): void;\n\n  /** Use campaign_source to identify a search engine, newsletter name, or other source. */\n  gtag(event: 'set', option: 'campaign_source', source: CampaignSource): void;\n\n  /** Used for paid search. Use campaign_term to note the keywords for this ad. */\n  gtag(event: 'set', option: 'campaign_term', term: string): void;\n\n  /**\n   * @deprecated\n   * Key Point: Use the campaign_ prefixed version of each campaign value instead of this field.\n   */\n  gtag(event: 'set', option: 'campaign', params: Campaign): void;\n\n  /**\n   * Pseudonymously identifies a browser instance. By default, this value is stored as part of the\n   * first-party Analytics cookie with a two-year expiration.\n   */\n  gtag(event: 'set', option: 'client_id', id: string): void;\n\n  /** example: gtag('set', 'content_group', '/news/sports'); */\n  gtag(event: 'set', option: 'content_group', group: string): void;\n\n  /**\n   * Specifies the domain used to store the analytics cookie.\n   * Set to 'none' to set the cookie without specifying a domain.\n   * Set to 'auto' (the default value) to set the cookie to the top level domain plus one\n   * subdomain (eTLD +1). For example, if cookie_domain is set to 'auto' https://example.com would\n   * use example.com for the domain, and https://subdomain.example.com would also use example.com\n   * for the domain.\n   *\n   * @param event\n   * @param option\n   * @param domain - The domain used to store the analytics cookie.\n   * @default 'auto'\n   */\n  gtag(event: 'set', option: 'cookie_domain', domain: 'none' | 'auto' | (string & {})): void;\n\n  /**\n   * Every time a hit is sent to Google Analytics, the cookie expiration time is updated to be the\n   * current time plus the value of the cookie_expires field. This means that if you use the default\n   * value time of two years (63,072,000 seconds), and a user visits your site every month, their\n   * cookie will never expire.\n   *\n   * If you set the cookie_expires time to 0 (zero) seconds, the cookie turns into a session-based\n   * cookie and expires once the current browser session ends.\n   *\n   * Caution: If you set the cookie to expire too quickly, you will inflate your user count and\n   * decrease the quality of your measurement.\n   *\n   * @param event\n   * @param option\n   * @param expires - The number of seconds until the cookie expires.\n   * @default 63072000\n   */\n  gtag(event: 'set', option: 'cookie_expires', expires: number): void;\n\n  /**\n   * Appends additional flags to the cookie when set. Flags must be separated by semicolons. See\n   * [write a new cookie](https://developer.mozilla.org/en-US/docs/Web/API/Document/cookie#write_a_new_cookie) for some examples of flags to set.\n   */\n  gtag(event: 'set', option: 'cookie_flags', flags: string): void;\n\n  /** Specifies the subpath used to store the analytics cookie. */\n  gtag(event: 'set', option: 'cookie_path', path: string): void;\n\n  /** Specifies a prefix to prepend to analytics cookie names. */\n  gtag(event: 'set', option: 'cookie_prefix', prefix: string): void;\n\n  /**\n   * When cookie_update is set to true, gtag.js will update cookies on each page load. This will\n   * update the cookie expiration to be set relative to the most recent visit to the site. For\n   * example, if cookie expiration is set to one week, and a user visits using the same browser\n   * every five days, the cookie expiration will be updated on each visit and will effectively\n   * never expire.\n   *\n   * When set to false, cookies are not updated on each page load. This has the effect of cookie\n   * expiration being relative to the first time a user visited the site.\n   *\n   * @param event\n   * @param option\n   * @param update - Whether to update the cookie on each page load.\n   * @default true\n   */\n  gtag(event: 'set', option: 'cookie_update', update: boolean): void;\n\n  /**\n   * Set to true to indicate to Analytics that the referrer shouldn't be displayed as a traffic\n   * source. [Learn when to use this field](https://support.google.com/analytics/answer/10327750#set-parameter)\n   *\n   * @param event\n   * @param option\n   * @param ignore - Whether to ignore the referrer.\n   * @default false\n   */\n  gtag(event: 'set', option: 'ignore_referrer', ignore: boolean): void;\n\n  /**\n   * Specifies the language preference of the user. Defaults to the user's `navigator.language` value.\n   *\n   * @param event\n   * @param option\n   * @param language - The language preference of the user.\n   * @default navigator.language\n   */\n  gtag(event: 'set', option: 'language', language: string): void;\n\n  /**\n   * Specifies the full URL of the page. Defaults to the user's `document.location` value.\n   *\n   * @param event\n   * @param option\n   * @param location - The full URL of the page. Character limit 1000\n   * @default document.location\n   */\n  gtag(event: 'set', option: 'page_location', location: string): void;\n\n  /**\n   * Specifies which referral source brought traffic to a page. This value is also used to compute\n   * the traffic source. The format of this value is a URL. Defaults to the user's `document.referrer`\n   * value.\n   *\n   * @param event\n   * @param option\n   * @param referrer - The referral source. Character limit 420\n   * @default document.referrer\n   */\n  gtag(event: 'set', option: 'page_referrer', referrer: string): void;\n\n  /**\n   * The title of the page or document. Defaults to the user's `document.title` value.\n   *\n   * @param event\n   * @param option\n   * @param title - The title of the page or document. Character limit 300\n   * @default document.title\n   */\n  gtag(event: 'set', option: 'page_title', title: string): void;\n\n  /**\n   * Set to false to prevent the default snippet from sending a page_view.\n   *\n   * @param event\n   * @param option\n   * @param send - Whether to send a page_view.\n   * @default true\n   */\n  gtag(event: 'set', option: 'send_page_view', send: boolean): void;\n\n  /**\n   * Specifies the resolution of the screen. Should be two positive integers separated by an x. For\n   * example, for an 800px by 600px screen, the value would be 800x600. Calculated from the user's\n   * window.screen value.\n   *\n   * @param event\n   * @param option\n   * @param resolution - The resolution of the screen.\n   * @default window.screen\n   */\n  gtag(event: 'set', option: 'screen_resolution', resolution: `${number}x${number}`): void;\n\n  /**\n   * Specifies a known identifier for a user provided by the site owner/library user. It must not\n   * itself be PII (personally identifiable information). The value should never be persisted in\n   * Google Analytics cookies or other Analytics-provided storage.\n   *\n   * @param event\n   * @param option\n   * @param userId - The user ID. Character limit 256\n   */\n  gtag(event: 'set', option: 'user_id', userId: string): void;\n\n  /**\n   * User properties are attributes that can be used to describe segments of your user base, such\n   * as language preference or geographic location. Up to 25 additional user properties can be set\n   * per project.\n   *\n   * @param event\n   * @param option\n   * @param properties\n   */\n  gtag(event: 'set', option: 'user_properties', properties: UserProperties): void;\n\n  gtag(event: 'set', option: 'user_data', data: UserProvidedData): void;\n\n  /**\n   * gtag('config', ...) Set for a single stream\n   * gtag('set', ...) Set globally\n   */\n  gtag(event: 'config', gaId: GaId, config?: Config): void;\n\n  gtag<T extends string>(\n    event: 'event',\n    eventName: T extends keyof StandardEvents ? T : string,\n    eventParams?: T extends keyof StandardEvents\n      ? StandardEvents[T]\n      : Record<string, string | number | boolean | null | undefined>\n  ): void;\n}\n"],"mappings":";AACA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,IAAM,wBAAwB;AAAA,EAC5B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEO,IAAM,qBAAqB,CAAC,GAAG,uBAAuB,GAAG,qBAAqB;","names":[]}

package/dist/track/index.cjs

@@ -103,7 +103,7 @@ function track(name, properties, options = defaultOptions) {
   if (list.length >= batch) {
     const copy = [...list];
     list.length = 0;
-    sendEvents(copy);
+    void sendEvents(copy);
     return;
   }
   if (timer) clearTimeout(timer);
@@ -111,7 +111,7 @@ function track(name, properties, options = defaultOptions) {
     timer = null;
     const copy = [...list];
     list.length = 0;
-    sendEvents(copy);
+    void sendEvents(copy);
   }, delay);
 }
 async function trackAsync(name, properties, options = defaultOptions) {

package/dist/track/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/track/index.ts"],"sourcesContent":["import { TokenBucket, fetch } from '@shware/utils';\nimport type { CreateTrackEventDTO } from '../schema/index';\nimport { cache, config } from '../setup/index';\nimport { session } from '../setup/session';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { getVisitor } from '../visitor/index';\nimport type { EventName, TrackEventResponse, TrackName, TrackProperties } from './types';\n\nexport interface TrackOptions {\n  enableThirdPartyTracking?: boolean;\n  onSucceed?: (response?: TrackEventResponse[number]) => void;\n  onError?: (error: unknown) => void;\n}\n\nconst defaultOptions: TrackOptions = { enableThirdPartyTracking: true };\nconst tokenBucket = new TokenBucket({ rate: 1, capacity: 20, requested: 2 });\n\ntype Item = {\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  name: TrackName<any>;\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  properties: TrackProperties<any>;\n  timestamp: string;\n  options: TrackOptions;\n};\n\nasync function sendEvents(events: Item[]) {\n  try {\n    if (events.length === 0) return;\n\n    if (session.isExpired()) {\n      session.refresh();\n      events.unshift({\n        name: 'session_start',\n        properties: {},\n        options: { enableThirdPartyTracking: false },\n        timestamp: new Date().toISOString(),\n      });\n    } else {\n      session.updateLastActiveTime();\n    }\n\n    await tokenBucket.removeTokens();\n\n    const tags = await config.getTags();\n    const visitor_id = (await getVisitor()).id;\n\n    const dto: CreateTrackEventDTO = events.map((event) => ({\n      name: event.name,\n      properties: event.properties,\n      tags,\n      visitor_id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: event.timestamp,\n    }));\n\n    const response = await fetch(`${config.endpoint}/events`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: await config.getHeaders(),\n      body: JSON.stringify(dto),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Failed to send track event: ${response.status} ${await response.text()}`);\n    }\n\n    const data = (await response.json()) as TrackEventResponse;\n\n    let index = 0;\n    while (events.length > 0) {\n      const event = events.shift();\n      if (!event) {\n        index++;\n        continue;\n      }\n      const { options, name, properties } = event;\n      const eventId = data[index].id;\n      options.onSucceed?.({ id: eventId });\n      index++;\n      if (\n        !config.thirdPartyTrackers ||\n        !options.enableThirdPartyTracking ||\n        IGNORED_EVENTS.includes(name)\n      ) {\n        continue;\n      }\n      config.thirdPartyTrackers.forEach((tracker) => tracker(name, properties, eventId));\n    }\n  } catch (e: unknown) {\n    if (e instanceof Error) console.log(e.message);\n    events.forEach((event) => event.options.onError?.(e));\n  }\n}\n\nconst batch = 10;\nconst delay = 2000;\nconst list: Item[] = [];\nlet timer: ReturnType<typeof setTimeout> | null = null;\n\nexport function track<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  list.push({ name, properties, options, timestamp: new Date().toISOString() });\n  if (list.length >= batch) {\n    const copy = [...list];\n    list.length = 0;\n    sendEvents(copy);\n    return;\n  }\n  if (timer) clearTimeout(timer);\n  timer = setTimeout(() => {\n    timer = null;\n    const copy = [...list];\n    list.length = 0;\n    sendEvents(copy);\n  }, delay);\n}\n\nexport async function trackAsync<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  await sendEvents([{ name, properties, options, timestamp: new Date().toISOString() }]);\n}\n\nexport function sendBeacon<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>\n) {\n  if (!cache.tags || !cache.visitor) return;\n  session.updateLastActiveTime();\n\n  const dto: CreateTrackEventDTO = [\n    {\n      name,\n      properties,\n      tags: cache.tags,\n      visitor_id: cache.visitor.id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: new Date().toISOString(),\n    },\n  ];\n  const blob = new Blob([JSON.stringify(dto)], { type: 'application/json' });\n  const success = navigator.sendBeacon(`${config.endpoint}/events`, blob);\n  if (success) return;\n  console.warn('Failed to send beacon', name, properties);\n}\n"],"mappings":"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","names":["_a"]}
+{"version":3,"sources":["../../src/track/index.ts"],"sourcesContent":["import { TokenBucket, fetch } from '@shware/utils';\nimport type { CreateTrackEventDTO } from '../schema/index';\nimport { cache, config } from '../setup/index';\nimport { session } from '../setup/session';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { getVisitor } from '../visitor/index';\nimport type { EventName, TrackEventResponse, TrackName, TrackProperties } from './types';\n\nexport interface TrackOptions {\n  enableThirdPartyTracking?: boolean;\n  onSucceed?: (response?: TrackEventResponse[number]) => void;\n  onError?: (error: unknown) => void;\n}\n\nconst defaultOptions: TrackOptions = { enableThirdPartyTracking: true };\nconst tokenBucket = new TokenBucket({ rate: 1, capacity: 20, requested: 2 });\n\ntype Item = {\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  name: TrackName<any>;\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  properties: TrackProperties<any>;\n  timestamp: string;\n  options: TrackOptions;\n};\n\nasync function sendEvents(events: Item[]) {\n  try {\n    if (events.length === 0) return;\n\n    if (session.isExpired()) {\n      session.refresh();\n      events.unshift({\n        name: 'session_start',\n        properties: {},\n        options: { enableThirdPartyTracking: false },\n        timestamp: new Date().toISOString(),\n      });\n    } else {\n      session.updateLastActiveTime();\n    }\n\n    await tokenBucket.removeTokens();\n\n    const tags = await config.getTags();\n    const visitor_id = (await getVisitor()).id;\n\n    const dto: CreateTrackEventDTO = events.map((event) => ({\n      name: event.name,\n      properties: event.properties,\n      tags,\n      visitor_id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: event.timestamp,\n    }));\n\n    const response = await fetch(`${config.endpoint}/events`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: await config.getHeaders(),\n      body: JSON.stringify(dto),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Failed to send track event: ${response.status} ${await response.text()}`);\n    }\n\n    const data = (await response.json()) as TrackEventResponse;\n\n    let index = 0;\n    while (events.length > 0) {\n      const event = events.shift();\n      if (!event) {\n        index++;\n        continue;\n      }\n      const { options, name, properties } = event;\n      const eventId = data[index].id;\n      options.onSucceed?.({ id: eventId });\n      index++;\n      if (\n        !config.thirdPartyTrackers ||\n        !options.enableThirdPartyTracking ||\n        IGNORED_EVENTS.includes(name)\n      ) {\n        continue;\n      }\n      config.thirdPartyTrackers.forEach((tracker) => tracker(name, properties, eventId));\n    }\n  } catch (e: unknown) {\n    if (e instanceof Error) console.log(e.message);\n    events.forEach((event) => event.options.onError?.(e));\n  }\n}\n\nconst batch = 10;\nconst delay = 2000;\nconst list: Item[] = [];\nlet timer: ReturnType<typeof setTimeout> | null = null;\n\nexport function track<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  list.push({ name, properties, options, timestamp: new Date().toISOString() });\n  if (list.length >= batch) {\n    const copy = [...list];\n    list.length = 0;\n    void sendEvents(copy);\n    return;\n  }\n  if (timer) clearTimeout(timer);\n  timer = setTimeout(() => {\n    timer = null;\n    const copy = [...list];\n    list.length = 0;\n    void sendEvents(copy);\n  }, delay);\n}\n\nexport async function trackAsync<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  await sendEvents([{ name, properties, options, timestamp: new Date().toISOString() }]);\n}\n\nexport function sendBeacon<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>\n) {\n  if (!cache.tags || !cache.visitor) return;\n  session.updateLastActiveTime();\n\n  const dto: CreateTrackEventDTO = [\n    {\n      name,\n      properties,\n      tags: cache.tags,\n      visitor_id: cache.visitor.id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: new Date().toISOString(),\n    },\n  ];\n  const blob = new Blob([JSON.stringify(dto)], { type: 'application/json' });\n  const success = navigator.sendBeacon(`${config.endpoint}/events`, blob);\n  if (success) return;\n  console.warn('Failed to send beacon', name, properties);\n}\n"],"mappings":"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","names":["_a"]}

package/dist/track/index.mjs

@@ -77,7 +77,7 @@ function track(name, properties, options = defaultOptions) {
   if (list.length >= batch) {
     const copy = [...list];
     list.length = 0;
-    sendEvents(copy);
+    void sendEvents(copy);
     return;
   }
   if (timer) clearTimeout(timer);
@@ -85,7 +85,7 @@ function track(name, properties, options = defaultOptions) {
     timer = null;
     const copy = [...list];
     list.length = 0;
-    sendEvents(copy);
+    void sendEvents(copy);
   }, delay);
 }
 async function trackAsync(name, properties, options = defaultOptions) {

package/dist/track/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/track/index.ts"],"sourcesContent":["import { TokenBucket, fetch } from '@shware/utils';\nimport type { CreateTrackEventDTO } from '../schema/index';\nimport { cache, config } from '../setup/index';\nimport { session } from '../setup/session';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { getVisitor } from '../visitor/index';\nimport type { EventName, TrackEventResponse, TrackName, TrackProperties } from './types';\n\nexport interface TrackOptions {\n  enableThirdPartyTracking?: boolean;\n  onSucceed?: (response?: TrackEventResponse[number]) => void;\n  onError?: (error: unknown) => void;\n}\n\nconst defaultOptions: TrackOptions = { enableThirdPartyTracking: true };\nconst tokenBucket = new TokenBucket({ rate: 1, capacity: 20, requested: 2 });\n\ntype Item = {\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  name: TrackName<any>;\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  properties: TrackProperties<any>;\n  timestamp: string;\n  options: TrackOptions;\n};\n\nasync function sendEvents(events: Item[]) {\n  try {\n    if (events.length === 0) return;\n\n    if (session.isExpired()) {\n      session.refresh();\n      events.unshift({\n        name: 'session_start',\n        properties: {},\n        options: { enableThirdPartyTracking: false },\n        timestamp: new Date().toISOString(),\n      });\n    } else {\n      session.updateLastActiveTime();\n    }\n\n    await tokenBucket.removeTokens();\n\n    const tags = await config.getTags();\n    const visitor_id = (await getVisitor()).id;\n\n    const dto: CreateTrackEventDTO = events.map((event) => ({\n      name: event.name,\n      properties: event.properties,\n      tags,\n      visitor_id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: event.timestamp,\n    }));\n\n    const response = await fetch(`${config.endpoint}/events`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: await config.getHeaders(),\n      body: JSON.stringify(dto),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Failed to send track event: ${response.status} ${await response.text()}`);\n    }\n\n    const data = (await response.json()) as TrackEventResponse;\n\n    let index = 0;\n    while (events.length > 0) {\n      const event = events.shift();\n      if (!event) {\n        index++;\n        continue;\n      }\n      const { options, name, properties } = event;\n      const eventId = data[index].id;\n      options.onSucceed?.({ id: eventId });\n      index++;\n      if (\n        !config.thirdPartyTrackers ||\n        !options.enableThirdPartyTracking ||\n        IGNORED_EVENTS.includes(name)\n      ) {\n        continue;\n      }\n      config.thirdPartyTrackers.forEach((tracker) => tracker(name, properties, eventId));\n    }\n  } catch (e: unknown) {\n    if (e instanceof Error) console.log(e.message);\n    events.forEach((event) => event.options.onError?.(e));\n  }\n}\n\nconst batch = 10;\nconst delay = 2000;\nconst list: Item[] = [];\nlet timer: ReturnType<typeof setTimeout> | null = null;\n\nexport function track<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  list.push({ name, properties, options, timestamp: new Date().toISOString() });\n  if (list.length >= batch) {\n    const copy = [...list];\n    list.length = 0;\n    sendEvents(copy);\n    return;\n  }\n  if (timer) clearTimeout(timer);\n  timer = setTimeout(() => {\n    timer = null;\n    const copy = [...list];\n    list.length = 0;\n    sendEvents(copy);\n  }, delay);\n}\n\nexport async function trackAsync<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  await sendEvents([{ name, properties, options, timestamp: new Date().toISOString() }]);\n}\n\nexport function sendBeacon<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>\n) {\n  if (!cache.tags || !cache.visitor) return;\n  session.updateLastActiveTime();\n\n  const dto: CreateTrackEventDTO = [\n    {\n      name,\n      properties,\n      tags: cache.tags,\n      visitor_id: cache.visitor.id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: new Date().toISOString(),\n    },\n  ];\n  const blob = new Blob([JSON.stringify(dto)], { type: 'application/json' });\n  const success = navigator.sendBeacon(`${config.endpoint}/events`, blob);\n  if (success) return;\n  console.warn('Failed to send beacon', name, properties);\n}\n"],"mappings":"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","names":["_a"]}
+{"version":3,"sources":["../../src/track/index.ts"],"sourcesContent":["import { TokenBucket, fetch } from '@shware/utils';\nimport type { CreateTrackEventDTO } from '../schema/index';\nimport { cache, config } from '../setup/index';\nimport { session } from '../setup/session';\nimport { IGNORED_EVENTS } from '../third-parties/ignored-events';\nimport { getVisitor } from '../visitor/index';\nimport type { EventName, TrackEventResponse, TrackName, TrackProperties } from './types';\n\nexport interface TrackOptions {\n  enableThirdPartyTracking?: boolean;\n  onSucceed?: (response?: TrackEventResponse[number]) => void;\n  onError?: (error: unknown) => void;\n}\n\nconst defaultOptions: TrackOptions = { enableThirdPartyTracking: true };\nconst tokenBucket = new TokenBucket({ rate: 1, capacity: 20, requested: 2 });\n\ntype Item = {\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  name: TrackName<any>;\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  properties: TrackProperties<any>;\n  timestamp: string;\n  options: TrackOptions;\n};\n\nasync function sendEvents(events: Item[]) {\n  try {\n    if (events.length === 0) return;\n\n    if (session.isExpired()) {\n      session.refresh();\n      events.unshift({\n        name: 'session_start',\n        properties: {},\n        options: { enableThirdPartyTracking: false },\n        timestamp: new Date().toISOString(),\n      });\n    } else {\n      session.updateLastActiveTime();\n    }\n\n    await tokenBucket.removeTokens();\n\n    const tags = await config.getTags();\n    const visitor_id = (await getVisitor()).id;\n\n    const dto: CreateTrackEventDTO = events.map((event) => ({\n      name: event.name,\n      properties: event.properties,\n      tags,\n      visitor_id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: event.timestamp,\n    }));\n\n    const response = await fetch(`${config.endpoint}/events`, {\n      method: 'POST',\n      credentials: 'include',\n      headers: await config.getHeaders(),\n      body: JSON.stringify(dto),\n    });\n\n    if (!response.ok) {\n      throw new Error(`Failed to send track event: ${response.status} ${await response.text()}`);\n    }\n\n    const data = (await response.json()) as TrackEventResponse;\n\n    let index = 0;\n    while (events.length > 0) {\n      const event = events.shift();\n      if (!event) {\n        index++;\n        continue;\n      }\n      const { options, name, properties } = event;\n      const eventId = data[index].id;\n      options.onSucceed?.({ id: eventId });\n      index++;\n      if (\n        !config.thirdPartyTrackers ||\n        !options.enableThirdPartyTracking ||\n        IGNORED_EVENTS.includes(name)\n      ) {\n        continue;\n      }\n      config.thirdPartyTrackers.forEach((tracker) => tracker(name, properties, eventId));\n    }\n  } catch (e: unknown) {\n    if (e instanceof Error) console.log(e.message);\n    events.forEach((event) => event.options.onError?.(e));\n  }\n}\n\nconst batch = 10;\nconst delay = 2000;\nconst list: Item[] = [];\nlet timer: ReturnType<typeof setTimeout> | null = null;\n\nexport function track<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  list.push({ name, properties, options, timestamp: new Date().toISOString() });\n  if (list.length >= batch) {\n    const copy = [...list];\n    list.length = 0;\n    void sendEvents(copy);\n    return;\n  }\n  if (timer) clearTimeout(timer);\n  timer = setTimeout(() => {\n    timer = null;\n    const copy = [...list];\n    list.length = 0;\n    void sendEvents(copy);\n  }, delay);\n}\n\nexport async function trackAsync<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  options: TrackOptions = defaultOptions\n) {\n  await sendEvents([{ name, properties, options, timestamp: new Date().toISOString() }]);\n}\n\nexport function sendBeacon<T extends EventName = EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>\n) {\n  if (!cache.tags || !cache.visitor) return;\n  session.updateLastActiveTime();\n\n  const dto: CreateTrackEventDTO = [\n    {\n      name,\n      properties,\n      tags: cache.tags,\n      visitor_id: cache.visitor.id,\n      session_id: session.getId(),\n      platform: config.platform,\n      environment: config.environment,\n      timestamp: new Date().toISOString(),\n    },\n  ];\n  const blob = new Blob([JSON.stringify(dto)], { type: 'application/json' });\n  const success = navigator.sendBeacon(`${config.endpoint}/events`, blob);\n  if (success) return;\n  console.warn('Failed to send beacon', name, properties);\n}\n"],"mappings":";AAAA,SAAS,aAAa,aAAa;AAEnC,SAAS,OAAO,cAAc;AAC9B,SAAS,eAAe;AACxB,SAAS,sBAAsB;AAC/B,SAAS,kBAAkB;AAS3B,IAAM,iBAA+B,EAAE,0BAA0B,KAAK;AACtE,IAAM,cAAc,IAAI,YAAY,EAAE,MAAM,GAAG,UAAU,IAAI,WAAW,EAAE,CAAC;AAW3E,eAAe,WAAW,QAAgB;AA1B1C;AA2BE,MAAI;AACF,QAAI,OAAO,WAAW,EAAG;AAEzB,QAAI,QAAQ,UAAU,GAAG;AACvB,cAAQ,QAAQ;AAChB,aAAO,QAAQ;AAAA,QACb,MAAM;AAAA,QACN,YAAY,CAAC;AAAA,QACb,SAAS,EAAE,0BAA0B,MAAM;AAAA,QAC3C,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,MACpC,CAAC;AAAA,IACH,OAAO;AACL,cAAQ,qBAAqB;AAAA,IAC/B;AAEA,UAAM,YAAY,aAAa;AAE/B,UAAM,OAAO,MAAM,OAAO,QAAQ;AAClC,UAAM,cAAc,MAAM,WAAW,GAAG;AAExC,UAAM,MAA2B,OAAO,IAAI,CAAC,WAAW;AAAA,MACtD,MAAM,MAAM;AAAA,MACZ,YAAY,MAAM;AAAA,MAClB;AAAA,MACA;AAAA,MACA,YAAY,QAAQ,MAAM;AAAA,MAC1B,UAAU,OAAO;AAAA,MACjB,aAAa,OAAO;AAAA,MACpB,WAAW,MAAM;AAAA,IACnB,EAAE;AAEF,UAAM,WAAW,MAAM,MAAM,GAAG,OAAO,QAAQ,WAAW;AAAA,MACxD,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,SAAS,MAAM,OAAO,WAAW;AAAA,MACjC,MAAM,KAAK,UAAU,GAAG;AAAA,IAC1B,CAAC;AAED,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,+BAA+B,SAAS,MAAM,IAAI,MAAM,SAAS,KAAK,CAAC,EAAE;AAAA,IAC3F;AAEA,UAAM,OAAQ,MAAM,SAAS,KAAK;AAElC,QAAI,QAAQ;AACZ,WAAO,OAAO,SAAS,GAAG;AACxB,YAAM,QAAQ,OAAO,MAAM;AAC3B,UAAI,CAAC,OAAO;AACV;AACA;AAAA,MACF;AACA,YAAM,EAAE,SAAS,MAAM,WAAW,IAAI;AACtC,YAAM,UAAU,KAAK,KAAK,EAAE;AAC5B,oBAAQ,cAAR,iCAAoB,EAAE,IAAI,QAAQ;AAClC;AACA,UACE,CAAC,OAAO,sBACR,CAAC,QAAQ,4BACT,eAAe,SAAS,IAAI,GAC5B;AACA;AAAA,MACF;AACA,aAAO,mBAAmB,QAAQ,CAAC,YAAY,QAAQ,MAAM,YAAY,OAAO,CAAC;AAAA,IACnF;AAAA,EACF,SAAS,GAAY;AACnB,QAAI,aAAa,MAAO,SAAQ,IAAI,EAAE,OAAO;AAC7C,WAAO,QAAQ,CAAC,UAAO;AA7F3B,UAAAA,KAAA;AA6F8B,oBAAAA,MAAA,MAAM,SAAQ,YAAd,wBAAAA,KAAwB;AAAA,KAAE;AAAA,EACtD;AACF;AAEA,IAAM,QAAQ;AACd,IAAM,QAAQ;AACd,IAAM,OAAe,CAAC;AACtB,IAAI,QAA8C;AAE3C,SAAS,MACd,MACA,YACA,UAAwB,gBACxB;AACA,OAAK,KAAK,EAAE,MAAM,YAAY,SAAS,YAAW,oBAAI,KAAK,GAAE,YAAY,EAAE,CAAC;AAC5E,MAAI,KAAK,UAAU,OAAO;AACxB,UAAM,OAAO,CAAC,GAAG,IAAI;AACrB,SAAK,SAAS;AACd,SAAK,WAAW,IAAI;AACpB;AAAA,EACF;AACA,MAAI,MAAO,cAAa,KAAK;AAC7B,UAAQ,WAAW,MAAM;AACvB,YAAQ;AACR,UAAM,OAAO,CAAC,GAAG,IAAI;AACrB,SAAK,SAAS;AACd,SAAK,WAAW,IAAI;AAAA,EACtB,GAAG,KAAK;AACV;AAEA,eAAsB,WACpB,MACA,YACA,UAAwB,gBACxB;AACA,QAAM,WAAW,CAAC,EAAE,MAAM,YAAY,SAAS,YAAW,oBAAI,KAAK,GAAE,YAAY,EAAE,CAAC,CAAC;AACvF;AAEO,SAAS,WACd,MACA,YACA;AACA,MAAI,CAAC,MAAM,QAAQ,CAAC,MAAM,QAAS;AACnC,UAAQ,qBAAqB;AAE7B,QAAM,MAA2B;AAAA,IAC/B;AAAA,MACE;AAAA,MACA;AAAA,MACA,MAAM,MAAM;AAAA,MACZ,YAAY,MAAM,QAAQ;AAAA,MAC1B,YAAY,QAAQ,MAAM;AAAA,MAC1B,UAAU,OAAO;AAAA,MACjB,aAAa,OAAO;AAAA,MACpB,YAAW,oBAAI,KAAK,GAAE,YAAY;AAAA,IACpC;AAAA,EACF;AACA,QAAM,OAAO,IAAI,KAAK,CAAC,KAAK,UAAU,GAAG,CAAC,GAAG,EAAE,MAAM,mBAAmB,CAAC;AACzE,QAAM,UAAU,UAAU,WAAW,GAAG,OAAO,QAAQ,WAAW,IAAI;AACtE,MAAI,QAAS;AACb,UAAQ,KAAK,yBAAyB,MAAM,UAAU;AACxD;","names":["_a"]}

package/dist/track/rdt.cjs

@@ -106,7 +106,7 @@ function mapServerStandardEvent(name) {
   if (name === "Purchase") return "PURCHASE";
   if (name === "Lead") return "LEAD";
   if (name === "SignUp") return "SIGN_UP";
-  throw new Error(`Unsupported standard event: ${name}`);
+  throw new Error(`Unsupported standard event: ${String(name)}`);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/track/rdt.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/track/rdt.ts"],"sourcesContent":["import type { Item } from './gtag';\nimport type { EventName, TrackName, TrackProperties } from './types';\n\n/** https://business.reddithelp.com/s/article/about-event-metadata */\nexport type Product = {\n  /**\n   * (Required) Product ID: Either the SKU or GTIN, which represents the variant ID, not the\n   * parent ID. If there are no variants, pass the assigned ID for that item.\n   */\n  id: string;\n\n  /** (Optional) Product Category: The group the product belongs to. */\n  name?: string;\n\n  /** (Optional) Product Name: The title of the product. */\n  category?: string;\n};\n\n/**\n * https://business.reddithelp.com/s/article/supported-conversion-events#supported-conversion-events\n * https://business.reddithelp.com/s/article/about-event-metadata\n * https://business.reddithelp.com/s/article/map-a-catalog-to-a-signal-source\n */\nexport type StandardEvents = {\n  PageVisit: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  ViewContent: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  Search: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToCart: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToWishlist: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Purchase: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Lead: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n  SignUp: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n};\n\nexport type PixelId = `a2_${string}`;\n\nexport type MatchKeys = {\n  email?: string;\n  phoneNumber?: string;\n  externalId?: string;\n  idfa?: string;\n  aaid?: string;\n};\n\nexport type CustomEventParams<T extends string = string> = {\n  customEventName: T;\n  value?: number;\n  currency?: string;\n  itemCount?: number;\n  conversionId?: string;\n  products?: Product[];\n};\n\nexport interface RDT {\n  rdt(event: 'init', pixelId: PixelId, matchKeys?: MatchKeys): void;\n\n  rdt<T extends keyof StandardEvents>(event: 'track', type: T, params?: StandardEvents[T]): void;\n\n  rdt(event: 'track', type: 'Custom', params: CustomEventParams): void;\n}\n\ntype Mapped<F extends keyof StandardEvents> = [F, StandardEvents[F]];\ntype Missed<F extends string> = ['Custom', CustomEventParams<F>];\n\nexport function mapItems(items?: Item[]): undefined | Product[] {\n  if (!items || items.length === 0) return undefined;\n  return items.map((item) => ({\n    id: item.item_id,\n    name: item.item_name,\n    category: item.item_category,\n  }));\n}\n\nexport function mapRDTEvent<T extends EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  eventId?: string\n): Mapped<keyof StandardEvents> | Missed<TrackName<T>> {\n  // standard events\n  if (name === 'page_view') {\n    return ['PageVisit', { conversionId: eventId }];\n  } else if (name === 'view_item') {\n    return ['ViewContent', { conversionId: eventId }];\n  } else if (name === 'search') {\n    return ['Search', { conversionId: eventId }];\n  } else if (name === 'add_to_cart') {\n    const p = properties as TrackProperties<'add_to_cart'> | undefined;\n    return [\n      'AddToCart',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'add_to_wishlist') {\n    const p = properties as TrackProperties<'add_to_wishlist'> | undefined;\n    return [\n      'AddToWishlist',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'purchase') {\n    const p = properties as TrackProperties<'purchase'> | undefined;\n    return [\n      'Purchase',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'generate_lead') {\n    const p = properties as TrackProperties<'generate_lead'> | undefined;\n    return [\n      'Lead',\n      { conversionId: eventId, value: p?.value, currency: p?.currency.toUpperCase() },\n    ];\n  } else if (name === 'sign_up' || name === 'login') {\n    return ['SignUp', { conversionId: eventId }];\n  } else {\n    // custom event\n    return [\n      'Custom',\n      {\n        customEventName: name,\n        conversionId: eventId,\n        value:\n          properties && 'value' in properties && typeof properties.value === 'number'\n            ? properties.value\n            : undefined,\n        currency:\n          properties && 'currency' in properties && typeof properties.currency === 'string'\n            ? properties.currency.toUpperCase()\n            : undefined,\n      },\n    ];\n  }\n}\n\nexport type ServerStandardEvent =\n  | 'PAGE_VISIT'\n  | 'VIEW_CONTENT'\n  | 'SEARCH'\n  | 'ADD_TO_CART'\n  | 'ADD_TO_WISHLIST'\n  | 'PURCHASE'\n  | 'LEAD'\n  | 'SIGN_UP';\n\nexport function mapServerStandardEvent(name: keyof StandardEvents): ServerStandardEvent {\n  if (name === 'PageVisit') return 'PAGE_VISIT';\n  if (name === 'ViewContent') return 'VIEW_CONTENT';\n  if (name === 'Search') return 'SEARCH';\n  if (name === 'AddToCart') return 'ADD_TO_CART';\n  if (name === 'AddToWishlist') return 'ADD_TO_WISHLIST';\n  if (name === 'Purchase') return 'PURCHASE';\n  if (name === 'Lead') return 'LEAD';\n  if (name === 'SignUp') return 'SIGN_UP';\n  throw new Error(`Unsupported standard event: ${name}`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqGO,SAAS,SAAS,OAAuC;AAC9D,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG,QAAO;AACzC,SAAO,MAAM,IAAI,CAAC,UAAU;AAAA,IAC1B,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,UAAU,KAAK;AAAA,EACjB,EAAE;AACJ;AAEO,SAAS,YACd,MACA,YACA,SACqD;AAlHvD;AAoHE,MAAI,SAAS,aAAa;AACxB,WAAO,CAAC,aAAa,EAAE,cAAc,QAAQ,CAAC;AAAA,EAChD,WAAW,SAAS,aAAa;AAC/B,WAAO,CAAC,eAAe,EAAE,cAAc,QAAQ,CAAC;AAAA,EAClD,WAAW,SAAS,UAAU;AAC5B,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,WAAW,SAAS,eAAe;AACjC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,mBAAmB;AACrC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,YAAY;AAC9B,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,iBAAiB;AACnC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA,EAAE,cAAc,SAAS,OAAO,uBAAG,OAAO,UAAU,uBAAG,SAAS,cAAc;AAAA,IAChF;AAAA,EACF,WAAW,SAAS,aAAa,SAAS,SAAS;AACjD,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,OAAO;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,iBAAiB;AAAA,QACjB,cAAc;AAAA,QACd,OACE,cAAc,WAAW,cAAc,OAAO,WAAW,UAAU,WAC/D,WAAW,QACX;AAAA,QACN,UACE,cAAc,cAAc,cAAc,OAAO,WAAW,aAAa,WACrE,WAAW,SAAS,YAAY,IAChC;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAYO,SAAS,uBAAuB,MAAiD;AACtF,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,cAAe,QAAO;AACnC,MAAI,SAAS,SAAU,QAAO;AAC9B,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,gBAAiB,QAAO;AACrC,MAAI,SAAS,WAAY,QAAO;AAChC,MAAI,SAAS,OAAQ,QAAO;AAC5B,MAAI,SAAS,SAAU,QAAO;AAC9B,QAAM,IAAI,MAAM,+BAA+B,IAAI,EAAE;AACvD;","names":[]}
+{"version":3,"sources":["../../src/track/rdt.ts"],"sourcesContent":["import type { Item } from './gtag';\nimport type { EventName, TrackName, TrackProperties } from './types';\n\n/** https://business.reddithelp.com/s/article/about-event-metadata */\nexport type Product = {\n  /**\n   * (Required) Product ID: Either the SKU or GTIN, which represents the variant ID, not the\n   * parent ID. If there are no variants, pass the assigned ID for that item.\n   */\n  id: string;\n\n  /** (Optional) Product Category: The group the product belongs to. */\n  name?: string;\n\n  /** (Optional) Product Name: The title of the product. */\n  category?: string;\n};\n\n/**\n * https://business.reddithelp.com/s/article/supported-conversion-events#supported-conversion-events\n * https://business.reddithelp.com/s/article/about-event-metadata\n * https://business.reddithelp.com/s/article/map-a-catalog-to-a-signal-source\n */\nexport type StandardEvents = {\n  PageVisit: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  ViewContent: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  Search: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToCart: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToWishlist: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Purchase: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Lead: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n  SignUp: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n};\n\nexport type PixelId = `a2_${string}`;\n\nexport type MatchKeys = {\n  email?: string;\n  phoneNumber?: string;\n  externalId?: string;\n  idfa?: string;\n  aaid?: string;\n};\n\nexport type CustomEventParams<T extends string = string> = {\n  customEventName: T;\n  value?: number;\n  currency?: string;\n  itemCount?: number;\n  conversionId?: string;\n  products?: Product[];\n};\n\nexport interface RDT {\n  rdt(event: 'init', pixelId: PixelId, matchKeys?: MatchKeys): void;\n\n  rdt<T extends keyof StandardEvents>(event: 'track', type: T, params?: StandardEvents[T]): void;\n\n  rdt(event: 'track', type: 'Custom', params: CustomEventParams): void;\n}\n\ntype Mapped<F extends keyof StandardEvents> = [F, StandardEvents[F]];\ntype Missed<F extends string> = ['Custom', CustomEventParams<F>];\n\nexport function mapItems(items?: Item[]): undefined | Product[] {\n  if (!items || items.length === 0) return undefined;\n  return items.map((item) => ({\n    id: item.item_id,\n    name: item.item_name,\n    category: item.item_category,\n  }));\n}\n\nexport function mapRDTEvent<T extends EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  eventId?: string\n): Mapped<keyof StandardEvents> | Missed<TrackName<T>> {\n  // standard events\n  if (name === 'page_view') {\n    return ['PageVisit', { conversionId: eventId }];\n  } else if (name === 'view_item') {\n    return ['ViewContent', { conversionId: eventId }];\n  } else if (name === 'search') {\n    return ['Search', { conversionId: eventId }];\n  } else if (name === 'add_to_cart') {\n    const p = properties as TrackProperties<'add_to_cart'> | undefined;\n    return [\n      'AddToCart',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'add_to_wishlist') {\n    const p = properties as TrackProperties<'add_to_wishlist'> | undefined;\n    return [\n      'AddToWishlist',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'purchase') {\n    const p = properties as TrackProperties<'purchase'> | undefined;\n    return [\n      'Purchase',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'generate_lead') {\n    const p = properties as TrackProperties<'generate_lead'> | undefined;\n    return [\n      'Lead',\n      { conversionId: eventId, value: p?.value, currency: p?.currency.toUpperCase() },\n    ];\n  } else if (name === 'sign_up' || name === 'login') {\n    return ['SignUp', { conversionId: eventId }];\n  } else {\n    // custom event\n    return [\n      'Custom',\n      {\n        customEventName: name,\n        conversionId: eventId,\n        value:\n          properties && 'value' in properties && typeof properties.value === 'number'\n            ? properties.value\n            : undefined,\n        currency:\n          properties && 'currency' in properties && typeof properties.currency === 'string'\n            ? properties.currency.toUpperCase()\n            : undefined,\n      },\n    ];\n  }\n}\n\nexport type ServerStandardEvent =\n  | 'PAGE_VISIT'\n  | 'VIEW_CONTENT'\n  | 'SEARCH'\n  | 'ADD_TO_CART'\n  | 'ADD_TO_WISHLIST'\n  | 'PURCHASE'\n  | 'LEAD'\n  | 'SIGN_UP';\n\nexport function mapServerStandardEvent(name: keyof StandardEvents): ServerStandardEvent {\n  if (name === 'PageVisit') return 'PAGE_VISIT';\n  if (name === 'ViewContent') return 'VIEW_CONTENT';\n  if (name === 'Search') return 'SEARCH';\n  if (name === 'AddToCart') return 'ADD_TO_CART';\n  if (name === 'AddToWishlist') return 'ADD_TO_WISHLIST';\n  if (name === 'Purchase') return 'PURCHASE';\n  if (name === 'Lead') return 'LEAD';\n  if (name === 'SignUp') return 'SIGN_UP';\n  throw new Error(`Unsupported standard event: ${String(name)}`);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAqGO,SAAS,SAAS,OAAuC;AAC9D,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG,QAAO;AACzC,SAAO,MAAM,IAAI,CAAC,UAAU;AAAA,IAC1B,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,UAAU,KAAK;AAAA,EACjB,EAAE;AACJ;AAEO,SAAS,YACd,MACA,YACA,SACqD;AAlHvD;AAoHE,MAAI,SAAS,aAAa;AACxB,WAAO,CAAC,aAAa,EAAE,cAAc,QAAQ,CAAC;AAAA,EAChD,WAAW,SAAS,aAAa;AAC/B,WAAO,CAAC,eAAe,EAAE,cAAc,QAAQ,CAAC;AAAA,EAClD,WAAW,SAAS,UAAU;AAC5B,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,WAAW,SAAS,eAAe;AACjC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,mBAAmB;AACrC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,YAAY;AAC9B,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,iBAAiB;AACnC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA,EAAE,cAAc,SAAS,OAAO,uBAAG,OAAO,UAAU,uBAAG,SAAS,cAAc;AAAA,IAChF;AAAA,EACF,WAAW,SAAS,aAAa,SAAS,SAAS;AACjD,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,OAAO;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,iBAAiB;AAAA,QACjB,cAAc;AAAA,QACd,OACE,cAAc,WAAW,cAAc,OAAO,WAAW,UAAU,WAC/D,WAAW,QACX;AAAA,QACN,UACE,cAAc,cAAc,cAAc,OAAO,WAAW,aAAa,WACrE,WAAW,SAAS,YAAY,IAChC;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAYO,SAAS,uBAAuB,MAAiD;AACtF,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,cAAe,QAAO;AACnC,MAAI,SAAS,SAAU,QAAO;AAC9B,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,gBAAiB,QAAO;AACrC,MAAI,SAAS,WAAY,QAAO;AAChC,MAAI,SAAS,OAAQ,QAAO;AAC5B,MAAI,SAAS,SAAU,QAAO;AAC9B,QAAM,IAAI,MAAM,+BAA+B,OAAO,IAAI,CAAC,EAAE;AAC/D;","names":[]}

package/dist/track/rdt.mjs

@@ -80,7 +80,7 @@ function mapServerStandardEvent(name) {
   if (name === "Purchase") return "PURCHASE";
   if (name === "Lead") return "LEAD";
   if (name === "SignUp") return "SIGN_UP";
-  throw new Error(`Unsupported standard event: ${name}`);
+  throw new Error(`Unsupported standard event: ${String(name)}`);
 }
 export {
   mapItems,

package/dist/track/rdt.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/track/rdt.ts"],"sourcesContent":["import type { Item } from './gtag';\nimport type { EventName, TrackName, TrackProperties } from './types';\n\n/** https://business.reddithelp.com/s/article/about-event-metadata */\nexport type Product = {\n  /**\n   * (Required) Product ID: Either the SKU or GTIN, which represents the variant ID, not the\n   * parent ID. If there are no variants, pass the assigned ID for that item.\n   */\n  id: string;\n\n  /** (Optional) Product Category: The group the product belongs to. */\n  name?: string;\n\n  /** (Optional) Product Name: The title of the product. */\n  category?: string;\n};\n\n/**\n * https://business.reddithelp.com/s/article/supported-conversion-events#supported-conversion-events\n * https://business.reddithelp.com/s/article/about-event-metadata\n * https://business.reddithelp.com/s/article/map-a-catalog-to-a-signal-source\n */\nexport type StandardEvents = {\n  PageVisit: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  ViewContent: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  Search: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToCart: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToWishlist: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Purchase: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Lead: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n  SignUp: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n};\n\nexport type PixelId = `a2_${string}`;\n\nexport type MatchKeys = {\n  email?: string;\n  phoneNumber?: string;\n  externalId?: string;\n  idfa?: string;\n  aaid?: string;\n};\n\nexport type CustomEventParams<T extends string = string> = {\n  customEventName: T;\n  value?: number;\n  currency?: string;\n  itemCount?: number;\n  conversionId?: string;\n  products?: Product[];\n};\n\nexport interface RDT {\n  rdt(event: 'init', pixelId: PixelId, matchKeys?: MatchKeys): void;\n\n  rdt<T extends keyof StandardEvents>(event: 'track', type: T, params?: StandardEvents[T]): void;\n\n  rdt(event: 'track', type: 'Custom', params: CustomEventParams): void;\n}\n\ntype Mapped<F extends keyof StandardEvents> = [F, StandardEvents[F]];\ntype Missed<F extends string> = ['Custom', CustomEventParams<F>];\n\nexport function mapItems(items?: Item[]): undefined | Product[] {\n  if (!items || items.length === 0) return undefined;\n  return items.map((item) => ({\n    id: item.item_id,\n    name: item.item_name,\n    category: item.item_category,\n  }));\n}\n\nexport function mapRDTEvent<T extends EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  eventId?: string\n): Mapped<keyof StandardEvents> | Missed<TrackName<T>> {\n  // standard events\n  if (name === 'page_view') {\n    return ['PageVisit', { conversionId: eventId }];\n  } else if (name === 'view_item') {\n    return ['ViewContent', { conversionId: eventId }];\n  } else if (name === 'search') {\n    return ['Search', { conversionId: eventId }];\n  } else if (name === 'add_to_cart') {\n    const p = properties as TrackProperties<'add_to_cart'> | undefined;\n    return [\n      'AddToCart',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'add_to_wishlist') {\n    const p = properties as TrackProperties<'add_to_wishlist'> | undefined;\n    return [\n      'AddToWishlist',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'purchase') {\n    const p = properties as TrackProperties<'purchase'> | undefined;\n    return [\n      'Purchase',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'generate_lead') {\n    const p = properties as TrackProperties<'generate_lead'> | undefined;\n    return [\n      'Lead',\n      { conversionId: eventId, value: p?.value, currency: p?.currency.toUpperCase() },\n    ];\n  } else if (name === 'sign_up' || name === 'login') {\n    return ['SignUp', { conversionId: eventId }];\n  } else {\n    // custom event\n    return [\n      'Custom',\n      {\n        customEventName: name,\n        conversionId: eventId,\n        value:\n          properties && 'value' in properties && typeof properties.value === 'number'\n            ? properties.value\n            : undefined,\n        currency:\n          properties && 'currency' in properties && typeof properties.currency === 'string'\n            ? properties.currency.toUpperCase()\n            : undefined,\n      },\n    ];\n  }\n}\n\nexport type ServerStandardEvent =\n  | 'PAGE_VISIT'\n  | 'VIEW_CONTENT'\n  | 'SEARCH'\n  | 'ADD_TO_CART'\n  | 'ADD_TO_WISHLIST'\n  | 'PURCHASE'\n  | 'LEAD'\n  | 'SIGN_UP';\n\nexport function mapServerStandardEvent(name: keyof StandardEvents): ServerStandardEvent {\n  if (name === 'PageVisit') return 'PAGE_VISIT';\n  if (name === 'ViewContent') return 'VIEW_CONTENT';\n  if (name === 'Search') return 'SEARCH';\n  if (name === 'AddToCart') return 'ADD_TO_CART';\n  if (name === 'AddToWishlist') return 'ADD_TO_WISHLIST';\n  if (name === 'Purchase') return 'PURCHASE';\n  if (name === 'Lead') return 'LEAD';\n  if (name === 'SignUp') return 'SIGN_UP';\n  throw new Error(`Unsupported standard event: ${name}`);\n}\n"],"mappings":";AAqGO,SAAS,SAAS,OAAuC;AAC9D,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG,QAAO;AACzC,SAAO,MAAM,IAAI,CAAC,UAAU;AAAA,IAC1B,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,UAAU,KAAK;AAAA,EACjB,EAAE;AACJ;AAEO,SAAS,YACd,MACA,YACA,SACqD;AAlHvD;AAoHE,MAAI,SAAS,aAAa;AACxB,WAAO,CAAC,aAAa,EAAE,cAAc,QAAQ,CAAC;AAAA,EAChD,WAAW,SAAS,aAAa;AAC/B,WAAO,CAAC,eAAe,EAAE,cAAc,QAAQ,CAAC;AAAA,EAClD,WAAW,SAAS,UAAU;AAC5B,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,WAAW,SAAS,eAAe;AACjC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,mBAAmB;AACrC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,YAAY;AAC9B,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,iBAAiB;AACnC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA,EAAE,cAAc,SAAS,OAAO,uBAAG,OAAO,UAAU,uBAAG,SAAS,cAAc;AAAA,IAChF;AAAA,EACF,WAAW,SAAS,aAAa,SAAS,SAAS;AACjD,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,OAAO;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,iBAAiB;AAAA,QACjB,cAAc;AAAA,QACd,OACE,cAAc,WAAW,cAAc,OAAO,WAAW,UAAU,WAC/D,WAAW,QACX;AAAA,QACN,UACE,cAAc,cAAc,cAAc,OAAO,WAAW,aAAa,WACrE,WAAW,SAAS,YAAY,IAChC;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAYO,SAAS,uBAAuB,MAAiD;AACtF,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,cAAe,QAAO;AACnC,MAAI,SAAS,SAAU,QAAO;AAC9B,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,gBAAiB,QAAO;AACrC,MAAI,SAAS,WAAY,QAAO;AAChC,MAAI,SAAS,OAAQ,QAAO;AAC5B,MAAI,SAAS,SAAU,QAAO;AAC9B,QAAM,IAAI,MAAM,+BAA+B,IAAI,EAAE;AACvD;","names":[]}
+{"version":3,"sources":["../../src/track/rdt.ts"],"sourcesContent":["import type { Item } from './gtag';\nimport type { EventName, TrackName, TrackProperties } from './types';\n\n/** https://business.reddithelp.com/s/article/about-event-metadata */\nexport type Product = {\n  /**\n   * (Required) Product ID: Either the SKU or GTIN, which represents the variant ID, not the\n   * parent ID. If there are no variants, pass the assigned ID for that item.\n   */\n  id: string;\n\n  /** (Optional) Product Category: The group the product belongs to. */\n  name?: string;\n\n  /** (Optional) Product Name: The title of the product. */\n  category?: string;\n};\n\n/**\n * https://business.reddithelp.com/s/article/supported-conversion-events#supported-conversion-events\n * https://business.reddithelp.com/s/article/about-event-metadata\n * https://business.reddithelp.com/s/article/map-a-catalog-to-a-signal-source\n */\nexport type StandardEvents = {\n  PageVisit: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  ViewContent: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  Search: {\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToCart: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  AddToWishlist: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Purchase: {\n    value?: number;\n    currency?: string;\n    itemCount?: number;\n    conversionId?: string;\n    products?: Product[];\n  };\n  Lead: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n  SignUp: {\n    value?: number;\n    currency?: string;\n    conversionId?: string;\n    products?: Product[];\n  };\n};\n\nexport type PixelId = `a2_${string}`;\n\nexport type MatchKeys = {\n  email?: string;\n  phoneNumber?: string;\n  externalId?: string;\n  idfa?: string;\n  aaid?: string;\n};\n\nexport type CustomEventParams<T extends string = string> = {\n  customEventName: T;\n  value?: number;\n  currency?: string;\n  itemCount?: number;\n  conversionId?: string;\n  products?: Product[];\n};\n\nexport interface RDT {\n  rdt(event: 'init', pixelId: PixelId, matchKeys?: MatchKeys): void;\n\n  rdt<T extends keyof StandardEvents>(event: 'track', type: T, params?: StandardEvents[T]): void;\n\n  rdt(event: 'track', type: 'Custom', params: CustomEventParams): void;\n}\n\ntype Mapped<F extends keyof StandardEvents> = [F, StandardEvents[F]];\ntype Missed<F extends string> = ['Custom', CustomEventParams<F>];\n\nexport function mapItems(items?: Item[]): undefined | Product[] {\n  if (!items || items.length === 0) return undefined;\n  return items.map((item) => ({\n    id: item.item_id,\n    name: item.item_name,\n    category: item.item_category,\n  }));\n}\n\nexport function mapRDTEvent<T extends EventName>(\n  name: TrackName<T>,\n  properties?: TrackProperties<T>,\n  eventId?: string\n): Mapped<keyof StandardEvents> | Missed<TrackName<T>> {\n  // standard events\n  if (name === 'page_view') {\n    return ['PageVisit', { conversionId: eventId }];\n  } else if (name === 'view_item') {\n    return ['ViewContent', { conversionId: eventId }];\n  } else if (name === 'search') {\n    return ['Search', { conversionId: eventId }];\n  } else if (name === 'add_to_cart') {\n    const p = properties as TrackProperties<'add_to_cart'> | undefined;\n    return [\n      'AddToCart',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'add_to_wishlist') {\n    const p = properties as TrackProperties<'add_to_wishlist'> | undefined;\n    return [\n      'AddToWishlist',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'purchase') {\n    const p = properties as TrackProperties<'purchase'> | undefined;\n    return [\n      'Purchase',\n      {\n        conversionId: eventId,\n        value: p?.value,\n        currency: p?.currency.toUpperCase(),\n        itemCount: p?.items?.reduce((acc, i) => acc + (i.quantity ?? 1), 0),\n        products: mapItems(p?.items),\n      },\n    ];\n  } else if (name === 'generate_lead') {\n    const p = properties as TrackProperties<'generate_lead'> | undefined;\n    return [\n      'Lead',\n      { conversionId: eventId, value: p?.value, currency: p?.currency.toUpperCase() },\n    ];\n  } else if (name === 'sign_up' || name === 'login') {\n    return ['SignUp', { conversionId: eventId }];\n  } else {\n    // custom event\n    return [\n      'Custom',\n      {\n        customEventName: name,\n        conversionId: eventId,\n        value:\n          properties && 'value' in properties && typeof properties.value === 'number'\n            ? properties.value\n            : undefined,\n        currency:\n          properties && 'currency' in properties && typeof properties.currency === 'string'\n            ? properties.currency.toUpperCase()\n            : undefined,\n      },\n    ];\n  }\n}\n\nexport type ServerStandardEvent =\n  | 'PAGE_VISIT'\n  | 'VIEW_CONTENT'\n  | 'SEARCH'\n  | 'ADD_TO_CART'\n  | 'ADD_TO_WISHLIST'\n  | 'PURCHASE'\n  | 'LEAD'\n  | 'SIGN_UP';\n\nexport function mapServerStandardEvent(name: keyof StandardEvents): ServerStandardEvent {\n  if (name === 'PageVisit') return 'PAGE_VISIT';\n  if (name === 'ViewContent') return 'VIEW_CONTENT';\n  if (name === 'Search') return 'SEARCH';\n  if (name === 'AddToCart') return 'ADD_TO_CART';\n  if (name === 'AddToWishlist') return 'ADD_TO_WISHLIST';\n  if (name === 'Purchase') return 'PURCHASE';\n  if (name === 'Lead') return 'LEAD';\n  if (name === 'SignUp') return 'SIGN_UP';\n  throw new Error(`Unsupported standard event: ${String(name)}`);\n}\n"],"mappings":";AAqGO,SAAS,SAAS,OAAuC;AAC9D,MAAI,CAAC,SAAS,MAAM,WAAW,EAAG,QAAO;AACzC,SAAO,MAAM,IAAI,CAAC,UAAU;AAAA,IAC1B,IAAI,KAAK;AAAA,IACT,MAAM,KAAK;AAAA,IACX,UAAU,KAAK;AAAA,EACjB,EAAE;AACJ;AAEO,SAAS,YACd,MACA,YACA,SACqD;AAlHvD;AAoHE,MAAI,SAAS,aAAa;AACxB,WAAO,CAAC,aAAa,EAAE,cAAc,QAAQ,CAAC;AAAA,EAChD,WAAW,SAAS,aAAa;AAC/B,WAAO,CAAC,eAAe,EAAE,cAAc,QAAQ,CAAC;AAAA,EAClD,WAAW,SAAS,UAAU;AAC5B,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,WAAW,SAAS,eAAe;AACjC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,mBAAmB;AACrC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,YAAY;AAC9B,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,cAAc;AAAA,QACd,OAAO,uBAAG;AAAA,QACV,UAAU,uBAAG,SAAS;AAAA,QACtB,YAAW,4BAAG,UAAH,mBAAU,OAAO,CAAC,KAAK,MAAM,OAAO,EAAE,YAAY,IAAI;AAAA,QACjE,UAAU,SAAS,uBAAG,KAAK;AAAA,MAC7B;AAAA,IACF;AAAA,EACF,WAAW,SAAS,iBAAiB;AACnC,UAAM,IAAI;AACV,WAAO;AAAA,MACL;AAAA,MACA,EAAE,cAAc,SAAS,OAAO,uBAAG,OAAO,UAAU,uBAAG,SAAS,cAAc;AAAA,IAChF;AAAA,EACF,WAAW,SAAS,aAAa,SAAS,SAAS;AACjD,WAAO,CAAC,UAAU,EAAE,cAAc,QAAQ,CAAC;AAAA,EAC7C,OAAO;AAEL,WAAO;AAAA,MACL;AAAA,MACA;AAAA,QACE,iBAAiB;AAAA,QACjB,cAAc;AAAA,QACd,OACE,cAAc,WAAW,cAAc,OAAO,WAAW,UAAU,WAC/D,WAAW,QACX;AAAA,QACN,UACE,cAAc,cAAc,cAAc,OAAO,WAAW,aAAa,WACrE,WAAW,SAAS,YAAY,IAChC;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAYO,SAAS,uBAAuB,MAAiD;AACtF,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,cAAe,QAAO;AACnC,MAAI,SAAS,SAAU,QAAO;AAC9B,MAAI,SAAS,YAAa,QAAO;AACjC,MAAI,SAAS,gBAAiB,QAAO;AACrC,MAAI,SAAS,WAAY,QAAO;AAChC,MAAI,SAAS,OAAQ,QAAO;AAC5B,MAAI,SAAS,SAAU,QAAO;AAC9B,QAAM,IAAI,MAAM,+BAA+B,OAAO,IAAI,CAAC,EAAE;AAC/D;","names":[]}