@stacksjs/analytics 0.74.67 → 0.74.69

package/dist/drivers/analyticshq.d.ts

@@ -0,0 +1,18 @@
+import type { AnalyticsHeadTag } from './shared';
+/**
+ * Build the AnalyticsHQ head tags. Values are raw; escaping happens when the
+ * tags are rendered.
+ */
+export declare function getAnalyticsHqHead(config: AnalyticsHqConfig): AnalyticsHeadTag[];
+/**
+ * Generate the AnalyticsHQ tracking script tag.
+ */
+export declare function generateAnalyticsHqScript(config: AnalyticsHqConfig): string;
+/** The hosted script, used when `scriptUrl` is not set. */
+export declare const ANALYTICSHQ_DEFAULT_SCRIPT: 'https://analyticshq.org/script.js';
+export declare interface AnalyticsHqConfig {
+  siteId: string
+  scriptUrl?: string
+  respectDnt?: boolean
+  vitals?: boolean
+}

package/dist/drivers/analyticshq.js

@@ -0,0 +1,2 @@
+import{renderHeadTags}from"./shared";export const ANALYTICSHQ_DEFAULT_SCRIPT="https://analyticshq.org/script.js";export function getAnalyticsHqHead(config){if(!config.siteId)return[];const attributes={src:config.scriptUrl||ANALYTICSHQ_DEFAULT_SCRIPT,"data-site":config.siteId,defer:""};if(config.respectDnt===!1)attributes["data-respect-dnt"]="false";if(config.vitals===!1)attributes["data-vitals"]="false";return[["script",attributes]]}export function generateAnalyticsHqScript(config){const tags=getAnalyticsHqHead(config);if(!tags.length)return"";return`<!-- Stacks AnalyticsHQ -->
+${renderHeadTags(tags)}`}

package/dist/drivers/index.d.ts

@@ -1,3 +1,4 @@
+export * from './analyticshq';
 export * from './fathom';
 export * from './google-analytics';
 export * from './plausible';

package/dist/drivers/index.js

@@ -1 +1 @@
-export*from"./fathom";export*from"./google-analytics";export*from"./plausible";export*from"./self-hosted";export*from"./shared";
+export*from"./analyticshq";export*from"./fathom";export*from"./google-analytics";export*from"./plausible";export*from"./self-hosted";export*from"./shared";

package/dist/registry.js

@@ -1 +1 @@
-import{getFathomAnalyticsHead}from"./drivers/fathom";import{getGoogleAnalyticsHead}from"./drivers/google-analytics";import{getPlausibleAnalyticsHead}from"./drivers/plausible";import{getSelfHostedAnalyticsHead}from"./drivers/self-hosted";import{renderHeadTags}from"./drivers/shared";export const ANALYTICS_DRIVERS=["google-analytics","fathom","plausible","self-hosted"];export function isAnalyticsDriver(value){return typeof value==="string"&&ANALYTICS_DRIVERS.includes(value)}function misconfigured(driver,key,field){return Error(`Analytics driver "${driver}" is selected but not configured: set \`drivers.${key}.${field}\` in config/analytics.ts, or change \`driver\`.`)}export function getAnalyticsHead(config){const driver=config.driver;if(!driver)return[];if(!isAnalyticsDriver(driver))throw Error(`Unknown analytics driver "${String(driver)}". Available drivers: ${ANALYTICS_DRIVERS.join(", ")}.`);switch(driver){case"google-analytics":{const options=config.drivers?.googleAnalytics;if(!options?.trackingId)throw misconfigured(driver,"googleAnalytics","trackingId");return getGoogleAnalyticsHead(options)}case"fathom":{const options=config.drivers?.fathom;if(!options?.siteId)throw misconfigured(driver,"fathom","siteId");return getFathomAnalyticsHead(options)}case"plausible":{const options=config.drivers?.plausible;if(!options?.domain)throw misconfigured(driver,"plausible","domain");return getPlausibleAnalyticsHead(options)}case"self-hosted":{const options=config.drivers?.selfHosted;if(!options?.siteId)throw misconfigured(driver,"selfHosted","siteId");if(!options.apiEndpoint)throw misconfigured(driver,"selfHosted","apiEndpoint");return getSelfHostedAnalyticsHead(options)}default:throw Error(`Analytics driver "${String(driver)}" has no implementation.`)}}export function generateAnalyticsScript(config){const tags=getAnalyticsHead(config);if(!tags.length)return"";return renderHeadTags(tags)}
+import{getAnalyticsHqHead}from"./drivers/analyticshq";import{getFathomAnalyticsHead}from"./drivers/fathom";import{getGoogleAnalyticsHead}from"./drivers/google-analytics";import{getPlausibleAnalyticsHead}from"./drivers/plausible";import{getSelfHostedAnalyticsHead}from"./drivers/self-hosted";import{renderHeadTags}from"./drivers/shared";export const ANALYTICS_DRIVERS=["google-analytics","fathom","plausible","self-hosted","analyticshq"];export function isAnalyticsDriver(value){return typeof value==="string"&&ANALYTICS_DRIVERS.includes(value)}function misconfigured(driver,key,field){return Error(`Analytics driver "${driver}" is selected but not configured: set \`drivers.${key}.${field}\` in config/analytics.ts, or change \`driver\`.`)}export function getAnalyticsHead(config){const driver=config.driver;if(!driver)return[];if(!isAnalyticsDriver(driver))throw Error(`Unknown analytics driver "${String(driver)}". Available drivers: ${ANALYTICS_DRIVERS.join(", ")}.`);switch(driver){case"google-analytics":{const options=config.drivers?.googleAnalytics;if(!options?.trackingId)throw misconfigured(driver,"googleAnalytics","trackingId");return getGoogleAnalyticsHead(options)}case"fathom":{const options=config.drivers?.fathom;if(!options?.siteId)throw misconfigured(driver,"fathom","siteId");return getFathomAnalyticsHead(options)}case"plausible":{const options=config.drivers?.plausible;if(!options?.domain)throw misconfigured(driver,"plausible","domain");return getPlausibleAnalyticsHead(options)}case"self-hosted":{const options=config.drivers?.selfHosted;if(!options?.siteId)throw misconfigured(driver,"selfHosted","siteId");if(!options.apiEndpoint)throw misconfigured(driver,"selfHosted","apiEndpoint");return getSelfHostedAnalyticsHead(options)}case"analyticshq":{const options=config.drivers?.analyticshq;if(!options?.siteId)throw misconfigured(driver,"analyticshq","siteId");return getAnalyticsHqHead(options)}default:throw Error(`Analytics driver "${String(driver)}" has no implementation.`)}}export function generateAnalyticsScript(config){const tags=getAnalyticsHead(config);if(!tags.length)return"";return renderHeadTags(tags)}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/analytics",
   "type": "module",
   "sideEffects": false,
-  "version": "0.74.67",
+  "version": "0.74.69",
   "description": "Stacks Analytics. Privacy-friendly.",
   "author": "Chris Breuer",
   "contributors": [
@@ -51,8 +51,8 @@
     "prepublishOnly": "bun run build"
   },
   "dependencies": {
-    "@stacksjs/database": "0.74.67",
-    "@stacksjs/types": "0.74.67"
+    "@stacksjs/database": "0.74.69",
+    "@stacksjs/types": "0.74.69"
   },
   "devDependencies": {
     "better-dx": "^0.2.24"