@getvitops/astro 4.0.0 → 4.1.0

package/CHANGELOG.md

@@ -1,5 +1,83 @@
 # @getvitops/astro
 
+## 4.1.0
+
+### Minor Changes
+
+- 2c890c0: Link a site to its ad properties: `site.ads`, `vitops ads`, and `<Ads />`.
+
+  `vitops search` covers the whole Search Console relationship. Nothing covered the equivalent one
+  with ad platforms, and a site's ad accounts had nowhere to live — so a Meta pixel pasted into a
+  template was invisible to the rest of the toolchain. It set `_fbp` on a site whose generated cookie
+  notice never mentioned it, whose consent gate never cleared it on revoke, and — for LinkedIn and
+  Pinterest — whose attribution never captured the click ID at all, so every conversion from those
+  platforms arrived indistinguishable from organic traffic.
+
+  **New `site.ads` block**, keyed by platform (`google`, `meta`, `linkedin`, `reddit`, `tiktok`,
+  `microsoft`, `pinterest`, `snapchat`):
+
+  ```jsonc
+  {
+    "site": {
+      "ads": {
+        "meta": { "pixelId": "123456789", "domainVerification": "abc123" },
+        "google": {
+          "accountId": "123-456-7890",
+          "pixelId": "AW-987654321",
+          "conversionLabel": "xyz",
+        },
+      },
+    },
+  }
+  ```
+
+  **`vitops ads setup`** ensures each platform's domain-verification DNS record. Only four platforms
+  verify a domain at all — Meta, TikTok, Pinterest and Snapchat, by apex DNS TXT — and that record is
+  the one thing created for you (in Cloudflare, via `CLOUDFLARE_API_TOKEN`; created only, never edited
+  or deleted). Google Ads, LinkedIn, Reddit and Microsoft Ads have no domain verification: linking
+  there is the tag and the account id, and the run says so rather than skipping in silence. No
+  platform Marketing API is called — Meta's needs a system-user token and Google's an approved
+  developer token with your own account on the line — so the final "Verify" click is surfaced as a
+  reminder. `--dry` prints the plan, `--check` reports drift and exits non-zero.
+
+  **It asks for what the config is missing.** A verification token does not exist until someone
+  fetches it from the platform UI, so a first run prompts for it, naming the exact UI path, folds the
+  answer into the plan and writes it to your config. The token is not a secret — it is published in
+  DNS, and the platform fetching it back is the ownership proof, exactly like the IndexNow key.
+  Prompting requires a TTY: with `--dry`, `--check`, `--no-prompt`, or in CI, you get a named error
+  instead and the run never hangs. `--no-write` keeps the answer out of the config.
+
+  **`vitops ads tags`** prints each pixel as an inert, consent-gated `<script>` — `type="text/plain"`
+  with the library URL on `data-src`, so an undecided visitor's page issues no third-party request.
+  For Bricks, WordPress, Eleventy: any stack without the Astro integration.
+
+  **`vitops ads lint`** reports the gaps that are invisible at runtime: a click ID the platform stamps
+  that attribution does not capture, a pixel while `site.tracking` is off, a property with no tag id.
+
+  **`<Ads />` in `@getvitops/astro`**, a sibling of `<Analytics />` rather than part of it — ad
+  properties come from the site config, state their own consent category (`marketing` by default,
+  rather than being derived), and switch per environment on their own
+  (`environments.<env>.ads`, defaulting to `analytics`, then true, so a preview deployment can send
+  pageviews without firing conversion pixels). Both components now render through one `<GatedTags />`,
+  so the inert markup has a single implementation.
+
+  **Your cookie notice now discloses every configured pixel** — name, cookies and opt-out — from the
+  same table that writes `data-consent-cookies`, so the notice and the revoke cannot disagree. If you
+  add `site.ads` to a config whose privacy policy or cookie notice you have already published,
+  re-generate and re-read them.
+
+  `li_fat_id` (LinkedIn) and `epik` (Pinterest) join the click-ID capture vocabulary; a site running
+  either platform starts attributing conversions it previously recorded as organic.
+
+### Patch Changes
+
+- Updated dependencies [2c890c0]
+- Updated dependencies [e764090]
+  - @getvitops/generator@4.1.0
+  - @getvitops/utils@4.1.0
+  - @getvitops/vite@4.1.0
+  - @getvitops/core@4.1.0
+
 ## 4.0.0
 
 ### Major Changes

package/dist/index.d.mts

@@ -1,5 +1,6 @@
 import { LegalOutput, SiteFont, StylesheetFormat } from "@getvitops/generator";
 import { generateIconInclude } from "@getvitops/utils";
+import { AdProvider } from "@getvitops/utils/ads";
 import { OutputKind } from "@getvitops/utils/media";
 import { AstroIntegration } from "astro";
 export * from "@getvitops/utils";
@@ -102,9 +103,22 @@ interface GetvitopsConsentOptions {
   /** Link the banner to the cookie notice (`vitops legal` renders one). */
   policyUrl?: string;
 }
-/** One tag, fully resolved. */
-interface ResolvedTag {
-  key: 'googleAnalytics' | 'clarity' | 'matomo' | 'plausible';
+/**
+ * A third-party tag, fully resolved — everything `<GatedTags />` needs to render
+ * one, with nothing left to decide.
+ *
+ * Shared by `<Analytics />` and `<Ads />` on purpose: the inert-markup rule
+ * (`type="text/plain"`, the URL on `data-src`, never a live `src`) is the whole
+ * consent gate, and it must have exactly one implementation. What differs between
+ * the two is where the tag comes from and who decides its category, which is why
+ * they have separate resolvers over one shape rather than one resolver over two
+ * vocabularies.
+ *
+ * `key` is left to each resolver: analytics keys are its four providers, ads keys
+ * are `AdProvider`. Widening it into one union here would let a provider from
+ * either side satisfy a check meant for the other.
+ */
+interface GatedTag {
   /** The provider as a reader would recognise it — used in warnings. */
   provider: string;
   category: ConsentCategory;
@@ -123,6 +137,10 @@ interface ResolvedTag {
   src: string | null;
   attrs: Record<string, string>;
 }
+/** One analytics tag. */
+interface ResolvedTag extends GatedTag {
+  key: 'googleAnalytics' | 'clarity' | 'matomo' | 'plausible';
+}
 interface ResolvedAnalytics {
   tags: ResolvedTag[];
   /** Does anything here need `@getvitops/core/consent` loaded? */
@@ -143,7 +161,7 @@ interface ResolveAnalyticsContext {
  */
 declare function resolveAnalytics(opts: GetvitopsAnalyticsOptions | undefined, ctx?: ResolveAnalyticsContext): ResolvedAnalytics;
 /** Which optional categories a set of tags actually needs a visitor to decide. */
-declare function consentCategories(tags: ResolvedTag[]): OptionalConsentCategory[];
+declare function consentCategories(tags: GatedTag[]): OptionalConsentCategory[];
 //#endregion
 //#region src/seo.d.ts
 /**
@@ -784,6 +802,48 @@ interface GetvitopsIconsOptions {
 }
 declare function vitops(opts?: GetvitopsOptions): AstroIntegration;
 //#endregion
+//#region src/ads.d.ts
+/**
+ * One ad property, mirroring a `site.ads` entry field for field.
+ *
+ * Structural rather than `SiteAdProperty` imported from the generator, matching
+ * how `GetvitopsSeoOptions` and `GetvitopsTrackingOptions` already work: the
+ * component surface must stay usable by a consumer who passes a plain object.
+ */
+interface GetvitopsAdProperty {
+  accountId?: string;
+  pixelId?: string;
+  conversionLabel?: string;
+  /** Default `marketing`. `analytics` for a property used purely for measurement. */
+  category?: 'marketing' | 'analytics';
+  /** False keeps the property on record without emitting its tag. */
+  enabled?: boolean;
+}
+type GetvitopsAdsOptions = Partial<Record<AdProvider, GetvitopsAdProperty>>;
+/** One ad tag. `key` is the platform, so a caller can find one without matching prose. */
+interface ResolvedAdTag extends GatedTag {
+  key: AdProvider;
+}
+interface ResolvedAds {
+  tags: ResolvedAdTag[];
+  /** Does anything here need `@getvitops/core/consent` loaded? */
+  needsRuntime: boolean;
+  /** Configuration problems, as prose. The integration logs these. */
+  warnings: string[];
+}
+interface ResolveAdsContext {
+  /** Is the consent gate enabled on this site (`vitops({ consent })`)? */
+  consent?: boolean;
+  /** Categories the banner offers, so we can catch a demand with no row. */
+  consentCategories?: readonly string[];
+  /** `environments.<env>.ads` — false switches every tag off for this build. */
+  enabled?: boolean;
+  /** When the tags load. Default `idle`: a pixel is never worth the critical path. */
+  strategy?: AnalyticsStrategy;
+}
+/** Resolve the configured ad properties into the tags `<Ads />` emits. */
+declare function resolveAds(ads: GetvitopsAdsOptions | undefined, ctx?: ResolveAdsContext): ResolvedAds;
+//#endregion
 //#region src/lastmod.d.ts
 interface GitLastmodOptions {
   /** Directories to read history from (default `src/pages`, `src/content`, `src/data`). */
@@ -813,5 +873,5 @@ declare function slugFromContent(file: string): string | undefined;
  */
 declare function gitLastmod(options?: GitLastmodOptions): Promise<(item: GetvitopsSitemapEntry) => GetvitopsSitemapEntry>;
 //#endregion
-export { type AnalyticsStrategy, type ClarityOptions, type ConsentCategory, type GetvitopsAnalyticsOptions, type GetvitopsConsentOptions, type GetvitopsCssOptions, type GetvitopsFaviconOptions, type GetvitopsMediaOptions, type GetvitopsOptions, type GetvitopsSeoOptions, type GetvitopsSitemapChangeFreq, type GetvitopsSitemapEntry, type GetvitopsSitemapOptions, type GetvitopsTrackingOptions, type GitLastmodOptions, type GoogleAnalyticsOptions, type MatomoOptions, type OptionalConsentCategory, type PlausibleOptions, type ResolveAnalyticsContext, type ResolveTrackingContext, type ResolvedAnalytics, type ResolvedSeo, type ResolvedTag, type ResolvedTracking, type SeoContext, type SeoNameTag, type SeoOgType, type SeoPropertyTag, type SeoProps, type SeoTwitterCard, TRACKING_COOKIE, type TrackingCategory, consentCategories, vitops as default, gitLastmod, resolveAnalytics, resolveSeo, resolveTracking, routeFromPage, slugFromContent };
+export { type AnalyticsStrategy, type ClarityOptions, type ConsentCategory, type GatedTag, type GetvitopsAdProperty, type GetvitopsAdsOptions, type GetvitopsAnalyticsOptions, type GetvitopsConsentOptions, type GetvitopsCssOptions, type GetvitopsFaviconOptions, type GetvitopsMediaOptions, type GetvitopsOptions, type GetvitopsSeoOptions, type GetvitopsSitemapChangeFreq, type GetvitopsSitemapEntry, type GetvitopsSitemapOptions, type GetvitopsTrackingOptions, type GitLastmodOptions, type GoogleAnalyticsOptions, type MatomoOptions, type OptionalConsentCategory, type PlausibleOptions, type ResolveAdsContext, type ResolveAnalyticsContext, type ResolveTrackingContext, type ResolvedAdTag, type ResolvedAds, type ResolvedAnalytics, type ResolvedSeo, type ResolvedTag, type ResolvedTracking, type SeoContext, type SeoNameTag, type SeoOgType, type SeoPropertyTag, type SeoProps, type SeoTwitterCard, TRACKING_COOKIE, type TrackingCategory, consentCategories, vitops as default, gitLastmod, resolveAds, resolveAnalytics, resolveSeo, resolveTracking, routeFromPage, slugFromContent };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/analytics.ts","../src/seo.ts","../src/tracking.ts","../src/integration.ts","../src/lastmod.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/analytics.ts","../src/seo.ts","../src/tracking.ts","../src/integration.ts","../src/ads.ts","../src/lastmod.ts"],"mappings":"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"}

package/dist/index.mjs

@@ -4,6 +4,7 @@ import { fileURLToPath } from "node:url";
 import { isConfig, resolveConfig } from "@getvitops/generator";
 import { collectIconRefs, faviconLinks, generateFavicons, generateIconInclude, resolveIcon, scanFiles, writeFaviconManifest } from "@getvitops/utils";
 import vitopsPlugin from "@getvitops/vite";
+import { AD_PLATFORMS, AD_PROVIDER_KEYS } from "@getvitops/utils/ads";
 import { fontProviders } from "astro/config";
 import { execFile } from "node:child_process";
 import { promisify } from "node:util";
@@ -17,9 +18,9 @@ export * from "@getvitops/utils"
 * the guard is one regex and the cost of not having it is arbitrary script
 * injection from a config file.
 */
-const SAFE_ID = /^[\w.-]+$/;
+const SAFE_ID$1 = /^[\w.-]+$/;
 function bad(value) {
-	return !SAFE_ID.test(value);
+	return !SAFE_ID$1.test(value);
 }
 /** JSON is a subset of JS object-literal syntax; `<` can't appear unescaped. */
 function literal(value) {
@@ -172,6 +173,105 @@ function consentCategories(tags) {
 	].filter((c) => used.has(c));
 }
 
+//#endregion
+//#region src/ads.ts
+/**
+* The `<Ads />` resolution layer — the site's ad properties in, the exact tags to
+* emit out.
+*
+* A sibling of `analytics.ts`, deliberately not part of it. The two render the
+* same gated markup, but they answer different questions and four things differ:
+*
+*  - **Where they come from.** Analytics providers are integration options
+*    (`vitops({ analytics })`); ad properties are `site.ads` in the site config,
+*    because the ad account is a fact about the site that `vitops ads setup`,
+*    `vitops ads lint` and the generated cookie notice all read too.
+*  - **Who decides the consent category.** `resolveAnalytics` *derives* it from
+*    whether the provider sets cookies, so a consumer cannot mark Google Analytics
+*    `necessary` to dodge a banner. Every ad pixel sets cookies and is advertising,
+*    so the answer is `marketing` unless the config says `analytics` — a stated
+*    fact, not a derivation.
+*  - **What the key means.** `ResolvedTag['key']` is the four analytics providers,
+*    and `analytics.ts` pairs that set against the generator's processor table.
+*    Widening it to eight ad platforms would make that check answer for tags it
+*    does not govern.
+*  - **When they fire.** Analytics is gated per environment by
+*    `environments.<env>.analytics`; a preview deployment sending pageviews is
+*    survivable, one firing conversion pixels is not, so ads gets its own switch.
+*
+* Everything decidable is here and unit-tested; `Ads.astro` renders what this
+* returns and chooses nothing.
+*/
+/**
+* IDs land inside an inline `<script>`, so they are checked rather than trusted —
+* the same guard, for the same reason, as `analytics.ts`'s `SAFE_ID`. A `<\/script>`
+* in a pixel ID is not a plausible accident; arbitrary script injection from a
+* config file is not a plausible thing to allow either.
+*/
+const SAFE_ID = /^[\w.-]+$/;
+/** Resolve the configured ad properties into the tags `<Ads />` emits. */
+function resolveAds(ads, ctx = {}) {
+	const warnings = [];
+	const tags = [];
+	const strategy = ctx.strategy ?? "idle";
+	const configured = AD_PROVIDER_KEYS.filter((p) => ads?.[p] != null);
+	if (configured.length === 0) return {
+		tags,
+		needsRuntime: false,
+		warnings
+	};
+	if (ctx.enabled === false) return {
+		tags,
+		needsRuntime: false,
+		warnings
+	};
+	for (const provider of configured) {
+		const entry = ads[provider];
+		if (entry.enabled === false) continue;
+		const platform = AD_PLATFORMS[provider];
+		const id = entry[platform.tag.needs];
+		if (!id) {
+			warnings.push(`ads: ${provider} has no ${platform.tag.needs}, so no tag is emitted. Run \`vitops ads setup\` to be prompted for it.`);
+			continue;
+		}
+		if (!SAFE_ID.test(id)) {
+			warnings.push(`ads: ${provider} ${platform.tag.needs} "${id}" is not a valid ID. Skipped.`);
+			continue;
+		}
+		const category = entry.category ?? "marketing";
+		tags.push({
+			key: provider,
+			provider: platform.name,
+			category,
+			setsCookies: true,
+			cookies: platform.tag.cookies,
+			strategy,
+			gated: ctx.consent === true,
+			inline: platform.tag.bootstrap(id, {
+				provider,
+				...entry
+			}),
+			src: platform.tag.src ? platform.tag.src(id) : null,
+			attrs: {}
+		});
+	}
+	if (tags.length === 0) return {
+		tags,
+		needsRuntime: false,
+		warnings
+	};
+	if (ctx.consent !== true) warnings.push(`ads: ${tags.map((t) => t.provider).join(", ")} ${tags.length === 1 ? "sets" : "set"} advertising cookies, and \`consent\` is off — so they load for every visitor with no way to decline. Set \`consent: true\`.`);
+	else {
+		const missing = [...new Set(tags.map((t) => t.category))].filter((c) => ctx.consentCategories && !ctx.consentCategories.includes(c));
+		if (missing.length) warnings.push(`ads: the tags demand the ${missing.join(", ")} consent categor${missing.length === 1 ? "y" : "ies"}, but the banner offers ${ctx.consentCategories?.join(", ") || "nothing"}. Add ${missing.join(", ")} to \`consent.categories\`, or the tags wait on a question the banner never asks.`);
+	}
+	return {
+		tags,
+		needsRuntime: true,
+		warnings
+	};
+}
+
 //#endregion
 //#region src/fonts.ts
 /**
@@ -298,6 +398,34 @@ function undisclosedProviders(configPath, analytics) {
 	}
 	return Object.keys(SITE_CONFIG_KEYS).filter((key) => analytics[key] !== void 0 && !declared[SITE_CONFIG_KEYS[key]]);
 }
+/**
+* Read `site.ads` and this environment's ads switch out of the site config.
+*
+* Best-effort, like `undisclosedProviders`: every other consumer of this file
+* validates it loudly elsewhere in the same hook, and a second copy of that error
+* helps nobody. `resolveConfig` is used rather than a bare `JSON.parse` so an A/B
+* variant's `overrides` are applied first — a variant that changes which pixels
+* run is exactly the kind of thing overrides exist for.
+*
+* The environment switch cascades `ads` → `analytics` → true. An environment that
+* has already said "no analytics here" has said the interesting half of it; making
+* a consumer repeat themselves to stop conversion pixels would mean a preview
+* deploy fires them by default, which is the wrong way for this to fail.
+*/
+function readSiteAds(configPath, siteEnv) {
+	try {
+		const cfg = resolveConfig(JSON.parse(readFileSync(configPath, "utf8")), siteEnv);
+		const properties = cfg.site.ads;
+		if (!properties || Object.keys(properties).length === 0) return null;
+		const env = cfg.site.environments?.[siteEnv];
+		return {
+			enabled: env?.ads ?? env?.analytics ?? true,
+			properties
+		};
+	} catch {
+		return null;
+	}
+}
 const VIRTUAL_ID = "virtual:getvitops/head";
 const RESOLVED_ID = `\0${VIRTUAL_ID}`;
 function virtualHeadPlugin(data) {
@@ -392,7 +520,11 @@ function vitops(opts = {}) {
 			const consentOpts = typeof opts.consent === "object" ? opts.consent : {};
 			const analytics = resolveAnalytics(opts.analytics, { consent: consentEnabled });
 			const trackingOpts = opts.tracking === true ? { enabled: true } : opts.tracking || void 0;
-			const detectedCategories = consentCategories(analytics.tags);
+			const adsConfig = siteInput ? readSiteAds(resolve(root, siteInput), opts.site?.siteEnv ?? "production") : null;
+			const detectedCategories = consentCategories([...analytics.tags, ...resolveAds(adsConfig?.properties, {
+				consent: consentEnabled,
+				enabled: true
+			}).tags]);
 			const defaultCategories = ["analytics", "preferences"];
 			const trackingCategory = trackingOpts?.enabled ? trackingOpts.category ?? "marketing" : null;
 			if (detectedCategories.includes("marketing") || trackingCategory === "marketing") defaultCategories.push("marketing");
@@ -403,6 +535,12 @@ function vitops(opts = {}) {
 				consentCategories: offeredCategories
 			});
 			for (const warning of tracking.warnings) logger.warn(warning);
+			const ads = resolveAds(adsConfig?.properties, {
+				consent: consentEnabled,
+				consentCategories: offeredCategories,
+				enabled: adsConfig?.enabled ?? true
+			});
+			for (const warning of ads.warnings) logger.warn(warning);
 			if (opts.analytics && legalInput) {
 				const undisclosed = undisclosedProviders(resolve(root, legalInput), opts.analytics);
 				if (undisclosed.length) logger.warn(`analytics: ${undisclosed.join(", ")} ${undisclosed.length === 1 ? "is" : "are"} configured here but absent from your site config's \`analytics\` block, so the cookie notice \`legal\` generates will not disclose ${undisclosed.length === 1 ? "it" : "them"}. Add ${undisclosed.map((k) => SITE_CONFIG_KEYS[k]).join(", ")} to ${legalInput}.`);
@@ -605,7 +743,8 @@ function vitops(opts = {}) {
 					enabled: true,
 					category: tracking.category,
 					cookies: tracking.cookies
-				} : null
+				} : null,
+				ads: adsConfig
 			})] } });
 			if (opts.css) {
 				const format = opts.css.format ?? "tailwind";
@@ -933,5 +1072,5 @@ function resolveSeo(defaults, props, ctx) {
 }
 
 //#endregion
-export { TRACKING_COOKIE, consentCategories, vitops as default, gitLastmod, resolveAnalytics, resolveSeo, resolveTracking, routeFromPage, slugFromContent };
+export { TRACKING_COOKIE, consentCategories, vitops as default, gitLastmod, resolveAds, resolveAnalytics, resolveSeo, resolveTracking, routeFromPage, slugFromContent };
 //# sourceMappingURL=index.mjs.map