@sonordev/site-kit 8.8.0 → 8.9.0

package/dist/resonance/meta-pixel.d.ts

@@ -0,0 +1,67 @@
+import type { ResonanceMeasurementConfig } from "../contracts/resonance.js";
+/**
+ * Meta browser pixel loader, controls C1 to C21 of the Resonance Meta pixel standard.
+ *
+ * Option A: the pixel is loaded only so Meta's own first-party cookies exist. This module sends NO browser
+ * event (it has no `track` capability), passes no user data to `init`, reads nothing from the page beyond the
+ * URL hygiene checks, attaches no DOM listener and never writes `_fbp` or `_fbc`. The Conversions API
+ * `PageView` the server builds stays the only event.
+ *
+ * The loader ships dark: a server witness for a controls revision listed in META_BROWSER_CONTROLS_IMPLEMENTED
+ * is the only thing that lets it start, and that list stays empty until Security accepts the evidence bundle.
+ */
+export declare const META_BROWSER_CONTROLS_V1 = "META_BROWSER_CONTROLS_V1";
+/** Controls revisions this build may start. Empty on purpose: add a revision only with Security's acceptance. */
+export declare const META_BROWSER_CONTROLS_IMPLEMENTED: readonly string[];
+/** One fixed URL. Locale is constant (no navigator.language); never a mirror, never a tag manager. */
+export declare const META_SDK_URL = "https://connect.facebook.net/en_US/fbevents.js";
+export type MetaBlocker = 'meta_duplicate_installation' | 'meta_scope_change_requires_reload' | 'meta_load_failed' | 'meta_multiple_destinations' | 'meta_page_not_eligible' | 'meta_url_not_clean';
+export interface MetaPixelHooks {
+    /** The provider runtime's own fence: the same function the Google loader uses. Never a copy. */
+    allowed(): boolean;
+    setBlocker(code: MetaBlocker, present: boolean): void;
+    /** Test seam; production reads META_BROWSER_CONTROLS_IMPLEMENTED. */
+    implementedRevisions?: readonly string[];
+}
+export type MetaPageDecision = {
+    ok: true;
+} | {
+    ok: false;
+    blocker: MetaBlocker;
+};
+/** Whether Meta may initialize on THIS page right now. Pure reads; no side effects. */
+export declare function decideMetaPage(config: ResonanceMeasurementConfig): MetaPageDecision;
+export declare class MetaPixelLoader {
+    private readonly config;
+    private readonly hooks;
+    private generation;
+    private owned;
+    private granted;
+    private cookiesExpired;
+    constructor(config: ResonanceMeasurementConfig, hooks: MetaPixelHooks);
+    private destinations;
+    /** Configuration-level facts, independent of consent and of the page. */
+    inspect(): {
+        destinations: number;
+        multiple: boolean;
+        witnessed: boolean;
+    };
+    /** Every SDK command re-checks the fence; a withdrawn runtime pushes nothing. */
+    private command;
+    private blockers;
+    private foreign;
+    update(): void;
+    /** Single-page navigation: re-evaluate; never re-initialize. */
+    navigate(): void;
+    private resume;
+    private install;
+    /** The grant is issued live, after the SDK has executed: a grant queued ahead of the script never releases its lock. */
+    private afterLoad;
+    private grant;
+    /** The page stopped being eligible or clean: pause the SDK without forgetting the installation. */
+    private pause;
+    /** Before the SDK has executed nothing needs retracting: remove everything so a late script finds no queue and does nothing. */
+    private discard;
+    withdraw(): void;
+    stop(): void;
+}

package/dist/resonance/providers.d.ts

@@ -0,0 +1,32 @@
+import type { ResonanceMeasurementConfig, ResonanceMeasurementOccurrence } from "../contracts/resonance.js";
+import { type MetaBlocker } from "./meta-pixel.js";
+export type ProviderBlocker = 'google_duplicate_installation' | 'google_scope_change_requires_reload' | 'google_load_failed' | 'meta_browser_collection_unverified' | MetaBlocker;
+/** Allowlisted, basic-mode delivery. No browser conversion action exists here. */
+export declare class ResonanceProviderRuntime {
+    private readonly config;
+    private readonly onBlockers?;
+    private google;
+    private script;
+    private configured;
+    private pending;
+    private generation;
+    private active;
+    private loaded;
+    private finishLoad;
+    readonly blockers: Set<ProviderBlocker>;
+    private readonly meta;
+    constructor(config: ResonanceMeasurementConfig, onBlockers?: ((blockers: ProviderBlocker[]) => void) | undefined, options?: {
+        metaControlsRevisions?: readonly string[];
+    });
+    private block;
+    private setBlocker;
+    private allowed;
+    update(): void;
+    private applyConsent;
+    private loadGoogle;
+    occurrence(event: ResonanceMeasurementOccurrence): Promise<void>;
+    /** Single-page navigation: Meta re-evaluates the new page's eligibility and URL hygiene. */
+    navigate(): void;
+    withdraw(): void;
+    stop(): void;
+}

package/dist/resonance/runtime-core.d.ts

@@ -0,0 +1,5 @@
+import type { ResonanceRuntimeProps } from "./ResonanceRuntime.js";
+export declare function mountResonanceRuntime({ site, apiUrl, apiKey }: ResonanceRuntimeProps): {
+    navigate(pathname: string): void;
+    stop(): void;
+} | undefined;

package/dist/revalidate/index.d.ts

@@ -25,9 +25,9 @@
  * single implementation of the webhook; this only supplies the key and
  * Next's cache functions.
  */
-import { type SeoRevalidationHandlerOptions } from '../llms/seo-revalidate';
-export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../contracts/site-cache';
-export type { SiteCacheTag, SiteRevalidatePayload, SiteRevalidatePong } from '../contracts/site-cache';
+import { type SeoRevalidationHandlerOptions } from "../llms/seo-revalidate.js";
+export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from "../contracts/site-cache.js";
+export type { SiteCacheTag, SiteRevalidatePayload, SiteRevalidatePong } from "../contracts/site-cache.js";
 export type RevalidateRouteOptions = Pick<SeoRevalidationHandlerOptions, 'publicationBasePath' | 'extraPaths' | 'extendPayload'> & {
     /** The key Sonor signs the call with. Defaults to `SONOR_API_KEY`, read on every call. */
     secret?: SeoRevalidationHandlerOptions['secret'];

package/dist/revalidate/index.js

@@ -1,7 +1,7 @@
-import { createSeoRevalidationHandler } from '../chunk-THXELZTQ.js';
+import { createSeoRevalidationHandler } from '../chunk-ISMHDUBW.js';
 import '../chunk-XTRZGXB2.js';
 export { SITE_CACHE_TAGS, SITE_REVALIDATE_PATH, isSiteRevalidatePong } from '../chunk-HY7ZEU2C.js';
-import '../chunk-F6WLHVMQ.js';
+import '../chunk-DXE6SXWW.js';
 import '../chunk-PKBMQBKP.js';
 
 // src/revalidate/index.ts

package/dist/robots/index.d.ts

@@ -16,9 +16,9 @@
  *   disallow: ['/admin'],
  * })
  */
-export { isNextInternalsPath } from './next-internals';
-export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler, } from '../llms/aiRobots';
-export type { AiCrawlerRulesOptions, ContentSignalsOptions, RobotsTxtHandlerOptions } from '../llms/aiRobots';
+export { isNextInternalsPath } from "./next-internals.js";
+export { AI_RETRIEVAL_CRAWLERS, AI_TRAINING_CRAWLERS, buildAiCrawlerRules, createRobotsTxtHandler, } from "../llms/aiRobots.js";
+export type { AiCrawlerRulesOptions, ContentSignalsOptions, RobotsTxtHandlerOptions } from "../llms/aiRobots.js";
 export interface RobotsConfig {
     /** Base URL of the site (optional when apiKey is set; then resolved from Sonor) */
     baseUrl?: string;

package/dist/robots/indexnow.js

@@ -1,4 +1,4 @@
-export { GET, INDEXNOW_KEY_PATH, createIndexNowKeyRoute, fetchIndexNowKey } from '../chunk-EATJPSTS.js';
-import '../chunk-C7TLGL3R.js';
+export { GET, INDEXNOW_KEY_PATH, createIndexNowKeyRoute, fetchIndexNowKey } from '../chunk-O5LQUBBN.js';
+import '../chunk-7VMA3KCN.js';
 import '../chunk-MH2DSGC6.js';
 import '../chunk-PKBMQBKP.js';

package/dist/runtime/index.d.ts

@@ -23,10 +23,10 @@
  * exact list of exports, so adding or removing one is a deliberate change.
  * See README.md.
  */
-export { sonorFetch } from '../shared/sonorFetch';
-export type { SonorFetchOptions } from '../shared/sonorFetch';
-export type { FetchRetryOptions } from '../shared/fetchWithRetry';
-export { getClientApiConfig, readPublishedApiConfig, DEFAULT_SONOR_API_URL } from '../shared/clientApiConfig';
-export type { ClientApiConfigOptions } from '../shared/clientApiConfig';
-export { readAnalyticsIdentity } from '../shared/identity-reader';
-export type { AnalyticsIdentity } from '../shared/identity-reader';
+export { sonorFetch } from '../shared/sonor-fetch.js';
+export type { SonorFetchOptions } from '../shared/sonor-fetch.js';
+export type { FetchRetryOptions } from '../shared/fetchWithRetry.js';
+export { getClientApiConfig, readPublishedApiConfig, DEFAULT_SONOR_API_URL } from '../shared/clientApiConfig.js';
+export type { ClientApiConfigOptions } from '../shared/clientApiConfig.js';
+export { readAnalyticsIdentity } from '../shared/identity-reader.js';
+export type { AnalyticsIdentity } from '../shared/identity-reader.js';

package/dist/runtime/index.js

@@ -1,8 +1,7 @@
 import '../chunk-B7T2SFUF.js';
-export { readAnalyticsIdentity } from '../chunk-5ROTTMBL.js';
-import '../chunk-5TM3WPCI.js';
-export { sonorFetch } from '../chunk-FLOJUMFR.js';
-import '../chunk-7HW4TZB5.js';
+export { readAnalyticsIdentity } from '../chunk-PVY7X5UR.js';
+import '../chunk-5IVD6G77.js';
+export { sonorFetch } from '../chunk-VXCUXHZO.js';
 export { DEFAULT_SONOR_API_URL, getClientApiConfig, readPublishedApiConfig } from '../chunk-W7OPEMGJ.js';
-import '../chunk-F6WLHVMQ.js';
+import '../chunk-FRY6PBT6.js';
 import '../chunk-PKBMQBKP.js';