@zinn-digital/sdk 0.1.1382 → 0.1.1384

package/dist/generated/schema.d.ts

@@ -17426,8 +17426,8 @@ export interface paths {
             cookie?: never;
         };
         /**
-         * Competitor ad groups in every language - thresholds and the last run (za-15).
-         * @description Gated on `ads.view`. On the caller's own connection. The daily audit (Temporal) reads the account's own search terms and proposes, for approval, one ad group `<Rival> alternative` per rival per language market whose searches reach the thresholds, with PHRASE keywords and one responsive search ad copied from an approved ad in that campaign (or the English ad translated in one batched call), with no competitor name in the ad text (docs/1006 §81). Proposals are ordinary approve-first changes (`listAdsChanges`). `enabled` is the competitor switch AND a plan carrying `ads_competitor_groups`. Read from stored rows, never a network call in the request.
+         * Competitor ad groups in every language - thresholds and the last run (za-15, za-71).
+         * @description za-71 (docs/1006 §89): a rival the house table says must not be built (a free host, or a local brand searched off its market) is BLOCKED with EXACT campaign negatives instead, each verdict behind its own customer switch (`block_free_hosts`, `block_off_market`, Recommended on); in the customer's Automatic mode builds and blocks are sent through the change gate (kill switch, good standing) with an Undo, otherwise queued for approval. Gated on `ads.view`. On the caller's own connection. The daily audit (Temporal) reads the account's own search terms and proposes, for approval, one ad group `<Rival> alternative` per rival per language market whose searches reach the thresholds, with PHRASE keywords and one responsive search ad copied from an approved ad in that campaign (or the English ad translated in one batched call), with no competitor name in the ad text (docs/1006 §81). Proposals are ordinary approve-first changes (`listAdsChanges`). `enabled` is the competitor switch AND a plan carrying `ads_competitor_groups`. Read from stored rows, never a network call in the request.
          */
         get: operations["getAdsCompetitorGroups"];
         put?: never;
@@ -32338,7 +32338,7 @@ export interface paths {
         put?: never;
         /**
          * Record translations the repository committed (batch).
-         * @description i18n fix A (2026-10-16): when a lane commits a translation into the repository after the engine translated the SAME English, the repository's copy wins, and the export (`scripts/i18n-sync.mjs export`) hands it back here so the engine and the repo hold one truth. Each item is accepted only while `source_hash` still equals the string's current English hash; an item whose English moved on (`stale`) or whose string is unknown (`missing`) is reported and left alone, so a changed source keeps re-translating through the ordinary batched pipeline (CLAUDE.md §2.19). An accepted row is `up_to_date`, its `translated_at` is now, and it is attributed `repo` — indistinguishable from any other translation to every consumer. Idempotent: the same text again changes nothing.
+         * @description i18n fix A (2026-10-16): when a lane commits a translation into the repository after the engine translated the SAME English, the repository's copy wins, and the export (`scripts/i18n-sync.mjs export`) hands it back here so the engine and the repo hold one truth. Each item is accepted only while `source_hash` still equals the string's current English hash; an item whose English moved on (`stale`) or whose string is unknown (`missing`) is reported and left alone, so a changed source keeps re-translating through the ordinary batched pipeline (CLAUDE.md §2.19). An accepted row is `up_to_date`, its `translated_at` is now, and it is attributed `repo` — indistinguishable from any other translation to every consumer. Idempotent: the same text again changes nothing. An item whose text drops a required term rendering for its locale (`engine/engine/i18n/term_renderings.py`, e.g. de "Zinn® Managed WordPress") is `refused` and left alone: a pin outranks the repository, exactly as it outranks a new machine answer.
          */
         post: operations["recordRepoTranslations"];
         delete?: never;
@@ -62302,15 +62302,32 @@ export interface components {
             headlines?: string[];
             impressions?: number;
             keywords?: string[];
+            /**
+             * @description za-71: a built group, or a blocked rival's campaign negatives.
+             * @enum {string}
+             */
+            kind?: "group" | "block";
             /** @description The market's language code. */
             language: string;
-            /** @description Why it waits - noApprovedAd, noLandingPage, gateRefused, noBid (no enabled group bid and no Maximise-clicks ceiling to start the new group on). */
+            /** @description za-71: the EXACT campaign negatives of a block. */
+            negatives?: string[];
+            /** @description Why it waits - noApprovedAd, noLandingPage, gateRefused, noBid (no enabled group bid and no Maximise-clicks ceiling to start the new group on), refused, failed, conflict. */
             reason?: string;
+            /** @description Searches of a block the pre-check refused (an enabled keyword's query, or a search that converted); the rest were still sent. */
+            refused?: string[];
             rival: string;
             /** @enum {string} */
-            source?: "copied" | "translated";
-            /** @enum {string} */
-            status: "proposed" | "waiting";
+            source?: "copied" | "translated" | "written";
+            /**
+             * @description applied = sent by the Automatic mode, with an Undo (za-71).
+             * @enum {string}
+             */
+            status: "proposed" | "applied" | "waiting" | "refused" | "failed" | "off";
+            /**
+             * @description za-71: why a block blocks.
+             * @enum {string}
+             */
+            verdict?: "free_host" | "wrong_market";
         };
         AdsCompetitorGroupsEnvelope: {
             data: {
@@ -62319,6 +62336,8 @@ export interface components {
                 /** @description Proposals waiting for approval. */
                 pending: number;
                 settings: {
+                    block_free_hosts: components["schemas"]["AdsCompetitorGroupsSwitch"];
+                    block_off_market: components["schemas"]["AdsCompetitorGroupsSwitch"];
                     lookback_days: components["schemas"]["AdsCompetitorGroupsThreshold"];
                     max_keywords: components["schemas"]["AdsCompetitorGroupsThreshold"];
                     min_clicks: components["schemas"]["AdsCompetitorGroupsThreshold"];
@@ -62328,14 +62347,22 @@ export interface components {
             };
         };
         AdsCompetitorGroupsPatch: {
+            /** @description za-71: block searches for a free host. null = Recommended (on). */
+            block_free_hosts?: boolean | null;
+            /** @description za-71: block a local brand searched outside its market. null = Recommended (on). */
+            block_off_market?: boolean | null;
             lookback_days?: number | null;
             max_keywords?: number | null;
             min_clicks?: number | null;
             min_impressions?: number | null;
         };
         AdsCompetitorGroupsRun: {
+            /** @description za-71: builds and blocks the Automatic mode sent. */
+            applied?: number;
             /** Format: date-time */
             at: string;
+            /** @description za-71: blocks decided this run (applied or proposed). */
+            blocked?: number;
             /** @description Rival + language pairs that already have a group or a decided proposal. */
             covered: number;
             groups: components["schemas"]["AdsCompetitorGroup"][];
@@ -62344,6 +62371,12 @@ export interface components {
             skipped: string;
             waiting: number;
         };
+        AdsCompetitorGroupsSwitch: {
+            /** @description True when the customer set it; false = Recommended. */
+            custom: boolean;
+            recommended: boolean;
+            value: boolean;
+        };
         AdsCompetitorGroupsThreshold: {
             /** @description True when the customer set it; false = Recommended. */
             custom: boolean;
@@ -162428,7 +162461,7 @@ export interface operations {
             };
         };
         responses: {
-            /** @description How many items were recorded, already equal, stale or unknown. */
+            /** @description How many items were recorded, already equal, stale, unknown or refused. */
             200: {
                 headers: {
                     [name: string]: unknown;
@@ -162437,6 +162470,8 @@ export interface operations {
                     "application/json": {
                         missing: number;
                         recorded: number;
+                        /** @description Items whose text breaks a term rendering pinned for its locale; the engine's row is kept unchanged. */
+                        refused: number;
                         stale: number;
                         unchanged: number;
                     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zinn-digital/sdk",
-  "version": "0.1.1382",
+  "version": "0.1.1384",
   "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>",