@c15t/scripts 2.0.1 → 2.1.0

package/dist-types/vendors/analytics/umami-analytics.d.ts

@@ -0,0 +1,93 @@
+import type { Script } from 'c15t';
+declare global {
+    interface Window {
+        umami?: {
+            identify: (sessionData?: Record<string, unknown> | string) => void;
+            track: {
+                (payload?: Record<string, unknown>): void;
+                (eventName: string, eventData?: Record<string, unknown>): void;
+            };
+        };
+    }
+}
+/**
+ * Umami Analytics vendor manifest.
+ *
+ * Configures Umami entirely through script `data-*` attributes. Umami is a
+ * cookieless analytics product, so the script is consent-gated on
+ * `measurement` and unloaded when consent is revoked.
+ */
+export declare const umamiAnalyticsManifest: {
+    readonly vendor: "umami-analytics";
+    readonly category: "measurement";
+    readonly install: [{
+        readonly type: "loadScript";
+        readonly src: "{{scriptUrl}}";
+        readonly defer: true;
+        readonly attributes: {
+            readonly 'data-website-id': "{{websiteId}}";
+            readonly 'data-host-url': "{{hostUrl}}";
+            readonly 'data-auto-track': "{{autoTrackAttribute}}";
+            readonly 'data-domains': "{{domains}}";
+            readonly 'data-tag': "{{tag}}";
+            readonly 'data-before-send': "{{beforeSend}}";
+        };
+    }];
+    readonly kind: "c15t.vendor-manifest";
+    readonly schemaVersion: 1;
+};
+export interface UmamiAnalyticsOptions {
+    /**
+     * Your Umami website ID.
+     */
+    websiteId: string;
+    /**
+     * Override the host that receives analytics events.
+     */
+    hostUrl?: string;
+    /**
+     * Disable automatic tracking when set to `false`.
+     */
+    autoTrack?: boolean;
+    /**
+     * Restrict tracking to specific domains.
+     */
+    domains?: string[] | string;
+    /**
+     * Attach a tag to tracked events.
+     */
+    tag?: string;
+    /**
+     * Optional global hook name used for Umami's `data-before-send` attribute.
+     *
+     * Callback functions are intentionally not supported here because the c15t
+     * manifest runtime cannot serialize custom JavaScript functions.
+     */
+    beforeSend?: string;
+    /**
+     * Custom loader URL.
+     * @default 'https://cloud.umami.is/script.js'
+     */
+    scriptUrl?: string;
+}
+/**
+ * Creates an Umami Analytics script.
+ *
+ * @see https://umami.is/docs/tracker-config
+ *
+ * @param options - The options for the Umami Analytics script.
+ * @returns The Umami Analytics script.
+ * @throws {Error} When `websiteId` is missing, empty, or invalid. Provide a
+ * valid non-empty `websiteId` string to prevent this error.
+ *
+ * @example
+ * ```ts
+ * import { umamiAnalytics } from '@c15t/scripts/umami-analytics';
+ *
+ * umamiAnalytics({
+ *   websiteId: 'site-abc-123',
+ *   domains: ['example.com', 'www.example.com'],
+ * });
+ * ```
+ */
+export declare function umamiAnalytics(options: UmamiAnalyticsOptions): Script;

package/dist-types/vendors/analytics/vercel-analytics.d.ts

@@ -0,0 +1,66 @@
+import type { Script } from 'c15t';
+export type VercelAnalyticsMode = 'auto' | 'development' | 'production';
+declare global {
+    interface Window {
+        va?: (event: string, properties?: unknown) => void;
+        vaq?: [string, unknown?][];
+        vam?: 'development' | 'production';
+    }
+}
+/**
+ * Vercel Analytics vendor manifest.
+ *
+ * Seeds Vercel's event queue before loading the tracker bundle.
+ */
+export declare const vercelAnalyticsManifest: {
+    readonly vendor: "vercel-analytics";
+    readonly category: "measurement";
+    readonly bootstrap: [{
+        readonly type: "setGlobal";
+        readonly name: "vaq";
+        readonly value: readonly [];
+        readonly ifUndefined: true;
+    }, {
+        readonly type: "defineStubFunction";
+        readonly name: "va";
+        readonly queue: {
+            readonly global: "vaq";
+        };
+        readonly queueFormat: "array";
+        readonly ifUndefined: true;
+    }];
+    readonly install: [{
+        readonly type: "loadScript";
+        readonly src: "{{scriptUrl}}";
+        readonly defer: true;
+        readonly attributes: {
+            readonly 'data-sdkn': "c15t";
+            readonly 'data-dsn': "{{dsn}}";
+            readonly 'data-disable-auto-track': "{{disableAutoTrackAttribute}}";
+            readonly 'data-endpoint': "{{endpoint}}";
+        };
+    }];
+    readonly kind: "c15t.vendor-manifest";
+    readonly schemaVersion: 1;
+};
+export interface VercelAnalyticsOptions {
+    /** Project DSN for self-hosted or non-Vercel deployments. */
+    dsn?: string;
+    /** Disable automatic pageview tracking. */
+    disableAutoTrack?: boolean;
+    /** Preferred script mode. */
+    mode?: VercelAnalyticsMode;
+    /** Load Vercel's debug bundle when set to `true`. */
+    debug?: boolean;
+    /** Custom ingestion endpoint. */
+    endpoint?: string;
+    /** Custom loader URL. */
+    scriptUrl?: string;
+}
+/**
+ * Creates a Vercel Analytics script.
+ *
+ * @param options - The options for the Vercel Analytics script.
+ * @returns The Vercel Analytics script.
+ */
+export declare function vercelAnalytics(options?: VercelAnalyticsOptions): Script;

package/dist-types/vendors/functional/crisp.d.ts

@@ -0,0 +1,78 @@
+import type { Script } from 'c15t';
+declare global {
+    interface Window {
+        $crisp: unknown[][];
+        CRISP_WEBSITE_ID: string;
+        CRISP_RUNTIME_CONFIG?: {
+            locale?: string;
+            session_merge?: boolean;
+        };
+        CRISP_COOKIE_DOMAIN?: string;
+        CRISP_COOKIE_EXPIRE?: number;
+        CRISP_TOKEN_ID?: string;
+    }
+}
+/**
+ * Crisp vendor manifest.
+ *
+ * Seeds the Crisp queue and website ID before loading the chat client.
+ * Optional runtime globals are added when provided by the helper options.
+ */
+export declare const crispManifest: {
+    readonly vendor: "crisp";
+    readonly category: "functionality";
+    readonly install: [{
+        readonly type: "setGlobal";
+        readonly name: "$crisp";
+        readonly value: readonly [];
+        readonly ifUndefined: false;
+    }, {
+        readonly type: "setGlobal";
+        readonly name: "CRISP_WEBSITE_ID";
+        readonly value: "{{websiteId}}";
+        readonly ifUndefined: false;
+    }, {
+        readonly type: "loadScript";
+        readonly src: "{{scriptSrc}}";
+        readonly async: true;
+    }];
+    readonly kind: "c15t.vendor-manifest";
+    readonly schemaVersion: 1;
+};
+export interface CrispOptions {
+    /** Your Crisp website ID. */
+    websiteId: string;
+    /** Optional locale passed through `window.CRISP_RUNTIME_CONFIG`. */
+    locale?: string;
+    /** Optional cookie domain override for Crisp. */
+    cookieDomain?: string;
+    /** Optional cookie expiration in seconds. */
+    cookieExpiry?: number;
+    /** Optional Crisp token ID for session continuity. */
+    tokenId?: string;
+    /** Whether to merge anonymous sessions into token-backed sessions. */
+    sessionMerge?: boolean;
+    /** Whether to enable `$crisp` safe mode before other queued calls. */
+    safeMode?: boolean;
+    /** Crisp loader URL. */
+    scriptSrc?: string;
+}
+/**
+ * Creates a Crisp chat script.
+ *
+ * This manifest-based helper keeps the serializable queue/bootstrap globals and
+ * omits the upstream ready callback wrapper.
+ *
+ * @param options - The options for the Crisp script.
+ * @returns The Crisp script configuration.
+ *
+ * @example
+ * ```ts
+ * const crispScript = crisp({
+ * 	websiteId: '1234-abcd',
+ * });
+ * ```
+ *
+ * @see {@link https://help.crisp.chat/en/article/how-do-i-install-crisp-live-chat-on-my-website-10wcj3l/} Crisp installation documentation.
+ */
+export declare function crisp(options: CrispOptions): Script;

package/dist-types/vendors/functional/intercom.d.ts

@@ -0,0 +1,135 @@
+import type { Script } from 'c15t';
+export declare const INTERCOM_API_BASES: {
+    readonly us: "https://api-iam.intercom.io";
+    readonly eu: "https://api-iam.eu.intercom.io";
+    readonly au: "https://api-iam.au.intercom.io";
+};
+export type IntercomApiBase = (typeof INTERCOM_API_BASES)[keyof typeof INTERCOM_API_BASES] | (string & {});
+export type IntercomThemeMode = 'light' | 'dark' | 'system';
+export interface IntercomAvatar {
+    type: 'avatar';
+    image_url: string;
+}
+export interface IntercomCompany {
+    id?: string;
+    company_id?: string;
+    name?: string;
+    created_at?: number;
+    remote_created_at?: number;
+    plan?: string;
+    monthly_spend?: number;
+    size?: number;
+    website?: string;
+    industry?: string;
+    [key: string]: unknown;
+}
+export interface IntercomSettings extends Record<string, unknown> {
+    app_id: string;
+    api_base: IntercomApiBase;
+    custom_launcher_selector?: string;
+    alignment?: 'left' | 'right';
+    vertical_padding?: number;
+    horizontal_padding?: number;
+    z_index?: number;
+    hide_default_launcher?: boolean;
+    hide_notifications?: boolean;
+    theme_mode?: IntercomThemeMode;
+    session_duration?: number;
+    action_color?: string;
+    background_color?: string;
+    link_color?: string;
+    email?: string;
+    user_id?: string;
+    created_at?: number;
+    name?: string;
+    phone?: string;
+    unsubscribed_from_emails?: boolean;
+    language_override?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+    utm_medium?: string;
+    utm_source?: string;
+    utm_term?: string;
+    avatar?: IntercomAvatar;
+    user_hash?: string;
+    company?: IntercomCompany;
+    companies?: IntercomCompany[];
+    page_title?: string;
+}
+export type IntercomCustomSettings = Partial<Omit<IntercomSettings, 'app_id' | 'api_base'>> & Record<string, unknown>;
+declare global {
+    interface Window {
+        Intercom?: ((...args: unknown[]) => void) & {
+            q?: unknown[][];
+        };
+        intercomSettings?: IntercomSettings;
+    }
+}
+/**
+ * Intercom vendor manifest.
+ *
+ * Seeds `window.intercomSettings` and a queueing `Intercom` stub before loading
+ * the messenger widget bundle.
+ */
+export declare const intercomManifest: {
+    readonly vendor: "intercom";
+    readonly category: "functionality";
+    readonly install: [{
+        readonly type: "defineStubFunction";
+        readonly name: "Intercom";
+        readonly queue: {
+            readonly property: "q";
+        };
+        readonly queueFormat: "array";
+        readonly ifUndefined: true;
+    }, {
+        readonly type: "setGlobal";
+        readonly name: "intercomSettings";
+        readonly value: "{{settings}}";
+        readonly ifUndefined: false;
+    }, {
+        readonly type: "loadScript";
+        readonly src: "{{scriptSrc}}";
+        readonly async: true;
+    }];
+    readonly kind: "c15t.vendor-manifest";
+    readonly schemaVersion: 1;
+};
+export interface IntercomOptions {
+    /**
+     * Your Intercom app ID.
+     */
+    appId: string;
+    /**
+     * Regional Intercom API base.
+     *
+     * @default 'https://api-iam.intercom.io'
+     */
+    apiBase?: IntercomApiBase;
+    /**
+     * Additional serializable Intercom settings merged into
+     * `window.intercomSettings`.
+     */
+    settings?: IntercomCustomSettings;
+    /** Intercom loader URL. */
+    scriptSrc?: string;
+}
+/**
+ * Creates an Intercom messenger script.
+ *
+ * The helper bootstraps the documented Intercom settings object and queues
+ * early `Intercom(...)` calls until the messenger bundle loads.
+ *
+ * @param options - The options for the Intercom script.
+ * @returns The Intercom script configuration.
+ *
+ * @example
+ * ```ts
+ * const intercomScript = intercom({
+ * 	appId: 'abc123',
+ * });
+ * ```
+ *
+ * @see {@link https://developers.intercom.com/installing-intercom/web/installation} Intercom installation documentation.
+ */
+export declare function intercom({ appId, apiBase, settings, scriptSrc, }: IntercomOptions): Script;

package/dist-types/{google-tag-manager.d.ts → vendors/tag-managers/google-tag-manager.d.ts}

@@ -32,7 +32,10 @@ export declare const googleTagManagerManifest: {
         readonly type: "pushToQueue";
         readonly queue: "dataLayer";
         readonly value: {
-            readonly 'gtm.start': "{{loadTime}}";
+            readonly 'gtm.start': {
+                readonly kind: "c15t.runtime-value";
+                readonly value: "timestamp";
+            };
             readonly event: "gtm.js";
         };
     }, {
@@ -45,13 +48,7 @@ export declare const googleTagManagerManifest: {
         readonly global: "gtag";
         readonly args: ["event", "{{updateEventName}}"];
     }];
-    readonly consentMapping: {
-        readonly necessary: ["security_storage"];
-        readonly functionality: ["functionality_storage"];
-        readonly measurement: ["analytics_storage"];
-        readonly marketing: ["ad_storage", "ad_user_data", "ad_personalization"];
-        readonly experience: ["personalization_storage"];
-    };
+    readonly consentMapping: Record<string, string[]>;
     readonly consentSignal: "gtag";
     readonly kind: "c15t.vendor-manifest";
     readonly schemaVersion: 1;

package/package.json

@@ -1,8 +1,34 @@
 {
 	"name": "@c15t/scripts",
-	"version": "2.0.1",
-	"description": "Pre-built scripts of popular tools for c15t's script loader.",
+	"version": "2.1.0",
+	"description": "Pre-built scripts for c15t's script loader (GTM, GA4, Meta).",
+	"keywords": [
+		"c15t",
+		"script-loader",
+		"consent",
+		"gdpr",
+		"ccpa",
+		"lgpd",
+		"gtm",
+		"google-tag-manager",
+		"google-tag",
+		"ga4",
+		"google-ads",
+		"meta-pixel",
+		"posthog",
+		"tiktok-pixel",
+		"linkedin-insights",
+		"microsoft-uet",
+		"x-pixel",
+		"analytics-consent",
+		"consent-mode",
+		"privacy",
+		"cmp"
+	],
 	"homepage": "https://c15t.com/docs/frameworks/javascript/script-loader",
+	"bugs": {
+		"url": "https://github.com/c15t/c15t/issues"
+	},
 	"repository": {
 		"type": "git",
 		"url": "https://github.com/c15t/c15t.git",
@@ -12,6 +38,141 @@
 	"sideEffects": false,
 	"type": "module",
 	"exports": {
+		"./ahrefs-analytics": {
+			"types": "./dist-types/vendors/analytics/ahrefs-analytics.d.ts",
+			"import": "./dist/vendors/analytics/ahrefs-analytics.js",
+			"require": "./dist/vendors/analytics/ahrefs-analytics.cjs"
+		},
+		"./cloudflare-web-analytics": {
+			"types": "./dist-types/vendors/analytics/cloudflare-web-analytics.d.ts",
+			"import": "./dist/vendors/analytics/cloudflare-web-analytics.js",
+			"require": "./dist/vendors/analytics/cloudflare-web-analytics.cjs"
+		},
+		"./microsoft-clarity": {
+			"types": "./dist-types/vendors/analytics/microsoft-clarity.d.ts",
+			"import": "./dist/vendors/analytics/microsoft-clarity.js",
+			"require": "./dist/vendors/analytics/microsoft-clarity.cjs"
+		},
+		"./databuddy": {
+			"types": "./dist-types/vendors/analytics/databuddy.d.ts",
+			"import": "./dist/vendors/analytics/databuddy.js",
+			"require": "./dist/vendors/analytics/databuddy.cjs"
+		},
+		"./fathom-analytics": {
+			"types": "./dist-types/vendors/analytics/fathom-analytics.d.ts",
+			"import": "./dist/vendors/analytics/fathom-analytics.js",
+			"require": "./dist/vendors/analytics/fathom-analytics.cjs"
+		},
+		"./hotjar": {
+			"types": "./dist-types/vendors/analytics/hotjar.d.ts",
+			"import": "./dist/vendors/analytics/hotjar.js",
+			"require": "./dist/vendors/analytics/hotjar.cjs"
+		},
+		"./google-tag": {
+			"types": "./dist-types/vendors/analytics/google-tag.d.ts",
+			"import": "./dist/vendors/analytics/google-tag.js",
+			"require": "./dist/vendors/analytics/google-tag.cjs"
+		},
+		"./matomo-analytics": {
+			"types": "./dist-types/vendors/analytics/matomo-analytics.d.ts",
+			"import": "./dist/vendors/analytics/matomo-analytics.js",
+			"require": "./dist/vendors/analytics/matomo-analytics.cjs"
+		},
+		"./mixpanel-analytics": {
+			"types": "./dist-types/vendors/analytics/mixpanel-analytics.d.ts",
+			"import": "./dist/vendors/analytics/mixpanel-analytics.js",
+			"require": "./dist/vendors/analytics/mixpanel-analytics.cjs"
+		},
+		"./plausible-analytics": {
+			"types": "./dist-types/vendors/analytics/plausible-analytics.d.ts",
+			"import": "./dist/vendors/analytics/plausible-analytics.js",
+			"require": "./dist/vendors/analytics/plausible-analytics.cjs"
+		},
+		"./posthog": {
+			"types": "./dist-types/vendors/analytics/posthog.d.ts",
+			"import": "./dist/vendors/analytics/posthog.js",
+			"require": "./dist/vendors/analytics/posthog.cjs"
+		},
+		"./promptwatch": {
+			"types": "./dist-types/vendors/analytics/promptwatch.d.ts",
+			"import": "./dist/vendors/analytics/promptwatch.js",
+			"require": "./dist/vendors/analytics/promptwatch.cjs"
+		},
+		"./segment": {
+			"types": "./dist-types/vendors/analytics/segment.d.ts",
+			"import": "./dist/vendors/analytics/segment.js",
+			"require": "./dist/vendors/analytics/segment.cjs"
+		},
+		"./rybbit-analytics": {
+			"types": "./dist-types/vendors/analytics/rybbit-analytics.d.ts",
+			"import": "./dist/vendors/analytics/rybbit-analytics.js",
+			"require": "./dist/vendors/analytics/rybbit-analytics.cjs"
+		},
+		"./umami-analytics": {
+			"types": "./dist-types/vendors/analytics/umami-analytics.d.ts",
+			"import": "./dist/vendors/analytics/umami-analytics.js",
+			"require": "./dist/vendors/analytics/umami-analytics.cjs"
+		},
+		"./vercel-analytics": {
+			"types": "./dist-types/vendors/analytics/vercel-analytics.d.ts",
+			"import": "./dist/vendors/analytics/vercel-analytics.js",
+			"require": "./dist/vendors/analytics/vercel-analytics.cjs"
+		},
+		"./crisp": {
+			"types": "./dist-types/vendors/functional/crisp.d.ts",
+			"import": "./dist/vendors/functional/crisp.js",
+			"require": "./dist/vendors/functional/crisp.cjs"
+		},
+		"./intercom": {
+			"types": "./dist-types/vendors/functional/intercom.d.ts",
+			"import": "./dist/vendors/functional/intercom.js",
+			"require": "./dist/vendors/functional/intercom.cjs"
+		},
+		"./google-tag-manager": {
+			"types": "./dist-types/vendors/tag-managers/google-tag-manager.d.ts",
+			"import": "./dist/vendors/tag-managers/google-tag-manager.js",
+			"require": "./dist/vendors/tag-managers/google-tag-manager.cjs"
+		},
+		"./linkedin-insights": {
+			"types": "./dist-types/vendors/ads-and-pixels/linkedin-insights.d.ts",
+			"import": "./dist/vendors/ads-and-pixels/linkedin-insights.js",
+			"require": "./dist/vendors/ads-and-pixels/linkedin-insights.cjs"
+		},
+		"./meta-pixel": {
+			"types": "./dist-types/vendors/ads-and-pixels/meta-pixel.d.ts",
+			"import": "./dist/vendors/ads-and-pixels/meta-pixel.js",
+			"require": "./dist/vendors/ads-and-pixels/meta-pixel.cjs"
+		},
+		"./reddit-pixel": {
+			"types": "./dist-types/vendors/ads-and-pixels/reddit-pixel.d.ts",
+			"import": "./dist/vendors/ads-and-pixels/reddit-pixel.js",
+			"require": "./dist/vendors/ads-and-pixels/reddit-pixel.cjs"
+		},
+		"./microsoft-uet": {
+			"types": "./dist-types/vendors/ads-and-pixels/microsoft-uet.d.ts",
+			"import": "./dist/vendors/ads-and-pixels/microsoft-uet.js",
+			"require": "./dist/vendors/ads-and-pixels/microsoft-uet.cjs"
+		},
+		"./snapchat-pixel": {
+			"types": "./dist-types/vendors/ads-and-pixels/snapchat-pixel.d.ts",
+			"import": "./dist/vendors/ads-and-pixels/snapchat-pixel.js",
+			"require": "./dist/vendors/ads-and-pixels/snapchat-pixel.cjs"
+		},
+		"./tiktok-pixel": {
+			"types": "./dist-types/vendors/ads-and-pixels/tiktok-pixel.d.ts",
+			"import": "./dist/vendors/ads-and-pixels/tiktok-pixel.js",
+			"require": "./dist/vendors/ads-and-pixels/tiktok-pixel.cjs"
+		},
+		"./x-pixel": {
+			"types": "./dist-types/vendors/ads-and-pixels/x-pixel.d.ts",
+			"import": "./dist/vendors/ads-and-pixels/x-pixel.js",
+			"require": "./dist/vendors/ads-and-pixels/x-pixel.cjs"
+		},
+		"./registry": {
+			"types": "./dist-types/registry.d.ts",
+			"import": "./dist/registry.js",
+			"require": "./dist/registry.cjs"
+		},
 		"./*": {
 			"types": "./dist-types/*.d.ts",
 			"import": "./dist/*.js",
@@ -28,7 +189,7 @@
 		"dev": "sh -c 'rslib build --no-dts --no-clean && rslib build --watch --no-dts --no-clean'",
 		"fmt": "bun biome format --write . && bun biome check --formatter-enabled=false --linter-enabled=false --write",
 		"lint": "bun biome lint ./src",
-		"test": "vitest run --passWithNoTests",
+		"test": "vitest run",
 		"test:watch": "vitest"
 	},
 	"browserslist": [
@@ -39,7 +200,7 @@
 	"devDependencies": {
 		"@c15t/typescript-config": "0.0.1",
 		"@c15t/vitest-config": "1.0.0",
-		"c15t": "2.0.0"
+		"c15t": "2.1.0"
 	},
 	"publishConfig": {
 		"access": "public"