@zinn-digital/sdk 0.1.1435 → 0.1.1436

package/dist/generated/schema.d.ts

@@ -41232,6 +41232,28 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/public/ads-tag/{public_key}/signals": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                public_key: string;
+            };
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * The universal tag's click-shield beacon (public, rate-limited, per-site key).
+         * @description Public (SHIELDTAG, docs/1006.d/features/za-316-shieldtag.md): the universal script sends it with `navigator.sendBeacon` as `text/plain` JSON (no CORS preflight), so the click-fraud shield works on ANY website, not only sites Zinn® hosts. `k` is `landing` (a paid-click visit; `q` holds ONLY the recognised click ids — gclid, msclkid, fbclid, ttclid, li_fat_id, twclid, epik), `engaged` (the visitor scrolled, tapped or typed), `page` (a later page view, only after ad consent) or `conversion` (`zinnAds.conversion` ran). The visitor address and user agent are the REQUEST's (our ingress's trusted client address), never the body's; the host is the tag's own site; the time is the engine's. The `Origin` must be the tag's site or a subdomain of it. A follow-up is kept only when the same address landed from a paid click inside the 10-minute dwell window. Landings are scored by the same shield as hosted sites every 5 minutes once the dwell window closed (same weights, verdicts, IP exclusions and claim packs), only while the organisation has the shield and is in good standing; a site already scored as a hosted site or by the Zinn® Ads WordPress plugin is not scored twice. Beacons are deleted after 3 days. Always `204` for a well-formed beacon, stored or not (no oracle).
+         */
+        post: operations["sendAdsSiteTagSignal"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/public/ads-wordpress/claim": {
         parameters: {
             query?: never;
@@ -67028,6 +67050,13 @@ export interface components {
                 meta_pixel_id?: string;
                 microsoft_uet_id?: string;
             };
+            /** @description What the click shield has seen through this tag (SHIELDTAG, docs/1006.d/features/za-316-shieldtag.md): when the last paid-click landing beacon arrived and the clicks scored from it in 30 days. Set on the list and the single read; the tag protects a site we do not host as soon as it is installed and the organisation has the shield. */
+            shield?: {
+                clicks_30d: number;
+                /** Format: date-time */
+                last_landing_at: string | null;
+                suspected_30d: number;
+            };
             site_host: string;
             /** Format: date-time */
             updated_at: string | null;
@@ -179682,6 +179711,40 @@ export interface operations {
             };
         };
     };
+    sendAdsSiteTagSignal: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                public_key: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "text/plain": string;
+            };
+        };
+        responses: {
+            /** @description Received (stored, or ignored on purpose). */
+            204: {
+                headers: {
+                    /** @description * */
+                    "Access-Control-Allow-Origin"?: string;
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Not a beacon (bad JSON, unknown kind, a landing without a click id, too large). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            429: components["responses"]["TooManyRequests"];
+        };
+    };
     claimAdsWordPressSite: {
         parameters: {
             query?: never;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1435",
+  "version": "0.1.1436",
   "description": "Typed TypeScript client for the Zinn Digital Platform API, generated from its OpenAPI spec.",
   "license": "MIT",
   "author": "Neil Lock \u2014 CEO, Zinn Digital\u00ae Ltd <office@zinndigital.com>",